148      阿里云

CreateKey__API 参考_密钥管理服务-阿里云

创建一个主密钥。主密钥可以直接用来加密少量的数据（少于4 k），但通常当做产生数据密钥 API的输入用以生成可以加密数据的DataKey，详情请看 产生数据密钥 API

• 请求格式

    Description="string"&KeyUsage="string"

• 请求参数

  • Description

    • 含义 : key的描述

    • 类型 : String

    • 长度: 0 <= len(Description) <= 8192

    • 是否必须 : 否

  • KeyUsage

    • 含义 : 指定key的用途。目前，默认为 ‘ENCRYPT/DECRYPT’，即key用于加密和解密

    • 类型 : String

    • 有效值 : ENCRYPT/DECRYPT

    • 是否必须 : 否

• 请求示例

https://kms.cn-hangzhou.aliyuncs.com/?Action=CreateKey
&Description=test
&KeyUsage=ENCRYPT/DECRYPT
&<其他公共参数>

• 返回格式

{
    "KeyMetadata": {
        "CreationDate": "string",
        "Description": "string",
        "KeyId": "string",
        "KeyState": "string",
        "KeyUsage": "string",
        "DeleteDate": "string"
    },
    "RequestId":"string"
}

• 返回参数KeyMetaData
  • CreationDate
    • 含义 : 创建key时的日期和时间（UTC时间)
    • 类型 : String
  • Description
    • 含义 : key的描述
    • 类型 : String
  • KeyId
    • 含义 : key的全局唯一标识符
    • 类型 : String
  • KeyState
    • 含义 : Key的状态.
    • 类型 : String
  • KeyUsage
    • 含义 : 指定key的用途。目前，默认为 ENCRYPT/DECRYPT，只支持对称加密和解密
    • 类型 : String
  • DeleteDate
    • 含义 : Key预计被删除的时间(UTC时间)。当该值为空时，表示Key不会被删除。CreateKey的返回值一定为空
    • 类型 : String
  • RequestId
    • 含义 : 随机的访问Id
    • 类型 : String

• 返回示例

//json response
{
    "KeyMetadata": {
        "CreationDate": "2016-03-25T10:42:40Z",
        "Description": "test",
        "KeyId": "*******************",
        "KeyState": "Enabled",
        "KeyUsage": "ENCRYPT/DECRYPT",
        "DeleteDate": ""
    },
    "RequestId": "3455b9b4-95c1-419d-b310-db6a53b09a39"
}
//xml response
<KMS>
 <KeyMetadata>
    <CreationDate>2016-03-25T10:40:47Z</CreationDate>
    <Description>test</Description>
    <KeyId>*******************</KeyId>
    <KeyState>Enabled</KeyState>
    <KeyUsage>ENCRYPT/DECRYPT</KeyUsage>
 </KeyMetadata>
 <RequestId>6cb4bf6b-d9c9-4660-af5f-2328378e7257</RequestId>
</KMS>