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 dalam setiap VPC tidak boleh melebihi 150.
Alamat IP pertama dan tiga alamat IP 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 satu vSwitch tidak boleh melebihi sisa kuota instans layanan cloud yang tersedia di VPC (15.000 dikurangi jumlah instans layanan cloud saat ini).
Satu instans layanan cloud hanya dapat menjadi bagian dari satu vSwitch.
vSwitch tidak mendukung multicast atau broadcast.
Setelah vSwitch dibuat, Anda tidak dapat mengubah blok CIDR-nya.
Operasi CreateVSwitch bersifat asinkron. Setelah permintaan dikirim, sistem akan mengembalikan ID instans, tetapi vSwitch belum selesai dibuat karena tugas latar belakang masih berjalan. Anda dapat memanggil DescribeVSwitchAttributes untuk memeriksa status pembuatan vSwitch:
- Jika status vSwitch adalah Pending, artinya vSwitch sedang dikonfigurasi.
- Jika status vSwitch adalah Available, artinya vSwitch sudah tersedia.
Operasi CreateVSwitch tidak mendukung pembuatan vSwitch secara konkuren dalam 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 resource.
	object	No	Tag.
Key	string	No	Kunci tag resource. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter. Kunci tag tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
Value	string	No	Nilai tag resource. Anda dapat menentukan hingga 20 nilai tag. Nilai tag boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter. Nilai tag tidak boleh diawali dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`.	FinanceDept
ZoneId	string	Yes	ID zona tempat vSwitch akan dibuat. Anda dapat memanggil operasi DescribeZones untuk menanyakan ID zona.	cn-hangzhou-b
RegionId	string	No	ID wilayah vSwitch yang ingin Anda buat. Anda dapat memanggil operasi DescribeRegions untuk menanyakan ID wilayah.	cn-hangzhou
CidrBlock	string	Yes	Blok CIDR vSwitch. Persyaratan berikut berlaku: Panjang masker blok CIDR vSwitch harus antara 16 hingga 29 bit. Blok CIDR vSwitch harus merupakan subset dari blok CIDR VPC tempat vSwitch tersebut berada. Blok CIDR vSwitch tidak boleh sama dengan blok CIDR tujuan entri rute di VPC, tetapi boleh merupakan subset dari blok CIDR tujuan tersebut. 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
Ipv6CidrBlock	integer	No	8 bit terakhir dari blok CIDR IPv6 vSwitch. Nilai valid: 0 hingga 255. Anda hanya dapat menentukan parameter ini jika VPC tempat vSwitch berada telah mengaktifkan IPv6. Hal ini memungkinkan Anda memberikan blok CIDR IPv6 ke vSwitch. Setelah blok CIDR IPv6 dialokasikan, nilainya tidak dapat diubah. Pastikan blok CIDR tersebut tidak tumpang tindih dengan blok CIDR vSwitch lain di VPC yang sama.	12
VpcId	string	Yes	ID VPC tempat vSwitch berada.	vpc-257gqcdfvx6n****
VSwitchName	string	No	Nama vSwitch. Nama harus terdiri dari 1 hingga 128 karakter dan tidak boleh diawali dengan `http://` atau `https://`.	vSwitch-1
Description	string	No	Deskripsi vSwitch. Deskripsi harus terdiri dari 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 menghasilkan token ini di sisi klien, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId dari permintaan API sebagai ClientToken. Nilai 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 menetapkan rentang blok CIDR IPv6 bagi vSwitch. Jika Anda tidak menentukan parameter ini, blok CIDR IPv6 yang ditetapkan saat IPv6 diaktifkan pada VPC akan digunakan.	2408:XXXX:0:6a::/56

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
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. Verifikasi 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.	vSwitch berada dalam status Pending dan tidak dapat dihapus.
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	Format blok CIDR salah.
400	IncorrectVpcStatus	Current VPC status does not support this operation.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	Status saat ini dari Cloud Enterprise Network (CEN) tidak mendukung pembuatan vSwitch.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.
400	MissingParameter	Miss mandatory parameter.
400	TaskConflict	The operation is too frequent, TaskConflict.	Operasi terlalu sering. Tunggu sebentar lalu coba lagi.
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 sudah 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 saat ini dari instans Cloud Enterprise Network (CEN) tidak valid.
400	OperationFailed.NotifyCenCreate	Failed to notify cen when create vswitch.
400	OperationFailed.DistibuteLock	Distibute lock fail.	Operasi terkunci oleh permintaan lain.
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	CloudBox tidak mendukung pembuatan alamat IPv6.
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	Operasi ditolak karena VPC memiliki koneksi peering.
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	Operasi dilarang karena VPC diasosiasikan dengan instans Cloud Enterprise Network (CEN).
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	Operasi tertentu dilarang karena terdapat gerbang NAT di VPC.
400	MissingParam.Ipv6CidrBlock	The parameter Ipv6CidrBlock is mandatory.	Parameter Ipv6CidrBlock yang merupakan parameter yang diperlukan tidak ada.
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 ditolak karena terdapat instans koneksi peering VPC di VPC.
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	Parameter CidrBlock 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 yang ditentukan dinonaktifkan. Anda tidak dapat membuat vSwitch di zona ini.
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.