更新时间:2023-10-11 GMT+08:00

吊销证书

功能介绍

吊销证书。

注:当不想填写吊销理由时,请求body体请置为"{}",否则将会报错。

URI

POST /v1/private-certificates/{certificate_id}/revoke

表1 路径参数

参数

是否必选

参数类型

描述

certificate_id

String

所要吊销的私有证书ID。

最小长度:36

最大长度:36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户token,参见:IAM token获取方法

表3 请求Body参数

参数

是否必选

参数类型

描述

reason

String

吊销理由,支持以下选项:

  • UNSPECIFIED : 吊销时未指定吊销原因,为默认值;

  • KEY_COMPROMISE : 证书密钥材料泄露;

  • CERTIFICATE_AUTHORITY_COMPROMISE : 颁发路径上,可能存在CA密钥材料泄露;

  • AFFILIATION_CHANGED : 证书中的主体或其他信息已经被改变;

  • SUPERSEDED : 此证书已被取代;

  • CESSATION_OF_OPERATION : 此证书或颁发路径中的实体已停止运营;

  • CERTIFICATE_HOLD : 该证书当前不应被视为有效,预计将来可能会生效;

  • PRIVILEGE_WITHDRAWN : 此证书不再具备其声明的属性的权限;

  • ATTRIBUTE_AUTHORITY_COMPROMISE : 担保此证书属性的机构可能已受到损害。

说明:

当不想填写吊销理由时,请求body体请置为"{}",否则将会报异常,默认值为UNSPECIFIED。

枚举值:

  • UNSPECIFIED

  • KEY_COMPROMISE

  • CERTIFICATE_AUTHORITY_COMPROMISE

  • AFFILIATION_CHANGED

  • SUPERSEDED

  • CESSATION_OF_OPERATION

  • CERTIFICATE_HOLD

  • PRIVILEGE_WITHDRAWN

  • ATTRIBUTE_AUTHORITY_COMPROMISE

响应参数

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

状态码: 401

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

状态码: 404

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度:3

最大长度:36

error_msg

String

错误请求返回的错误信息。

最小长度:0

最大长度:1024

请求示例

吊销证书,请求头中的X-Auth-Token字段需要填写token,且该token需要具有本API的访问权限。

POST https://ccm.ap-southeast-3.myhuaweicloud.com/v1/private-certificates/6434f74f-2d13-4e6a-89eb-93ee313f1a43/revoke

{
  "reason" : "KEY_COMPROMISE"
}

响应示例

状态码: 400

请求参数有误。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码: 401

被请求的页面需要鉴权。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码: 403

认证失败。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码: 404

资源不存在或资源未找到。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码: 500

服务内部错误。

{
  "error_code" : "PCA.XXX",
  "error_msg" : "XXX"
}

状态码

状态码

描述

204

请求已成功,无响应body

400

请求参数有误。

401

被请求的页面需要鉴权。

403

认证失败。

404

资源不存在或资源未找到。

500

服务内部错误。

错误码

请参见错误码