Tüm Ürünler
Search
Belge Merkezi

:DescribeVpcs

Son Güncelleme:Oct 02, 2026

Bir bölgedeki sanal özel bulutları (VPC) sorgular.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parameter Type Required Example Description
Action String Yes DescribeVpcs

Gerçekleştirmek istediğiniz işlem. Değeri DescribeVpcs olarak ayarlayın.

VpcId String No vpc-bp1b1xjllp3ve5yze****

VPC kimliği.

En fazla 20 VPC kimliği belirtebilirsiniz. Birden fazla kimliği virgülle (,) ayırın.

RegionId String Yes cn-hangzhou

VPC'nin bölge kimliği.

En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

VpcName String No Vpc-1

VPC adı.

IsDefault Boolean No false

Belirtilen bölgedeki varsayılan VPC'nin sorgulanıp sorgulanmayacağını belirtir. Geçerli değerler:

  • true (varsayılan)
  • false
DryRun Boolean No false

Gerçek isteği yerine getirmeden yalnızca kuru çalışma yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: Yalnızca kuru çalışma gerçekleştirir. Sistem; eksik parametre değerleri, hatalı istek sözdizimi ve hizmet sınırları dahil olmak üzere olası sorunları kontrol eder. İstek kuru çalışmayı geçemezse bir hata mesajı döndürülür. İstek kuru çalışmayı geçer ise DryRunOperation hata kodu döndürülür.
  • false (varsayılan): Kuru çalışma gerçekleştirir ve gerçek isteği yürütür. İstek kuru çalışmayı geçer ise 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir.
ResourceGroupId String No rg-acfmxvfvazb4p****

Sorgulanacak VPC'nin ait olduğu kaynak grubunun kimliği.

PageNumber Integer No 1

Döndürülecek sayfanın numarası. Varsayılan değer: 1.

PageSize Integer No 10

Her sayfada döndürülecek giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.

VpcOwnerId Long No 253460731706911258

VPC'nin ait olduğu Alibaba Cloud hesabının kimliği.

DhcpOptionsSetId String No dopt-o6w0df4epg9zo8isy****

DHCP seçenekleri kümesinin kimliği.

Tag.N.Key String No FinanceDept

Kaynağa eklenecek N. etiketin anahtarı. En fazla 20 etiket anahtarı belirtebilirsiniz. Etiket anahtarı boş bir dize olamaz.

Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir. aliyun veya acs: ile başlayamaz ve http:// ya da https:// içeremez.

Tag.N.Value String No FinanceJoshua

Kaynağa eklenecek N. etiketin değeri. En fazla 20 etiket değeri belirtebilirsiniz. Etiket değeri boş bir dize olabilir.

Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve http:// ya da https:// içeremez. Etiket değeri aliyun veya acs: ile başlayamaz.

Yanıt parametreleri

Parameter Type Example Description
PageSize Integer 10

Sayfa başına düşen giriş sayısı.

RequestId String C6532AA8-D0F7-497F-A8EE-094126D441F5

İstek kimliği.

PageNumber Integer 1

Döndürülen sayfanın numarası.

TotalCount Integer 2

Döndürülen toplam giriş sayısı.

Vpcs Array of Vpc

VPC'lerin ayrıntıları.

Vpc
CreationTime String 2021-04-18T15:02:37Z

VPC'nin oluşturulma zamanı.

Status String Available

VPC durumu. Geçerli değerler:

  • Pending
  • Available
VpcId String vpc-bp1qpo0kug3a20qqe****

VPC kimliği.

IsDefault Boolean false

VPC'nin bölgedeki varsayılan VPC olup olmadığını gösterir. Geçerli değerler:

  • true
  • false
OwnerId Long 253460731706911258

VPC'nin ait olduğu Alibaba Cloud hesabının kimliği.

RegionId String cn-hangzhou

VPC'nin bölge kimliği.

VpcName String vpc1

VPC adı.

VRouterId String vrt-bp1jcg5cmxjbl9xgc****

