published on Thursday, Apr 23, 2026 by Volcengine
published on Thursday, Apr 23, 2026 by Volcengine
Key Management Service (KMS) is a one-stop key management and data encryption platform on Volcano Engine. It provides easy-to-use encryption interfaces. KMS helps users easily manage keys and protect the security of core cloud data. It also greatly reduces the procurement and development costs for users to deploy their own cryptographic infrastructure. KMS helps businesses easily meet regulatory and compliance requirements.
Example Usage
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
Example coming soon!
resources:
kMSKeyDemo:
type: volcenginecc:kms:Key
name: KMSKeyDemo
properties:
keyringName: KMSKeyDemo
keyName: KMSKeyDemoKeyName
keySpec: SYMMETRIC_256
description: description KMSKeyDemo
keyUsage: ENCRYPT_DECRYPT
protectionLevel: HSM
rotateState: Enable
origin: CloudKMS
multiRegion: false
rotateInterval: 900
keyEnableOperation: 1
keyRotationOperation: 1
tags:
- key: env
value: test
Create Key Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Key(name: string, args: KeyArgs, opts?: CustomResourceOptions);@overload
def Key(resource_name: str,
args: KeyArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Key(resource_name: str,
opts: Optional[ResourceOptions] = None,
key_name: Optional[str] = None,
keyring_name: Optional[str] = None,
key_usage: Optional[str] = None,
key_enable_operation: Optional[int] = None,
key_rotation_operation: Optional[int] = None,
key_spec: Optional[str] = None,
description: Optional[str] = None,
key_archive_operation: Optional[int] = None,
multi_region: Optional[bool] = None,
origin: Optional[str] = None,
protection_level: Optional[str] = None,
rotate_interval: Optional[int] = None,
tags: Optional[Sequence[KeyTagArgs]] = None)func NewKey(ctx *Context, name string, args KeyArgs, opts ...ResourceOption) (*Key, error)public Key(string name, KeyArgs args, CustomResourceOptions? opts = null)type: volcenginecc:kms:Key
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args KeyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args KeyArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args KeyArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args KeyArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args KeyArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Key Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Key resource accepts the following input properties:
- Key
Name string - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Keyring
Name string - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Description string
- Key description: Length 0–8192 characters.
- Key
Archive intOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- Key
Enable intOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- Key
Rotation intOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- Key
Spec string - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- Key
Usage string - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- Multi
Region bool - Is this a multi-region type master key.
- Origin string
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- Protection
Level string - Key protection level. Options: SOFTWARE, HSM.
- Rotate
Interval int - Key rotation period (days). Range: [90, 2560].
-
List<Volcengine.
Key Tag>
- Key
Name string - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Keyring
Name string - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Description string
- Key description: Length 0–8192 characters.
- Key
Archive intOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- Key
Enable intOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- Key
Rotation intOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- Key
Spec string - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- Key
Usage string - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- Multi
Region bool - Is this a multi-region type master key.
- Origin string
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- Protection
Level string - Key protection level. Options: SOFTWARE, HSM.
- Rotate
Interval int - Key rotation period (days). Range: [90, 2560].
-
[]Key
Tag Args
- key
Name String - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- keyring
Name String - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- description String
- Key description: Length 0–8192 characters.
- key
Archive IntegerOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key
Enable IntegerOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key
Rotation IntegerOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key
Spec String - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key
Usage String - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- multi
Region Boolean - Is this a multi-region type master key.
- origin String
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection
Level String - Key protection level. Options: SOFTWARE, HSM.
- rotate
Interval Integer - Key rotation period (days). Range: [90, 2560].
-
List<Key
Tag>
- key
Name string - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- keyring
Name string - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- description string
- Key description: Length 0–8192 characters.
- key
Archive numberOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key
Enable numberOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key
Rotation numberOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key
Spec string - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key
Usage string - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- multi
Region boolean - Is this a multi-region type master key.
- origin string
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection
Level string - Key protection level. Options: SOFTWARE, HSM.
- rotate
Interval number - Key rotation period (days). Range: [90, 2560].
-
Key
Tag[]
- key_
name str - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- keyring_
name str - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- description str
- Key description: Length 0–8192 characters.
- key_
archive_ intoperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key_
enable_ intoperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key_
rotation_ intoperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key_
spec str - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key_
usage str - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- multi_
region bool - Is this a multi-region type master key.
- origin str
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection_
level str - Key protection level. Options: SOFTWARE, HSM.
- rotate_
interval int - Key rotation period (days). Range: [90, 2560].
-
Sequence[Key
Tag Args]
- key
Name String - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- keyring
Name String - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- description String
- Key description: Length 0–8192 characters.
- key
Archive NumberOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key
Enable NumberOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key
Rotation NumberOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key
Spec String - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key
Usage String - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- multi
Region Boolean - Is this a multi-region type master key.
- origin String
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection
Level String - Key protection level. Options: SOFTWARE, HSM.
- rotate
Interval Number - Key rotation period (days). Range: [90, 2560].
- List<Property Map>
Outputs
All input properties are implicitly available as output properties. Additionally, the Key resource produces the following output properties:
- Created
Time int - Key creation time.
- Id string
- The provider-assigned unique ID for this managed resource.
- Key
Id string - Key unique identifier in UUID format.
- Key
Material stringExpire Time - Key material expiration time. If empty, the key does not expire.
- Key
State stringValue - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- Last
Rotation stringTime - Key last rotation time.
- Multi
Region Volcengine.Configuration Key Multi Region Configuration - Multi-region key configuration information.
- Rotate
State string - Key rotation status. Options: Enable, Disable.
- Schedule
Delete stringTime - Key deletion time.
- Schedule
Rotation stringTime - Key rotation time.
- Trn string
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- Updated
Time int - Key update time.
- Created
Time int - Key creation time.
- Id string
- The provider-assigned unique ID for this managed resource.
- Key
Id string - Key unique identifier in UUID format.
- Key
Material stringExpire Time - Key material expiration time. If empty, the key does not expire.
- Key
State string - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- Last
Rotation stringTime - Key last rotation time.
- Multi
Region KeyConfiguration Multi Region Configuration - Multi-region key configuration information.
- Rotate
State string - Key rotation status. Options: Enable, Disable.
- Schedule
Delete stringTime - Key deletion time.
- Schedule
Rotation stringTime - Key rotation time.
- Trn string
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- Updated
Time int - Key update time.
- created
Time Integer - Key creation time.
- id String
- The provider-assigned unique ID for this managed resource.
- key
Id String - Key unique identifier in UUID format.
- key
Material StringExpire Time - Key material expiration time. If empty, the key does not expire.
- key
State String - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- last
Rotation StringTime - Key last rotation time.
- multi
Region KeyConfiguration Multi Region Configuration - Multi-region key configuration information.
- rotate
State String - Key rotation status. Options: Enable, Disable.
- schedule
Delete StringTime - Key deletion time.
- schedule
Rotation StringTime - Key rotation time.
- trn String
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated
Time Integer - Key update time.
- created
Time number - Key creation time.
- id string
- The provider-assigned unique ID for this managed resource.
- key
Id string - Key unique identifier in UUID format.
- key
Material stringExpire Time - Key material expiration time. If empty, the key does not expire.
- key
State string - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- last
Rotation stringTime - Key last rotation time.
- multi
Region KeyConfiguration Multi Region Configuration - Multi-region key configuration information.
- rotate
State string - Key rotation status. Options: Enable, Disable.
- schedule
Delete stringTime - Key deletion time.
- schedule
Rotation stringTime - Key rotation time.
- trn string
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated
Time number - Key update time.
- created_
time int - Key creation time.
- id str
- The provider-assigned unique ID for this managed resource.
- key_
id str - Key unique identifier in UUID format.
- key_
material_ strexpire_ time - Key material expiration time. If empty, the key does not expire.
- key_
state str - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- last_
rotation_ strtime - Key last rotation time.
- multi_
region_ Keyconfiguration Multi Region Configuration - Multi-region key configuration information.
- rotate_
state str - Key rotation status. Options: Enable, Disable.
- schedule_
delete_ strtime - Key deletion time.
- schedule_
rotation_ strtime - Key rotation time.
- trn str
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated_
time int - Key update time.
- created
Time Number - Key creation time.
- id String
- The provider-assigned unique ID for this managed resource.
- key
Id String - Key unique identifier in UUID format.
- key
Material StringExpire Time - Key material expiration time. If empty, the key does not expire.
- key
State String - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- last
Rotation StringTime - Key last rotation time.
- multi
Region Property MapConfiguration - Multi-region key configuration information.
- rotate
State String - Key rotation status. Options: Enable, Disable.
- schedule
Delete StringTime - Key deletion time.
- schedule
Rotation StringTime - Key rotation time.
- trn String
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated
Time Number - Key update time.
Look up Existing Key Resource
Get an existing Key resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: KeyState, opts?: CustomResourceOptions): Key@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
created_time: Optional[int] = None,
description: Optional[str] = None,
key_archive_operation: Optional[int] = None,
key_enable_operation: Optional[int] = None,
key_id: Optional[str] = None,
key_material_expire_time: Optional[str] = None,
key_name: Optional[str] = None,
key_rotation_operation: Optional[int] = None,
key_spec: Optional[str] = None,
key_state: Optional[str] = None,
key_usage: Optional[str] = None,
keyring_name: Optional[str] = None,
last_rotation_time: Optional[str] = None,
multi_region: Optional[bool] = None,
multi_region_configuration: Optional[KeyMultiRegionConfigurationArgs] = None,
origin: Optional[str] = None,
protection_level: Optional[str] = None,
rotate_interval: Optional[int] = None,
rotate_state: Optional[str] = None,
schedule_delete_time: Optional[str] = None,
schedule_rotation_time: Optional[str] = None,
tags: Optional[Sequence[KeyTagArgs]] = None,
trn: Optional[str] = None,
updated_time: Optional[int] = None) -> Keyfunc GetKey(ctx *Context, name string, id IDInput, state *KeyState, opts ...ResourceOption) (*Key, error)public static Key Get(string name, Input<string> id, KeyState? state, CustomResourceOptions? opts = null)public static Key get(String name, Output<String> id, KeyState state, CustomResourceOptions options)resources: _: type: volcenginecc:kms:Key get: id: ${id}- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Created
Time int - Key creation time.
- Description string
- Key description: Length 0–8192 characters.
- Key
Archive intOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- Key
Enable intOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- Key
Id string - Key unique identifier in UUID format.
- Key
Material stringExpire Time - Key material expiration time. If empty, the key does not expire.
- Key
Name string - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Key
Rotation intOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- Key
Spec string - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- Key
State stringValue - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- Key
Usage string - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- Keyring
Name string - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Last
Rotation stringTime - Key last rotation time.
- Multi
Region bool - Is this a multi-region type master key.
- Multi
Region Volcengine.Configuration Key Multi Region Configuration - Multi-region key configuration information.
- Origin string
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- Protection
Level string - Key protection level. Options: SOFTWARE, HSM.
- Rotate
Interval int - Key rotation period (days). Range: [90, 2560].
- Rotate
State string - Key rotation status. Options: Enable, Disable.
- Schedule
Delete stringTime - Key deletion time.
- Schedule
Rotation stringTime - Key rotation time.
-
List<Volcengine.
Key Tag> - Trn string
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- Updated
Time int - Key update time.
- Created
Time int - Key creation time.
- Description string
- Key description: Length 0–8192 characters.
- Key
Archive intOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- Key
Enable intOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- Key
Id string - Key unique identifier in UUID format.
- Key
Material stringExpire Time - Key material expiration time. If empty, the key does not expire.
- Key
Name string - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Key
Rotation intOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- Key
Spec string - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- Key
State string - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- Key
Usage string - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- Keyring
Name string - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- Last
Rotation stringTime - Key last rotation time.
- Multi
Region bool - Is this a multi-region type master key.
- Multi
Region KeyConfiguration Multi Region Configuration Args - Multi-region key configuration information.
- Origin string
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- Protection
Level string - Key protection level. Options: SOFTWARE, HSM.
- Rotate
Interval int - Key rotation period (days). Range: [90, 2560].
- Rotate
State string - Key rotation status. Options: Enable, Disable.
- Schedule
Delete stringTime - Key deletion time.
- Schedule
Rotation stringTime - Key rotation time.
-
[]Key
Tag Args - Trn string
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- Updated
Time int - Key update time.
- created
Time Integer - Key creation time.
- description String
- Key description: Length 0–8192 characters.
- key
Archive IntegerOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key
Enable IntegerOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key
Id String - Key unique identifier in UUID format.
- key
Material StringExpire Time - Key material expiration time. If empty, the key does not expire.
- key
Name String - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- key
Rotation IntegerOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key
Spec String - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key
State String - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- key
Usage String - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- keyring
Name String - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- last
Rotation StringTime - Key last rotation time.
- multi
Region Boolean - Is this a multi-region type master key.
- multi
Region KeyConfiguration Multi Region Configuration - Multi-region key configuration information.
- origin String
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection
Level String - Key protection level. Options: SOFTWARE, HSM.
- rotate
Interval Integer - Key rotation period (days). Range: [90, 2560].
- rotate
State String - Key rotation status. Options: Enable, Disable.
- schedule
Delete StringTime - Key deletion time.
- schedule
Rotation StringTime - Key rotation time.
-
List<Key
Tag> - trn String
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated
Time Integer - Key update time.
- created
Time number - Key creation time.
- description string
- Key description: Length 0–8192 characters.
- key
Archive numberOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key
Enable numberOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key
Id string - Key unique identifier in UUID format.
- key
Material stringExpire Time - Key material expiration time. If empty, the key does not expire.
- key
Name string - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- key
Rotation numberOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key
Spec string - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key
State string - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- key
Usage string - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- keyring
Name string - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- last
Rotation stringTime - Key last rotation time.
- multi
Region boolean - Is this a multi-region type master key.
- multi
Region KeyConfiguration Multi Region Configuration - Multi-region key configuration information.
- origin string
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection
Level string - Key protection level. Options: SOFTWARE, HSM.
- rotate
Interval number - Key rotation period (days). Range: [90, 2560].
- rotate
State string - Key rotation status. Options: Enable, Disable.
- schedule
Delete stringTime - Key deletion time.
- schedule
Rotation stringTime - Key rotation time.
-
Key
Tag[] - trn string
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated
Time number - Key update time.
- created_
time int - Key creation time.
- description str
- Key description: Length 0–8192 characters.
- key_
archive_ intoperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key_
enable_ intoperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key_
id str - Key unique identifier in UUID format.
- key_
material_ strexpire_ time - Key material expiration time. If empty, the key does not expire.
- key_
name str - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- key_
rotation_ intoperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key_
spec str - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key_
state str - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- key_
usage str - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- keyring_
name str - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- last_
rotation_ strtime - Key last rotation time.
- multi_
region bool - Is this a multi-region type master key.
- multi_
region_ Keyconfiguration Multi Region Configuration Args - Multi-region key configuration information.
- origin str
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection_
level str - Key protection level. Options: SOFTWARE, HSM.
- rotate_
interval int - Key rotation period (days). Range: [90, 2560].
- rotate_
state str - Key rotation status. Options: Enable, Disable.
- schedule_
delete_ strtime - Key deletion time.
- schedule_
rotation_ strtime - Key rotation time.
-
Sequence[Key
Tag Args] - trn str
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated_
time int - Key update time.
- created
Time Number - Key creation time.
- description String
- Key description: Length 0–8192 characters.
- key
Archive NumberOperation - User master key archive operation (enter 1 to archive, 2 to unarchive).
- key
Enable NumberOperation - User master key enable operation (enter 1 to enable, 2 to disable).
- key
Id String - Key unique identifier in UUID format.
- key
Material StringExpire Time - Key material expiration time. If empty, the key does not expire.
- key
Name String - Master key name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- key
Rotation NumberOperation - User master key rotation operation (enter 1 to enable, 2 to disable).
- key
Spec String - Symmetric keys: SYMMETRIC256, SYMMETRIC128; asymmetric keys: RSA2048, RSA3072, RSA4096, ECP256, ECP256K, ECP384, ECP521, ECSM2.
- key
State String - Key status: Enable, Disable, PendingDelete, Archived, PendingImport.
- key
Usage String - Key usage. Options: ENCRYPTDECRYPT, SIGNVERIFY, GENERATEVERIFYMAC.
- keyring
Name String - Key ring name. Length 2–31 characters. Valid characters: [a-zA-Z0-9-_].
- last
Rotation StringTime - Key last rotation time.
- multi
Region Boolean - Is this a multi-region type master key.
- multi
Region Property MapConfiguration - Multi-region key configuration information.
- origin String
- Key source. Options: CloudKMS, External, ExternalKeyStore.
- protection
Level String - Key protection level. Options: SOFTWARE, HSM.
- rotate
Interval Number - Key rotation period (days). Range: [90, 2560].
- rotate
State String - Key rotation status. Options: Enable, Disable.
- schedule
Delete StringTime - Key deletion time.
- schedule
Rotation StringTime - Key rotation time.
- List<Property Map>
- trn String
- Resource name. Format should be trn:${Service}:${Region}:${AccountID}:${ResourcePath}.
- updated
Time Number - Key update time.
Supporting Types
KeyMultiRegionConfiguration, KeyMultiRegionConfigurationArgs
- Multi
Region stringKey Type - Multi-region key type.
- Primary
Key Volcengine.Key Multi Region Configuration Primary Key - Primary multi-region key transaction identifier and region ID.
- Replica
Keys List<Volcengine.Key Multi Region Configuration Replica Key>
- Multi
Region stringKey Type - Multi-region key type.
- Primary
Key KeyMulti Region Configuration Primary Key - Primary multi-region key transaction identifier and region ID.
- Replica
Keys []KeyMulti Region Configuration Replica Key
- multi
Region StringKey Type - Multi-region key type.
- primary
Key KeyMulti Region Configuration Primary Key - Primary multi-region key transaction identifier and region ID.
- replica
Keys List<KeyMulti Region Configuration Replica Key>
- multi
Region stringKey Type - Multi-region key type.
- primary
Key KeyMulti Region Configuration Primary Key - Primary multi-region key transaction identifier and region ID.
- replica
Keys KeyMulti Region Configuration Replica Key[]
- multi_
region_ strkey_ type - Multi-region key type.
- primary_
key KeyMulti Region Configuration Primary Key - Primary multi-region key transaction identifier and region ID.
- replica_
keys Sequence[KeyMulti Region Configuration Replica Key]
- multi
Region StringKey Type - Multi-region key type.
- primary
Key Property Map - Primary multi-region key transaction identifier and region ID.
- replica
Keys List<Property Map>
KeyMultiRegionConfigurationPrimaryKey, KeyMultiRegionConfigurationPrimaryKeyArgs
KeyMultiRegionConfigurationReplicaKey, KeyMultiRegionConfigurationReplicaKeyArgs
KeyTag, KeyTagArgs
Import
$ pulumi import volcenginecc:kms/key:Key example "keyring_name|key_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Thursday, Apr 23, 2026 by Volcengine
