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

Associa um vSwitch em uma nuvem privada virtual (VPC) a um domínio de multicast para habilitar a comunicação multicast para recursos na VPC.

Descrição da operação

Um vSwitch pode ser associado a apenas um domínio de multicast. Certifique-se de que o vSwitch a ser associado não esteja associado a outros domínios de multicast. Para desassociar um vSwitch de um domínio de multicast, consulte DisassociateTransitRouterMulticastDomain.
AssociateTransitRouterMulticastDomain é uma operação de API assíncrona. Depois de chamar essa operação, o sistema retorna um RequestId, mas o vSwitch não é associado imediatamente ao domínio de multicast. A tarefa de associação é executada em segundo plano. Você pode chamar ListTransitRouterMulticastDomainAssociations para consultar o status de associação do vSwitch e do domínio de multicast.
- Se o status de associação for Associating, o vSwitch está sendo associado ao domínio de multicast. Nesse estado, você pode realizar apenas operações de consulta no vSwitch.
- Se o status de associação for Associated, o vSwitch está associado ao domínio de multicast.
A VPC à qual o vSwitch pertence deve estar conectada a um transit router Enterprise Edition. Para criar uma conexão VPC, consulte CreateTransitRouterVpcAttachment.

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:AssociateTransitRouterMulticastDomain

update

*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 valor, mas deve garantir que o valor seja exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII.	123e4567-e89b-12d3-a456-426655440000
TransitRouterMulticastDomainId	string	Sim	O ID do domínio de multicast.	tr-mcast-domain-91wpg6wbhchjeq****
TransitRouterAttachmentId	string	Sim	O ID da conexão VPC.	tr-attach-g3kz2k3u76amsk****
VSwitchIds	array	Sim	Os IDs dos vSwitches.
	string	Sim	O ID do vSwitch. Você pode associar até 5 vSwitches por vez. Um domínio de multicast pode ser associado a até 10 vSwitches.	vsw-p0wxk12u6okfkr8xy****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run e não associa os vSwitches ao domínio de multicast. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido e se os limites de serviço foram atendidos. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado. false (padrão): envia uma solicitação normal e associa os vSwitches ao domínio de multicast se a solicitação passar na verificação.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	F88AC12C-943B-50E9-A344-4F8820BB07A7

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "F88AC12C-943B-50E9-A344-4F8820BB07A7"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidMulticastDomain.NotFound	The specified MulticastDomain is not found.	O MulticastDomain especificado no parâmetro não existe.
400	IncorrectStatus.MulticastDomain	The status of MulticastDomain is incorrect.	O status atual do domínio de multicast não suporta esta operação. Tente novamente mais tarde.
400	InvalidAttachmentId.NotFound	The specified AttachmentId is not found.
400	IllegalParam.AttachmentId	The specified AttachmentId is illegal.	O AttachmentId especificado na solicitação é inválido.
400	IncorrectStatus.Attachment	The status of Attachment is incorrect.	A instância de conectividade de rede está sendo processada. Tente novamente mais tarde.
400	MissingParam.VSwitchIds	The parameter VSwitchIds is mandatory.	O parâmetro VSwitchIds está ausente.
400	InstanceNotExist	The instance is not exist.	A instância especificada não existe.
400	OperationUnsupported.CloudBoxVpc	The specified CloudBoxVpc does not support the operation.	Esta operação não é suportada para VPCs CloudBox.
400	AssociationExist.VSwitchIds	The association already exists.	O vSwitch já está associado.
400	QuotaFull.VswitchPerMulticastDomain	The number of vswitch associated with multicast domain has exceed the maximum value that can be created.	O número de vSwitches associados ao domínio de multicast atingiu o limite superior.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A solicitação de dry run passou na validação.
400	OperationUnsupported.VpcRegion	The specified Region is not support for this operation.	A região atual não suporta esta operação.
400	OperationUnsupported.AdvancedFeature	The specified vpc does not support the operation.
400	QuotaFull.MulticastDomainPerVpc	The number of multicast domain that vpc associated has exceed the maximum value that can be associated.	O número de domínios de multicast que podem ser associados à VPC atingiu o limite superior.
400	IllegalParam.VSwitchIds	The parameter VSwitchIds is illegal.	O parâmetro VSwitchIds é inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	Você não tem permissões suficientes para realizar esta operação. Abra um ticket para obter assistência.
400	InvalidParameter.TransitRouterAttachmentId	The specified parameter TransitRouterAttachmentId is invalid.	O parâmetro TransitRouterAttachmentId especificado é inválido.
400	InvalidParameter.TransitRouterMulticastDomainId	The specified parameter TransitRouterMulticastDomainId is invalid.	O parâmetro TransitRouterMulticastDomainId especificado é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.