api.dc.domain

/dc/(dc)/domain

api.dc.domain.views.dc_domain_list(*args, **kwargs)

List (GET) available DNS domains in current datacenter.

GET /dc/(dc)/domain

DC-bound?:

• ✓

Permissions:

• Admin

Asynchronous?:

• ✗

Parameters:

• request.dc (string) – required - Datacenter name
• data.full (boolean) – Return list of objects with all DNS domain details (default: false)
• data.order_by (string) – Available fields for sorting: name (default: name)

Status Codes:

• 200 OK – SUCCESS
• 403 Forbidden – Forbidden
• 404 Not Found – Datacenter not found

/dc/(dc)/domain/(name)

api.dc.domain.views.dc_domain(*args, **kwargs)

Show (GET), create (POST) or delete (DELETE) a DNS domain (name) association with a datacenter (dc).

GET /dc/(dc)/domain/(name)

DC-bound?:

• ✓

Permissions:

• Admin

Asynchronous?:

• ✗

Parameters:

• request.dc (string) – required - Datacenter name
• name (string) – required - DNS domain name

Status Codes:

• 200 OK – SUCCESS
• 403 Forbidden – Forbidden
• 404 Not Found – Datacenter not found / Domain not found

POST /dc/(dc)/domain/(name)

DC-bound?:

• ✓

Permissions:

• SuperAdmin

Asynchronous?:

• ✗

Parameters:

• request.dc (string) – required - Datacenter name
• name (string) – required - DNS domain name

Status Codes:

• 201 Created – SUCCESS
• 403 Forbidden – Forbidden
• 404 Not Found – Datacenter not found / Domain not found
• 406 Not Acceptable – Domain already exists

DELETE /dc/(dc)/domain/(name)

DC-bound?:

• ✓

Permissions:

• SuperAdmin

Asynchronous?:

• ✗

Parameters:

• request.dc (string) – required - Datacenter name
• name (string) – required - DNS domain name

Status Codes:

• 200 OK – SUCCESS
• 403 Forbidden – Forbidden
• 404 Not Found – Datacenter not found / Domain not found
• 417 Expectation Failed – Default VM domain cannot be removed from datacenter