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>