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

Observações de uso

A operação DeregisterTransitRouterMulticastGroupSources é assíncrona. Após o envio da solicitação, o sistema retorna o ID da solicitação, mas a execução continua em segundo plano. Para consultar o status de uma origem de multicast, chame a API ListTransitRouterMulticastGroups.

Se uma origem de multicast estiver no estado Deregistering, ela estará em processo de exclusão. Nesse cenário, é possível consultar a origem, mas outras operações ficam bloqueadas.
Caso a origem de multicast não seja encontrada, significa que ela já foi excluída.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação diretamente no OpenAPI Explorer. A ferramenta também gera dinamicamente exemplos de código para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DeregisterTransitRouterMulticastGroupSources	Operação a ser executada. Defina o valor como DeregisterTransitRouterMulticastGroupSources.
ClientToken	String	Não	123e4567-e89b-12d3-a456-4266****	Token do cliente usado para garantir a idempotência da solicitação. Gere esse valor no lado do cliente e garanta que seja único para cada solicitação distinta. O ClientToken aceita apenas caracteres ASCII.
TransitRouterMulticastDomainId	String	Sim	tr-mcast-domain-91wpg6wbhchjeq****	ID do grupo de multicast ao qual a origem pertence.
GroupIpAddress	String	Sim	239.XX.XX.2	Endereço IP do grupo de multicast ao qual a origem pertence.
NetworkInterfaceIds.N	String	Não	eni-p0weuda3lszwzjly****	ID da origem de multicast. É permitido crie apenas uma origem de multicast por grupo. Nota Este parâmetro é obrigatório.
DryRun	Boolean	Não	false	Defina se a solicitação deve ser apenas validada. Valores válidos: true: realiza apenas uma verificação prévia da API sem excluir a origem de multicast. O sistema valida os parâmetros obrigatórios, o formato da solicitação e os limites de serviço. Se a validação falhar, o sistema retornará uma mensagem de erro. Caso contrário, o código de erro `DryRunOperation` será retornado. false (padrão): envia a solicitação efetivamente. Após a aprovação na verificação prévia, a origem de multicast é excluída.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	53E7E8BE-7F4E-5458-ACCA-9B5C1D6A642D	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=DeregisterTransitRouterMulticastGroupSources
&ClientToken=123e4567-e89b-12d3-a456-4266****
&TransitRouterMulticastDomainId=tr-mcast-domain-91wpg6wbhchjeq****
&GroupIpAddress=239.XX.XX.2
&NetworkInterfaceIds=["eni-p0weuda3lszwzjly****"]
&DryRun=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DeregisterTransitRouterMulticastGroupSourcesResponse>
    <RequestId>53E7E8BE-7F4E-5458-ACCA-9B5C1D6A642D</RequestId>
</DeregisterTransitRouterMulticastGroupSourcesResponse>

Formato JSON

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

{
  "RequestId" : "53E7E8BE-7F4E-5458-ACCA-9B5C1D6A642D"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Mensagem retornada quando a solicitação de teste (dry run) passa na verificação prévia com sucesso.

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