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 jalur BGP (multi-ISP). BGP_PRO: Jalur BGP (multi-ISP) Pro. Hanya wilayah berikut yang mendukung EIP jalur BGP (multi-ISP) Pro: Hong Kong (China), Singapura, Jepang (Tokyo), Malaysia (Kuala Lumpur), Filipina (Manila), Indonesia (Jakarta), dan Thailand (Bangkok). Untuk informasi lebih lanjut tentang jalur BGP (multi-ISP) dan jalur 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), bidang ini wajib diisi. Atur nilainya ke BGP_FinanceCloud.	BGP
ActivityId	integer	No	ID aktivitas khusus. Anda tidak perlu mengonfigurasi parameter ini.	123456
Netmode	string	No	Jenis jaringan. Nilainya diatur ke 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 dari klien Anda untuk memastikan keunikan di berbagai permintaan. ClientToken hanya mendukung karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem 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 Basic. Jika parameter ini diatur ke AntiDDoS_Enhanced, nilainya menunjukkan Anti-DDoS (Enhanced). 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 Basic. Jika parameter ini diatur ke AntiDDoS_Enhanced, nilainya menunjukkan Anti-DDoS (Enhanced).	AntiDDoS_Enhanced
PublicIpAddressPoolId	string	No	ID kolam alamat pengatur waktu IP. EIP dialokasikan dari kolam alamat pengatur waktu IP yang ditentukan. Fitur kolam alamat pengatur waktu IP tidak diaktifkan secara default. Untuk menggunakan fitur ini, ajukan kuota hak istimewa kolam alamat pengatur waktu IP di Pusat Kuota. Untuk informasi lebih lanjut, lihat Meningkatkan kuota di Pusat Kuota.	pippool-2vc0kxcedhquybdsz****
Zone	string	No	Zona EIP. Jika 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 jika 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	EIP dengan Anti-DDoS (Enhanced) yang diaktifkan tidak dapat dibuat karena layanan Anti-DDoS Origin belum dibeli.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	EIP tidak dapat dialokasikan karena status kolam alamat tidak valid.
400	IllegalParam.Isp	The param of %s is illegal.	EIP tidak dapat dialokasikan karena parameter ISP tidak valid.
400	ExclusiveParam.ZoneAndPublicIpAddressPoolId	The Zone and PublicIpAddressPoolId parameters are mutually exclusive.	Parameter Zone dan PublicIpAddressPoolId tidak dapat ditentukan secara bersamaan.
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.	Aplikasi EIP yang ditentukan hanya memungkinkan Anda mengajukan alamat IP yang digunakan dalam 7 hari terakhir.
400	Ip.Allocated	The reserve ip has been allocated.	Alamat IP yang dipesan sudah ditetapkan.
400	IncorrectStatus.Ip	The status of ip is incorrect.	Alamat IP berada dalam status yang salah.
400	UnsupportedFeature.AllocateEipAddressWithZone	The feature of AllocateEipAddressWithZone is not supported.	Zona yang ditentukan tidak mendukung pembuatan instans di wilayah saat ini.
400	ResourceNotFound.Ip	The specified ip is not found.	Alamat IP yang ditentukan tidak ditemukan.
400	OperationFailed.ResourceNotEnough	The resources you have applied for are insufficient.	Sumber daya yang diminta tidak mencukupi. Untuk melanjutkan permintaan, kirimkan tiket.
400	IllegalParam.Bandwidth	The param of bandwidth is illegal.	Bandwidth yang ditentukan tidak valid.
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 yang ditentukan 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 berkonflik dengan parameter IpAddress atau InstanceId.
400	InvalidDescription.Malformed	The Description is illeagl.	Format deskripsi Sumber daya yang ditentukan tidak valid. Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400	InvalidName.Malformed	The attribute name is illegal.	Format nama yang ditentukan 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.
400	QuotaExceeded.LocalISPBasicEip	The quota for Local ISP Provider EIP has been exceeded.	Kuota EIP LocalISPBasic telah terlampaui.
400	QuotaExceeded.LocalISPEip	The quota for Local ISP EIPs has been exceeded.	Kuota LocalISP telah terlampaui.
403	Forbidden	User not authorized to operate on the specified resource.	Anda tidak memiliki izin untuk mengoperasikan Sumber daya yang ditentukan. Ajukan izin yang diperlukan dan coba lagi.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.