CreatePolicy

1. 接口描述

本接口(CreatePolicy)用于创建防护策略

2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

参数名称	必选	类型	描述
policyName	是	String	防护策略的名称。 范围2到63个字符。 仅支持输入字母、数字、-和英文句点(.)。 且必须以数字或字母开头和结尾。
resourceGroupId	否	String	创建后防护策略所在的资源组ID，如不指定则放入默认资源组。
blackIpList	否	Array of String	黑名单列表。
whiteIpList	否	Array of String	白名单列表。
ipBlackTimeout	否	Integer	黑名单超时时间, 单位:分钟。 可选值范围：[1, 10080]。
ports	否	Array of DdosPolicyPort	端口封禁, 支持TCP和UDP。
blockProtocol	否	Array of Protocol	开启的封禁协议。 不能同时开启UDP和TCP。
blockRegions	否	Array of String	封禁的区域。
finger	否	Array of DdosFingerprintRule	指纹过滤相关配置。
reflectUdpPort	否	Array of DdosReflectUdpPort	反射攻击防护过滤的端口列表。
trafficControl	否	DdosTrafficControl	源限速配置。
tags	否	TagAssociation	创建DDoS时关联的标签。 注意：·关联标签键不能重复。

3. 响应结果

参数名称	类型	描述
requestId	String	唯一请求 ID。 每次请求都会返回。定位问题时需要提供该次请求的 requestId。
policyId	String	防护策略ID。

4. 代码示例

示例

1. 创建防护策略

POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: CreatePolicy
<Common Request Params>

Request：
{
    "policyName": "policyName",
    "blackIpList": ["10.0.0.1","10.0.0.2"],
    "whiteIpList": ["10.0.0.1","10.0.0.2"],
    "ipBlackTimeout": 100,
    "ports": [
      {
        "protocol": "TCP",
        "srcPortStart": 1,
        "srcPortEnd": 100,
        "dstPortStart": 1,
        "dstPortEnd": 100,
        "action": "Accept"
      }
    ]
}

Response：
{
  "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
  "response": {
    "requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
    "policyId": "<policyId>"
  }
}

5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的开发工具集（SDK），未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见公共错误码

HTTP状态码	错误码	说明
404	INVALID_DDOS_POLICY_REGION_NOT_FOUND	封禁区域不存在。
400	INVALID_IP_FORMAT	IP格式错误。
400	INVALID_POLICY_PACKET_LENGTH_RANGE_OF_FINGERPRINT	指纹过滤的端口范围错误。
400	INVALID_POLICY_PORT_OVERLAP	端口范围有重叠。
400	INVALID_POLICY_PORT_RANGE_OF_BLOCKING	端口封禁的端口范围错误。
400	INVALID_POLICY_PORT_RANGE_OF_FINGERPRINT	指纹过滤的端口范围错误。
400	INVALID_POLICY_PROTOCOL_CONFLICT	封禁协议冲突，不能同时开启UDP和TCP。
409	INVALID_POLICY_TRAFFIC_CONTROL_VALUE	源限速值未设定。
409	INVALID_REFLECT_UDP_PORT_CONFLICT_DEFAULT	自定义UDP反射源端口已存在在默认中，无法设置。
400	OPERATION_DENIED_POLICY_ACTION_AFTER_MATCHING	匹配后的动作不支持。
400	OPERATION_DENIED_POLICY_FINGERPRINT_FILTER_LIMITED	指纹过滤数量超过限制。
400	OPERATION_DENIED_POLICY_PORT_BLOCKING_LIMITED	端口封禁数量超过限制。
400	OPERATION_DENIED_POLICY_REFLECTION_ATTACK_FILTERING_LIMITED	反射攻击过滤数量超过限制。
400	OPERATION_DENIED_POLICY_WHITE_BLACK_IP_LIMITED	IP黑白名单数量超过限制。