ListTransitRouterAvailableResource - Cloud Enterprise Network

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

Operation description

You can call the ListTransitRouterAvailableResource operation 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

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID of the Enterprise Edition transit router. You can call the DescribeChildInstanceRegions operation to query the most recent region list.	cn-hangzhou
SupportMulticast	boolean	No	Specifies whether to query only the zones in which the multicast feature is supported. Valid values: true 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)	false

Response parameters

Parameter	Type	Description	Example
	object	The response parameters.
RequestId	string	The request ID.	B4F480E0-4E76-5E43-9966-8322C28A158A
SlaveZones	array	A list of secondary zone IDs.
SlaveZone	string	A list of secondary zone IDs. You can call DescribeZones to query zones by ID.	cn-hangzhou-h
MasterZones	array	A list of primary zones.
MasterZone	string	The ID of the primary zone.	cn-hangzhou-h
AvailableZones	array	A list of zone IDs.
AvailableZone	string	The zone ID.	cn-hangzhou-i
SupportMulticast	boolean	Indicates whether the zone supports the multicast feature.	false

Examples

Sample success responses

JSONformat

{
  "RequestId": "B4F480E0-4E76-5E43-9966-8322C28A158A",
  "SlaveZones": [
    "cn-hangzhou-h"
  ],
  "MasterZones": [
    "cn-hangzhou-h"
  ],
  "AvailableZones": [
    "cn-hangzhou-i"
  ],
  "SupportMulticast": false
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter	Invalid parameter.	The error message returned because the parameter is set to an invalid value.
400	Unauthorized	The AccessKeyId is unauthorized.	The error message returned because you do not have the permissions to perform this operation.

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2024-02-22	API Description Update	View Change Details
2023-11-22	The internal configuration of the API is changed, but the call is not affected	View Change Details
2023-03-09	The response structure of the API has changed	View Change Details
2022-08-25	The response structure of the API has changed	View Change Details