
# 获取租户账户下配额情况 - GetQuotas
#### 功能介绍
本接口用于获取租户账户下配额情况。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dis/dis_02_0400.html)。
#### URI
GET /v1/{project_id}/quotas
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目ID。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-dis/dis_02_0501.html)。 **约束限制**： 不涉及 **取值范围**： 只能由英文字母和数字组成，且长度为\[1-64\]个字符。 **默认取值**： 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**： 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。请参见[认证鉴权-Token认证](https://support.huaweicloud.com/api-dis/dis_02_0517.html)。 **约束限制**： 不涉及 **取值范围**： 长度为\[1-32768\]个字符。 **默认取值**： 不涉及 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数    | 参数类型                                                                     | 描述                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| quota | Array of [ResourcesResult] objects | **参数解释**： 配额。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 |
   
 表4ResourcesResult 
| 参数        | 参数类型                                                                                 | 描述                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| resources | Array                                                                                | **参数解释**： 资源详情。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及                   |
| items     | [ResourcesdescriptionResult] object | **参数解释**： 资源详情列表。包含资源的类型、配额、使用情况。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 |
   
 表5ResourcesdescriptionResult 
| 参数    | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| type  | String  | **参数解释**： 资源类型。 **约束限制**： 不涉及 **取值范围**： - common_partition：普通分区。   - advanced_partition：高级分区。   - app: app。    **默认取值**： 不涉及 |
| quota | Integer | **参数解释**： 当前资源类型总配额。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 根据资源类型配额默认值不同，普通分区默认总配额50，高级分区默认总10，app分区默认总配额100。                                                                                                                                                                                                                                                                                                                                           |
| used  | Integer | **参数解释**： 当前资源类型已使用配额。 **约束限制**： 不涉及 **取值范围**： 不大于对应资源类型总配额，普通分区不大于50，如高级分区不大于10，app不大于100。 **默认取值**： 不涉及                                                                                                                                                                                                                                                                                                                                               |
   
#### 请求示例
获取租户账户下配额情况。
```
GET https://{Endpoint}/v1/{tenantId}/quotas
```
#### 响应示例
**状态码：200**
正常返回
```
{
  "quotas" : {
    "resource" : {
      "type" : "common_partition",
      "quota" : 50,
      "used" : 10
    }
  }
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 200 | 正常返回 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dis/ErrorCode.html)。
