Tüm Ürünler
Search
Belge Merkezi

:CreateVSwitch

Son Güncelleme:Oct 02, 2026

Bir vSwitch oluşturur.

Kullanım notları

Bu işlemi çağırırken aşağıdaki sınırlamalara dikkat edin:

  • Bir sanal özel cloud (VPC) içinde en fazla 150 vSwitch oluşturabilirsiniz.

  • Her vSwitch CIDR bloğunun ilk IP adresi ve son üç IP adresi ayrılmıştır. Örneğin, bir vSwitch'in CIDR bloğu 192.168.1.0/24 ise 192.168.1.0, 192.168.1.253, 192.168.1.254 ve 192.168.1.255 IP adresleri ayrılmıştır.

  • Bir vSwitch'teki örnek sayısı, VPC'nin kalan kapasitesini aşamaz. Kalan kapasite, 15.000 ile mevcut örnek sayısı arasındaki farktır.

  • Her örnek yalnızca bir vSwitch'e ait olabilir.

  • vSwitch'ler çoklu yayın veya yayını desteklemez.

  • Bir vSwitch oluşturduktan sonra CIDR bloğunu değiştiremezsiniz.

  • CreateVSwitch asenkron bir işlemdir. Bir istek 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 DescribeVSwitchAttributes işlemini çağırabilirsiniz.

    • vSwitch Pending durumundaysa vSwitch yapılandırılıyor demektir.

    • vSwitch Available durumundaysa vSwitch kullanıma hazırdır.

  • Belirtilen süre içinde bir VPC'de vSwitch oluşturmak için CreateVSwitch işlemini tekrar tekrar çağırmanız mümkün değildir.

Hata ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da ç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 Gerekli Örnek Açıklama
Action String Evet CreateVSwitch

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

Tag.N.Key String Hayır FinanceJoshua

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

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

Tag.N.Value String Hayır FinanceDept

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.

ZoneId String Evet cn-hangzhou-b

vSwitch'in alan kimliği.

En güncel alan listesini sorgulamak için DescribeZones işlemini çağırabilirsiniz.

RegionId String Hayır cn-hangzhou

vSwitch'in bölge kimliği.

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

CidrBlock String Evet 172.16.0.0/24

vSwitch'in CIDR bloğu. Aşağıdaki sınırlamalara dikkat edin:

  • CIDR bloğunun alt ağ maskesi 16 ila 29 bit uzunluğunda olmalıdır.
  • vSwitch'in CIDR bloğu, ait olduğu VPC'nin CIDR bloğu içinde yer almalıdır.
  • Bir vSwitch'in CIDR bloğu, VPC'nin bir rota girdisindeki hedef CIDR bloğuyla aynı olamaz. Ancak hedef CIDR bloğunun bir alt kümesi olabilir.
Ipv6CidrBlock Integer Hayır 12

vSwitch'in IPv6 CIDR bloğunun son sekiz biti. Geçerli değerler: 0 ila 255.

VpcId String Evet vpc-257gqcdfvx6n****

vSwitch'i oluşturmak istediğiniz VPC'nin kimliği.

VSwitchName String Hayır vSwitch-1

vSwitch'in adı.

Ad 1 ila 128 karakter uzunluğunda olmalı ve http:// ya da https:// ile başlamamalıdır.

Description String Hayır vSwitch

vSwitch'in açıklaması.

Açıklama 1 ila 256 karakter uzunluğunda olmalı ve http:// ya da https:// ile başlamamalıdır.

ClientToken String Hayır 0c593ea1-3bea-11e9-b96b-88e9fe63****

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

Belirteci istemci kullanarak 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 istek kimliğini istemci belirteci olarak kullanır. İstek kimliği her istek için farklı olabilir.
VpcIpv6CidrBlock String Hayır 2408:XXXX:0:6a::/56

VPC'nin IPv6 CIDR bloğu.

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

VSwitchId

String

vsw-25navfgbue4g****

vSwitch'in kimliği.

RequestId

String

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

İstek kimliği.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateVSwitch
&Tag=[{"Key":"FinanceJoshua","Value":"FinanceDept"}]
&ZoneId=cn-hangzhou-b
&RegionId=cn-hangzhou
&CidrBlock=172.16.0.0/24
&Ipv6CidrBlock=12
&VpcId=vpc-257gqcdfvx6n****
&VSwitchName=vSwitch-1
&Description=vSwitch
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe63****
&VpcIpv6CidrBlock=2408:XXXX:0:6a::/56
&Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<CreateVSwitchResponse>
    <VSwitchId>vsw-25navfgbue4g****</VSwitchId>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</CreateVSwitchResponse>

JSON biçimi

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

