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