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

Consulta as informações de conexão de roteadores de borda virtuais (VBRs) em um roteador de trânsito Enterprise Edition, incluindo o número total de entradas, status da conexão, IDs de conexão e pagadores das instâncias de rede.

Descrição da operação

Você pode consultar informações sobre conexões de roteador de borda virtual (VBR) em um roteador de trânsito Enterprise Edition das seguintes maneiras:

Consulte informações sobre todas as conexões VBR em um roteador de trânsito Enterprise Edition especificando o ID da instância do roteador de trânsito.
Consulte informações sobre todas as conexões VBR em um roteador de trânsito Enterprise Edition especificando o ID da instância da Cloud Enterprise Network (CEN) e o ID da região da instância do roteador de trânsito.
Consulte informações sobre uma conexão VBR especificando apenas o parâmetro TransitRouterAttachmentId.

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

list

CenInstance

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

TransitRouterVbrAttachment

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

TransitRouterVbrAttachment

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 CEN.	cen-j3jzhw1zpau2km****
RegionId	string	Não	O ID da região da instância do roteador de trânsito Enterprise Edition. Você pode chamar DescribeRegions para consultar o ID da região.	cn-hangzhou
TransitRouterAttachmentId	string	Não	O ID da conexão VBR.	tr-attach-oyf70wfuorwx87****
TransitRouterId	string	Não	O ID da instância de roteamento de encaminhamento Enterprise Edition.	tr-bp1su1ytdxtataupl****
MaxResults	integer	Não	O número máximo de entradas a serem retornadas por página. Valor padrão: 20.	20
NextToken	string	Não	O token que determina o ponto inicial da consulta. Valores válidos: Se esta for a primeira consulta ou nenhuma consulta subsequente for enviada, você não precisa especificar este parâmetro. Se uma consulta subsequente for enviada, defina o valor como o valor NextToken retornado pela chamada de API anterior.	dd20****
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. A chave da tag 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 ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`. Cada chave de tag corresponde a um valor de tag. Você pode especificar até 20 valores de tag por vez.	tagtest

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
NextToken	string	O token que determina o ponto inicial da consulta. Valores válidos: Se esta for a primeira consulta ou nenhuma consulta subsequente for enviada, você não precisa especificar este parâmetro. Se uma consulta subsequente for enviada, defina o valor como o valor NextToken retornado pela chamada de API anterior.	dd20****
RequestId	string	O ID da solicitação.	F42D9616-29EB-4E75-8CA8-9654D4E07501
TotalCount	integer	O número total de entradas retornadas.	1
MaxResults	integer	O número máximo de entradas retornadas por página.	20
TransitRouterAttachments	array<object>	A lista de conexões VBR.
	array<object>
CreationTime	string	A hora em que a conexão VBR foi criada. A hora é exibida no padrão ISO 8601 em UTC. Formato: AAAA-MM-DDThh:mmZ.	2021-06-15T15:20Z
Status	string	O status da conexão VBR. Valores válidos: Attached: A conexão VBR está anexada. Attaching: A conexão VBR está sendo anexada. Detaching: A conexão VBR está sendo desanexada.	Attached
TransitRouterAttachmentId	string	O ID da conexão VBR.	tr-attach-oyf70wfuorwx87****
TransitRouterId	string	O ID da instância de roteamento de encaminhamento Enterprise Edition.	tr-bp1su1ytdxtataupl****
ResourceType	string	O tipo de recurso ao qual a conexão pertence. O valor é VBR, que indica uma instância de roteador de borda virtual.	VBR
VbrRegionId	string	O ID da região da instância VBR.	cn-hangzhou
TransitRouterAttachmentDescription	string	A descrição da conexão VBR.	testdesc
VbrOwnerId	integer	O ID da conta à qual a instância VBR pertence.	1688111111111111
AutoPublishRouteEnabled	boolean	Indica se o roteamento de encaminhamento Enterprise Edition publica automaticamente entradas de rota na instância VBR. Valores válidos: false: O roteamento de encaminhamento Enterprise Edition não publica automaticamente entradas de rota na instância VBR. true: O roteamento de encaminhamento Enterprise Edition publica automaticamente entradas de rota na instância VBR.	false
VbrId	string	O ID da instância VBR.	vbr-bp1svadp4lq38janc****
TransitRouterAttachmentName	string	O nome da conexão VBR.	testa
Tags	array<object>	A lista de tags.
	object
Key	string	A chave da tag.	test
Value	string	O valor da tag.	value_A1
CenId	string	O ID da instância CEN.	cen-j3jzhw1zpau2km****
ManagedService	string	O serviço em nuvem que gerencia a conexão VBR. Este parâmetro é retornado apenas quando a conexão VBR é gerenciada por um serviço em nuvem. O código padrão do serviço em nuvem é retornado. Se a conexão VBR for gerenciada por você, este parâmetro não será retornado.
OrderType	string	O pagador da instância de rede. Valores válidos: PayByCenOwner: A taxa de conexão e a taxa de processamento de dados da instância VBR são pagas pela conta à qual a instância do roteador de trânsito pertence. PayByResourceOwner: A taxa de conexão e a taxa de processamento de dados da instância VBR são pagas pela conta à qual a instância VBR pertence.	PayByCenOwner

Exemplos

Resposta de sucesso

JSON formato

{
  "NextToken": "dd20****",
  "RequestId": "F42D9616-29EB-4E75-8CA8-9654D4E07501",
  "TotalCount": 1,
  "MaxResults": 20,
  "TransitRouterAttachments": [
    {
      "CreationTime": "2021-06-15T15:20Z",
      "Status": "Attached",
      "TransitRouterAttachmentId": "tr-attach-oyf70wfuorwx87****",
      "TransitRouterId": "tr-bp1su1ytdxtataupl****",
      "ResourceType": "VBR",
      "VbrRegionId": "cn-hangzhou",
      "TransitRouterAttachmentDescription": "testdesc",
      "VbrOwnerId": 1688111111111111,
      "AutoPublishRouteEnabled": false,
      "VbrId": "vbr-bp1svadp4lq38janc****",
      "TransitRouterAttachmentName": "testa",
      "Tags": [
        {
          "Key": "test",
          "Value": "value_A1"
        }
      ],
      "CenId": "cen-j3jzhw1zpau2km****",
      "ManagedService": "",
      "OrderType": "PayByCenOwner"
    }
  ]
}

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 especificado na solicitação é inválido.
400	IllegalParam.TrInstance	The specified TransitRouter is invalid.	O parâmetro TransitRouterId ou RegionId é inválido.
400	IllegalParam.Region	The specified Region is invalid.	A Region especificada na solicitação é inválida.
400	IllegalParam.CenId	The specified CenId is invalid.	O cenId especificado é inválido.
400	IllegalParam.TransitRouterId	The specified TransitRouterId is invalid.	O parâmetro TransitRouterId ou RegionId é inválido.
400	IllegalParam.CenIdOrRegionId	The specified CenId or RegionId is invalid.	O CenId ou RegionId especificado é inválido.
400	IllegalParam.MaxResults	The specified MaxResults is illegal.	O valor de MaxResults é inválido.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.