调用AttachDdosToAccelerator接口将DDoS高防实例与全球加速实例绑定。

使用说明

在调用本接口时,请注意以下事项:

  • 调用本接口时,系统会判断全球加速是否拥有服务关联角色AliyunServiceRoleForGaAntiDdos:
    • 如果全球加速不存在服务关联角色AliyunServiceRoleForGaAntiDdos,系统会自动创建该服务关联角色,并为该服务关联角色添加名称为AliyunServiceRolePolicyForGaAntiDdos的权限策略,授予全球加速拥有访问DDoS高防实例的权限。
    • 如果全球加速已经拥有服务关联角色AliyunServiceRoleForGaAntiDdos,则不会重复创建该服务关联角色。

      详细信息,请参见AliyunServiceRoleForGaAntiDdos

  • AttachDdosToAccelerator接口属于异步接口,即系统会先返回一个请求ID,但DDoS高防实例与全球加速实例并未绑定完成,系统后台的关联任务仍在进行。您可以调用DescribeAcceleratorListAccelerators查询全球加速实例的状态:
    • 当全球加速实例处于configuring状态时,表示DDoS高防实例与全球加速实例正在绑定中,在该状态下,您只能执行查询操作,不能执行其他操作。
    • 当全球加速实例处于active状态时,表示DDoS高防实例与全球加速实例绑定完成。
  • AttachDdosToAccelerator接口不支持并发为同一个全球加速实例绑定DDoS高防实例。

调试

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

请求参数

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

系统规定参数。取值:AttachDdosToAccelerator

AcceleratorId String ga-bp1odcab8tmno0hdq****

要绑定DDoS高防实例的全球加速实例ID。

DdosId String ddoscoo-cn-zz11vq7j****

要绑定到全球加速实例的DDoS高防实例ID。

DdosRegionId String cn-hangzhou

DDoS高防实例所在的地域,取值:

  • cn-hangzhou:中国内地。
  • ap-southeast-1:非中国内地。
RegionId String cn-hangzhou

全球加速实例所在的地域ID,仅取值cn-hangzhou

返回数据

名称 类型 示例值 描述
DdosId String ddoscoo-cn-zz11vq7j****

绑定到全球加速实例的DDoS高防实例ID。

RequestId String DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

请求ID。

GaId String ga-bp1odcab8tmno0hdq****

绑定了DDoS高防实例的全球加速实例ID。

示例

请求示例

POST /?Action=AttachDdosToAccelerator&AcceleratorId=ga-bp1odcab8tmno0hdq****&DdosId=ddoscoo-cn-zz11vq7j****&DdosRegionId=cn-hangzhou&RegionId=cn-hangzhou&公共请求参数 HTTP/1.1

正常返回示例

XML格式

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

<AttachDdosToAcceleratorResponse>
    <DdosId>ddoscoo-cn-zz11vq7j****</DdosId>
    <RequestId>DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6</RequestId>
    <GaId>ga-bp1odcab8tmno0hdq****</GaId>
</AttachDdosToAcceleratorResponse>

JSON格式

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

{
  "DdosId" : "ddoscoo-cn-zz11vq7j****",
  "RequestId" : "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "GaId" : "ga-bp1odcab8tmno0hdq****"
}

错误码

HttpCode 错误码 错误信息 描述
400 DdosId.Error Failed to find the DDoS instance based on the DDoS ID. 获取DDoS信息失败
400 NoPermission.GaDdosRoleSession You are not authorized to perform the operation. 用户没有创建服务关联角色的权限,请联系阿里云账号(主账号)或权限管理员授予权限AliyunGlobalAccelerationFullAccess,或者创建服务关联角色的自定义权限。 自定义权限策略的相关信息为ServiceName:ddos.ga.aliyuncs.com。 服务关联角色名称为AliyunServiceRoleForGaAntiDDos。 执行该操作所需的用户权限为ram:CreateServiceLinkedRole。

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