AllocatePublicIpAddress - - Alibaba Cloud Dokümantasyon Merkezi

Açıklama

Bu işlemi çağırırken aşağıdaki hususlara dikkat edin:

Genel IP adresi atanacak örneğin Running(Running) veya Stopped(Stopped) durumunda olması gerekir.
DescribeInstances yanıtındaki OperationLocks öğesi bir örnek için "LockReason" : "security" değerini içeriyorsa, bu örnek güvenlik nedenleriyle kilitlenmiştir ve kendisine genel bir IP adresi atanamaz.
Bir örneğe yalnızca tek bir genel IP adresi atayabilirsiniz. Örnek zaten bir genel IP adresine sahipse AllocatedAlready hata kodu döner.
Bir örneğe genel bir IP adresi atadıktan sonra, genel IP adresinin etkinleşmesi için örneği yeniden başlatmanız (RebootInstance) veya başlatmanız (StartInstance) gerekir.

Bir sanal özel cloud (VPC) içinde bulunan bir örneğe genel bir IP adresi atayabilir veya örnekle esnek bir IP adresini (EIP) ilişkilendirebilirsiniz. Daha fazla bilgi için bkz. AssociateEipAddress.

Not

Bir EIP, VPC içindeki bir örnekle ilişkilendirildikten sonra bu örneğe genel IP adresi atanamaz.

Hata Ayıklama

OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	AllocatePublicIpAddress	Gerçekleştirmek istediğiniz işlem. Değeri AllocatePublicIpAddress olarak ayarlayın.
InstanceId	String	Evet	i-bp1gtjxuuvwj17zr****	Genel IP adresi atanacak örneğin ID'si.
IpAddress	String	Hayır	112.124..	Örneğe atanacak genel IP adresi. Bu parametreyi boş bırakırsanız sistem belirtilen örneğe rastgele bir genel IP adresi atar.
VlanId	String	Hayır	720	Örneğin sanal LAN (VLAN) ID'si. Not Bu parametre gelecekte kaldırılacaktır. Gelecekteki uyumluluğu sağlamak için diğer parametreleri kullanmanızı öneririz.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
IpAddress	String	112.124..	Örneğe atanan genel IP adresi.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İsteğin ID'si.

Örnekler

Örnek istekler

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

Başarılı yanıt örnekleri

XML biçimi

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

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

JSON biçimi

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

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

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	OperationDenied	Specified operation is denied as your instance is in VPC.	İşlem, örnek bir VPC içinde bulunduğundan desteklenmediği için döndürülen hata mesajı.
400	AllocateIpInvalidInstanceBandwidth	OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0.	Maksimum giden genel bant genişliği 0 Mbit/s'den büyük olmadığından işlem desteklenmediği için döndürülen hata mesajı.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Kaynak mevcut durumda olduğundan işlem desteklenmediği için döndürülen hata mesajı.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Örnek güvenlik nedenleriyle kilitlendiğinden işlem desteklenmediği için döndürülen hata mesajı.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Abonelik tabanlı örnek süresi dolduğu için döndürülen hata mesajı. Örneği yenileyin ve tekrar deneyin.
403	IpInUse	The specified IP is already in use.	Belirtilen IP adresi zaten kullanımda olduğu için döndürülen hata mesajı.
403	AllocatedAlready	There is an IpAddress allocated already for the specified instance.	Örnek zaten başka bir IP adresine sahip olduğu için döndürülen hata mesajı.
403	NAT_PUBLIC_IP_ALLOCATE_FAILED	Nat public ip binding failed.	Genel IP adresi atanamadığı için döndürülen hata mesajı.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Belirtilen InstanceId parametresi geçersiz olduğu için döndürülen hata mesajı.
404	InvalidVlanId.NotFound	The VlanId provided does not exist in our records.	Belirtilen VlanId parametresi mevcut olmadığı için döndürülen hata mesajı.
404	InvalidIpAddress.NotFound	The specified IP is not in the specified vlan.	Belirtilen IP adresi belirtilen VLAN'da olmadığı için döndürülen hata mesajı.

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.