summaryrefslogtreecommitdiff
path: root/api-ref/source/dns-api-v2-zone-tasks.inc
blob: 06e179dfc86db5b5fa4e26e07be8557671da74a9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
==========
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

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_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.

Normal response codes: 202

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

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

.. rest_parameters:: parameters.yaml

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