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

调试

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

请求参数

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

要执行的操作,取值:ListVpcEndpointZones

EndpointId String ep-hp33b2e43fays7s8****

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

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

RegionId String eu-west-1

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

NextToken String caeba0bbb2be03f84eb48b699f0a4883

查询凭证(Token),取值为上一次API调用返回的NextToken参数值。如果没有下一个查询,请不传。

MaxResults Integer 50

分页大小,取值范围:1~50,默认为50

返回数据

名称 类型 示例值 描述
MaxResults String 50

分页大小。

NextToken String caeba0bbb2be03f84eb48b699f0a4883

下一个查询开始Token,NextToken为空说明没有下一个。

RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

Zones Array of Zone

可用区信息。

EniId String eni-hp3c8qj1tyct8aqy****

终端节点网卡。

EniIp String 192.xx.xx.23

终端节点网卡的IP地址。

RegionId String eu-west-1

终端节点所属的地域ID。

VSwitchId String vsw-hjkshjvdkdvd****

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

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

可用区域名。

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

ZoneId String eu-west-1a

可用区ID。

ZoneStatus String Wait

可用区状态:

  • Creating:创建中。
  • Wait:等待连接。
  • Connected:已连接。
  • Deleting:删除中。
  • Disconnecting:断开连接中。
  • Disconnected:已断开。
  • Connecting:连接中。

示例

请求示例

https://[Endpoint]/?Action=ListVpcEndpointZones
&EndpointId=ep-hp33b2e43fays7s8****
&RegionId=eu-west-1
&<公共请求参数>

正常返回示例

XML 格式

<ListVpcEndpointZonesResponse> 
      <RequestId>B40660B0-A67C-43B4-8C30-83BDBB541CFC</RequestId>
      <MaxResults>50</MaxResults>
      <Zones>
            <EniId>eni-hp3c8qj1tyct8aqy****</EniId>
            <ZoneId>cn-huhehaote-a</ZoneId>
            <VSwitchId>vsw-hp3rdstfpu35g24ey****</VSwitchId>
            <EniIp>192.xx.xx.58</EniIp>
            <ZoneStatus>Wait</ZoneStatus>
            <RegionId>cn-huhehaote</RegionId>
            <ZoneDomain>ep-hp3f033dp24c5yc9****-cn-huhehaote.epsrv-hp3itcpowf37m3d5****.cn-huhehaote-a.privatelink.aliyuncs.com</ZoneDomain>
      </Zones>
</ListVpcEndpointZonesResponse>

JSON 格式

{
  "RequestId": "B40660B0-A67C-43B4-8C30-83BDBB541CFC",
  "MaxResults": 50,
  "Zones": [
    {
      "EniId": "eni-hp3c8qj1tyct8aqy****",
      "ZoneId": "cn-huhehaote-a",
      "VSwitchId": "vsw-hp3rdstfpu35g24ey****",
      "EniIp": "192.xx.xx.58",
      "ZoneStatus": "Wait",
      "RegionId": "cn-huhehaote",
      "ZoneDomain": "ep-hp3f033dp24c5yc9****-cn-huhehaote.epsrv-hp3itcpowf37m3d5****.cn-huhehaote-a.privatelink.aliyuncs.com"
    }
  ]
}

错误码

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

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