AllocatePublicIpAddress - - Alibaba Cloud Documentation Center

Menetapkan alamat IP publik ke instans Elastic Compute Service (ECS).

Description

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Instans yang akan diberi alamat IP publik harus berada dalam status Running (Running) atau Stopped (Stopped).
Jika OperationLocks dalam respons DescribeInstances berisi "LockReason" : "security" untuk suatu instans, instans tersebut terkunci karena alasan keamanan dan tidak dapat diberi alamat IP publik.
Anda hanya dapat menetapkan satu alamat IP publik ke satu instans. Jika instans tersebut sudah memiliki alamat IP publik, kode kesalahan AllocatedAlready akan dikembalikan.
Setelah menetapkan alamat IP publik ke instans, Anda harus melakukan restart instans (RebootInstance) atau menjalankan instans (StartInstance) agar alamat IP publik tersebut berlaku.

Jika suatu instans berada di virtual private cloud (VPC), Anda dapat menetapkan alamat IP publik ke instans tersebut atau mengasosiasikan elastic IP address (EIP) dengan instans tersebut. Untuk informasi selengkapnya, lihat AssociateEipAddress.

Catatan Setelah EIP diasosiasikan dengan instans yang berada di VPC, tidak ada alamat IP publik yang dapat ditetapkan ke instans tersebut.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	AllocatePublicIpAddress	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AllocatePublicIpAddress.
InstanceId	String	Yes	i-bp1gtjxuuvwj17zr****	ID instans yang akan diberi alamat IP publik.
IpAddress	String	No	112.124..	Alamat IP publik yang akan ditetapkan ke instans. Jika Anda mengosongkan parameter ini, sistem akan secara acak menetapkan alamat IP publik ke instans yang ditentukan.
VlanId	String	No	720	ID virtual LAN (VLAN) dari instans. Catatan Parameter ini akan dihapus di masa mendatang. Kami menyarankan agar Anda menggunakan parameter lain untuk memastikan kompatibilitas di masa depan.

Response parameters

Parameter	Type	Example	Description
IpAddress	String	112.124..	Alamat IP publik yang ditetapkan ke instans.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.

Examples

Contoh permintaan

https://ecs.aliyuncs.com/?Action=AllocatePublicIpAddress
&InstanceId=i-bp1gtjxuuvwj17zr****
&IpAddress=112.124.**.**
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<AllocatePublicIpAddressResponse>
    <RequestId>F2EF6A3B-E345-46B9-931E-0EA094818567</RequestId>
    <IpAddress>112.124.**.**</IpAddress>
</AllocatePublicIpAddressResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "F2EF6A3B-E345-46B9-931E-0EA094818567",
  "IpAddress" : "112.124.**.**"
}

Error codes

HTTP status code	Error code	Error message	Description
400	OperationDenied	Specified operation is denied as your instance is in VPC.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans berada di VPC.
400	AllocateIpInvalidInstanceBandwidth	OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat bandwidth publik keluar maksimum tidak lebih besar dari 0 Mbit/s.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat resource berada dalam status saat ini.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instans terkunci karena alasan keamanan.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Pesan kesalahan yang dikembalikan karena instans langganan telah kedaluwarsa. Perbarui instans tersebut dan coba lagi.
403	IpInUse	The specified IP is already in use.	Pesan kesalahan yang dikembalikan karena alamat IP yang ditentukan sedang digunakan.
403	AllocatedAlready	There is an IpAddress allocated already for the specified instance.	Pesan kesalahan yang dikembalikan karena instans tersebut sudah diberi alamat IP lain.
403	NAT_PUBLIC_IP_ALLOCATE_FAILED	Nat public ip binding failed.	Pesan kesalahan yang dikembalikan karena alamat IP publik tidak dapat ditetapkan.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak valid.
404	InvalidVlanId.NotFound	The VlanId provided does not exist in our records.	Pesan kesalahan yang dikembalikan karena parameter VlanId yang ditentukan tidak ada.
404	InvalidIpAddress.NotFound	The specified IP is not in the specified vlan.	Pesan kesalahan yang dikembalikan karena alamat IP yang ditentukan tidak berada di VLAN yang ditentukan.

Untuk daftar kode kesalahan, kunjungi API Error Center.