{
  "VSwitchId" : "vsw-25navfgbue4g****",
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Hata kodları

Http Kodu

Hata kodu

Hata iletisi

Açıklama

400

InvalidVSwitchName.Malformed

Specified virtual switch name is not valid.

Belirtilen vSwitch adının biçimi geçersiz. Adı geçerli biçimde belirtin.

400

InvalidVSwitchDiscription.Malformed

Specified virtual switch description is not valid.

vSwitch açıklaması geçersiz.

400

MissingParam.vpcId

The parameter vpcId is mandatory.

vpcId gereklidir.

400

ResourceNotAvailable

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

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

400

InvalidParameter

Specified CIDR block is not valid in VPC.

CIDR bloğu VPC CIDR bloğu içinde yer almıyor.

400

InvalidCidrBlock.Overlapped

Specified CIDR block overlapped with other subnets.

vSwitch CIDR bloğu başka bir vSwitch CIDR bloğuyla veya özel bir rota girdisinin hedef CIDR bloğuyla çakışıyor. Kullanımda olmayan farklı bir CIDR bloğu deneyin.

400

InvalidCidrBlock.Overlapped

Specified CIDR block overlapped with other entry.

vSwitch CIDR bloğu başka bir vSwitch CIDR bloğuyla veya özel bir rota girdisinin hedef CIDR bloğuyla çakışıyor. Kullanımda olmayan farklı bir CIDR bloğu deneyin.

400

QuotaExceeded.VSwitch

Virtual switch quota exceeded.

vSwitch sayısı üst sınıra ulaştı. vSwitch sayısını azaltın ve daha sonra tekrar deneyin.

400

IncorrectRouteEntryStatus

Some route entry status blocked this operation.

Geçerli yönlendirme tablosundaki bir veya daha fazla rota girdisi Pending veya Modifying durumundadır.

400

IncorrectVSwitchStatus

Some virtual switch is modifying within the same VPC.

Aynı VPC'de birden çok vSwitch Modifying durumundadır. Daha sonra tekrar deneyin.

400

InvalidCirdrBlock.MaskLength

Specified CIDR block is not valid .

CIDR bloğunun biçimi geçersiz.

400

IncorrectVpcStatus

Current VPC status does not support this operation.

VPC geçerli durumdayken bu işlem gerçekleştirilemez.

400

CreateVSwitch.IncorrectStatus.cbnStatus

Current CBN status does not support this operation.

CEN örneği geçerli durumdayken bir vSwitch oluşturamazsınız.

400

InvalidCidrBlock.Malformed

Specified CIDR block is not valid.

Belirtilen CIDR bloğunun biçimi geçersiz.

400

MissingParameter

Miss mandatory parameter.

Bir veya daha fazla gerekli parametre ayarlanmamış. Bu işlemi çağırmadan önce tüm gerekli parametreleri ayarladığınızdan emin olun.

400

IncorrectVSwitchStatus

VSwitch Creation simultaneously is not supported.

Sistem vSwitch'i oluşturamadı ve VPC'ye ait bir veya daha fazla vSwitch Creating durumundadır.

400

TaskConflict

The operation is too frequent, TaskConflict.

Sistem meşgul. Daha sonra tekrar deneyin.

400

Forbidden.VpcNotFound

Specified VPC can not found.

Belirtilen VPC mevcut değil.

400

RouteConflict.AlreadyExist

Route conflict exists in routing table.

Yönlendirme tablosunda rota çakışmaları var.

400

IncorrectStatus.cbnStatus

Current CBN status does not support this operation.

CEN örneğinin durumu geçersiz.

400

UnsupportedFeature.CloudBoxIpv6

The IPv6 feature is not supported by cloud box.

Bir cloud box için IPv6 adresi oluşturamazsınız.

400

OperationDenied.VpcPeerExist

The operation is not allowed because the VPC peer exists.

VPC'nin bir VPC eşlemesi bağlantısı var.

400

OperationDenied.CenAttached

The operation is not allowed because the VPC is attached to CEN.

İşleme izin verilmiyor çünkü VPC bir CEN örneğine bağlı.

400

OperationDenied.NatgwExist

The operation is not allowed because the NAT gateway exists in VPC.

İşleme izin verilmiyor çünkü VPC'de NAT ağ geçitleri var.

400

MissingParam.Ipv6CidrBlock

The parameter Ipv6CidrBlock is mandatory.

Ipv6CidrBlock gereklidir.

400

OperationDenied.VpcPeerExists

The operation is not allowed because the VpcPeer exists.

VPC'nin bir VPC eşlemesi bağlantısı var.

404

InvalidZoneId.NotFound

Specified zone does not exist.

Alan kimliği geçersiz.

404

InvalidVpcId.NotFound

Specified VPC does not exist.

VPC bulunamadı.

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