> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/networking/zga/accelerator/modifyacceleratorregion.md).

# ModifyAcceleratorAccRegion

## 1. 接口描述

本接口(ModifyAcceleratorAccRegion)用于修改加速器加速区域。

#### 准备工作

* 查询可用加速区域：调用[`DescribeAccelerateRegions`](/api-reference/cn/networking/zga/region/describeaccelerateregions.md) 添加originRegionId参数, 查询可用加速区域。

{% hint style="info" %}
**注意事项**

* 修改单个加速区域也需要全量提交其他加速区域信息，建议修改前调用`DescribeAccelerators`接口，获取加速区域信息。
* 本接口为异步接口，接口返回成功后，此时修改加速器操作并未立即完成。在此期间加速器的状态将会处于`Deploying`，加速器状态可以通过调用`DescribeAccelerators` 接口查询，如果加速器状态(acceleratorStatus)由`Deploying`(部署中)变为`Accelerating`(加速中），则代表加速成功，`AccelerateFailure`代表加速失败，可调用redeploy接口重试部署。
  {% endhint %}

## 2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

| 参数名称              | 必选 | 类型                                                                                              | 描述     |
| ----------------- | -- | ----------------------------------------------------------------------------------------------- | ------ |
| acceleratorId     | 是  | String                                                                                          | 加速器Id  |
| accelerateRegions | 是  | Array of [AccelerateRegion](/api-reference/cn/networking/zga/datastructure.md#accelerateregion) | 加速区域信息 |

## 3. 响应结果

| 参数名称      | 类型     | 描述                                         |
| --------- | ------ | ------------------------------------------ |
| requestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 requestId。 |

## 4. 代码示例

{% tabs %}
{% tab title="示例" %}

1. **修改加速器源站**

```json
POST /api/v2/zga HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: ModifyAcceleratorAccRegion
<Common Request Params>

Request:
{
    "acceleratorId": "acceleratorIdxxxxx",
    "accelerateRegions": [
        {
            "accelerateRegionId": "FR",
        },
        {
            "accelerateRegionId": "SG",
        }
    ],
}


Response:
{
    "requestId": "TEEFDCA5B-76FB-4E91-A18E-DF7F5D2CE41F",
}
```

{% endtab %}
{% endtabs %}

## 5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](/api-reference/cn/api-introduction/toolkit.md)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

## 6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](/api-reference/cn/api-introduction/instruction/commonerrorcode.md)

| HTTP状态码 | 错误码                                       | 说明                      |
| ------- | ----------------------------------------- | ----------------------- |
| 400     | ACCELERATE\_REGION\_ONLY                  | 此区域仅提供于加速区域使用           |
| 400     | ANYCAST\_ONLY                             | 此区域仅提供于Anycast使用        |
| 400     | NO\_FIT\_LINE                             | 没有线路提供给加速区域             |
| 500     | FOUND\_AVAILABLE\_REGION\_ERROR           | 查询可用区域失败                |
| 404     | INVALID\_REGION\_NOT\_FOUND               | 未找到指定区域                 |
| 400     | ANYCAST\_NOT\_ALLOW\_WITH\_NORMAL\_REGION | Anycast加速不允许和普通加速区域同时使用 |
| 400     | NORMAL\_ACCELERATOR\_NOT\_ALLOW\_ANYCAST  | 普通加速不允许修改为Anycast加速     |
| 400     | CUSTOMER\_ACCOUNT\_NOT\_AVAILABLE         | 客户账号不可用                 |
| 400     | TRAFFIC\_PACKAGE\_NOT\_EXIST              | 全球加速包不存在                |
| 400     | TRAFFIC\_PACKAGE\_EXPIRED                 | 全球加速包已经过期，请续费           |
| 400     | LINE\_NOT\_ENOUGH                         | 账户线路资源已到限制数量            |
| 400     | NO\_ENOUGH\_BANDWIDTH                     | 用户没有足够的带宽               |
| 400     | ONLY\_ONE\_CN2\_AREA\_CAN\_SELECTED       | 只能选择一个CN2加速区域           |
| 400     | NOT\_ALLOW\_MODIFY\_BANDWIDTH             | 不允许修改加速区域带宽             |