RenewInstance - Elastic Compute Service - Centre de documentation Alibaba Cloud

Renouvelle une instance Elastic Compute Service (ECS) par abonnement. Vous pouvez spécifier une période de renouvellement ou renouveler l'instance jusqu'à une date d'expiration unifiée.

Description de l'opération

Avant d'utiliser cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'Elastic Compute Service.

Assurez-vous que le solde de votre compte ou votre limite de crédit est suffisant.
Seules les instances par abonnement sont prises en charge. L'appel de cette opération pour des instances prépayées renvoie une erreur.
Vous devez spécifier soit les paramètres de période de renouvellement (Period et PeriodUnit), soit le paramètre de date d'expiration unifiée (ExpectedRenewDay), mais pas les deux.

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

update

*Instance.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
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 qu'il est unique pour chaque requête. La valeur de ClientToken ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez Comment garantir l'idempotence.	0c593ea1-3bea-11e9-b96b-88e9fe637760
InstanceId	string	Oui	L'identifiant de l'instance que vous souhaitez renouveler.	i-bp67acfmxazb4p****
Period	integer	Non	La période de renouvellement pour l'instance par abonnement. Si vous spécifiez DedicatedHostId, la valeur de Period ne peut pas dépasser la période d'abonnement restante de l'hôte dédié. Valeurs valides : Si PeriodUnit est défini sur Month, valeurs valides de Period : 1, 2, 3, 4, 5, 6, 7, 8, 9 et 12. Remarque Vous devez spécifier soit les paramètres de période de renouvellement (Period et PeriodUnit), soit le paramètre de date d'expiration unifiée (ExpectedRenewDay), mais pas les deux.	1
PeriodUnit	string	Non	L'unité de la période de renouvellement. Ce paramètre spécifie l'unité pour le paramètre Period. Valeurs valides : Month. Valeur par défaut : Month.	Month
ExpectedRenewDay	integer	Non	Le jour auquel renouveler l'instance jusqu'à une date d'expiration unifiée. Valeurs valides : 1 à 28. Pour utiliser ce paramètre, vous devez d'abord définir une date d'expiration unifiée pour les instances ECS. La valeur de ce paramètre doit correspondre à la date d'expiration unifiée que vous avez définie. Sinon, l'appel échoue. Remarque Vous devez spécifier soit les paramètres de période de renouvellement (Period et PeriodUnit), soit le paramètre de date d'expiration unifiée (ExpectedRenewDay), mais pas les deux.	5

Éléments de réponse

Élément	Type	Description	Exemple
	object
OrderId	string	L'identifiant de la commande.	1234567890
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Exemples

JSON format

