Allocate Flexible IP - Revision history

Mike.robski: 1 revision: Release 86

2013-10-11T17:00:56Z

1 revision: Release 86

Emanuela.mitreva at 15:12, 11 July 2013

2013-07-11T15:12:54Z

Administrator: /* POST /os-floating-ips */

2013-06-27T01:01:48Z

POST /os-floating-ips

Mike.robski: 1 revision

2013-05-24T15:24:59Z

1 revision

Mike.robski at 13:18, 20 May 2013

2013-05-20T13:18:00Z

Administrator: /* POST /os-floating-ips */

2013-04-13T01:30:39Z

POST /os-floating-ips

Mike.robski at 20:53, 14 December 2012

2012-12-14T20:53:58Z

Mike.robski at 20:50, 14 December 2012

2012-12-14T20:50:39Z

Mike.robski at 20:36, 14 December 2012

2012-12-14T20:36:59Z

Administrator: Created page with "A Flexible IP address is a static IP address that can be bound to any single Server. When you associate a flexible IP with a Server the IP is bound to that Server's network in..."

2012-07-04T21:24:04Z

Created page with "A Flexible IP address is a static IP address that can be bound to any single Server. When you associate a flexible IP with a Server the IP is bound to that Server's network in..."

New page

A Flexible IP address is a static IP address that can be bound to any single Server. When you associate a flexible IP with a Server the IP is bound to that Server's network interface. You will use your flexible IP to connect to your Server. You can allocate IPs and release IPs from your account as needed.

='''POST''' /os-floating-ips=
Allocates a new flexible IP.

== Response ==
=== JSON ===
<nowiki>
{
"floating_ip" : {
"instance_id" : "{instance_id}",
"ip" : "{ip_address}",
"fixed_ip" : null,
"links" : [
{
"href" : "http://{api_server}/os-floating-ips/{ip_address}/",
"rel" : "self"
}
],
"pool" : "default"
}
}
</nowiki>

====floating_ip====
; instance_id - ''string''
: Unique instance identifier floating IP is assigned to.

; ip - ''string''
: IP address allocated.

; fixed_ip - ''string''
: Fixed IP address.

; links - ''list''
: [[Hypermedia]] for this resource.

; pool - ''string''
: Name of the pool IP address belongs to.

== Response Codes ==
; Success
: ''HTTP/1.1 202 Accepted''

; Failure
: ''HTTP/1.1 401 Unauthorized'' : This server could not verify that you are authorized to access the document you requested. Either you supplied incorrect credentials (e.g., bad password), or your browser does not understand how to supply the credentials required.

== Examples ==
'''Successfully allocate a flexible IP'''
:'''POST''' http(s)://{api_server}/os-floating-ips

''Request Headers:''
Content-Type:application/json
Charset=UTF-8
Authorization:Base64-encoded username & password string

''Response Code:''
<pre>HTTP/1.1 202 Accepted</pre>

''Response Body:''
<nowiki>
{
"floating_ip" : {
"instance_id" : null,
"ip" : "{ip_address}",
"fixed_ip" : null,
"links" : [
{
"href" : "http://{api_server}/os-floating-ips/{ip_address}/",
"rel" : "self"
}
],
"pool" : "default"
}
}
</nowiki>

'''Unauthorized access'''
:'''POST''' <nowiki>http://{api_server}/os-floating-ips</nowiki>

''Request Headers:''
Content-Type:application/json
Charset=UTF-8
Authorization:Base64-encoded <span style="color:red">fake_authentication_string</span>

''Response Code:''
<pre>HTTP/1.1 401 Unauthorized</pre>

''Response Body:''
401 Unauthorized
This server could not verify that you are authorized to
access the document you requested. Either you supplied the
wrong credentials (e.g., bad password), or your browser
does not understand how to supply the credentials required.



{{#widget:DISQUS
|id=hostway
|uniqid={{PAGENAME}}
|url={{fullurl:{{PAGENAME}}}}
}}

@@ Line 2: / Line 2: @@
 ='''POST''' /os-floating-ips=
-Allocates a new flexible IP.
+This operation will allocate a new flexible IP.
 == Request ==

@@ Line 2: / Line 2: @@
 =='''POST''' /os-floating-ips==
-Allocates a new flexible IP.
+This operation will allocate a new flexible IP.
 === Response ===

