调用DescribeVpcEndpointZones接口，查询指定终端节点已添加的可用区。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Action String 必选示例值：DescribeVpcEndpointZones

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

Version String 必选示例值：2020-04-01

API的版本信息，当前版本为 2020-04-01。

EndpointId String 必选示例值：ep-273yuq6q7bgn47fap8squ****

终端节点的ID。

您可以调用DescribeVpcEndpoints接口，获取终端节点的ID。

PageNumber Integer 可选示例值：1

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

PageSize Integer 可选示例值：10

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

返回参数

RequestId String 示例值：0ED8D006-F706-4D23-88ED-E11ED28D****

请求ID。

PageNumber Integer 示例值：1

当前页码。

PageSize Integer 示例值：10

当前分页的行数。

TotalCount Integer 示例值：2

符合条件的终端节点服务总数。

EndpointZones Object[] 示例值：-

终端节点可用区的详细信息。

ZoneId String 示例值：cn-guangzhou-a

终端节点可用区的ID。

ZoneDomain String 示例值：ep-273yuq6q7bgn47fap8squ****.cn-guangzhou-a.epsvc-273yuqembrojk7fap8sbf****.cn-guangzhou.privatelink.volces.com

终端节点可用区的域名。格式为<终端节点ID>.<可用区ID>.<终端节点服务ID>.<地域ID>.privatelink.volces.com。

ZoneStatus String 示例值：Connected

终端节点可用区的状态。

PendingAcceptance：等待连接。

Connecting：连接中。

Connected：已连接。

Disconnecting：断开连接中。

Rejected：拒绝连接。

Failed：连接失败。

ServiceStatus String 示例值：Active

终端节点IPv4地址的服务状态。

Active：正常。

Inactive：异常。

Ipv6ServiceStatus String 示例值：Active

终端节点IPv6地址的服务状态。

Active：正常。

Inactive：异常。

说明

终端节点仅支持IPv4时，不返回该参数。

SubnetId String 示例值：subnet-2744ts087kglc7fap8tu6****

终端节点网卡所属子网的ID。

NetworkInterfaceId String 示例值：eni-273w2q67fwq9s7fap8t1a****

终端节点网卡的 ID。

若处于平滑更换服务资源期间，终端节点的原有网卡继续与旧服务资源保持连接，同时新增一张网卡用于与新服务资源建立连接。本参数为该新增网卡的ID。

NetworkInterfaceIP String 示例值：192.XX.XX.3

终端节点网卡的私网 IPv4 地址。

若处于平滑更换服务资源期间，终端节点的原有网卡继续与旧服务资源保持连接，同时新增一张网卡用于与新服务资源建立连接。本参数为该新增网卡的 IPv4 地址。

NetworkInterfaceIpv6 String 示例值：2408::153:3921:XX:XX:7b12:1c5f

终端节点网卡的私网 IPv6 地址。

若处于平滑更换服务资源期间，终端节点的原有网卡继续与旧服务资源保持连接，同时新增一张网卡用于与新服务资源建立连接。本参数为该新增网卡的 IPv6 地址。

说明

终端节点仅支持 IPv4 时，不返回该参数。

ReplacedNetworkInterfaceId String 示例值：eni-273w2q67fwq9s7fap8t1a****

平滑更换服务资源期间，终端节点的原有网卡继续与旧服务资源保持连接，同时新增一张网卡用于与新服务资源建立连接。本参数为该原有网卡的 ID。

如未处于平滑更换服务资源期间，则该参数返回空。

ReplacedNetworkInterfaceIp String 示例值：192.XX.XX.4

平滑更换服务资源期间，终端节点的原有网卡继续与旧服务资源保持连接，同时新增一张网卡用于与新服务资源建立连接。本参数为该原有网卡的 IPv4 地址。

如未处于平滑更换服务资源期间，则该参数返回空。

ReplacedNetworkInterfaceIpv6 String 示例值：2408::153:3921:XX:XX:7b12:1acc

平滑更换服务资源期间，终端节点的原有网卡继续与旧服务资源保持连接，同时新增一张网卡用于与新服务资源建立连接。本参数为该原有网卡的 IPv6 地址。

如未处于平滑更换服务资源期间，则该参数返回空。

说明

终端节点仅支持IPv4时，不返回该参数。

请求示例

返回示例

错误码

此处仅展示当前API的错误码，更多错误码请参见公共错误码。

状态码	错误码	错误信息	说明
400	MissingParameter	The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request; for example, the 'XXX'.	该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如XXX。说明其中，XXX表示缺少的参数名称。
400	InvalidPaging.Malformed	The specified PageNumber or PageSize is malformed.	指定的分页参数格式不合法。
404	InvalidEndpoint.NotFound	The specified endpoint does not exist.	指定的终端节点不存在。

私网连接