调用ListVpcEndpointZones接口查询终端节点的可用区列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListVpcEndpointZones

系统规定参数。取值:ListVpcEndpointZones

RegionId String cn-huhehaote

要查询的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。
MaxResults Integer 50

分批次查询时每次显示的条目数。取值范围:1~50,默认值:50

EndpointId String ep-hp33b2e43fays7s8****

要查询可用区的终端节点ID。

指定终端节点ID后,系统会查询该终端节点的可用区。

返回数据

名称 类型 示例值 描述
NextToken String caeba0bbb2be03f84eb48b699f0a4883

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

MaxResults Integer 50

分批次查询时每次显示的条目数。

Zones Array of Zone

可用区信息。

VSwitchId String vsw-hjkshjvdkdvd****

可用区中的交换机,系统会自动在该交换机下创建一个终端节点网卡。

EniIp String 192.168.2.23

终端节点网卡的IP地址。

ZoneStatus String Wait

可用区状态,取值:

  • Creating:创建中。
  • Wait:等待连接。
  • Connected:已连接。
  • Deleting:删除中。
  • Disconnecting:断开连接中。
  • Disconnected:已断开。
  • Connecting:连接中。
ZoneId String cn-huhehaote-a

可用区ID。

ServiceStatus String Active

终端节点服务的状态,取值:

  • Creating:创建中。
  • Pending:修改中。
  • Active:可用。
  • Deleting:删除中。
EniId String eni-hp3c8qj1tyct8aqy****

终端节点网卡ID。

ZoneDomain String ep-hp3f033dp24c5yc9****-cn-huhehaote.epsrv-hp3itcpowf37m3d5****.cn-huhehaote-a.privatelink.aliyuncs.com

可用区域名。

终端节点连接建立成功后,可以通过该可用区域名访问终端节点服务中的服务资源。

RegionId String cn-huhehaote

终端节点所属的地域ID。

ZoneIpv6Address String false

终端节点是否支持IPv6功能。取值:

  • true:是。
  • false(默认值):否。

示例

请求示例

http(s)://[Endpoint]/?Action=ListVpcEndpointZones
&RegionId=cn-huhehaote
&NextToken=caeba0bbb2be03f84eb48b699f0a4883
&MaxResults=50
&EndpointId=ep-hp33b2e43fays7s8****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListVpcEndpointZonesResponse>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <MaxResults>50</MaxResults>
    <Zones>
        <VSwitchId>vsw-hjkshjvdkdvd****</VSwitchId>
        <EniIp>192.168.2.23</EniIp>
        <ZoneStatus>Wait</ZoneStatus>
        <ZoneId>cn-huhehaote-a</ZoneId>
        <ServiceStatus>Active</ServiceStatus>
        <EniId>eni-hp3c8qj1tyct8aqy****</EniId>
        <ZoneDomain>ep-hp3f033dp24c5yc9****-cn-huhehaote.epsrv-hp3itcpowf37m3d5****.cn-huhehaote-a.privatelink.aliyuncs.com</ZoneDomain>
        <RegionId>cn-huhehaote</RegionId>
        <ZoneIpv6Address>false</ZoneIpv6Address>
    </Zones>
</ListVpcEndpointZonesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "MaxResults" : 50,
  "Zones" : [ {
    "VSwitchId" : "vsw-hjkshjvdkdvd****",
    "EniIp" : "192.168.2.23",
    "ZoneStatus" : "Wait",
    "ZoneId" : "cn-huhehaote-a",
    "ServiceStatus" : "Active",
    "EniId" : "eni-hp3c8qj1tyct8aqy****",
    "ZoneDomain" : "ep-hp3f033dp24c5yc9****-cn-huhehaote.epsrv-hp3itcpowf37m3d5****.cn-huhehaote-a.privatelink.aliyuncs.com",
    "RegionId" : "cn-huhehaote",
    "ZoneIpv6Address" : "false"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 EndpointNotFound The specified Endpoint does not exist. 当前终端节点未找到。

访问错误中心查看更多错误码。