Konnect Cloud Gateways (3.0.0)

Download OpenAPI specification:Download

Konnect API for managing cloud-gateways infrastructure.

Data-Plane Group Configurations

List Configurations

Returns a paginated collection of dedicated configurations or serverless configurations across control-planes for an organization (restricted by permitted control-plane reads).

Authorizations:

konnectAccessTokenpersonalAccessTokensystemAccountAccessToken

query Parameters

page[size]	integer Example: page[size]=10 The maximum number of items to include per page. The last page of a collection may include fewer items.
page[number]	integer Example: page[number]=1 Determines which page of the entities to retrieve.
	object (ConfigurationsFilterParameters) Filters supported for configurations.

Responses

Response samples

200
400
401
403

Content type

application/json

{"meta": {"page": {"number": 1,
"size": 10,
"total": 100
}
},
"data": [{"id": "f521675a-af6b-4684-be7b-43bc27b20543",
"kind": "dedicated.v0",
"control_plane_id": "b5922611-a763-499e-8d86-5643de122768",
"control_plane_geo": "us",
"version": "3.2",
"api_access": "private",
"dataplane_group_config": [{"provider": "aws",
"region": "us-east-2",
"cloud_gateway_network_id": "aa0b1b44-10eb-483d-8063-661e802782d9",
"autoscale": {"kind": "static",
"instance_type": "small",
"requested_instances": 3
},
"environment": [{"name": "KONG_LOG_LEVEL",
"value": "INFO"
}
]
}
],
"dataplane_groups": [{"id": "14a74117-868a-4859-bf6c-eb2fe301a6ab",
"provider": "aws",
"region": "us-east-2",
"autoscale": {"kind": "static",
"instance_type": "small",
"requested_instances": 3
},
"environment": [{"name": "KONG_LOG_LEVEL",
"value": "INFO"
}
],
"cloud_gateway_network_id": "aa0b1b44-10eb-483d-8063-661e802782d9",
"state": "created",
"private_ip_addresses": ["string"
],
"egress_ip_addresses": ["string"
],
"hostnames": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}
],
"entity_version": 1,
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}
]
}

Create Configuration

Creates a new dedicated or serverless configuration for a control-plane (restricted by permitted control-plane permissions for configurations). This request will replace any existing configuration for the requested control_plane_id and control_plane_geo by performing a diff. From this diff, new resources detected in the requested configuration will be added, resources not found in the request configuration but in the previous will be deleted, and resources found in both will be updated to the requested configuration. Networks referenced in this request that are in an offline state will automatically initialize (i.e. move to an initializing state).

Authorizations:

konnectAccessTokenpersonalAccessTokensystemAccountAccessToken

Request Body schema: application/json

One of

kind required	string Enum: "dedicated.v0" "serverless.v0" Provisioning backend to use for deploying data-plane groups.
control_plane_id required	string <uuid> ID of the control-plane this configuration belongs to.
control_plane_geo required	string (Control-Plane Geo) Enum: "us" "eu" "au" "me" "in" Set of control-plane geos supported for deploying cloud-gateways configurations.
version required	string^(\d)+(\.(\d)+)?$ Gateway version to configure data-plane groups with.
required	Array of objects (CreateCloudGatewayConfigurationDataplaneGroup) List of data-plane groups that describe where to deploy instances, along with how many instances.
api_access	string (CloudGatewayApiAccess) Default: "private+public" Enum: "private" "private+public" "public" Type of API access dataplane groups will support for a configuration.

Responses

Request samples

Payload

Content type

application/json

{"kind": "serverless.v0",
"control_plane_id": "b5922611-a763-499e-8d86-5643de122768",
"control_plane_geo": "us",
"dataplane_groups": [{"region": "us"
}
]
}

Response samples

Content type

application/json

Example

Dedicated Configuration

{"id": "f521675a-af6b-4684-be7b-43bc27b20543",
"kind": "dedicated.v0",
"control_plane_id": "b5922611-a763-499e-8d86-5643de122768",
"control_plane_geo": "us",
"version": "3.2",
"api_access": "private",
"dataplane_group_config": [{"provider": "aws",
"region": "us-east-2",
"cloud_gateway_network_id": "aa0b1b44-10eb-483d-8063-661e802782d9",
"autoscale": {"kind": "static",
"instance_type": "small",
"requested_instances": 3
},
"environment": [{"name": "KONG_LOG_LEVEL",
"value": "INFO"
}
]
}
],
"dataplane_groups": [{"id": "14a74117-868a-4859-bf6c-eb2fe301a6ab",
"provider": "aws",
"region": "us-east-2",
"autoscale": {"kind": "static",
"instance_type": "small",
"requested_instances": 3
},
"environment": [{"name": "KONG_LOG_LEVEL",
"value": "INFO"
}
],
"cloud_gateway_network_id": "aa0b1b44-10eb-483d-8063-661e802782d9",
"state": "created",
"private_ip_addresses": ["string"
],
"egress_ip_addresses": ["string"
],
"hostnames": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}
],
"entity_version": 1,
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}

Get Configuration

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

Authorizations:

konnectAccessTokenpersonalAccessTokensystemAccountAccessToken

path Parameters

configurationId

required

string <uuid> (ConfigurationId)

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

The ID of the configuration to operate on.

Responses

Response samples

200
401
403
404

Content type

application/json

Example

Dedicated Configuration

{"id": "f521675a-af6b-4684-be7b-43bc27b20543",
"kind": "dedicated.v0",
"control_plane_id": "b5922611-a763-499e-8d86-5643de122768",
"control_plane_geo": "us",
"version": "3.2",
"api_access": "private",
"dataplane_group_config": [{"provider": "aws",
"region": "us-east-2",
"cloud_gateway_network_id": "aa0b1b44-10eb-483d-8063-661e802782d9",
"autoscale": {"kind": "static",
"instance_type": "small",
"requested_instances": 3
},
"environment": [{"name": "KONG_LOG_LEVEL",
"value": "INFO"
}
]
}
],
"dataplane_groups": [{"id": "14a74117-868a-4859-bf6c-eb2fe301a6ab",
"provider": "aws",
"region": "us-east-2",
"autoscale": {"kind": "static",
"instance_type": "small",
"requested_instances": 3
},
"environment": [{"name": "KONG_LOG_LEVEL",
"value": "INFO"
}
],
"cloud_gateway_network_id": "aa0b1b44-10eb-483d-8063-661e802782d9",
"state": "created",
"private_ip_addresses": ["string"
],
"egress_ip_addresses": ["string"
],
"hostnames": ["string"
],
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}
],
"entity_version": 1,
"created_at": "2022-11-04T20:10:06.927Z",
"updated_at": "2022-11-04T20:10:06.927Z"
}