ListVpcPeerConnections - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Consulta os detalhes das conexões de peering de VPC.

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

vpc:ListVpcPeerConnections

list

*VpcPeer

acs:vpc:*:{#AccountId}:vpcpeer/{#InstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região da conexão de peering de VPC que você deseja consultar. Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.	cn-hangzhou
InstanceId	string	Não	O ID da instância da conexão de peering de VPC que você deseja consultar.	pcc-lnk0m24khwvtkm****
VpcId	array	Não	Filtra os resultados pelos IDs de VPC do iniciador e do aceitador. O filtro não faz distinção entre o iniciador e o aceitador. Se você especificar apenas um ID de VPC, os resultados serão filtrados com base no ID de VPC especificado.
	string	Não	O ID da instância do VPC iniciador ou aceitador da conexão de peering de VPC que você deseja consultar.	vpc-bp1gsk7h12ew7oegk****
Name	string	Não	O nome da conexão de peering de VPC que você deseja consultar.	vpcpeer
NextToken	string	Não	O token usado para recuperar a próxima página de resultados. Valores válidos: Se esta for sua primeira solicitação ou se nenhuma solicitação subsequente for enviada, deixe este parâmetro vazio. Se uma solicitação subsequente for enviada, defina o valor como o valor de NextToken retornado da última chamada de API.	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	Não	O número de entradas a serem retornadas em cada página. Valores válidos: 1 a 100. Valor padrão: 20.	20
Tags	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag. Você pode especificar até 20 chaves de tag. Se você especificar este parâmetro, ele não poderá ser uma string vazia. Uma chave de tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag. Você pode especificar até 20 valores de tag. Se você especificar este parâmetro, ele poderá ser uma string vazia. Um valor de tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	FinanceJoshua
ResourceGroupId	string	Não	O ID do grupo de recursos. Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos.	rg-acfmxazb4ph6aiy****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
MaxResults	integer	O número de entradas a serem retornadas em cada página. Valores válidos: 1 a 100. Valor padrão: 20.	20
NextToken	string	O token usado para recuperar a próxima página de resultados. Valores válidos: Se NextToken estiver vazio, nenhuma solicitação subsequente será enviada. Se NextToken for retornado, o valor indica o token usado para iniciar a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED39DCAC0
TotalCount	integer	O número total de entradas retornadas.	1
VpcPeerConnects	array<object>	Os detalhes das conexões de peering de VPC consultadas.
	array<object>	Os detalhes de uma conexão de peering de VPC consultada.
AcceptingOwnerUid	integer	O ID da conta Alibaba Cloud do aceitador da conexão de peering de VPC.	25346073170691****
AcceptingRegionId	string	O ID da região do aceitador da conexão de peering de VPC.	cn-hangzhou
AcceptingVpc	object	Os detalhes da instância conectada à VPC do aceitador.
Ipv4Cidrs	array	Os blocos CIDR IPv4 do aceitador.
	string	Os blocos CIDR IPv4 do aceitador.	10.0.0.0/16
Ipv6Cidrs	array	Os blocos CIDR IPv6 do aceitador.
	string	Os blocos CIDR IPv6 do aceitador.	2408:XXXX:3b8:3a00::/56
VpcId	string	O ID da instância conectada à VPC do aceitador.	vpc-bp1vzjkp2q1xgnind****
Bandwidth	integer	A largura de banda da conexão de peering de VPC. Unidade: Mbit/s. O valor deve ser um número inteiro maior que 0. Nota Um valor de -1 indica que nenhum limite de largura de banda é aplicado. Valores padrão: A largura de banda padrão de uma conexão de peering de VPC entre regiões é de 1024 Mbit/s. A largura de banda padrão de uma conexão de peering de VPC intrarregional é de -1 Mbit/s, o que indica que nenhum limite de largura de banda é aplicado.	1024
BizStatus	string	O status de faturamento da conexão de peering de VPC. Valores válidos: Normal: Normal. FinancialLocked: Bloqueado devido a pagamento em atraso.	Normal
Description	string	A descrição da conexão de peering de VPC.	test
EnableJumboFrame	boolean	Indica se o recurso de jumbo frame está ativado para a conexão de peering de VPC. Valores válidos: true: Ativado. false: Desativado.	true
GmtCreate	string	A hora em que a conexão de peering de VPC foi criada. A hora é exibida em UTC no formato `YYYY-MM-DDThh:mm:ssZ`.	2022-04-24T09:02:36Z
GmtExpired	string	O horário de expiração da conexão de peering de VPC. O horário é exibido em UTC no formato `YYYY-MM-DDThh:mm:ssZ`. O horário de expiração específico é retornado apenas quando o Status da conexão de peering de VPC é Accepting ou Expired. Se a conexão de peering de VPC estiver em outros estados, null será retornado.	2022-05-01T09:02:36Z
GmtModified	string	A hora em que a conexão de peering de VPC foi modificada. A hora é exibida em UTC no formato `YYYY-MM-DDThh:mm:ssZ`.	2022-04-24T19:20:45Z
InstanceId	string	O ID da instância da conexão de peering de VPC.	pcc-lnk0m24khwvtkm****
LinkType	string	O tipo de link da conexão de peering de VPC. Valores padrão: O tipo de link padrão de uma conexão de peering de VPC entre regiões é Gold. O tipo de link padrão de uma conexão de peering de VPC intrarregional é vazio.	Gold
ManagedService	string	O serviço de nuvem associado.	SWAS
Name	string	O nome da conexão de peering de VPC.	vpcpeer
OwnerId	integer	O ID da conta Alibaba Cloud do iniciador da conexão de peering de VPC.	25346073170691****
RegionId	string	O ID da região do iniciador da conexão de peering de VPC.	cn-hangzhou
ResourceGroupId	string	O ID do grupo de recursos.	rg-acfmxazb4ph6aiy****
Status	string	O status da conexão de peering de VPC. Valores válidos: Creating: Criando. Accepting: Aceitando. Updating: Atualizando. Rejected: Rejeitado. Expired: Expirado. Activated: Ativado. Deleting: Excluindo. Deleted: Excluído. Para obter mais informações sobre os status das conexões de peering de VPC, consulte Visão geral da conexão de peering de VPC.	Activated
Tags	array<object>	A lista de tags.
	object	A lista de tags.
Key	string	A chave da tag.	FinanceDept
Value	string	O valor da tag.	FinanceJoshua
Vpc	object	Os detalhes da instância conectada à VPC do iniciador.
Ipv4Cidrs	array	Os blocos CIDR IPv4 do iniciador.
	string	Os blocos CIDR IPv4 do iniciador.	192.168.0.0/16
Ipv6Cidrs	array	Os blocos CIDR IPv6 do iniciador.
	string	Os blocos CIDR IPv6 do iniciador.	2408:XXXX:3c5:6e00::/56
VpcId	string	O ID da instância conectada à VPC do iniciador.	vpc-bp1gsk7h12ew7oegk****

Exemplos

Resposta de sucesso

JSON formato

{
  "MaxResults": 20,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED39DCAC0",
  "TotalCount": 1,
  "VpcPeerConnects": [
    {
      "AcceptingOwnerUid": 0,
      "AcceptingRegionId": "cn-hangzhou",
      "AcceptingVpc": {
        "Ipv4Cidrs": [
          "10.0.0.0/16"
        ],
        "Ipv6Cidrs": [
          "2408:XXXX:3b8:3a00::/56"
        ],
        "VpcId": "vpc-bp1vzjkp2q1xgnind****"
      },
      "Bandwidth": 1024,
      "BizStatus": "Normal",
      "Description": "test",
      "EnableJumboFrame": true,
      "GmtCreate": "2022-04-24T09:02:36Z",
      "GmtExpired": "2022-05-01T09:02:36Z",
      "GmtModified": "2022-04-24T19:20:45Z",
      "InstanceId": "pcc-lnk0m24khwvtkm****",
      "LinkType": "Gold",
      "ManagedService": "SWAS",
      "Name": "vpcpeer",
      "OwnerId": 0,
      "RegionId": "cn-hangzhou",
      "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
      "Status": "Activated",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ],
      "Vpc": {
        "Ipv4Cidrs": [
          "192.168.0.0/16"
        ],
        "Ipv6Cidrs": [
          "2408:XXXX:3c5:6e00::/56"
        ],
        "VpcId": "vpc-bp1gsk7h12ew7oegk****"
      }
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.