← Older revision		Revision as of 20:53, 14 December 2012
Line 95:		Line 95:


−	[[Category:API]]	+	[[Category:Hostway API]]
		+	[[Category:FlexCloud Server API]]

	<!-- THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->		<!-- THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->

← Older revision		Revision as of 20:36, 14 December 2012
Line 94:		Line 94:
	does not understand how to supply the credentials required.		does not understand how to supply the credentials required.

		+
		+	[[Category:API]]

	<!-- THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->		<!-- THIS CODE ENABLES DISQUS COMMENTS ON THE PAGE - DELETE TO DISABLE COMMENTING-->

@@ Line 1: / Line 1: @@
 A Flexible IP address is a static IP address that can be bound to any single Server. When you associate a flexible IP with a Server the IP is bound to that Server's network interface. You will use your flexible IP to connect to your Server. You can allocate IPs and release IPs from your account as needed.
-='''POST''' /os-floating-ips=
+='''POST''' /accounts/{accountId}/flexcloud/os-floating-ips=
-This operation will allocate a new flexible IP.
+Allocates a new flexible IP.
 == Request ==
@@ Line 9: / Line 9: @@
      "zone": "AUS001"
 }</nowiki>
 == Response ==
@@ Line 20: / Line 24: @@
        "links" : [
+          {
-             "href" : "http://{api_server}/os-floating-ips/{ip_address}/",
+             "href" : "http://{api_server}/accounts/{accountId}/flexcloud/os-floating-ips/{ip_address}/",
              "rel" : "self"
+          }
@@ Line 50: / Line 54: @@
 ; Failure
 : ''HTTP/1.1 401 Unauthorized'' : This server could not verify that you are authorized to access the document you requested.  Either you supplied incorrect credentials (e.g., bad password), or your browser does not understand how to supply the credentials required.
 == Examples ==
 '''Successfully allocate a flexible IP'''
-:'''POST''' http(s)://{api_server}/os-floating-ips
+:'''POST''' http(s)://{api_server}/accounts/{accountId}/flexcloud/os-floating-ips
 ''Request Headers:''
@@ Line 72: / Line 77: @@
        "links" : [
+          {
-             "href" : "http://{api_server}/os-floating-ips/{ip_address}/",
+             "href" : "http://{api_server}/account/{accountId}/flexcloud/os-floating-ips/{ip_address}/",
              "rel" : "self"
+          }
@@ Line 78: / Line 83: @@
        "pool" : "default"
+    }
 }</nowiki>
 </nowiki>
 '''Unauthorized access'''
-:'''POST''' <nowiki>http://{api_server}/os-floating-ips</nowiki>
+:'''POST''' <nowiki>http://{api_server}/accounts/{accountId}/flexcloud/os-floating-ips</nowiki>
 ''Request Headers:''
@@ Line 98: / Line 102: @@
       wrong credentials (e.g., bad password), or your browser
       does not understand how to supply the credentials required.
 [[Category:Hostway API]]
 [[Category:FlexCloud Server API]]

@@ Line 1: / Line 1: @@
 A Flexible IP address is a static IP address that can be bound to any single Server. When you associate a flexible IP with a Server the IP is bound to that Server's network interface. You will use your flexible IP to connect to your Server. You can allocate IPs and release IPs from your account as needed.
-='''POST''' /os-floating-ips=
+=='''POST''' /os-floating-ips==
 Allocates a new flexible IP.
-== Response ==
+=== Response ===
-=== JSON ===
+==== JSON ====
   <nowiki>
+{
@@ Line 23: / Line 23: @@
 </nowiki>
-====floating_ip====
+=====floating_ip=====
 ; instance_id - ''string''
 : Unique instance identifier floating IP is assigned to.
@@ Line 39: / Line 39: @@
 : Name of the pool IP address belongs to.
-== Response Codes ==
+=== Response Codes ===
 ; Success
 : ''HTTP/1.1 202 Accepted''
@@ Line 46: / Line 46: @@
 : ''HTTP/1.1 401 Unauthorized'' : This server could not verify that you are authorized to access the document you requested.  Either you supplied incorrect credentials (e.g., bad password), or your browser does not understand how to supply the credentials required.
-== Examples ==
+=== Examples ===
 '''Successfully allocate a flexible IP'''
 :'''POST''' http(s)://{api_server}/os-floating-ips