AllocatePublicIpAddress - - Centre de documentation Alibaba Cloud

Description

Lors de l'appel à cette opération, tenez compte des points suivants :

L'instance doit être dans l'état Running (Running) ou Stopped (Stopped).
Si le champ OperationLocks de la réponse DescribeInstances contient "LockReason" : "security" pour une instance, celle-ci est verrouillée pour des raisons de sécurité et ne peut pas recevoir d'adresse IP publique.
Une seule adresse IP publique peut être attribuée à une instance. Si l'instance possède déjà une adresse IP publique, le code d'erreur AllocatedAlready est renvoyé.
Après l'attribution d'une adresse IP publique, redémarrez l'instance (RebootInstance) ou démarrez-la (StartInstance) pour que l'adresse IP prenne effet.

Si une instance se trouve dans un réseau privé virtuel (VPC), vous pouvez lui attribuer une adresse IP publique ou lui associer une adresse IP élastique (EIP). Pour plus d'informations, consultez la rubrique AssociateEipAddress.

Remarque

Une fois qu'une EIP est associée à une instance située dans un VPC, il n'est plus possible d'attribuer d'adresses IP publiques à cette instance.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	AllocatePublicIpAddress	Opération à effectuer. Définissez la valeur sur AllocatePublicIpAddress.
InstanceId	String	Yes	i-bp1gtjxuuvwj17zr****	ID de l'instance à laquelle attribuer une adresse IP publique.
IpAddress	String	No	112 124..	Adresse IP publique à attribuer à l'instance. Si vous laissez ce paramètre vide, le système attribue aléatoirement une adresse IP publique à l'instance spécifiée.
VlanId	String	No	720	ID du réseau local virtuel (VLAN) de l'instance. Remarque Ce paramètre sera supprimé à l'avenir. Nous vous recommandons d'utiliser d'autres paramètres pour garantir la compatibilité future.

Paramètres de réponse

Parameter	Type	Example	Description
IpAddress	String	112.124..	Adresse IP publique attribuée à l'instance.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

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

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

Format JSON

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

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	OperationDenied	Specified operation is denied as your instance is in VPC.	L'opération n'est pas prise en charge lorsque l'instance réside dans un VPC.
400	AllocateIpInvalidInstanceBandwidth	OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0.	L'opération n'est pas prise en charge lorsque la bande passante sortante maximale sur Internet n'est pas supérieure à 0 Mbit/s.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	L'opération n'est pas prise en charge lorsque la ressource se trouve dans l'état actuel.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	L'opération n'est pas prise en charge lorsque l'instance est verrouillée pour des raisons de sécurité.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	L'instance par abonnement a expiré. Renouvelez l'instance et réessayez.
403	IpInUse	The specified IP is already in use.	L'adresse IP spécifiée est déjà utilisée.
403	AllocatedAlready	There is an IpAddress allocated already for the specified instance.	Une autre adresse IP est déjà attribuée à l'instance.
403	NAT_PUBLIC_IP_ALLOCATE_FAILED	Nat public ip binding failed.	L'attribution de l'adresse IP publique a échoué.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Le paramètre InstanceId spécifié n'est pas valide.
404	InvalidVlanId.NotFound	The VlanId provided does not exist in our records.	Le paramètre VlanId spécifié n'existe pas.
404	InvalidIpAddress.NotFound	The specified IP is not in the specified vlan.	L'adresse IP spécifiée ne se trouve pas dans le VLAN spécifié.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.