私网连接
私网连接
文档指南
请输入
- 文档首页
私网连接API参考PrivateEgressServiceDescribePrivateEgressEndpoints-查询私网出口终端节点列表
复制全文
下载 pdfDescribePrivateEgressEndpoints-查询私网出口终端节点列表
文档反馈
问问助手调用 DescribePrivateEgressEndpoints 接口，查询私网出口终端节点列表。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：DescribePrivateEgressEndpoints
要执行的操作，取值：DescribePrivateEgressEndpoints。
Version String 必选 示例值：2020-04-01
API的版本信息，当前版本为 2020-04-01。
PrivateEgressId String 必选 示例值：pre-p6q7r8s9t0****
私网出口的ID。
PrivateEgressEndpointIds.N String 可选 示例值：ep-273yuq6q7bgn47fap8squ****
私网出口终端节点的 ID。
- 参数-N：表示私网出口终端节点ID的序号。取值访问为1～100。
- 多个私网出口终端节点之间用&分隔。
PageNumber Integer 可选 示例值：1
列表的页码。
- 不填默认值为 1。
- 最小值为 1。
PageSize Integer 可选 示例值：20
分页查询时每页的行数。
- 取值范围为1～100。
- 不填默认值为20。
返回参数
AsyncTaskId String 示例值：asynctask-13f0odozfrdvk3n6nu41l****
异步任务ID。
PageNumber Integer 示例值：1
当前页码。
PageSize Integer 示例值：10
每页行数。
PrivateEgressEndpoints Object[] 示例值：--
私网出口终端节点信息。
VpcId String 示例值：vpc-bp1b1llp3ve5yze****
用户VPC的ID。
Status String 示例值：Available
终端节点的状态。
- Creating：创建中
- Available：可用
- Pending：处理中
- Deleting：删除中
CreateTime String 示例值：2026-08-18 15:19:00
私网出口终端节点创建时间。
UpdateTime String 示例值：2026-08-18 15:19:00
私网出口终端节点更新时间。
EndpointIps String[] 示例值：["192.168.0.2","192.168.0.3","192.168.0.4",192.168.0.5",192.168.0.6","192.168.0.7"]
终端节点的IP列表。
ZoneMappings Object[] 示例值：--
可用区与子网的关联信息。
ZoneId String 示例值：cn-beijing-a
可用区ID。
SubnetId String 示例值：subnet-bp1nhbnpv2blyz8dl****
子网ID。
SpaceNetworkId String 示例值：csn-3hxxy2a53tce81wincnyu****
空间网络的ID。
PrivateEgressId String 示例值：pre-p6q7r8s9t0****
私网出口的ID。
DestinationCidrs String[] 示例值：["192.168.0.0/16"]
可被Claw实例私网访问的企业服务CIDR。
SecurityGroupIds String[] 示例值：["sg-bp1fg655nh68xyz9****"]
安全组 ID。
AppPrivateAccessEnabled Boolean 示例值：false
是否开启应用私网访问。
- true
- false
PrivateEgressEndpointId String 示例值：ep-273yuq6q7bgn47fap8squ****
私网出口终端节点的ID。
RequestId String 示例值：0ED8D006-F706-4D23-88ED-E11ED28D****
请求ID。
TotalCount Integer 示例值：2
满足条件的私网出口终端节点的总数。
请求示例
GET /?Action=DescribePrivateEgressEndpoints&Version=2020-04-01&PrivateEgressId=pre-p6q7r8s9t0****&PrivateEgressEndpointIds.1=ep-273yuq6q7bgn47fap8squ****&PageNumber=1&PageSize=20
Host: privatelink.cn-guangzhou.volcengineapi.com
X-Date: 20251121T094038Z
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-guangzhou/privatelink/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
返回示例
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "DescribePrivateEgressEndpoints",
"Version": "2020-04-01",
"Service": "privatelink",
"Region": "cn-guangzhou"
},
"Result": {
"AsyncTaskId": "asynctask-13f0odozfrdvk3n6nu41l****",
"PageNumber": 1,
"PageSize": 10,
"PrivateEgressEndpoints": [
{
"VpcId": "vpc-bp1b1llp3ve5yze****",
"Status": "Available",
"CreateTime": "2026-08-18 15:19:00",
"UpdateTime": "2026-08-18 15:19:00",
"EndpointIps": [
""
],
"ZoneMappings": [
{
"ZoneId": "cn-beijing-a",
"SubnetId": "subnet-bp1nhbnpv2blyz8dl****"
}
],
"SpaceNetworkId": "csn-3hxxy2a53tce81wincnyu****",
"PrivateEgressId": "pre-p6q7r8s9t0****",
"DestinationCidrs": [
"192.168.0.0/16"
],
"SecurityGroupIds": [
"sg-bp1fg655nh68xyz9****"
],
"AppPrivateAccessEnabled": true,
"PrivateEgressEndpointId": "ep-273yuq6q7bgn47fap8squ****"
}
],
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****",
"TotalCount": 2
}
}
错误码
最近更新时间：2026.08.19 19:35:07
这个页面对您有帮助吗？
有用
有用
无用
无用