Todos os produtos
Search
Central de documentação

:DescribeVpcAttribute

Última atualização: Jul 03, 2026

Consulta informações detalhadas de uma Virtual Private Cloud (VPC).

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDescribeVpcAttribute

Operação a ser executada. Defina o valor como DescribeVpcAttribute.

VpcIdStringSimvpc-bp18sth14qii3pnv****

ID da VPC a ser consultada.

RegionIdStringSimcn-hangzhou

ID da região da VPC.

Chame a operação DescribeRegions para obter a lista de regiões mais recente.

DryRunBooleanNãofalse

Defina se apenas uma simulação será executada, sem realizar a solicitação real. Valores válidos:

  • true: execute apenas a simulação. O sistema verifica possíveis problemas na solicitação, como valores de parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a simulação falhar, uma mensagem de erro é retornada. Caso contrário, o código de erro DryRunOperation é retornado.
  • false (padrão): execute a simulação e a solicitação real. Se a simulação for bem-sucedida, um código de status HTTP 2xx é retornado e a operação é executada.
IsDefaultBooleanNãofalse

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

  • false (padrão)
  • true

Parâmetros de resposta

ParâmetroTipoExemploDescrição
CreationTimeString2021-10-16T07:31:09Z

Hora de criação da VPC.

StatusStringAvailable

Status da VPC. Valores válidos:

  • Available
  • Pending
VpcIdStringvpc-bp18sth14qii3pnvo****

ID da VPC.

IsDefaultBooleanfalse

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

  • true
  • false (padrão): não
ClassicLinkEnabledBooleanfalse

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

  • true
  • false (padrão)
OwnerIdLong283117732402483989

ID da conta Alibaba Cloud proprietária da VPC.

RegionIdStringcn-hangzhou

ID da região da VPC.

VpcNameStringdoctest2

Nome da VPC.

VRouterIdStringvrt-bp1jso6ng1at0ajsc****

ID do vRouter associado à VPC.

DhcpOptionsSetStatusStringAvailable

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

  • Available
  • InUse
  • Deleted
  • Pending
CidrBlockString192.168.0.0/16

Bloco CIDR IPv4 da VPC.

RequestIdString7486AE4A-129D-43DB-A714-2432C074BA04

ID da solicitação.

DescriptionStringVPC

Descrição da VPC.

ResourceGroupIdStringrg-acfmxazbvgb4ph****

ID do grupo de recursos.

DhcpOptionsSetIdStringdopt-o6w0df4epg9zo8isy****

ID do conjunto de opções DHCP.

Ipv6CidrBlockString2408:XXXX:0:a600::/56

Bloco CIDR IPv6 da VPC.

VSwitchIdsArray of String{"VSwitchId": [ "vsw-bp14cagpfysr29feg****" ]}

Lista de vSwitches implantados na VPC.

UserCidrsArray of String172.16.0.1/24

Bloco CIDR do usuário. Múltiplos blocos CIDR são separados por vírgulas (,). São retornados no máximo três blocos CIDR.

SecondaryCidrBlocksArray of String192.168.0.0/16

Bloco CIDR IPv4 secundário da VPC.

AssociatedCensArray of AssociatedCen

Lista de instâncias da Cloud Enterprise Network (CEN) às quais a VPC está associada.

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

AssociatedCen
CenOwnerIdLong283117732402483989

ID da conta Alibaba Cloud proprietária da instância CEN.

CenIdStringcen-7qthudw0ll6jmc****

ID da instância CEN à qual a VPC está associada.

CenStatusStringAttached

Status da instância CEN à qual a VPC está associada.

Attached é retornado apenas se a VPC estiver associada a uma instância CEN.

CloudResourcesArray of CloudResourceSetType

Lista de recursos implantados na VPC.

CloudResourceSetType
ResourceCountInteger1

Número de recursos implantados na VPC.

ResourceTypeStringVSwitch

Tipo de recursos implantados na VPC. Valores válidos:

  • VSwitch
  • VRouter
  • RouteTable
Ipv6CidrBlocksArray of Ipv6CidrBlock

Bloco CIDR IPv6 da VPC.

Ipv6CidrBlock
Ipv6IspStringBGP

Provedor de serviços de Internet (ISP) para endereços IPv6 da VPC. Valores válidos:

  • BGP (padrão): Border Gateway Protocol (BGP) da Alibaba Cloud
  • ChinaMobile: China Mobile (ISP único)
  • ChinaUnicom: China Unicom (ISP único)
  • ChinaTelecom: China Telecom (ISP único)
Nota Se sua conta Alibaba Cloud tiver permissão para usar largura de banda de ISP único, os valores válidos são: ChinaTelecom, ChinaUnicom e ChinaMobile.
Ipv6CidrBlockString2408:XXXX:0:6a::/56

Bloco CIDR IPv6 da VPC.

SupportIpv4GatewayBooleantrue

Indica se a VPC oferece suporte a gateways IPv4.

  • true
  • false
Ipv4GatewayIdStringipv4gw-5tsnc6s4ogsedtp3k****

ID do gateway IPv4.

TagsArray of Tag

Lista de tags.

Tag
KeyStringFinanceDept

Chave da tag.

ValueStringFinanceJoshua

Valor da tag.

Exemplos

Solicitações de exemplo

http(s)://[Endpoint]/?Action=DescribeVpcAttribute
&VpcId=vpc-bp18sth14qii3pnv****
&RegionId=cn-hangzhou
&DryRun=false
&IsDefault=false
&Common request parameters

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

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

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "CreationTime" : "2021-10-16T07:31:09Z",
  "Status" : "Available",
  "VpcId" : "vpc-bp18sth14qii3pnvo****",
  "IsDefault" : false,
  "ClassicLinkEnabled" : false,
  "OwnerId" : 283117732402484000,
  "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\": [ \"vsw-bp14cagpfysr29feg****\" ]}" ],
  "UserCidrs" : [ "172.16.0.1/24" ],
  "SecondaryCidrBlocks" : [ "192.168.0.0/16" ],
  "AssociatedCens" : [ {
    "CenOwnerId" : 283117732402484000,
    "CenId" : "cen-7qthudw0ll6jmc****",
    "CenStatus" : "Attached"
  } ],
  "CloudResources" : [ {
    "ResourceCount" : 1,
    "ResourceType" : "VSwitch"
  } ],
  "Ipv6CidrBlocks" : [ {
    "Ipv6Isp" : "BGP",
    "Ipv6CidrBlock" : "2408:XXXX:0:6a::/56"
  } ],
  "SupportIpv4Gateway" : true,
  "Ipv4GatewayId" : "ipv4gw-5tsnc6s4ogsedtp3k****",
  "Tags" : [ {
    "Key" : "FinanceDept",
    "Value" : "FinanceJoshua"
  } ]
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

IncorrectVpcStatus

Current VPC status does not support this operation.

Esta operação não pode ser executada quando a VPC está no estado atual.

404

InvalidVpcId.NotFound

Specified VPC does not exist.

A VPC não existe.

500

InternalError

The request processing has failed due to some unknown error.

Ocorreram erros desconhecidos.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.