Get Configuration

Retrieves a configuration by ID (restricted by permitted control-plane read).

get
https://global.api.konghq.com/v2/cloud-gateways/configurations/{configurationId}

Path Parameters

configurationIdstring(uuid)requiredread-only

The ID of the configuration to operate on.

Example:edaf40f9-9fb0-4ffe-bb74-4e763a6bd471

Response

application/json

Response format for retrieving a configuration by ID.

Configuration

Object containing information about a control-plane’s cloud-gateways configuration.

idstring(uuid)requiredread-only

Example:edaf40f9-9fb0-4ffe-bb74-4e763a6bd471

versionstring

Supported gateway version. For serverless.v1 kind of cloud gateways, this field should be omitted.

Example:3.2

api_accessstring

Type of API access data-plane groups will support for a configuration.

Allowed values:privatepublicprivate+public

Default:private+public

Example:private+public

dataplane_group_configarray[object]required

Object that describes where a data-plane group will be deployed to, along with how many instances.

* Additional properties are NOT allowed.
Show Child Parameters
dataplane_groupsarray[object](set)required

Object that describes the set of data-plane groups currently pointed to this configuration.

Show Child Parameters
kindstring

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

Kind of the Cloud Gateway deployment. If serverless.v1 is specified, the following fields
should be omitted (will be ignored if provided): autoscale, cloud_gateway_network_id, version.

Allowed values:dedicated.v0serverless.v1

Default:dedicated.v0

entity_versionnumberrequiredread-only

Positive, monotonically increasing version integer, to serialize configuration changes.

Example:1

created_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of configuration creation date.

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

updated_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of configuration update date.

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

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

get/cloud-gateways/configurations/{configurationId}
 
application/json

Networks

List Networks

Returns a paginated list of networks.

get
https://global.api.konghq.com/v2/cloud-gateways/networks

Query Parameters

filterobject

Filters supported for networks.

* Additional properties are NOT allowed.
Show Child 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 networks.

ListNetworksResponse

metaobjectrequired

returns the pagination information

Show Child Parameters
dataarray[object]required

Object containing information about a network to be used in configurations.

Show Child Parameters
get/cloud-gateways/networks
 
application/json

Create Network

Creates a new network for a given provider account.

post
https://global.api.konghq.com/v2/cloud-gateways/networks

Body

application/json

CreateNetworkRequest

Request schema for creating a network.

* Additional properties are NOT allowed.
namestringrequired

Human-readable name of the network.

Example:us-east-2 network

cloud_gateway_provider_account_idstring(uuid)required

Example:929b2449-c69f-44c4-b6ad-9ecec6f811ae

regionstringrequired

Region ID for cloud provider region.

Example:us-east-2

availability_zonesarray[string]required

List of availability zones that the network is attached to.

Example:["use2-az1","use2-az2","use2-az3"]

cidr_blockstringrequired

CIDR block configuration for the network.

Example:10.0.0.0/8

statestring

Initial state for creating a network.

Allowed values:initializingoffline

Default:initializing

Response

application/json

Response format for creating a network.

Network

Object containing information about a network to be used in configurations.

idstring(uuid)required

The network ID to operate on. For serverless.v1 kind of cloud gateways, this field should be omitted.

Example:36ae63d3-efd1-4bec-b246-62aa5d3f5695

namestringrequired

Human-readable name of the network.

Example:us-east-2 network

defaultbooleanrequired

Whether the network is a default network or not. Default networks are Networks that are created
automatically by Konnect when an organization is linked to a provider account.

Example:false

cloud_gateway_provider_account_idstring(uuid)required

Example:929b2449-c69f-44c4-b6ad-9ecec6f811ae

regionstringrequired

Region ID for cloud provider region.

Example:us-east-2

availability_zonesarray[string]required

List of availability zones that the network is attached to.

Example:["use2-az1","use2-az2","use2-az3"]

cidr_blockstringrequired

CIDR block configuration for the network.

Example:10.0.0.0/8

staterequiredread-only

State of the network.

Allowed values:createdinitializingofflinereadyterminatingterminated

state_metadataobjectread-only

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

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

Metadata describing attributes returned by cloud-provider for the network.

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

The number of transit gateways attached to this network.

Example:0

configuration_reference_countintegerrequiredread-only

The number of configurations that reference this network.

Example:0

entity_versionintegerrequiredread-only

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

Example:1

created_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of network creation date.

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

updated_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of network update date.

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

post/cloud-gateways/networks

Body

{ "name": "us-east-2 network", "cloud_gateway_provider_account_id": "929b2449-c69f-44c4-b6ad-9ecec6f811ae", "region": "us-east-2", "availability_zones": [ "use2-az1", "use2-az2", "use2-az3" ], "cidr_block": "10.0.0.0/8" }
 
application/json

Get Network

Retrieves a network by ID.

get
https://global.api.konghq.com/v2/cloud-gateways/networks/{networkId}

Path Parameters

networkIdstring(uuid)required

The network ID to operate on. For serverless.v1 kind of cloud gateways, this field should be omitted.

Example:36ae63d3-efd1-4bec-b246-62aa5d3f5695

Response

application/json

Response format for retrieving a network.

Network

Object containing information about a network to be used in configurations.

idstring(uuid)required

The network ID to operate on. For serverless.v1 kind of cloud gateways, this field should be omitted.

Example:36ae63d3-efd1-4bec-b246-62aa5d3f5695

namestringrequired

Human-readable name of the network.

Example:us-east-2 network

defaultbooleanrequired

Whether the network is a default network or not. Default networks are Networks that are created
automatically by Konnect when an organization is linked to a provider account.

Example:false

cloud_gateway_provider_account_idstring(uuid)required

Example:929b2449-c69f-44c4-b6ad-9ecec6f811ae

regionstringrequired

Region ID for cloud provider region.

Example:us-east-2

availability_zonesarray[string]required

List of availability zones that the network is attached to.

Example:["use2-az1","use2-az2","use2-az3"]

cidr_blockstringrequired

CIDR block configuration for the network.

Example:10.0.0.0/8

staterequiredread-only

State of the network.

Allowed values:createdinitializingofflinereadyterminatingterminated

state_metadataobjectread-only

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

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

Metadata describing attributes returned by cloud-provider for the network.

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

The number of transit gateways attached to this network.

Example:0

configuration_reference_countintegerrequiredread-only

The number of configurations that reference this network.

Example:0

entity_versionintegerrequiredread-only

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

Example:1

created_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of network creation date.

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

updated_atstring(date-time)requiredread-only

An RFC-3339 timestamp representation of network update date.

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

get/cloud-gateways/networks/{networkId}
 
application/json