Tüm Ürünler
Search
Belge Merkezi

:CreateVpc

Son Güncelleme:Oct 02, 2026

Sanal özel cloud (VPC) oluşturur.

Kullanım notları

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

  • Her VPC için yalnızca bir CIDR bloğu belirtebilirsiniz.

  • Bir VPC oluşturduktan sonra CIDR bloğunu değiştiremezsiniz. Ancak, VPC'ye ikincil IPv4 CIDR blokları ekleyebilirsiniz.

  • Her VPC'de cloud hizmetleri en fazla 60.000 özel IP adresi kullanabilir. Bu kotayı artıramazsınız.

  • Bir VPC oluşturduktan sonra sistem otomatik olarak bir vRouter ve bir yönlendirme tablosu oluşturur.

  • Bir VPC'ye en fazla üç kullanıcı CIDR bloğu eklenebilir. Bir kullanıcı CIDR bloğu başka birini kapsıyorsa daha kısa alt ağ maskesine sahip olan blok geçerli olur. Örneğin, hem 10.0.0.0/8 hem de 10.1.0.0/16 belirtilirse yalnızca 10.0.0.0/8 geçerli olur.

  • CreateVpc asenkron bir işlemdir. İstek gönderildikten sonra sistem bir istek kimliği döndürür ve görevi arka planda çalıştırır. Görevin durumunu sorgulamak için DescribeVpcAttribute işlemini çağırabilirsiniz:

    • VPC Creating durumundaysa VPC oluşturuluyor demektir.

    • VPC Created durumundaysa VPC oluşturulmuş demektir.

  • Belirli bir süre içinde varsayılan VPC'ler oluşturmak için DeleteRouteEntry işlemine tekrar tekrar çağrı yapamazsınız. Ancak, aynı süre içinde özel VPC'ler oluşturmak için bu işlemi tekrar tekrar çağırabilirsiniz.

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 işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Zorunlu Örnek Açıklama
Action String Evet CreateVpc

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

RegionId String Evet cn-hangzhou

VPC'nin ait olduğu bölgenin kimliği.

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

CidrBlock String Hayır 172.16.0.0/12

VPC'nin CIDR bloğu.

  • VPC'nin birincil IPv4 CIDR bloğu olarak aşağıdaki CIDR bloklarından birini veya bunların alt kümelerini belirtebilirsiniz: 192.168.0.0/16, 172.16.0.0/12 ve 10.0.0.0/8. Bu CIDR blokları, Request for Comments (RFC) belgelerinde tanımlanan standart özel CIDR bloklarıdır. Alt ağ maskesi 8 ila 28 bit uzunluğunda olmalıdır.
  • VPC'nin birincil IPv4 CIDR bloğu olarak 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16 ve bunların alt ağları dışında özel bir CIDR bloğu da kullanabilirsiniz.
Ipv6CidrBlock String Hayır 2408:XXXX:0:6a::/56

VPC'nin IPv6 CIDR blokları.

VpcName String Hayır abc

VPC'nin adı.

Ad 1 ila 128 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

EnableIpv6 Boolean Hayır false

IPv6'nın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • false (varsayılan)
  • true: evet
Description String Hayır This is my first Vpc

VPC'nin açıklaması.

Açıklama 1 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

ResourceGroupId String Hayır rg-acfmxazb4ph6aiy****

Kaynak grubunun kimliği.

Kaynak grupları hakkında daha fazla bilgi için bkz. What is a resource group?

Tag.N.Key String Hayır 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:// veya https:// içeremez.

Tag.N.Value String Hayır 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:// veya https:// içeremez. Etiket değeri aliyun veya acs: ile başlayamaz.

DryRun Boolean Hayır false

Yalnızca deneme çalıştırması yapılıp yapılmayacağını, gerçek isteğin gerçekleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: yalnızca deneme çalıştırması yapar. Sistem eksik parametre değerleri, hatalı istek sözdizimi ve hizmet sınırları dahil olmak üzere olası sorunlar için isteği kontrol eder. İstek deneme çalıştırmasında başarısız olursa bir hata mesajı döndürülür. İstek deneme çalıştırmasını geçerse DryRunOperation hata kodu döndürülür.
  • false (varsayılan): deneme çalıştırması yapar ve gerçek isteği gerçekleştirir. İstek deneme çalıştırmasını geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir.
UserCidr String Hayır 192.168.0.0/12

Kullanıcı CIDR bloğu. Kullanıcı CIDR bloklarını virgül (,) ile ayırın. En fazla üç kullanıcı CIDR bloğu belirtebilirsiniz.

Kullanıcı CIDR blokları hakkında daha fazla bilgi için VPC FAQ bölümündeki What is a user CIDR block? kısmına bakın.

ClientToken String Hayır 123e4567-e89b-12d3-a456-426655440000

İsteğin yinelenebilirliğini (idempotency) sağlamak için kullanılan istemci belirteci.

Belirteci istemci aracılığıyla oluşturabilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir.

Not Bu parametreyi belirtmezseniz sistem otomatik olarak request ID değerini client token olarak kullanır. request ID her istekte farklı olabilir.
Ipv6Isp String Hayır BGP

