ModifyTransitRouterMulticastDomain でトランジットルーターマルチキャストドメインを更新 - Cloud Enterprise Network (CEN) - Alibaba Cloud - Cloud Enterprise Network

マルチキャストドメインの名前、説明、および特徴オプションを変更します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cen:ModifyTransitRouterMulticastDomain

update

*TransitRouterMulticastDomain

acs:cen:*:{#accountId}:centransitroutermulticast/{#TransitRouterMulticastDomainId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。ClientToken パラメーターは ASCII 文字のみをサポートします。	123e4567-e89b-12d3-a456-4266****
TransitRouterMulticastDomainId	string	必須	マルチキャストドメインの ID。	tr-mcast-domain-40cwj0rgzgdtam****
TransitRouterMulticastDomainName	string	任意	マルチキャストドメインの新しい名前。名前は空、または 1～128 文字の長さに設定でき、http:// または https:// で始めることはできません。	nametest
TransitRouterMulticastDomainDescription	string	任意	マルチキャストドメインの新しい説明。説明は空、または 1～256 文字の長さに設定でき、http:// または https:// で始めることはできません。	desctest
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値: true: ドライランを実行します。システムは必須パラメーター、リクエスト構文、およびビジネス制限をチェックします。チェックに失敗した場合、対応するエラーが返されます。チェックに成功した場合、`DryRunOperation` エラーコードが返されます。 false (デフォルト): ドライランを実行し、リクエストを送信します。リクエストがドライランを通過した後、マルチキャストドメインの名前と説明が変更済みとなります。	false
Options	object	任意	マルチキャストドメインの特徴オプション。
Igmpv2Support	string	任意	マルチキャストドメインで IGMP 特徴を有効にするかどうかを指定します。この特徴を有効にすると、ホストはインターネットグループ管理プロトコル (IGMP) を使用してマルチキャストグループに動的に参加または脱退できます。有効な値: enable。説明 IGMP 特徴はパブリックプレビュー中です。この特徴を使用するには、アカウントマネージャーに連絡先を問い合わせてアクセスをリクエストしてください。 IGMP 特徴は、一度有効にすると無効にできません。	enable
StrictSourceControl	string	任意	Strict マルチキャストソースコントロール特徴を有効にするかどうかを指定します。この特徴が無効になっている場合、関連付けられた vSwitch 内のすべての ECS インスタンスをマルチキャストソースとして使用できます。この特徴が有効になっている場合、静的に構成されているか、IGMP Join メッセージを送信した ENI のみをマルチキャストソースとして使用できます。有効な値: `enable`: Strict マルチキャストソースコントロール特徴を有効にします。 `disable`: Strict マルチキャストソースコントロール特徴を無効にします。説明 Strict マルチキャストソースコントロール特徴は、IGMP 特徴が有効になっているマルチキャストドメインに対してのみ効果があります。トランジットルーター配下では、Strict マルチキャストソースコントロール特徴が無効になっているマルチキャストドメインを 1 つだけ作成できます。	enable

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
RequestId	string	リクエスト ID。	26273D23-5CB0-5EFC-AF5F-78A5448084C9

例

成功レスポンス

JSONJSON

{
  "RequestId": "26273D23-5CB0-5EFC-AF5F-78A5448084C9"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	Illegal.Name	Name is illegal.	名前が無効です。
400	Illegal.Description	Description is illegal.	説明が無効です。
400	InvalidMulticastDomainId.NotFound	The specified MulticastDomainId is not found.	パラメーターで指定された MulticastDomain が存在しません。
400	DryRunOperation	Request validation has been passed with DryRun flag set.	DryRun リクエストの検証が有効です。
400	IllegalParam.Igmpv2Support	The specified Igmpv2Support is illegal. Valid values are [enable, disable].	Igmpv2Support パラメーターが無効です。有効な値: enable、disable。
400	OperationUnsupported.Igmpv2Support	The current UID does not allow the creation of a igmpv2 multicast domain. Please submit a ticket.	現在の UID では IGMPv2 マルチキャストドメインを作成できません。この問題を解決するには、チケットを起票してください。
400	OperationUnsupported.NotAllowedDisableIgmpv2Support	The operation is not permitted because Igmpv2Support is not currently available to be disabled.	IGMPv2 の無効化はサポートされていません。
400	InvalidParameter	Invalid parameter.	パラメーターが無効です。
400	Unauthorized	The AccessKeyId is unauthorized.	この操作を実行するために必須の権限がアカウントにありません。
400	InvalidParameter.TransitRouterMulticastDomainId	The specified parameter TransitRouterMulticastDomainId is invalid.	TransitRouterMulticastDomainId パラメーターが無効です。

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。