All Products
Search
Document Center

Cloud Enterprise Network:ListTransitRouterAvailableResource

Last Updated:Apr 03, 2024

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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringYes

The region ID of the Enterprise Edition transit router.

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

cn-hangzhou
SupportMulticastbooleanNo

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

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

B4F480E0-4E76-5E43-9966-8322C28A158A
SlaveZonesarray

A list of secondary zone IDs.

string

A list of secondary zone IDs.

You can call DescribeZones to query zones by ID.

cn-hangzhou-h
MasterZonesarray

A list of primary zones.

string

The ID of the primary zone.

cn-hangzhou-h
AvailableZonesarray

A list of zone IDs.

string

The zone ID.

cn-hangzhou-i
SupportMulticastboolean

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 codeError codeError messageDescription
400InvalidParameterInvalid parameter.The error message returned because the parameter is set to an invalid value.
400UnauthorizedThe 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 timeSummary of changesOperation
2024-02-22API Description Updatesee changesets
Change itemChange content
API DescriptionAPI Description Update.
2023-11-22The internal configuration of the API is changed, but the call is not affectedsee changesets
Change itemChange content
The internal configuration of the API is changed, but the call is not affected.
2023-03-09The response structure of the API has changedsee changesets
Change itemChange content
Output ParametersThe response structure of the API has changed.
2022-08-25The response structure of the API has changedsee changesets
Change itemChange content
Output ParametersThe response structure of the API has changed.