Create a DNS Zone

post

https://{region}.api.jamfcloud.com/securitycloud/v1/dns/zones

Creates a new DNS Zone for the tenant from the supplied definition. Returns a reference to the newly created Zone, including its identifier and canonical URL. A tenant may hold at most a per-customer maximum number of DNS Zones (value TBD); a request that would exceed this per-customer cap is rejected with 400 LIST_SIZE_EXCEEDED.

Required Permissions: ztna:create

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Headers

X-Tenant-Id

uuid

^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

The tenant UUID identifier. Send it to address tenant scope. This API is also published at environment scope — send that scope's header instead. Send exactly one scope header per request.

X-Environment-Id

uuid

^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

The environment UUID identifier. Send it to address environment scope. This API is also published at tenant scope — send that scope's header instead. Send exactly one scope header per request.

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201The DNS Zone was created. A reference to the new Zone is returned.

401Unauthorized. The access token is missing, invalid, or expired, or the token belongs to a different organization than the tenant in the request path.

403Forbidden. The authenticated principal does not hold the privilege required to perform this operation.

409Conflict. A DNS Zone with the same name or overlapping domain already exists for the tenant.

422Unprocessable Entity. The request is well formed but cannot be processed: the referenced gateway is unknown or not owned by the tenant (GATEWAY_NOT_FOUND), a name server IP falls outside the permitted range (NAMESERVER_IP_OUT_OF_RANGE) or is otherwise restricted (NAMESERVER_IP_RESTRICTED).

429Too Many Requests. The client has exceeded the rate limit for this endpoint. Inspect the RateLimit-* and Retry-After headers to determine when to retry.

503Service Unavailable. A downstream dependency required to validate route ownership was unavailable. The request may be retried.