Bir bölgedeki sanal özel bulutları (VPC) sorgular.
Hata Ayıklama
İ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:
|
| 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:
|
| 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. |
| 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 |
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:
|
| 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:
|
| 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:
|
| 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:
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ı.