Todos os produtos
Search
Central de documentação

Virtual Private Cloud:GetVpcPeerConnectionAttribute

Última atualização: Jun 28, 2026

Consulta os atributos de uma conexão de emparelhamento de VPC especificada.

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

get

*PeerConnection

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

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceId

string

Sim

O ID da conexão de emparelhamento de VPC.

pcc-lnk0m24khwvtkm****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O ID da solicitação.

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E

InstanceId

string

O ID da conexão de emparelhamento de VPC.

pcc-lnk0m24khwvtkm****

GmtCreate

string

A hora em que a conexão de emparelhamento de VPC foi criada. A hora é exibida em UTC no formato YYYY-MM-DDThh:mm:ssZ.

2022-04-24T09:02:36Z

GmtModified

string

A hora em que a conexão de emparelhamento de VPC foi modificada pela última vez. A hora é exibida em UTC no formato YYYY-MM-DDThh:mm:ssZ.

2022-04-24T19:20:45Z

Name

string

O nome da conexão de emparelhamento de VPC.

vpcpeer

Description

string

A descrição da conexão de emparelhamento de VPC.

test

OwnerId

integer

O ID da conta Alibaba Cloud à qual a VPC solicitante pertence.

25346073170691****

AcceptingOwnerUid

integer

O ID da conta Alibaba Cloud à qual a VPC aceitante pertence.

28311773240248****

RegionId

string

O ID da região da VPC solicitante.

cn-hangzhou

AcceptingRegionId

string

O ID da região da VPC aceitante.

cn-hangzhou

Bandwidth

integer

A largura de banda da conexão de emparelhamento de VPC. Unidade: Mbps. O valor deve ser um inteiro maior que 0.

Nota

Um valor de -1 indica que nenhum limite é imposto à largura de banda.

Valores padrão:

  • A largura de banda padrão para uma conexão de emparelhamento de VPC entre regiões é 1.024 Mbps.

  • A largura de banda padrão para uma conexão de emparelhamento de VPC dentro da mesma região é -1 Mbps. Isso indica que nenhum limite é imposto à largura de banda.

1024

Status

string

O status da conexão de emparelhamento de VPC. Valores válidos:

  • Creating

  • Accepting

  • Updating

  • Rejected

  • Expired

  • Activated

  • Deleting

  • Deleted

Para mais informações, consulte Visão geral da conexão de emparelhamento de VPC.

Activated

BizStatus

string

O status comercial da conexão de emparelhamento de VPC. Valores válidos:

  • Normal

  • FinancialLocked: A conexão de emparelhamento de VPC está bloqueada devido a um pagamento em atraso.

Normal

GmtExpired

string

A hora em que a conexão de emparelhamento de VPC expira.

Este parâmetro é retornado apenas quando o Status da conexão de emparelhamento de VPC é Accepting ou Expired. Para outros status, o valor retornado é null.

2022-05-01T09:02:36Z

ResourceGroupId

string

O ID do grupo de recursos.

rg-acfmxazb4ph6aiy****

Vpc

object

Os detalhes da VPC solicitante.

VpcId

string

O ID da VPC solicitante.

vpc-bp1gsk7h12ew7oegk****

Ipv4Cidrs

array

Os blocos CIDR IPv4 da VPC solicitante.

string

O bloco CIDR IPv4 da VPC solicitante.

192.168.0.0/16

Ipv6Cidrs

array

Os blocos CIDR IPv6 da VPC solicitante.

string

O bloco CIDR IPv6 da VPC solicitante.

2408:XXXX:3c5:6e00::/56

AcceptingVpc

object

Os detalhes da VPC aceitante.

VpcId

string

O ID da VPC aceitante.

vpc-bp1vzjkp2q1xgnind****

Ipv4Cidrs

array

Os blocos CIDR IPv4 da VPC aceitante.

string

O bloco CIDR IPv4 da VPC aceitante.

10.0.0.0/16

Ipv6Cidrs

array

Os blocos CIDR IPv6 da VPC aceitante.

string

O bloco CIDR IPv6 da VPC aceitante.

2408:XXXX:3b8:3a00::/56

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

LinkType

string

O tipo de link da conexão de emparelhamento de VPC.

Valores padrão:

  • O tipo de link padrão para uma conexão de emparelhamento de VPC entre regiões é Gold.

  • O tipo de link padrão para uma conexão de emparelhamento de VPC dentro da mesma região é vazio.

Gold

ManagedService

string

O serviço Alibaba Cloud ao qual o recurso pertence.

SWAS

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E",
  "InstanceId": "pcc-lnk0m24khwvtkm****",
  "GmtCreate": "2022-04-24T09:02:36Z",
  "GmtModified": "2022-04-24T19:20:45Z",
  "Name": "vpcpeer",
  "Description": "test",
  "OwnerId": 0,
  "AcceptingOwnerUid": 0,
  "RegionId": "cn-hangzhou",
  "AcceptingRegionId": "cn-hangzhou",
  "Bandwidth": 1024,
  "Status": "Activated",
  "BizStatus": "Normal",
  "GmtExpired": "2022-05-01T09:02:36Z",
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
  "Vpc": {
    "VpcId": "vpc-bp1gsk7h12ew7oegk****",
    "Ipv4Cidrs": [
      "192.168.0.0/16"
    ],
    "Ipv6Cidrs": [
      "2408:XXXX:3c5:6e00::/56"
    ]
  },
  "AcceptingVpc": {
    "VpcId": "vpc-bp1vzjkp2q1xgnind****",
    "Ipv4Cidrs": [
      "10.0.0.0/16"
    ],
    "Ipv6Cidrs": [
      "2408:XXXX:3b8:3a00::/56"
    ]
  },
  "Tags": [
    {
      "Key": "FinanceDept",
      "Value": "FinanceJoshua"
    }
  ],
  "LinkType": "Gold",
  "ManagedService": "SWAS"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ResourceNotFound.InstanceId The specified resource of %s is not found. The specified instance is not found

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.