All Products
Search

This Product

    Virtual Private Cloud:CreateVSwitchCidrReservation

    Document Center

    Virtual Private Cloud:CreateVSwitchCidrReservation

    Last Updated:Jun 12, 2026

    Membuat blok CIDR yang dicadangkan untuk vSwitch dengan memanggil operasi CreateVSwitchCidrReservation.

    Deskripsi operasi

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

    • VPC dapat memiliki maksimum 100 blok CIDR yang dicadangkan IPv4 dan maksimum 100 blok CIDR yang dicadangkan IPv6.

    • Blok CIDR yang dicadangkan tidak boleh berisi alamat yang dicadangkan sistem dari vSwitch tempatnya berada.

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

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

    • Operasi CreateVSwitchCidrReservation adalah operasi asinkron. Sistem mengembalikan ID instans, tetapi blok CIDR yang dicadangkan dari vSwitch belum dibuat. Tugas latar belakang masih berjalan. Anda dapat memanggil operasi ListVSwitchCidrReservations untuk membuat kueri status pembuatan blok CIDR yang dicadangkan dari vSwitch:

      • Ketika blok CIDR yang dicadangkan dari vSwitch dalam status Assigning, ini menunjukkan bahwa blok CIDR yang dicadangkan dari vSwitch sedang dialokasikan.

      • Ketika blok CIDR yang dicadangkan dari vSwitch dalam status Assigned, ini menunjukkan bahwa blok CIDR yang dicadangkan dari 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

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    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. Kunci tag tidak boleh berupa string kosong.

    Kunci tag dapat memiliki panjang maksimum 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

    FinanceDept
    Value

    string

    No

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

    Nilai tag dapat memiliki panjang maksimum 128 karakter. Tidak boleh diawali dengan aliyun atau acs:, dan tidak boleh berisi http:// atau https://.

    FinanceJoshua
    VSwitchId

    string

    Yes

    ID vSwitch tempat blok CIDR yang dicadangkan yang akan dibuat berada.

    vsw-25navfgbue4g****
    VSwitchCidrReservationName

    string

    No

    Nama blok CIDR yang dicadangkan dari vSwitch.

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

    ReservationName
    VSwitchCidrReservationDescription

    string

    No

    Deskripsi blok CIDR yang dicadangkan dari vSwitch. Jika Anda tidak menentukan nilai, deskripsi secara default kosong.

    Deskripsi harus memiliki panjang 1 hingga 256 karakter, dan harus diawali dengan huruf atau karakter Tionghoa. Tidak boleh diawali dengan http:// atau https://.

    ReservationDescription
    IpVersion

    string

    No

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

    • IPv4 (default)

    • IPv6

    Catatan

    Parameter ini bersifat opsional ketika Anda membuat blok CIDR yang dicadangkan IPv4, dan wajib ketika Anda membuat blok CIDR yang dicadangkan IPv6.

    IPv4
    VSwitchCidrReservationMask

    string

    No

    Mask blok CIDR yang dicadangkan dari vSwitch.

    • Ketika IpVersion diatur ke IPv4, panjang mask blok CIDR yang dicadangkan dari vSwitch harus setidaknya 2 bit lebih besar dari mask blok CIDR IPv4 dari vSwitch tempatnya berada, dan panjang mask maksimum adalah 28.

    • Ketika IpVersion diatur ke IPv6, panjang mask blok CIDR yang dicadangkan dari vSwitch harus lebih besar dari panjang mask blok CIDR IPv6 dari vSwitch tempatnya berada, dan panjang mask maksimum adalah 80.

    Catatan

    • Anda harus menentukan salah satu dari parameter VSwitchCidrReservationMask dan parameter VSwitchCidrReservationCidr.

    • Blok CIDR yang dicadangkan tidak boleh berisi alamat yang dicadangkan sistem dari vSwitch tempatnya berada.

    28
    VSwitchCidrReservationCidr

    string

    No

    Blok CIDR yang dicadangkan dari vSwitch.

    • Ketika IpVersion diatur ke IPv4, blok CIDR yang dicadangkan dari vSwitch harus merupakan subset yang tepat dari blok CIDR IPv4 dari vSwitch tempatnya berada, dan panjang mask blok CIDR tidak boleh melebihi 28.

    • Ketika IpVersion diatur ke IPv6, blok CIDR yang dicadangkan dari vSwitch harus merupakan subset yang tepat dari blok CIDR IPv6 dari vSwitch tempatnya berada, dan panjang mask blok CIDR tidak boleh melebihi 80.

    Catatan

    • Anda harus menentukan salah satu dari parameter VSwitchCidrReservationMask dan parameter VSwitchCidrReservationCidr.

    • Blok CIDR yang dicadangkan tidak boleh berisi alamat yang dicadangkan sistem dari vSwitch tempatnya berada.

    192.168.1.64/28
    VSwitchCidrReservationType

    string

    No

    Tipe blok CIDR yang dicadangkan dari vSwitch. Nilai yang valid: prefix, yang menunjukkan bahwa alamat dialokasikan per blok.

    Catatan

    Ketika pengguna dan layanan cloud secara otomatis mengalokasikan blok CIDR untuk Elastic Network Interface (ENI), alamat harus dialokasikan dari blok CIDR yang dicadangkan. Jika alamat dalam blok CIDR yang dicadangkan telah dialokasikan sepenuhnya, sistem mengembalikan kesalahan.

    prefix
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai, tetapi Anda harus memastikan bahwa nilainya unik di antara permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId dari setiap permintaan API berbeda.

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

    boolean

    No

    Menentukan apakah hanya melakukan pra-pemeriksaan permintaan ini. Nilai yang valid:

    • true: mengirim permintaan pemeriksaan dan tidak membuat blok CIDR yang dicadangkan dari vSwitch. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan, format permintaan, dan batasan bisnis. Jika permintaan gagal pemeriksaan, kesalahan yang sesuai dikembalikan. Jika permintaan lulus pemeriksaan, kode kesalahan DryRunOperation dikembalikan.

    • false (default): mengirim permintaan normal. Setelah permintaan lulus pemeriksaan, kode status HTTP 2xx dikembalikan dan pembuatan dilakukan secara langsung.

    false
    RegionId

    string

    Yes

    ID region dari vSwitch.

    Anda dapat memanggil operasi DescribeRegions untuk membuat kueri ID region.

    cn-hangzhou

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ID instans dari blok CIDR yang dicadangkan dari vSwitch.

    VSwitchCidrReservationId

    string

    ID instans dari blok CIDR yang dicadangkan dari 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 The parameter format is invalid.
    400 IllegalParamFormat.VSwitchCidrReservationCidr The param format of VSwitchCidrReservationCidr is illegal. The VSwitchCidrReservationCidr value is invalid.
    400 ResourceNotFound.VSwitch The specified resource of VSwitch is not found. The specified vSwitch does not exist.
    400 UnsupportedFeature.ReservedType The specified ReservedType is not supported. The ReservedType value is invalid.
    400 UnsupportedFeature.VSwitchIpv6 The ipv6 feature of switch is not supported. IPv6 is not enabled for the specified vSwitch.
    400 OperationFailed.VSwitchCidrReservationCidr The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr. The VSwitchCidrReservationCidr value conflicts with an existing VSwitchCidrReservation value.
    400 MissingParam.CidrReservationMaskOrCidrReservationCidr Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified. You cannot leave both the VSwitchCidrReservationMask and VSwitchCidrReservationCidr parameters empty. Set a value and try again.
    400 UnsupportedRegion UnsupportedRegion The error message returned because the current region does not support this feature.
    400 UnsupportedFeature.VpcAdvancedFeature UnsupportedFeature.VpcAdvancedFeature The error message returned because the VPC where the specified vSwitch is deployed does not support advanced VPC features. Specify another vSwitch and try again.
    400 QuotaExceeded.CidrReservationCount The quota of VSwitchCidrReservation is exceeded. The VSwitchCidrReservation value exceeds the upper limit.
    400 Conflict.CidrReservationMaskAndCidrReservationCidr The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict. The VSwitchCidrReservationMask value conflicts with the VSwitchCidrReservationCidr value. Adjust the values and try again.
    400 OperationFailed.CidrNotEnoughInVSwitch No enough cidr to allocate in this vswitch. The specified vSwitch does not have sufficient CIDR blocks.
    400 OperationFailed.SystemReservedIpContained The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses. VSwitchCidrReservationCidr cannot contain a reserved IP address.
    400 OperationFailed.AlreadyUsedIpContained The specified VSwitchCidrReservationCidr cannot contain already used IP addresses. The reserved CIDR block cannot contain used IP addresses.
    400 IncorrectStatus.VSWITCH The status of the specified VSwitch is invalid. The status of the specified VSwitch is invalid.
    400 IllegalParam.VSwitchCidrReservationMask The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask. The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask.
    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. The operation failed because of the quota %s. The mask of the reserved CIDR block exceeds the default mask of the current IP Prefix, %s/%s.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.