Logo
Akamai APIs API Documentation

Submit a bulk zone create request

POST https://{{host}}/config-dns/v2/zones/create-requests?contractId={{contractId}}&gid={{gid}}

Submits a request to create one or more new Zones asynchronously. The request body contains a JSON array. Each object in the array contains the data necessary to create a zone. All zones are created on the same contract and group. An offline task creates the new zones. You can use the response's requestId to check the task's status and view its results once it completes.

 

Body PARAM

Key Datatype Required Description 
contractId
string (Required) The contract to use for the new zone.
gid
string (Required) The currently selected group ID to manage.
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string




RESPONSES

status Created

{ "expirationDate": "2021-01-03T12:00:00Z", "requestId": "e585a640-0849-4b87-8dd9-91afdaf8851c" }



Curl
curl -X POST 'https://undefined/config-dns/v2/zones/create-requests?contractId=&gid=?contractId=&gid=&accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"zones":[{"comment":"Adding bodies of water","masters":["192.0.2.20","192.0.2.91"],"type":"SECONDARY","zone":"river.com"},{"comment":"Adding bodies of water","masters":["192.0.2.245","192.0.2.208"],"type":"SECONDARY","zone":"lake.com"},{"comment":"Adding bodies of water","masters":["192.0.2.69","192.0.2.62"],"type":"SECONDARY","zone":"ocean.com"}]}'

ENDPOINTS