文档中心

ArkClaw 企业版

请输入

PrivateEgressService

DescribePrivateEgressDnsBlockRules - 查询域名解析封禁规则列表

调用 DescribePrivateEgressDnsBlockRules 接口，查询域名解析封禁规则列表。

请求参数

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

Action string 必选示例值：DescribePrivateEgressDnsBlockRules

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

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

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

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

空间ID。

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

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

私网出口的ID。

PageNumber integer 可选示例值：1

列表的页码。默认值为1。

PageSize integer 可选示例值：20

分页查询时每页的行数。最大值为100，默认值为20。

RuleIds.N string[] 可选示例值：dbr-a1b2c3****

域名解析封禁规则的ID。

参数-N：表示域名解析封禁规则 ID 的序号，调用上限为100。

多个域名解析封禁规则ID之间用 & 分隔。

Name string 可选示例值：DNS‑DENY‑PHISHING‑LIST

域名解析封禁规则的名称。

返回参数

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

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

请求ID。

PageNumber integer 示例值：1

当前页码。

PageSize integer 示例值：20

当前分页的行数。

TotalCount integer 示例值：1

符合条件的封禁规则总数。

DnsBlockRules object[] 示例值：--

私网出口域名封禁规则信息。

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

域名解析封禁规则ID。

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

私网出口的ID。

SpaceNetworkId string 示例值：csn-3hxxy2a53tce81wincnyu****

空间网络的ID。

Name string 示例值：DNS‑DENY‑PHISHING‑LIST

域名解析封禁规则名称。

Description string 示例值：Phishing Domain Blacklist Resolution Interception

域名解析封禁规则描述。

Domains string[] 示例值：a.test.com

域名解析封禁域名列表。

SourceType string 示例值：ClawInstance

源实例类型。

ClawInstance：指定Claw实例。

All ：所有Claw实例。

SourceIds string[] 示例值：claw-adsf****

源实例ID。

Status string 示例值：Enabled

域名解析封禁规则的状态。

Enabled

Disabled

Enabling

Disabling

Configuring

CreateTime string 示例值：2026-05-10T16:37:37Z

规则的创建时间。

UpdateTime string 示例值：2026-05-10T16:37:37Z

规则的最近修改时间。

请求示例

GET /?Action=DescribePrivateEgressDnsBlockRules&Version=2026-03-01&SpaceId=csi-yeihfm47b48gethr****&PrivateEgressId=pre-p6q7r8s9t0****&RuleId=dbr-a1b2c3d4e5 HTTP/1.1​
Host: arkclaw.cn-beijing.volcengineapi.com​
X-Date: 20260724T024706Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260724/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "2026072914361212901807409455B6FB",​
    "Action": "DescribePrivateEgressDnsBlockRules",​
    "Version": "2026-03-01",​
    "Service": "arkclaw",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "RequestId": "202605281952040651192030174E6****",​
    "PageNumber": 1,​
    "PageSize": 20,​
    "TotalCount": 1,​
    "DnsBlockRules": [​
      {​
        "RuleId": "dbr-a1b2c3****",​
        "PrivateEgressId": "pre-p6q7r8s9t0****",​
        "SpaceNetworkId": "csn-3hxxy2a53tce81wincnyu****",​
        "Name": "DNS‑DENY‑PHISHING‑LIST",​
        "Description": "Phishing Domain Blacklist Resolution Interception",​
        "Domains": [​
          "a.test.com"​
        ],​
        "SourceType": "ClawInstance",​
        "SourceIds": [​
          "claw-adsf****"​
        ],​
        "Status": "Enabled",​
        "CreateTime": "2026-05-10T16:37:37Z",​
        "UpdateTime": "2026-05-10T16:37:37Z"​
      }​
    ]​
  }​
}​

错误码

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

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

最近更新时间：2026.09.16 16:44:12

这个页面对您有帮助吗？

有用

无用