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.

Request Params

KeyDatatypeRequiredDescription
contractIdstring(Required) The contract to use for the new zone.
gidstring(Required) The currently selected group ID to manage.
accountSwitchKeystring(Optional) For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Request Body

{"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"}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: Created

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