创建PIN码

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

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

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

表3 请求Body参数
参数	是否必选	参数类型	描述
pin_type	否	String	pin码的类型，默认为“CipherText”： PlainText CipherText
keystore_id	否	String	密钥库ID，指定密文pin时必选： 1：管理面manage_az集群（共享卡集群） 2：数据面共享集群(pod区) 其它：租户专属

状态码：200

表4 响应Body参数
参数	参数类型	描述
pin	String	创建的PIN码

状态码：400

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

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

状态码：401

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

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

状态码：403

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

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

状态码：404

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

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

状态码：500

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

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

状态码：502

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

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

状态码：504

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

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

指定管理面共享卡集群创建pin码，返回密文pin。

{
  "pin_type" : "CipherText",
  "keystore_id" : "1"
}

状态码：200

请求已成功

{
  "pin" : "020098009EEAFCE122CAA5927D2XXX..."
}