Queries vSwitches that are associated with multicast domains in a virtual private cloud (VPC).

Usage notes

You can query vSwitches only in VPCs that are connected to 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 ListTransitRouterMulticastDomainVSwitches

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

CenId String Yes cen-44m0p68spvlrqq****

The ID of the Cloud Enterprise Network (CEN) instance.

VpcId String Yes vpc-p0wr1cd4fcuxy3ui0****

The ID of the VPC.

VSwitchIds.N String No vsw-p0w5ejr9bzfsttiza****

The IDs of the vSwitches.

You can specify at most 50 vSwitch IDs in each call.

MaxResults Integer No 20

The number of entries to return per page. Minimum value: 0. Default value: 20.

NextToken String No FFmyTO70tTpLG6I3FmYAXGKPd****

The token that determines the start point of the query. Valid values:

  • If this is your first query or no subsequent query is to be sent, ignore this parameter.
  • If a subsequent query is to be sent, set the value to the value of NextToken that was returned from the last call.

Response parameters

Parameter Type Example Description
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

The token that determines the start point of the query. Valid values:

  • If NextToken was not returned, it indicates that no additional results exist.
  • If NextToken was returned in the previous query, specify the value to obtain the next set of results.
RequestId String B0E7E43C-979A-5130-AA0D-B3ADA69E0827

The ID of the request.

TotalCount Integer 2

The number of entries returned.

MaxResults Integer 20

The number of entries returned per page.

VSwitchIds Array of String vsw-p0w5ejr9bzfsttiza****

The ID of the vSwitch.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ListTransitRouterMulticastDomainVSwitches
&CenId=cen-44m0p68spvlrqq****
&VpcId=vpc-p0wr1cd4fcuxy3ui0****
&VSwitchIds=["vsw-p0w5ejr9bzfsttiza****"]
&MaxResults=20
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTransitRouterMulticastDomainVSwitchesResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>B0E7E43C-979A-5130-AA0D-B3ADA69E0827</RequestId>
    <TotalCount>2</TotalCount>
    <MaxResults>20</MaxResults>
    <VSwitchIds>vsw-p0w5ejr9bzfsttiza****</VSwitchIds>
</ListTransitRouterMulticastDomainVSwitchesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId" : "B0E7E43C-979A-5130-AA0D-B3ADA69E0827",
  "TotalCount" : 2,
  "MaxResults" : 20,
  "VSwitchIds" : [ "vsw-p0w5ejr9bzfsttiza****" ]
}

Error codes

HTTP status code Error code Error message Description
400 IllegalParam.NextToken The specified NextToken is invalid. The error message returned because the value of NextToken is invalid.
400 IllegalParam.TrInstance The specified TransitRouter is invalid. The error message returned because the ID of the transit router is invalid.

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