创建专属密钥库

功能介绍

"创建租户专属密钥库，专属密钥库使用DHSM实例作为密钥的存储"

调用方法

请参见如何调用API。

URI

POST /v1.0/{project_id}/keystores

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

表3 请求Body参数
参数	是否必选	参数类型	描述
keystore_alias	是	String	专属密钥库别名，取值范围为1到255个字符，满足正则匹配“^[a-zA-Z0-9:/_-]{1,255}$”，且不与已有的专属密钥库别名重名。
hsm_cluster_id	是	String	DHSM集群Id，要求集群当前未创建专属密钥库。
hsm_ca_cert	是	String	DHSM集群的CA证书

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
keystore	KeystoreInfo object	密钥库信息。

表5 KeystoreInfo
参数	参数类型	描述
keystore_id	String	密钥库ID
domain_id	String	用户域ID

状态码： 400

表6 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

表7 ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 401

表8 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

表9 ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 403

**表10** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表11** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 404

**表12** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表13** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 500

**表14** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表15** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 502

**表16** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表17** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

状态码： 504

**表18** 响应Body参数
参数	参数类型	描述
error	Object	错误信息返回体。

**表19** ErrorDetail
参数	参数类型	描述
error_code	String	错误请求返回的错误码
error_msg	String	错误请求返回的错误信息

请求示例

创建别名为"keystore_alia1"，集群ID为"hsm_cluster_id"的租户专属密钥库。

{
  "keystore_alias" : "keystore_alia1",
  "hsm_cluster_id" : "hsm_cluster_id",
  "hsm_ca_cert" : "-----BEGIN CERTIFICATE---******----END CERTIFICATE-----"
}

响应示例

状态码： 200

请求已成功

{
  "keystore" : {
    "keystore_id" : "bb6a3d22-dc93-47ac-b5bd-88df7ad35f1e",
    "domain_id" : "b168fe00ff56492495a7d22974df2d0b"
  }
}

状态码

状态码	描述
200	请求已成功
400	请求参数有误
401	被请求的页面需要用户名和密码
403	认证失败
404	资源不存在，资源未找到
500	服务内部错误
502	请求未完成。服务器从上游服务器收到一个无效的响应
504	网关超时