华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255

概述 针对DDoS攻击，华为云提供多种安全防护方案，您可以根据您的实际业务选择合适的防护方案。华为云DDoS防护服务（Anti-DDoS Service，简称AAD）提供了DDoS原生基础防护（Anti-DDoS流量清洗）、DDoS原生高级防护和DDoS高防三个子服务。 DDoS原生基础防护（Anti-DDoS流量清洗）服务（以下简称Anti-DDoS）为华为云内公网IP资源（弹性云服务器、弹性负载均衡），提供网络层和应用层的DDoS攻击防护（如泛洪流量型攻击防护、资源消耗型攻击防护），并提供攻击拦截实时告警，有效提升用户带宽利用率，保障业务稳定可靠。 您可以使用本文档提供的API对Anti-DDoS进行相关操作，如查询、更新Anti-DDoS服务等。支持的全部操作请参见API概览。 在调用Anti-DDoS API之前，请确保已经充分了解Anti-DDoS相关概念，详细信息请参见《DDoS防护用户指南》的“产品介绍”章节。 父主题： 使用前必读

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 ddos_intercept_times Integer 一周内DDoS拦截次数 最小值：0 最大值：2147483647 weekdata Array of WeeklyCount objects 一周的攻击次数统计数据 数组长度：0 - 2147483647 top10 Array of WeeklyTop10 objects 被攻击次数排名前10的IP地址 数组长度：0 - 2147483647 表5 WeeklyCount 参数 参数类型 描述 ddos_intercept_times Integer DDoS拦截次数 最小值：0 最大值：2147483647 ddos_blackhole_times Integer DDoS黑洞次数 最小值：0 最大值：2147483647 max_attack_bps Integer 最大攻击流量 最小值：0 最大值：2147483647 max_attack_conns Integer 最大攻击连接数 最小值：0 最大值：2147483647 period_start_date Long 开始时间 最小值：0 最大值：999999999 表6 WeeklyTop10 参数 参数类型 描述 floating_ip_address String 弹性IP地址 最小长度：7 最大长度：128 times Integer DDoS拦截次数，包括清洗和黑洞 最小值：0 最大值：2147483647

响应示例 状态码： 200 请求已成功 { "ddos_intercept_times" : 0, "weekdata" : [ { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1605496722606 }, { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1605583122606 }, { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1605669522606 }, { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1605755922606 }, { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1605842322606 }, { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1605928722606 }, { "ddos_intercept_times" : 0, "ddos_blackhole_times" : 0, "max_attack_bps" : 0, "max_attack_conns" : 0, "period_start_date" : 1606015122606 } ], "top10" : [ ] }

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type请求头 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String token 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type 缺省值：application/json;charset=utf8 最小长度：1 最大长度：128 表3 请求Body参数 参数 是否必选 参数类型 描述 ids 否 Array of strings 批量id

请求示例 删除指定高防实例IP下，ID为“e6e4a678-XXXX-XXXX-XXXX-a47db59553bf”的转发规则。 POST https://{endpoint}/v1/aad/instances/{instance_id}/{ip}/rules/batch-delete { "ids" : [ "e6e4a678-XXXX-XXXX-XXXX-a47db59553bf" ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type 缺省值：application/json;charset=utf8 最小长度：1 最大长度：128 表3 请求Body参数 参数 是否必选 参数类型 描述 instance_id 是 String 实例id type 是 String 规则类型。black - 黑名单， white - 白名单 ips 是 Array of strings ip列表

