CreateDefaultVSwitch - Virtual Private Cloud - Alibaba Cloud Documentation Center

Membuat vSwitch default.

Deskripsi operasi

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

Tiga alamat IP pertama dan terakhir dari setiap blok CIDR vSwitch default 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 vSwitch default tidak dapat melebihi sisa instans layanan cloud yang tersedia di VPC (15.000 dikurangi jumlah instans layanan cloud saat ini).
VSwitch default tidak mendukung multicast atau broadcast.
Setelah vSwitch default dibuat, Anda tidak dapat mengubah blok CIDR-nya.
Operasi CreateDefaultVSwitch bersifat asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID instans, tetapi vSwitch default belum dibuat. Tugas latar belakang masih berjalan. Anda dapat memanggil DescribeVSwitchAttributes untuk mengkueri status pembuatan vSwitch default:
- Jika vSwitch default berada dalam status Pending, vSwitch default sedang dikonfigurasi.
- Jika vSwitch default berada dalam status Available, vSwitch default telah tersedia.
Jika vSwitch default sudah ada di zona wilayah yang ditentukan, pemanggilan operasi ini akan gagal.
Sebelum membuat vSwitch default, buat VPC default terlebih dahulu. Anda dapat memanggil operasi CreateDefaultVpc untuk membuat VPC default.

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:CreateDefaultVSwitch

create

*VSwitch

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ZoneId	string	Yes	ID zona vSwitch default yang ingin Anda buat. Anda dapat memanggil operasi DescribeZones untuk mengkueri ID zona.	cn-hangzhou-b
RegionId	string	Yes	ID wilayah vSwitch default yang ingin Anda buat. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
Ipv6CidrBlock	integer	No	8 bit terakhir dari blok CIDR IPv6 vSwitch. Nilai valid: 0 hingga 255.	12
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	0c593ea1-3bea-11e9-b96b-88e9fe63****

Elemen respons

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidDescription.Malformed	Deskripsi tidak valid.
400	InvalidVSwitchName.Malformed	Nama virtual switch yang ditentukan tidak valid.	Format nama vSwitch tidak valid. Verifikasi format nama vSwitch.
400	InvalidVSwitchDiscription.Malformed	Deskripsi virtual switch yang ditentukan tidak valid.
400	Abs.Vpc.InvalidDescription.Malformed	Nama virtual switch yang ditentukan tidak valid.
400	ResourceNotAvailable	Sumber daya yang Anda minta tidak tersedia di wilayah atau zona ini.
400	InvalidParameter	Blok CIDR yang ditentukan tidak valid di VPC.
400	InvalidCidrBlock.Overlapped	Blok CIDR yang ditentukan tumpang tindih dengan subnet lain.
400	QuotaExceeded.VSwitch	Kuota virtual switch terlampaui.	Jumlah vSwitch telah mencapai batas atas. Kurangi jumlah vSwitch dan coba lagi.
400	IncorrectRouteEntryStatus	Beberapa status entri rute memblokir operasi ini.
400	IncorrectVSwitchStatus	Beberapa virtual switch sedang dimodifikasi dalam VPC yang sama.	Beberapa vSwitch dalam VPC yang sama berada dalam status Modifying. Coba lagi nanti.
400	InvalidCirdrBlock.MaskLength	Blok CIDR yang ditentukan tidak valid .	Format blok CIDR tidak valid.
400	IncorrectVpcStatus	Status VPC saat ini tidak mendukung operasi ini.
400	CreateVSwitch.IncorrectStatus.cbnStatus	Status CBN saat ini tidak mendukung operasi ini.	Status CBN saat ini tidak mendukung pembuatan vSwitch.
400	InvalidCidrBlock.Malformed	Blok CIDR yang ditentukan tidak valid.
400	MissingParameter	Parameter wajib tidak ada.
400	TaskConflict	Operasi terlalu sering, TaskConflict.	Operasi terlalu sering. Coba lagi nanti.
400	VPC.SWITCH.RULE.QUOTA.NOT.EXISTS	Aturan kuota vSwitch tidak ada.
400	Forbidden.VpcNotFound	VPC yang ditentukan tidak ditemukan.	VPC yang ditentukan tidak ada. Periksa apakah VPC sudah benar.
400	RouteConflict.AlreadyExist	Konflik rute ada dalam tabel routing.	Konflik rute ada dalam tabel rute.
400	OperationFailed.CidrAcross	CIDR instance classic link tidak boleh saling bersilangan.
400	Duplicated.ClientToken	%s
400	OperationFailed.Ipv6CidrBlockExisted	%s
400	IllegalParam.Ipv6CidrBlock	%s
400	OperationFailed.VpcIpv6Disabled	%s
400	IncorrectStatus.cbnStatus	Status CBN saat ini tidak mendukung operasi ini.	Status CBN saat ini tidak valid.
400	OperationFailed.DefaultVpcNotExist	%s
400	UnsupportedFeature.CloudBoxIpv6	Fitur IPv6 tidak didukung oleh cloud box.	Cloud Box tidak mendukung pembuatan IPv6.
400	OperationDenied.VpcPeerExist	Operasi tidak diizinkan karena VPC peer ada.	Operasi yang ditentukan dilarang karena terdapat koneksi peering VPC.
400	OperationDenied.CenAttached	Operasi tidak diizinkan karena VPC terhubung ke CEN.	Operasi yang ditentukan dilarang karena VPC terhubung ke instance CEN.
400	OperationDenied.NatgwExist	Operasi tidak diizinkan karena gateway NAT ada di VPC.	Operasi yang ditentukan dilarang karena gateway NAT telah dibuat di VPC.
400	OperationDenied.OtherSubnetCreating	subnet lain sedang dibuat
400	OperationFailed.DefaultVSwitchExist	vSwitch default sudah ada di zona tersebut.	vSwitch default sudah ada di zona saat ini.
400	InvalidStatus.RouteEntry	Kesalahan status RouteEntry.
400	InvalidZoneId.NotFound	Zona yang ditentukan tidak ada.
400	OperationDenied.ZoneIsDisabled	Zona yang ditentukan dinonaktifkan. Anda tidak dapat membuat vSwitch di zona yang dinonaktifkan.	Zona saat ini dinonaktifkan. Anda tidak dapat membuat vSwitch di zona yang dinonaktifkan.
404	Invalid.NotExist	Aturan mask vSwitch tidak ada.
404	InvalidVpcId.NotFound	VPC yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.