文档中心

ArkClaw 企业版

请输入

PrivateEgressService

CreatePrivateEgressDnsBlockRule - 创建私网出口域名解析封禁规则

调用CreatePrivateEgressDnsBlockRule接口，创建私网出口域名解析封禁规则。

使用说明

调用本API之前，您已开启域名封禁规则功能。

请求参数

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

Action string 必选示例值：CreatePrivateEgressDnsBlockRule

要执行的操作，取值：CreatePrivateEgressDnsBlockRule。

Version string 必选示例值：2026-03-01

API的版本，取值：2026-03-01。

SpaceId string 必选示例值：csi-yeihfm47b48gethr****

空间ID。

您可以调用 ListClawSpaces 接口，获取空间ID。

PrivateEgressId string 必选示例值：pre-p6q7r8s9t0****

私网出口的ID。

Name string 可选示例值：block-kafka-domain

域名解析封禁规则名称。

长度限制为1 ~ 128个字符。

需要以字母、中文或数字开头，可包含点号（.）、下划线（_）和短横线（-）。

不填默认为域名封禁规则的ID。

不能以http://或https://开头。

Description string 可选示例值：封禁 Kafka 相关域名

域名解析封禁规则描述。

长度限制为0~ 255个字符。

不填默认为空字符串。

需要以字母、中文或数字开头。可包含英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（-）、中文逗号（，）、中文句号（。）。

不能以http://或https://开头。

Domains.N string[] 必选示例值：Domains.1=a.test.com

域名解析封禁域名列表。

参数 - N：表示域名的序号，最多支持50 个。

多个域名之间用&分隔。

支持子域名和泛域名。

不支持 * 和 . 单独配置。

不同规则之间域名不可重复。

SourceType string 可选示例值：ClawInstance

源类型。取值如下：

ClawInstance（默认）：指定Claw实例。

All ：所有Claw实例。

SourceIds.N string[] 可选示例值：SourceIds.1=claw-abc123**** & SourceIds.2=claw-def456****

源实例ID。

您可以调用 ListClawInstances接口，获取Claw实例的ID。

SourceType传入ClawInstance 时，支持传入本参数。

参数-N：表示Claw实例的ID，最多支持100个。

多个Claw实例ID之间用 & 分隔。

返回参数

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

RequestId string 示例值：202605281952040651192030174E6****

请求ID。

AsyncTaskId string 示例值：asynctask-13f0odozfrdvk3n6nu41l****

异步任务ID。

RuleId string 示例值：dbr-a1b2c3****

域名解析封禁规则ID。

请求示例

GET /?Action=CreatePrivateEgressDnsBlockRule&Version=2026-03-01&SpaceId=csi-yeihfm47b48gethr****&PrivateEgressId=pre-p6q7r8s9t0****&Domains.1=Domains.1%3Da.test.com HTTP/1.1​
Host: arkclaw.cn-beijing.volcengineapi.com​
X-Date: 20260729T084936Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260729/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "20260729142259186020090247EC71EA",​
    "Action": "CreatePrivateEgressDnsBlockRule",​
    "Version": "2026-03-01",​
    "Service": "arkclaw",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "RequestId": "202605281952040651192030174E6****",​
    "AsyncTaskId": "asynctask-13f0odozfrdvk3n6nu41l****",​
    "RuleId": "dbr-a1b2c3****"​
  }​
}​

错误码

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

状态码	错误码	错误信息	说明
400	InvalidParameter	Invalid request parameters: %s.	参数不合法。
404	NotFound	Resource not found: %s.	资源不存在。
500	InternalError	Internal server error: %s.	内部服务错误。

最近更新时间：2026.07.31 17:41:17

这个页面对您有帮助吗？

有用

无用