:RegisterTransitRouterMulticastGroupMembers

使用上の注意

Enterprise Editionトランジットルーターを使用すると、エラスティックネットワークインターフェイス (ENI) をマルチキャストメンバーとして指定できます。 RegisterTransitRouterMulticastGroupMembersを呼び出して、同じリージョンまたは異なるリージョンのENIをマルチキャストメンバーとしてマルチキャストグループに追加できます。

• NetworkInterfaceIdsを設定した場合、現在のリージョンのENIがマルチキャストメンバーとして指定されます。 ENIのvSwitchがマルチキャストドメインに関連付けられていることを確認します。 詳細については、「AssociateTransitRouterMulticastDomain」をご参照ください。

• PeerTransitRouterMulticastDomainsを設定した場合、現在のマルチキャストグループと同じIPアドレスを持つマルチキャストグループ内のマルチキャストメンバーが現在のマルチキャストグループに追加されます。 リージョン間接続が作成されていることを確認します。 詳細については、「CreateTransitRouterPeerAttachment」をご参照ください。

  たとえば、Aliceは、オーストラリア (シドニー) 地域にマルチキャストドメイン (ドメインa) を作成し、英国 (ロンドン) 地域にマルチキャストドメイン (ドメインB) を作成しました。 ドメインAはマルチキャストグループ (グループa) を含み、ドメインBはマルチキャストグループ (グループB) を含む。 グループAおよびグループBは、同じマルチキャストIPアドレスを有する。 英国 (ロンドン) のグループBは、マルチキャストメンバー (メンバーB) を含む。 アリスがRegisterTransitRouterMulticastGroupMembersを呼び出してマルチキャストメンバーをオーストラリア (シドニー) のグループAに追加したときに、アリスがPeerTransitRouterMulticastDomainsを英国 (ロンドン) のドメインBのIDに設定した場合、メンバーBはオーストラリア (シドニー) のグループAに追加されます。

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

リクエストパラメーター

レスポンスパラメーター

例

リクエストの例

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

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

XML 形式

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

<RegisterTransitRouterMulticastGroupMembersResponse>
    <RequestId>EB985B7E-2CF8-5EC9-A7DB-F7C82ABD3ACE</RequestId>
</RegisterTransitRouterMulticastGroupMembersResponse>

JSON 形式

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

{
  "RequestId" : "EB985B7E-2CF8-5EC9-A7DB-F7C82ABD3ACE"
}

エラーコード

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