
# 获取配额信息 - ShowQuota
#### 功能介绍
获取UCS配额信息
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ucs/ucs_api_0026.html)。
#### URI
GET /v1/maintenance/quota/{domainid}
表1路径参数 
| 参数       | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| domainid | 是    | String | 账号id |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数     | 参数类型                                                     | 描述        |
|:---|:---|:---|
| quotas | [CommonQuotas] object | 包含配额资源的集合 |
   
 表3CommonQuotas 
| 参数        | 参数类型                                                                 | 描述     |
|:---|:---|:---|
| resources | Array of [QuotaResource] objects | 配额资源列表 |
   
 表4QuotaResource 
| 参数    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|
| 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 | 服务器内部错误           |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ucs/ErrorCode.html)。
