AllocateEipAddressPro - Elastic IP Address - Centre de documentation Alibaba Cloud

Alloue une adresse IP élastique (EIP) spécifiée pour des exigences de configuration réseau spécifiques.

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:AllocateEipAddressPro

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 à allouer. Vous pouvez appeler l'opération DescribeRegions pour interroger les identifiants de région.	cn-hangzhou
IpAddress	string	Non	L'adresse IP de l'EIP à allouer. 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 à allouer. 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****
Bandwidth	string	Non	La bande passante maximale de l'EIP à allouer. Unité : Mbit/s. Si InstanceChargeType est défini sur PostPaid et InternetChargeType sur PayByBandwidth, les valeurs valides de Bandwidth sont de 1 à 500. Si InstanceChargeType est défini sur PostPaid et InternetChargeType sur PayByTraffic, les valeurs valides de Bandwidth sont de 1 à 200. Si InstanceChargeType est défini sur PrePaid, les valeurs valides de Bandwidth sont de 1 à 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 de 1 à 9. Si PricingCycle est défini sur Year, les valeurs valides de Period sont de 1 à 3. Ce paramètre est requis si InstanceChargeType est défini sur PrePaid. Ne définissez pas ce paramètre 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 BGP (multi-ISP). BGP_PRO : ligne BGP (multi-ISP) Pro. Seules les régions de Hong Kong (Chine), Singapour, Malaisie (Kuala Lumpur), Philippines (Manille), Indonésie (Jakarta) et Thaïlande (Bangkok) prennent en charge les EIP BGP (multi-ISP) Pro. Pour plus d'informations sur les lignes BGP (multi-ISP) et 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 China (Hangzhou) Finance Cloud, ce paramètre est requis. Définissez la valeur sur BGP_FinanceCloud.	BGP
Netmode	string	Non	Le type de réseau. La valeur peut uniquement être public (par défaut), ce qui indique le réseau public.	public
AutoPay	boolean	Non	Indique si le paiement automatique doit être activé. Valeurs valides : false : désactive le paiement automatique. Une fois la commande générée, accédez au Centre des commandes pour effectuer le paiement. true : active le paiement automatique. 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.	true
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	La méthode de facturation de l'EIP à allouer. 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 facturation de l'EIP à allouer. Valeurs valides : PayByBandwidth (par défaut) : paiement par bande passante. PayByTraffic : paiement par 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.	PayByBandwidth
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel l'EIP appartient.	rg-resourcegroup****
Tag	array<object>	Non
	object	Non
Key	string	Non
Value	string	Non
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Générez une valeur de paramètre 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-88e9fe6****
SecurityProtectionTypes	array	Non	Le niveau de protection de sécurité. Si ce paramètre est laissé vide, Protection DDoS (Basic) est utilisé par défaut. Si ce paramètre est défini sur AntiDDoS_Enhanced, Protection DDoS (Enhanced) est utilisé.
	string	Non	Le niveau de protection de sécurité. Si ce paramètre est laissé vide, Protection DDoS (Basic) est utilisé par défaut. Si ce paramètre est défini sur AntiDDoS_Enhanced, Protection DDoS (Enhanced) est utilisé.
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 disponible 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****

É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é lorsque InstanceChargeType (la méthode de facturation de l'EIP) est défini sur PrePaid (abonnement). Si AutoPay est défini sur false, ce qui signifie que le paiement automatique n'est pas activé, accédez au Centre des commandes pour effectuer le paiement.	20190000
ResourceGroupId	string	L'identifiant du groupe de ressources. Ce paramètre est renvoyé uniquement lorsque InstanceChargeType est défini sur PostPaid.	rg-resourcegroup****
EipAddress	string	L'adresse IP attribuée à l'EIP spécifiée. Ce paramètre est renvoyé uniquement lorsque InstanceChargeType est défini sur PostPaid.	192.0.XX.XX
AllocationId	string	L'identifiant de l'EIP.	eip-25877c70gddh****

Exemples

JSON format

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

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	FrequentPurchase.EIP	eip frequent purchase
400	QuotaExceeded.Eip	Elastic IP address quota exceeded
400	InvalidParameter	Specified value of "InternetChargeType" is not valid
400	ReserveIpFail	Reserve eip failed.
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.	The specified resource group ID does not exist.
400	Invalid.Reserve.Ip	The reserve ip is invalid.
400	Ip.Allocated	The reserve ip has been allocated.	Reserved IP addresses are already specified.
400	Ip.Keeped	The reserve ip been keeped in an hour.
400	OperationFailed.AllocateUnfamiliarIp	The operation failed because only IP addresses used within the last seven days can be allocated.	Only IP addresses used within the last seven days can be used to apply for EIP.
400	INVALID_INSTANCE_STATUS	The instance status is invalid.
400	OperationFailed.InstanceNotExist	Eip instanceId does not exist.
400	InvalidStatus.ValueNotSupported	The specified status is not supported.
400	OperationFailed.RiskControl	Risk control check failed.	The error message returned because your payment method has security risks. Click the link for verification in your email or console message and submit your order after verification.
400	ResourceNotEnough.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not enough.
400	Mismatch.IpAndPublicIpAddressPool	The Ip and PublicIpAddressPool are mismatched.
400	ResourceNotFound.PublicIpAddressPool	The specified resource of PublicIpAddressPool is not found.
400	ResourceNotFound.Ip	The specified ip is not found.	The specified IP could not be found.
400	OperationDenied.IpBelongToOtherUser	The operation is not allowed because of ip belong to other user.	Your application failed because the IP address belongs to another user.
400	IncorrectStatus.Ip	The status of ip is incorrect.	The status of the IP is incorrect.
400	OperationFailed.IpIsLocked	The operation is failed because of ip is locked.	Your application failed because the IP address is locked.
400	Mismatch.IpAndIsp	The specified IP address does not match the ISP.	The system failed to allocate the specified EIP because the ISP and IP address do not match.
400	IncorrectStatus.PublicIpAddressPool	The status of PublicIpAddressPool is incorrect.	EIPs are not allowed to be allocated because the address pool is in an unstable state.
400	IllegalParam.IpAddress	The specified IpAddress (%s) is illegal.	The IpAddress parameter is set to an invalid value.
400	OperationFailed.ResourceNotEnough	The resources you have applied for are insufficient.	The resources you have applied for are insufficient. If you still need to apply, please submit a work order for processing.
400	Mismatch.EipSecurityProtectionTypeAndPoolSecurityProtectionType	The EipSecurityProtectionType and PoolSecurityProtectionType are mismatched.	The EIP protection type does not match the address pool protection type.
400	IllegalParam.Isp	The param of Isp [%s] is illegal.	The error message returned because the Isp parameter is set to an invalid value. Specify a valid value and try again.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error occurred.
403	Forbidden	User not authorized to operate on the specified resource.	You do not have the permissions to manage the specified resource. Apply for the permissions and try again.

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

Notes de version

Consultez Notes de version pour la liste complète.