ModifyInstanceChargeType - - Centre de documentation Alibaba Cloud

Modifie le mode de facturation d'une ou plusieurs instances Elastic Compute Service (ECS). Vous pouvez basculer le mode de facturation des instances entre le paiement à l'utilisation et l'abonnement, ou changer le mode de facturation de tous les disques de données attachés à une instance du paiement à l'utilisation vers l'abonnement.

Notes d'utilisation

Avant d'appeler cette opération, assurez-vous de bien comprendre les modes de facturation et la grille tarifaire d'ECS. Pour plus d'informations, consultez la page produit Elastic Compute Service.

Tenez compte des points suivants :

Les instances doivent être dans l'état Running (Running) ou Stopped (Stopped), et vous ne devez avoir aucun impayé les concernant.
Après la modification du mode de facturation, le paiement est effectué automatiquement. Veillez à maintenir un solde de compte suffisant. Dans le cas contraire, votre commande devient invalide et doit être annulée. Si le solde de votre compte est insuffisant, définissez AutoPay sur false pour générer une commande non payée. Connectez-vous ensuite à la ECS console pour régler la commande.
Passage du mode abonnement au paiement à l'utilisation :
- Votre utilisation d'ECS détermine si le mode de facturation d'une instance peut être modifié de l'abonnement au paiement à l'utilisation.
- Après avoir modifié le mode de facturation d'une instance de l'abonnement au paiement à l'utilisation, le nouveau mode de facturation reste en vigueur pour le reste du cycle de vie de l'instance. La différence de prix est remboursée sur le compte de paiement que vous avez utilisé. Les bons d'achat déjà utilisés ne sont pas remboursables.
- Règle de remboursement : vous disposez d'un quota pour le montant total des remboursements chaque mois, et le solde inutilisé de ce quota n'est pas reporté au mois suivant. Après avoir épuisé le quota de remboursement du mois en cours, vous ne pourrez modifier le mode de facturation qu'au mois suivant. Le montant du remboursement encouru lors de la modification du mode de facturation est calculé selon la formule suivante : Nombre de vCPU × (Nombre de jours restants × 24 ± Nombre d'heures restantes ou écoulées).
Passage du mode paiement à l'utilisation à l'abonnement :
- Vous pouvez modifier le mode de facturation de tous les disques de données attachés à une instance, en passant du paiement à l'utilisation à l'abonnement.
- Cette opération ne peut pas être appelée pour une instance en paiement à l'utilisation dont l'heure de libération automatique est définie.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyInstanceChargeType	L'opération que vous souhaitez effectuer. Définissez la valeur sur ModifyInstanceChargeType.
InstanceIds	String	Yes	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]	Les ID des instances. La valeur peut être un tableau JSON contenant jusqu'à 20 ID d'instance. Séparez les ID d'instance par des virgules (,).
RegionId	String	Yes	cn-hangzhou	L'ID de région de l'instance. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
Period	Integer	No	1	La durée de renouvellement de l'instance en abonnement. Si l'instance est hébergée sur un hôte dédié, la durée de renouvellement de l'instance ne peut pas dépasser la durée d'abonnement de l'hôte dédié. Valeurs valides : Valeurs valides lorsque `PeriodUnit` est défini sur Month : `1, 2, 3, 4, 5, 6, 7, 8, 9, and 12`.
PeriodUnit	String	No	Month	L'unité de la durée de renouvellement (`Period`). Valeurs valides : Month Valeur par défaut : Month.
IncludeDataDisks	Boolean	No	false	Indique s'il faut modifier le mode de facturation de tous les disques de données de l'instance, en passant du paiement à l'utilisation à l'abonnement. true false Valeur par défaut : false.
DryRun	Boolean	No	false	Indique s'il faut effectuer uniquement un test à blanc, sans exécuter la requête réelle. Valeurs valides : true : effectue uniquement un test à blanc. Le système vérifie la paire AccessKey, les autorisations de l'utilisateur RAM et les paramètres requis. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, le code d'erreur `DryRunOperation` est renvoyé. false : effectue un test à blanc et exécute la requête réelle. Si la requête réussit le test à blanc, un code d'état HTTP 2xx est renvoyé et l'opération est effectuée. Valeur par défaut : false.
AutoPay	Boolean	No	false	Indique s'il faut effectuer le paiement automatiquement. Valeurs valides : true : le paiement est effectué automatiquement. Veillez à maintenir un solde de compte suffisant. Dans le cas contraire, votre commande devient invalide et est annulée. false : une commande est générée mais aucun paiement n'est effectué. Valeur par défaut : true. Remarque Si le solde de votre compte est insuffisant, définissez AutoPay sur false pour générer une commande non payée. Connectez-vous ensuite à la console ECS pour régler la commande.
InstanceChargeType	String	No	PrePaid	Le nouveau mode de facturation. Valeurs valides : PrePaid : abonnement PostPaid : paiement à l'utilisation Valeur par défaut : PrePaid.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique parmi différentes requêtes. Le token ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères. Pour plus d'informations, consultez la rubrique Comment garantir l'idempotence.
IsDetailFee	Boolean	No	false	Indique s'il faut renvoyer les détails des coûts de la commande après la modification du mode de facturation, en passant de l'abonnement au paiement à l'utilisation. Valeurs valides : true false Valeur par défaut : false.

Paramètres de réponse

