文档中心

ArkClaw 企业版

PrivateEgressService

DescribePrivateEgressNetworkAccessRules - 查询私网出口网络访问规则列表

调用 DescribePrivateEgressNetworkAccessRules 接口，查询私网出口网络访问规则列表。

请求参数

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

Action string 必选示例值：DescribePrivateEgressNetworkAccessRules

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

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

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

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

空间的ID。

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

Name string 可选示例值：test

私网出口网络访问规则的名称。

PrivateEgressNetworkAccessRuleIds.N string[] 可选示例值：pwar-2irekkpstr7cw3snftvmi****

规则ID列表。

参数 - N：表示规则ID的序号，单次调用数量上限为100个。

多个规则ID之间用&分隔。

PageNumber integer 可选示例值：1

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

PageSize integer 可选示例值：20

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

PrivateEgressNetworkAccessPolicyId string 必选示例值：pwap-pstr7cw3snftvmi****

私网出口网络访问策略的ID。

返回参数

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

RequestId string 示例值：2026052819520406511920301****

请求ID。

PageNumber integer 示例值：1

当前页码。

PageSize integer 示例值：10

当前分页的行数。

TotalCount integer 示例值：10

符合条件的网络访问规则的数量。

PrivateEgressNetworkAccessRules object[] 示例值：--

规则列表。

PrivateEgressNetworkAccessRuleId string 示例值：pwar-2irekkpstr7cw3snftvmi****

规则的ID。

PrivateEgressNetworkAccessPolicyId string 示例值：pwap-2irekklurj3eo3snftwj3****

网络访问策略的ID。

Name string 示例值：pwar-test

规则的名称。

Description string 示例值：pwar-test

规则的描述。

Priority integer 示例值：1

规则的优先级。

SourceType string 示例值：ClawInstance

源类型。

ClawInstance ：指定Claw实例。

All：所有Claw实例。

SourceIds string[] 示例值：All

源Claw实例的ID。All表示所有Claw实例。

DestCidrs string[] 示例值：10.0.0.0/24

目标网段。

Protocol string 示例值：TCP

协议类型。

TCP：TCP协议。

UDP：UDP协议。

ICMP：ICMP协议。

ALL：支持所有协议。

DestinationPorts string[] 示例值：All

目标端口。All表示所有端口。

RuleAction string 示例值：Allow

执行动作。

Allow ：放行。

Deny：阻断。

IsDefault boolean 示例值：true

是否为默认规则。

true

false

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

规则的创建时间。

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

规则的最近修改时间。

请求示例

GET /?Action=DescribePrivateEgressNetworkAccessRules&Version=2026-03-01&SpaceId=csi-yeihfm47b48gethr****&PrivateEgressNetworkAccessPolicyId=pwap-pstr7cw3snftvmi**** HTTP/1.1​
Host: arkclaw.cn-beijing.volcengineapi.com​
X-Date: 20260729T073614Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260729/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202607291536181382441590488C1A12",​
    "Action": "DescribePrivateEgressNetworkAccessRules",​
    "Version": "2026-03-01",​
    "Service": "arkclaw",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "RequestId": "202605281952040651192030174E6",​
    "PageNumber": 1,​
    "PageSize": 10,​
    "TotalCount": 10,​
    "PrivateEgressNetworkAccessRules": [​
      {​
        "PrivateEgressNetworkAccessRuleId": "pwar-2irekkpstr7cw3snftvmi****",​
        "PrivateEgressNetworkAccessPolicyId": "pwap-2irekklurj3eo3snftwj3****",​
        "Name": "pwar-test",​
        "Description": "pwar-test",​
        "Priority": 1,​
        "SourceType": "ClawInstance",​
        "SourceIds": [​
          "All"​
        ],​
        "DestCidrs": [​
          "10.0.0.0/24"​
        ],​
        "Protocol": "TCP",​
        "DestinationPorts": [​
          "All"​
        ],​
        "RuleAction": "Allow",​
        "IsDefault": true,​
        "CreateTime": "2026-05-10T16:37:37Z",​
        "UpdateTime": "2026-05-10T16:37:37Z"​
      }​
    ]​
  }​
}​

错误码

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

状态码	错误码	错误信息	说明
400	InvalidParameter	Invalid request parameters: %s.	参数不合法。
403	AccessDenied	You are not authorized to perform this action.	请求未通过权限验证。
404	NotFound	Resource not found: %s.	资源不存在。
500	InternalError	Internal server error: %s.	内部服务错误。

最近更新时间：2026.09.16 16:43:16

这个页面对您有帮助吗？

有用

无用