CreateTransitRouterMulticastDomain によるマルチキャストドメインの作成 - CEN - Alibaba Cloud - Cloud Enterprise Network

マルチキャストドメインを作成します。マルチキャストドメインは、リージョン内のマルチキャストネットワークの範囲を定義します。マルチキャストドメイン内のリソースのみがマルチキャストトラフィックを送受信できます。マルチキャストドメイン外のリソースは、マルチキャストトラフィックを送受信できません。

操作説明

開始する前に:

マルチキャストネットワークを構築するリージョンに Enterprise Edition トランジットルーターが作成されており、その Enterprise Edition トランジットルーターでマルチキャスト機能が有効になっていることを確認してください。詳細については、「 CreateTransitRouter 」をご参照ください。

マルチキャトリソースの申請前に Enterprise Edition トランジットルーターインスタンスを作成した場合、その Enterprise Edition トランジットルーターインスタンスはマルチキャスト機能をサポートしません。現在の Enterprise Edition トランジットルーターインスタンスを削除し、新しいインスタンスを作成できます。Enterprise Edition トランジットルーターインスタンスの削除方法については、「 DeleteTransitRouter 」をご参照ください。
CreateTransitRouterMulticastDomain 操作を呼び出す際、CenId および RegionId パラメーターを指定した場合は、TransitRouterId パラメーターを指定する必要はありません。TransitRouterId パラメーターを指定した場合は、CenId または RegionId パラメーターを指定する必要はありません。

今すぐお試しください

この 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:CreateTransitRouterMulticastDomain

create

TransitRouter