Sanal yönlendirici kimliği.

DhcpOptionsSetStatus String Available

DHCP seçenekleri kümesinin durumu. Geçerli değerler:

  • Available
  • InUse
  • Deleted
  • Pending
CidrBlock String 192.168.0.0/16

VPC'nin IPv4 CIDR bloğu.

Description String This is my VPC.

VPC açıklaması.

ResourceGroupId String rg-acfmxazb4ph****

VPC'nin ait olduğu kaynak grubunun kimliği.

DhcpOptionsSetId String dopt-o6w0df4epg9zo8isy****

DHCP seçenekleri kümesinin kimliği.

Ipv6CidrBlock String 2408:XXXX:0:a600::/56

VPC'nin IPv6 CIDR bloğu.

CenStatus String Attached

VPC'nin bağlı olduğu Cloud Enterprise Network (CEN) örneğinin durumu.

Attached yalnızca VPC bir CEN örneğiyle ilişkilendirildiğinde döndürülür.

Tags Array of Tag

VPC ile ilgili etiket bilgileri.

Tag
Key String env

N. etiketin anahtarı.

Value String internal

N. etiketin değeri.

Ipv6CidrBlocks Array of Ipv6CidrBlock

VPC'nin IPv6 CIDR blokları.

Ipv6CidrBlock
Ipv6Isp String BGP

VPC'nin IPv6 adresleri için Internet servis sağlayıcısı (ISP). Geçerli değerler:

  • BGP
  • ChinaMobile
  • ChinaUnicom
  • ChinaTelecom
Not Tek ISP bant genişliği kullanmanıza izin veriliyorsa geçerli değerler ChinaTelecom, ChinaUnicom ve ChinaMobile şeklindedir.
Ipv6CidrBlock String 2408:XXXX:0:a600::/56

VPC'nin IPv6 CIDR bloğu.

VSwitchIds Array of String vsw-bp1nhbnpv2blyz8dl****

VPC içindeki vSwitch'ler.

VPC içinde en fazla 300 vSwitch sorgulayabilirsiniz. En yeni vSwitch'lerle ilgili bilgiler döndürülür. Bir VPC'deki tüm vSwitch'lerle ilgili bilgileri sorgulamak istiyorsanız DescribeVSwitches işlemini çağırın.

SecondaryCidrBlocks Array of String 192.168.20.0/24

VPC'nin ikincil CIDR bloğu.

UserCidrs Array of String 10.0.0.0/8

Kullanıcı CIDR bloklarının listesi.

NatGatewayIds Array of String nat-245xxxftwt45bg****

NAT ağ geçidi kimliği.

RouterTableIds Array of String vtb-bp1krxxzp0c29fmon****

Yönlendirme tablosu kimliği.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeVpcs
&VpcId=vpc-bp1b1xjllp3ve5yze****
&RegionId=cn-hangzhou
&VpcName=Vpc-1
&IsDefault=false
&DryRun=false
&ResourceGroupId=rg-acfmxvfvazb4p****
&PageNumber=1
&PageSize=10
&VpcOwnerId=253460731706911258
&DhcpOptionsSetId=dopt-o6w0df4epg9zo8isy****
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Common request parameters

Başarılı yanıt örnekleri

XML formatı

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

