AllocateEipAddress - Elastic IP Address - Centre de documentation Alibaba Cloud

Demande une adresse IP élastique (EIP).

Description de l'opération

Assurez-vous de bien connaître les modes de facturation et la tarification des EIP avant d'appeler cette opération. Pour plus d'informations, consultez Présentation de la facturation.

Après avoir appelé cette opération, une EIP à l'état Available est allouée de manière aléatoire dans la région spécifiée. Les EIP prennent uniquement en charge les protocoles ICMP, TCP et UDP au niveau de la couche de transport. Les protocoles IGMP et SCTP ne sont pas pris en charge.

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.

vpc:AllocateEipAddress

create

*Address.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de l'EIP. Vous pouvez appeler l'opération DescribeRegions pour interroger l'identifiant de la région. Valeurs valides : cn-beijing : cn-beijing.	cn-hangzhou
Bandwidth	string	Non	La bande passante maximale de l'EIP. Unité : Mbit/s. Si InstanceChargeType est défini sur PostPaid et InternetChargeType sur PayByBandwidth, les valeurs valides de Bandwidth sont comprises entre 1 et 500. Si InstanceChargeType est défini sur PostPaid et InternetChargeType sur PayByTraffic, les valeurs valides de Bandwidth sont comprises entre 1 et 200. Si InstanceChargeType est défini sur PrePaid, les valeurs valides de Bandwidth sont comprises entre 1 et 1000. Valeur par défaut : 5 Mbit/s.	5
Period	integer	Non	La durée de l'abonnement. Si PricingCycle est défini sur Month, les valeurs valides de Period sont comprises entre 1 et 9. Si PricingCycle est défini sur Year, les valeurs valides de Period sont comprises entre 1 et 5. Ce paramètre est requis si InstanceChargeType est défini sur PrePaid. Ce paramètre n'est pas requis si InstanceChargeType est défini sur PostPaid.	1
ISP	string	Non	Le type de ligne. Valeurs valides : BGP (par défaut) : ligne BGP (multi-ISP). Toutes les régions prennent en charge les EIP de ligne BGP (multi-ISP). BGP_PRO : ligne BGP (multi-ISP) Pro. Seules les régions suivantes prennent en charge les EIP de ligne BGP (multi-ISP) Pro : Hong Kong (Chine), Singapour, Japon (Tokyo), Malaisie (Kuala Lumpur), Philippines (Manille), Indonésie (Jakarta) et Thaïlande (Bangkok). Pour plus d'informations sur les lignes BGP (multi-ISP) et les lignes BGP (multi-ISP) Pro, consultez Types de lignes EIP. Si vous êtes un utilisateur sur liste blanche pour la bande passante mono-ISP, vous pouvez également sélectionner les types suivants : ChinaTelecom : China Telecom ChinaUnicom : China Unicom ChinaMobile : China Mobile ChinaTelecom_L2 : China Telecom L2 ChinaUnicom_L2 : China Unicom L2 ChinaMobile_L2 : China Mobile L2 Si vous êtes un utilisateur de Finance Cloud en Chine (Hangzhou), ce champ est requis. Définissez la valeur sur BGP_FinanceCloud.	BGP
ActivityId	integer	Non	L'identifiant de l'activité spéciale. Vous n'avez pas besoin de configurer ce paramètre.	123456
Netmode	string	Non	Le type de réseau. La valeur est définie sur public (par défaut), ce qui spécifie le réseau public.	public
AutoPay	boolean	Non	Indique si le paiement automatique doit être activé. Valeurs valides : false (par défaut) : le paiement automatique est désactivé. Une fois la commande générée, accédez au Centre des commandes pour effectuer le paiement. true : le paiement automatique est activé. La commande est payée automatiquement. Ce paramètre est requis si InstanceChargeType est défini sur PrePaid. Ce paramètre est facultatif si InstanceChargeType est défini sur PostPaid.	false
PricingCycle	string	Non	Le cycle de facturation de l'abonnement. Valeurs valides : Month (par défaut) : facturation mensuelle. Year : facturation annuelle. Ce paramètre est requis si InstanceChargeType est défini sur PrePaid. Ce paramètre est facultatif si InstanceChargeType est défini sur PostPaid.	Month
InstanceChargeType	string	Non	Le mode de facturation de l'EIP. Valeurs valides : PrePaid : abonnement. PostPaid (par défaut) : paiement à l'usage. Si InstanceChargeType est défini sur PrePaid, InternetChargeType doit être défini sur PayByBandwidth. Si InstanceChargeType est défini sur PostPaid, InternetChargeType peut être défini sur PayByBandwidth ou PayByTraffic.	PostPaid
InternetChargeType	string	Non	La méthode de comptage de l'EIP. Valeurs valides : PayByBandwidth (par défaut) : facturation à la bande passante. PayByTraffic : facturation au transfert de données. Si InstanceChargeType est défini sur PrePaid, InternetChargeType doit être défini sur PayByBandwidth. Si InstanceChargeType est défini sur PostPaid, InternetChargeType peut être défini sur PayByBandwidth ou PayByTraffic.	PayByTraffic
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfmxazffggds****
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur depuis votre client pour garantir l'unicité entre les différentes requêtes. ClientToken prend uniquement en charge les caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.	0c593ea1-3bea-11e9-b96b-88e9fe637760
Name	string	Non	Le nom de l'instance EIP. Le nom doit comporter entre 0 et 128 caractères et ne peut pas commencer par `http://` ou `https://`. Remarque Ce paramètre n'est pas pris en charge lors de la création d'une instance EIP par abonnement.	EIP1
Description	string	Non	La description de l'instance EIP. La description doit comporter entre 0 et 256 caractères et ne peut pas commencer par `http://` ou `https://`. Remarque Ce paramètre n'est pas pris en charge lors de la création d'une instance EIP par abonnement.	test
SecurityProtectionTypes	array	Non	Le niveau de protection de sécurité. Si ce paramètre est laissé vide, la valeur par défaut est Anti-DDoS Basic. Si ce paramètre est défini sur AntiDDoS_Enhanced, la valeur indique Anti-DDoS (Enhanced). Vous pouvez spécifier au maximum un niveau de protection de sécurité.	AntiDDoS_Enhanced
	string	Non	Le niveau de protection de sécurité. Si ce paramètre est laissé vide, la valeur par défaut est Anti-DDoS Basic. Si ce paramètre est défini sur AntiDDoS_Enhanced, la valeur indique Anti-DDoS (Enhanced).	AntiDDoS_Enhanced
