Tous les produits
Search
Centre de documentation

:DescribeVpcAttribute

Dernière mise à jour :Aug 18, 2026

Récupère les informations détaillées d’un réseau privé virtuel (VPC).

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d’appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

ParamètreTypeObligatoireExempleDescription
ActionStringOuiDescribeVpcAttribute

Opération à effectuer. Définissez la valeur sur DescribeVpcAttribute.

VpcIdStringOuivpc-bp18sth14qii3pnv****

ID du VPC à interroger.

RegionIdStringOuicn-hangzhou

ID de région du VPC.

Appelez l’opération DescribeRegions pour obtenir la liste des régions la plus récente.

DryRunBooleanNonfalse

Indique s’il faut effectuer une vérification préalable sans exécuter la requête réelle. Valeurs possibles :

  • true : effectue uniquement une vérification préalable. Le système vérifie la requête pour détecter d’éventuels problèmes, tels que des paramètres manquants, une syntaxe incorrecte ou le dépassement des limites de service. En cas d’échec, un message d’erreur est renvoyé. En cas de succès, le code d’erreur DryRunOperation est renvoyé.
  • false (valeur par défaut) : effectue une vérification préalable puis exécute la requête réelle. Si la vérification réussit, un code d’état HTTP 2xx est renvoyé et l’opération est exécutée.
IsDefaultBooleanNonfalse

Indique si le VPC est le VPC par défaut. Valeurs possibles :

  • false (valeur par défaut)
  • true

Paramètres de réponse

ParamètreTypeExempleDescription
CreationTimeString2021-10-16T07:31:09Z

Date et heure de création du VPC.

StatusStringAvailable

État du VPC. Valeurs possibles :

  • Available
  • Pending
VpcIdStringvpc-bp18sth14qii3pnvo****

ID du VPC.

IsDefaultBooleanfalse

Indique si le VPC est le VPC par défaut. Valeurs possibles :

  • true
  • false (valeur par défaut) : non
ClassicLinkEnabledBooleanfalse

Indique si la fonctionnalité ClassicLink est activée. Valeurs possibles :

  • true
  • false (valeur par défaut)
OwnerIdLong283117732402483989

ID du compte Alibaba Cloud propriétaire du VPC.

RegionIdStringcn-hangzhou

ID de région du VPC.

VpcNameStringdoctest2

Nom du VPC.

VRouterIdStringvrt-bp1jso6ng1at0ajsc****

ID du vRouter associé au VPC.

DhcpOptionsSetStatusStringAvailable

État de l’ensemble d’options DHCP. Valeurs possibles :

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

Bloc CIDR IPv4 du VPC.

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

ID de la requête.

DescriptionStringVPC

Description du VPC.

ResourceGroupIdStringrg-acfmxazbvgb4ph****

ID du groupe de ressources.

DhcpOptionsSetIdStringdopt-o6w0df4epg9zo8isy****

ID de l’ensemble d’options DHCP.

Ipv6CidrBlockString2408:XXXX:0:a600::/56

Bloc CIDR IPv6 du VPC.

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

Liste des vSwitch déployés dans le VPC.

UserCidrsArray of String172.16.0.1/24

Bloc CIDR utilisateur. Les blocs CIDR multiples sont séparés par des virgules (,). Au maximum trois blocs CIDR sont renvoyés.

SecondaryCidrBlocksArray of String192.168.0.0/16

Bloc CIDR IPv4 secondaire du VPC.

AssociatedCensArray of AssociatedCen

Liste des instances Cloud Enterprise Network (CEN) auxquelles le VPC est attaché.

Si le VPC n’est attaché à aucune instance CEN, ce paramètre n’est pas renvoyé.

AssociatedCen
CenOwnerIdLong283117732402483989

ID du compte Alibaba Cloud propriétaire de l’instance CEN.

CenIdStringcen-7qthudw0ll6jmc****

ID de l’instance CEN à laquelle le VPC est attaché.

CenStatusStringAttached

État de l’instance CEN à laquelle le VPC est attaché.

La valeur Attached est renvoyée uniquement si le VPC est attaché à une instance CEN.

CloudResourcesArray of CloudResourceSetType

Liste des ressources déployées dans le VPC.

CloudResourceSetType
ResourceCountInteger1

Nombre de ressources déployées dans le VPC.

ResourceTypeStringVSwitch

Type de ressources déployées dans le VPC. Valeurs possibles :

  • VSwitch
  • VRouter
  • RouteTable
Ipv6CidrBlocksArray of Ipv6CidrBlock

Bloc CIDR IPv6 du VPC.

Ipv6CidrBlock
Ipv6IspStringBGP

Fournisseur d’accès Internet (ISP) pour les adresses IPv6 du VPC. Valeurs possibles :

  • BGP (valeur par défaut) : Border Gateway Protocol (BGP) d’Alibaba Cloud
  • ChinaMobile : China Mobile (ISP unique)
  • ChinaUnicom : China Unicom (ISP unique)
  • ChinaTelecom : China Telecom (ISP unique)
Remarque Si votre compte Alibaba Cloud est autorisé à utiliser la bande passante d’un ISP unique, les valeurs valides sont : ChinaTelecom, ChinaUnicom et ChinaMobile.
Ipv6CidrBlockString2408:XXXX:0:6a::/56

Bloc CIDR IPv6 du VPC.

SupportIpv4GatewayBooleantrue

Indique si le VPC prend en charge les passerelles IPv4.

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

ID de la passerelle IPv4.

TagsArray of Tag

Liste des tags.

Tag
KeyStringFinanceDept

Clé du tag.

ValueStringFinanceJoshua

Valeur du tag.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format 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>

Format 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"
  } ]
}

Codes d'erreur

HttpCode Code d'erreur Message d'erreur Description
400 IncorrectVpcStatus Current VPC status does not support this operation. Cette opération ne peut pas être effectuée lorsque le VPC se trouve dans l’état actuel.
404 InvalidVpcId.NotFound Specified VPC does not exist. Le VPC n’existe pas.
500 InternalError The request processing has failed due to some unknown error. Des erreurs inconnues se sont produites.

Pour obtenir la liste des codes d’erreur, consultez les Codes d'erreur de service.