<DescribeVpcsResponse>
    <PageSize>10</PageSize>
    <RequestId>C6532AA8-D0F7-497F-A8EE-094126D441F5</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>2</TotalCount>
    <Vpcs>
        <CreationTime>2021-04-18T15:02:37Z</CreationTime>
        <Status>Available</Status>
        <VpcId>vpc-bp1qpo0kug3a20qqe****</VpcId>
        <IsDefault>false</IsDefault>
        <OwnerId>253460731706911260</OwnerId>
        <RegionId>cn-hangzhou</RegionId>
        <VpcName>vpc1</VpcName>
        <VRouterId>vrt-bp1jcg5cmxjbl9xgc****</VRouterId>
        <DhcpOptionsSetStatus>Available</DhcpOptionsSetStatus>
        <CidrBlock>192.168.0.0/16</CidrBlock>
        <Description>This is my VPC.</Description>
        <ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
        <DhcpOptionsSetId>dopt-o6w0df4epg9zo8isy****</DhcpOptionsSetId>
        <Ipv6CidrBlock>2408:XXXX:0:a600::/56</Ipv6CidrBlock>
        <CenStatus>Attached</CenStatus>
        <Tags>
            <Key>env</Key>
            <Value>internal</Value>
        </Tags>
        <Ipv6CidrBlocks>
            <Ipv6Isp>BGP</Ipv6Isp>
            <Ipv6CidrBlock>2408:XXXX:0:a600::/56</Ipv6CidrBlock>
        </Ipv6CidrBlocks>
        <VSwitchIds>vsw-bp1nhbnpv2blyz8dl****</VSwitchIds>
        <SecondaryCidrBlocks>192.168.20.0/24</SecondaryCidrBlocks>
        <UserCidrs>10.0.0.0/8</UserCidrs>
        <NatGatewayIds>nat-245xxxftwt45bg****</NatGatewayIds>
        <RouterTableIds>vtb-bp1krxxzp0c29fmon****</RouterTableIds>
    </Vpcs>
</DescribeVpcsResponse>

JSON formatı

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

{
  "PageSize" : 10,
  "RequestId" : "C6532AA8-D0F7-497F-A8EE-094126D441F5",
  "PageNumber" : 1,
  "TotalCount" : 2,
  "Vpcs" : [ {
    "CreationTime" : "2021-04-18T15:02:37Z",
    "Status" : "Available",
    "VpcId" : "vpc-bp1qpo0kug3a20qqe****",
    "IsDefault" : false,
    "OwnerId" : 253460731706911260,
    "RegionId" : "cn-hangzhou",
    "VpcName" : "vpc1",
    "VRouterId" : "vrt-bp1jcg5cmxjbl9xgc****",
    "DhcpOptionsSetStatus" : "Available",
    "CidrBlock" : "192.168.0.0/16",
    "Description" : "This is my VPC.",
    "ResourceGroupId" : "rg-acfmxazb4ph****",
    "DhcpOptionsSetId" : "dopt-o6w0df4epg9zo8isy****",
    "Ipv6CidrBlock" : "2408:XXXX:0:a600::/56",
    "CenStatus" : "Attached",
    "Tags" : [ {
      "Key" : "env",
      "Value" : "internal"
    } ],
    "Ipv6CidrBlocks" : [ {
      "Ipv6Isp" : "BGP",
      "Ipv6CidrBlock" : "2408:XXXX:0:a600::/56"
    } ],
    "VSwitchIds" : [ "vsw-bp1nhbnpv2blyz8dl****" ],
    "SecondaryCidrBlocks" : [ "192.168.20.0/24" ],
    "UserCidrs" : [ "10.0.0.0/8" ],
    "NatGatewayIds" : [ "nat-245xxxftwt45bg****" ],
    "RouterTableIds" : [ "vtb-bp1krxxzp0c29fmon****" ]
  } ]
}

Hata kodları

HttpCode

Error code

Error message

Description

400

InvalidVpcIdNumber.NotSupported

The number of vpcIds exceeds the limit.

VPC kimliklerinin sayısı sınırı aşıyor.

400

InvalidResourceGroupId

The specified ResourceGroupId does not exist.

Belirtilen kaynak grubu kimliği mevcut değil.

400

InvalidTagKey

The tag keys are not valid.

Etiket anahtarları geçerli değil.

400

InvalidTagValue

The tag values are not valid.

Etiket değerleri geçerli değil.

400

InvalidAccount.NotFound

The account is invalid.

Geçersiz bir hesap kullanıldığından işlem başarısız oldu.

500

InternalError

The request processing has failed due to some unknown error.

Bazı bilinmeyen hatalar oluştu.

Hata kodlarının listesi için bkz. Hizmet hata kodları.