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

Observações de uso

Defina os parâmetros RegionId e TransitRouterId conforme necessário.

Sem a definição de RegionId ou TransitRouterId, o sistema consulta todos os transit routers conectados à instância CEN especificada.
Ao definir apenas RegionId, o sistema consulta os transit routers implantados na região especificada.
Ao definir somente TransitRouterId, o sistema consulta o transit router especificado.
Ao definir tanto RegionId quanto TransitRouterId, o sistema consulta o transit router especificado na região indicada.

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	ListTransitRouters	A operação a ser executada. Defina o valor como ListTransitRouters.
PageNumber	Integer	Não	1	O número da página a retornar. Valor padrão: 1.
PageSize	Integer	Não	10	O número de entradas a retornar por página. Valores válidos: 1 a 50. Valor padrão: 10.
CenId	String	Sim	cen-j3jzhw1zpau2km****	O ID da instância CEN.
TransitRouterId	String	Não	tr-uf654ttymmljlvh2x****	O ID do transit router.
RegionId	String	Não	ap-southeast-2	O ID da região onde o transit router está implantado. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
Tag.N.Key	String	Não	TagKey	As chaves de tag dos recursos. As chaves de tag não podem ser strings vazias. Devem ter até 64 caracteres e não podem começar com `acs:` ou `aliyun`. Não podem conter `http://` ou `https://`. Especifique no máximo 20 chaves de tag.
Tag.N.Value	String	Não	TagValue	Os valores de tag dos recursos. Os valores de tag podem ter de 0 a 128 caracteres e não podem começar com `aliyun` ou `acs:`. Não podem conter `http://` ou `https://`. Cada chave de tag possui um valor exclusivo. Especifique no máximo 20 valores de tag por chamada.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	10	O número de entradas retornadas por página.
RequestId	String	68521297-5FA6-46CB-B4EB-658F1C68C8CC	O ID da solicitação.
PageNumber	Integer	1	O número da página retornada.
TotalCount	Integer	1	O número total de entradas retornadas.
TransitRouters	Array of TransitRouter		Lista de transit routers.
CreationTime	String	2021-03-15T09:39Z	Horário de criação do transit router. O horário segue o padrão ISO8601 no formato `YYYY-MM-DDThh:mmZ` e é exibido em UTC.
Type	String	Enterprise	Edição do transit router. Valores válidos: Enterprise: Enhanced Edition Basic: Basic Edition
Status	String	Active	Status do transit router. Valores válidos: Creating: O transit router está sendo criado. Active: O transit router está disponível. Modifying: O transit router está sendo modificado. Deleting: O transit router está sendo excluído. Upgrading: O transit router está sendo atualizado.
TransitRouterId	String	tr-bp1su1ytdxtataupl****	ID do transit router.
TransitRouterDescription	String	testdesc	Descrição do transit router.
TransitRouterName	String	testname	Nome do transit router.
CenId	String	cen-j3jzhw1zpau2km****	ID da instância CEN.
AliUid	Long	1210123456123456	ID da conta Alibaba Cloud proprietária da instância CEN.
RegionId	String	ap-southeast-2	ID da região onde o transit router está implantado.
SupportMulticast	Boolean	false	Indica se o multicast está ativado para o transit router. Valores válidos: true: ativado false: desativado
TransitRouterCidrList	Array of TransitRouterCidrList		Informações sobre o bloco CIDR do transit router.
Cidr	String	192.168.1.0/24	Bloco CIDR do transit router.
Name	String	CIDRname	Nome do bloco CIDR.
Description	String	CIDRdesc	Descrição do bloco CIDR.
TransitRouterCidrId	String	cidr-46p5ceg21e8152****	ID do bloco CIDR.
PublishCidrRoute	Boolean	true	Indica se o sistema adiciona automaticamente o bloco CIDR à tabela de rotas do transit router. true: sim O valor true indica que, após a criação de uma conexão VPN privada e a ativação do aprendizado de rotas para essa conexão, o sistema adiciona automaticamente uma rota blackhole à tabela de rotas do transit router ao qual a conexão VPN está anexada. O bloco CIDR de destino da rota blackhole corresponde ao bloco CIDR do transit router. Esse bloco refere-se ao intervalo de endereços IP de onde são alocados os endereços IP de gateway para as conexões IPsec-VPN. A rota blackhole é anunciada apenas para a tabela de rotas do roteador de borda virtual (VBR) conectado ao transit router. false: não
Tags	Array of Tag		Lista de tags.
Key	String	TagKey	Chave da tag.
Value	String	TagValue	Valor da tag.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=ListTransitRouters
&PageNumber=1
&PageSize=10
&CenId=cen-j3jzhw1zpau2km****
&TransitRouterId=tr-uf654ttymmljlvh2x****
&RegionId=ap-southeast-2
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<ListTransitRoutersResponse>
    <PageSize>10</PageSize>
    <RequestId>68521297-5FA6-46CB-B4EB-658F1C68C8CC</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <TransitRouters>
        <CreationTime>2021-03-15T09:39Z</CreationTime>
        <Type>Enterprise</Type>
        <Status>Active</Status>
        <TransitRouterId>tr-bp1su1ytdxtataupl****</TransitRouterId>
        <TransitRouterDescription>testdesc</TransitRouterDescription>
        <TransitRouterName>testname</TransitRouterName>
        <CenId>cen-j3jzhw1zpau2km****</CenId>
        <AliUid>1210123456123456</AliUid>
        <RegionId>ap-southeast-2</RegionId>
        <SupportMulticast>false</SupportMulticast>
        <TransitRouterCidrList>
            <Cidr>192.168.1.0/24</Cidr>
            <Name>CIDRname</Name>
            <Description>CIDRdesc</Description>
            <TransitRouterCidrId>cidr-46p5ceg21e8152****</TransitRouterCidrId>
            <PublishCidrRoute>true</PublishCidrRoute>
        </TransitRouterCidrList>
    </TransitRouters>
</ListTransitRoutersResponse>

Formato JSON

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

{
  "PageSize" : 10,
  "RequestId" : "68521297-5FA6-46CB-B4EB-658F1C68C8CC",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "TransitRouters" : [ {
    "CreationTime" : "2021-03-15T09:39Z",
    "Type" : "Enterprise",
    "Status" : "Active",
    "TransitRouterId" : "tr-bp1su1ytdxtataupl****",
    "TransitRouterDescription" : "testdesc",
    "TransitRouterName" : "testname",
    "CenId" : "cen-j3jzhw1zpau2km****",
    "AliUid" : 1210123456123456,
    "RegionId" : "ap-southeast-2",
    "SupportMulticast" : false,
    "TransitRouterCidrList" : [ {
      "Cidr" : "192.168.1.0/24",
      "Name" : "CIDRname",
      "Description" : "CIDRdesc",
      "TransitRouterCidrId" : "cidr-46p5ceg21e8152****",
      "PublishCidrRoute" : true
    } ]
  } ]
}

Códigos de erro

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