全部產品
Search
文件中心

Cloud Enterprise Network:RegisterTransitRouterMulticastGroupMembers

更新時間:Aug 12, 2026

呼叫 RegisterTransitRouterMulticastGroupMembers 介面建立或新增群播成員。

介面說明

目前企業版轉送路由器僅支援將彈性網路介面 ENI(Elastic Network Interface)指定為群播成員。您可以透過呼叫 RegisterTransitRouterMulticastGroupMembers 介面將同區域的 ENI 和跨區域的 ENI 指定為群播成員。

  • 如果您指定 NetworkInterfaceIds 參數的值,則表示您需要將目前區域下的 ENI 指定為群播成員。請確保 ENI 所屬的交換器已關聯至群播網域。具體操作,請參見 AssociateTransitRouterMulticastDomain

  • 如果您指定 PeerTransitRouterMulticastDomains 參數的值,則表示您需要將跨區域相同群播 IP 位址的群播群組下的群播成員指定為您目前群播群組的群播成員。請確保您已經建立了跨區域連線,具體操作,請參見 CreateTransitRouterPeerAttachment

    例如:您在華東 1(杭州)區域擁有一個群播網域 1,群播網域 1 下擁有一個群播群組 1,在華東 2(上海)區域擁有一個群播網域 2,群播網域 2 下擁有群播群組 2,群播群組 1 和群播群組 2 擁有相同的群播 IP 位址,且華東 2(上海)區域的群播群組 2 下擁有一個群播成員 2。在您呼叫 RegisterTransitRouterMulticastGroupMembers 介面為華東 1(杭州)區域的群播群組 1 建立群播成員時,如果您指定 PeerTransitRouterMulticastDomains 參數的值為華東 2(上海)區域群播網域 2 的 ID,則華東 2(上海)區域群播群組 2 下的群播成員 2,也將是華東 1(杭州)區域群播群組 1 下的群播成員。

  • RegisterTransitRouterMulticastGroupMembers 介面屬於非同步介面,即系統會先返回一個 RequestId,但群播成員尚未完全建立成功,系統背景的建立任務仍在進行。您可以呼叫 ListTransitRouterMulticastGroups 介面查詢群播成員的狀態。

    • 當群播成員處於 Registering 狀態時,表示群播成員正在被建立,在該狀態下,您只能對群播成員執行查詢操作,不能執行其他操作。

    • 當群播成員處於 Registered 狀態時,表示群播成員已成功建立。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

cen:RegisterTransitRouterMulticastGroupMembers

create

*TransitRouterMulticastDomain

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

請求參數

名稱

類型

必填

描述

樣本值

ClientToken

string

用戶端 Token,用於保證請求的冪等性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

說明

若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 識別碼。每次 API 請求的 RequestId 不一樣。

123e4567-e89b-12d3-a456-426655440000

TransitRouterMulticastDomainId

string

群播成員所屬的群播網域 ID。

tr-mcast-domain-91wpg6wbhchjeq****

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。

一次支援關聯多個彈性網路介面。請確保您指定的彈性網路介面個數與跨區域群播網域的個數之和小於或等於 5。

eni-p0weuda3lszwzjly****

PeerTransitRouterMulticastDomains

array

跨區域的群播網域 ID 清單。

string

跨區域的群播網域 ID。

一次支援關聯多個跨區域的群播網域。請確保您指定的彈性網路介面個數與跨區域群播網域的個數之和小於或等於 5。

tr-mcast-domain-5mjb5gjb6dgu98****

DryRun

boolean

是否僅預檢此次請求。取值:

  • true:傳送檢查請求,不會建立群播成員。檢查項目包括是否填寫了必要參數、請求格式、業務限制等。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回錯誤碼 DryRunOperation

  • false(預設值):傳送正常請求,通過檢查後直接建立群播成員。

false

VpcId

string

彈性網路介面所屬的 VPC 執行個體 ID。

  • 如果彈性網路介面所屬阿里雲帳號和您目前登入的阿里雲帳號為相同帳號,本參數可不填。

  • 如果彈性網路介面所屬阿里雲帳號和您目前登入的阿里雲帳號為不同帳號,本參數必填。

vpc-wz9fusm6zq8uy7cfa****

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

請求 ID。

EB985B7E-2CF8-5EC9-A7DB-F7C82ABD3ACE

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

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 InstanceNotExist The instance is not exist. 指定的執行個體不存在。
400 InvalidOperation.PeerMulticastDomainRegion Operation is invalid because to peer multicast domain in the same region with multicast domain.
400 InvalidOperation.MulticastDomainStatus Operation is invalid, due to multicast domain not Active. 目前多播域狀態不支援此操作,請稍後重試。
400 InvalidOperation.BandwidthLimitNotExist Operation is invalid because a bandwidth limit not exist. 頻寬包限速不存在。
400 AttachmentNotFound "The attachment does not exist.
400 IncorrectStatus.AttachmentId The status of AttachmentId is incorrect. 當前 Attachment 的狀態不支援該操作,請稍後重試。
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 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 InvalidPeerTrMulticastDomainId.NotFound The specified PeerTrMulticastDomainId is not found. 參數中指定的 PeerTrMulticastDomainId 不存在。
400 IncorrectStatus.PeerTrMulticastDomainId The status of PeerTrMulticastDomainId is incorrect. 當前 PeerTrMulticastDomain 的狀態不支援該操作,請稍後重試。
400 IllegalParam.PeerTrMulticastDomainId The specified PeerTrMulticastDomainId is illegal. 參數中指定的 PeerTrMulticastDomainId 不合法。
400 InvalidOperation Operation is invalid. 非法操作。
400 QuotaFull.MulticastGroupPerDomain The number of multicast group has exceed the maximum value that can be created. 群播域中的群播群組數量已達上限。
400 QuotaFull.MulticastMemberPerGroup The number of multicast group member has exceed the maximum value that can be created. 群播群組中的群播成員數量已達上限。
400 QuotaFull.MulticastPeerMemberPerGroup The number of multicast group member peer domain has exceed the maximum value that can be created. 群播群組中的跨地域成員數量已達上限。
400 DryRunOperation Request validation has been passed with DryRun flag set. DryRun 請求驗證通過。
400 InvalidConnectPeerIds.NotFound The Connect Peer Ids are invalid. 輸入的 Connect Peer ID 不合法。
400 InvalidVpcId.NotFound The specified VpcId is not found. 參數中指定的 VpcId 不存在。
400 OperationUnsupported.ExistsIgmpv2MemberOnEni An igmpv2 multicast source or multicast member already exists on the ENI. 彈性網卡上已經存在 igmpv2 類型的群播來源或群播成員了。
400 InvalidVpcId.NotValid The specified Vpc is invalid. 指定的 vpcId 無效。
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. 帳號無權限操作。
400 InvalidParameter.TransitRouterMulticastDomainId The specified parameter TransitRouterMulticastDomainId is invalid. 輸入的參數 TransitRouterMulticastDomainId 不合法。
400 InvalidParameter.PeerTransitRouterMulticastDomains The specified parameter PeerTransitRouterMulticastDomains is invalid. 輸入的參數PeerTransitRouterMulticastDomains不合法。
400 InvalidParameter.ConnectPeerIds The specified parameter ConnectPeerIds is invalid. 輸入的參數ConnectPeerIds不合法。

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

變更歷史

更多資訊,參考變更詳情