调用ALIYUN::KMS::Key创建一个主密钥_资源编排(ROS)-阿里云帮助中心

ALIYUN::KMS::Key类型用于创建一个主密钥。

语法

{
  "Type": "ALIYUN::KMS::Key",
  "Properties": {
    "KeyUsage": String,
    "Enable": Boolean,
    "PendingWindowInDays": Integer,
    "Description": String,
    "KeySpec": String,
    "EnableAutomaticRotation": Boolean,
    "RotationInterval": String,
    "ProtectionLevel": String,
    "DKMSInstanceId": String,
    "Policy": Map
  }
}

属性

属性名称	类型	必须	允许更新	描述	约束
KeyUsage	String	否	否	密钥的用途。	取值： ENCRYPT/DECRYPT：数据加密和解密。 SIGN/VERIFY：产生和验证数字签名。
Enable	Boolean	否	是	将密钥设置为启用或禁用状态。	取值： true（默认值）：将密钥设置为启用状态。 false：将密钥设置为禁用状态。
PendingWindowInDays	Integer	否	否	密钥预删除周期。在这段时间内，您可以撤销删除处于待删除状态的密钥；预删除时间过后无法撤销删除。	取值范围：7~30。默认值：30。单位：天。
Description	String	否	是	密钥的描述。	长度为0~8192个字符。
KeySpec	String	否	否	密钥的类型。	取值： Aliyun_AES_256 Aliyun_SM4 RSA_2048 EC_P256 EC_P256K EC_SM2 说明在中国内地使用托管密码机创建的密钥，默认为Aliyun_SM4类型，其余情况下默认为Aliyun_AES_256。
EnableAutomaticRotation	Boolean	否	是	是否开启密钥自动轮转。	取值： true：开启密钥自动轮转。 false（默认值）：关闭密钥自动轮转。
RotationInterval	String	否	是	自动轮转的时间周期。例如：`365d`。	格式为`integer[unit]`，其中`integer`表示时间长度，`unit`表示时间单位。合法的`unit`单位取值如下： d：天 h：小时 m：分钟 s：秒 7d或者604800s均表示7天的周期。取值范围：7~730天。
ProtectionLevel	String	否	否	密钥的保护级别。	取值： SOFTWARE（默认值） HSM
DKMSInstanceId	String	否	否	专属KMS的实例ID。	无
Policy	Map	否	否	密钥策略。	JSON格式。最大长度为32768个字节。关于密钥策略的详细介绍，请参见密钥策略概述。不输入该参数时，使用默认凭据策略。密钥策略内容包含： Version：密钥策略的版本，目前版本仅支持设置为1。 Statement：密钥策略的语句，每个密钥策略包含一个或多个语句。密钥策略格式为： `{ "Version": "1", "Statement": [ { "Sid": "Enable RAM User Permissions", "Effect": "Allow", "Principal": { "RAM": "acs:ram::112890462***:root" } "Action": [ "kms:" ], "Resource": [ "*" ] } ] }`

返回值

Fn::GetAtt

KeyId：密钥的全局唯一标识符。

示例

`YAML`格式

ROSTemplateFormatVersion: '2015-09-01'
Parameters: {}
Resources:
  Key:
    Type: ALIYUN::KMS::Key
    Properties:
      KeyUsage: ENCRYPT/DECRYPT
      Enable: false
      PendingWindowInDays: 15
      Description: Test create key
Outputs:
  KeyId:
    Description: The globally unique identifier for the CMK.
    Value:
      Fn::GetAtt:
        - Key
        - KeyId

`JSON`格式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
  },
  "Resources": {
    "Key": {
      "Type": "ALIYUN::KMS::Key",
      "Properties": {
        "KeyUsage": "ENCRYPT/DECRYPT",
        "Enable": false,
        "PendingWindowInDays": 15,
        "Description": "Test create key"
      }
    }
  },
  "Outputs": {
    "KeyId": {
      "Description": "The globally unique identifier for the CMK.",
      "Value": {
        "Fn::GetAtt": [
          "Key",
          "KeyId"
        ]
      }
    }
  }
}

语法

属性

返回值

示例

YAML格式

JSON格式

`YAML`格式

`JSON`格式