PublicIpAddressPoolId	string	Non	L'identifiant du pool d'adresses IP. L'EIP est allouée à partir du pool d'adresses IP spécifié. La fonctionnalité de pool d'adresses IP n'est pas activée par défaut. Pour utiliser cette fonctionnalité, demandez le quota de privilèges de pool d'adresses IP dans le Centre de quotas. Pour plus d'informations, consultez Augmenter un quota dans le Centre de quotas.	pippool-2vc0kxcedhquybdsz****
Zone	string	Non	La zone de l'EIP. Si le pool d'adresses IP spécifié par PublicIpAddressPoolId est de type CloudBox, ce paramètre prend par défaut la zone du pool d'adresses IP. Pour plus d'informations sur la façon d'afficher le type d'activité d'un pool d'adresses IP, consultez ListPublicIpAddressPools.	ap-southeast-1-lzdvn-cb
IpAddress	string	Non	L'adresse IP de l'EIP que vous souhaitez demander. Vous devez spécifier uniquement l'un des paramètres IpAddress et InstanceId. Si aucun n'est spécifié, le système alloue une EIP de manière aléatoire.	192.0.XX.XX
InstanceId	string	Non	L'identifiant de l'instance de l'EIP que vous souhaitez demander. Vous devez spécifier uniquement l'un des paramètres IpAddress et InstanceId. Si aucun n'est spécifié, le système alloue une EIP de manière aléatoire.	eip-25877c70gddh****
Tag	array<object>	Non	Les balises de la ressource.
	object	Non
