マルチキャストソースを削除します。
使用上の注意
DeregisterTransitRouterMulticastGroupSources
は非同期操作です。 リクエストを送信すると、リクエストIDが返されますが、操作はシステムバックグラウンドで実行中です。 ListTransitRouterMulticastGroups
を呼び出して、マルチキャストソースのステータスを照会できます。
- マルチキャストソースが登録解除状態の場合、マルチキャストソースは削除中です。 マルチキャストソースを照会できますが、他の操作は実行できません。
- マルチキャストソースが見つからない場合、マルチキャストソースは削除される。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | DeregisterTransitRouterMulticastGroupSources |
実行する操作です。 値をDeregisterTransitRouterMulticastGroupSourcesに設定します。 |
ClientToken | String | 任意 | 123e4567-e89b-12d3-a456-4266 **** |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 ClientTokenにはASCII文字のみを含めることができます。 |
TransitRouterMulticastDomainId | String | 必須 | tr-mcast-domain-91wpg6wbhchjeq **** |
マルチキャストソースが属するマルチキャストグループのID。 |
GroupIpAddress | String | 必須 | 239.XX.XX.2 |
マルチキャストソースが属するマルチキャストグループのIPアドレス。 |
NetworkInterfaceIds.N | String | 任意 | eni-p0weuda3lszwzjly **** |
マルチキャストソースのID。 1つのマルチキャストグループに作成できるマルチキャストソースは1つだけです。 説明 このパラメーターは必須です。
|
DryRun | Boolean | いいえ | false |
リクエストのみをチェックするかどうかを指定します。 有効な値:
|
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
RequestId | String | 53E7E8BE-7F4E-5458-ACCA-9B5C1D6A642D |
リクエストの ID です。 |
例
リクエストの例
http(s)://[Endpoint]/?Action=DeregisterTransitRouterMulticastGroupSources
&ClientToken=123e4567-e89b-12d3-a456-4266 ****
&TransitRouterMulticastDomainId=tr-mcast-domain-91wpg6wbhchjeq ****
&GroupIpAddress=239.XX. XX.2
&NetworkInterfaceIds=["eni-p0weuda3lszwzjly ****"]
&DryRun=false
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<DeregisterTransitRouterMulticastGroupSourcesResponse>
<RequestId>53E7E8BE-7F4E-5458-ACCA-9B5C1D6A642D</RequestId>
</DeregisterTransitRouterMulticastGroupSourcesResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "53E7E8BE-7F4E-5458-ACCA-9B5C1D6A642D"
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | DryRunOperation | 要求検証は、DryRunフラグを設定して渡されました。 | ドライ実行要求が事前チェックに合格した場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。