文档首页/ 云证书与管理服务 CCM/ API参考/ API/ 管理私有证书/ 私有CA管理/ 查询CA配额
更新时间：2025-09-29 GMT+08:00
查看PDF
分享

查询CA配额

功能介绍

查询CA证书配额。

URI

GET /v1/private-certificate-authorities/quotas

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户token，参见:IAM token获取方法。

响应参数

状态码： 200

表2 响应Body参数

参数

参数类型

描述

quotas

Quotas object

证书配额，详情请参见Quotas字段数据结构说明。
表3 Quotas

参数

参数类型

描述

resources

Array of Resources objects

资源配额列表，详情请参见Resources字段数据结构说明。
表4 Resources

参数

参数类型

描述

type

String

证书类型:

  • CERTIFICATE_AUTHORITY: CA证书；
  • CERTIFICATE: 私有证书。

used

Integer

已使用配额数。

quota

Integer

配额总数：

  • CERTIFICATE_AUTHORITY: 当前系统指定100；
  • CERTIFICATE: 当前系统指定100000。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度：3

最大长度：36

error_msg

String

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

最小长度：0

最大长度：1024

状态码： 401

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度：3

最大长度：36

error_msg

String

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

最小长度：0

最大长度：1024

状态码： 403

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度：3

最大长度：36

error_msg

String

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

最小长度：0

最大长度：1024

状态码： 404

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度：3

最大长度：36

error_msg

String

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

最小长度：0

最大长度：1024

状态码： 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

最小长度：3

最大长度：36

error_msg

String

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

最小长度：0

最大长度：1024

请求示例

查询CA证书配额，请求头中的X-Auth-Token字段需要填写token，且该token需要具有本API的访问权限。

GET https://{Endpoint}/v1/private-certificate-authorities/quotas

响应示例

状态码： 200

请求已成功

{
  "quotas" : {
    "resources" : [ {
      "type" : "CERTIFICATE_AUTHORITY",
      "used" : 25,
      "quota" : 100
    } ]
  }
}

状态码： 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"
}

状态码

状态码

描述

200

请求已成功

400

请求参数有误。

401

被请求的页面需要鉴权。

403

认证失败。

404

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

500

服务内部错误。

错误码

请参见错误码。

父主题： 私有CA管理