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

Observações de uso

Ao desassociar um vSwitch de um domínio multicast, as fontes e os membros multicast desse vSwitch também são removidos do domínio.
A operação DisassociateTransitRouterMulticastDomain é assíncrona. Após o envio da requisição, o sistema retorna o request ID, mas a execução continua em segundo plano. Para consultar o status da associação entre o vSwitch e o domínio multicast, chame a API ListTransitRouterMulticastDomainAssociations.
- O status Dissociating indica que a desassociação do vSwitch está em andamento. Nesse estado, é possível consultar o vSwitch, mas outras operações ficam bloqueadas.
- Caso o vSwitch não seja encontrado, significa que ele já foi desassociado do domínio multicast.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DisassociateTransitRouterMulticastDomain	Operação a ser executada. Defina o valor como DisassociateTransitRouterMulticastDomain.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	Token de cliente usado para garantir a idempotência da requisição. Use o cliente para gerar esse valor e garanta que seja único entre diferentes requisiçõ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 Virtual Private Cloud (VPC). Um ID de conexão é gerado quando a VPC à qual o vSwitch pertence se conecta a um transit router.
DryRun	Boolean	Não	false	Defina se apenas a validação da requisição será executada. Valores válidos: true: pré-verifica a requisição sem desassociar o vSwitch do domínio multicast. O sistema valida os parâmetros obrigatórios, o formato da requisição e os limites de 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 requisição. A desassociação do vSwitch ocorre após a aprovação na pré-verificação.
VSwitchIds.N	String	Não	vsw-p0w9s2ig1jnwgrbzl****	ID do vSwitch. Especifique até cinco IDs de vSwitch por chamada.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	6F6B3FF0-45D1-5416-B189-C45A42A0222B	ID da requisição.

Exemplos

Exemplos de requisição

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

Exemplos de resposta de sucesso

Formato XML

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

<DisassociateTransitRouterMulticastDomainResponse>
    <RequestId>6F6B3FF0-45D1-5416-B189-C45A42A0222B</RequestId>
</DisassociateTransitRouterMulticastDomainResponse>

Formato JSON

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

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

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 requisição de simulação (dry run) passou na pré-verificação.

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