创建密钥

功能介绍

创建用户主密钥，可用来加密数据密钥。

别名“/default”为服务默认主密钥的后缀名，由服务自动创建。因此用户创建的主密钥别名不能与服务默认主密钥的别名相同，即后缀名不能为“/default”。

对于开通企业项目的用户，服务默认主密钥属于且只能属于默认企业项目下，且不支持企业资源的迁入迁出。服务默认主密钥为用户提供基础的云上加密功能，满足合规要求。因此，在企业多项目下，其他非默认企业项目下的用户均可使用该密钥。若客户有企业管理资源诉求，请自行创建和使用密钥。

URI

• URI格式

  POST /v1.0/{project_id}/kms/create-key

• 参数说明

  表1 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目ID。

请求消息

响应消息

示例

如下以创建别名为“test”的密钥为例。

• 请求样例

  {
      "key_alias": "test"
  }

• 响应样例

  {
      "key_info": {
          "key_id": "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e",
          "domain_id": "b168fe00ff56492495a7d22974df2d0b"
      }
  }

  或

  {
      "error": {
          "error_code": "KMS.XXXX",
          "error_msg": "XXX"
      }
  }

状态码

异常状态码，请参见状态码。