DisassociateTransitRouterMulticastDomain - 解除交換器與組播域的關聯關係 -

調用DisassociateTransitRouterMulticastDomain介面解除交換器與組播域的關聯關係。

介面說明

交換器和組播域解除關聯前，請確保交換器下不存在組播源和組播成員。刪除群組播源和刪除群組播成員的操作，請參見 DeregisterTransitRouterMulticastGroupSources 和 DeregisterTransitRouterMulticastGroupMembers 。
如果您輸入的參數有誤調用介面後仍然會返回 RequestId，但不會解除交換器與組播域的關聯關係。
DisassociateTransitRouterMulticastDomain 介面屬於非同步介面，即系統會先返回一個 RequestId，但交換器和組播域並未完全解除關聯關係，系統背景解除任務仍在進行。您可以調用 ListTransitRouterMulticastDomainAssociations 介面查詢交換器和組播域的關聯狀態。
- 當關聯狀態為 Dissociating 時，表示交換器和組播域正在解除關聯關係，在該狀態下，您只能對交換器執行查詢操作，不能執行其他動作。
- 當在組播域下查詢不到該交換器的資訊時，表示交換器和組播域已成功解除關聯關係。

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

cen:DisassociateTransitRouterMulticastDomain

delete

*TransitRouterMulticastDomain

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

無

名稱	類型	必填	描述	樣本值
ClientToken	string	否	用戶端 Token，用於保證請求的等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。	123e4567-e89b-12d3-a456-426655440000
TransitRouterMulticastDomainId	string	是	組播域 ID。	tr-mcast-domain-91wpg6wbhchjeq****
TransitRouterAttachmentId	string	是	VPC 串連 ID。本參數為交換器所屬的Virtual Private Cloud（Virtual Private Cloud）被串連至轉寄路由器執行個體後產生的 VPC 串連的 ID。	tr-attach-g3kz2k3u76amsk****
DryRun	boolean	否	是否只預檢此次請求。取值： true：發送檢查請求，不會解除交換器和組播域的關聯關係。檢查項包括是否填寫了必需參數、請求格式、業務限制等。如果檢查不通過，則返回對應錯誤。如果檢查通過，則返回錯誤碼`DryRunOperation`。 false（預設值）：發送正常請求，通過檢查後直接解除交換器和組播域的關聯關係。	false
VSwitchIds	array	否	交換器 ID 列表。
	string	是	交換器 ID。一次最多支援與 5 個交換器解除關聯關係。	vsw-p0w9s2ig1jnwgrbzl****

正常返回樣本

JSON格式

{
  "RequestId": "6F6B3FF0-45D1-5416-B189-C45A42A0222B"
}

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidMulticastDomainId.NotFound	The specified MulticastDomainId is not found.	參數中指定的MulticastDomain不存在。
400	IncorrectStatus.MulticastDomain	The status of MulticastDomain is incorrect.	當前MulticastDomain的狀態不支援該操作，請稍後重試。
400	InstanceStatusNotSupport	The status of instance not support the operation.	當前執行個體狀態不支援該操作。
400	InvalidAttachmentId.NotFound	The specified AttachmentId is not found.
400	IncorrectStatus.Attachment	The status of Attachment is incorrect.	當前Attachment的狀態不支援該操作，請稍後重試。
400	IllegalParam.AttachmentId	The specified AttachmentId is illegal.	參數中指定的AttachmentId不合法。
400	InvalidOperation.MulticastGroupExist	Operation is invalid because multicast groups exist.	組播組存在，無法支援當前操作。
400	DryRunOperation	Request validation has been passed with DryRun flag set.	DryRun請求驗證通過。
400	InvalidParameter	Invalid parameter.	參數不合法。
400	Unauthorized	The AccessKeyId is unauthorized.	帳號無許可權操作。

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

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