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

Consulta os detalhes das conexões inter-regionais em um roteador de trânsito da Enterprise Edition.

Descrição da operação

Você pode consultar as informações sobre as conexões inter-regionais em um roteador de trânsito da Enterprise Edition das seguintes duas maneiras:

Consulte as informações sobre todas as conexões inter-regionais no roteador de trânsito da Enterprise Edition usando o ID da instância do roteador de trânsito da Enterprise Edition.
Consulte as informações sobre todas as conexões inter-regionais no roteador de trânsito da Enterprise Edition usando o ID da instância da Cloud Enterprise Network (CEN) e o ID da região do roteador de trânsito da Enterprise Edition.

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

get

*CenInstance.

acs:cen:*:{#accountId}:ceninstance/{#ceninstanceId}

TransitRouterPeerAttachment.

acs:cen:*:{#accountId}:centransitrouterattachment/*

TransitRouterPeerAttachment.

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
CenId	string	Não	O ID da instância da Cloud Enterprise Network (CEN). Se você especificar este parâmetro, também deverá especificar RegionId.	cen-j3jzhw1zpau2km****
RegionId	string	Não	O ID da região do roteador de trânsito da Enterprise Edition. Se você especificar este parâmetro, também deverá especificar CenId. Você pode chamar a operação DescribeRegions para consultar os IDs de região.	cn-hangzhou
TransitRouterAttachmentId	string	Não	O ID da conexão inter-regional.	tr-attach-5u4qbayfv2io5v****
TransitRouterId	string	Não	O ID da instância do roteador de trânsito da Enterprise Edition, que é usado para encaminhar tráfego e gerenciar roteamento.	tr-bp1su1ytdxtataupl****
MaxResults	integer	Não	O número de entradas a serem retornadas em cada página. Valor padrão: 20. Valor máximo: 100.	20
NextToken	string	Não	O token usado para a próxima consulta. Valores válidos: Se esta for sua primeira consulta ou se nenhuma próxima consulta for enviada, ignore este parâmetro. Se uma próxima consulta for enviada, defina o valor como o valor de NextToken retornado na última chamada de API.	1
Tag	array<object>	Não	As informações da tag. Você pode especificar até 20 tags por vez.
	object	Não
Key	string	Não	A chave da tag do recurso. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Você pode especificar até 20 chaves de tag por vez.	tagtest
Value	string	Não	O valor da tag do recurso. O valor da tag pode ser uma string vazia ou uma string de até 128 caracteres. Não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`. Cada chave de tag é emparelhada com um valor de tag. Você pode especificar até 20 valores de tag por vez.	tagtest

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O resultado retornado.
NextToken	string	O token usado para a próxima consulta. Valores válidos: Se NextToken estiver vazio, nenhuma próxima consulta será enviada. Se NextToken for retornado, o valor indica o token usado para a próxima consulta.	dd20****
RequestId	string	O ID da solicitação.	AA97AFA3-8E48-4BD7-9F3E-A9F6176018A0
TotalCount	integer	O número total de entradas.	1
MaxResults	integer	O número de entradas retornadas em cada página.	20
TransitRouterAttachments	array<object>	A lista de conexões inter-regionais.
	array<object>	As informações sobre a conexão inter-regional.
CreationTime	string	A hora em que a conexão inter-regional foi criada. A hora segue o padrão ISO 8601 no formato `YYYY-MM-DDThh:mmZ`. A hora é exibida em UTC.	2021-06-16T02:50Z
Status	string	O status da conexão inter-regional. Valores válidos: Attached: A conexão está anexada. Attaching: A conexão está sendo anexada. Detaching: A conexão está sendo desanexada. Detached: A conexão está desanexada.	Attached
TransitRouterAttachmentId	string	O ID da conexão inter-regional.	tr-attach-5u4qbayfv2io5v****
BandwidthType	string	O método de alocação de largura de banda. Valores válidos: BandwidthPackage: A largura de banda é alocada a partir de um plano de largura de banda. DataTransfer: Nenhuma largura de banda é alocada para a conexão inter-regional. Você é cobrado com base na transferência de dados.	BandwidthPackage
CenBandwidthPackageId	string	O ID do plano de largura de banda associado à conexão inter-regional.	cenbwp-3xrxupouolw5ou****
TransitRouterAttachmentDescription	string	A descrição da conexão inter-regional.	testdesc
RegionId	string	O ID da região do roteador de trânsito da Enterprise Edition.	cn-hangzhou
PeerTransitRouterId	string	O ID da instância do roteador de trânsito par, que é usado para encaminhar tráfego e gerenciar roteamento.	tr-m5eq27g6bndum7e88****
TransitRouterId	string	O ID da instância do roteador de trânsito da Enterprise Edition, que é usado para encaminhar tráfego e gerenciar roteamento.	tr-bp1su1ytdxtataupl****
PeerTransitRouterRegionId	string	O ID da região do roteador de trânsito par.	cn-qingdao
ResourceType	string	O tipo do recurso associado à conexão. Valores válidos: VPC: virtual private cloud (VPC). CCN: Cloud Connect Network (CCN). VBR: virtual border router (VBR). TR: roteador de trânsito.	TR
Bandwidth	integer	A largura de banda da conexão inter-regional. Unidade: Mbit/s. Se BandwidthType estiver definido como BandwidthPackage, este parâmetro indica a largura de banda disponível para a conexão inter-regional. Se BandwidthType estiver definido como DataTransfer, este parâmetro indica o limite de largura de banda da conexão inter-regional.	2
GeographicSpanId	string	As áreas conectadas do plano de largura de banda.	china_china
PeerTransitRouterOwnerId	integer	O ID da conta Alibaba Cloud à qual o roteador de trânsito par pertence.	253460731706911258
AutoPublishRouteEnabled	boolean	Especifica se o roteador de trânsito da Enterprise Edition anuncia automaticamente as rotas da conexão inter-regional para a região par. Valores válidos: false (padrão): não. true: sim.	false
TransitRouterAttachmentName	string	O nome da conexão inter-regional.	test
Tags	array<object>	A lista de tags.
	object
Key	string	A chave da tag.	tag_A1
Value	string	O valor da tag.	test
CenId	string	O ID da instância da Cloud Enterprise Network (CEN).	cen-j3jzhw1zpau2km****
DefaultLinkType	string	O tipo de link padrão. Valores válidos: Gold (padrão): ouro. Platinum: platina.	Gold

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "dd20****",
  "RequestId": "AA97AFA3-8E48-4BD7-9F3E-A9F6176018A0",
  "TotalCount": 1,
  "MaxResults": 20,
  "TransitRouterAttachments": [
    {
      "CreationTime": "2021-06-16T02:50Z",
      "Status": "Attached",
      "TransitRouterAttachmentId": "tr-attach-5u4qbayfv2io5v****",
      "BandwidthType": "BandwidthPackage",
      "CenBandwidthPackageId": "cenbwp-3xrxupouolw5ou****",
      "TransitRouterAttachmentDescription": "testdesc",
      "RegionId": "cn-hangzhou",
      "PeerTransitRouterId": "tr-m5eq27g6bndum7e88****",
      "TransitRouterId": "tr-bp1su1ytdxtataupl****",
      "PeerTransitRouterRegionId": "cn-qingdao",
      "ResourceType": "TR",
      "Bandwidth": 2,
      "GeographicSpanId": "china_china",
      "PeerTransitRouterOwnerId": 253460731706911260,
      "AutoPublishRouteEnabled": false,
      "TransitRouterAttachmentName": "test",
      "Tags": [
        {
          "Key": "tag_A1",
          "Value": "test"
        }
      ],
      "CenId": "cen-j3jzhw1zpau2km****",
      "DefaultLinkType": "Gold"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.NextToken	The specified NextToken is invalid.	O NextToken é inválido.
400	IllegalParam.TrInstance	The specified TransitRouter is invalid.	O parâmetro TransitRouterId é inválido.
400	IllegalParam.Region	The specified Region is invalid.	O parâmetro Region especificado é inválido.
400	IllegalParam.CenId	The specified CenId is invalid.	O ID da instância da Cloud Enterprise Network (CEN) é inválido.
400	IllegalParam.TransitRouterId	The specified TransitRouterId is invalid.	O TransitRouterId especificado na solicitação é inválido.
400	IllegalParam.RegionIdOrTransitRouterId	The specified TransitRouterId or RegionId is invalid.	O parâmetro TransitRouterId ou Region especificado é inválido.
400	IllegalParam.CenIdOrRegionId	The specified CenId or RegionId is invalid.	O CenId ou RegionId especificado é inválido.
400	IllegalParam.TagKey	The tag keys are not valid.	A chave da tag especificada na solicitação é inválida.
400	IllegalParam.TagValue	The tag values are not valid.	O valor da tag especificado na solicitação é inválido.
400	IllegalParam.MaxResults	The specified MaxResults is invalid.	O parâmetro MaxResults é inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	Você não tem permissões suficientes para realizar esta operação. Abra um ticket para obter assistência.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.