FloatingIPs¶
In order to use the FloatingIPs functionality you will need to have a FloatingIP associated to your project in Neutron.
Set FloatingIP’s PTR record¶
-
PATCH
/reverse/floatingips/
(string: region):
(uuid: floatingip_id)¶ Set a PTR record for the given FloatingIP. The domain if it does not exist will be provisioned automatically.
Example request:
POST /reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd HTTP/1.1 Host: example.com Accept: application/json Content-Type: application/json { "ptrdname" : "smtp.example.com.", "description" : "This is a floating ip for 10.0.0.1", "ttl": 600 }
Example response:
HTTP/1.1 202 Created Content-Type: application/json; charset=UTF-8 Location: http://example.com:9001/v2/reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd { "ptrdname": "smtp.example.com.", "ttl": 600, "description":"This is a floating ip for 172.24.4.3", "address": "172.24.4.3", "action": "CREATE", "status": "PENDING", "links":{ "self":"http://example.com:9001/v2/reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd" }, "pattern":"smtp.example.com.", "created_at":"2014-03-11T21:54:57.000000", "updated_at":null, "id":"RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd", }
Form Parameters: - created_at – timestamp
- updated_at – timestamp
- ptrdname – Hostname
- ttl – Time to live
- address – The FloatingIP address
- id – A combination of the Region and FloatingIP ID
- description – UTF-8 text field
- links – links to traverse the list
- action – Provisioning Action
- status – Provisioning Status
Status Codes: - 202 Accepted – Created
- 401 Unauthorized – Access Denied
- 400 Bad Request – Invalid Object
- 404 Not Found – FloatingIP / PTR Not found
Get a FloatingIP’s PTR record¶
-
GET
/reverse/floatingips/
(string: region):
(uuid: floatingip_id)¶ Shows a particular FloatingIP PTR
Example request:
GET /reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd HTTP/1.1 Host: example.com Accept: application/json
Example response:
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 { "ptrdname": "smtp.example.com.", "ttl": 600, "description":"This is a floating ip for 172.24.4.3", "address": "172.24.4.3", "action": "NONE", "status": "ACTIVE", "links":{ "self":"http://example.com:9001/v2/reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd" }, "pattern":"smtp.example.com.", "created_at":"2014-03-11T21:54:57.000000", "updated_at":null, "id":"RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd", }
Form Parameters: - created_at – timestamp
- updated_at – timestamp
- ptrdname – Hostname
- ttl – Time to live
- address – The FloatingIP address
- id – A combination of the Region and FloatingIP ID
- description – UTF-8 text field
- links – links to traverse the list
- action – Provisioning Action
- status – Provisioning Status
Status Codes: - 200 OK – OK
- 404 Not Found – FloatingIP or PTR not found not found
List FloatingIP PTR records¶
-
GET
/reverse/floatingips/
¶ Lists all FloatingIPs PTR records
Example request:
GET /reverse/floatingips/ HTTP/1.1 Host: example.com Accept: application/json
Example response:
HTTP/1.1 200 OK Content-Type: application/json; charset=UTF-8 { "floatingips":[ { "ttl": 600, "ptrdname": "smtp.example.com.", "description":"This is a floating ip for 172.24.4.3", "address": "172.24.4.3", "action": "NONE", "status": "ACTIVE", "links":{ "self":"http://example.com:9001/v2/reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd" }, "pattern":"smtp.example.com.", "created_at":"2014-03-11T21:54:57.000000", "updated_at":null, "id":"RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd", }, { "ptrdname": "www.example.com.", "ttl": 600, "description":"This is a floating ip for 172.24.4.4", "address": "172.24.4.4", "action": "NONE", "status": "ACTIVE", "links":{ "self":"http://example.com:9001/v2/reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4be" }, "pattern":"smtp.example.com.", "created_at":"2014-03-11T21:54:57.000000", "updated_at":null, "id":"RegionOne:c47229fb-0831-4b55-a5b5-380d361be4be", } ], "links":{ "self":"http://127.0.0.1:9001/v2/tlds" } }
Form Parameters: - created_at – timestamp
- updated_at – timestamp
- name – tld name
- id – uuid
- description – UTF-8 text field
- links – links to traverse the list
Status Codes: - 200 OK – OK
- 401 Unauthorized – Access Denied
Unset the PTR record for a FloatingIP¶
-
PATCH
/reverse/floatingips/
(string: region):
(uuid: floatingip_id)¶ Unset a PTR record for the given FloatingIP.
Example request:
PATCH /reverse/floatingips/RegionOne:c47229fb-0831-4b55-a5b5-380d361be4bd HTTP/1.1 Host: example.com Accept: application/json Content-Type: application/json { "ptrdname" : null, }
Status Codes: - 202 Accepted – Pending
- 401 Unauthorized – Access Denied
- 400 Bad Request – Invalid Object
- 404 Not Found – FloatingIP / PTR Not found