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

ArkClaw 企业版

复制全文
下载 pdf
PrivateEgressService
CreatePrivateEgressNetworkAccessRule - 创建私网出口网络访问规则
复制全文
下载 pdf
CreatePrivateEgressNetworkAccessRule - 创建私网出口网络访问规则
调用 CreatePrivateEgressNetworkAccessRule 接口,创建私网出口网络访问规则。​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:CreatePrivateEgressNetworkAccessRule​
要执行的操作,取值:CreatePrivateEgressNetworkAccessRule。​
​
Version string 必选 示例值:2026-03-01​
API的版本,取值:2026-03-01。​
​
SpaceId string 必选 示例值:csi-yeihfm47b48gethr****​
空间ID。​
您可以调用 ListClawSpaces 接口,获取空间ID。​
​
PrivateEgressNetworkAccessPolicyId string 必选 示例值:pnap-2iqtovxg6ftvk3snftvgd****​
网络访问策略ID。​
​
Name string 可选 示例值:test​
网络访问规则的名称。​
  • 长度限制为1 ~ 128个字符。​
  • 需要以字母、中文或数字开头,可包含点号(.)、下划线(_)和短横线(-)。​
  • 不填默认为规则的ID。​
  • 不能以http://或https://开头。​
​
Description string 可选 示例值:test​
网络访问规则的描述。​
  • 长度限制为0~ 255个字符。​
  • 不填默认为空字符串。​
  • 需要以字母、中文或数字开头。可包含英文逗号(,)、点号(.)、下划线(_)、空格( )、等号(=)、短横线(-)、中文逗号(,)、中文句号(。)。​
  • 不能以http://或https://开头。​
​
Priority integer 必选 示例值:1​
网络访问规则的优先级。​
  • 取值范围:1-10000。​
  • 数字越小优先级越高。​
  • 同策略内优先级唯一。​
​
SourceType string 必选 示例值:All​
源类型。取值如下:​
  • ClawInstance:指定Claw实例。​
  • All:所有Claw实例。​
​
SourceIds string 可选 示例值:All​
CLAW 实例 ID。​
  • SourceType为ClawInstance时,此参数必传,多个Claw 实例 ID 之间用英文逗号分隔。​
  • SourceType为All时,若传入本参数,SourceIDs只能为All。​
​
DestCidrs string 必选 示例值:10.0.0.0/16​
目的网段。​
  • 用英文逗号分隔的 IPv4 CIDR。​
  • All 表示匹配所有目的 IP。​
​
Protocol string 必选 示例值:TCP​
协议类型。取值如下:​
  • TCP:TCP协议。​
  • UDP:UDP协议。​
  • ICMP:ICMP协议。​
  • ALL:支持所有协议。​
​
DestinationPorts string 必选 示例值:90​
目的端口。​
  • 支持单个端口(如443)或端口范围(如8000-9000),取值范围为1~65535。​
  • 当Protocol 传入TCP或UDP时,取值范围为1~65535。​
  • ALL表示匹配所有端口,当协议类型为ALL、ICMP时,仅支持输入ALL。​
​
RuleAction string 必选 示例值:Allow​
执行动作。取值如下:​
  • Allow :允许。​
  • Deny:拒绝。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
RequestId string 示例值:202605281952040651192030****​
请求ID。​
​
AsyncTaskId string 示例值:asynctask_0924yr7ybl3****​
异步任务ID。​
​
PrivateEgressNetworkAccessRuleId string 示例值:pnar-2irprpniihngg3snftvkf****​
网络访问规则的ID。​
​
​
​
请求示例​
​
GET /?Action=CreatePrivateEgressNetworkAccessRule&Version=2026-03-01&SpaceId=csi-yeihfm47b48gethr****&PrivateEgressNetworkAccessPolicyId=pnap-2iqtovxg6ftvk3snftvgd****&Priority=1&SourceType=All&DestCidrs=10.0.0.0%2F16&Protocol=TCP&DestinationPorts=90&RuleAction=Allow HTTP/1.1​
Host: arkclaw.cn-beijing.volcengineapi.com​
X-Date: 20260729T093453Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260729/cn-beijing/arkclaw/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202607291734480400840151074C5601",​
"Action": "CreatePrivateEgressNetworkAccessRule",​
"Version": "2026-03-01",​
"Service": "arkclaw",​
"Region": "cn-beijing"​
},​
"Result": {​
"RequestId": "202605281952040651192030****",​
"AsyncTaskId": "asynctask_0924yr7ybl3****",​
"PrivateEgressNetworkAccessRuleId": "pnar-2irprpniihngg3snftvkf****"​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
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
这个页面对您有帮助吗?
有用
有用
无用
无用