首页 全球加速 开发参考 API参考 API目录 全球加速实例 AttachDdosToAccelerator - 将DDoS高防实例与全球加速实例绑定

AttachDdosToAccelerator - 将DDoS高防实例与全球加速实例绑定

更新时间: 2024-04-10 12:01:46

如果您想让全球加速的应用不受大规模DDoS攻击的影响,确保服务的稳定性和可用性,您可以调用AttachDdosToAccelerator接口将DDoS高防实例与全球加速实例绑定。

接口说明

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

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
AcceleratorIdstring

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

ga-bp1odcab8tmno0hdq****
DdosIdstring

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

ddoscoo-cn-zz11vq7j****
DdosRegionIdstring

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

  • cn-hangzhou:中国内地。

  • ap-southeast-1:非中国内地。

cn-hangzhou
RegionIdstring

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

cn-hangzhou

返回参数

名称类型描述示例值
object

返回数据结构体。

DdosIdstring

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

ddoscoo-cn-zz11vq7j****
RequestIdstring

请求 ID。

DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
GaIdstring

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

ga-bp1odcab8tmno0hdq****

示例

正常返回示例

JSON格式

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

错误码

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

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

变更历史

变更时间变更内容概要操作
暂无变更历史
阿里云首页 全球加速 相关技术圈