Apache CloudStack 4.23.0.0 Root Admin API Reference

createKMSKey

Creates a new KMS key (Key Encryption Key) for encryption

Request parameters

Parameter NameDescriptionRequired
hsmprofileidID of HSM profile to create key intrue
nameName of the KMS keytrue
zoneidZone ID where the key will be validtrue
accountAccount name (for creating keys for child accounts - requires domain admin or admin)false
descriptionDescription of the KMS keyfalse
domainidDomain ID (for creating keys for child accounts - requires domain admin or admin)false
keybitsKey size in bits: 128, 192, or 256 (default: 256)false
projectidID of the project to create the KMS key forfalse

Response Tags

Response NameDescription
idthe UUID of the key
accountthe account owning the key
accountidthe account ID owning the key
algorithmthe encryption algorithm
createdthe creation timestamp
descriptionthe description of the key
domainthe domain name of the key
domainidthe domain ID of the key
domainpaththe domain path of the key
enabledwhether the key is enabled
hsmprofilethe zone name where the key is valid
hsmprofileidthe zone ID where the key is valid
keklabelthe provider-specific KEK label (admin only)
keybitsthe key size in bits
namethe name of the key
projectthe project name of the key
projectidthe project ID of the key
versionthe key size in bits
zoneidthe zone ID where the key is valid
zonenamethe zone name where the key is valid