All Products
Search

This Product

    Elastic IP Address:AddPublicIpAddressPoolCidrBlock

    Document Center

    Elastic IP Address:AddPublicIpAddressPoolCidrBlock

    Last Updated:Jun 12, 2026

    Memanggil antarmuka AddPublicIpAddressPoolCidrBlock untuk menambahkan segmen jaringan alamat IP ke kumpulan alamat IP.

    Deskripsi operasi

    Saat memanggil antarmuka ini, harap pahami hal-hal berikut:

    • Segmen jaringan alamat IP dan kumpulan alamat IP harus berada di region yang sama.

    • Segmen jaringan alamat IP dan kumpulan alamat IP harus memiliki tipe jalur ISP yang sama.

    • Antarmuka AddPublicIpAddressPoolCidrBlock adalah antarmuka asinkron, yaitu sistem akan terlebih dahulu mengembalikan ID permintaan, namun segmen jaringan alamat IP belum selesai ditambahkan, tugas penambahan di latar belakang sistem masih berlangsung. Anda dapat memanggil ListPublicIpAddressPoolCidrBlocks untuk meninjau status segmen jaringan alamat IP di kumpulan alamat IP.

      • Ketika segmen jaringan alamat IP berada dalam status Modifying, ini menunjukkan bahwa segmen jaringan alamat IP sedang dalam proses ditambahkan. Pada status ini, Anda hanya dapat melakukan operasi peninjauan, tidak dapat melakukan operasi lainnya.

      • Ketika segmen jaringan alamat IP berada dalam status Created, ini menunjukkan bahwa penambahan segmen jaringan alamat IP telah selesai.

    • Antarmuka AddPublicIpAddressPoolCidrBlock tidak mendukung penambahan segmen jaringan alamat IP yang sama ke kumpulan alamat IP secara bersamaan.

    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
    PublicIpAddressPoolId

    string

    Yes

    ID instance dari kumpulan alamat IP.

    pippool-6wetvn6fumkgycssx****
    CidrBlock

    string

    No

    Segmen jaringan alamat IP.

    Catatan

    Tidak mendukung konfigurasi CidrBlock dan CidrMask secara bersamaan, silakan pilih salah satu untuk dikonfigurasi.

    47.0.XX.XX/24
    ClientToken

    string

    No

    Token klien, digunakan untuk menjamin idempotensi permintaan.

    Hasilkan nilai parameter dari klien Anda, pastikan nilai parameter tersebut unik antar permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII.

    Catatan

    Jika Anda tidak menentukannya, sistem akan secara otomatis menggunakan RequestId dari permintaan API sebagai identifier ClientToken. Setiap permintaan API memiliki RequestId yang berbeda.

    02fb3da4-130e-11****
    DryRun

    boolean

    No

    Apakah hanya melakukan pra-pemeriksaan untuk permintaan ini. Nilainya:

    • true: Mengirim permintaan pemeriksaan, segmen jaringan tidak akan ditambahkan. Item pemeriksaan mencakup apakah parameter yang diperlukan telah diisi, format permintaan, dan batasan bisnis. Jika pemeriksaan gagal, akan dikembalikan kesalahan yang sesuai. Jika pemeriksaan lulus, akan dikembalikan kode kesalahan DryRunOperation.

    • false (nilai default): Mengirim permintaan normal, setelah lulus pemeriksaan akan mengembalikan kode status HTTP 2xx dan langsung melakukan operasi.

    false
    RegionId

    string

    Yes

    ID region tempat kumpulan alamat IP yang akan ditambahkan segmen jaringannya berada.

    cn-chengdu
    CidrMask

    integer

    No

    Mask segmen jaringan alamat IP. Setelah memasukkan mask, sistem akan secara otomatis mengalokasikan segmen jaringan alamat IP.

    Rentang nilai: 24~28.

    Catatan

    Tidak mendukung konfigurasi CidrBlock dan CidrMask secara bersamaan, silakan pilih salah satu untuk dikonfigurasi.

    24

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Struktur data yang dikembalikan.

    RequestId

    string

    ID permintaan.

    4EC47282-1B74-4534-BD0E-403F3EE64CAF
    CidrBlock

    string

    Segmen alamat IP.

    47.0.XX.XX/28

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "CidrBlock": "47.0.XX.XX/28"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 IllegalParam.CidrBlock The param of CidrBlock [%s] is illegal.
    400 IllegalParam.CidrBlockMask The param of CidrBlock Mask [%s] is illegal.
    400 IncorrectStatus.PublicIpAddressPool The status of PublicIpAddressPool [%s] is incorrect.
    400 OperationDenied.CidrBlockBelongToOtherUser The operation is not allowed because of CidrBlock belong to other user.
    400 ResourceNotFound.PublicIpAddressPool The specified resource ofPublicIpAddressPool [%s] is not found.
    400 QuotaExceeded.PoolIpQuantity The quota of PoolIpQuantity is exceeded.
    400 OperationDenied.OperateSharedResource The operation is not allowed because of the PublicIpAddressPool is a shared resource.
    400 MissingParam.CidrBlockOrCidrMask CidrBlock or CidrMask is not specified.
    400 DuplicatedParam.CidrBlockAndCidrMask CidrBlock and CidrMask cannot be specified at the same time.
    400 Forbidden.FinancialLocked The instance is locked due to outstanding payments.
    400 ResourceNotEnough.CidrBlock The specified resource is not enough.
    400 MissingParam.PublicIpAddressPoolId The parameter PublicIpAddressPoolId is missing.
    400 OperationFailed.ResourceNotEnough Insufficient resources.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.