调用AssociateAnycastEipAddress接口将Anycast EIP绑定到指定地域的云资源实例上。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 AssociateAnycastEipAddress

系统规定参数。取值：AssociateAnycastEipAddress。

BindInstanceId String 是 lb-d7oxbixhxv1uupnon****

要绑定的云资源实例ID。
BindInstanceRegionId String 是 us-west-1

要绑定的云资源实例地域ID。

仅支持绑定部分地域的云资源实例，您可以通过调用DescribeAnycastServerRegions接口获取可绑定云资源实例的地域ID。

BindInstanceType String 是 SlbInstance

要绑定的云资源实例类型。取值：

  • SlbInstance：专有网络类型私网负载均衡（SLB）实例。
  • NetworkInterface：弹性网卡。
AnycastId String 是 aeip-bp1ix34fralt4ykf3****

Anycast EIP实例ID。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

客户端Token，用于保证请求的幂等性。

由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
DryRun Boolean 否 false

是否只预检此次请求。取值：

  • true：发送检查请求，不会绑定实例。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码DryRunOperation。
  • false（默认值）：发送正常请求，通过检查后返回HTTP 2xx状态码并直接进行操作。
PopLocations Array 否

绑定云资源实例时，关联的接入区域的接入点信息。

如果您是第一次绑定，该参数无需配置，系统自动关联所有接入区域。

您可以通过调用DescribeAnycastPopLocations接口获取支持的接入区域的接入点信息。

PopLocation String 否 us-west-1-pop

绑定云资源实例时，关联的接入区域的接入点信息。

如果您是第一次绑定，该参数无需配置，系统自动关联所有接入区域。

您可以通过调用DescribeAnycastPopLocations接口获取支持的接入区域的接入点信息。

AssociationMode String 否 Default

绑定模式，取值：

  • Default：默认模式，将要绑定的云资源实例设置为默认源站。
  • Normal：普通模式，要绑定的云资源实例设置为普通源站。
说明

Anycast EIP支持绑定多个地域的云资源实例，仅支持一个云资源实例为默认源站，其余均为普通源站。当不指定接入点或新增接入点时，访问请求默认转发至默认源站。

  • 如果您是第一次绑定，绑定模式默认取值为Default。
  • 如果您不是第一次绑定，您可以将绑定模式设置为Default，将生效新的默认源站，原默认源站将变更为普通源站。
PrivateIpAddress String 否 192.168.XX.XX

要绑定的弹性网卡的辅助私网IP。

只有当BindInstanceType取值为NetworkInterface时，该参数生效。不输入时，该参数默认为弹性网卡的主私网IP。

返回数据

名称 类型 示例值 描述
RequestId String FBDB18D8-E91E-4978-8D6C-6E2E3EE10133

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=AssociateAnycastEipAddress
&BindInstanceId=lb-d7oxbixhxv1uupnon****
&BindInstanceRegionId=us-west-1
&BindInstanceType=SlbInstance
&AnycastId=aeip-bp1ix34fralt4ykf3****
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&DryRun=false
&PopLocations=[{"PopLocation":"us-west-1-pop"}]
&AssociationMode=Default
&PrivateIpAddress=192.168.XX.XX
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<AssociateAnycastEipAddressResponse>
    <RequestId>FBDB18D8-E91E-4978-8D6C-6E2E3EE10133</RequestId>
</AssociateAnycastEipAddressResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "FBDB18D8-E91E-4978-8D6C-6E2E3EE10133"
}

错误码

访问错误中心查看更多错误码。