Todos os produtos
Search
Central de documentação

Virtual Private Cloud:DescribeVpcAttribute

Última atualização: Jul 07, 2026

Consulta a configuração de uma nuvem privada virtual (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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

VpcId

string

Sim

O ID da VPC que você deseja consultar.

vpc-bp18sth14qii3pnv****

RegionId

string

Sim

O ID da região onde a VPC está implantada.

Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

DryRun

boolean

Não

Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. Valores válidos:

  • true: Realiza apenas um dry run. O sistema verifica a solicitação em busca de possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. O dry run valida apenas o formato da solicitação e as permissões, mas não verifica se o recurso especificado realmente existe. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado.

  • false (padrão): Realiza um dry run e executa a solicitação real. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e a operação será executada.

false

IsDefault

boolean

Não

Especifica se a VPC é a VPC padrão. Valores válidos:

  • false (padrão)

  • true

false

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Hora de criação da VPC.

CreationTime

string

A hora em que a VPC foi criada.

2021-10-16T07:31:09Z

Status

string

O status da VPC. Valores válidos:

  • Available

  • Pending

Available

VpcId

string

O ID da VPC.

vpc-bp18sth14qii3pnvo****

IsDefault

boolean

Indica se a VPC é a VPC padrão. Valores válidos:

  • true

  • false (padrão)

false

ClassicLinkEnabled deprecated

boolean

Indica se o recurso ClassicLink está ativado. Valores válidos:

  • true

  • false (padrão)

false

OwnerId

integer

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

28311773240248****

RegionId

string

O ID da região à qual a VPC pertence.

cn-hangzhou

VpcName

string

O nome da VPC.

doctest2

VRouterId

string

O ID do VRouter que pertence à VPC.

vrt-bp1jso6ng1at0ajsc****

DhcpOptionsSetStatus

string

O status do conjunto de opções DHCP. Valores válidos:

  • Available

  • InUse

  • Deleted

  • Pending

Available

CidrBlock

string

O bloco CIDR IPv4 da VPC.

192.168.0.0/16

RequestId

string

O ID da solicitação.

7486AE4A-129D-43DB-A714-2432C074BA04

Description

string

A descrição da VPC.

VPC

ResourceGroupId

string

O ID do grupo de recursos.

rg-acfmxazbvgb4ph****

DhcpOptionsSetId

string

O ID do conjunto de opções DHCP.

dopt-o6w0df4epg9zo8isy****

Ipv6CidrBlock

string

O bloco CIDR IPv6 da VPC.

2408:XXXX:0:a600::/56

VSwitchIds

object

VSwitchId

array

A lista de vSwitches implantados na VPC.

string

A lista de vSwitches implantados na VPC.

{"VSwitchId": [ "vsw-bp14cagpfysr29feg****" ]}

UserCidrs

object

UserCidr

array

O bloco CIDR do usuário. Vários blocos CIDR são separados por vírgulas (,). No máximo três blocos CIDR são retornados.

string

O bloco CIDR do usuário. Vários blocos CIDR são separados por vírgulas (,). No máximo três blocos CIDR são retornados.

172.16.0.1/24

SecondaryCidrBlocks

object

SecondaryCidrBlock

array

O bloco CIDR IPv4 secundário da VPC.

string

O bloco CIDR IPv4 secundário da VPC.

192.168.0.0/16

AssociatedCens

object

AssociatedCen

array<object>

A lista de instâncias da Cloud Enterprise Network (CEN) às quais a VPC está anexada.

Se a VPC não estiver anexada a uma instância CEN, o parâmetro não será retornado.

object

O ID da conta à qual a Cloud Enterprise Network (CEN) pertence.

CenOwnerId

integer

The ID of the account to which the CEN instance belongs.

28311773240248****

CenId

string

The ID of the CEN instance to which the VPC is attached.

cen-7qthudw0ll6jmc****

CenStatus

string

The status of the CEN instance.

Attached is returned only when the VPC is attached to a CEN instance.

Attached

CloudResources

object

CloudResourceSetType

array<object>

Os recursos na VPC.

object

A contagem de recursos na VPC.

ResourceCount

integer

The number of resources in the VPC.

1

ResourceType

string

The type of resource deployed in the VPC. Valid values: Valid values:

  • VSwitch

  • VRouter

  • RouteTable

VSwitch

Ipv6CidrBlocks

object

Ipv6CidrBlock

array<object>

O bloco CIDR IPv6 da VPC.

object

Ipv6Isp

string

The IPv6 CIDR block type of the VPC. Valid values:

  • BGP (default)

  • ChinaMobile

  • ChinaUnicom

  • ChinaTelecom

Nota

If you are allowed to use single-ISP bandwidth, valid values are ChinaTelecom, ChinaUnicom, and ChinaMobile

BGP

Ipv6CidrBlock

string

The IPv6 CIDR block of the VPC.

2408:XXXX:0:6a::/56

SupportIpv4Gateway

boolean

Indica se a VPC oferece suporte a gateways IPv4.

  • true

  • false

true

Ipv4GatewayId

string

O ID do gateway IPv4.

ipv4gw-5tsnc6s4ogsedtp3k****

Tags

object

Tag

array<object>

As informações sobre as tags.

object

As tags.

Key

string

The key of tag N.

FinanceDept

Value

string

The value of tag N.

FinanceJoshua

AssociatedPropagationSources

object

AssociatedPropagationSources

array<object>

A origem de rota associada à VPC.

object

SourceType

string

The source type.

  • CEN

  • VPN

  • TR

  • ECR

CEN

SourceOwnerId

integer

The account ID of the source.

153980532164****

SourceInstanceId

string

The instance ID of the source.

cen-dc4vwznpwbobrl****

Status

string

The binding status.

  • Attaching

  • Attached

  • Detaching

Attaching

RoutePropagated

boolean

Indicates whether routes are advertised to the VPC.

true

EnabledIpv6

boolean

Indica se o IPv6 está ativado na VPC.

  • true

  • false

Valores válidos:

  • false :

    false.

  • true :

    true.

false

DnsHostnameStatus

string

Indica se o nome de host DNS está ativado.

DISABLED

Exemplos

Resposta de sucesso

JSON formato

{
  "CreationTime": "2021-10-16T07:31:09Z",
  "Status": "Available",
  "VpcId": "vpc-bp18sth14qii3pnvo****",
  "IsDefault": false,
  "ClassicLinkEnabled": false,
  "OwnerId": 0,
  "RegionId": "cn-hangzhou",
  "VpcName": "doctest2",
  "VRouterId": "vrt-bp1jso6ng1at0ajsc****",
  "DhcpOptionsSetStatus": "Available",
  "CidrBlock": "192.168.0.0/16",
  "RequestId": "7486AE4A-129D-43DB-A714-2432C074BA04",
  "Description": "VPC",
  "ResourceGroupId": "rg-acfmxazbvgb4ph****",
  "DhcpOptionsSetId": "dopt-o6w0df4epg9zo8isy****",
  "Ipv6CidrBlock": "2408:XXXX:0:a600::/56",
  "VSwitchIds": {
    "VSwitchId": [
      "{\"VSwitchId\": [ \"vsw-bp14cagpfysr29feg****\" ]}"
    ]
  },
  "UserCidrs": {
    "UserCidr": [
      "172.16.0.1/24"
    ]
  },
  "SecondaryCidrBlocks": {
    "SecondaryCidrBlock": [
      "192.168.0.0/16"
    ]
  },
  "AssociatedCens": {
    "AssociatedCen": [
      {
        "CenOwnerId": 0,
        "CenId": "cen-7qthudw0ll6jmc****",
        "CenStatus": "Attached"
      }
    ]
  },
  "CloudResources": {
    "CloudResourceSetType": [
      {
        "ResourceCount": 1,
        "ResourceType": "VSwitch"
      }
    ]
  },
  "Ipv6CidrBlocks": {
    "Ipv6CidrBlock": [
      {
        "Ipv6Isp": "BGP",
        "Ipv6CidrBlock": "2408:XXXX:0:6a::/56"
      }
    ]
  },
  "SupportIpv4Gateway": true,
  "Ipv4GatewayId": "ipv4gw-5tsnc6s4ogsedtp3k****",
  "Tags": {
    "Tag": [
      {
        "Key": "FinanceDept",
        "Value": "FinanceJoshua"
      }
    ]
  },
  "AssociatedPropagationSources": {
    "AssociatedPropagationSources": [
      {
        "SourceType": "CEN",
        "SourceOwnerId": 0,
        "SourceInstanceId": "cen-dc4vwznpwbobrl****",
        "Status": "Attaching",
        "RoutePropagated": true
      }
    ]
  },
  "EnabledIpv6": false,
  "DnsHostnameStatus": "DISABLED"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 IncorrectVpcStatus Current VPC status does not support this operation.
400 Forbidden.VpcNotFound Specified VPC does not exist.
500 InternalError The request processing has failed due to some unknown error.
404 InvalidVpcId.NotFound Specified VPC does not exist.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.