导入证书
功能介绍
导入证书到SCM服务管理。
URI
POST /v3/scm/certificates/import
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:32 最大长度:2097152 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
证书名称。字符长度为3~63位。 最小长度:3 最大长度:63 |
certificate |
是 |
String |
证书内容,可包含中间证书及根证书。若certificate_chain字段传入证书链,则该字段只取证书本身。回车换行需要使用转义字符\n或者\r\n替换。 最小长度:0 最大长度:4096 |
certificate_chain |
否 |
String |
证书链,非必填,可通过certificate字段传入。回车换行需要使用转义字符\n或者\r\n替换。 最小长度:0 最大长度:8192 |
private_key |
是 |
String |
证书私钥。 不能上传带有口令保护的私钥,回车换行需要使用转义字符\n或者\r\n替换。 最小长度:0 最大长度:4096 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
certificate_id |
String |
证书id。 最小长度:16 最大长度:16 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误请求返回的错误码。 最小长度:3 最大长度:36 |
error_msg |
String |
错误请求返回的错误信息。 最小长度:0 最大长度:1024 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误请求返回的错误码。 最小长度:3 最大长度:36 |
error_msg |
String |
错误请求返回的错误信息。 最小长度:0 最大长度:1024 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误请求返回的错误码。 最小长度:3 最大长度:36 |
error_msg |
String |
错误请求返回的错误信息。 最小长度:0 最大长度:1024 |
请求示例
导入名称为“test_cert”,内容为“-----BEGIN CERTIFICATE---******----END CERTIFICATE----------BEGIN CERTIFICATE-----**********-----END CERTIFICATE-----”,证书私钥为“-----BEGIN RSA PRIVATE KEY-----*********-----END RSA PRIVATE KEY-----”的证书。
{ "name" : "test_cert", "certificate" : "-----BEGIN CERTIFICATE---******----END CERTIFICATE----------BEGIN CERTIFICATE-----**********-----END CERTIFICATE-----", "private_key" : "-----BEGIN RSA PRIVATE KEY-----*********-----END RSA PRIVATE KEY-----" }
响应示例
状态码: 200
正常返回。
{ "certificate_id" : "scs1600313391074" }
状态码: 401
认证失败。
{ "error_code" : "SCM.XXX", "error_msg" : "XXX" }
状态码: 403
禁止访问。
{ "error_code" : "SCM.XXX", "error_msg" : "XXX" }
状态码: 500
请求未完成,服务器内部异常。
{ "error_code" : "SCM.XXX", "error_msg" : "XXX" }
状态码
状态码 |
描述 |
---|---|
200 |
正常返回。 |
401 |
认证失败。 |
403 |
禁止访问。 |
404 |
访问页面未找到。 |
500 |
请求未完成,服务器内部异常。 |
错误码
请参见错误码。