VPC'nin IPv6 CIDR bloğunun türü. Geçerli değerler:

  • BGP (varsayılan): Alibaba Cloud Border Gateway Protocol (BGP)
  • ChinaMobile: China Mobile (tek ISP).
  • ChinaUnicom: China Unicom (tek ISP).
  • ChinaTelecom: China Telecom (tek ISP).
Not Alibaba Cloud hesabınız tek ISP bant genişliği kullanmasına izin veriyorsa bu parametreyi ChinaTelecom, ChinaUnicom veya ChinaMobile olarak ayarlayabilirsiniz.
Ipv4IpamPoolId String Hayır ipam-pool-sycmt3p2a9v63i****

IPv4 türündeki IP Address Manager (IPAM) havuzunun kimliği.

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

VpcId

String

vpc-bp15zckdt37pq72zv****

Oluşturulan VPC'nin kimliği.

VRouterId

String

vrt-bp1lhl0taikrteen8****

VPC oluşturulduktan sonra sistem tarafından otomatik olarak oluşturulan vRouter'ın kimliği.

RequestId

String

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

İstek kimliği.

RouteTableId

String

vtb-bp145q7glnuzdv****

VPC oluşturulduktan sonra sistem tarafından otomatik olarak oluşturulan yönlendirme tablosunun kimliği.

ResourceGroupId

String

rg-acfmxazb4ph6aiy****

Kaynak grubunun kimliği.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateVpc
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/12
&Ipv6CidrBlock=2408:XXXX:0:6a::/56
&VpcName=abc
&EnableIpv6=false
&Description=This is my first Vpc
&ResourceGroupId=rg-acfmxazb4ph6aiy****
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&DryRun=false
&UserCidr=192.168.0.0/12
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Ipv6Isp=BGP
&Ipv4IpamPoolId=ipam-pool-sycmt3p2a9v63i****
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<CreateVpcResponse>
    <VpcId>vpc-bp15zckdt37pq72zv****</VpcId>
    <VRouterId>vrt-bp1lhl0taikrteen8****</VRouterId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
    <RouteTableId>vtb-bp145q7glnuzdv****</RouteTableId>
    <ResourceGroupId>rg-acfmxazb4ph6aiy****</ResourceGroupId>
</CreateVpcResponse>

JSON biçimi

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

{
  "VpcId" : "vpc-bp15zckdt37pq72zv****",
  "VRouterId" : "vrt-bp1lhl0taikrteen8****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "RouteTableId" : "vtb-bp145q7glnuzdv****",
  "ResourceGroupId" : "rg-acfmxazb4ph6aiy****"
}

Hata kodları

HttpCode

Hata kodu

Hata mesajı

Açıklama

400

InvalidParameter

Specified CIDR block is not valid

Belirtilen CIDR bloğu geçersiz.

400

ResourceNotAvailable

Resource you requested is not available in this region or zone.

Geçerli bölgede veya alanda bir vSwitch oluşturamazsınız.

400

InvalidVpcName.Malformed

Specified VPC name is not valid.

VPC adının biçimi geçersiz. Geçerli bir VPC adı girin ve tekrar deneyin.

400

InvalidVpcDiscription.Malformed

Specified VPC description is not valid.

VPC açıklamasının biçimi geçersiz.

400

QuotaExceeded.Vpc

VPC quota exceeded.

Bu hesaptaki VPC sayısı üst limite ulaştı.

400

ResourceNotAvailable.Vpc

Resource you requested is not available in this region or zone.

İstenen kaynak bu bölgede veya alanda kullanılamıyor.

400

InvalidParameter

Specified UserCidr invalid format.

Kullanıcı CIDR bloğunun biçimi geçersiz.

400

InvalidParameter

Specified UserCidr Subnet mask is not valid .

Kullanıcı CIDR bloğunun alt ağ maskesi geçersiz.

400

InvalidUserCidr.Quota

Specified UserCidr number is greater than 3.

Kullanıcı CIDR bloğu sayısı üst limite ulaştı.

400

InvalidUserCidr.Malformed

Specified UserCidr overlapping in of 100.64.0.0/10.

Belirttiğiniz kullanıcı CIDR bloğu 100.64.0.0/10 ile çakışıyor.

400

InvalidResourceGroupId

The specified ResourceGroupId does not exist.

Belirtilen kaynak grubu kimliği mevcut değil.

400

OperationUnsupported.ResourceGroupId

ResourceGroup is not supported in this region.

Kaynak grubu özelliği devre dışı.

400

UnsupportedFeature.Ipv6Isp

The Ipv6Isp feature is not supported.

Belirtilen IPv6 ISP desteklenmiyor.

400

ResourceNotEnough.Ipv6Cidr

The specified resource of Ipv6Cidr is not enough.

IPv6 adresleri yetersiz.

400

UnsupportedFeature.IPAM

VPCs cannot be created by using IPAM.

VPC oluşturmak için IPAM kullanamazsınız.

403

Forbidden

User not authorized to operate on the specified resource.

Belirtilen kaynakta bu işlemi gerçekleştirmek için yetkiniz yok. Gerekli izinler için başvuruda bulunup tekrar deneyebilirsiniz.

404

InvalidRegionId.NotFound

Specified value of "regionId" is not supported.

RegionId geçersiz bir değere ayarlandı. Hizmetin belirtilen bölgede kullanılabilir olup olmadığını kontrol edin.

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. Service error codes.