RegisterTransitRouterMulticastGroupSources - - Alibaba Cloud ドキュメントセンター

使用上の注意

マルチキャストソースとしてelastic network Interface (ENI) のみを指定できます。
RegisterTransitRouterMulticastGroupSourcesは非同期操作です。リクエストを送信すると、リクエストIDが返されますが、操作はシステムバックグラウンドで実行中です。 ListTransitRouterMulticastGroupsを呼び出して、マルチキャストソースのステータスを照会できます。
- マルチキャストソースが [登録] 状態の場合、マルチキャストソースは作成中です。マルチキャストソースを照会できますが、他の操作は実行できません。
- マルチキャストソースが [登録済み] 状態の場合、マルチキャストソースが作成されます。

前提条件

RegisterTransitRouterMulticastGroupSourcesを呼び出す前に、ENIが作成されたvSwitchがマルチキャストドメインに関連付けられていることを確認してください。詳細については、「AssociateTransitRouterMulticastDomain」をご参照ください。

デバッグ

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

リクエストパラメーター


項目	データ型	必須／任意	例:	説明
操作	String	必須	RegisterTransitRouterMulticastGroupSources	実行する操作です。値をRegisterTransitRouterMulticastGroupSourcesに設定します。
ClientToken	String	任意	123e4567-e89b-12d3-a456-4266 ****	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。説明このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。各APIリクエストのRequestIdの値は異なる場合があります。
TransitRouterMulticastDomainId	String	必須	tr-mcast-domain-5mjb5gjb6dgu98 ****	マルチキャストソースが属するマルチキャストグループのID。
GroupIpAddress	String	必須	239.XX.XX.2	マルチキャストソースが属するマルチキャストグループのIPアドレス。有効な値: 224.0.0.1〜239.255.255.254。マルチキャストグループがマルチキャストドメインに存在しない場合、システムは自動的にマルチキャストドメインにマルチキャストグループを作成します。
NetworkInterfaceIds.N	String	任意	eni-p0w92o2wupc3c05t ****	ENI の ID。 1つのマルチキャストグループに作成できるマルチキャストソースは1つだけです。説明このパラメーターは必須です。
DryRun	Boolean	いいえ	false	リクエストのみをチェックするかどうかを指定します。有効な値： true: リクエストを事前にチェックしますが、マルチキャストソースは作成しません。システムは、必要なパラメーター、リクエスト形式、およびサービス制限をチェックします。リクエストが事前チェックに合格しなかった場合、エラーメッセージが返されます。リクエストが事前チェックに合格した場合、`DryRunOperation`エラーコードが返されます。 false (デフォルト): リクエストを送信します。リクエストが事前チェックを通過した後、マルチキャストソースが作成されます。
VpcId	String	任意	vpc-wz9fusm6zq8uy7cfa ****	ENIが属するVPCのID。 ENIが現在のAlibaba Cloudアカウントに属している場合、このパラメーターは無視してください。 ENIが別のAlibaba Cloudアカウントに属している場合、このパラメーターを設定する必要があります。

レスポンスパラメーター


項目	データ型	例:	説明
RequestId	String	9C5D5D70-0AFF-5E5C-8D8A-E92C90C8FB08	リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=RegisterTransitRouterMulticastGroupSources
&ClientToken=123e4567-e89b-12d3-a456-4266 ****
&TransitRouterMulticastDomainId=tr-mcast-domain-5mjb5gjb6dgu98 ****
&GroupIpAddress=239.XX. XX.2
&NetworkInterfaceIds=["eni-p0w92o2wupc3c05t ****"]
&DryRun=false
&VpcId=vpc-wz9fusm6zq8uy7cfa ****
&<共通リクエストパラメーター>

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

XML 形式

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

<RegisterTransitRouterMulticastGroupSourcesResponse>
    <RequestId>9C5D5D70-0AFF-5E5C-8D8A-E92C90C8FB08</RequestId>
</RegisterTransitRouterMulticastGroupSourcesResponse>

JSON 形式

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

{
  "RequestId" : "9C5D5D70-0AFF-5E5C-8D8A-E92C90C8FB08"
}

エラーコード


HttpCode	エラーコード	エラーメッセージ	説明
400	DryRunOperation	要求検証は、DryRunフラグを設定して渡されました。	ドライ実行要求が事前チェックに合格した場合に返されるエラーメッセージ。

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