文档中心

ArkClaw 企业版

请输入

PrivateEgressService

ModifyPrivateEgressNetworkAccessRule - 修改私网出口网络访问规则

调用 ModifyPrivateEgressNetworkAccessRule 接口，修改私网出口网络访问规则。

请求参数

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

Action string 必选示例值：ModifyPrivateEgressNetworkAccessRule

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

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

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

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

空间的ID。

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

Name string 可选示例值：test

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

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

网络访问规则的ID。

您可以调用 DescribePrivateEgressNetworkAccessRules 接口，获取网络访问规则ID。

Description string 可选示例值：test

私网出口网络访问规则的描述。

Priority integer 可选示例值：1

优先级。

取值范围为1-10000。

数字越小优先级越高。

同策略内优先级唯一。

SourceType string 可选示例值：ALL

源类型。

ClawInstance：指定Claw实例。

All：所有Claw实例。

SourceIds string 可选示例值：All

源Claw实例的ID。

使用英文逗号分隔的多个Claw实例 ID。

SourceType为All时，SourceIDs只能为All。

DestCidrs string 可选示例值：192.168.1.0/24

目的IP。

使用英文逗号分隔多个 IPv4 CIDR。

All表示匹配所有目的 IP。

Protocol string 可选示例值：TCP

协议类型。取值如下：

TCP：TCP协议。

UDP：UDP协议。

ICMP：ICMP协议。

ALL：支持所有协议。

DestinationPorts string 可选示例值：80

目的端口。

支持单个端口（如 443）或端口范围（如8000-9000）。取值范围为1~65535。

当Protocol 传入TCP或UDP时，取值范围为1~65535。

ALL表示匹配所有端口，当协议类型为ALL、ICMP时，仅支持输入ALL。

RuleAction string 可选示例值：Allow

执行动作。

Allow：放行。

Deny：阻断。

ClientToken string 可选示例值：123e4567-e89b-12d3-a456-42665544****

客户端Token，用于保证请求幂等性。

由客户端自动生成一个参数值，确保不同请求间该参数值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。

仅支持ASCII字符，且不能超过64个字符。

若不传入ClientToken，则此次API调用不进行幂等校验。

返回参数

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

RequestId string 示例值：2026052819520406511920301****

请求ID。

AsyncTaskId string 示例值：asynctask_0924yr7ybl3****

异步任务ID。

请求示例

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

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202607291551551380880761941D1878",​
    "Action": "ModifyPrivateEgressNetworkAccessRule",​
    "Version": "2026-03-01",​
    "Service": "arkclaw",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "RequestId": "2026052819520406511920301****",​
    "AsyncTaskId": "asynctask_0924yr7ybl3****"​
  }​
}​

错误码

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

状态码	错误码	错误信息	说明
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.07.31 17:41:18

这个页面对您有帮助吗？

有用

无用