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

Chama a operação DeleteTransitRouterRouteEntry para excluir entradas de rota estática do tipo blackhole ou conexão de instância de uma tabela de rotas de encaminhamento de roteador de trânsito da Enterprise Edition.

Descrição da operação

Antes de chamar esta operação para excluir uma entrada de rota, observe as seguintes informações:

Se você especificar TransitRouterRouteEntryId para excluir uma entrada de rota, não será necessário especificar TransitRouterRouteTableId ou TransitRouterRouteEntryDestinationCidrBlock. Caso contrário, ocorrerá um erro de conflito de parâmetros.
Se você não especificar TransitRouterRouteEntryId para excluir uma entrada de rota, especifique os parâmetros correspondentes com base no tipo de próximo salto da entrada de rota:
- Para excluir uma rota blackhole, especifique TransitRouterRouteTableId, TransitRouterRouteEntryDestinationCidrBlock e TransitRouterRouteEntryNextHopType.
- Para excluir uma rota não blackhole, especifique TransitRouterRouteTableId, TransitRouterRouteEntryDestinationCidrBlock, TransitRouterRouteEntryNextHopType e TransitRouterRouteEntryNextHopId.
DeleteTransitRouterRouteEntry é uma operação assíncrona. Após o envio de uma solicitação, o sistema retorna um RequestId, mas a entrada de rota ainda não é excluída. A tarefa de exclusão é executada em segundo plano. Você pode chamar ListTransitRouterRouteEntries para consultar o status da entrada de rota.
- Se a entrada de rota estiver no estado Deleting, ela estará sendo excluída. Nesse estado, você só pode consultar a entrada de rota, mas não pode executar outras operações nela.
- Se a entrada de rota não for encontrada, significa que ela foi excluída.

Limites

Esta operação pode excluir apenas entradas de rota estática. Entradas de rota aprendidas automaticamente não podem ser excluídas. Você pode chamar ListTransitRouterRouteEntries para consultar o tipo de uma entrada de rota.

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

delete

TransitRouterRouteEntry

acs:cen:*:{#accountId}:centransitrouterroutentry/{#centransitrouterroutentryId}

TransitRouterRouteTable

acs:cen:*:{#accountId}:centransitrouterroutentry/{#transitrouterroutetableId}

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 exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o ClientToken. O RequestId pode ser diferente para cada solicitação de API.	02fb3da4-130e-11e9-8e44-001****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run, incluindo validação de permissões e status da instância. Valores válidos: false (padrão): Envia uma solicitação normal e exclui diretamente a entrada de rota após a solicitação passar na validação. true: Envia uma solicitação de verificação. Apenas a validação é realizada. A entrada de rota não é excluída. O sistema verifica parâmetros obrigatórios, formato da solicitação e outras condições. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o ID da solicitação correspondente será retornado.	false
TransitRouterRouteEntryId	string	Não	O ID da entrada de rota.	rte-75eg4jprkvk0pw****
TransitRouterRouteEntryNextHopType	string	Não	O tipo de próximo salto da entrada de rota. Valores válidos: BlackHole: A entrada de rota é uma rota blackhole. Não é necessário especificar as informações de próximo salto. Attachment: O próximo salto da entrada de rota é uma conexão de instância de rede. Você também deve especificar o ID da conexão de instância de rede como o próximo salto.	BlackHole
TransitRouterRouteEntryDestinationCidrBlock	string	Não	O bloco CIDR de destino.	192.168.0.0/24
TransitRouterRouteEntryNextHopId	string	Não	O ID da conexão de instância de rede associada ao próximo salto da entrada de rota.	tr-attach-nls9fzkfat8934****
TransitRouterRouteTableId	string	Não	O ID da tabela de rotas do roteador de trânsito da Enterprise Edition.	vtb-bp1dudbh2d5na6b50****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A validação da solicitação DryRun foi aprovada.
400	IllegalParam.TransitRouterRouteEntryId	TransitRouterRouteEntryId is not found.	O TransitRouterRouteEntryId especificado na solicitação é inválido.
400	ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock	RouteEntryId and TransitRouterRouteTableIdOrDestCidrBlock is mutually exclusive.	Os parâmetros RouteEntryId, TransitRouterRouteTableId e DestCidrBlock são mutuamente exclusivos.
400	InvalidTransitRouterRouteTableId.NotFound	TransitRouterRouteTableId is not found.	O ID da instância da tabela de rotas do roteador de trânsito não foi encontrado.
400	InvalidDestinationCidrBlock.NotFound	DestinationCidrBlock is not found.	O DestinationCidrBlock especificado no parâmetro não existe.
400	OperationFailed.DeleteTransitRouterRouteEntry	Operation failed because this route entry is created automatically.	As entradas de roteamento criadas automaticamente pelo sistema não podem ser excluídas.
400	IllegalParam.NextHopType	The NextHopType is illegal.	O NextHopType especificado na solicitação é inválido.
400	IllegalParam.TransitRouterRouteTableId	The transitRouter route table id is illegal.	O TransitRouterRouteTableId especificado na solicitação é inválido.
400	MissingParam.TransitRouterRouteEntryNextHopId	The parameter TransitRouterRouteEntryNextHopId is mandatory	O parâmetro TransitRouterRouteEntryNextHopId está ausente.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.
400	InvalidParameter.TransitRouterRouteEntryId	The specified parameter TransitRouterRouteEntryId is invalid.	O parâmetro TransitRouterRouteEntryId é inválido.
400	InvalidParameter.TransitRouterRouteEntryNextHopId	The specified parameter TransitRouterRouteEntryNextHopId is invalid.	O parâmetro TransitRouterRouteEntryNextHopId é inválido.
400	InvalidParameter.TransitRouterRouteTableId	The specified parameter TransitRouterRouteTableId is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.