All Products
Search
Document Center

Cloud Enterprise Network:ListTransitRouterAvailableResource

最終更新日:Oct 22, 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

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.

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.

SlaveZonestring

A list of secondary zone IDs.

You can call DescribeZones to query zones by ID.

cn-hangzhou-h
MasterZonesarray

A list of primary zones.

MasterZonestring

The ID of the primary zone.

cn-hangzhou-h
AvailableZonesarray

A list of zone IDs.

AvailableZonestring

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 UpdateView Change Details
2023-11-22The internal configuration of the API is changed, but the call is not affectedView Change Details
2023-03-09The response structure of the API has changedView Change Details
2022-08-25The response structure of the API has changedView Change Details