
# 开启/关闭Range回源
#### 功能介绍
Range回源是指源站在收到CDN节点回源请求时，根据http请求头中的Range信息返回指定范围的数据给CDN节点。
开启Range回源前需要确认源站是否支持Range请求，若源站不支持Range请求，开启Range回源将导致资源无法缓存。
#### URI
PUT /v1.0/cdn/domains/{domain_id}/range-switch
表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的值）。 |
   
表4请求Body参数 
| 参数           | 是否必选 | 参数类型   | 描述                  |
|:---|:---|:---|:---|
| range_status | 是    | String | range状态（"off"/"on"） |
   
#### 响应参数
**状态码：200**
表5响应Body参数 
| 参数           | 参数类型                                                                   | 描述         |
|:---|:---|:---|
| origin_range | [OriginRangeBody] object | Range回源配置。 |
   
 表6OriginRangeBody 
| 参数           | 参数类型   | 描述                  |
|:---|:---|:---|
| range_status | String | range状态（"off"/"on"） |
| domain_id    | String | 加速域名id。             |
   
#### 请求示例
```
PUT https://cdn.myhuaweicloud.com/v1.0/cdn/domains/ff80808266fd001e0166fd21c65d0337/range-switch
{
  "range_status" : "on"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "origin_range" : {
    "domain_id" : "ff8080826812caa9016812dbfcd400ea",
    "range_status" : "off"
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cdn/ErrorCode.html)。
