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

Observações de uso

Um vSwitch pode ser associado a apenas um domínio multicast. Verifique se o vSwitch não está associado a outros domínios multicast. Para obter mais informações sobre como desassociar um vSwitch de um domínio multicast, consulte DisassociateTransitRouterMulticastDomain.
A operação AssociateTransitRouterMulticastDomain é assíncrona. Após o envio da solicitação, o sistema retorna o request ID, mas a execução continua em segundo plano. Chame a operação ListTransitRouterMulticastDomainAssociations para consultar o status da associação entre o vSwitch e o domínio multicast.
- Associating: o vSwitch está sendo associado ao domínio multicast. Nesse estado, é possível consultar o vSwitch, mas outras operações ficam bloqueadas.
- Associated: a associação entre o vSwitch e o domínio multicast foi concluída com sucesso.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AssociateTransitRouterMulticastDomain	Operação a ser executada. Defina o valor como AssociateTransitRouterMulticastDomain.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token do cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar esse valor e garanta que ele seja exclusivo entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII.
TransitRouterMulticastDomainId	String	Sim	tr-mcast-domain-91wpg6wbhchjeq****	ID do domínio multicast.
TransitRouterAttachmentId	String	Sim	tr-attach-g3kz2k3u76amsk****	ID da conexão da VPC.
VSwitchIds.N	String	Não	vsw-p0wxk12u6okfkr8xy****	ID do vSwitch. Especifique até cinco IDs de vSwitch em cada chamada.
DryRun	Boolean	Não	false	Defina se a solicitação deve passar apenas por uma pré-verificação. Valores válidos: true: execute a pré-verificação sem associar o vSwitch ao domínio multicast. O sistema valida os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a pré-verificação falhar, o sistema retorna uma mensagem de erro. Caso contrário, retorna o código de erro `DryRunOperation`. false (padrão): envia a solicitação. O sistema associa o vSwitch ao domínio multicast após a aprovação na pré-verificação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	F88AC12C-943B-50E9-A344-4F8820BB07A7	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=AssociateTransitRouterMulticastDomain
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&TransitRouterMulticastDomainId=tr-mcast-domain-91wpg6wbhchjeq****
&TransitRouterAttachmentId=tr-attach-g3kz2k3u76amsk****
&VSwitchIds=["vsw-p0wxk12u6okfkr8xy****"]
&DryRun=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AssociateTransitRouterMulticastDomainResponse>
    <RequestId>F88AC12C-943B-50E9-A344-4F8820BB07A7</RequestId>
</AssociateTransitRouterMulticastDomainResponse>

Formato JSON

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

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

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidAttachmentId.NotFound	The specified AttachmentId is not found.	Mensagem retornada porque o ID da instância de rede especificado não existe.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Mensagem retornada porque a solicitação de teste (dry run) passou na pré-verificação.

Para obter uma lista de códigos de erro, visite o API Error Center.