Key	string	Non	La clé de balise de la ressource. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de balise ne peut pas être une chaîne vide. Une clé de balise peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par `aliyun` ou `acs:`, et ne peut pas contenir `http://` ou `https://`.	TestKey
Value	string	Non	La valeur de la balise. Spécifiez la valeur au format Tag.N.Value. Valeurs valides de N : 1 à 20. La valeur de la balise ne peut pas être une chaîne vide. La valeur de la balise peut comporter jusqu'à 128 caractères. Elle ne peut pas commencer par aliyun ou acs:, et ne peut pas contenir http:// ou https://.	FinanceJoshua

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	4EC47282-1B74-4534-BD0E-403F3EE64CAF
OrderId	integer	L'identifiant de la commande. Ce paramètre est renvoyé si InstanceChargeType (le mode de facturation de l'EIP) est défini sur PrePaid (abonnement). Si AutoPay (paiement automatique) n'est pas activé, accédez au Centre des commandes pour effectuer le paiement.	10
ResourceGroupId	string	L'identifiant du groupe de ressources. Ce paramètre est renvoyé uniquement si InstanceChargeType est défini sur PostPaid.	rg-acfmxazfdgdg****
EipAddress	string	L'EIP allouée. Ce paramètre est renvoyé uniquement si InstanceChargeType est défini sur PostPaid.	192.0.XX.XX
AllocationId	string	L'identifiant de l'instance EIP.	eip-25877c70gddh****

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InsufficientBalance	Your account does not have enough balance.
400	InvalidParameter	Specified value of "InternetChargeType" is not valid
400	ReserveIpFail	Reserve eip failed.
400	InvalidRegion.NotSupport	The specified region does not support.
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.	L'identifiant du groupe de ressources n'existe pas.
400	OperationFailed.InsufficientEIP	Eip resource is not enough.
400	FrequentPurchase.EIP	eip frequent purchase
400	IellgalParameter.OwnerAccount	The specified parameter OwnerAccount is not valid.	Le paramètre OwnerAccount spécifié n'est pas valide.
400	ResourceNotFound.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not found.
400	ResourceNotEnough.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not enough.
400	Mismatch.IpAndPublicIpAddressPool	The Ip and PublicIpAddressPool are mismatched.
400	OperationDenied.NotOpenDdosOriginProtectService	The operation is not allowed because of you do not open Ddos Origin Protection Service	L'EIP avec la fonction Anti-DDoS (Enhanced) activée ne peut pas être créée, car le service Anti-DDoS Origin n'a pas été souscrit.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	L'EIP ne peut pas être allouée car l'état du pool d'adresses IP n'est pas valide.
400	IllegalParam.Isp	The param of %s is illegal.	L'EIP ne peut pas être allouée car le paramètre ISP n'est pas valide.
400	ExclusiveParam.ZoneAndPublicIpAddressPoolId	The Zone and PublicIpAddressPoolId parameters are mutually exclusive.	Les paramètres Zone et PublicIpAddressPoolId ne peuvent pas être spécifiés simultanément.
400	IllegalParam.Zone	The specified zone is invalid.	Le paramètre Zone n'est pas valide.
400	OperationFailed.AllocateUnfamiliarIp	The operation failed because only IP addresses used within the last seven days can be allocated.	L'application EIP spécifiée vous permet uniquement de demander une adresse IP qui a été utilisée au cours des 7 derniers jours.
400	Ip.Allocated	The reserve ip has been allocated.	L'adresse IP réservée a déjà été attribuée.
400	IncorrectStatus.Ip	The status of ip is incorrect.	L'adresse IP est dans un état incorrect.
400	UnsupportedFeature.AllocateEipAddressWithZone	The feature of AllocateEipAddressWithZone is not supported.	La zone spécifiée ne prend pas en charge la création d'instances dans la région actuelle.
400	ResourceNotFound.Ip	The specified ip is not found.	L'adresse IP spécifiée est introuvable.
400	OperationFailed.ResourceNotEnough	The resources you have applied for are insufficient.	Les ressources demandées sont insuffisantes. Pour poursuivre la requête, soumettez un ticket.
400	IllegalParam.Bandwidth	The param of bandwidth is illegal.	La bande passante spécifiée n'est pas valide.
400	OperationFailed.IpIsLocked	The operation is failed because of ip is locked.	La requête a échoué car l'adresse IP est verrouillée.
400	Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionType	The EipSecurityProtectionType and PoolSecurityProtectionType are mismatched.	Le type de protection de sécurité de l'EIP ne correspond pas au type de protection de sécurité du pool d'adresses.
400	IllegalParam.SecurityProtectionTypes	The param of securityProtectionTypes is illegal.	Le paramètre SecurityProtectionTypes spécifié n'est pas valide.
400	IllegalParam.ServiceLocation	The param of serviceLocation is illegal.	Le paramètre ServiceLocation n'est pas valide.
400	UnsupportedFeature.Isp	The feature of Isp is not supported.	Le fournisseur d'accès Internet spécifié n'est pas pris en charge.
400	ExclusiveParam.ZoneAndIpAddress	The specified param Zone and IpAddress or InstanceId are mutually exclusive.	Le paramètre Zone spécifié est en conflit avec le paramètre IpAddress ou InstanceId.
400	InvalidDescription.Malformed	The Description is illeagl.	Le format de description de la ressource spécifié n'est pas valide. La description doit comporter de 2 à 256 caractères et ne peut pas commencer par http:// ou https://.
400	InvalidName.Malformed	The attribute name is illegal.	Le format de nom spécifié n'est pas valide.
400	OperationFailed.UpgradeCdtServiceFirst	The operation is failed because of cdt is not upgraded.	Le type d'instance que vous avez spécifié nécessite une mise à niveau de la facturation de Cloud Data Transfer (CDT). Mettez à niveau CDT et réessayez.
400	OperationFailed.TokenExpired	The operation is failed because of TokenExpired.	Le jeton d'allocation d'EIP spécifié a expiré.
400	QuotaExceeded.LocalISPBasicEip	The quota for Local ISP Provider EIP has been exceeded.	Le quota d'EIP LocalISPBasic a été dépassé.
400	QuotaExceeded.LocalISPEip	The quota for Local ISP EIPs has been exceeded.	Le quota LocalISP a été dépassé.
403	Forbidden	User not authorized to operate on the specified resource.	Vous n'avez pas l'autorisation d'effectuer des opérations sur la ressource spécifiée. Demandez l'autorisation requise et réessayez.

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

Notes de version

Consultez Notes de version pour la liste complète.