AllocateEipAddress - Elastic IP Address - Alibaba Cloud Documentation Center

Mengajukan elastic IP address (EIP).

Deskripsi operasi

Pastikan Anda memahami metode penagihan dan harga EIP sebelum memanggil operasi ini. Untuk informasi lebih lanjut, lihat Ikhtisar penagihan.

Setelah Anda memanggil operasi ini, sebuah EIP dalam status Available akan dialokasikan secara acak di wilayah yang ditentukan. EIP hanya mendukung ICMP, TCP, dan UDP pada lapisan transport. IGMP dan SCTP tidak didukung.

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:AllocateEipAddress

create

*Address

acs:vpc:{#regionId}:{#accountId}:eip/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah EIP. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah. Valid values: cn-beijing : cn-beijing.	cn-hangzhou
Bandwidth	string	No	Bandwidth maksimum EIP. Unit: Mbit/s. Jika InstanceChargeType diatur ke PostPaid dan InternetChargeType diatur ke PayByBandwidth, nilai valid untuk Bandwidth adalah 1 hingga 500. Jika InstanceChargeType diatur ke PostPaid dan InternetChargeType diatur ke PayByTraffic, nilai valid untuk Bandwidth adalah 1 hingga 200. Jika InstanceChargeType diatur ke PrePaid, nilai valid untuk Bandwidth adalah 1 hingga 1000. Nilai default: 5 Mbit/s.	5
Period	integer	No	Durasi langganan. Jika PricingCycle diatur ke Month, nilai valid untuk Period adalah 1 hingga 9. Jika PricingCycle diatur ke Year, nilai valid untuk Period adalah 1 hingga 5. Parameter ini wajib diisi jika InstanceChargeType diatur ke PrePaid. Parameter ini tidak wajib diisi jika InstanceChargeType diatur ke PostPaid.	1
ISP	string	No	Jenis jalur. Nilai valid: BGP (default): Jalur BGP (multi-ISP). Semua wilayah mendukung EIP BGP (multi-ISP). BGP_PRO: Jalur BGP (multi-ISP) Pro. Hanya wilayah Hong Kong (China), Singapura, Tokyo (Jepang), Kuala Lumpur (Malaysia), Manila (Filipina), Jakarta (Indonesia), dan Bangkok (Thailand) yang mendukung EIP BGP (multi-ISP) Pro. Untuk informasi lebih lanjut tentang jalur BGP (multi-ISP) dan BGP (multi-ISP) Pro, 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 dan harus diatur ke BGP_FinanceCloud.	BGP
ActivityId	integer	No	ID aktivitas khusus. Anda tidak perlu mengonfigurasi parameter ini.	123456
Netmode	string	No	Jenis jaringan. Nilainya adalah public (default), yang menentukan jaringan publik.	public
AutoPay	boolean	No	Apakah akan mengaktifkan pembayaran otomatis. Nilai valid: false (default): Pembayaran otomatis dinonaktifkan. Setelah pesanan dibuat, buka Pusat Pesanan untuk menyelesaikan pembayaran. true: Pembayaran otomatis diaktifkan. Pesanan dibayar secara otomatis. Parameter ini wajib diisi jika InstanceChargeType diatur ke PrePaid. Parameter ini opsional jika InstanceChargeType diatur ke PostPaid.	false
PricingCycle	string	No	Siklus penagihan langganan. Nilai valid: Month (default): ditagih bulanan. Year: ditagih tahunan. Parameter ini wajib diisi jika InstanceChargeType diatur ke PrePaid. Parameter ini opsional jika InstanceChargeType diatur ke PostPaid.	Month
InstanceChargeType	string	No	Metode penagihan EIP. Nilai valid: PrePaid: langganan. PostPaid (default): bayar sesuai pemakaian. Jika InstanceChargeType diatur ke PrePaid, InternetChargeType harus diatur ke PayByBandwidth. Jika InstanceChargeType diatur ke PostPaid, InternetChargeType dapat diatur ke PayByBandwidth atau PayByTraffic.	PostPaid
InternetChargeType	string	No	Metode pengukuran EIP. Nilai valid: PayByBandwidth (default): bayar berdasarkan bandwidth. PayByTraffic: bayar berdasarkan transfer data. Jika InstanceChargeType diatur ke PrePaid, InternetChargeType harus diatur ke PayByBandwidth. Jika InstanceChargeType diatur ke PostPaid, InternetChargeType dapat diatur ke PayByBandwidth atau PayByTraffic.	PayByTraffic
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-acfmxazffggds****
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Buat nilai parameter dari klien Anda untuk memastikan keunikan antar permintaan berbeda. ClientToken hanya mendukung karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	0c593ea1-3bea-11e9-b96b-88e9fe637760
Name	string	No	Nama instans EIP. Panjang nama harus 0 hingga 128 karakter dan tidak boleh dimulai dengan `http://` atau `https://`. Catatan Parameter ini tidak didukung saat Anda membuat instans EIP langganan.	EIP1
Description	string	No	Deskripsi instans EIP. Panjang deskripsi harus 0 hingga 256 karakter dan tidak boleh dimulai dengan `http://` atau `https://`. Catatan Parameter ini tidak didukung saat Anda membuat instans EIP langganan.	test
SecurityProtectionTypes	array	No	Tingkat perlindungan keamanan. Jika parameter ini dibiarkan kosong, nilai defaultnya adalah Anti-DDoS Origin Basic. Jika parameter ini diatur ke AntiDDoS_Enhanced, Anti-DDoS Origin Enterprise digunakan. Anda dapat menentukan paling banyak satu tingkat perlindungan keamanan.	AntiDDoS_Enhanced
	string	No	Tingkat perlindungan keamanan. Jika parameter ini dibiarkan kosong, nilai defaultnya adalah Anti-DDoS Origin Basic. Jika parameter ini diatur ke AntiDDoS_Enhanced, Anti-DDoS Origin Enterprise digunakan.	AntiDDoS_Enhanced
PublicIpAddressPoolId	string	No	ID kolam alamat pengatur waktu. EIP dialokasikan dari kolam alamat pengatur waktu yang ditentukan. Fitur kolam alamat pengatur waktu tidak tersedia secara default. Untuk menggunakan fitur ini, ajukan kuota hak istimewa kolam alamat pengatur waktu di Pusat Kuota. Untuk informasi lebih lanjut, lihat Meningkatkan kuota di Pusat Kuota.	pippool-2vc0kxcedhquybdsz****
Zone	string	No	Zona EIP. Ketika kolam alamat IP yang ditentukan oleh PublicIpAddressPoolId bertipe CloudBox, parameter ini secara default mengikuti zona kolam alamat IP. Untuk informasi tentang cara melihat format jenis bisnis kolam alamat IP, lihat ListPublicIpAddressPools.	ap-southeast-1-lzdvn-cb
IpAddress	string	No	Alamat IP EIP yang ingin Anda ajukan. Anda hanya perlu menentukan salah satu dari IpAddress dan InstanceId. Jika keduanya tidak ditentukan, sistem akan mengalokasikan EIP secara acak.	192.0.XX.XX
InstanceId	string	No	ID instans EIP yang ingin Anda ajukan. Anda hanya perlu menentukan salah satu dari IpAddress dan InstanceId. Jika keduanya tidak ditentukan, sistem akan mengalokasikan EIP secara acak.	eip-25877c70gddh****
Tag	array<object>	No	Tag Sumber daya.
	object	No
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. Tidak boleh dimulai dengan `aliyun` atau `acs:` dan tidak boleh mengandung `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag. Tentukan nilai dalam format Tag.N.Value. Nilai valid N: 1 hingga 20. Nilai tag tidak boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter. Tidak boleh dimulai dengan aliyun atau acs: dan tidak boleh mengandung http:// atau https://.	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
OrderId	integer	ID pesanan. Parameter ini dikembalikan ketika InstanceChargeType (metode penagihan EIP) diatur ke PrePaid (langganan). Jika AutoPay (pembayaran otomatis) tidak diaktifkan, buka Pusat Pesanan untuk menyelesaikan pembayaran.	10
ResourceGroupId	string	ID kelompok sumber daya. Parameter ini hanya dikembalikan jika InstanceChargeType diatur ke PostPaid.	rg-acfmxazfdgdg****
EipAddress	string	EIP yang dialokasikan. Parameter ini hanya dikembalikan jika InstanceChargeType diatur ke PostPaid.	192.0.XX.XX
AllocationId	string	ID instans EIP.	eip-25877c70gddh****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "OrderId": 10,
  "ResourceGroupId": "rg-acfmxazfdgdg****",
  "EipAddress": "192.0.XX.XX",
  "AllocationId": "eip-25877c70gddh****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InsufficientBalance	Your account does not have enough balance.
400	InvalidParameter	Specified value of "InternetChargeType" is not valid
400	ReserveIpFail	Reserve eip failed.
400	InvalidRegion.NotSupport	The specified region does not support.
400	InvalidBandwidth.Malformed	The specified Bandwidth is invalid.
400	INSTANCE_TYPE_NOT_SUPPORT	The instance type is invalid.
400	QueryParameter.Illegal	query parameter illegal
400	QuotaExceeded.LargeSpecEip	Elastic IP address with large spec quota exceeded.
400	InvalidResourceGroupId	The specified ResourceGroupId does not exist.	ID kelompok sumber daya tidak ada.
400	OperationFailed.InsufficientEIP	Eip resource is not enough.
400	FrequentPurchase.EIP	eip frequent purchase
400	IellgalParameter.OwnerAccount	The specified parameter OwnerAccount is not valid.	Parameter OwnerAccount yang ditentukan tidak valid.
400	ResourceNotFound.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not found.
400	ResourceNotEnough.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not enough.
400	Mismatch.IpAndPublicIpAddressPool	The Ip and PublicIpAddressPool are mismatched.
400	OperationDenied.NotOpenDdosOriginProtectService	The operation is not allowed because of you do not open Ddos Origin Protection Service	Gagal membuat EIP dengan Anti-DDoS (Enhanced) diaktifkan karena layanan Anti-DDoS Origin belum dibeli.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	Instans kolam alamat tidak berada dalam status stabil. Alokasi EIP tidak diizinkan.
400	IllegalParam.Isp	The param of %s is illegal.	Parameter Isp tidak valid. Masukkan nilai valid seperti yang ditentukan dalam parameter permintaan.
400	ExclusiveParam.ZoneAndPublicIpAddressPoolId	The Zone and PublicIpAddressPoolId parameters are mutually exclusive.	Parameter Zone dan PublicIpAddressPoolId tidak dapat ditentukan pada waktu yang sama.
400	IllegalParam.Zone	The specified zone is invalid.	Parameter Zone tidak valid.
400	OperationFailed.AllocateUnfamiliarIp	The operation failed because only IP addresses used within the last seven days can be allocated.	Anda hanya dapat menentukan alamat IP yang digunakan dalam 7 hari terakhir saat meminta EIP.
400	Ip.Allocated	The reserve ip has been allocated.	Alamat IP yang dipesan telah dialokasikan.
400	IncorrectStatus.Ip	The status of ip is incorrect.	Status alamat IP tidak benar.
400	UnsupportedFeature.AllocateEipAddressWithZone	The feature of AllocateEipAddressWithZone is not supported.	Pembuatan instans di zona yang ditentukan tidak didukung di wilayah saat ini.
400	ResourceNotFound.Ip	The specified ip is not found.	Alamat IP yang ditentukan tidak dapat ditemukan.
400	OperationFailed.ResourceNotEnough	The resources you have applied for are insufficient.	Sumber daya yang diminta tidak mencukupi. Jika Anda masih perlu mengajukan, kirimkan tiket.
400	IllegalParam.Bandwidth	The param of bandwidth is illegal.	Parameter Bandwidth yang ditentukan tidak valid. Ubah parameter berdasarkan deskripsi data deret waktu dalam referensi API dan coba lagi.
400	OperationFailed.IpIsLocked	The operation is failed because of ip is locked.	Permintaan gagal karena alamat IP terkunci.
400	Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionType	The EipSecurityProtectionType and PoolSecurityProtectionType are mismatched.	Tipe perlindungan keamanan EIP tidak cocok dengan tipe perlindungan keamanan kolam alamat.
400	IllegalParam.SecurityProtectionTypes	The param of securityProtectionTypes is illegal.	Parameter SecurityProtectionTypes tidak valid.
400	IllegalParam.ServiceLocation	The param of serviceLocation is illegal.	Parameter ServiceLocation tidak valid.
400	UnsupportedFeature.Isp	The feature of Isp is not supported.	Isp yang ditentukan tidak didukung.
400	ExclusiveParam.ZoneAndIpAddress	The specified param Zone and IpAddress or InstanceId are mutually exclusive.	Parameter Zone yang ditentukan bertentangan dengan parameter IpAddress atau InstanceId.
400	InvalidDescription.Malformed	The Description is illeagl.	Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400	InvalidName.Malformed	The attribute name is illegal.	Nilai parameter Name tidak valid.
400	OperationFailed.UpgradeCdtServiceFirst	The operation is failed because of cdt is not upgraded.	Tipe instans yang Anda tentukan memerlukan peningkatan penagihan Cloud Data Transfer (CDT). Tingkatkan CDT dan coba lagi.
400	OperationFailed.TokenExpired	The operation is failed because of TokenExpired.	Token alokasi EIP yang ditentukan telah kedaluwarsa.
403	Forbidden	User not authorized to operate on the specified resource.	EIP bukan milik pemanggil saat ini. Periksa apakah Anda memiliki izin untuk menggunakan EIP ini.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.