Look up a domain's existing records into a proposal
Writes nothing: asks the nameservers the domain's parent delegates it to for a fixed list of common names and types, and answers what it found, to review and apply through records/changes. DNS can't list a zone, so names outside that list aren't found. Takes about 8 seconds at most, and answers what it found by then, with one note in skipped whose type is empty when it couldn't ask everything. A domain that isn't delegated, or that's delegated to EZGH DNS, gives an empty proposal. Takes no body. Refused with 409 zone_deleting once the zone is being deleted. Takes no Idempotency-Key: it keeps nothing, so a retry runs again.
https://dns-api.ezghcloud.com/v1/organizations/{orgId}/projects/{projectId}/zones/{zoneId}/records/scanAuthorization
Path parameters
Returns
200
A proposal. Nothing has been written: apply it through records/changes.
400
invalid_request (with issues), invalid_cursor, or the endpoint's own 400 codes.
403
access_denied: the caller's policies don't allow the action; forbidden_origin: a cookie-authenticated write from an origin that isn't allowed; spend_limit_reached.
404
not_found: unknown, malformed, or in an organization the caller isn't in.
409
quota_exceeded (an allocation quota, with quota), idempotency_conflict, idempotency_in_progress (with Retry-After), organization_deletion_pending, operation_in_progress, or the endpoint's own 409 codes.
413
payload_too_large: the body is over the endpoint's limit (1 MiB unless it says otherwise).
429
too_many_requests, with Retry-After; or quota_exceeded (a rate, usage or concurrency quota, with quota), never with Retry-After.
500
internal_error: a bug; the details are in the logs, under the request ID.