You need to enable JavaScript to run this app.
文档中心
ArkClaw 企业版

ArkClaw 企业版

复制全文
下载 pdf
PrivateEgressService
CreatePrivateEgressDnsBlockRule - 创建私网出口域名解析封禁规则
复制全文
下载 pdf
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。​
  • 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
这个页面对您有帮助吗?
有用
有用
无用
无用