All Products
Search
Document Center

Elastic IP Address:TransformEipSegmentToPublicIpAddressPool

Last Updated:Jul 10, 2026

Memigrasikan kelompok Elastic IP Address (EIP) yang berdekatan ke kolam alamat IP.

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

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

vpc:TransformEipSegmentToPublicIpAddressPool

create

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans kelompok EIP yang berdekatan untuk dimigrasikan.

eipsg-2zett8ba055tbsxme****

RegionId

string

Yes

ID wilayah kelompok EIP yang berdekatan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-hangzhou

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

ResourceGroupId

string

No

ID kelompok sumber daya kolam alamat IP.

rg-acfmxazb4pcdvf****

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token unik di antara berbagai permintaan. Nilai ClientToken hanya dapat berisi karakter ASCII.

Catatan

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

02fb3da4-130e-11****

Elemen respons

Element

Type

Description

Example

object

PublicIpAddressPoolId

string

ID instans kolam alamat IP.

pippool-6wetvn6fumkgycssx****

ResourceGroupId

string

ID kelompok sumber daya kolam alamat IP.

rg-acfmxazb4pcdvf****

RequestId

string

ID permintaan.

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 Forbidden.RAM The user is not authorized to operate on the specified resource, or the API operation does not support RAM. Otentikasi RAM gagal.
400 IllegalParam.Name The param of Name [%s] is illegal. Parameter Name tidak valid. Masukkan nilai yang valid berdasarkan 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 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 diizinkan menggunakan layanan IP Address Manager yang diminta. Pastikan Anda telah berlangganan layanan tersebut.
400 QuotaExceeded.PoolIpQuantity The quota of PoolIpQuantity is exceeded. Jumlah alamat IP dalam kolam alamat melebihi kuota. Untuk meningkatkan kuota, ajukan tiket atau hubungi manajer akun Anda.
400 ResourceNotFound.EipSegment The specified resource of Eip Segment is not found. Instans kelompok EIP yang berdekatan yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.