AllocatePublicIpAddress - Elastic Compute Service - Centre de documentation Alibaba Cloud

Attribue une adresse IP publique à une instance ECS. Nous vous recommandons d'appeler l'opération ModifyInstanceNetworkSpec pour attribuer une adresse IP publique.

Description de l'opération

Avant de commencer

Avant d'attribuer une adresse IP publique, l'instance doit être dans l'état Running (Running) ou Stopped (Stopped).
Si "LockReason" : "security" est inclus dans les OperationLocks d'une instance verrouillée pour des raisons de sécurité, vous ne pouvez pas attribuer d'adresse IP publique à l'instance.
Assurez-vous que la bande passante publique de l'instance est supérieure à 0 avant d'appeler cette opération. Vous pouvez appeler l'opération ModifyInstanceNetworkSpec pour ajuster la bande passante.

Précautions

Seuls les utilisateurs figurant sur la liste blanche peuvent spécifier l'adresse IP publique à l'aide du paramètre IpAddress. Si la bande passante publique est supérieure à 0, vous pouvez définir InstanceId pour allouer une adresse IP publique aléatoire. Si la bande passante publique est égale à 0, appelez l'opération ModifyInstanceNetworkSpec pour ajuster la bande passante avant d'appeler cette opération afin d'allouer une adresse IP publique.
Une seule adresse IP publique peut être allouée à une instance. Si l'instance possède déjà une adresse IP publique, l'adresse IP publique attachée existante IpAddress est renvoyée.
La nouvelle adresse IP publique prend effet après le redémarrage de l'instance (RebootInstance) ou le démarrage de l'instance (StartInstance).

En plus d'attribuer une adresse IP publique, vous pouvez associer une adresse IP élastique (EIP) à une instance ECS connectée à un VPC. Pour plus d'informations, consultez AssociateEipAddress.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:AllocatePublicIpAddress

create

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
InstanceId	string	Oui	L'identifiant de l'instance à laquelle vous souhaitez allouer une adresse IP publique. Remarque La bande passante publique de l'instance doit être supérieure à 0.	i-bp1gtjxuuvwj17zr****
IpAddress	string	Non	L'adresse IP publique de l'instance. Si ce paramètre est laissé vide, le système attribue une adresse IP de manière aléatoire. Remarque Seuls les utilisateurs figurant sur la liste blanche peuvent spécifier ce paramètre. Les utilisateurs ordinaires ne peuvent pas spécifier d'adresse IP.	112.124..
VlanId	string	Non	L'identifiant VLAN de l'instance. Remarque Ce paramètre sera obsolète. Pour une meilleure compatibilité, utilisez d'autres paramètres.	720

Éléments de réponse

Élément	Type	Description	Exemple
	object
IpAddress	string	L'adresse IP publique de l'instance.	112.124..
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemples

JSON format

{
  "IpAddress": "112.124.**.**",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidOperation.AllocateFailed	The current instance failed to allocate public IP, please try again later.
400	InvalidIpAddress.Malformed	The specified parameter "IpAddress" is not valid.
400	OperationDenied	Specified operation is denied as your instance is in VPC.	L'adresse EIP spécifiée est indisponible ou non autorisée.
400	InsufficientPublicIp	Ip address not found.
400	AllocateIpInvalidInstanceBandwidth	OperationDenied The InternetMaxBandwidthOut of the specified instance cannot be less than 0.	L'opération actuelle est invalide. Assurez-vous que la bande passante sortante maximale est supérieure à 0.
400	OperationDenied.CloudboxNotSupport	This operation is denied, because the specified ECS instance which is in the Cloudbox dose not support PublicIp or Eip.
400	OperationDenied.DedicatedRegionNotSupported	This operation is denied, because the specified ECS instance which is in the dedicated region dose not support PublicIp or Eip.	L'API n'est pas prise en charge par le cloud dédié.
500	InternalError	The request processing has failed due to some unknown error.
500	InvalidOperation.AllocateIpFailed	Failed to allocate the specific IP, please ensure the IP is available.	Échec de l'attribution de l'adresse IP spécifiée. Assurez-vous que l'adresse IP est disponible.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	L'instance est verrouillée pour des raisons de sécurité. Contactez le support technique de sécurité pour obtenir de l'aide.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	IpInUse	The specified IP is already in use.	L'adresse IP spécifiée est déjà utilisée sur une autre instance.
403	AllocatedAlready	There is an IpAddress allocated already for the specified instance.	Lorsque vous tentez de lier l'instance avec l'adresse IP spécifiée, l'instance s'est déjà vu attribuer une adresse IP différente.
403	AllocateIp.Fail	The specified instance fails to allocate ip, please try again.
403	NAT_PUBLIC_IP_BINDING_FAILED	Binding nat public ip failed.
403	NAT_PUBLIC_IP_ALLOCATE_FAILED	Nat public ip binding failed.	Échec de la liaison de l'adresse IP publique.
403	InvalidIpAddress.NotPublic	The specified IP is not public address.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'identifiant d'instance spécifié est invalide.
404	InvalidVlanId.NotFound	The VlanId provided does not exist in our records.	L'identifiant de réseau local virtuel spécifié n'existe pas.
404	InvalidIpAddress.NotFound	The specified IP is not in the specified vlan.	L'adresse IP spécifiée a été libérée.
409	OperationConflict	Request was denied due to conflict with a previous request,please try again later.	L'opération de ressource demandée est en conflit avec une requête précédente.
409	TokenProcessing	The previous token request is still processing. Please try again later.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.