All Products
Search
Document Center

Elastic IP Address:CreatePublicIpAddressPool

Last Updated:Jul 07, 2026

Membuat kolam alamat IP dengan memanggil operasi CreatePublicIpAddressPool.

Deskripsi operasi

Fitur kolam alamat IP tidak tersedia secara default. Untuk menggunakan fitur ini, ajukan kuota hak istimewa fitur kolam alamat IP di Pusat Kuota. Untuk informasi lebih lanjut, lihat Meningkatkan kuota di Pusat Kuota.

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

Isp

string

No

Jenis jalur. Nilai valid:

  • BGP (default): Jalur BGP (multi-ISP).

  • BGP_PRO: Jalur premium BGP (multi-ISP).

Untuk informasi lebih lanjut tentang jalur BGP (multi-ISP) dan jalur premium BGP (multi-ISP), lihat Jenis jalur EIP.

  • Jika Anda adalah pengguna daftar putih untuk bandwidth single-ISP, Anda juga dapat memilih jenis berikut:
    • ChinaTelecom: China Telecom

    • ChinaUnicom: China Unicom

    • ChinaMobile: China Mobile

    • ChinaTelecom_L2: China Telecom L2

    • ChinaUnicom_L2: China Unicom L2

    • ChinaMobile_L2: China Mobile L2

  • Jika Anda adalah pengguna Cloud Keuangan China (Hangzhou), parameter ini wajib diisi. Atur nilainya menjadi BGP_FinanceCloud.

BGP

Name

string

No

Nama instans kolam alamat IP.

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

AddressPoolName

Description

string

No

Deskripsi instans kolam alamat IP.

Panjang deskripsi harus 0 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.

AddressPoolDescription

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 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.

02fb3da4-130e-11****

DryRun

boolean

No

Apakah akan menjalankan dry run. Nilai valid:

  • true: Menjalankan dry run tanpa membuat kolam alamat IP. Sistem memeriksa parameter yang diperlukan, sintaks permintaan, dan batasan bisnis. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

  • false (default): Menjalankan dry run dan mengirimkan permintaan. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan operasi akan dilakukan.

false

ResourceGroupId

string

No

ID kelompok sumber daya tempat kolam alamat IP berada.

rg-acfmxazb4pcdvf****

RegionId

string

Yes

ID wilayah dari kolam alamat IP yang ingin Anda buat.

cn-chengdu

BizType

string

No

Tipe bisnis kolam alamat IP. Nilai valid:

  • CloudBox: CloudBox. Hanya pengguna CloudBox yang dapat memilih tipe ini.

  • Default (default): menunjukkan tipe non-khusus.

Default

Zones

array

No

Zona dari kolam alamat IP. Parameter ini wajib diisi hanya jika BizType diatur ke CloudBox, yang menunjukkan bahwa tipe bisnis kolam alamat IP adalah CloudBox.

string

No

Zona dari kolam alamat IP. Parameter ini wajib diisi hanya jika BizType diatur ke CloudBox, yang menunjukkan bahwa tipe bisnis kolam alamat IP adalah CloudBox. Hanya satu zona yang dapat ditentukan.

ap-southeast-1-lzdvn-cb

Tag

array<object>

No

Tag Sumber daya.

object

No

Tag.

Key

string

No

Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

Panjang kunci tag maksimal 128 karakter dan tidak boleh dimulai 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. Nilai tag dapat berupa string kosong.

Panjang nilai tag maksimal 128 karakter dan tidak boleh dimulai dengan aliyun atau acs:. Nilai tag tidak boleh mengandung http:// atau https://.

FinanceJoshua

SecurityProtectionTypes

array

No

Tingkat perlindungan keamanan.

  • Jika parameter ini dibiarkan kosong, Perlindungan DDoS (Dasar) akan digunakan secara default.

  • Jika parameter ini diatur ke AntiDDoS_Enhanced, Perlindungan DDoS (Ditingkatkan) akan digunakan.

string

No

Tingkat perlindungan keamanan.

  • Jika parameter ini dibiarkan kosong, Perlindungan DDoS (Dasar) akan digunakan secara default.

  • Jika parameter ini diatur ke AntiDDoS_Enhanced, Perlindungan DDoS (Ditingkatkan) akan digunakan.

AntiDDoS_Enhanced

Elemen respons

Element

Type

Description

Example

object

Struktur tanggapan.

PulbicIpAddressPoolId deprecated

string

ID instans kolam IPAM.

pippool-6wetvn6fumkgycssx****

RequestId

string

ID permintaan.

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

ResourceGroupId

string

ID kelompok sumber daya tempat kolam alamat IP berada.

rg-acfmxazb4pcdvf****

PublicIpAddressPoolId

string

ID instans kolam IPAM.

pippool-6wetvn6fumkgycssx****

Contoh

Respons sukses

JSONformat

{
  "PulbicIpAddressPoolId": "pippool-6wetvn6fumkgycssx****",
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "ResourceGroupId": "rg-acfmxazb4pcdvf****",
  "PublicIpAddressPoolId": "pippool-6wetvn6fumkgycssx****"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalParam.Isp The param of Isp [%s] is illegal. Parameter Isp tidak valid. Masukkan nilai valid seperti yang ditentukan dalam parameter permintaan.
400 IllegalParam.Name The param of Name [%s] is illegal. Parameter Name tidak valid. Masukkan nilai yang valid sesuai dengan persyaratan parameter permintaan.
400 IllegalParam.Description The param of Description [%s] is illegal. Parameter Description tidak valid.
400 Forbidden.CreatePublicIpAddressPool Authentication is failed for creating public ip address pool. Anda tidak dapat membuat PublicIpAddressPool pada waktu ini. Periksa apakah akun Anda diotorisasi untuk melakukan operasi ini.
400 QuotaExceeded.PublicIpAddressPool The quota of PublicIpAddressPool is exceeded. Jumlah PublicIpAddressPools telah mencapai kuota. Tingkatkan kuota sebelum melanjutkan.
400 MissingParam.Zones The Zones parameter is required. Parameter Zones diperlukan.
400 IllegalParam.Zones The values of Zones [%s] are invalid. Parameter Zones tidak valid.
400 IllegalParamSize.Zones An invalid number of zones is specified. Ukuran array Zones tidak valid.
400 UnsupportedFeature.Isp The feature of Isp is not supported. Isp yang ditentukan tidak didukung.
400 OperationDenied.ISPNotSupportDdosEnhanced The operation is not allowed because of DdosEnhanced is not supported by current isp. ISP saat ini tidak mendukung pembuatan kolam alamat perlindungan keamanan yang ditingkatkan.
400 IllegalParam.SecurityProtectionTypes The param of securityProtectionTypes is illegal. Parameter SecurityProtectionTypes tidak valid.
400 IncorrectBusinessStatus.PublicIpAddressPool The business status of publicIpAddressPool is incorrect. Status layanan saat ini tidak mendukung pembuatan instans kolam alamat IP.
400 OptInRequired.PublicIpAddressPool You are not authorized to use the requested service of publicIpAddressPool. Ensure that you have subscribed to the service you are trying to use. Anda tidak memiliki izin untuk menggunakan layanan IP Address Manager yang diminta. Pastikan Anda telah berlangganan layanan tersebut.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.