c9f5ad3bcf
As discussed at summit, the version part of the URL is not really relevant, or a thing a user should be filling out themselves, this should instead be set by the service catalog and extracted from the token. This removes it's reference in all documented REST urls, and adds a new section describing how one gets the base URL for all calls. Change-Id: I4306b8c3de0225e54f3909dd8a1fb293c4e5944c
196 lines
4.0 KiB
ReStructuredText
196 lines
4.0 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:parameter_verification
|
|
.. needs:example_verification
|
|
.. needs:body_verification
|
|
|
|
==============================================
|
|
Floating IP DNS records (os-floating-ip-dns)
|
|
==============================================
|
|
|
|
Manages DNS records associated with floating IP addresses. The API
|
|
dispatches requests to a DNS driver that is selected at startup.
|
|
|
|
List Dns Domains
|
|
================
|
|
|
|
.. rest_method:: GET /os-floating-ip-dns
|
|
|
|
Lists registered DNS domains published by the DNS drivers.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), notImplemented(501)
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example List Dns Domains: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-list-resp.json
|
|
:language: javascript
|
|
|
|
Create Or Update Dns Domain
|
|
===========================
|
|
|
|
.. rest_method:: PUT /os-floating-ip-dns/{domain}
|
|
|
|
Creates or updates a DNS domain.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401),
|
|
forbidden(403), notImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- domain: domain
|
|
|
|
**Example Create Or Update Dns Domain: JSON request**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-create-or-update-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example Create Or Update Dns Domain: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-create-or-update-resp.json
|
|
:language: javascript
|
|
|
|
Delete Dns Domain
|
|
=================
|
|
|
|
.. rest_method:: DELETE /os-floating-ip-dns/{domain}
|
|
|
|
Deletes a DNS domain and all associated host entries.
|
|
|
|
Normal response codes: 202
|
|
|
|
Error response codes: unauthorized(401), forbidden(403),
|
|
itemNotFound(404), notImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- domain: domain
|
|
|
|
Response
|
|
--------
|
|
|
|
List Dns Entries
|
|
================
|
|
|
|
.. rest_method:: GET /os-floating-ip-dns/{domain}/entries/{ip}
|
|
|
|
Lists DNS entries for a domain and IP.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403),
|
|
itemNotFound(404), notImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- domain: domain
|
|
- ip: ip
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example List Dns Entries: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-entry-list-resp.json
|
|
:language: javascript
|
|
|
|
Find Unique Dns Entry
|
|
=====================
|
|
|
|
.. rest_method:: GET /os-floating-ip-dns/{domain}/entries/{name}
|
|
|
|
Finds a unique DNS entry for a domain and name.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403),
|
|
itemNotFound(404), notImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- domain: domain
|
|
- name: name
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example Find Unique Dns Entry: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-entry-get-resp.json
|
|
:language: javascript
|
|
|
|
Create Or Update Dns Entry
|
|
==========================
|
|
|
|
.. rest_method:: PUT /os-floating-ip-dns/{domain}/entries/{name}
|
|
|
|
Creates or updates a DNS entry.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), notImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- domain: domain
|
|
- name: name
|
|
|
|
**Example Create Or Update Dns Entry: JSON request**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-create-or-update-entry-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example Create Or Update Dns Entry: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-floating-ip-dns/floating-ip-dns-create-or-update-entry-resp.json
|
|
:language: javascript
|
|
|
|
Delete Dns Entry
|
|
================
|
|
|
|
.. rest_method:: DELETE /os-floating-ip-dns/{domain}/entries/{name}
|
|
|
|
Deletes a DNS entry.
|
|
|
|
Normal response codes: 202
|
|
|
|
Error response codes: unauthorized(401), forbidden(403),
|
|
itemNotFound(404), notImplemented(501)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- domain: domain
|
|
- name: name
|
|
|
|
Response
|
|
--------
|