AllocateEipAddressPro - Elastic IP Address - Alibaba Cloud Documentation Center

Mengalokasikan elastic IP address (EIP) tertentu untuk kebutuhan konfigurasi jaringan spesifik.

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

create

*Address

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah EIP yang akan dialokasikan. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
IpAddress	string	No	Alamat IP EIP yang akan dialokasikan. Anda hanya perlu menentukan salah satu parameter IpAddress atau InstanceId. Jika keduanya tidak ditentukan, sistem akan mengalokasikan EIP secara acak.	192.0.XX.XX
InstanceId	string	No	ID instans EIP yang akan dialokasikan. Anda hanya perlu menentukan salah satu parameter IpAddress atau InstanceId. Jika keduanya tidak ditentukan, sistem akan mengalokasikan EIP secara acak.	eip-25877c70gddh****
Bandwidth	string	No	Bandwidth maksimum EIP yang akan dialokasikan. 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 3. Parameter ini wajib diisi jika InstanceChargeType diatur ke PrePaid. Jangan atur parameter ini 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, Malaysia (Kuala Lumpur), Filipina (Manila), Indonesia (Jakarta), dan Thailand (Bangkok) 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. Atur nilainya ke BGP_FinanceCloud.	BGP
Netmode	string	No	Jenis jaringan. Nilainya hanya dapat berupa public (default), yang menunjukkan jaringan publik.	public
AutoPay	boolean	No	Apakah akan mengaktifkan pembayaran otomatis. Nilai valid: false: Menonaktifkan pembayaran otomatis. Setelah pesanan dibuat, buka Pusat Pesanan untuk menyelesaikan pembayaran. true: Mengaktifkan pembayaran otomatis. Pesanan dibayar secara otomatis. Parameter ini wajib diisi jika InstanceChargeType diatur ke PrePaid. Parameter ini opsional jika InstanceChargeType diatur ke PostPaid.	true
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 yang akan dialokasikan. 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 yang akan dialokasikan. 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.	PayByBandwidth
ResourceGroupId	string	No	ID kelompok sumber daya tempat EIP berada.	rg-resourcegroup****
Tag	array<object>	No
	object	No
Key	string	No
Value	string	No
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Buat nilai parameter 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-88e9fe6****
SecurityProtectionTypes	array	No	Tingkat perlindungan keamanan. Jika parameter ini dibiarkan kosong, Perlindungan DDoS (Dasar) digunakan secara default. Jika parameter ini diatur ke AntiDDoS_Enhanced, Perlindungan DDoS (Ditingkatkan) digunakan.
	string	No	Tingkat perlindungan keamanan. Jika parameter ini dibiarkan kosong, Perlindungan DDoS (Dasar) digunakan secara default. Jika parameter ini diatur ke AntiDDoS_Enhanced, Perlindungan DDoS (Ditingkatkan) digunakan.
PublicIpAddressPoolId	string	No	ID kolam alamat IP. EIP dialokasikan dari kolam alamat IP yang ditentukan. Fitur kolam alamat IP tidak tersedia secara default. Untuk menggunakan fitur ini, ajukan kuota hak istimewa kolam alamat IP di Pusat Kuota. Untuk informasi lebih lanjut, lihat Meningkatkan kuota di Pusat Kuota.	pippool-2vc0kxcedhquybdsz****

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 diatur ke false, yang berarti pembayaran otomatis tidak diaktifkan, buka Pusat Pesanan untuk menyelesaikan pembayaran.	20190000
ResourceGroupId	string	ID kelompok sumber daya. Parameter ini hanya dikembalikan jika InstanceChargeType diatur ke PostPaid.	rg-resourcegroup****
EipAddress	string	Alamat IP yang ditetapkan ke EIP tertentu. Parameter ini hanya dikembalikan jika InstanceChargeType diatur ke PostPaid.	192.0.XX.XX
AllocationId	string	ID EIP.	eip-25877c70gddh****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	FrequentPurchase.EIP	eip frequent purchase
400	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InvalidParameter	Specified value of "InternetChargeType" is not valid
400	ReserveIpFail	Reserve eip failed.
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	Invalid.Reserve.Ip	The reserve ip is invalid.
400	Ip.Allocated	The reserve ip has been allocated.	Alamat IP yang dipesan telah dialokasikan.
400	Ip.Keeped	The reserve ip been keeped in an hour.
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	INVALID_INSTANCE_STATUS	The instance status is invalid.
400	OperationFailed.InstanceNotExist	Eip instanceId does not exist.
400	InvalidStatus.ValueNotSupported	The specified status is not supported.
400	OperationFailed.RiskControl	Risk control check failed.	Risiko keamanan terdeteksi pada metode pembayaran Anda. Lanjutkan verifikasi melalui tautan di email atau Paket konsol, dan kirimkan ulang pesanan setelah verifikasi.
400	ResourceNotEnough.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not enough.
400	Mismatch.IpAndPublicIpAddressPool	The Ip and PublicIpAddressPool are mismatched.
400	ResourceNotFound.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not found.
400	ResourceNotFound.Ip	The specified ip is not found.	Alamat IP yang ditentukan tidak dapat ditemukan.
400	OperationDenied.IpBelongToOtherUser	The operation is not allowed because of ip belong to other user.	Permintaan gagal. Alamat IP milik pengguna lain.
400	IncorrectStatus.Ip	The status of ip is incorrect.	Status alamat IP tidak benar.
400	OperationFailed.IpIsLocked	The operation is failed because of ip is locked.	Permintaan gagal karena alamat IP terkunci.
400	Mismatch.IpAndIsp	The specified IP address does not match the ISP.	Gagal meminta alamat IP yang ditentukan. Parameter ISP dan IP tidak cocok.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	Instans kolam alamat tidak berada dalam status stabil. Alokasi EIP tidak diizinkan.
400	IllegalParam.IpAddress	The specified IpAddress (%s) is illegal.	IpAddress yang ditentukan tidak valid.
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	Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionType	The EipSecurityProtectionType and PoolSecurityProtectionType are mismatched.	Tipe perlindungan keamanan EIP tidak cocok dengan tipe perlindungan keamanan kolam alamat.
400	IllegalParam.Isp	The param of Isp [%s] is illegal.	Parameter Isp tidak valid. Masukkan nilai valid seperti yang ditentukan dalam parameter permintaan.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan sistem internal.
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.