Parameter	Type	Example	Description
OrderId	String	20413515388****	L'ID de la commande.
RequestId	String	B61C08E5-403A-46A2-96C1-F7B1216DB10C	L'ID de la requête.
FeeOfInstances	Array of FeeOfInstance		Détails des frais de la commande.
FeeOfInstance
InstanceId	String	i-bp67acfmxazb4p****	L'ID de l'instance.
Currency	String	CNY	L'unité monétaire de la facture. Site Alibaba Cloud Chine (aliyun.com) : CNY. Site Alibaba Cloud International (alibabacloud.com) : USD.
Fee	String	0	La valeur du coût.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceChargeType
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb4p****","i-bp67acfmxazb4d****"]
&Period=1
&PeriodUnit=Month
&AutoPay=false
&IncludeDataDisks=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyInstanceChargeTypeResponse>
    <OrderId>20413515388****</OrderId>
    <RequestId>B61C08E5-403A-46A2-96C1-F7B1216DB10C</RequestId>
    <FeeOfInstances>
        <InstanceId>i-bp67acfmxazb4p****</InstanceId>
        <Currency>CNY</Currency>
        <Fee>0</Fee>
    </FeeOfInstances>
</ModifyInstanceChargeTypeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "OrderId" : "20413515388****",
  "RequestId" : "B61C08E5-403A-46A2-96C1-F7B1216DB10C",
  "FeeOfInstances" : [ {
    "InstanceId" : "i-bp67acfmxazb4p****",
    "Currency" : "CNY",
    "Fee" : "0"
  } ]
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	Valeur InstanceIds non valide.
400	InvalidParameter	%s	Paramètre non valide.
400	InvalidStatus.ValueNotSupported	%s	Cette opération ne peut pas être effectuée sur la ressource dans son état actuel.
400	InvalidInstanceChargeType.ValueNotSupported	%s	Valeur InstanceChargeType non valide.
400	ExpiredInstance	The specified instance has expired.	L'instance spécifiée a expiré.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.	Le nombre maximal d'instances est dépassé.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Valeur ClientToken non valide.
400	InvalidInternetChargeType.ValueNotSupported	%s	Valeur InternetChargeType non valide.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	Une heure de libération automatique est définie pour l'instance spécifiée.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Votre requête est refusée en raison d'une limitation de débit. Réessayez dans 5 minutes.
400	Throttling	%s	La requête est refusée en raison d'une limitation de débit.
400	InvalidParameter.Bandwidth	%s	Bande passante non valide. Vérifiez les valeurs des paramètres.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	La valeur Period se situe en dehors de la plage déterminée par le paramètre PeriodUnit.
400	InvalidImageType.NotSupported	%s	Type d'image non valide. Vérifiez si le type d'image est pris en charge dans la région.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	Le mode de facturation de l'image Alibaba Cloud Marketplace n'est pas pris en charge.
400	InvalidSystemDiskCategory.ValueNotSupported	%s	La catégorie de disque système ne prend pas en charge cette opération.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	Aucun disque système n'est attaché à l'instance spécifiée. Assurez-vous que l'instance spécifiée possède un disque système attaché. Vous pouvez appeler l'opération DescribeInstances pour interroger les détails de l'instance.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	Les utilisateurs internes ne peuvent acheter que des instances ECS en paiement à l'utilisation. Ils ne peuvent pas acheter de produits tiers tels que les images Alibaba Cloud Marketplace. Vérifiez les paramètres. Assurez-vous que tous les paramètres remplissent les conditions et réessayez.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Cette opération ne peut pas être effectuée lorsque PrivatePoolOptions.MatchCriteria est défini sur Target.
400	InvalidPeriod	The specified period is not valid.	Valeur Period non valide.
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	Vous ne pouvez pas modifier le mode de facturation de l'instance en paiement à l'utilisation pendant une période de mise à niveau temporaire de la bande passante.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Le type d'instance est introuvable ou vous n'êtes pas autorisé à gérer des instances de ce type.
403	InstanceType.Offline	%s	L'opération ne peut pas être effectuée lorsque le type d'instance est retiré ou lorsque le stock du type d'instance est insuffisant.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Le solde de votre compte est insuffisant. Ajoutez des fonds à votre compte et réessayez.
403	Account.Arrearage	Your account has an outstanding payment.	Vous avez des commandes impayées dans votre compte.
403	InvalidParameter.NotMatch	%s	Valeur de paramètre non valide. Vérifiez l'existence de conflits de paramètres.
403	InvalidAction	%s	L'opération n'est pas valide.
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	Le nombre maximal de disques en paiement à l'utilisation est dépassé.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	L'image Alibaba Cloud Marketplace spécifiée ne prend pas en charge le type d'instance.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	Le type d'instance spécifié est retiré.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Vous n'avez pas terminé la vérification d'identité réelle. Effectuez la vérification d'identité réelle et réessayez.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Le nombre maximal d'instances du type d'instance spécifié dans la région est dépassé. Essayez une autre région ou un autre type d'instance, ou réduisez le nombre d'instances que vous souhaitez créer. Vous pouvez également accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	Le nombre maximal d'instances du type d'instance spécifié dans la région est dépassé. Essayez une autre région ou un autre type d'instance, ou réduisez le nombre d'instances que vous souhaitez créer. Vous pouvez également accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Le nombre maximal de vCPU pour tous les types d'instance est dépassé. Vous pouvez accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Le nombre maximal d'instances du type d'instance spécifié dans la région, ou le nombre maximal de vCPU pour tous les types d'instance est dépassé. Vous pouvez accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	L'ID d'instance spécifié est introuvable.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Une erreur interne s'est produite. Réessayez ultérieurement.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Vous n'êtes pas autorisé à utiliser le type d'instance.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Service error codes.