All Products
Search
Document Center

Elastic IP Address:CreatePublicIpAddressPool

Last Updated:Jun 12, 2026

Membuat kumpulan alamat IP dengan memanggil operasi CreatePublicIpAddressPool.

Deskripsi operasi

Fitur kumpulan alamat IP dinonaktifkan secara default. Untuk menggunakan fitur ini, ajukan permohonan kuota fitur kumpulan alamat IP di Quota Center. Untuk informasi lebih lanjut, lihat Meningkatkan kuota melalui Quota Center.

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

Tipe lini. Nilai yang valid:

  • BGP (default): Lini BGP (Multi-ISP).

  • BGP_PRO: Lini BGP (Multi-ISP) _Pro.

Untuk informasi lebih lanjut tentang lini BGP (Multi-ISP) dan lini BGP (Multi-ISP) Pro, lihat Tipe lini EIP.

  • Jika Anda diizinkan menggunakan bandwidth single-ISP, Anda juga dapat memilih salah satu tipe 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 Hangzhou Finance Cloud, parameter ini wajib diisi dan harus diatur ke BGP_FinanceCloud.

BGP

Name

string

No

Nama kumpulan alamat IP.

Panjangnya harus 0 hingga 128 karakter dan tidak boleh diawali dengan http:// atau https://.

AddressPoolName

Description

string

No

Deskripsi kumpulan alamat IP.

Panjangnya harus 0 hingga 256 karakter dan tidak boleh diawali dengan http:// atau https://.

AddressPoolDescription

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

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

Catatan

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

02fb3da4-130e-11****

DryRun

boolean

No

Menentukan apakah hanya melakukan pemeriksaan awal terhadap permintaan. Nilai yang valid:

  • true: melakukan pemeriksaan awal terhadap permintaan tetapi tidak membuat kumpulan alamat IP. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan, format permintaan, dan batasan layanan. Jika permintaan gagal pemeriksaan awal, pesan kesalahan yang sesuai akan dikembalikan. Jika permintaan lulus pemeriksaan awal, kode kesalahan DryRunOperation akan dikembalikan.

  • false (default): mengirim permintaan. Setelah permintaan lulus pemeriksaan awal, kode status HTTP 2xx akan dikembalikan dan operasi dilakukan.

false

ResourceGroupId

string

No

ID grup sumber daya tempat kumpulan alamat IP berada.

rg-acfmxazb4pcdvf****

RegionId

string

Yes

ID region kumpulan alamat IP yang akan dibuat.

cn-chengdu

BizType

string

No

Tipe layanan kumpulan alamat IP. Nilai yang valid:

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

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

Default

Zones

array

No

Zona kumpulan alamat IP. Parameter ini hanya diperlukan ketika BizType diatur ke CloudBox, yang berarti tipe layanan kumpulan alamat IP adalah CloudBox.

string

No

Zona kumpulan alamat IP. Parameter ini hanya diperlukan ketika BizType diatur ke CloudBox, yang berarti tipe layanan kumpulan alamat IP adalah CloudBox. Hanya satu zona yang didukung.

ap-southeast-1-lzdvn-cb

Tag

array<object>

No

Tag sumber daya.

object

No

Tag.

Key

string

No

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

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

FinanceDept

Value

string

No

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

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

FinanceJoshua

SecurityProtectionTypes

array

No

Tingkat perlindungan.

  • Jika Anda mengosongkan parameter ini, Anti-DDoS Basic digunakan secara default.

  • Jika Anda mengatur parameter ini ke AntiDDoS_Enhanced, Anti-DDoS Pro/Premium digunakan.

string

No

Tingkat perlindungan.

  • Jika Anda mengosongkan parameter ini, Anti-DDoS Basic digunakan secara default.

  • Jika Anda mengatur parameter ini ke AntiDDoS_Enhanced, Anti-DDoS Pro/Premium digunakan.

AntiDDoS_Enhanced

Elemen respons

Element

Type

Description

Example

object

Data yang dikembalikan.

PulbicIpAddressPoolId deprecated

string

ID kumpulan alamat IP.

pippool-6wetvn6fumkgycssx****

RequestId

string

ID permintaan.

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

ResourceGroupId

string

ID grup sumber daya tempat kumpulan alamat IP berada.

rg-acfmxazb4pcdvf****

PublicIpAddressPoolId

string

ID kumpulan alamat IP.

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.
400 IllegalParam.Name The param of Name [%s] is illegal.
400 IllegalParam.Description The param of Description [%s] is illegal.
400 Forbidden.CreatePublicIpAddressPool Authentication is failed for creating public ip address pool.
400 QuotaExceeded.PublicIpAddressPool The quota of PublicIpAddressPool is exceeded.
400 MissingParam.Zones The Zones parameter is required.
400 UnsupportedRegion The feature is not supported in current region.
400 IllegalParam.Zones The values of Zones [%s] are invalid.
400 IllegalParamSize.Zones An invalid number of zones is specified.
400 UnsupportedFeature.Isp The feature of Isp is not supported.
400 OperationDenied.ISPNotSupportDdosEnhanced The operation is not allowed because of DdosEnhanced is not supported by current isp.
400 IllegalParam.SecurityProtectionTypes The param of securityProtectionTypes is illegal.
400 IncorrectBusinessStatus.PublicIpAddressPool The business status of publicIpAddressPool is incorrect.
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.