Skip to main content

Key

Properties

PropertyTypeAttributesDescription
keyTypestringRequiredThe type of key to create. One of 'RSA', 'RSA-HSM', 'EC', 'EC-HSM', 'oct' or 'oct-HSM'.
namestringRequired, IdentifierThe name of the key in KeyVault.
createdOnstringRead-onlyThe UTC date/time at which the key was created, in ISO 8601 format.
curvestringThe elliptic curve name. Required for 'EC' and 'EC-HSM' keys. One of 'P-256', 'P-256K', 'P-384' or 'P-521'.
estringRead-onlyThe RSA public exponent, as a base64url-encoded string.
enabledboolWhether the key is enabled.
expiresOnstringThe UTC date/time at which the key expires, in ISO 8601 format, e.g. '2026-01-01T00:00:00Z'.
exportableboolWhether the private key can be exported. Requires a release policy.
idstringRead-onlyThe versioned URI of the key.
keyOpsstring[]The permitted JSON web key operations, e.g. 'sign', 'verify', 'encrypt', 'decrypt', 'wrapKey', 'unwrapKey'.
keySizeintThe size of the key in bits. Required for 'RSA', 'RSA-HSM', 'oct' and 'oct-HSM' keys, e.g. 2048, 3072 or 4096.
nstringRead-onlyThe RSA modulus, as a base64url-encoded string.
notBeforestringThe UTC date/time before which the key cannot be used, in ISO 8601 format, e.g. '2025-01-01T00:00:00Z'.
publicKeyOpenSshstringRead-onlyThe OpenSSH-encoded public key. Only populated for RSA and EC keys.
publicKeyPemstringRead-onlyThe PEM-encoded public key. Only populated for RSA and EC keys.
recoveryLevelstringRead-onlyThe deletion recovery level currently in effect for the key.
releasePolicyKeyReleasePolicyThe policy rules under which the key can be exported.
rotationPolicyKeyRotationPolicyThe key rotation policy.
tagsDictionary<string, String>Tags to apply to the key.
updatedOnstringRead-onlyThe UTC date/time at which the key was last updated, in ISO 8601 format.
vaultUristringIdentifierThe URI of the Key Vault holding the key. Defaults to the 'vaultUri' supplied in the extension configuration.
versionstringRead-onlyThe version of the key.
versionlessIdstringRead-onlyThe URI of the key, without a version. Use this to always resolve the latest version.
xstringRead-onlyThe elliptic curve X component, as a base64url-encoded string.
ystringRead-onlyThe elliptic curve Y component, as a base64url-encoded string.

KeyReleasePolicy

PropertyTypeAttributesDescription
jsonstringRequiredThe release policy, as a JSON string.
immutableboolWhether the release policy is immutable. An immutable policy cannot be changed once set.

KeyRotationPolicy

PropertyTypeAttributesDescription
automaticKeyRotationPolicyAutomaticConfigures automatic rotation. When omitted, the key is not rotated automatically.
expireAfterstringHow long a newly rotated key remains valid, as an ISO 8601 duration, e.g. 'P90D'. Must be at least 'P28D'.
notifyBeforeExpirystringHow long before expiry to raise a notification event, as an ISO 8601 duration, e.g. 'P29D'.

Dictionary<string, String>

Additional properties of type string are allowed.

KeyRotationPolicyAutomatic

PropertyTypeAttributesDescription
timeAfterCreationstringRotate the key this long after it was created, as an ISO 8601 duration, e.g. 'P90D'. Cannot be combined with 'timeBeforeExpiry'.
timeBeforeExpirystringRotate the key this long before it expires, as an ISO 8601 duration, e.g. 'P30D'. Cannot be combined with 'timeAfterCreation'.