Use ListTransitRouterAvailableResource to query available zones for Enterprise Edition transit routers - Cloud Enterprise Network - Alibaba Cloud - Cloud Enterprise Network

Operation description

You can invoke ListTransitRouterAvailableResource to query information about regular zones or zones that support the multicast feature for Enterprise Edition transit routers in a specified region.
- If you do not set SupportMulticast to true, the system queries only the regular zones supported by Enterprise Edition transit routers by default.
- If you set SupportMulticast to true, the system queries only the zones that support the multicast feature for Enterprise Edition transit routers.
On May 31, 2022, Cloud Enterprise Network (CEN) performed an optimization upgrade on the mode in which Enterprise Edition transit routers connect to virtual private clouds (VPCs). After the upgrade, you no longer need to specify primary and secondary zones when connecting an Enterprise Edition transit router to a VPC-connected instance. You can specify one or more zones.
- If your Enterprise Edition transit router has not been upgraded, you must specify primary and secondary zones when connecting the Enterprise Edition transit router to a VPC-connected instance. After you invoke ListTransitRouterAvailableResource, you can obtain the primary and secondary zone information from the MasterZones and SlaveZones parameters.
- If your Enterprise Edition transit router has been upgraded, you can specify any zones when connecting the Enterprise Edition transit router to a VPC-connected instance. After you invoke ListTransitRouterAvailableResource, you can obtain the zone information supported by the Enterprise Edition transit router from the AvailableZones parameter.

For more information about the Enterprise Edition transit router upgrade, see Upgrade the mode in which an Enterprise Edition transit router connects to a VPC.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID of the Enterprise Edition transit router. You can call DescribeChildInstanceRegions to query region IDs.	cn-hangzhou
SupportMulticast	boolean	No	Specifies whether to query only the multicast-enabled zones. true: queries only the multicast-enabled zones. If the ListTransitRouterAvailableResource operation returns an empty result, the Enterprise Edition transit router in the current region does not support multicast. false (default): does not query only the multicast-enabled zones.	false

Response elements

Element	Type	Description	Example
	object	The response parameters.
RequestId	string	The request ID.	B4F480E0-4E76-5E43-9966-8322C28A158A
SlaveZones	array	The list of secondary zone IDs.
	string	The list of secondary zone IDs. You can call DescribeZones to query the information about zones that correspond to zone IDs.	cn-hangzhou
MasterZones	array	The list of primary zone IDs.
	string	The primary zone ID.	cn-hangzhou-h
AvailableZones	array	The list of zone IDs.
	string	The zone ID.	cn-hangzhou-i
SupportMulticast	boolean	Indicates whether the zone information is for multicast-enabled zones.	false

Examples

Success response

JSON format

{
  "RequestId": "B4F480E0-4E76-5E43-9966-8322C28A158A",
  "SlaveZones": [
    "cn-hangzhou"
  ],
  "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.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.