{
  "OrderId": "1234567890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	La méthode de facturation réseau spécifiée n'est pas valide.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.
400	InvalidParameter	The specified parameter "InternetMaxBandwidthOut" is not valid.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	La méthode de facturation de l'instance spécifiée n'existe pas.
400	InvalidRebootTime.Malformed	The specified RebootTime is not valid.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	L'heure de redémarrage spécifiée n'est pas valide.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Les paramètres de la requête ne correspondent pas à la requête utilisant le même ClientToken.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Le ClientToken spécifié n'est pas valide.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Le type d'instance spécifié n'est pas valide car il se situe en dehors de la plage disponible.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	Le paramètre InstanceType spécifié n'est pas valide.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	Le paramètre InternetChargeType spécifié n'est pas pris en charge pour cette instance.
400	InvalidPeriod	The specified period is not valid.	La période spécifiée n'est pas valide.
400	MissingParamter	The specified parameter "Period" is not null.	Le paramètre Period ne peut pas être vide.
400	Upgrade.NotSupported	Upgrade operation is not supported.	L'opération de mise à niveau n'est pas valide.
400	OperationDenied	Specified instance is in VPC.	L'instantané spécifié ne permet pas la création de volumes de données.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	Le type d'instance actuel ne peut pas être modifié pour le type d'instance spécifié.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Le paramètre PeriodUnit n'est pas valide.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	L'hôte dédié spécifié n'existe pas.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	L'état actuel de l'hôte dédié ne prend pas en charge cette opération.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.	L'état actuel de la ressource ne prend pas en charge cette opération.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	L'instance est en cours de mise à niveau. Réessayez plus tard.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.	La période de renouvellement spécifiée ne peut pas dépasser la période de validité maximale. Raccourcissez la période de renouvellement et réessayez.
400	LastOrderProcessing	The previous order is still processing, please try again later.	La commande est en cours de traitement. Réessayez plus tard.
400	Idempotence.Processing	The previous request is still processing, please try again later.	La requête est en cours de traitement. Réessayez plus tard.
400	InvalidLoanOrderStatus.Uncompleted	Any unpaid order must be cancelled before you try this action again. The scheduled unpaid order is a loan order that cannot be auto cancelled. For more information, visit the loan management center.
400	OperationDenied.UnfinishedOrder	The current instance has unfinished refundOrder, this operation is denied.	L'instance a une commande de remboursement en attente. Patientez un instant et réessayez plus tard.
400	InvalidPeriod.NotFound	The specified period and expectedRenewDay cannot both be empty.
400	InvalidExpectedRenewDay.StarterPackageNotSupported	The specified starterPackage cannot support renew with expectedRenewDay.
400	InvalidParam.ExpectedRenewDay	The specified param ExpectedRenewDay is not valid.
400	QuotaExceed.AlignInstance	The maximum number of align operations is exceeded.
400	InvalidExpectedRenewDay.Conflict	The specified expectedRenewDay is in conflict with period.
400	InvalidExpectedRenewDay.ValueNotSupported	The specified parameter ExpectedRenewDay is not valid.
400	OperationDenied.AbnormalInstanceInfo	The current renewable operation is not supported due to abnormal information of the instance, please submit ticket to process.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	Cette opération nécessite des autorisations de tarification. Demandez les autorisations à votre compte principal, ou définissez le paramètre AutoPay sur true pour le paiement automatique.
400	InvalidOperation.ClassicNetworkTypeNotSupported	The classic network instance does not support this operation.	L'instance basée sur l'architecture réseau classique ne peut plus être renouvelée. Vous devez migrer l'instance vers un VPC avant de pouvoir procéder à un renouvellement normal.
500	InternalError	The request processing has failed due to some unknown error.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	Le disque spécifié ne peut pas être converti en disque détachable en raison de restrictions liées au type de disque. Les disques de ce type ne prennent pas en charge le détachement.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	L'instance spécifiée est réservée en raison d'un changement de spécification et ne peut pas prendre effet pendant la période de contrat en cours.
403	LastTokenProcessing	The last token request is processing.
403	Instance.UnPaidOrder	The specified instance has unpaid order.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	L'instance à laquelle le disque est attaché est verrouillée pour des raisons de sécurité.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	Cette opération n'est pas prise en charge pour les instances avec ce type de facturation.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	La catégorie de disque spécifiée n'existe pas dans la zone ou le cluster spécifié, ou la zone spécifiée ne correspond pas au cluster.
403	OperationDenied.ImageNotValid	The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	Les instances qui participent à la promotion de forfait d'entrée de gamme ne peuvent être configurées que pour un renouvellement automatique mensuel.
403	RenewDateNotSupported.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed three days before it expires.
403	PrePaidInstance.Expired	The prePaid instance has expired.	L'instance par abonnement a expiré.
403	Forbidden.RiskControl	This operation is forbidden by Aliyun RiskControl system.	L'opération est interdite par le système de gouvernance des risques.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Le disque spécifié n'existe pas. Vérifiez si l'identifiant du disque est correct.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance spécifiée n'existe pas. Vérifiez que l'identifiant de l'instance est correct.

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

Notes de version

Consultez Notes de version pour la liste complète.