调用DescribeVpcEndpointZones接口，查询指定终端节点已添加的可用区。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=DescribeVpcEndpointZones&serviceCode=privatelink&version=2020-04-01&groupName=) ## 请求参数 **Action** String 必选 `示例值：DescribeVpcEndpointZones` 要执行的操作，取值：**DescribeVpcEndpointZones**。 **Version** String 必选 `示例值：2020-04-01` API的版本信息，当前版本为 **2020\-04\-01**。 **EndpointId** String 必选 `示例值：ep-273yuq6q7bgn47fap8squ****` 终端节点的ID。您可以调用[DescribeVpcEndpoints](https://www.volcengine.com/docs/6980/155900)接口，获取终端节点的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时，不返回该参数。

## 请求示例 ```json GET /?Action=DescribeVpcEndpointZones&Version=2020-04-01&EndpointId=ep-273yuq6q7bgn47fap8squ**** HTTP/1.1 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 ``` ## 返回示例 ```json { "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "DescribeVpcEndpointZones", "Version": "2020-04-01", "Service": "privatelink", "Region": "cn-guangzhou" }, "Result": { "EndpointZones": [ { "ZoneId": "cn-guangzhou-a", "SubnetId": "subnet-2744ts087kglc7fap8tu6****", "ZoneDomain": "ep-273yuq6q7bgn47fap8squ****.cn-guangzhou-a.epsvc-273yuqembrojk7fap8sbf****.cn-guangzhou.privatelink.volces.com", "ZoneStatus": "Connected", "ServiceStatus": "Active", "Ipv6ServiceStatus": "Active", "NetworkInterfaceIP": "192.XX.XX.3", "NetworkInterfaceId": "eni-273w2q67fwq9s7fap8t1a****", "NetworkInterfaceIpv6": "2408::153:3921:XX:XX:7b12:1c5f", "ReplacedNetworkInterfaceId": "eni-273w2q67fwq9s7fap8t1a****", "ReplacedNetworkInterfaceIp": "192.XX.XX.4", "ReplacedNetworkInterfaceIpv6": "2408::153:3921:XX:XX:7b12:1acc" } ], "PageNumber": 1, "PageSize": 10, "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28D****", "TotalCount": 2 } } ``` ## 错误码此处仅展示当前API的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6980/155783)。 |状态码 |错误码 |错误信息 |说明 | |---|---|---|---| |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表示缺少的参数名称。

私网连接