Queries the zones that support Enterprise Edition transit routers in a specified region.

Usage notes

  • You can call ListTransitRouterAvailableResource to query the zones that support Enterprise Edition transit routers in a specified region.
    • If you do not set SupportMulticast to true, general-purpose zones that support Enterprise Edition transit routers are queried.
    • If you set SupportMulticast to true, zones in which Enterprise Edition transit routers support multicast are queried.
  • On May 31, 2022, VPC-connected Enterprise Edition transit routers were optimized. Optimized Enterprise Edition transit routers do not require you to specify the primary and secondary zones when you connect VPCs to the Enterprise Edition transit routers. You can specify one or more zones.
    • If your Enterprise Edition transit router has not been optimized, you must specify the primary and secondary zones when you connect a VPC to your Enterprise Edition transit router. After you call ListTransitRouterAvailableResource, you can call MasterZones and SlaveZones to query the primary and secondary zones.

    • If your Enterprise Edition transit router has been optimized, you can specify a zone as needed when you connect a VPC to your Enterprise Edition transit router. After you call ListTransitRouterAvailableResource, you can call AvailableZones to query the zones.

      For more information about the optimization, see Announcement: Optimization on VPC-connected Enterprise Edition transit routers.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ListTransitRouterAvailableResource

The operation that you want to perform. Set the value to ListTransitRouterAvailableResource.

RegionId String Yes ap-southeast-2

The ID of the region where the Enterprise Edition transit router is deployed.

You can call the DescribeChildInstanceRegions operation to query the most recent region list.

SupportMulticast Boolean No false

Specifies whether to query only the zones in which the multicast feature is supported. Valid values:

  • true: yes

    After you call ListTransitRouterAvailableResource, if no zone is returned, it indicates that the Enterprise Edition transit router does not support the multicast feature.

  • false (default): no

Response parameters

Parameter Type Example Description
RequestId String B4F480E0-4E76-5E43-9966-8322C28A158A

The ID of the request.

SlaveZones Array of String ap-southeast-2a

A list of zone IDs.

You can call DescribeZones to query zones by ID.

MasterZones Array of String ap-southeast-2b

A list of primary zones.

AvailableZones Array of String ap-southeast-2a

A list of zones.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListTransitRouterAvailableResource
&RegionId=ap-southeast-2
&SupportMulticast=false
&<Common request parameters>

Sample success responses

XML format 

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 format 

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" ]
}

Error codes

For a list of error codes, visit the Error Center.