Delete a CMEK

Delete a customer managed encryption key. Avoid revoking or deleting a KMS key and CMEK that is actively used by Konnect, as this can lead to data loss or service disruptions.

delete

Path Parameters

cmekIdstringrequired

Customer Managed Encryption Key identifier. This ID is selected from a predefined, Konnect-specific list of allowed values and uniquely identifies a CMEK configuration within a given organization and Konnect region. While not global in function, these IDs behave like scoped namespaces with enforced uniqueness and enumeration constraints.

Allowed values:default

Default:default

Example:default

Response

Success

delete/cmeks/{cmekId}
 

KMSARN

string

The Amazon Resource Name (ARN) of the Key Management Service (KMS) key to use for encryption and decryption. We recommend using one multi-region key (MRK) per Konnect region to enhance security and compliance, while also supporting failover to other AWS regions.

Example

CMEKName

string

The name of the CMEK. We recommend you match the key’s name used in KMS.

>= 1 characters

Example

CMEKDescription

string

An optional description of the CMEK.

Example

CMEK

object
idstringrequired
key_arnstringrequired

The Amazon Resource Name (ARN) of the Key Management Service (KMS) key to use for encryption and decryption. We recommend using one multi-region key (MRK) per Konnect region to enhance security and compliance, while also supporting failover to other AWS regions.

Example:arn:aws:kms:us-east-1:123456789012:key/mrk-12345678123412341234123456789012

namestringrequired

The name of the CMEK. We recommend you match the key’s name used in KMS.

>= 1 characters

Example:My KMS Key

descriptionstring

An optional description of the CMEK.

Example:My Key Description

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

Example