文档首页/ 华为云UCS/ API参考/ API/ 配额管理/ 获取配额信息 - ShowQuota
更新时间：2026-04-16 GMT+08:00
查看PDF
分享

获取配额信息 - ShowQuota

功能介绍

获取UCS配额信息

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/maintenance/quota/{domainid}

表1 路径参数

参数

是否必选

参数类型

描述

domainid

是

String

账号id

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

quotas

CommonQuotas object

包含配额资源的集合
表3 CommonQuotas

参数

参数类型

描述

resources

Array of QuotaResource objects

配额资源列表
表4 QuotaResource

参数

参数类型

描述

type

String

配额类型，取值范围：

  • cluster：集群类型配额

  • clustergroup：容器舰队类型配额

  • rule：规则类型配额

  • federation：联邦类型配额

quota

Integer

配额的总值

used

Integer

已使用配额

unit

String

单位

min

Integer

最小值

max

Integer

最大值

状态码：400

表5 响应Body参数

参数

参数类型

描述

-

String

-

状态码：403

表6 响应Body参数

参数

参数类型

描述

-

String

-

状态码：500

表7 响应Body参数

参数

参数类型

描述

-

String

-

请求示例

无

响应示例

状态码：200

返回当前租户配额信息集合

{
  "quotas" : {
    "resources" : [ {
      "type" : "cluster",
      "quota" : 75,
      "used" : 8,
      "unit" : "",
      "min" : 20,
      "max" : 100
    }, {
      "type" : "clustergroup",
      "quota" : 50,
      "used" : 2,
      "unit" : "",
      "min" : 20,
      "max" : 100
    }, {
      "type" : "rule",
      "quota" : 50,
      "used" : 1,
      "unit" : "",
      "min" : 20,
      "max" : 100
    }, {
      "type" : "federation",
      "quota" : 10,
      "used" : 1,
      "unit" : "",
      "min" : 1,
      "max" : 50
    } ]
  }
}

状态码

状态码

描述

200

返回当前租户配额信息集合

400

客户端请求错误，服务器无法执行请求

403

服务器拒绝执行请求

500

服务器内部错误

错误码

请参见错误码。

父主题： 配额管理