全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 智能硬件
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 更多

CreateKey

更新时间:2018-04-17 20:16:23

描述

创建一个主密钥。主密钥可以直接用来加密少量的数据(少于6KB),但通常用来生成可以加密大量数据的DataKey,请参见 GenerateDataKey

请求参数

名称 类型 是否必需 描述
Origin String 密钥材料来源。如果选择 External,您需要导入密钥材料
Description String 密钥的描述。 长度必须在0到8192个字符之间。
KeyUsage String 密钥的用途。默认值:ENCRYPT/DECRYPT。

返回参数

名称 类型 描述
KeyMetadata KeyMetadata 密钥的 metadata。

KeyMetadata

名称 类型 描述
CreationDate Timestamp 创建密钥时的日期和时间(UTC时间)。
Description String 密钥的描述。
KeyId String 密钥的全局唯一标识符。
KeyState String 密钥的状态。
KeyUsage String 密钥的用途,加密/解密。
DeleteDate Timestamp 密钥预计被删除的时间(UTC时间)。
  • 当该值为空时,表示密钥不会被删除。
  • 只有当KeyStatePendingDeletion时,会返回这个参数。
Creator String 密钥的创建者。
Arn String 当前密钥的阿里云资源名称,详情请参见 权限
Origin String 密钥材料来源。
MaterialExpireTime String 密钥材料过期时间(UTC时间)。当该值为空时,表示密钥材料不会过期。

示例

请求示例

  1. https://kms.cn-hangzhou.aliyuncs.com/?Action=CreateKey
  2. &Description=<your key description>
  3. &KeyUsage=ENCRYPT/DECRYPT
  4. &Origin=<key origin, default Aliyun_KMS>
  5. &<公共请求参数>

返回示例

JSON 格式

  1. //json response
  2. {
  3. "KeyMetadata": {
  4. "CreationDate": "2016-03-25T10:42:40Z",
  5. "Description": "key description example",
  6. "KeyId": "08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4fb73",
  7. "KeyState": "Enabled",
  8. "KeyUsage": "ENCRYPT/DECRYPT",
  9. "DeleteDate": "",
  10. "Creator":"123456",
  11. "Arn":"acs:kms:cn-hangzhou:123456:key/08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4fb73",
  12. "Origin":"Aliyun_KMS",
  13. "MaterialExpireTime":""
  14. },
  15. "RequestId": "3455b9b4-95c1-419d-b310-db6a53b09a39"
  16. }

XML 格式

  1. //xml response
  2. <KMS>
  3. <KeyMetadata>
  4. <CreationDate>2016-03-25T10:40:47Z</CreationDate>
  5. <Description>key description example</Description>
  6. <KeyId>08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4fb73</KeyId>
  7. <KeyState>Enabled</KeyState>
  8. <KeyUsage>ENCRYPT/DECRYPT</KeyUsage>
  9. <DeleteDate></DeleteDate>
  10. <Creator>123456</Creator>
  11. <Arn>acs:kms:cn-hangzhou:123456:key/08c33a6f-4e0a-4a1b-a3fa-7ddfa1d4fb73</Arn>
  12. <Origin>Aliyun_KMS</Origin>
  13. <MaterialExpireTime></MaterialExpireTime>
  14. </KeyMetadata>
  15. <RequestId>6cb4bf6b-d9c9-4660-af5f-2328378e7257</RequestId>
  16. </KMS>
本文导读目录