ListTransitRouterMulticastDomainAssociations - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Consulta as associações entre um domínio multicast e vSwitches.

Descrição da operação

Ao chamar esta operação, você deve especificar pelo menos um dos parâmetros de solicitação TransitRouterMulticastDomainId e TransitRouterAttachmentId. Especificar TransitRouterAttachmentId consulta as informações sobre vSwitches associados a um domínio multicast sob uma instância conectada à VPC. Especificar TransitRouterMulticastDomainId consulta as informações sobre vSwitches associados ao domínio multicast.
Ao chamar a operação ListTransitRouterMulticastDomainAssociations, certifique-se de que os valores dos parâmetros especificados estejam corretos. Se você especificar valores de parâmetros incorretos, a operação ainda retornará um RequestId, mas não retornará as associações entre o domínio multicast e os vSwitches.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cen:ListTransitRouterMulticastDomainAssociations

get

*TransitRouterMulticastDomain

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII.	123e4567-e89b-12d3-a456-4266****
TransitRouterMulticastDomainId	string	Não	O ID do domínio multicast.	tr-mcast-domain-91wpg6wbhchjeq****
TransitRouterAttachmentId	string	Não	O ID da conexão da instância de rede.	tr-attach-p90y3ymbbwuvy5****
VSwitchIds	array	Não	A lista de IDs de vSwitches.
	string	Não	O ID do vSwitch. Você pode especificar até 20 IDs de vSwitches.	vsw-p0w9s2ig1jnwgrbzl****
ResourceType	string	Não	O tipo de recurso associado ao domínio multicast. Defina o valor como VPC.	VPC.
ResourceId	string	Não	O ID do recurso associado ao domínio multicast.	vpc-p0w9alkte4w2htrqe****
MaxResults	integer	Não	O número de entradas por página para uma consulta paginada. Valor padrão: 20.	20
NextToken	string	Não	O token que determina o ponto inicial da consulta. Valores válidos: Se esta for a primeira consulta ou nenhuma consulta subsequente for enviada, você não precisa especificar este parâmetro. Se uma consulta subsequente for enviada, defina o valor como o valor NextToken retornado na chamada anterior.	FFmyTO70tTpLG6I3FmYAXGKPd****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	1CD0969B-A605-5D2D-BFF0-699FD182FB7F.
TotalCount	integer	O número total de entradas retornadas.	1
MaxResults	integer	O número de entradas por página para uma consulta paginada.	20
NextToken	string	O token que determina o ponto inicial da consulta. Valores válidos: Se NextToken estiver vazio, nenhuma consulta subsequente será enviada. Se NextToken for retornado, o valor indica o token para a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
TransitRouterMulticastAssociations	array<object>	A lista de associações.
	object	As informações da associação.
TransitRouterMulticastDomainId	string	O ID do domínio multicast.	tr-mcast-domain-91wpg6wbhchjeq****
TransitRouterAttachmentId	string	O ID da conexão da instância de rede.	tr-attach-p90y3ymbbwuvy5****
VSwitchId	string	O ID do vSwitch.	vsw-p0wxk12u6okfkr8xy****
Status	string	O status da associação. Associated: associado. Associating: sendo associado. Dissociating: sendo desassociado.	Dissociating.
ResourceType	string	O tipo de recurso associado ao domínio multicast. Defina o valor como VPC.	VPC.
ResourceOwnerId	integer	O ID da conta Alibaba Cloud à qual o recurso associado ao domínio multicast pertence.	1210123456123456
ResourceId	string	O ID do recurso associado ao domínio multicast.	vpc-p0w9b7g9l90yofr0n****

Exemplos

Resposta de sucesso

JSON formato

{
  "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****"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.NextToken	The specified NextToken is illegal.	O NextToken especificado na solicitação é inválido.
400	IllegalParam.TransitRouterMulticastDomainId	The specified TransitRouterMulticastDomainId is illegal.	O TransitRouterMulticastDomainId especificado na solicitação é inválido.
400	IllegalParam.MaxResults	The specified MaxResults is illegal.	O valor de MaxResults é inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem permissão para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.