使用RegisterTransitRouterMulticastGroupSources建立組播源-雲企業網-阿里雲

為了實現一對多的組播通訊，調用RegisterTransitRouterMulticastGroupSources介面建立組播源。

介面說明

當前僅支援將彈性網卡 ENI（Elastic Network Interface）指定為組播源。
RegisterTransitRouterMulticastGroupSources介面屬於非同步介面，即系統會先返回一個 RequestId，但組播源未完全建立成功，系統背景建立任務仍在進行。您可以調用ListTransitRouterMulticastGroups介面查詢組播源的狀態。
- 當組播源處於 Registering 狀態時，表示組播源正在被建立，在該狀態下，您只能對組播源執行查詢操作，不能執行其他動作。
- 當組播源處於 Registered 狀態時，表示組播源已被成功建立。

前提條件

在調用RegisterTransitRouterMulticastGroupSources介面建立組播源前，請確保彈性網卡所在的交換器已被關聯至組播域。具體操作，請參見 AssociateTransitRouterMulticastDomain 。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cen:RegisterTransitRouterMulticastGroupSources

create

*TransitRouterMulticastDomain

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

無

請求參數

名稱	類型	必填	描述	樣本值
ClientToken	string	否	用戶端 Token，用於保證請求的等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。說明若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。	123e4567-e89b-12d3-a456-4266****
TransitRouterMulticastDomainId	string	是	組播源所屬的組播域 ID。	tr-mcast-domain-5mjb5gjb6dgu98****
GroupIpAddress	string	是	組播源所屬的組播組的 IP 位址。取值範圍：224.0.1.0~239.255.255.254。重要 224.0.0.0～224.0.0.127 為系統保留地址，不支援作為組播組 IP 位址。如果當前組播域下不存在您指定的組播組，系統將自動為您建立新的組播組。	239.XX.XX.2
NetworkInterfaceIds	array	否	彈性網卡 ID 列表。
	string	否	彈性網卡 ID。（即組播源）當前一個組播組最多一次支援建立五個組播源。說明當前本參數為必填參數。	eni-p0w92o2wupc3c05t****
DryRun	boolean	否	是否只預檢此次請求。取值： true：發送檢查請求，不會建立組播源。檢查項包括是否填寫了必需參數、請求格式、業務限制等。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼`DryRunOperation`。 false（預設值）：發送正常請求，通過檢查後直接建立組播源。	false
VpcId	string	否	彈性網卡所屬的 VPC 執行個體 ID。如果彈性網卡所屬阿里雲帳號和您當前登入的阿里雲帳號為相同帳號，本參數可不填。如果彈性網卡所屬阿里雲帳號和您當前登入的阿里雲帳號為不同帳號，本參數必填。	vpc-wz9fusm6zq8uy7cfa****

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	9C5D5D70-0AFF-5E5C-8D8A-E92C90C8FB08

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidOperation.PeerMulticastDomainSource	Operation is invalid because peer multicast domain can not be group source.	另一個地區的組播域不能作為組播源。
400	IllegalParam.GroupIpAddress	The specified GroupIpAddress is illegal.	參數中指定的GroupIpAddress不合法。
400	InvalidMulticastDomainId.NotFound	The specified AttachmentId is not found.	參數中指定的MulticastDomain不存在。
400	IncorrectStatus.MulticastDomainId	The status of MulticastDomainId is incorrect.	當前MulticastDomain的狀態不支援該操作，請稍後重試。
400	IncorrectStatus.Cen	The status of Cen is incorrect.	當前Cen的狀態不支援該操作，請稍後重試。
400	InstanceExist	The instance already exists.	指定執行個體已經存在。
400	InvalidOperation.NetworkInterfaceNotExist	Operation is invalid bacause network interface not exist.	NetworkInterface不存在。
400	InvalidOperation.NTRNetworkInterfaceNotSupport	Operation is invalid, due to ntr eni not support.	轉寄路由器的Eni不允許加入組播組中。
400	InstanceNotExist	The instance is not exist.	指定執行個體不存在。
400	InvalidOperation.MulticastDomainAssociationNotExist	Operation is invalid because multicast association domain association not exist.	組播域關聯不存在，無法支援當前操作。
400	InvalidOperation.MulticastDomainAssociationStatus	Operation is invalid, due to multicast domain association not Active.	當前組播域關聯狀態不支援該操作，請稍後重試。
400	QuotaFull.MulticastGroupPerDomain	The number of multicast group has exceed the maximum value that can be created.	組播域中的組播組數量已達到上限。
400	QuotaFull.MulticastSourcePerGroup	The number of multicast group source has exceed the maximum value that can be created.	組播組中的組播源數量已達到上限。
400	DryRunOperation	Request validation has been passed with DryRun flag set.	DryRun請求驗證通過。
400	IncorrectStatus.ConnectPeerIds	Connect Peer statuses are incorrect.	Connect Peer狀態不正確。
400	InvalidConnectPeerIds.NotFound	The Connect Peer Ids are invalid.	輸入的Connect Peer ID不合法。
400	OperationUnsupported.ExistsIgmpv2MemberOnEni	An igmpv2 multicast source or multicast member already exists on the ENI.	彈性網卡上已經存在 igmpv2 類型的組播源或組播成員了。
400	QuotaExceeded.SourceAndMemberPerTransitRouter	The number of multicast group members and sources has exceed the maximum value that can be created.	每個轉寄路由器下可以支援的組播源和組播成員數量超出限制。
400	InvalidParameter	Invalid parameter.	參數不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	帳號無許可權操作。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。