# Alibaba Cloud Anycast EIP API

> Alibaba Cloud Anycast EIP API on Apizie: 16 endpoints (The AllocateAnycastEipAddress operation creates an Anycast EIP instance, Associates an Anycast EIP with a specified backend cloud resource, Modifies the resource group to which an AnycastEipAddress instance belongs, Queries the details of a specified Anycast EIP instance, including its status, peak bandwidth, and…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-eipanycast/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-eipanycast`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/eipanycast
- Page: https://apizie.tech/api/cloud/aliyun-eipanycast
- OpenAPI: https://apizie.tech/api/cloud/aliyun-eipanycast/openapi.json

Alibaba Cloud OpenAPI for Anycast EIP (eipanycast, version 2020-03-09). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### The AllocateAnycastEipAddress operation creates an Anycast EIP instance
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/allocate-anycast-eip-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| Bandwidth | string | no | The peak bandwidth of the Anycast EIP instance. Unit: Mbps. Valid values: 200 to 1000. Default value: 1000. The peak bandwidth is for… |
| ServiceLocation | string | yes | The access area of the Anycast EIP instance |
| InstanceChargeType | string | no | The billing method of the Anycast EIP instance. Set the value to PostPaid. This value specifies the pay-as-you-go billing method |
| InternetChargeType | string | no | The metering method for Internet data transfer. Set the value to PayByTraffic. This value specifies the pay-by-data-transfer metering method |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. Make sure that the client token is unique for each request. The… |
| Name | string | no | The name of the Anycast EIP instance. The name must be 0 to 128 characters in length. It must start with a letter or a Chinese character… |
| Description | string | no | The description of the Anycast EIP instance. The description must be 0 to 256 characters in length and cannot start with `http://` or… |
| ResourceGroupId | string | no | The ID of the resource group to which the instance belongs |
| Tag | string | no | The resource tags (JSON-encoded) |

### Associates an Anycast EIP with a specified backend cloud resource
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/associate-anycast-eip-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| BindInstanceId | string | yes | The ID of the cloud resource with which you want to associate the Anycast EIP |
| BindInstanceRegionId | string | yes | The ID of the region where the cloud resource is deployed. You can associate Anycast EIPs with cloud resources in specific regions. You… |
| BindInstanceType | string | yes | The type of the cloud resource with which you want to associate the Anycast EIP. Valid values: SlbInstance: a Classic Load Balancer (CLB)… |
| AnycastId | string | yes | The ID of the Anycast EIP instance |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |
| DryRun | string | no | Specifies whether to perform a dry run, without performing the actual request. Valid values: true: performs a dry run. The system checks… |
| PopLocations | string | no | The information about the access points in the access areas that are associated with the cloud resource. If this is your first time to… |
| AssociationMode | string | no | The association mode. Valid values: Default: the default mode. In this mode, the associated cloud resource is the default origin server.… |
| PrivateIpAddress | string | no | The secondary private IP address of the ENI. This parameter is required when BindInstanceType is set to NetworkInterface. If you do not… |

### Modifies the resource group to which an AnycastEipAddress instance belongs
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/change-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| ResourceId | string | yes | The resource ID |
| NewResourceGroupId | string | yes | The ID of the destination resource group. You can call the https://help.aliyun.com/document_detail/158855.html operation to query resource… |
| ResourceType | string | yes | The resource type. Set the value to ANYCASTEIPADDRESS |

### Queries the details of a specified Anycast EIP instance, including its status, peak bandwidth, and…
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/describe-anycast-eip-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| Ip | string | no | The IP address of the Anycast EIP instance. You must specify either Ip or AnycastId |
| AnycastId | string | no | The ID of the Anycast EIP instance. You must specify either Ip or AnycastId |
| BindInstanceId | string | no | The ID of the cloud resource instance with which the Anycast EIP is associated |

### Queries the access points in a specified access area
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/describe-anycast-pop-locations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| ServiceLocation | string | no | The access area of the Anycast EIP instance. Set the value to international. This value specifies the regions outside the Chinese mainland |

### Queries the regions where backend services can be attached to an Anycast EIP
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/describe-anycast-server-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| ServiceLocation | string | yes | The access area of the Anycast EIP. Set the value to international. This value indicates regions outside the Chinese mainland |

### Queries the details of Anycast EIPs in a specified access area, including their status, peak bandwidth, and…
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/list-anycast-eip-addresses` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| AnycastId | string | no | The ID of the Anycast EIP instance. To ensure query accuracy, we recommend that you do not specify AnycastIds and AnycastId at the same time |
| AnycastIds | string | no | The list of Anycast EIP instance IDs. You can enter up to 50 Anycast EIP instance IDs. To ensure query accuracy, we recommend that you do… |
| AnycastEipAddress | string | no | The IP address of the Anycast EIP instance |
| ServiceLocation | string | no | The access area of the Anycast EIP instance. Set the value to international, which specifies regions outside the Chinese mainland |
| InstanceChargeType | string | no | The billing method of the Anycast EIP. Set the value to PostPaid, which specifies the pay-as-you-go billing method |
| InternetChargeType | string | no | The metering method for Internet data transfer of the Anycast EIP instance. Set the value to PayByTraffic, which specifies the… |
| Name | string | no | The name of the Anycast EIP instance. The name must be 0 to 128 characters in length, start with a letter or a Chinese character, and can… |
| ResourceGroupId | string | no | The ID of the resource group to which the instance belongs |
| Tags | string | no | The tag information (JSON-encoded) |
| MaxResults | integer | no | The number of entries to return on each page when a list is displayed. Valid values: 20 to 100. Default value: 50 |
| NextToken | string | no | The token that is used for the next query. Valid values: You do not need to specify this parameter for the first query or if no next query… |
| Status | string | no | The IP address status. Valid values: Associating: The Anycast EIP is being associated. Unassociating: The Anycast EIP is being… |
| BusinessStatus | string | no | The service status of the Anycast EIP instance. Valid values: Normal: The Anycast EIP is in a normal state. FinancialLocked: The Anycast… |
| BindInstanceIds | string | no | The list of IDs of cloud resources with which the Anycast EIP is associated. You can enter up to 100 cloud resource IDs (JSON-encoded) |

### Queries the tags that are bound to Anycast elastic IP addresses (Anycast EIPs) by calling the…
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| ResourceId | string | no | The list of resource IDs (JSON-encoded) |
| ResourceType | string | yes | The resource type. Valid values: ANYCASTEIPADDRESS |
| Tag | string | no | The tag information (JSON-encoded) |
| NextToken | string | no | The pagination token. Valid values: If this is the first query or no subsequent query is required, leave this parameter empty. If a… |
| MaxResults | string | no | The maximum number of entries per page for a paged query. Valid values: 1 to 50. Default value: 50 |

### Changes the name and description of an Anycast EIP instance
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/modify-anycast-eip-address-attribute` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| AnycastId | string | yes | The ID of the Anycast EIP instance |
| Name | string | no | The name of the Anycast EIP instance. The name must be 0 to 128 characters in length. It must start with a letter or a Chinese character.… |
| Description | string | no | The description of the Anycast EIP instance. The description must be 0 to 256 characters in length and cannot start with `http://` or… |

### Modifies the bandwidth of an Anycast EIP instance
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/modify-anycast-eip-address-spec` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| Bandwidth | string | yes | The peak bandwidth of the Anycast EIP instance. Unit: Mbps. Valid values: 200 to 1000 |
| AnycastId | string | yes | The ID of the Anycast EIP instance |

### Releases an Anycast EIP instance
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/release-anycast-eip-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| AnycastId | string | yes | The ID of the Anycast EIP instance that you want to release |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |

### Creates and attaches tags to specified resources
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| ResourceId | string | yes | The resource ID. You can specify up to 20 resource IDs (JSON-encoded) |
| ResourceType | string | yes | The resource type. Set the value to ANYCASTEIPADDRESS |
| Tag | string | yes | The tag information (JSON-encoded) |

### Disassociates an Anycast EIP from an endpoint
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/unassociate-anycast-eip-address` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| BindInstanceId | string | yes | The ID of the endpoint from which you want to disassociate the Anycast EIP |
| BindInstanceRegionId | string | yes | The region where the endpoint is deployed |
| BindInstanceType | string | yes | The type of endpoint from which you want to disassociate the Anycast EIP. Valid values: SlbInstance: an internal-facing Server Load… |
| AnycastId | string | yes | The ID of the Anycast EIP |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |
| DryRun | string | no | Specifies whether to perform a dry run, without performing the actual request. Valid values: true: performs only a dry run. The system… |
| PrivateIpAddress | string | no | The secondary private IP address of the ENI from which you want to disassociate the Anycast EIP. This parameter is valid only when you set… |

### Detaches tags from Anycast EIPs in a batch
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/untag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| ResourceId | string | yes | The resource IDs. You can detach tags from a maximum of 20 resource IDs (JSON-encoded) |
| ResourceType | string | yes | The resource type. Set the value to ANYCASTEIPADDRESS |
| TagKey | string | no | The tag keys that you want to detach. You can enter a maximum of 20 tag keys. If you specify this parameter, the value cannot be an empty… |

### If an Anycast EIP instance is associated with backend resources in multiple regions, you can modify the…
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/update-anycast-eip-address-associations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |
| BindInstanceId | string | yes | The ID of the cloud resource instance to be associated |
| AnycastId | string | yes | The ID of the Anycast EIP instance |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. The client generates the token, but you must make sure that the… |
| DryRun | string | no | Specifies whether to perform a dry run. Valid values: true: sends a check request and does not update the association. The system checks… |
| PopLocationAddList | string | no | The list of access areas and access points to be added (JSON-encoded) |
| PopLocationDeleteList | string | no | The list of access areas and access points to be deleted (JSON-encoded) |
| AssociationMode | string | no | The association mode. Valid values: Default: In this mode, the cloud resource instance to be associated is set as the default origin… |

### version
`POST https://apizie.tech/v1/cloud:aliyun-eipanycast/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://eipanycast.cn-hangzhou.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-eipanycast/allocate-anycast-eip-address" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Anycast EIP API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-eipanycast/allocate-anycast-eip-address with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Anycast EIP API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Anycast EIP itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Anycast EIP API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-eipanycast.

### What is the status of the Alibaba Cloud Anycast EIP API?
Needs your own provider key (bring your own key)