Todos os produtos
Search
Central de documentação

:ListTransitRouterCidrAllocation

Última atualização: Jul 03, 2026

Consulta a alocação de endereços IP no bloco CIDR de um transit router.

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 solicitação

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

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

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

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

Gere o valor pelo cliente, mas garanta que seja único entre solicitações diferentes. O ClientToken aceita apenas caracteres ASCII.

Nota Se você não definir este parâmetro, o ClientToken assumirá o valor de RequestId. O valor de RequestId pode variar em cada solicitação de API.
TransitRouterId String Sim tr-p0w3x8c9em72a40nw****

ID do transit router.

RegionId String Sim ap-southeast-2

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

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

TransitRouterCidrId String Não cidr-0zv0q9crqpntzz****

ID do bloco CIDR.

Chame a operação ListTransitRouterCidr para consultar o ID de um bloco CIDR.

CidrBlock String Não 192.168.10.0/28

Bloco CIDR alocado às instâncias de rede.

Cidr String Não 192.168.10.0/24

Bloco CIDR do transit router.

DedicatedOwnerId String Não VPN

Bloco CIDR de uso exclusivo.

Defina o valor como VPN para especificar o bloco CIDR reservado a conexões VPN.

AttachmentId String Não tr-attach-2nalp6yksc805w****

ID da conexão da instância de rede.

AttachmentName String Não nametest

Nome da conexão da instância de rede.

DryRun Boolean Não false

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

  • true: realiza a pré-verificação sem consultar a alocação de endereços IP no bloco CIDR do transit router. O sistema valida os parâmetros obrigatórios, o formato da solicitaçã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 solicitação. Após a aprovação na pré-verificação, o sistema consulta os endereços IP alocados.
MaxResults Integer Não 20

Número de entradas retornadas por página.

  • Se MaxResults não for definido, a consulta não será paginada e o valor de MaxResults representará o total de entradas.
  • Se um valor for especificado para MaxResults, a consulta será paginada. Valores válidos: 1 a 100. Recomendamos definir MaxResults como 20.

    O valor de MaxResults na resposta indica o número de entradas no lote atual.

NextToken String Não FFmyTO70tTpLG6I3FmYAXGKPd****

Token que determina o ponto inicial da consulta. Valores válidos:

  • Ignore este parâmetro na primeira consulta ou quando não houver consultas subsequentes.
  • Para enviar uma consulta subsequente, defina o valor como o NextToken retornado na última chamada.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

Token que determina o ponto inicial da consulta. Valores válidos:

  • A ausência do NextToken indica que não há resultados adicionais.
  • Se a consulta anterior retornou um NextToken, especifique esse valor para obter o próximo conjunto de resultados.
RequestId String 0876E54E-3E36-5C31-89F0-9EE8A9266F9A

ID da solicitação.

TotalCount Integer 1

Número total de entradas retornadas.

MaxResults Integer 1

Número de entradas retornadas por página.

  • Sem a especificação de um valor para MaxResults, os resultados são retornados em um único lote e o valor de MaxResults indica o total de entradas.
  • Com a especificação de um valor para MaxResults, os resultados são retornados em lotes. O valor de MaxResults na resposta indica o número de entradas no lote atual.
TransitRouterCidrAllocations Array of TransitRouterCidrAllocation

Informações sobre os blocos CIDR alocados.

TransitRouterCidrId String cidr-0zv0q9crqpntzz****

ID do bloco CIDR do transit router.

AllocatedCidrBlock String 192.168.10.0/28

Blocos CIDR alocados às instâncias de rede.

AttachmentId String tr-attach-2nalp6yksc805w****

ID da conexão da instância de rede.

Cidr String 192.168.10.0/24

ID do bloco CIDR do transit router.

AttachmentName String nametest

Nome da conexão da instância de rede.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=ListTransitRouterCidrAllocation
&ClientToken=123e4567-e89b-12d3-a456-426****
&TransitRouterId=tr-p0w3x8c9em72a40nw****
&RegionId=ap-southeast-2
&TransitRouterCidrId=cidr-0zv0q9crqpntzz****
&CidrBlock=192.168.10.0/28
&Cidr=192.168.10.0/24
&AttachmentId=tr-attach-2nalp6yksc805w****
&AttachmentName=nametest
&DryRun=false
&MaxResults=20
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<ListTransitRouterCidrAllocationResponse>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <RequestId>0876E54E-3E36-5C31-89F0-9EE8A9266F9A</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>1</MaxResults>
    <TransitRouterCidrAllocations>
        <TransitRouterCidrId>cidr-0zv0q9crqpntzz****</TransitRouterCidrId>
        <AllocatedCidrBlock>192.168.10.0/28</AllocatedCidrBlock>
        <AttachmentId>tr-attach-2nalp6yksc805w****</AttachmentId>
        <Cidr>192.168.10.0/24</Cidr>
        <AttachmentName>nametest</AttachmentName>
    </TransitRouterCidrAllocations>
</ListTransitRouterCidrAllocationResponse>

Formato JSON

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

{
  "RequestId" : "0876E54E-3E36-5C31-89F0-9EE8A9266F9A",
  "TotalCount" : 1,
  "MaxResults" : 1,
  "TransitRouterCidrAllocations" : [ {
    "TransitRouterCidrId" : "cidr-0zv0q9crqpntzz****",
    "AllocatedCidrBlock" : "192.168.10.0/28",
    "AttachmentId" : "tr-attach-2nalp6yksc805w****",
    "Cidr" : "192.168.10.0/24",
    "AttachmentName" : "nametest"
  } ]
}

Códigos de erro

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