# 查询Referer过滤规则
#### 功能介绍
查询Referer过滤规则。
#### URI
GET /v1.0/cdn/domains/{domain_id}/referer
表1路径参数 
| 参数        | 是否必选 | 参数类型   | 描述                             |
|:---|:---|:---|:---|
| domain_id | 是    | String | 加速域名id。 您可以通过查询加速域名接口查询加速域名id。 |
表2Query参数 
| 参数                    | 是否必选 | 参数类型   | 描述                                                                                                                              |
|:---|:---|:---|:---|
| enterprise_project_id | 否    | String | 当用户开启企业项目功能时，该参数生效，表示查询资源所属项目，"all"表示所有项目。注意：当使用子账号调用接口时，该参数必传。 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id。 |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数      | 参数类型                                                 | 描述          |
|:---|:---|:---|
| referer | [RefererRsp] object | Referrer配置。 |
   
 表5RefererRsp 
| 参数            | 参数类型    | 描述                                                                                               |
|:---|:---|:---|
| referer_type  | Integer | Referer类型。取值：0代表不设置Referer过滤；1代表黑名单；2代表白名单。默认取值为0。                                               |
| referer_list  | String  | 配置的referer地址。                                                                                    |
| include_empty | Boolean | 是否包含空Referer。如果是黑名单并开启该选项，则表示无referer不允许访问。如果是白名单并开启该选项，则表示无referer允许访问。默认不包含,true：包含，false：不包含。 |
   
#### 请求示例
```
GET https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff8080***********************d71/referer?enterprise_project_id=0
```
#### 响应示例
**状态码：200**
OK
```
{
  "referer" : {
    "referer_type" : 1,
    "referer_list" : "www.example1.com;www.example2.com",
    "include_empty" : false
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。