Get Custom Domain

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

get
https://global.api.konghq.com/v2/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

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

idstring(uuid)requiredread-only

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

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

kindstring

Pre-release Feature
This feature is currently in beta and is subject to change.

Kind of the custom domain based on Cloud Gateway deployment.

Allowed values:dedicated.v0serverless.v1

Default:dedicated.v0

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/v2/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/v2/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

Cloud Gateways Resource Quotas

List Default Resource Quotas

Returns a paginated collection of default resource quotas for cloud-gateways, along with
organizationally-defined overrides for those resource quotas.

get
https://global.api.konghq.com/v2/cloud-gateways/default-resource-quotas

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

Response

application/json

A paginated list for a collection of default resource quotas.

ListDefaultResourceQuotasResponse

metaobjectrequired

returns the pagination information

Show Child Parameters
dataarray[object]required

Object containing information about a default resource quota, and any organizational overrides.

Show Child Parameters
get/cloud-gateways/default-resource-quotas
 
application/json