调用ListTransitRouterAvailableResource接口查询指定地域下企业版转发路由器支持的可用区的信息。

使用说明

  • 您可以调用ListTransitRouterAvailableResource接口查询指定地域下企业版转发路由器支持的普通可用区的信息或者支持的组播功能的可用区的信息。
    • 如果您未指定SupportMulticast参数的值为true，则系统默认只查询企业版转发路由器支持的普通可用区的信息。
    • 如果您指定SupportMulticast参数的支持为true，则系统只查询企业版转发路由器支持的组播功能的可用区的信息。
  • 2022年05月31日云企业网对企业版转发路由器连接专有网络VPC（Virtual Private Cloud）的模式进行了优化升级，升级后的企业版转发路由器连接VPC实例时无需指定主备可用区，可任意指定一个或多个可用区。
    • 如果您的企业版转发路由器未经历过升级，在企业版转发路由器连接VPC实例时，您需要指定主备可用区。调用ListTransitRouterAvailableResource接口后可以通过MasterZones和SlaveZones参数获取主备可用区的信息。

    • 如果您的企业版转发路由器经历过升级，在企业版转发路由器连接VPC实例时，您可以指定任意的可用区。调用ListTransitRouterAvailableResource接口后可通过AvailableZones参数获取企业版转发路由器支持的可用区的信息。

      关于企业版转发路由器升级的信息，请参见企业版转发路由器连接VPC模式升级。

调试

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

请求参数

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

系统规定参数。取值：ListTransitRouterAvailableResource。

RegionId String 是 ap-southeast-2

企业版转发路由器所属的地域ID。

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

SupportMulticast Boolean 否 false

是否只查询支持组播功能的可用区的信息。

  • true：是。

    开启查询功能后，如果ListTransitRouterAvailableResource接口返回结果为空，则表示当前地域的企业版转发路由器不支持组播功能。

  • false（默认值）：否。

返回数据

名称 类型 示例值 描述
RequestId String B4F480E0-4E76-5E43-9966-8322C28A158A

请求ID。
SlaveZones Array of String ap-southeast-2a

备可用区ID列表。

您可以调用DescribeZones接口查询可用区ID对应的可用区的信息。

MasterZones Array of String ap-southeast-2b

主可用区ID列表。
AvailableZones Array of String ap-southeast-2a

可用区ID列表。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterAvailableResource
&RegionId=ap-southeast-2
&SupportMulticast=false
&公共请求参数

正常返回示例

XML格式 

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

<ListTransitRouterAvailableResourceResponse>
    <SlaveZones>ap-southeast-2b</SlaveZones>
    <SlaveZones>ap-southeast-2a</SlaveZones>
    <RequestId>B4F480E0-4E76-5E43-9966-8322C28A158A</RequestId>
    <MasterZones>ap-southeast-2b</MasterZones>
    <AvailableZones>ap-southeast-2b</AvailableZones>
    <AvailableZones>ap-southeast-2a</AvailableZones>
</ListTransitRouterAvailableResourceResponse>

JSON格式 

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

{
  "SlaveZones" : [ "ap-southeast-2b", "ap-southeast-2a" ],
  "RequestId" : "B4F480E0-4E76-5E43-9966-8322C28A158A",
  "MasterZones" : [ "ap-southeast-2b" ],
  "AvailableZones" : [ "ap-southeast-2b", "ap-southeast-2a" ]
}

错误码

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