DDoS原生基础防护状态码 正常 返回值 说明 200 请求成功。 异常 状态码 编码 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求页面的访问被禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突，请求无法被完成。 500 Internal Server Error 请求未完成，服务异常。 501 Not Implemented 请求未完成，服务器不支持所请求的功能。 502 Bad Gateway 请求未完成，服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成，系统暂时异常。 504 Gateway Timeout 网关超时。 父主题： 附录

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户token 最小长度：32 最大长度：2097152 Content-Type 是 String application/json;charset=utf8 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255 表3 请求Body参数 参数 是否必选 参数类型 描述 ip 是 String ip地址 最小长度：7 最大长度：128 blocking_time 否 Long 用于查询IP的封堵时间 最小值：0 最大值：9223372036854775807

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 最小值：0 最大值：2147483647 ips Array of ProtectedIpResponse objects 防护ip列表 数组长度：0 - 2147483647 表5 ProtectedIpResponse 参数 参数类型 描述 id String 防护IP的Id 最小长度：32 最大长度：64 ip String 防护IP 最小长度：7 最大长度：128 type String 类型。VPN：VPN；NAT：NAT；VIP：VIP；CCI：CCI；EIP：弹性公网IP；ELB：弹性负载均衡；REROUTING_IP：REROUTING_IP；SubEni：SubEni；NetInterFace：NetInterFace； name String 名字 最小长度：1 最大长度：255 status Integer 状态：0 - 正常， 1 - 清洗中， 2 - 黑洞中 最小值：0 最大值：2 status_detail IpStatusDetail object 封堵信息 policy_name String 策略名 最小长度：1 最大长度：255 region String 所属region 最小长度：1 最大长度：255 package_id String 防护包id 最小长度：32 最大长度：64 package_name String 防护包名 最小长度：0 最大长度：255 tags String TMS标签 最小长度：1 最大长度：255 tag String 本地标签 最小长度：0 最大长度：255 is_resale Boolean 默认false，表示是否转售版的IP，不需要展示策略和报表 package_version String package_version。cnad_pro：专业版；cnad_ip：标准版；cnad_ep：铂金版；cnad_full_high：全力防高级版；cnad_vic：按需版；cnad_intl_ep：国际站铂金版 表6 IpStatusDetail 参数 参数类型 描述 block_time Long 封堵时间 最小值：0 最大值：9223372036854775807 unblock_time Long 解封时间 最小值：0 最大值：9223372036854775807

URI GET /v1/cnad/packages/{package_id}/unbound-protected-ips 表1 路径参数 参数 是否必选 参数类型 描述 package_id 是 String 防护包id 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 开始查询的偏移量,默认值:0 最小值：0 最大值：65535 limit 否 Integer 每页显示的条目数量,默认值:2000 最小值：1 最大值：2000

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255

请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type请求头 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 enable_L7 Boolean 是否开启L7层防护，固定值为fasle traffic_pos_id Long 流量分段ID，取值范围：1～9、88、99 最小值：1 最大值：99 http_request_pos_id Long HTTP请求数分段ID，取值范围：1～15 最小值：1 最大值：15 cleaning_access_pos_id Long 清洗时访问限制分段ID，取值范围：1～8、88、99 最小值：1 最大值：99 app_type_id Integer 应用类型ID，可选取值： 0 1

