# 查询租户的试用权限
#### 功能介绍
查询租户可以参与的免费使用权限。
![](https://support.huaweicloud.com/api-dcs/public_sys-resources/note_3.0-zh-cn.png)
该接口仅"华北-北京一"、"华东-上海二"和"华南-广州"region支持，其他region暂未支持。
#### **URI**
GET /v1.0/{domain_id}/trials
参数说明见[表1]。
 表1参数说明 
| 参数        | 类型       | 必选 | 说明 |
|:---|:---|:---|:---|
| domain_id | String | 是 | 租户ID。  |
   
#### **请求消息**
**请求参数**
无。
**请求示例**
无。
#### **响应消息**
**响应参数**
参数说明见[表2]。
 表2参数说明 
| 参数              | 类型   | 说明     |
|:---|:---|:---|
| domain_id         | String | 租户ID。  |
| domain_name     | String  | 租户名称。    |
| free_trials      | JSON  | 免费试用信息。 |
| one_yuan_trials | JSON   | 1元试用信息。 |
   
表3free_trials和one_yuan_trials中的参数说明 
| 参数       | 类型      | 说明                        |
|:---|:---|:---|
| engine   | String    | 引擎类型。取值包括Redis和Memcached。 |
| version  | String    | 引擎版本。                     |
| support  | Boolean | 是否支持试用。                    |
| cause_id   | String   | 不支持的原因ID。                  |
| message | String   | 额外消息。                      |
   
表4cause_id取值说明 
| cause_id   | 说明                            |
|:---|:---|
| 111400129   | 暂时没有免费试用活动。                    |
| 111400125 | 用户免费试用限额已经用完，或者暂不支持参加该免费试用活动。 |
   
**响应示例**
```
{
"domain_id": "xx",
"domain_name": "xx",
"free_trials": [{
"engine": "redis",
"support": true,
"cause_id": "xxx",
"message": "xx"
}]
}
```
#### **状态码**
操作成功的状态码如[表5]所示，其他响应见[表1](https://support.huaweicloud.com/api-dcs/dcs-api-0312043.html#dcs-api-0312043__table5210141351517)。
 表5状态码 
| 状态码  | 描述        |
|:---|:---|
| 200 | 查询租户试用权限成功。 |