Get Custom Domain

Retrieves a custom domain by ID (restricted by permitted control-plane reads).

get
https://global.api.konghq.com/v3/cloud-gateways/custom-domains/{customDomainId}

Path Parameters

customDomainIdstring(uuid)requiredread-only

ID of the custom domain to operate on.

Example:39ed3790-085d-4605-9627-f96d86aaf425

Response

application/json

Response format for retrieving a custom domain for a control-plane.

Custom Domain

Custom Domainobject

Object containing information about a custom domain for a control-plane.

One Of
idstring(uuid)requiredread-only

Example:39ed3790-085d-4605-9627-f96d86aaf425

kindstringrequired

Allowed values:dedicated.v0

control_plane_idstring(uuid)required

Example:0949471e-b759-45ba-87ab-ee63fb781388

control_plane_geostringrequired

Set of control-plane geos supported for deploying cloud-gateways configurations.

Allowed values:useuaumeinsg

domainstringrequired

Domain name of the custom domain.

Example:example.com

certificate_idstring | null(uuid)read-only

Certificate ID for the certificate representing this domain and stored on data-planes for this
control-plane. Can be retrieved via the control-planes API for this custom domain’s control-plane.

Example:3b7cbeee-fbec-440e-a5ef-89e7dec3b9d0

sni_idstring | null(uuid)read-only

Server Name Indication ID for this domain and stored on data-planes for this control-plane. Can be retrieved
via the control-planes API for this custom domain’s control-plane.

Example:a8f11ea8-af09-4422-9735-5d4f8910aba1

statestringrequiredread-only

State of the custom domain.

Allowed values:createdinitializingreadyterminatingterminatederror

state_metadataobjectrequiredread-only

Metadata describing the backing state of the custom domain and why it may be in an erroneous state.

* Additional properties are NOT allowed.
Show Child Parameters
entity_versionintegerrequiredread-only

Monotonically-increasing version count of the custom domain, to indicate the order of updates to the custom
domain.

Example:1

created_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of custom domain creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of custom domain update date.

Example:2022-11-04T20:10:06.927Z

get/cloud-gateways/custom-domains/{customDomainId}
 
application/json

Delete Custom Domain

Deletes a custom domain by ID (restricted by permitted control-plane reads).

delete
https://global.api.konghq.com/v3/cloud-gateways/custom-domains/{customDomainId}

Path Parameters

customDomainIdstring(uuid)requiredread-only

ID of the custom domain to operate on.

Example:39ed3790-085d-4605-9627-f96d86aaf425

Response

No Content

delete/cloud-gateways/custom-domains/{customDomainId}
 

Get Custom Domain Online Status

Retrieves the CNAME and SSL status of a custom domain.

get
https://global.api.konghq.com/v3/cloud-gateways/custom-domains/{customDomainId}/online-status

Path Parameters

customDomainIdstring(uuid)requiredread-only

ID of the custom domain to operate on.

Example:39ed3790-085d-4605-9627-f96d86aaf425

Response

application/json

Response format for retrieving the CNAME and SSL status of a custom domain.

Custom Domain Online Status

* Additional properties are NOT allowed.
cnamestringrequiredread-only

Set of available statuses for the online properties of a custom domain.

Allowed values:verifiedunverified

sslstringrequiredread-only

Set of available statuses for the online properties of a custom domain.

Allowed values:verifiedunverified

get/cloud-gateways/custom-domains/{customDomainId}/online-status
 
application/json

Control-Plane Geo

string

Set of control-plane geos supported for deploying cloud-gateways configurations.

Allowed values:useuaumeinsg

ControlPlaneGeoFieldFilter

One Of
ControlPlaneGeoFieldEqualsFilterOne Of

Filter a control-plane geo by exact match.

Control-Plane Geostring

Set of control-plane geos supported for deploying cloud-gateways configurations.

Allowed values:useuaumeinsg