URI GET /v1/{project_id}/antiddos/{floating_ip_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 最小长度：32 最大长度：64 floating_ip_id 是 String 用户EIP对应的ID 最小长度：32 最大长度：64 表2 Query参数 参数 是否必选 参数类型 描述 ip 否 String 用户EIP 最小长度：7 最大长度：128

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String token 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type 缺省值：application/json;charset=utf8 最小长度：1 最大长度：128 表3 请求Body参数 参数 是否必选 参数类型 描述 real_server_type 否 Integer 源站类型 0：源站IP 1：源站 域名 real_servers 否 String 源站

Go 配置用户默认的防护策略，清洗时访问限制分段ID设置为8，流量分段ID设置为1。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 package main import ( "fmt" "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic" antiddos "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/antiddos/v1" "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/antiddos/v1/model" region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/antiddos/v1/region" ) func main() { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak := os.Getenv("CLOUD_SDK_AK") sk := os.Getenv("CLOUD_SDK_SK") auth := basic.NewCredentialsBuilder(). WithAk(ak). WithSk(sk). Build() client := antiddos.NewAntiDDoSClient( antiddos.AntiDDoSClientBuilder(). WithRegion(region.ValueOf("cn-north-4")). WithCredential(auth). Build()) request := &model.CreateDefaultConfigRequest{} request.Body = &model.DdosConfig{ AppTypeId: int64(0), CleaningAccessPosId: int64(8), HttpRequestPosId: int64(1), TrafficPosId: int64(1), EnableL7: false, } response, err := client.CreateDefaultConfig(request) if err == nil { fmt.Printf("%+v\n", response) } else { fmt.Println(err) } }

Python 配置用户默认的防护策略，清洗时访问限制分段ID设置为8，流量分段ID设置为1。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 # coding: utf-8 from huaweicloudsdkcore.auth.credentials import BasicCredentials from huaweicloudsdkantiddos.v1.region.antiddos_region import AntiDDoSRegion from huaweicloudsdkcore.exceptions import exceptions from huaweicloudsdkantiddos.v1 import * if __name__ == "__main__": # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment ak = os.getenv("CLOUD_SDK_AK") sk = os.getenv("CLOUD_SDK_SK") credentials = BasicCredentials(ak, sk) \ client = AntiDDoSClient.new_builder() \ .with_credentials(credentials) \ .with_region(AntiDDoSRegion.value_of("cn-north-4")) \ .build() try: request = CreateDefaultConfigRequest() request.body = DdosConfig( app_type_id=0, cleaning_access_pos_id=8, http_request_pos_id=1, traffic_pos_id=1, enable_l7=False ) response = client.create_default_config(request) print(response) except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)

Java 配置用户默认的防护策略，清洗时访问限制分段ID设置为8，流量分段ID设置为1。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 package com.huaweicloud.sdk.test; import com.huaweicloud.sdk.core.auth.ICredential; import com.huaweicloud.sdk.core.auth.BasicCredentials; import com.huaweicloud.sdk.core.exception.ConnectionException; import com.huaweicloud.sdk.core.exception.RequestTimeoutException; import com.huaweicloud.sdk.core.exception.ServiceResponseException; import com.huaweicloud.sdk.antiddos.v1.region.AntiDDoSRegion; import com.huaweicloud.sdk.antiddos.v1.*; import com.huaweicloud.sdk.antiddos.v1.model.*; public class CreateDefaultConfigSolution { public static void main(String[] args) { // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security. // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment String ak = System.getenv("CLOUD_SDK_AK"); String sk = System.getenv("CLOUD_SDK_SK"); ICredential auth = new BasicCredentials() .withAk(ak) .withSk(sk); AntiDDoSClient client = AntiDDoSClient.newBuilder() .withCredential(auth) .withRegion(AntiDDoSRegion.valueOf("cn-north-4")) .build(); CreateDefaultConfigRequest request = new CreateDefaultConfigRequest(); DdosConfig body = new DdosConfig(); body.withAppTypeId(0L); body.withCleaningAccessPosId(8L); body.withHttpRequestPosId(1L); body.withTrafficPosId(1L); body.withEnableL7(false); request.withBody(body); try { CreateDefaultConfigResponse response = client.createDefaultConfig(request); System.out.println(response.toString()); } catch (ConnectionException e) { e.printStackTrace(); } catch (RequestTimeoutException e) { e.printStackTrace(); } catch (ServiceResponseException e) { e.printStackTrace(); System.out.println(e.getHttpStatusCode()); System.out.println(e.getRequestId()); System.out.println(e.getErrorCode()); System.out.println(e.getErrorMsg()); } } }

请求示例 配置用户默认的防护策略，清洗时访问限制分段ID设置为8，流量分段ID设置为1。 POST https://{endpoint}/v1/{project_id}/antiddos/default-config { "app_type_id" : 0, "cleaning_access_pos_id" : 8, "enable_L7" : false, "http_request_pos_id" : 1, "traffic_pos_id" : 1 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type请求头 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255 表3 请求Body参数 参数 是否必选 参数类型 描述 enable_L7 是 Boolean 是否开启L7层防护，固定值为fasle traffic_pos_id 是 Long 流量分段ID，取值范围：1～9、88、99 最小值：1 最大值：99 http_request_pos_id 是 Long HTTP请求数分段ID，取值范围：1～15 最小值：1 最大值：15 cleaning_access_pos_id 是 Long 清洗时访问限制分段ID，取值范围：1～8、88、99 最小值：1 最大值：99 app_type_id 是 Integer 应用类型ID，可选取值： 0 1

URI GET /v1/aad/instances/{instance_id}/{ip}/ddos-statistics 表1 路径参数 参数 是否必选 参数类型 描述 instance_id 是 String 实例Id 最小长度：16 最大长度：64 ip 是 String 单个 IP 最小长度：1 最大长度：45 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 开始时间，毫秒时间戳 end_time 是 String 结束时间，毫秒时间戳

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 attack_kbps_peak Number 攻击峰值 最小值：0 最大值：100000000 in_kbps_peak Number 流量峰值 最小值：0 最大值：100000000 ddos_count Number 攻击次数 最小值：0 最大值：100000000 timestamp Number 攻击峰值发生时间点 最小值：0 最大值：4803811200000 vip String 高防IP

响应示例 状态码： 200 OK { "type" : "self_unblocking_user", "total_unblocking_quota" : 103, "remaining_unblocking_quota" : 100, "unblocking_quota_today" : 4, "remaining_unblocking_quota_today" : 4 }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 type String 用户类型：common_user , native_protection_user total_unblocking_quota Integer 解封总配额 最小值：0 最大值：2097152 remaining_unblocking_quota Integer 剩余解封配额 最小值：0 最大值：2097152 unblocking_quota_today Integer 今日解封配额 最小值：0 最大值：2097152 remaining_unblocking_quota_today Integer 今日剩余解封配额 最小值：0 最大值：2097152

响应示例 状态码： 200 OK { "items" : [ { "package_id" : "0c613ff9-2b63-4aa2-9333-e03541fe0d9a", "package_name" : "name", "region_id" : "cn-north4", "protection_type" : 0, "instance_type" : "cnad_pro", "resource_id" : "0c613ff9-2b63-4aa2-9333-e03541fe0d9a", "count_down_code" : "hws_countdown_period_using", "count_down_infos" : { "status" : 2, "nextOperationPolicy" : 0, "nextOperationRemainingDay" : 10 }, "count_down_tips" : { "effTime" : "2022-10-09T10:00:17Z", "expTime" : "2022-12-09T15:59:59Z" }, "order_id" : " CS 2211020327RKFEA", "subscription_id" : "0c613ff9-2b63-4aa2-9333-e03541fe0d9a", "ip_num" : 100, "ip_num_now" : 100, "protection_num_now" : 1, "protection_num" : 9999, "basic_bandwidth" : 10, "elastic_bandwidth" : 200, "service_bandwidth" : 100, "clean_bandwidth" : 100, "policy_num" : 1, "is_old" : false, "new_flag" : true, "create_time" : 1665309611045 } ], "total" : 1 }

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：32 最大长度：2097152 Content-Type 是 String Content-Type 缺省值：application/json;charset=utf8 最小长度：1 最大长度：255

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 total Integer 总数 最小值：0 最大值：2147483647 items Array of PackageResponse objects 数据 数组长度：0 - 2147483647 表3 PackageResponse 参数 参数类型 描述 package_id String 防护包id 最小长度：32 最大长度：64 package_name String 防护包名 最小长度：1 最大长度：255 region_id String 资源所属region 最小长度：1 最大长度：255 protection_type Integer 防护类型 最小值：0 最大值：1 instance_type String 防护包类型。cnad_pro：专业版；cnad_ip：标准版；cnad_ep：铂金版；cnad_full_high：全力防高级版；cnad_vic：按需版；cnad_intl_ep：国际站铂金版 resource_id String 资源id 最小长度：32 最大长度：64 count_down_code String 倒计时相关信息 最小长度：1 最大长度：255 count_down_infos String 倒计时相关信息 最小长度：1 最大长度：255 count_down_tips String 倒计时相关信息 最小长度：1 最大长度：255 order_id String 订单id 最小长度：17 最大长度：17 subscription_id String 续费用的id 最小长度：32 最大长度：64 ip_num Integer ip数 最小值：0 最大值：2147483647 ip_num_now Integer 当前IP数 最小值：0 最大值：2147483647 protection_num_now Integer 当前防护次数 最小值：0 最大值：9999 protection_num Integer 防护次数，9999为无限次 最小值：0 最大值：9999 basic_bandwidth Integer 保底带宽 最小值：0 最大值：2147483647 elastic_bandwidth Integer 弹性带宽 最小值：0 最大值：2147483647 service_bandwidth Integer 业务带宽 最小值：0 最大值：2147483647 clean_bandwidth Integer 回源带宽 最小值：0 最大值：2147483647 policy_num Integer 策略模板数 最小值：0 最大值：2147483647 is_old Boolean 是否旧防护包（旧防护包不支持升级规格）,默认不传为否 new_flag Boolean 专业版铂金版合并之后购买的专业版和铂金版均标识为true create_time Long 创建时间 最小值：0 最大值：9223372036854775807

响应示例 状态码： 200 请求已成功 { "data" : [ { "period_start" : 1606188642720, "bps_in" : 0, "bps_attack" : 0, "total_bps" : 0, "pps_in" : 0, "pps_attack" : 0, "total_pps" : 0 } ] }