Difference between revisions of "Designate/Blueprints/ReverseFixedIP"
< Designate | Blueprints
(→Create the PTR Record (POST)) |
(→API Details: GET / POST / DELETE) |
||
Line 20: | Line 20: | ||
Using the general endpoint call "/reverse" add the fixed IP resource called "fixedips". | Using the general endpoint call "/reverse" add the fixed IP resource called "fixedips". | ||
− | === API Details | + | === API Details === |
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
Line 27: | Line 27: | ||
| GET || /reverse/fixedips/{IP address} || Return the PTR record for the given IP address. | | GET || /reverse/fixedips/{IP address} || Return the PTR record for the given IP address. | ||
|- | |- | ||
− | | | + | | PATCH || /reverse/fixedips/{IP address} || Set or unset the PTR record for the given IP address. |
− | |||
− | |||
|} | |} | ||
Line 49: | Line 47: | ||
"description": null, | "description": null, | ||
"links": { | "links": { | ||
− | "self": "http://endpoint/v2/reverse/fixedips/< | + | "self": "http://endpoint/v2/reverse/fixedips/<ip address>" |
} | } | ||
} | } | ||
Line 77: | Line 75: | ||
"description": null, | "description": null, | ||
"links": { | "links": { | ||
− | "self": "http://endpoint/v2/reverse/fixedips/< | + | "self": "http://endpoint/v2/reverse/fixedips/<ip address>" |
} | } | ||
} | } | ||
Line 84: | Line 82: | ||
==== Unset the PTR Record (PATCH) ==== | ==== Unset the PTR Record (PATCH) ==== | ||
− | Unset the PTR record for the given | + | Unset the PTR record for the given IP address. |
'''Request''' | '''Request''' |
Revision as of 19:09, 4 March 2014
Contents
Overview
Gerrit Patch | [] |
---|---|
Launchpad Blueprint | [1] |
Summary
This blueprint proposes to provide an interface for a VM instance's PTR record based on the allocated Fixed IP.
This blueprint is based on the blueprint done for floating IPs:
Designate/Blueprints/Reverse
API Resource - Private / Fixed IPs
Using the general endpoint call "/reverse" add the fixed IP resource called "fixedips".
API Details
Verb | Resource | Description |
---|---|---|
GET | /reverse/fixedips/{IP address} | Return the PTR record for the given IP address. |
PATCH | /reverse/fixedips/{IP address} | Set or unset the PTR record for the given IP address. |
Get the PTR Record (GET)
Return the PTR record for the given instance ID.
There is no request message body.
Response
{ “fixedip”: { "id": "<uuid>", "ptrdname": "server.mydomain.com.", "address": "<ipv4 or ipv6 compliant address>", "ttl": 3600, "created_at": "2014-03-04T11:00:01.000000", "update_at": null, "description": null, "links": { "self": "http://endpoint/v2/reverse/fixedips/<ip address>" } } }
Set the PTR Record (PATCH)
Set the PTR record for the given IP address.
Request
{ "fixedip": { "ptrdname": "server.mydomain.com.", "ttl": 3600 } }
Response
{ “fixedip”: { "id": "<uuid>", "ptrdname": "server.mydomain.com.", "address": "<ipv4 or ipv6 compliant address>", "ttl": 3600, "created_at": "2014-03-04T11:00:01.000000", "update_at": null, "description": null, "links": { "self": "http://endpoint/v2/reverse/fixedips/<ip address>" } } }
Unset the PTR Record (PATCH)
Unset the PTR record for the given IP address.
Request
{ "fixedip": { "ptrdname": null } }
The return body is empty.
Database Changes
There are no changes to the database schema.