CreateVSwitch - Virtual Private Cloud - Alibaba Cloud Documentation Center

Membuat vSwitch.

Deskripsi operasi

Saat memanggil operasi ini untuk membuat vSwitch, perhatikan hal-hal berikut:

Jumlah vSwitch di setiap VPC tidak boleh melebihi 150.
Tiga alamat IP pertama dan terakhir dari setiap Blok CIDR vSwitch dicadangkan oleh sistem. Misalnya, alamat IP yang dicadangkan sistem untuk 192.168.1.0/24 adalah 192.168.1.0, 192.168.1.253, 192.168.1.254, dan 192.168.1.255.
Jumlah instans layanan cloud dalam sebuah vSwitch tidak boleh melebihi sisa instans layanan cloud yang tersedia di VPC (15.000 dikurangi jumlah instans layanan cloud saat ini).
Sebuah instans layanan cloud hanya dapat berada di satu vSwitch.
vSwitch tidak mendukung multicast atau broadcast.
Setelah vSwitch dibuat, Anda tidak dapat mengubah Blok CIDR-nya.
Operasi CreateVSwitch bersifat asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID instans tetapi vSwitch belum dibuat. Tugas latar belakang masih berjalan. Anda dapat memanggil DescribeVSwitchAttributes untuk mengkueri status pembuatan vSwitch:
- Saat vSwitch berada dalam status Pending, vSwitch sedang dikonfigurasi.
- Saat vSwitch berada dalam status Available, vSwitch sudah tersedia.
Operasi CreateVSwitch tidak mendukung pembuatan vSwitch secara bersamaan di VPC yang sama.
Saat memanggil operasi CreateVSwitch, Blok CIDR vSwitch tidak boleh berada dalam rentang alamat yang dicadangkan berikut: 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16, atau 224.0.0.0/4.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vpc:CreateVSwitch

create

*VPC.

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

*VSwitch.

