Upsert a SNI
Create or Update SNI using ID or name.
Path Parameters
ID of the SNI to lookup
Example:64c17a1a-b7d7-4a65-a5a4-42e4a7016e7f
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
Description of the SNI
SNI
An SNI object represents a many-to-one mapping of hostnames to a certificate. That is, a certificate object can have many hostnames associated with it; when Kong receives an SSL request, it uses the SNI field in the Client Hello to lookup the certificate object based on the SNI associated with the certificate.
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.
Show Child Parameters
Unix epoch when the resource was created.
A string representing a UUID (universally unique identifier).
The SNI name to associate with the given certificate.
A string representing a tag.
Unix epoch when the resource was last updated.
Response
application/json
Response
Successfully upserted SNI
SNI
An SNI object represents a many-to-one mapping of hostnames to a certificate. That is, a certificate object can have many hostnames associated with it; when Kong receives an SSL request, it uses the SNI field in the Client Hello to lookup the certificate object based on the SNI associated with the certificate.
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.
Show Child Parameters
Unix epoch when the resource was created.
A string representing a UUID (universally unique identifier).
The SNI name to associate with the given certificate.
A string representing a tag.
Unix epoch when the resource was last updated.
Authentication
Path Parameters
Body
Schemas
Validate entity schema
Validate schema for an entity
Path Parameters
The name of the entity
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Body
application/json
Body
Request body of a Koko entity to validate against its schema
Response
200 application/json
Response
Validation result of the request against a schema
Authentication
Path Parameters
Body
Get partial schema
Get the schema for a partial
Path Parameters
The type of a partial
The UUID of your control plane. This variable is available in the Konnect manager.
Example:9524ec7d-36d9-465d-a8c5-83a3c9390458
Response
200 application/json
Response
The schema for a partial
Authentication
Path Parameters
Services
Service entities are abstractions of your microservice interfaces or formal APIs. For example, a service could be a data transformation microservice or a billing API.
The main attribute of a service is the destination URL for proxying traffic. This URL can be set as a single string or by specifying its protocol, host, port and path individually.
Services are associated to routes, and a single service can have many routes associated with it. Routes are entrypoints in Kong Gateway which define rules to match client requests. Once a route is matched, Kong Gateway proxies the request to its associated service. See the Route documentation for a detailed explanation of how Kong proxies traffic.
Services can be both tagged and filtered by tags.