All Products
Search

This Product

    Virtual Private Cloud:CreateVSwitchCidrReservation

    Document Center

    Virtual Private Cloud:CreateVSwitchCidrReservation

    Last Updated:Sep 15, 2026

    Membuat blok CIDR yang dicadangkan untuk vSwitch.

    Deskripsi operasi

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

    • Jumlah maksimum blok CIDR IPv4 yang dicadangkan dan blok CIDR IPv6 yang dicadangkan dalam sebuah VPC adalah masing-masing 100.

    • Blok CIDR yang dicadangkan tidak dapat berisi alamat IP yang dicadangkan sistem dari vSwitch tempat blok tersebut berada.

      • Blok CIDR IPv4: Alamat IP pertama dan tiga alamat IP terakhir dari vSwitch adalah alamat IP yang dicadangkan sistem.

      • Blok CIDR IPv6: Alamat IP pertama dan sembilan alamat IP terakhir dari vSwitch adalah alamat IP yang dicadangkan sistem.

    • Operasi CreateVSwitchCidrReservation bersifat asinkron. Setelah Anda mengirim permintaan, sistem akan mengembalikan ID instans, tetapi blok CIDR yang dicadangkan untuk vSwitch belum dibuat. Sistem terus menjalankan node latar belakang. Anda dapat memanggil ListVSwitchCidrReservations untuk mengkueri status pembuatan blok CIDR yang dicadangkan untuk vSwitch:

      • Jika blok CIDR yang dicadangkan untuk vSwitch berada dalam status Assigning, blok CIDR yang dicadangkan untuk vSwitch sedang mengalokasikan.

      • Jika blok CIDR yang dicadangkan untuk vSwitch berada dalam status Assigned, blok CIDR yang dicadangkan untuk vSwitch telah mengalokasikan.

    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 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Tag

    array<object>

    No

    Tag sumber daya.

    object

    No

    Format 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 dapat mencapai 128 karakter. Tidak dapat diawali dengan aliyun atau acs: dan tidak dapat mengandung http:// atau https://.

    FinanceDept
    Value

    string

    No

    Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilainya dapat berupa string kosong.

    Panjang nilai tag dapat mencapai 128 karakter. Tidak dapat diawali dengan aliyun atau acs: dan tidak dapat mengandung http:// atau https://.

    FinanceJoshua
    VSwitchId

    string

    Yes

    ID vSwitch tempat blok CIDR yang dicadangkan untuk vSwitch berada.

    vsw-25navfgbue4g****
    VSwitchCidrReservationName

    string

    No

    Nama blok CIDR yang dicadangkan untuk vSwitch.

    Panjang nama harus 1 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Dapat berisi angka, garis bawah (_), dan tanda hubung (-). Tidak dapat diawali dengan http:// atau https://.

    ReservationName
    VSwitchCidrReservationDescription

    string

    No

    Deskripsi blok CIDR yang dicadangkan untuk vSwitch. Jika Anda mengosongkan parameter ini, nilai defaultnya adalah kosong.

    Panjang deskripsi harus 1 hingga 256 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Tidak dapat diawali dengan http:// atau https://.

    ReservationDescription
    IpVersion

    string

    No

    Versi IP blok CIDR yang dicadangkan untuk vSwitch. Nilai valid:

    • IPv4 (default)

    • IPv6

    Catatan

    Anda tidak perlu menentukan parameter ini saat membuat blok CIDR IPv4 yang dicadangkan untuk vSwitch. Parameter ini wajib ditentukan saat membuat blok CIDR IPv6 yang dicadangkan untuk vSwitch.

    IPv4
    VSwitchCidrReservationMask

    string

    No

    Mask blok CIDR yang dicadangkan untuk vSwitch.

    • Jika IpVersion diatur ke IPv4, panjang mask blok CIDR yang dicadangkan untuk vSwitch harus setidaknya 2 bit lebih panjang daripada mask blok CIDR IPv4 vSwitch dan tidak boleh melebihi 28.

    • Jika IpVersion diatur ke IPv6, panjang mask blok CIDR yang dicadangkan untuk vSwitch harus lebih panjang daripada mask blok CIDR IPv6 vSwitch dan tidak boleh melebihi 80.

    Catatan

    • Anda harus menentukan parameter VSwitchCidrReservationMask atau parameter VSwitchCidrReservationCidr.

    • Blok CIDR yang dicadangkan tidak dapat berisi alamat IP yang dicadangkan sistem dari vSwitch tempat blok tersebut berada.

    28
    VSwitchCidrReservationCidr

    string

    No

    Blok CIDR yang dicadangkan untuk vSwitch.

    • Jika IpVersion diatur ke IPv4, blok CIDR yang dicadangkan untuk vSwitch harus merupakan subset sejati dari blok CIDR IPv4 vSwitch, dan panjang mask tidak boleh melebihi 28.

    • Jika IpVersion diatur ke IPv6, blok CIDR yang dicadangkan untuk vSwitch harus merupakan subset sejati dari blok CIDR IPv6 vSwitch, dan panjang mask tidak boleh melebihi 80.

    Catatan

    • Anda harus menentukan parameter VSwitchCidrReservationMask atau parameter VSwitchCidrReservationCidr.

    • Blok CIDR yang dicadangkan tidak dapat berisi alamat IP yang dicadangkan sistem dari vSwitch tempat blok tersebut berada.

    192.168.1.64/28
    VSwitchCidrReservationType

    string

    No

    Tipe blok CIDR yang dicadangkan untuk vSwitch. Nilai valid: awalan, yang menunjukkan bahwa alamat IP mengalokasikan berdasarkan blok CIDR.

    Catatan

    Saat pengguna atau layanan cloud secara otomatis menetapkan blok CIDR ke pengontrol antarmuka jaringan elastis (NIC), blok CIDR harus dialokasikan dari blok CIDR yang dicadangkan. Jika alamat IP dalam blok CIDR yang dicadangkan telah habis, sistem akan mengembalikan kesalahan.

    awalan
    IpPrefixNumber

    integer

    No

    Jumlah awalan IP yang diharapkan untuk dicadangkan. 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 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.

    123e4567-e89b-12d3-a456-426655440000
    DryRun

    boolean

    No

    Apakah akan menjalankan dry run. Nilai valid:

    • true: menjalankan dry run. Sistem memeriksa parameter wajib, format permintaan, dan batasan bisnis. Jika pemeriksaan gagal, kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

    • false (default): mengirim permintaan Normal. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan blok CIDR yang dicadangkan untuk vSwitch akan 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 blok CIDR yang dicadangkan untuk vSwitch.

    RequestId

    string

    ID permintaan.

    54B48E3D-DF70-471B-AA93-08E683A1B45
    VSwitchCidrReservationId

    string

    ID instans blok CIDR yang dicadangkan untuk vSwitch.

    vcr-bp1m12saqteraw3rp****

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalParamFormat IllegalParamFormat Format parameter salah.
    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. Instans vSwitch yang ditentukan tidak ada.
    400 UnsupportedFeature.ReservedType The specified ReservedType is not supported. ReservedType yang ditentukan tidak didukung.
    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 bertentangan 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 satunya dan coba lagi.
    400 UnsupportedRegion UnsupportedRegion Wilayah saat ini tidak mendukung operasi pada entri rute daftar awalan.
    400 UnsupportedFeature.VpcAdvancedFeature UnsupportedFeature.VpcAdvancedFeature VPC tempat vSwitch yang ditentukan berada tidak mendukung fitur lanjutan. Gunakan vSwitch lain dan coba lagi.
    400 QuotaExceeded.CidrReservationCount The quota of VSwitchCidrReservation is exceeded. Jumlah instans VSwitchCidrReservation melebihi kuota.
    400 Conflict.CidrReservationMaskAndCidrReservationCidr The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict. VSwitchCidrReservationMask yang ditentukan konflik dengan VSwitchCidrReservationCidr. Ubah parameter berdasarkan deskripsi data deret waktu di 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. vSwitch dalam status abnormal.
    400 IllegalParam.VSwitchCidrReservationMask The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask. Parameter VSwitchCidrReservationMask tidak valid. Lihat deskripsi parameter di referensi API dan coba lagi.
    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. VSwitchCidrReservationMask melebihi kuota. Lihat deskripsi parameter di referensi API dan coba lagi.
    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. Salah satu dari IpPrefixNumber, VSwitchCidrReservationMask, atau VSwitchCidrReservationCidr harus ditentukan.
    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.