acs:vpc:{#regionId}:{#accountId}:vswitch/*

vpc:tag

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Tag	array<object>	No	Tag Sumber daya.
	object	No	Tag.
Key	string	No	Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
Value	string	No	Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter. Tidak boleh diawali dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`.	FinanceDept
ZoneId	string	Yes	ID zona tempat membuat vSwitch. Anda dapat memanggil operasi DescribeZones untuk mengkueri ID zona.	cn-hangzhou-b
RegionId	string	No	ID wilayah vSwitch yang akan dibuat. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
CidrBlock	string	No	Blok CIDR vSwitch. Blok CIDR vSwitch harus memenuhi persyaratan berikut: Panjang mask Blok CIDR vSwitch harus 16 hingga 29 bit. Blok CIDR vSwitch harus merupakan subset dari Blok CIDR VPC tempat vSwitch berada. Blok CIDR vSwitch tidak boleh sama dengan Blok CIDR tujuan dari entri rute di VPC, tetapi dapat berupa subset dari Blok CIDR tujuan. Blok CIDR vSwitch tidak boleh berada dalam rentang alamat yang dicadangkan berikut: 100.64.0.0/10, 127.0.0.0/8, 169.254.0.0/16, atau 224.0.0.0/4. Catatan Setelah vSwitch dibuat, Anda tidak dapat mengubah Blok CIDR-nya.	172.16.0.0/24
CidrMask	integer	No	Panjang mask Blok CIDR IPv4 vSwitch. Catatan Panjang mask Blok CIDR IPv4 vSwitch harus 16 hingga 29 bit. Anda harus menentukan setidaknya satu dari CidrBlock dan CidrMask.	24
Ipv6CidrBlock	integer	No	8 bit terakhir dari Blok CIDR IPv6 vSwitch. Nilai valid: 0 hingga 255. Anda dapat menentukan parameter ini untuk menetapkan Blok CIDR IPv6 ke vSwitch hanya jika VPC tempat vSwitch berada telah mengaktifkan IPv6. Setelah Blok CIDR IPv6 ditetapkan, tidak dapat diubah ke Blok CIDR lain. Pastikan Blok CIDR tidak tumpang tindih dengan vSwitch lain di VPC.	12
Ipv6CidrMask	integer	No	Mask subnet Blok CIDR IPv6 vSwitch. Anda dapat menentukan parameter ini untuk menetapkan Blok CIDR IPv6 ke vSwitch hanya jika VPC tempat vSwitch berada telah mengaktifkan IPv6. Catatan Hanya 64 yang didukung.	64
VpcId	string	Yes	ID VPC tempat vSwitch berada.	vpc-257gqcdfvx6n****
VSwitchName	string	No	Nama vSwitch. Panjang nama harus 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	vSwitch-1
Description	string	No	Deskripsi vSwitch. Panjang deskripsi harus 1 hingga 256 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	vSwitch
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi harus memastikan token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dapat berbeda untuk setiap permintaan API.	0c593ea1-3bea-11e9-b96b-88e9fe63****
VpcIpv6CidrBlock	string	No	Blok CIDR IPv6 VPC. Jika VPC tempat vSwitch berada memiliki beberapa Blok CIDR IPv6, Anda dapat menentukan parameter ini untuk menentukan rentang Blok CIDR IPv6 untuk vSwitch. Jika Anda tidak menentukan parameter ini, Blok CIDR IPv6 yang ditetapkan saat IPv6 diaktifkan untuk VPC akan digunakan.	2408:XXXX:0:6a::/56

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
VSwitchId	string	ID vSwitch yang dibuat.	vsw-25navfgbue4g****
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationFailed.ResourceConflict	vpc only support one cloud box.
400	OperationFailed.IdempotentTokenProcessing	Action is processing.
400	InvalidDescription.Malformed	Invalid description.
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	Format nama vSwitch tidak valid. Periksa format nama vSwitch.
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.
400	Abs.Vpc.InvalidDescription.Malformed	Specified virtual switch name is not valid.
400	MissingParam.vpcId	The parameter vpcId is mandatory.
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.
400	InvalidParameter	Specified CIDR block is not valid in VPC.
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.	Jumlah vSwitch telah mencapai batas kuota. Kurangi jumlah vSwitch dan coba lagi.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	Gagal membuat vSwitch karena sebuah vSwitch di VPC berada dalam status Creating.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	Format blok CIDR tidak valid.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	Status instans Cloud Enterprise Network (CEN) saat ini tidak mendukung operasi pembuatan virtual switch (vSwitch).
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	MissingParameter	Miss mandatory parameter.
400	TaskConflict	The operation is too frequent, TaskConflict.	Operasi EIP terlalu sering.
400	VPC.SWITCH.RULE.QUOTA.NOT.EXISTS	vSwitch quota rule not exists.
400	Forbidden.VpcNotFound	Specified VPC can not found.	VPC yang ditentukan tidak ada. Periksa apakah VPC benar.
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	Terdapat konflik entri rute dalam tabel rute.
400	OperationFailed.CidrAcross	Classic link instance cidr must not across.
400	Duplicated.ClientToken	%s
400	OperationFailed.Ipv6CidrBlockExisted	%s
400	IllegalParam.Ipv6CidrBlock	%s
400	OperationFailed.VpcIpv6Disabled	%s
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	Status CBN saat ini salah.
400	OperationFailed.NotifyCenCreate	Failed to notify cen when create vswitch.
400	OperationFailed.DistibuteLock	Distibute lock fail.	Sumber daya terkunci. Operasi tidak diizinkan.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	CloudBox tidak mendukung pembuatan IPv6.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	Operasi dilarang karena VPC memiliki koneksi peering.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	Operasi dilarang karena VPC dikaitkan dengan instans Cloud Enterprise Network (CEN).
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	Operasi dilarang karena terdapat gerbang NAT di VPC.
400	IllegalParam.VpcIpv6CidrBlock	%s
400	OperationDenied.OtherSubnetCreating	The operation is not allowed because the other VSwitch is creating.
400	OperationDenied.VpcPeerExists	The operation is not allowed because the VpcPeer exists.	Operasi dilarang karena terdapat koneksi peering VPC di VPC.
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	Blok CIDR tidak valid.
400	InvalidStatus.RouteEntry	RouteEntry status error.
400	InvalidZoneId.NotFound	Specified zone does not exist.
400	OperationDenied.ZoneIsDisabled	The specified zone is disabled. You cannot create a vSwitch in a disabled zone.	Zona saat ini telah dinonaktifkan. Pembuatan vSwitch di zona ini tidak diizinkan.
400	OperationDenied.VpcIpv6CidrBlockNotExist	The specified VpcIpv6CidrBlock does not exist in the VPC.	VpcIpv6CidrBlock yang ditentukan tidak ada di VPC.
400	OperationDenied.AvailableCidrInsufficient	Insufficient available CIDR blocks for allocation. This is either because the VPC has no remaining address space, or because the candidate CIDR contains destination networks of active non-system routes in the VPC.	Operasi ditolak karena sumber daya Blok CIDR yang tersedia tidak mencukupi.
400	OperationDenied.Ipv6CidrMaskInvalid	The specified Ipv6CidrMask is invalid, only %s is allowed.	Masker IPv6 yang ditentukan tidak valid. Hanya %s yang didukung.
400	ParamExclusive.CidrBlockAndCidrMask	CidrBlock and CidrMask are mutually exclusive.	Parameter CidrBlock dan CidrMask saling eksklusif.
400	MissingParam.Ipv6CidrBlockOrIpv6CidrMask	Ipv6CidrBlock or Ipv6CidrMask must be specified.	Setidaknya satu dari Ipv6CidrBlock atau Ipv6CidrMask harus ditentukan.
400	MissingParam.CidrBlockOrCidrMask	CidrBlock or CidrMask is not specified.	Gagal menambahkan blok CIDR ke kolam alamat karena parameter blok CIDR atau masker hilang.
400	UnsupportedFeature.Ipv6OnlyVsw	IPv6-only VSwitches are not supported in this region.
404	Invalid.NotExist	witch mask rule not exists.
404	InvalidVpcId.NotFound	Specified VPC does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.