Todos los productos
Search
Centro de documentos

:DescribeVpcAttribute

Última actualización: Aug 26, 2026

Consulta la información detallada de una virtual private cloud (VPC).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíDescribeVpcAttribute

La operación que desea ejecutar. Establezca el valor en DescribeVpcAttribute.

VpcIdStringSívpc-bp18sth14qii3pnv****

El ID de la VPC que desea consultar.

RegionIdStringSícn-hangzhou

El ID de región de la VPC.

Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.

DryRunBooleanNofalse

Especifica si se debe realizar solo una prueba en seco, sin ejecutar la solicitud real. Valores válidos:

  • true: realiza solo una prueba en seco. El sistema comprueba la solicitud en busca de posibles problemas, incluidos valores de parámetros faltantes, sintaxis de solicitud incorrecta y límites de servicio. Si la solicitud no supera la prueba en seco, se devuelve un mensaje de error. Si la solicitud supera la prueba en seco, se devuelve el código de error DryRunOperation.
  • false (predeterminado): realiza una prueba en seco y ejecuta la solicitud real. Si la solicitud supera la prueba en seco, se devuelve un código de estado HTTP 2xx y se ejecuta la operación.
IsDefaultBooleanNofalse

Especifica si la VPC es la VPC predeterminada. Valores válidos:

  • false (predeterminado)
  • true

Parámetros de respuesta

ParámetroTipoEjemploDescripción
CreationTimeString2021-10-16T07:31:09Z

La hora en que se creó la VPC.

StatusStringAvailable

El estado de la VPC. Valores válidos:

  • Available
  • Pending
VpcIdStringvpc-bp18sth14qii3pnvo****

El ID de la VPC.

IsDefaultBooleanfalse

Indica si la VPC es la VPC predeterminada. Valores válidos:

  • true
  • false (predeterminado): no
ClassicLinkEnabledBooleanfalse

Indica si la función ClassicLink está habilitada. Valores válidos:

  • true
  • false (predeterminado)
OwnerIdLong283117732402483989

El ID de la cuenta de Alibaba Cloud a la que pertenece la VPC.

RegionIdStringcn-hangzhou

El ID de región de la VPC.

VpcNameStringdoctest2

El nombre de la VPC.

VRouterIdStringvrt-bp1jso6ng1at0ajsc****

El ID del vRouter que pertenece a la VPC.

DhcpOptionsSetStatusStringAvailable

El estado del conjunto de opciones DHCP. Valores válidos:

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

El bloque CIDR IPv4 de la VPC.

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

El ID de la solicitud.

DescriptionStringVPC

La descripción de la VPC.

ResourceGroupIdStringrg-acfmxazbvgb4ph****

El ID del resource group.

DhcpOptionsSetIdStringdopt-o6w0df4epg9zo8isy****

El ID del conjunto de opciones DHCP.

Ipv6CidrBlockString2408:XXXX:0:a600::/56

El bloque CIDR IPv6 de la VPC.

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

La lista de vSwitches desplegados en la VPC.

UserCidrsArray of String172.16.0.1/24

El bloque CIDR de usuario. Los bloques CIDR múltiples se separan con comas (,). Se devuelven como máximo tres bloques CIDR.

SecondaryCidrBlocksArray of String192.168.0.0/16

El bloque CIDR IPv4 secundario de la VPC.

AssociatedCensArray of AssociatedCen

La lista de instancias de Cloud Enterprise Network (CEN) a las que está conectada la VPC.

Si la VPC no está conectada a una instancia de CEN, no se devuelve el parámetro.

AssociatedCen
CenOwnerIdLong283117732402483989

El ID de la cuenta de Alibaba Cloud a la que pertenece la instancia de CEN.

CenIdStringcen-7qthudw0ll6jmc****

El ID de la instancia de CEN a la que está conectada la VPC.

CenStatusStringAttached

El estado de la instancia de CEN a la que está conectada la VPC.

Se devuelve Attached solo si la VPC está conectada a una instancia de CEN.

CloudResourcesArray of CloudResourceSetType

La lista de recursos desplegados en la VPC.

CloudResourceSetType
ResourceCountInteger1

El número de recursos desplegados en la VPC.

ResourceTypeStringVSwitch

El tipo de recursos desplegados en la VPC. Valores válidos:

  • VSwitch
  • VRouter
  • RouteTable
Ipv6CidrBlocksArray of Ipv6CidrBlock

El bloque CIDR IPv6 de la VPC.

Ipv6CidrBlock
Ipv6IspStringBGP

El proveedor de servicios de Internet (ISP) para las direcciones IPv6 de la VPC. Valores válidos:

  • BGP (predeterminado): Border Gateway Protocol (BGP) de Alibaba Cloud
  • ChinaMobile: China Mobile (ISP único)
  • ChinaUnicom: China Unicom (ISP único)
  • ChinaTelecom: China Telecom (ISP único)
Nota Si su cuenta de Alibaba Cloud tiene permiso para usar ancho de banda de ISP único, los valores válidos son: ChinaTelecom, ChinaUnicom y ChinaMobile.
Ipv6CidrBlockString2408:XXXX:0:6a::/56

El bloque CIDR IPv6 de la VPC.

SupportIpv4GatewayBooleantrue

Indica si la VPC admite puertas de enlace IPv4.

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

El ID de la puerta de enlace IPv4.

TagsArray of Tag

La lista de etiquetas.

Tag
KeyStringFinanceDept

La clave de la etiqueta.

ValueStringFinanceJoshua

El valor de la etiqueta.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

HttpCode

Código de error

Mensaje de error

Descripción

400

IncorrectVpcStatus

Current VPC status does not support this operation.

Esta operación no se puede ejecutar cuando la VPC se encuentra en el estado actual.

404

InvalidVpcId.NotFound

Specified VPC does not exist.

La VPC no existe.

500

InternalError

The request processing has failed due to some unknown error.

Ocurrieron errores desconocidos.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.