===================================
Zone Ownership Transfers - Requests
===================================

Designate allows users to transer ownership of a zone between projects.

The traditional route is to create a ``zone_transfer_request``, communicate
the key and ID out of band to the intended owner, and they create a
``zone_transfer_accept`` using this information, which will move the
ownership of the zone that project.


Create Zone Transfer Request
============================

.. rest_method::  POST /v2/zones/{zone_id}/tasks/transfer_requests

This creates an offer to transfer the zone to a different project.
The request can be scoped to single project if the ``project_id`` parameter is
supplied.

.. note:: This POST can have no body.


Normal response codes: 201

Error response codes: 405,404,403,401,400,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
   - target_project_id: zone_transfer_request_target_project_id
   - description: description

Request Example
----------------

.. literalinclude:: samples/zones/create-zone-transfer-request-request.json
   :language: javascript


Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - x-openstack-request-id: x-openstack-request-id
   - id: zone_transfer_request_id
   - project_id: project_id
   - description: description
   - status: zone_transfer_request_status
   - zone_id: zone_transfer_request_zone_id
   - zone_name: zone_transfer_request_zone_name
   - key: zone_transfer_request_key
   - target_project_id: zone_transfer_request_target_project_id
   - created_at: created_at
   - updated_at: updated_at
   - version: version

Response Example
----------------

.. literalinclude:: samples/zones/create-zone-transfer-request-response.json
   :language: javascript


List Zone Transfer Requests
===========================

.. rest_method::  GET /v2/zones/tasks/transfer_requests

This will list all your outgoing requests, and any incoming requests that
have been scoped to your project.

Normal response codes: 200

Error response codes: 405,404,403,401,400,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
   - status: zone_transfer_request_status_filter


Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - x-openstack-request-id: x-openstack-request-id
   - id: zone_transfer_request_id
   - project_id: project_id
   - description: description
   - status: zone_transfer_request_status
   - zone_id: zone_transfer_request_zone_id
   - zone_name: zone_transfer_request_zone_name
   - key: zone_transfer_request_key
   - target_project_id: zone_transfer_request_target_project_id
   - created_at: created_at
   - updated_at: updated_at
   - version: version

Response Example
----------------

.. literalinclude:: samples/zones/list-zone-transfer-request-response.json
   :language: javascript



Show a Zone Transfer Request
============================

.. rest_method::  GET /v2/zones/tasks/transfer_requests/{zone_transfer_request_id}


Normal response codes: 200

Error response codes: 405,404,403,401,400,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_transfer_request_id: path_zone_transfer_request_id


Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - x-openstack-request-id: x-openstack-request-id
   - id: zone_transfer_request_id
   - project_id: project_id
   - description: description
   - status: zone_transfer_request_status
   - zone_id: zone_transfer_request_zone_id
   - zone_name: zone_transfer_request_zone_name
   - key: zone_transfer_request_key
   - target_project_id: zone_transfer_request_target_project_id
   - created_at: created_at
   - updated_at: updated_at
   - version: version

Response Example
----------------

.. literalinclude:: samples/zones/show-zone-transfer-request-response.json
   :language: javascript


Update a Zone Transfer Request
==============================

.. rest_method::  PATCH /v2/zones/tasks/transfer_requests/{zone_transfer_request_id}


Normal response codes: 200

Error response codes: 405,404,403,401,400,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_transfer_request_id: path_zone_transfer_request_id
   - target_project_id: zone_transfer_request_target_project_id
   - description: description

Request Example
----------------

.. literalinclude:: samples/zones/update-zone-transfer-request-request.json
   :language: javascript


Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - x-openstack-request-id: x-openstack-request-id
   - id: zone_transfer_request_id
   - project_id: project_id
   - description: description
   - status: zone_transfer_request_status
   - zone_id: zone_transfer_request_zone_id
   - zone_name: zone_transfer_request_zone_name
   - key: zone_transfer_request_key
   - target_project_id: zone_transfer_request_target_project_id
   - created_at: created_at
   - updated_at: updated_at
   - version: version

Response Example
----------------

.. literalinclude:: samples/zones/update-zone-transfer-request-response.json
   :language: javascript


Delete a Zone Transfer Request
==============================

.. rest_method::  DELETE /v2/zones/tasks/transfer_requests/{zone_transfer_request_id}


Normal response codes: 204

Error response codes: 405,404,403,401,400,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_transfer_request_id: path_zone_transfer_request_id


Response Parameters
-------------------

.. rest_parameters:: parameters.yaml

   - x-openstack-request-id: x-openstack-request-id