8733f8f85b
The new API would be v2/zones/<zone_id>/tasks/move Only POST would be allowed on this API. This move zone from existing pool and add it in new pool. After zone pool_id field will be updated in DB, clone-zone will be created on target pool backend servers. The zone transfer(AXFR/IXFR) will happen and the zone on target pool gets synced with the Designate DB. This command serve as replacement to "zone export + zone delete + zone import" procedure. Added following things in pool move operation: - Add/Update NS servers of new pool in the zone Implements: blueprint zone-move Change-Id: I5307de429114b20efd9785c3c0cdb33977418423
158 lines
2.8 KiB
HTML
158 lines
2.8 KiB
HTML
==========
|
|
Zone Tasks
|
|
==========
|
|
|
|
Zone tasks.
|
|
|
|
|
|
Abandon Zone
|
|
============
|
|
|
|
.. rest_method:: POST /v2/zones/{zone_id}/tasks/abandon
|
|
|
|
Abandon a zone.
|
|
|
|
This removes a zone from the designate database without removing it
|
|
from the backends.
|
|
|
|
.. note:: This POST should have no body.
|
|
|
|
.. warning::
|
|
This is a protentially dangerous operation, and should only be used if required
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 204
|
|
|
|
|
|
.. 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
|
|
|
|
|
|
Manually Trigger an Update of a Secondary Zone
|
|
==============================================
|
|
|
|
.. rest_method:: POST /v2/zones/{zone_id}/tasks/xfr
|
|
|
|
Trigger a new XFR from the upstream DNS servers
|
|
|
|
This will cause designate to query the name servers and if the version in
|
|
Designate is out of date, import the new version.
|
|
|
|
This is useful if an upstream server failed to send a notify to Designate
|
|
|
|
.. note:: This POST should have no body.
|
|
|
|
.. important:: This is only useful on SECONDARY zones.
|
|
|
|
.. 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
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|
|
|
|
|
|
|
|
Pool Move Zone
|
|
==============
|
|
|
|
.. rest_method:: POST /v2/zones/{zone_id}/tasks/pool_move
|
|
|
|
Move a zone to another pool.
|
|
|
|
This moves a zone from the existing designate pool to specified target pool. If
|
|
pool is not specified by admin, designate will determine suitable pool by
|
|
itself and move zone to that pool.
|
|
|
|
.. rest_status_code:: success status.yaml
|
|
|
|
- 202
|
|
|
|
|
|
.. rest_status_code:: error status.yaml
|
|
|
|
- 400
|
|
- 401
|
|
- 403
|
|
- 404
|
|
- 405
|
|
- 500
|
|
- 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
|
|
- pool_id: zone_pool_target_id
|
|
|
|
Request Example
|
|
---------------
|
|
|
|
.. literalinclude:: samples/zones/poolmove-zone-request.json
|
|
:language: javascript
|
|
|
|
|
|
Response Parameters
|
|
-------------------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- x-openstack-request-id: x-openstack-request-id
|