您可以使用 CreateAclRule 接口创建访问管控规则，管控指定 IP 地址的访问。支持设置对应的允许访问名单和禁止访问名单。

请求说明

• 请求方式：POST
• 请求地址：https://open.volcengineapi.com/?Action=CreateAclRule&Version=2023-12-25

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Body

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

请求示例

POST /?Action=CreateAclRule&Version=2023-12-25 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241120T122924Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/waf/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
    "Action": "observe",
    "HostGroupId": [
        7436
    ],
    "Description": "禁止特定 IP 访问。",
    "Name": "访问控制1",
    "IpLocationCountry": [
        "US",
        "JP"
    ],
    "IpLocationSubregion": [
        "Anhui",
        "Guangdong"
    ],
    "AccurateGroup": {
        "Logic": 1,
        "AccurateRules": [
            {
                "ValueString": "Get",
                "Opretar": 2,
                "ObjType": 2,
                "HttpObj": "request.schema",
                "Property": 0
            }
        ]
    },
    "Url": "/path",
    "PrefixSwitch": 0,
    "IpAddType": 4,
    "HostAddType": 2,
    "Enable": 1,
    "Advanced": 1,
    "AclType": "Block",
    "HostList": [
        "*.test.com",
        "www.test.com"
    ],
    "IpGroupId": [
        6283
    ],
    "IpList": [
        "1.1.1.1",
        "1.1.1.2"
    ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120203109226190241094C8EFC3",
    "Action": "CreateAclRule",
    "Version": "2023-12-25",
    "Service": "waf",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": 111229
  }
}

错误码

您可访问公共错误码，获取更多错误码信息。

国内地理位置列表