调用CreatePrivateEgressDnsBlockRule接口，创建私网出口域名解析封禁规则。 ## 使用说明调用本API之前，您已开启域名封禁规则功能。 ## 请求参数下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见[公共参数](https://www.volcengine.com/docs/6369/67268)。 **Action** string 必选 `示例值：CreatePrivateEgressDnsBlockRule` 要执行的操作，取值：CreatePrivateEgressDnsBlockRule。 **Version** string 必选 `示例值：2026-03-01` API的版本，取值：2026\-03\-01。 **SpaceId** string 必选 `示例值：csi-yeihfm47b48gethr****` 空间ID。您可以调用 [ListClawSpaces](https://docs.volcengine.com/docs/87732/2483224) 接口，获取空间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](https://docs.volcengine.com/docs/87732/2466959)接口，获取Claw实例的ID。 * SourceType传入ClawInstance 时，支持传入本参数。 * 参数\-N：表示Claw实例的ID，最多支持100个。 * 多个Claw实例ID之间用 & 分隔。 ## 返回参数下方仅列出本接口特有的返回参数。更多信息请参见[返回结构](https://www.volcengine.com/docs/6369/80336)。 **RequestId** string `示例值：202605281952040651192030174E6****` 请求ID。 **AsyncTaskId** string `示例值：asynctask-13f0odozfrdvk3n6nu41l****` 异步任务ID。 **RuleId** string `示例值：dbr-a1b2c3****` 域名解析封禁规则ID。 ## 请求示例 ```text 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 ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20260729142259186020090247EC71EA", "Action": "CreatePrivateEgressDnsBlockRule", "Version": "2026-03-01", "Service": "arkclaw", "Region": "cn-beijing" }, "Result": { "RequestId": "202605281952040651192030174E6****", "AsyncTaskId": "asynctask-13f0odozfrdvk3n6nu41l****", "RuleId": "dbr-a1b2c3****" } } ``` ## 错误码下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见[公共错误码](https://www.volcengine.com/docs/6369/68677)文档。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |400 |InvalidParameter |Invalid request parameters: %s. |参数不合法。 | |404 |NotFound |Resource not found: %s. |资源不存在。 | |500 |InternalError |Internal server error: %s. |内部服务错误。 |

ArkClaw 企业版