Create Or Update SNI Associated to a Specific Certificate
PUT {{gateway}}/certificates/:certificateId/snis/:sniNameOrId
Update SNI Associated to a Specific Certificate konghq
- Inserts (or replaces) the SNI under the requested resource with the definition specified in the body. The SNI will be identified via the name or id attribute.
- When the name or id attribute has the structure of a UUID, the SNI being inserted/replaced will be identified by its id. Otherwise it will be identified by its name.
- When creating a new SNI without specifying id (neither in the URL nor in the body), then it will be auto-generated.
- Notice that specifying a name in the URL and a different one in the request body is not allowed.
| Attributes | Mandatory | Type | Description |
|---|---|---|---|
| certificate id | required | path | The unique identifier of the Certificate to update. |
| sni name or id | required | path | The unique identifier or the name of the SNI to update. |
Request Body
| Attributes | Mandatory | Type | Description |
|---|---|---|---|
| name | required | body | The SNI name to associate with the given certificate. |
| tags | optional | body | An optional set of strings associated with the SNIs, for grouping and filtering. |
| certificate | required | body | 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= |
Request Body
{"name"=>"my-sni", "tags"=>["user-level", "low-priority"], "certificate"=>{"id"=>"a2e013e8-7623-4494-a347-6d29108ff68b"}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string |