Getting startedGuidesReferenceChangelog
Apoxy:// Docs / Reference / DomainZone

DomainZone

API reference for Domain Zones (core.apoxy.dev/v1alpha3)

API Group: core.apoxy.dev/v1alpha3

Operations

List Domain Zones

GET/apis/core.apoxy.dev/v1alpha3/domainzones

List DomainZone

Response

  • 200: OK

Create Domain Zone

POST/apis/core.apoxy.dev/v1alpha3/domainzones

Create a DomainZone

Request Body

Spec fields (DomainZoneSpec):

FieldTypeDescription
nameserversstring[]Nameservers to use for this domain zone. If not specified, defaults to Apoxy's nameservers.
registrationConfigRegistrationConfigRegistrationConfig contains configuration for domain registration.

Response

  • 200: OK
  • 201: Created
  • 202: Accepted

Delete All Domain Zones

DELETE/apis/core.apoxy.dev/v1alpha3/domainzones

Delete collection of DomainZone

Response

  • 200: OK

Get Domain Zone

GET/apis/core.apoxy.dev/v1alpha3/domainzones/{name}

Get the specified DomainZone

Response

  • 200: OK

Replace Domain Zone

PUT/apis/core.apoxy.dev/v1alpha3/domainzones/{name}

Replace the specified DomainZone

Request Body

Spec fields (DomainZoneSpec):

FieldTypeDescription
nameserversstring[]Nameservers to use for this domain zone. If not specified, defaults to Apoxy's nameservers.
registrationConfigRegistrationConfigRegistrationConfig contains configuration for domain registration.

Response

  • 200: OK
  • 201: Created

Update Domain Zone

PATCH/apis/core.apoxy.dev/v1alpha3/domainzones/{name}

Partially update the specified DomainZone

Response

  • 200: OK
  • 201: Created

Delete Domain Zone

DELETE/apis/core.apoxy.dev/v1alpha3/domainzones/{name}

Delete a DomainZone. Deleting a zone also deletes the DomainRecords in it.

A zone that Apoxy registered for you keeps its registration until it expires. To release such a zone before it expires, set spec.registrationConfig.autoRenew to false and then delete the zone. The domain stays registered to you until the end of the paid term and is not renewed.

Response

  • 200: OK
  • 202: Accepted

Schema Reference

RegistrationConfig

FieldTypeDescription
autoRenewbooleanAutoRenew indicates whether the domain should be automatically renewed. A registered zone with autoRenew: false can be deleted before it expires.
registrantRegistrantRegistrant contains the registrant contact information.
registrationPeriodYearsinteger (int32)RegistrationPeriodYears is the number of years to register the domain for.

Registrant

FieldTypeDescription
addressAddressAddress of the registrant.
emailstringEmail of the registrant.
firstNamestringFirstName of the registrant.
lastNamestringLastName of the registrant.
organizationstringOrganization of the registrant.
phonestringPhone number of the registrant.

Address

FieldTypeDescription
addressLine1stringAddress line 1.
addressLine2stringAddress line 2.
citystringCity.
countrystringCountry code (ISO 3166-1 alpha-2).
postalCodestringPostalCode or ZIP code.
stateProvincestringState or province.