Todos os produtos
Search
Central de documentação

:ModifiqueTransitRouterCidr

Última atualização: Jul 03, 2026

Modifica o bloco CIDR de um transit router.

Observações de uso

  • Antes de modificar o bloco CIDR de um transit router, leia os limites de blocos CIDR do transit router.

  • Não é possível alterar o bloco CIDR se endereços IP dentro dele já estiverem alocados para instâncias de rede.

  • Ao chamar a operação ModifyTransitRouterCidr, caso nenhum parâmetro da operação PublishCidrRoute seja alterado, a execução será síncrona e as novas configurações entrarão em vigor imediatamente.

  • Se houver modificação em algum parâmetro da operação PublishCidrRoute, a chamada àModifyTransitRouterCidr será assíncrona. O sistema retorna o ID da solicitação (RequestId) enquanto continua processando a tarefa em segundo plano. Para verificar o status do bloco CIDR do transit router, utilize a operação ListTransitRouterCidr.

    • Enquanto o bloco CIDR permanecer inalterado, a modificação ainda está em andamento.

    • A alteração é considerada concluída quando o bloco CIDR corresponder ao valor especificado na solicitação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos executar esta operação no OpenAPI Explorer, que 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 ModifyTransitRouterCidr

Operação a ser executada. Defina o valor como ModifyTransitRouterCidr.

ClientToken String Não 123e4567-e89b-12d3-a456-426****

Token de cliente usado para garantir a idempotência da solicitação.

Gere esse valor no lado do cliente, assegurando que seja único para cada solicitação distinta. O ClientToken aceita apenas caracteres ASCII.

Nota Caso este parâmetro não seja definido, o sistema atribuirá ao ClientToken o mesmo valor do RequestId. Note que o RequestId pode variar entre diferentes chamadas de API.
TransitRouterId String Sim tr-gw8ergozrv77rtbjd****

ID do transit router.

TransitRouterCidrId String Sim cidr-0zv0q9crqpntzz****

ID do bloco CIDR do transit router.

Para obter o ID de um bloco CIDR de rota de trânsito, chame a operação ListTransitRouterCidr.

RegionId String Sim ap-southeast-2

ID da região onde o transit router está implantado.

Consulte a lista mais recente de regiões disponíveis por meio da operação DescribeChildInstanceRegions.

Name String Não nametest

Novo nome para o bloco CIDR do transit router.

O comprimento deve estar entre 1 e 128 caracteres.

Description String Não desctest

Nova descrição para o bloco CIDR do transit router.

Deve conter entre 1 e 256 caracteres.

Cidr String Não 192.168.10.0/24

Novo bloco CIDR do transit router.

DryRun Boolean Não false

Defina se a solicitação passará apenas por uma pré-verificação. Valores válidos:

  • true: realiza a validação sem efetuar alterações reais. O sistema confere os parâmetros obrigatórios, o formato da solicitação e os limites de serviço. Falhas na validação retornam uma mensagem de erro específica; aprovações retornam o código de erro DryRunOperation.
  • false: envia a solicitação normalmente. Se a pré-verificação for bem-sucedida, o bloco CIDR do transit router será modificado.
PublishCidrRoute Boolean Não true

Indica se o sistema deve adicionar automaticamente rotas apontando para o bloco CIDR na tabela de rotas do transit router.

  • true: sim

    Ao definir como true, após criar uma conexão VPN privada e ativar o aprendizado de rotas, o sistema insere automaticamente uma rota blackhole na tabela de rotas do transit router associado à conexão VPN.

    Essa rota blackhole tem como destino o próprio bloco CIDR do transit router, ou seja, o intervalo de onde são alocados endereços IP de gateway para conexões IPsec-VPN.

    A propagação dessa rota ocorre exclusivamente para a tabela de rotas do virtual border router (VBR) conectado ao transit router.

  • false: não

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

0876E54E-3E36-5C31-89F0-9EE8A9266F9A

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ModifyTransitRouterCidr
&ClientToken=123e4567-e89b-12d3-a456-426****
&TransitRouterId=tr-gw8ergozrv77rtbjd****
&TransitRouterCidrId=cidr-0zv0q9crqpntzz****
&RegionId=ap-southeast-2
&Name=nametest
&Description=desctest
&Cidr=192.168.10.0/24
&DryRun=false
&PublishCidrRoute=true
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<ModifyTransitRouterCidrResponse>
    <RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
</ModifyTransitRouterCidrResponse>

Formato JSON

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

{
  "RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

Códigos de erro

Para obter uma lista completa de códigos de erro, visite o Centro de Erros de API.