d193b0c70c
Designate does not delete the zone-files on the back-end when zone is deleted. This results in thousands leftover zone files on backend e.g. bind. Add option in designate zone delete API to force clean/delete zone-files on the back-end. This option is restricted for admin or owner roles. Closes-Bug: 1966517 Change-Id: Ic7b8fee4d4702b0632774d32542b23d7d2a8c253
432 lines
7.3 KiB
PHP
432 lines
7.3 KiB
PHP
====
|
|
Zone
|
|
====
|
|
|
|
Zone operations.
|
|
|
|
|
|
Create Zone
|
|
===========
|
|
|
|
.. rest_method:: POST /v2/zones
|
|
|
|
Create a zone
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 202
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 409
|
|
- 503
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-auth-token: x-auth-token
|
|
- x-auth-all-projects: x-auth-all-projects
|
|
- x-auth-sudo-project-id: x-auth-sudo-project-id
|
|
- name: zone_name
|
|
- email: zone_email
|
|
- ttl: zone_ttl
|
|
- description: zone_description
|
|
- masters: zone_masters
|
|
- type: zone_type
|
|
- attributes: zone_attributes
|
|
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/zones/create-zone-request.json
|
|
:language: javascript
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
- id: id
|
|
- pool_id: zone_pool_id
|
|
- project_id: project_id
|
|
- name: zone_name
|
|
- email: zone_email
|
|
- ttl: zone_ttl
|
|
- serial: zone_serial
|
|
- status: status
|
|
- action: action
|
|
- description: zone_description
|
|
- masters: zone_masters
|
|
- type: zone_type
|
|
- transfered_at: zone_transfered_at
|
|
- version: version
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- attributes: zone_attributes
|
|
- links: links
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/zones/zone-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
List Zones
|
|
==========
|
|
|
|
.. rest_method:: GET /v2/zones
|
|
|
|
List all zones
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 503
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-auth-token: x-auth-token
|
|
- x-auth-all-projects: x-auth-all-projects
|
|
- x-auth-sudo-project-id: x-auth-sudo-project-id
|
|
- limit: limit
|
|
- marker: marker
|
|
- sort_dir: sort_dir
|
|
- sort_key: sort_key
|
|
- name: zone_name_filter
|
|
- type: zone_type_filter
|
|
- email: zone_email_filter
|
|
- status: zone_status_filter
|
|
- description: zone_description_filter
|
|
- ttl: zone_ttl_filter
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
- id: id
|
|
- pool_id: zone_pool_id
|
|
- project_id: project_id
|
|
- name: zone_name
|
|
- email: zone_email
|
|
- ttl: zone_ttl
|
|
- serial: zone_serial
|
|
- status: status
|
|
- action: action
|
|
- description: zone_description
|
|
- masters: zone_masters
|
|
- type: zone_type
|
|
- transfered_at: zone_transfered_at
|
|
- version: version
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- attributes: zone_attributes
|
|
- links: links
|
|
- metadata: metadata
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/zones/list-zones-response.json
|
|
:language: javascript
|
|
|
|
|
|
Show a Zone
|
|
===========
|
|
|
|
.. rest_method:: GET /v2/zones/{zone_id}
|
|
|
|
Show a zone
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 503
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-auth-token: x-auth-token
|
|
- x-auth-all-projects: x-auth-all-projects
|
|
- x-auth-sudo-project-id: x-auth-sudo-project-id
|
|
- zone_id: path_zone_id
|
|
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
- id: id
|
|
- pool_id: zone_pool_id
|
|
- project_id: project_id
|
|
- name: zone_name
|
|
- email: zone_email
|
|
- ttl: zone_ttl
|
|
- serial: zone_serial
|
|
- status: status
|
|
- action: action
|
|
- description: zone_description
|
|
- masters: zone_masters
|
|
- type: zone_type
|
|
- transfered_at: zone_transfered_at
|
|
- version: version
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- attributes: zone_attributes
|
|
- links: links
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/zones/zone-response.json
|
|
:language: javascript
|
|
|
|
|
|
Get the Name Servers for a Zone
|
|
===============================
|
|
|
|
.. rest_method:: GET /v2/zones/{zone_id}/nameservers
|
|
|
|
Show the nameservers for a zone
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 200
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 503
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-auth-token: x-auth-token
|
|
- x-auth-all-projects: x-auth-all-projects
|
|
- x-auth-sudo-project-id: x-auth-sudo-project-id
|
|
- zone_id: path_zone_id
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
- hostname: zone_nameserver_hostname
|
|
- priority: zone_nameserver_priority
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/zones/show-zone-nameservers-response.json
|
|
:language: javascript
|
|
|
|
|
|
|
|
|
|
Update a Zone
|
|
=============
|
|
|
|
.. rest_method:: PATCH /v2/zones/{zone_id}
|
|
|
|
Update the attribute(s) for an existing zone.
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 202
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 503
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-auth-token: x-auth-token
|
|
- x-auth-all-projects: x-auth-all-projects
|
|
- x-auth-sudo-project-id: x-auth-sudo-project-id
|
|
- zone_id: path_zone_id
|
|
- email: zone_email_update
|
|
- ttl: zone_ttl
|
|
- description: zone_description
|
|
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/zones/update-zone-request.json
|
|
:language: javascript
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
- id: id
|
|
- pool_id: zone_pool_id
|
|
- project_id: project_id
|
|
- name: zone_name
|
|
- email: zone_email
|
|
- ttl: zone_ttl
|
|
- serial: zone_serial
|
|
- status: status
|
|
- action: action
|
|
- description: zone_description
|
|
- masters: zone_masters
|
|
- type: zone_type
|
|
- transfered_at: zone_transfered_at
|
|
- version: version
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- attributes: zone_attributes
|
|
- links: links
|
|
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/zones/update-zone-response.json
|
|
:language: javascript
|
|
|
|
|
|
Delete a Zone
|
|
=============
|
|
|
|
.. rest_method:: DELETE /v2/zones/{zone_id}
|
|
|
|
Delete a zone
|
|
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 202
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 503
|
|
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-auth-token: x-auth-token
|
|
- x-auth-all-projects: x-auth-all-projects
|
|
- x-auth-sudo-project-id: x-auth-sudo-project-id
|
|
- x-designate-hard-delete: x-designate-hard-delete
|
|
- zone_id: path_zone_id
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
- id: id
|
|
- pool_id: zone_pool_id
|
|
- project_id: project_id
|
|
- name: zone_name
|
|
- email: zone_email
|
|
- ttl: zone_ttl
|
|
- serial: zone_serial
|
|
- status: status
|
|
- action: action
|
|
- description: zone_description
|
|
- masters: zone_masters
|
|
- type: zone_type
|
|
- transfered_at: zone_transfered_at
|
|
- version: version
|
|
- created_at: created_at
|
|
- updated_at: updated_at
|
|
- attributes: zone_attributes
|
|
- links: links
|
|
|
|
|
|
Response Example
|
|
----------------
|
|
|
|
.. literalinclude:: samples/zones/delete-zone-response.json
|
|
:language: javascript
|