RenewElasticityAssurances - Elastic Compute Service - Centre de documentation Alibaba Cloud

Renouvelle un ou plusieurs services de garantie d'élasticité souscrits.

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

create

*ElasticityAssurance

acs:ecs:{#regionId}:{#accountId}:elasticityassurance/{#ElasticityAssuranceId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Non	L'identifiant de la région du service de garantie d'élasticité. Vous pouvez appeler DescribeRegions pour obtenir la liste la plus récente des régions.	cn-hangzhou
Period	integer	Non	La durée de renouvellement. L'unité de la durée est déterminée par le paramètre PeriodUnit. Valeurs valides : Lorsque PeriodUnit est défini sur Weekly : 1, 2 et 3. Lorsque PeriodUnit est défini sur Month : 1, 2, 3, 4, 5, 6, 7, 8 et 9. Lorsque PeriodUnit est défini sur Year : 1, 2, 3, 4 et 5. Valeur par défaut : 1.	1
PeriodUnit	string	Non	L'unité de la durée de renouvellement. Valeurs valides : Weekly : semaine Month : mois Year : année Valeur par défaut : Year.	Year
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais assurez-vous que ce jeton est unique pour chaque requête. ClientToken prend uniquement en charge les caractères ASCII et ne peut pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	123e4567-e89b-12d3-a456-426655440000
AutoPay	boolean	Non	Indique si le paiement automatique doit être activé. Valeurs valides : true : le paiement automatique est activé. false : le paiement automatique n'est pas activé. Valeur par défaut : true.	true
PrivatePoolOptions.Id	array	Non	La liste des identifiants des services de garantie d'élasticité. Limite : vous pouvez renouveler jusqu'à 20 services de garantie d'élasticité à la fois. Vous pouvez appeler DescribeElasticityAssurances pour obtenir les services de garantie d'élasticité souscrits.
	string	Non	L'identifiant du service de garantie d'élasticité.	eap-bp67acfmxazb4****
AutoRenew	boolean	Non	Indique si le renouvellement automatique doit être activé. Valeurs valides : true : le renouvellement automatique est activé. false : le renouvellement automatique n'est pas activé. Valeur par défaut : false.	true
AutoRenewPeriod	integer	Non	La durée du renouvellement automatique. Unité : mois. Valeurs valides : 1, 2, 3, 6, 12, 24 et 36. Lorsque PeriodUnit=Month, la valeur par défaut est 1. Lorsque PeriodUnit=Year, la valeur par défaut est 12. Remarque Ce paramètre est requis lorsque AutoRenew est défini sur true.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
OrderId	string	L'identifiant de la commande de renouvellement.	182372800****
PrivatePoolOptionsIdSet	object
PrivatePoolOptionsId	array	La liste des identifiants des services de garantie d'élasticité.
	string	L'identifiant du service de garantie d'élasticité.	eap-bp67acfmxazb4****

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "OrderId": "182372800****",
  "PrivatePoolOptionsIdSet": {
    "PrivatePoolOptionsId": [
      "eap-bp67acfmxazb4****"
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	The specified PeriodUnit parameter is invalid.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid.
400	MissingParameter.PrivatePoolOptions.Id	The specified parameter PrivatePoolOptions.Id does not exist.	The specified parameter PrivatePoolOptions.Id does not exist
400	InvalidParameter.PeriodUnit	The specified PeriodUnit is invalid.	The specified PeriodUnit is invalid
400	InvalidParameter.Period	The specified parameter Period or PeriodUnit is invalid.	The specified Period or PeriodUnit parameter does not meet the requirements.
400	InvalidParameter.PrivatePoolOptionsId	The specified parameter PrivatePoolOptions.Id is invalid.	The specified parameter PrivatePoolOptions.Id is invalid
400	InvalidAutoRenewPeriod.ValueNotSupported	The specified autoRenewPeriod is invalid.	The specified auto-renewal duration is invalid.
500	InternalError	The request processing has failed due to some unknown error.
500	IncorrectPrivatePoolStatus	The current status of the private pool does not support this operation.
500	InvalidPrivatePoolId.NotFound	The specified private pool does not exist.	The specified private pool does not exist
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	The specified ResourceOwnerAccount parameter is invalid.
403	Account.Arrearage	Your account has been in arrears.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	InvalidOperation.PackageTypeUnsupported	Not support to renew this type of resource package.	Not support to renew this type of resource package.
403	OperationDenied.UtilizationTooLow	The utilization of this ElasticityAssurance is below 20%, renewal is not allowed. Please improve the utilization and try again.

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

Notes de version

Consultez Notes de version pour la liste complète.