Update an SNI
Create or Update SNI using ID or name.
Path Parameters
The unique identifier or the name of the SNI to retrieve.
Example:my-sni
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
A JSON object containing the details of the new SNI, including the name, certificate, and tags.
The SNI name to associate with the given certificate.
Example:my-sni
An optional set of strings associated with the SNIs for grouping and filtering.
Example:[user-level, low-priority]
The id (a UUID) of the certificate with which to associate the SNI hostname. The Certificate must have a valid private key associated with it to be used by the SNI object. With form-encoded, the notation is certificate.id=<certificate id>. With JSON, use “certificate:{id:<certificate id>”}.
Show Child Parameters
Response
application/json
Response
SNI response object
Array of SNIs
Show Child Parameters
Offset is used to paginate through the API. Provide this value to the next list operation to fetch the next page
Example:http://localhost:8001/snis?offset=6378122c-a0a1-438d-a5c6-efabae9fb969
Authentication
Path Parameters
Body
CA Certificates
CA certificates
List all CA certificates
Retrieve a list of all available Certificate Authority (CA) certificates, including the certificate ID, creation date, and other details. You can use query parameters to filter the results by size or tags, for example /ca-certificates?size=50&tags=enterprise.
Query Parameters
Number of resources to be returned.
Default:100
>= 1<= 1000
Offset from which to return the next set of resources. Use the value of the ‘offset’ field from the response of a list operation as input here to paginate through all the resources
A list of tags to filter the list of resources on. Multiple tags can be concatenated using ‘,’ to mean AND or using ‘/’ to mean OR.
Example:tag1,tag2
Path Parameters
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
200 application/json
Response
A successful response listing CA Certificates
CA-Certificate
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate. CA Certificates can be both tagged and filtered by tags.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
Unix epoch when the resource was created.
Example:1422386534
Unix epoch when the resouce was updated.
Example:1422386534
Example:04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
An optional set of strings associated with the Certificate for grouping and filtering.
Example:[user-level, low-priority]
Authentication
Path Parameters
Query Parameters
Create a new CA certificate
Create a new Certificate Authority (CA) certificate. The request body must include the cert property, the certificate data in PEM format; it can also include cert_digest, a digest of the certificate in hex format for verifying the certificates integrity, and tags, an optional list of tags to categorize the certificate.
Path Parameters
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
This request body represents a new Certificate Authority (CA) certificate and includes the properties required to create a new certificate.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
An optional set of strings associated with the Certificate for grouping and filtering.
Response
application/json
Response
The created certificate object.
CA-Certificate
A CA certificate object represents a trusted CA. These objects are used by Kong to verify the validity of a client or server certificate. CA Certificates can be both tagged and filtered by tags.
PEM-encoded public certificate of the CA.
Example:-----BEGIN CERTIFICATE-----...
SHA256 hex digest of the public certificate.
Example:c641e28d77e93544f2fa87b2cf3f3d51...
Unix epoch when the resource was created.
Example:1422386534
Unix epoch when the resouce was updated.
Example:1422386534
Example:04fbeacf-a9f1-4a5d-ae4a-b0407445db3f
An optional set of strings associated with the Certificate for grouping and filtering.
Example:[user-level, low-priority]
Authentication
Path Parameters
Body
Delete a CA Certificate
Delete the specified Certificate Authority (CA) certificate using the provided ca_certificate_id.
Path Parameters
ID of the related certificate
Example:7fca84d6-7d37-4a74-a7b0-93e576089a41
The ID of your runtime group. This variable is available in the Konnect manager
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
204
Response
Successfully deleted CA Certificate or the resource didn’t exist