# 获取租户订单已用资源信息 - ListUsageInfosV4
#### 功能介绍
获取租户订单已用资源信息，如果没达到告警的阈值，不会返回数据
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/domain/usage
表1Query参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| project_uuid | 是    | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **约束限制**: 32位字母和数字组成的字符串 **取值范围**: 不涉及 **默认取值**: 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 必传。 **取值范围：** 字符串长度不少于1，不超过10万。 **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数    | 参数类型                                                                  | 描述  |
|:---|:---|:---|
| value | Array of [UsageInfos] objects | 返回值 |
   
 表4UsageInfos 
| 参数           | 参数类型                                                                  | 描述                                                                                                                                                        |
|:---|:---|:---|
| name         | String                                                                | **参数解释**: 资源名称 **取值范围**: 不涉及                  |
| id           | String                                                                | **参数解释**: 资源标识 **取值范围**: 不涉及                  |
| amount       | String                                                                | **参数解释**: 资源总量 **取值范围**: 不涉及                  |
| used         | String                                                                | **参数解释**: 已消耗用量 **取值范围**: 不涉及                 |
| used_percent | Integer                                                               | **参数解释**: 资源已用容量百分比,例如80/ %值为80 **取值范围**: 不涉及 |
| usage_info   | Array of [UsageInfos] objects | **参数解释**: 版本超限信息 **取值范围**: 不涉及                |
   
**状态码：400**
表5响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                            |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：401**
表6响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                            |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：404**
表7响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                            |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
**状态码：500**
表8响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                            |
|:---|:---|:---|
| code   | String | **参数解释**: 业务失败的错误码 **取值范围**: 不涉及  |
| reason | String | **参数解释**: 业务失败的提示内容 **取值范围**: 不涉及 |
   
#### 请求示例
```
get https://{endpoint}/GT3KServer/v4/domain/usage?project_uuid=761e569574894180b3ecadc9d9df52b6
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : [ {
    "name" : "test1",
    "id" : "12345678911",
    "amount" : "10",
    "used" : "0",
    "used_percent" : 80
  } ]
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。