仮想プライベートクラウド (VPC) のマルチキャストドメインに関連付けられているvSwitchを照会します。

使用上の注意

Enterprise Editionトランジットルーターに接続されているVPCでのみvSwitchをクエリできます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 ListTransitRouterMulticastDomainVSwitches

実行する操作です。 値をListTransitRouterMulticastDomainVSwitchesに設定します。

CenId String 必須 cen-44m0p68spvlrqq ****

Cloud Enterprise Network (CEN) インスタンスのID。

VpcId String 必須 vpc-p0wr1cd4fcuxy3ui0 ****

VPCのID。

VSwitchIds.N String 任意 vsw-p0w5ejr9bzfsttiza ****

vSwitchのID。

各呼び出しで最大50個のvSwitch IDを指定できます。

MaxResults Integer 任意 20

1ページあたりに返されるエントリの数。 最小値: 0。 デフォルト値: 20

NextToken String 任意 FFmyTO70tTpLG6I3FmYAXGKPd ****

クエリの開始点を決定するトークン。 設定可能な値は以下のとおりです。

  • これが最初のクエリである場合、または後続のクエリを送信しない場合は、このパラメーターを無視します。
  • 後続のクエリを送信する場合は、前回の呼び出しから返されたNextTokenの値に値を設定します。

レスポンスパラメーター

パラメーター データ型 例 説明
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd ****

クエリの開始点を決定するトークン。 設定可能な値は以下のとおりです。

  • NextTokenが返されなかった場合は、追加の結果が存在しないことを示します。
  • 前のクエリでNextTokenが返された場合は、値を指定して次の結果セットを取得します。
RequestId String B0E7E43C-979A-5130-AA0D-B3ADA69E0827

リクエストの ID です。

TotalCount Integer 2

返されたエントリの数。

MaxResults Integer 20

1 ページあたりで返されるエントリ数。

VSwitchIds 文字列の配列 vsw-p0w5ejr9bzfsttiza ****

VSwitch の ID です。

例

リクエストの例

http(s)://[Endpoint]/? アクション=ListTransitRouterMulticastDomainVSwitches
&CenId=cen-44m0p68spvlrqq ****
&VpcId=vpc-p0wr1cd4fcuxy3ui0 ****
&VSwitchIds=["vsw-p0w5ejr9bzfsttiza ****"]
&MaxResults=20
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd ****
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式 

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 形式 

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

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

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 IllegalParam.NextToken 指定されたNextTokenは無効です。 NextTokenの値が無効な場合に返されるエラーメッセージ。
400 IllegalParam.TrInstance 指定されたTransitRouterは無効です。 トランジットルーターのIDが無効な場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。