CreateVSwitchCidrReservation - Virtual Private Cloud - Alibaba Cloud Documentation Center

Membuat Blok CIDR yang dipesan untuk vSwitch.

Deskripsi operasi

Saat Anda memanggil operasi ini untuk membuat Blok CIDR yang dipesan untuk vSwitch, perhatikan hal-hal berikut:

Jumlah maksimum Blok CIDR IPv4 dan IPv6 yang dipesan dalam sebuah VPC adalah masing-masing 100.
Blok CIDR yang dipesan tidak boleh berisi alamat IP yang dicadangkan sistem dari vSwitch tempat blok tersebut berada.
- Blok CIDR IPv4: Tiga alamat IP pertama dan terakhir dari vSwitch adalah alamat IP yang dicadangkan sistem.
- Blok CIDR IPv6: Sembilan alamat IP pertama dan terakhir dari vSwitch adalah alamat IP yang dicadangkan sistem.
Operasi CreateVSwitchCidrReservation bersifat asinkron. Setelah Anda mengirim permintaan, sistem mengembalikan ID instans, tetapi Blok CIDR yang dipesan untuk vSwitch belum dibuat. Sistem terus menjalankan node latar belakang. Anda dapat memanggil ListVSwitchCidrReservations untuk mengkueri status pembuatan Blok CIDR yang dipesan untuk vSwitch:
- Jika Blok CIDR yang dipesan untuk vSwitch berada dalam status Assigning, Blok CIDR yang dipesan untuk vSwitch sedang dialokasikan.
- Jika Blok CIDR yang dipesan untuk vSwitch berada dalam status Assigned, Blok CIDR yang dipesan untuk vSwitch telah dialokasikan.

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

create

*VSwitchCidrReservation.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Tag	array<object>	No	Tag Sumber daya.
	object	No	Informasi tag.
Key	string	No	Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Jika Anda menentukan parameter ini, nilainya tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Jika Anda menentukan parameter ini, nilainya dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Nilai tag tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
VSwitchId	string	Yes	ID vSwitch tempat Blok CIDR yang dipesan untuk vSwitch berada.	vsw-25navfgbue4g****
VSwitchCidrReservationName	string	No	Nama Blok CIDR yang dipesan untuk vSwitch. Panjang nama harus 1 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, garis bawah (_), dan tanda hubung (-). Nama tidak boleh diawali dengan `http://` atau `https://`.	ReservationName
VSwitchCidrReservationDescription	string	No	Deskripsi Blok CIDR yang dipesan untuk vSwitch. Jika Anda tidak menentukan parameter ini, deskripsinya kosong. Nilai defaultnya kosong. Panjang deskripsi harus 1 hingga 256 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Deskripsi tidak boleh diawali dengan `http://` atau `https://`.	ReservationDescription
IpVersion	string	No	Versi IP dari Blok CIDR yang dipesan untuk vSwitch. Nilai valid: IPv4 (default) IPv6 Catatan Anda tidak perlu menentukan parameter ini saat membuat Blok CIDR yang dipesan untuk vSwitch IPv4. Parameter ini wajib ditentukan saat membuat Blok CIDR yang dipesan untuk vSwitch IPv6.	IPv4
VSwitchCidrReservationMask	string	No	Masker dari Blok CIDR yang dipesan untuk vSwitch. Jika IpVersion diatur ke IPv4, panjang masker Blok CIDR yang dipesan harus setidaknya 2 bit lebih panjang daripada masker Blok CIDR IPv4 vSwitch dan tidak boleh melebihi 28. Jika IpVersion diatur ke IPv6, panjang masker Blok CIDR yang dipesan harus lebih panjang daripada masker Blok CIDR IPv6 vSwitch dan tidak boleh melebihi 80. Catatan Anda harus menentukan parameter VSwitchCidrReservationMask atau VSwitchCidrReservationCidr. Blok CIDR yang dipesan tidak boleh berisi alamat IP yang dicadangkan sistem dari vSwitch tempat blok tersebut berada.	28
VSwitchCidrReservationCidr	string	No	Blok CIDR yang dipesan untuk vSwitch. Jika IpVersion diatur ke IPv4, Blok CIDR yang dipesan untuk vSwitch harus merupakan subset sejati dari Blok CIDR IPv4 vSwitch dan panjang maskernya tidak boleh melebihi 28. Jika IpVersion diatur ke IPv6, Blok CIDR yang dipesan untuk vSwitch harus merupakan subset sejati dari Blok CIDR IPv6 vSwitch dan panjang maskernya tidak boleh melebihi 80. Catatan Anda harus menentukan parameter VSwitchCidrReservationMask atau VSwitchCidrReservationCidr. Blok CIDR yang dipesan tidak boleh berisi alamat IP yang dicadangkan sistem dari vSwitch tempat blok tersebut berada.	192.168.1.64/28
VSwitchCidrReservationType	string	No	Tipe Blok CIDR yang dipesan untuk vSwitch. Nilai valid: prefix, yang menunjukkan bahwa alamat IP dialokasikan berdasarkan awalan. Catatan Saat pengguna atau layanan cloud secara otomatis mengalokasikan Blok CIDR ke antarmuka jaringan elastis (ENI), Blok CIDR harus dialokasikan dari Blok CIDR yang dipesan untuk vSwitch. Jika alamat IP dalam Blok CIDR yang dipesan untuk vSwitch habis, sistem akan mengembalikan error.	awalan
IpPrefixNumber	integer	No	Jumlah awalan IP yang diharapkan untuk dipesan. Nilai valid: 1 hingga 32.	1
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 berbagai permintaan. Token hanya boleh 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.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	No	Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid: true: mengirim permintaan pemeriksaan tanpa membuat Blok CIDR yang dipesan untuk vSwitch. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan, format permintaan valid, dan batas layanan tidak terlampaui. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false (default): mengirim permintaan Normal. Setelah pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan Blok CIDR yang dipesan untuk vSwitch dibuat.	false
RegionId	string	Yes	ID Wilayah vSwitch. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou

Elemen respons

Element	Type	Description	Example
	object	ID instans dari Blok CIDR yang dipesan untuk vSwitch.
VSwitchCidrReservationId	string	ID instans dari Blok CIDR yang dipesan untuk vSwitch.	vcr-bp1m12saqteraw3rp****
RequestId	string	ID permintaan.	54B48E3D-DF70-471B-AA93-08E683A1B45

Contoh

Respons sukses

JSONformat

{
  "VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****",
  "RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	IllegalParamFormat	IllegalParamFormat	Parameter yang ditentukan tidak valid.
400	IllegalParamFormat.VSwitchCidrReservationCidr	The param format of VSwitchCidrReservationCidr is illegal.	Format parameter VSwitchCidrReservationCidr tidak valid.
400	ResourceNotFound.VSwitch	The specified resource of VSwitch is not found.	vSwitch yang terkait dengan antarmuka jaringan elastis (ENI) tidak ada.
400	UnsupportedFeature.ReservedType	The specified ReservedType is not supported.	ReservedType yang ditentukan tidak didukung. Masukkan nilai valid berdasarkan spesifikasi parameter permintaan.
400	UnsupportedFeature.VSwitchIpv6	The ipv6 feature of switch is not supported.	vSwitch yang ditentukan belum mengaktifkan IPv6.
400	OperationFailed.VSwitchCidrReservationCidr	The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr.	VSwitchCidrReservationCidr yang ditentukan konflik dengan blok CIDR VSwitchCidrReservation yang ada.
400	MissingParam.CidrReservationMaskOrCidrReservationCidr	Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified.	VSwitchCidrReservationMask dan VSwitchCidrReservationCidr tidak boleh kosong keduanya. Tentukan salah satu dan coba lagi.
400	UnsupportedRegion	UnsupportedRegion	Fitur ini tidak didukung di wilayah saat ini.
400	UnsupportedFeature.VpcAdvancedFeature	UnsupportedFeature.VpcAdvancedFeature	VPC tidak mendukung beberapa fitur lanjutan. Ajukan tiket untuk bantuan.
400	QuotaExceeded.CidrReservationCount	The quota of VSwitchCidrReservation is exceeded.	Jumlah instans CidrReservation yang Anda buat telah melebihi batas.
400	Conflict.CidrReservationMaskAndCidrReservationCidr	The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict.	VSwitchCidrReservationMask yang ditentukan berkonflik dengan VSwitchCidrReservationCidr. Ubah parameter berdasarkan deskripsi data deret waktu dalam dokumentasi API dan coba lagi.
400	OperationFailed.CidrNotEnoughInVSwitch	No enough cidr to allocate in this vswitch.	vSwitch yang ditentukan tidak memiliki blok CIDR yang cukup untuk mengalokasikan CidrReservation.
400	OperationFailed.SystemReservedIpContained	The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses.	VSwitchCidrReservationCidr yang ditentukan tidak boleh berisi alamat IP yang dicadangkan sistem.
400	OperationFailed.AlreadyUsedIpContained	The specified VSwitchCidrReservationCidr cannot contain already used IP addresses.	Blok CIDR cadangan yang ditentukan tidak boleh berisi alamat IP yang sudah digunakan.
400	IncorrectStatus.VSWITCH	The status of the specified VSwitch is invalid.	Status vSwitch tidak normal.
400	IllegalParam.VSwitchCidrReservationMask	The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask.	VSwitchCidrReservationMask yang ditentukan harus setidaknya 2 lebih besar dari mask vSwitch.
400	QuotaExceeded.VSwitchCidrReservationMask	The operation is failed because of %s. The mask of the reserved subnet cidr exceeds the current default mask of IP Prefix, %s/%s.	Operasi gagal karena batas kuota %s. Masker blok CIDR yang dicadangkan melebihi masker default dari awalan IP saat ini, %s/%s.
400	IllegalParam.ReservedType	IpPrefixNumber is only supported with Prefix reserved type.	IpPrefixNumber hanya didukung untuk tipe reservasi Prefix.
400	MissingParam.VSwitchCidrReservationParam	One of IpPrefixNumber, VSwitchCidrReservationMask, or VSwitchCidrReservationCidr must be specified.	Anda harus menentukan salah satu dari IpPrefixNumber, VSwitchCidrReservationMask, atau VSwitchCidrReservationCidr.
400	Conflict.VSwitchCidrReservationParam	IpPrefixNumber cannot be used together with VSwitchCidrReservationCidr or VSwitchCidrReservationMask.	IpPrefixNumber tidak dapat digunakan bersama dengan VSwitchCidrReservationCidr atau VSwitchCidrReservationMask.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.