调用 CreateAllowList 接口可以创建一个新的 IP 白名单规则。

使用说明

创建白名单并绑定白名单和 Kafka 实例后，白名单中配置的 IP 地址或地址段才能访问该实例。每个火山引擎账号在每个地域下最多创建 100 个白名单。

调试

请求参数

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

返回参数

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

请求示例

POST /?Action=CreateAllowList&Version=2022-05-01 HTTP/1.1
Content-Type: application/json
Host: kafka.volcengineapi.com
X-Date: 20210328T100802Z
Authorization: HMAC-SHA256 Credential=AK********/20210328/cn-beijing/Kafka/request, SignedHeaders=x-date, Signature=********

{
    "AllowList":"127.0.0.1,192.168.0.1/24",
    "AllowListName":"测试",
    "AllowListDesc":"测试白名单"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "2023100916165107E94074D816B8C1E88A",
        "Action": "CreateAllowList",
        "Version": "2022-05-01",
        "Service": "Kafka",
        "Region": "cn-beijing"
    },
    "Result": {
        "AllowListId": "acl-fda2ed6365b94c909e44198fbbf48bcd"
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。