调用ListTransitRouterMulticastDomainAssociations接口查询组播域的关联信息。

使用说明

当前组播域仅支持关联专有网络VPC(Virtual Private Cloud)下的交换机,您可以调用ListTransitRouterMulticastDomainAssociations接口查询组播域和交换机的关联关系。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTransitRouterMulticastDomainAssociations

系统规定参数。取值:ListTransitRouterMulticastDomainAssociations

ClientToken String 123e4567-e89b-12d3-a456-4266****

客户端Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

TransitRouterMulticastDomainId String tr-mcast-domain-91wpg6wbhchjeq****

组播域ID。

TransitRouterAttachmentId String tr-attach-p90y3ymbbwuvy5****

网络实例连接ID。

VSwitchIds.N String vsw-p0w9s2ig1jnwgrbzl****

交换机ID。

最多支持输入20个交换机ID。

ResourceType String VPC

组播域关联的资源类型。

仅取值:VPC

ResourceId String vpc-p0w9alkte4w2htrqe****

组播域关联的资源的ID。

MaxResults Long 20

分批次查询时每次显示的条目数。默认值:20

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。

返回数据

名称 类型 示例值 描述
RequestId String 1CD0969B-A605-5D2D-BFF0-699FD182FB7F

请求ID。

TotalCount Integer 1

列表条目数。

MaxResults Integer 20

分批次查询时每次显示的条目数。

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
TransitRouterMulticastAssociations Array of TransitRouterMulticastAssociation

关联信息列表。

TransitRouterMulticastDomainId String tr-mcast-domain-91wpg6wbhchjeq****

组播域ID。

TransitRouterAttachmentId String tr-attach-p90y3ymbbwuvy5****

网络实例连接ID。

VSwitchId String vsw-p0wxk12u6okfkr8xy****

交换机ID。

Status String Dissociating

关联状态。

  • Associated:已关联。
  • Associating:关联中。
  • Dissociating:解除关联中。
ResourceType String VPC

组播域关联的资源类型。

仅取值:VPC

ResourceOwnerId Long 1210123456123456

组播域关联的资源所属的阿里云账号(主账号)ID。

ResourceId String vpc-p0w9b7g9l90yofr0n****

组播域关联的资源的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterMulticastDomainAssociations
&ClientToken=123e4567-e89b-12d3-a456-4266****
&TransitRouterMulticastDomainId=tr-mcast-domain-91wpg6wbhchjeq****
&TransitRouterAttachmentId=tr-attach-p90y3ymbbwuvy5****
&VSwitchIds=["vsw-p0w9s2ig1jnwgrbzl****"]
&ResourceType=VPC
&ResourceId=vpc-p0w9alkte4w2htrqe****
&MaxResults=20
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTransitRouterMulticastDomainAssociationsResponse>
    <RequestId>1CD0969B-A605-5D2D-BFF0-699FD182FB7F</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>20</MaxResults>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <TransitRouterMulticastAssociations>
        <TransitRouterMulticastDomainId>tr-mcast-domain-91wpg6wbhchjeq****</TransitRouterMulticastDomainId>
        <TransitRouterAttachmentId>tr-attach-p90y3ymbbwuvy5****</TransitRouterAttachmentId>
        <VSwitchId>vsw-p0wxk12u6okfkr8xy****</VSwitchId>
        <Status>Dissociating</Status>
        <ResourceType>VPC</ResourceType>
        <ResourceOwnerId>1210123456123456</ResourceOwnerId>
        <ResourceId>vpc-p0w9b7g9l90yofr0n****</ResourceId>
    </TransitRouterMulticastAssociations>
</ListTransitRouterMulticastDomainAssociationsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1CD0969B-A605-5D2D-BFF0-699FD182FB7F",
  "TotalCount" : 1,
  "MaxResults" : 20,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TransitRouterMulticastAssociations" : [ {
    "TransitRouterMulticastDomainId" : "tr-mcast-domain-91wpg6wbhchjeq****",
    "TransitRouterAttachmentId" : "tr-attach-p90y3ymbbwuvy5****",
    "VSwitchId" : "vsw-p0wxk12u6okfkr8xy****",
    "Status" : "Dissociating",
    "ResourceType" : "VPC",
    "ResourceOwnerId" : 1210123456123456,
    "ResourceId" : "vpc-p0w9b7g9l90yofr0n****"
  } ]
}

错误码

访问错误中心查看更多错误码。