acs:cen:*:{#accountId}:centransitrouter/{#centransitrouterId}

*TransitRouterMulticastDomain

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを使用できます。	123e4567-e89b-12d3-a456-4266****
CenId	string	任意	Cloud Enterprise Network (CEN) インスタンスの ID。	cen-a7syd349kne38g****
TransitRouterId	string	任意	トランジットルーターのインスタンス ID。	tr-p0wr9p28r92d598y6****
RegionId	string	任意	トランジットルーターインスタンスのリージョン ID。 DescribeChildInstanceRegions 操作を呼び出して、リージョン ID を照会できます。	cn-hangzhou
TransitRouterMulticastDomainName	string	任意	マルチキャストドメインの名前。名前は空、または 1～128 文字の長さに設定でき、http:// または https:// で始めることはできません。	nametest
TransitRouterMulticastDomainDescription	string	任意	マルチキャストドメインの説明。説明は空、または 1～256 文字の長さに設定でき、http:// または https:// で始めることはできません。	desctest
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値: true: ドライランを実行します。システムは必須パラメーター、リクエスト構文、および制限事項をチェックします。リクエストがドライランに失敗した場合、エラーメッセージが返されます。リクエストがドライランに成功した場合、`DryRunOperation` エラーコードが返されます。 false (デフォルト): ドライランを実行し、リクエストを送信します。リクエストがドライランに成功した場合、マルチキャストドメインが作成されます。	false
Tag	array<object>	任意	タグ情報。一度に最大 20 個のタグを指定できます。
	object	任意
Key	string	任意	リソースのタグキー。このパラメーターを指定する場合、空の文字列にすることはできません。タグキーの長さは最大 64 文字で、`aliyun` または `acs:` で始めることはできません。また、`http://` または `https://` を含めることはできません。一度に最大 20 個のタグキーを指定できます。	TagKey
Value	string	任意	リソースのタグ値。このパラメーターを指定する場合、空にすることはできません。タグ値の長さは最大 128 文字で、aliyun または acs: で始めることはできません。また、http:// または https:// を含めることはできません。各タグキーは 1 つのタグ値に対応します。一度に最大 20 個のタグ値を指定できます。	TagValue
Options	object	任意	マルチキャストドメイン機能のオプション。
Igmpv2Support	string	任意	マルチキャストドメインに対してインターネットグループ管理プロトコル (IGMP) 機能を有効にするかどうかを指定します。この機能を有効にすると、ホストは IGMP プロトコルを使用してマルチキャストグループに動的に参加したり、グループから離脱したりできます。有効な値: enable: IGMP 機能を有効にします。 disable (デフォルト): IGMP 機能を無効にします。説明 IGMP 機能はパブリックプレビュー中です。この機能を使用するには、アカウントマネージャーに連絡して権限を申請してください。 IGMP 機能を有効にした後、無効にすることはできません。	enable
StrictSourceControl	string	任意	厳格なマルチキャストソースコントロール機能を有効にするかどうかを指定します。この機能が無効の場合、関連付けられた vSwitch 内のすべての ECS インスタンスをマルチキャストソースとして使用できます。この機能が有効の場合、静的に設定された ENI、または IGMP Join メッセージを送信した ENI のみをマルチキャストソースとして使用できます。有効な値: `enable`: 厳格なマルチキャストソースコントロール機能を有効にします。 `disable`: 厳格なマルチキャストソースコントロール機能を無効にします。説明厳格なマルチキャストソースコントロール機能は、IGMP 機能が有効になっているマルチキャストドメインに対してのみ効果があります。現在、1 つのトランジットルーター配下で作成できる、厳格なマルチキャストソースコントロール機能が無効になっているマルチキャストドメインは 1 つだけです。	enable

レスポンスフィールド

フィールド	型	説明	例
	object	応答パラメーター。
TransitRouterMulticastDomainId	string	マルチキャストドメインの ID。	tr-mcast-ドメイン-40cwj0rgzgdtam****
RequestId	string	リクエスト ID。	94E19C6F-206F-5223-9A63-64B85851BC04

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidTransitRouterId.NotFound	The specified TransitRouterId is not found.	リクエストに指定された TransitRouterId が存在しません。
400	IllegalParam.TransitRouterId	The specified TransitRouterId is illegal.	TransitRouterId または RegionId パラメーターが無効です。
400	IllegalParam.CenId	The specified CenId is illegal.	指定された cenId が無効です。
400	IllegalParam.RegionId	The specified RegionId is illegal.	リクエストで指定されたリージョンが無効です。
400	InvalidCenId.NotFound	The specified CenId is not found.	パラメーターで指定された CenId が存在しません。
400	InvalidOperation.TransitRouterNotExist	Operation is invalid because the transit router not exist.	トランジットルーターが存在しません。
400	InvalidOperation.CENInstanceStatus	The CEN instance is not in a valid state for the operation.
400	IncorrectStatus.TransitRouterInstance	The status of TransitRouter is incorrect.	トランジットルーターが無効な状態です。
400	OperationUnsupported.TransitRouterType	The specified TransitRouterType does not support the operation.	現在のトランジットルータータイプでは、この操作はサポートされていません。
400	OperationUnsupported.ServiceMode	The specified ServiceMode does not support the operation.	現在のトランジットルーターモードは、この操作をサポートしていません。
400	OperationUnsupported.TransitRouterSupportMulticast	The specified TransitRouterSupportMulticast does not support the operation.
400	OperationUnsupported.RegionId	The specified RegionId does not support the operation.	現在のリージョンではこの操作はサポートされていません。
400	IncorrectStatus.Cen	The status of Cen is incorrect.	現在の CEN インスタンスのステータスではこのポート操作を実行できません。後でもう一度お試しください。
400	IncorrectStatus.TransitRouter	The status of TransitRouter is incorrect.	トランジットルーターの現在のステータスでは、この操作はサポートされていません。後でもう一度お試しください。
400	DryRunOperation	Request validation has been passed with DryRun flag set.	DryRun リクエストの検証が有効です。
400	QuotaExceeded.MulticastDomain	The MulticastDomain quota is exceeded.	マルチキャストドメイン数が制限を超えたため、増やすことはできません。
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	InvalidParameter	Invalid parameter.	パラメーターが無効です。
400	Unauthorized	The AccessKeyId is unauthorized.	この操作を実行するために必須の権限がアカウントにありません。
400	InvalidParameter.TagValue	The specified parameter TagValue is invalid.	タグ値パラメーターが無効です。
400	InvalidParameter.CenId	The specified parameter CenId is invalid.
400	InvalidParameter.TransitRouterId	The specified parameter TransitRouterId is invalid.	TransitRouterId パラメーターが無効です。

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

変更履歴

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