All Products
Search

This Product

    Virtual Private Cloud:CreateIpamPoolAllocation

    Document Center

    Virtual Private Cloud:CreateIpamPoolAllocation

    Last Updated:Mar 13, 2026

    Membuat Blok CIDR khusus yang dicadangkan dari Kolam IPAM.

    Deskripsi operasi

    • Sebelum membuat Blok CIDR khusus yang dicadangkan, pastikan Anda telah membuat Kolam IPAM dan menambahkan Blok CIDR ke dalamnya. Anda dapat memanggil operasi CreateIpamPool untuk membuat Kolam IPAM dan operasi AddIpamPoolCidr untuk menambahkan Blok CIDR ke kolam tersebut.

    • Saat menentukan parameter Cidr atau CidrMask untuk membuat Blok CIDR khusus yang dicadangkan, mask harus berada dalam rentang yang ditentukan untuk Kolam IPAM tersebut.

    • Jika Kolam IPAM memiliki atribut region, permintaan untuk membuat Blok CIDR khusus yang dicadangkan harus diajukan dari wilayah tempat kolam tersebut berada.

    • Blok CIDR khusus yang dicadangkan tidak boleh tumpang tindih dengan alokasi Blok CIDR yang sudah ada di Kolam IPAM.

    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
    RegionId

    string

    Yes

    ID wilayah tempat Anda ingin membuat Blok CIDR khusus yang dicadangkan.

    Anda dapat memanggil DescribeRegions untuk mendapatkan ID wilayah tersebut.

    cn-hangzhou
    IpamPoolId

    string

    Yes

    ID Kolam IPAM.

    ipam-pool-6rcq3tobayc20t****
    Cidr

    string

    No

    Blok CIDR yang akan dialokasikan dari Kolam IPAM.

    Catatan

    Anda harus menentukan salah satu parameter Cidr atau CidrMask.

    192.168.1.0/24
    CidrMask

    integer

    No

    Mask Blok CIDR yang akan dialokasikan dari Kolam IPAM.

    Catatan

    Anda harus menentukan salah satu parameter Cidr atau CidrMask.

    24
    DryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run. Nilai yang valid:

    • true: Mengirim permintaan pemeriksaan. Blok CIDR khusus yang dicadangkan tidak dibuat. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika pemeriksaan gagal, sistem mengembalikan kesalahan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan.

    • false (default): Mengirim permintaan normal. Setelah permintaan lolos pemeriksaan, kode status HTTP 2xx dikembalikan dan Blok CIDR khusus yang dicadangkan dibuat.

    false
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan. Hasilkan nilai pada klien Anda agar nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII.

    Catatan

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

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

    string

    No

    Deskripsi Blok CIDR khusus yang dicadangkan.

    Panjang deskripsi harus antara 1 hingga 256 karakter. Deskripsi harus dimulai dengan huruf atau karakter Tionghoa dan tidak boleh dimulai dengan http:// atau https://. Nilai default adalah string kosong.

    test description
    IpamPoolAllocationName

    string

    No

    Nama Blok CIDR khusus yang dicadangkan.

    Panjang nama harus antara 1 hingga 128 karakter dan tidak boleh dimulai dengan http:// atau https://.

    test name

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    RequestId

    string

    ID permintaan.

    CE9CDAE5-341E-5D0B-AC8A-2BAC707D3EB2
    IpamPoolAllocationId

    string

    ID Blok CIDR khusus yang dicadangkan.

    ipam-pool-alloc-112za33e4****
    Cidr

    string

    Blok CIDR yang dialokasikan.

    192.168.1.0/24
    SourceCidr

    string

    Blok CIDR sumber.

    192.168.0.0/16

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "CE9CDAE5-341E-5D0B-AC8A-2BAC707D3EB2",
  "IpamPoolAllocationId": "ipam-pool-alloc-112za33e4****",
  "Cidr": "192.168.1.0/24",
  "SourceCidr": "192.168.0.0/16"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 OperationDenied.ResourceTypeIsNotCustom The operation is not allowed because the resource type is not Custom.
    400 MissingParam.CidrOrCidrMask The CIDR or CIDR Mask must be input.
    400 OperationDenied.IpamPoolNotInRegion The operation is not allowed because the IPAM pool not in specific region does not support creating VPC or associating CIDR for VPC.
    400 OperationDenied.RequestRegionInvalid The operation is not allowed because the request is not invoked in the region of the IPAM pool.
    400 IllegalParam.Cidr The specified CIDR is illegal.
    400 IllegalParam.CidrMask The specified CidrMask is illegal.
    400 DryRunOperation Request validation has been passed with DryRun flag set.
    400 OperationDenied.AvailableCidrInsufficient The operation is not allowed because available CIDR is insufficient.
    400 OperationDenied.CidrInExcludeCidrs The operation is not allowed because the input CIDR is within the illegal CIDRs.
    400 OperationDenied.CidrUnavailableInPool The operation is not allowed because the CIDR is unavailable in the IPAM pool.
    400 OperationDenied.CidrMaskTooLarge The operation is denied because the CIDR mask %s is larger than the allocationMaxNetmask %s of the pool.
    400 OperationDenied.CidrMaskTooSmall The operation is denied because the CIDR mask %s is less than the allocationMinNetmask %s of the pool.
    404 ResourceNotFound.IpamPool The dependent IPAM pool is not found.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.