すべてのプロダクト
Search

このプロダクト

    :CreateTransitRouterMulticastDomain

    ドキュメントセンター

    :CreateTransitRouterMulticastDomain

    最終更新日:Apr 03, 2024

    マルチキャストドメインを作成します。

    使用上の注意

    • オーストラリア (シドニー) および英国 (ロンドン) リージョンのEnterprise Editionトランジットルーターのみがマルチキャスト機能をサポートしています。 マルチキャストはデフォルトで無効になっています。 マルチキャストを有効にする場合は、セールスマネージャーに連絡してマルチキャストリソースを申請してください。

    • Enterprise Editionトランジットルーターでマルチキャストドメインを作成する前に、トランジットルーターのマルチキャストが有効になっていることを確認してください。 詳細については、「CreateTransitRouter」をご参照ください。

    デバッグ

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

    リクエストパラメーター

    パラメーター

    データ型

    必須／任意

    例

    説明

    操作

    String

    必須

    CreateTransitRouterMulticastDomain

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

    ClientToken

    String

    任意

    123e4567-e89b-12d3-a456-4266 ****

    リクエストのべき等性を保証するために使用されるクライアントトークン。

    クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。

    CenId

    String

    任意

    cen-a7syd349kne38g ****

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

    TransitRouterId

    String

    任意

    tr-p0wr9p28r92d598y6 ****

    トランジットルーターのID。

    RegionId

    String

    任意

    cn-hangzhou

    トランジットルーターがデプロイされているリージョンのID。

    DescribeChildInstanceRegionsを呼び出して、最新のリージョンリストを照会できます。

    TransitRouterMulticastDomainName

    String

    任意

    nametest

    マルチキャストドメインの名前。

    名前は0〜128文字で、文字、数字、カンマ（,）、ピリオド（...）、セミコロン（;）、スラッシュ（/）、アットマーク（@）、アンダースコア（_）、ハイフン（-）を使用することが可能です。

    TransitRouterMulticastDomainDescription

    String

    任意

    desktest

    マルチキャストドメインの説明。

    説明は0 ~ 256文字で、英数字、コンマ (,) 、ピリオド (.) 、セミコロン (;) 、スラッシュ (/) 、記号 (@) 、アンダースコア (_) 、ハイフン (-) を使用できます。

    DryRun

    Boolean

    任意

    false

    リクエストのみを事前チェックするかどうかを指定します。 設定可能な値は以下のとおりです。

    • true:要求をチェックするが、マルチキャストドメインを作成しない。システムは、必要なパラメーター、リクエスト形式、およびサービス制限をチェックします。 リクエストが事前チェックに失敗した場合、エラーメッセージが返されます。 リクエストが事前チェックに合格した場合、DryRunOperationエラーコードが返されます。

    • false (default): リクエストを送信します。 リクエストが事前チェックに合格すると、マルチキャストドメインが作成されます。

    レスポンスパラメーター

    パラメーター

    データ型

    例

    説明

    TransitRouterMulticastDomainId

    String

    94E19C6F-206F-5223-9A63-64B85851BC04

    リクエストの ID です。

    RequestId

    String

    tr-mcast-domain-40cwj0rgzgdtam ****

    マルチキャストドメインのID。

    例

    リクエストの例

    http(s)://[Endpoint]/?Action=CreateTransitRouterMulticastDomain
&ClientToken=123e4567-e89b-12d3-a456-4266****
&CenId=cen-a7syd349kne38g****
&TransitRouterId=tr-p0wr9p28r92d598y6****
&RegionId=cn-hangzhou
&TransitRouterMulticastDomainName=nametest
&TransitRouterMulticastDomainDescription=desctest
&DryRun=false
&<Common request parameters>

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

    XML 形式

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

<CreateTransitRouterMulticastDomainResponse>
    <RequestId>94E19C6F-206F-5223-9A63-64B85851BC04</RequestId>
    <TransitRouterMulticastDomainId>tr-mcast-domain-40cwj0rgzgdtam ****</TransitRouterMulticastDomainId>
</CreateTransitRouterMulticastDomainResponse>

    JSON 形式

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

{
  "RequestId" : "94E19C6F-206F-5223-9A63-64B85851BC04" 、
  "TransitRouterMulticastDomainId" : "tr-mcast-domain-40cwj0rgzgdtam ****"
}

    エラーコード

    HttpCode

    エラーコード

    エラーメッセージ

    説明

    400

    IncorrectStatus.TransitRouterInstance

    TransitRouterのステータスが正しくありません。

    トランジットルーターが無効な状態の場合に返されるエラーメッセージ。

    400

    DryRunOperation

    要求検証は、DryRunフラグを設定して渡されました。

    ドライ実行要求が事前チェックに合格した場合に返されるエラーメッセージ。

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