Todos os produtos
Search
Central de documentação

:CreateTransitRouterCidr

Última atualização: Jun 23, 2026

Cria um bloco CIDR para um transit router.

Notas de uso

Você pode especificar um bloco CIDR para um transit router. O bloco CIDR funciona de maneira semelhante ao bloco CIDR da interface de loopback em um roteador. Endereços IP dentro do bloco CIDR podem ser atribuídos a conexões IPsec-VPN. Para mais informações, consulte Blocos CIDR de transit router.

Você só pode usar a operação CreateTransitRouterCidr para criar um bloco CIDR depois de criar um transit router.

O bloco CIDR deve atender aos seguintes requisitos:

  • Apenas transit routers da Enterprise Edition são compatíveis com blocos CIDR personalizados.
  • Este recurso está em prévia pública e está disponível apenas em algumas regiões. Para mais informações sobre as regiões compatíveis, consulte Limites de blocos CIDR de transit router.
  • Cada transit router aceita no máximo cinco blocos CIDR. A máscara de sub-rede de um bloco CIDR deve ter de 16 a 24 bits de comprimento.
  • Os seguintes blocos CIDR e suas sub-redes não são aceitos: 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8 e 169.254.0.0/16.
  • O bloco CIDR não pode se sobrepor a blocos CIDR usados por instâncias de rede conectadas à instância do CEN para comunicação entre si.
  • Em uma mesma instância do CEN, cada bloco CIDR de transit router deve ser único.
  • Ao criar a primeira conexão VPN após adicionar um bloco CIDR a um transit router, o sistema reserva três blocos CIDR dentro do bloco CIDR. Um endereço IP dos blocos CIDR restantes é alocado para a conexão IPsec-VPN.

    Chame ListTransitRouterCidrAllocation para consultar os blocos CIDR reservados e os endereços IP alocados a conexões de rede.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, 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 de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateTransitRouterCidr

A operação que você deseja executar. Defina o valor como CreateTransitRouterCidr.

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

O token do cliente usado para garantir a idempotência da solicitação.

Você pode usar o cliente para gerar o valor, mas deve garantir que ele seja único entre diferentes solicitações. O ClientToken pode conter apenas caracteres ASCII.

null Se você não definir este parâmetro, o ClientToken será definido com o valor de RequestId. O valor de RequestId pode ser diferente para cada solicitação de API.
TransitRouterId String Sim tr-p0w3x8c9em72a40nw****

O ID do transit router.

RegionId String Sim ap-southeast-2

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

Chame a operação DescribeChildInstanceRegions para consultar a lista de regiões mais recente.

Name String Não nametest

O nome do bloco CIDR.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, pontos (.), underscores (_) e hifens (-). O nome deve começar com uma letra e não pode começar com http:// ou https://.

Description String Não desctest

A descrição do bloco CIDR.

A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra e não pode começar com http:// ou https://.

DryRun Boolean Não false

Especifica se a solicitação deve apenas ser pré-verificada. Valores válidos:

  • true: pré-verifica a solicitação, mas não cria o bloco CIDR. O sistema verifica os parâmetros obrigatórios, o formato da solicitação e os limites do serviço. Se a solicitação não passar na pré-verificação, o sistema retornará uma mensagem de erro. Se a solicitação passar na pré-verificação, o código de erro DryRunOperation será retornado.
  • false (padrão): envia a solicitação. Após a solicitação passar na pré-verificação, o sistema cria o bloco CIDR.
Cidr String Sim 192.168.10.0/24

O bloco CIDR que você deseja criar para o transit router.

PublishCidrRoute Boolean Não true

Especifica se o sistema deve adicionar automaticamente uma rota que aponte para o bloco CIDR à tabela de rotas do transit router.

  • true (padrão): sim

    O valor true indica que, após criar uma conexão VPN privada e ativar o aprendizado de rotas para a conexão, o sistema adiciona automaticamente uma rota blackhole à tabela de rotas do transit router ao qual a conexão VPN está conectada. O bloco CIDR de destino da rota blackhole é o bloco CIDR do transit router. O bloco CIDR do transit router refere-se ao bloco CIDR a partir do qual os endereços IP do gateway são alocados para conexões IPsec-VPN. A rota blackhole é divulgada apenas 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
TransitRouterCidrId String cidr-0zv0q9crqpntzz****

O ID do bloco CIDR do transit router.

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

O ID da solicitação.

Exemplos

Exemplos de solicitação

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

Exemplos de respostas bem-sucedidas

Formato XML

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

<CreateTransitRouterCidrResponse>
    <TransitRouterCidrId>cidr-0zv0q9crqpntzz****</TransitRouterCidrId>
    <RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
</CreateTransitRouterCidrResponse>

Formato JSON

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

{
  "TransitRouterCidrId" : "cidr-0zv0q9crqpntzz****",
  "RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A"
}

Códigos de erro

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