idstring(uuid)required
The control plane ID
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Fetch Control Plane
Returns information about an individual control plane.
get
Path Parameters
Response
application/json
Response
application/json
A response to retrieving a single control plane.
ControlPlane
The control plane object contains information about a Kong control plane.
* Additional properties are NOT allowed.
idstring(uuid)requiredread-only
The control plane ID.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
namestringrequired
The name of the control plane.
Example:Test Control Plane
descriptionstring
The description of the control plane in Konnect.
Example:A test control plane for exploration.
labelsobject
Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters, and cannot start with ‘kong’, ‘konnect’, ‘mesh’, ‘kic’, or ‘_’.
Example:{"env":"test"}
configobjectrequired
CP configuration object for related access endpoints.
* Additional properties are NOT allowed.
Show Child Parameters
created_atstring(date-time)requiredread-only
An ISO-8604 timestamp representation of control plane creation date.
Example:2022-11-04T20:10:06.927Z
updated_atstring(date-time)requiredread-only
An ISO-8604 timestamp representation of control plane update date.
Example:2022-11-04T20:10:06.927Z
get/control-planes/{id}
Authentication
Path Parameters
application/json
Update Control Plane
Update an individual control plane.
patch
Path Parameters
idstring(uuid)required
The control plane ID
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Body
application/json
Body
application/json
UpdateControlPlaneRequest
The request schema for the update control plane request.
* Additional properties are NOT allowed.
namestring
The name of the control plane.
Example:Test Control Plane
descriptionstring
The description of the control plane in Konnect.
Example:A test control plane for exploration.
auth_typestring
The auth type value of the cluster associated with the Runtime Group.
Allowed values:pinned_client_certspki_client_certs
Example:pinned_client_certs
proxy_urlsarray[object](set)
Proxy URL associated with reaching the data-planes connected to a control-plane.
Example:{"host":"example.com","port":443,"protocol":"https"}
* Additional properties are NOT allowed.
Show Child Parameters
labelsobject
Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters, and cannot start with ‘kong’, ‘konnect’, ‘mesh’, ‘kic’, or ‘_’.
Example:{"env":"test"}
Response
application/json
Response
application/json
A response to updating a control plane.
ControlPlane
The control plane object contains information about a Kong control plane.
* Additional properties are NOT allowed.
idstring(uuid)requiredread-only
The control plane ID.
Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7
namestringrequired
The name of the control plane.
Example:Test Control Plane
descriptionstring
The description of the control plane in Konnect.
Example:A test control plane for exploration.
labelsobject
Labels to facilitate tagged search on control planes. Keys must be of length 1-63 characters, and cannot start with ‘kong’, ‘konnect’, ‘mesh’, ‘kic’, or ‘_’.
Example:{"env":"test"}
configobjectrequired
CP configuration object for related access endpoints.
* Additional properties are NOT allowed.
Show Child Parameters
created_atstring(date-time)requiredread-only
An ISO-8604 timestamp representation of control plane creation date.
Example:2022-11-04T20:10:06.927Z
updated_atstring(date-time)requiredread-only
An ISO-8604 timestamp representation of control plane update date.
Example:2022-11-04T20:10:06.927Z
patch/control-planes/{id}
Authentication
Path Parameters
Body
{
"name": "Test Control Plane",
"description": "A test control plane for exploration.",
"proxy_urls": [
{
"host": "example.com",
"port": 443,
"protocol": "https"
}
],
"labels": {
"env": "development"
}
}
application/json
Delete Control Plane
Delete an individual control plane.
delete
Path Parameters
idstring(uuid)required
The control plane ID
Example:d32d905a-ed33-46a3-a093-d8f536af9a8a
Response
Response
No Content
delete/control-planes/{id}
Authentication
Path Parameters
Control Plane Groups
List Control Plane Group Memberships
Returns an array of control planes that are a member of this control plane group.
get
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[after]string
Request the next page of data, starting with the item after this parameter.
Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ
Path Parameters
idstringrequired
ID of a control plane group
Response
application/json
Response
application/json
A paginated list response for a collection of control plane group memberships.
metaobjectrequired
returns the pagination information
Show Child Parameters
dataarray[object]required
The control plane object contains information about a Kong control plane.
* Additional properties are NOT allowed.
Show Child Parameters
get/control-planes/{id}/group-memberships
Authentication
Path Parameters
Query Parameters
application/json