Tous les produits
Search
Centre de documentation

Elastic Compute Service:ModifyReservedInstances

Dernière mise à jour :Aug 18, 2026

Modifie les configurations d'une instance réservée, telles que le type d'instance, la quantité et la zone, afin de diviser, fusionner ou modifier la portée de l'instance réservée.

Description de l'opération

Cette opération est asynchrone. Après avoir appelé cette opération pour modifier une instance réservée, l'opération lance le processus de modification et renvoie l'identifiant de la nouvelle instance réservée résultante. L'instance réservée d'origine passe à l'état Updating puis à l'état Inactive. Parallèlement, la nouvelle instance réservée résultante est générée et passe à l'état Creating puis à l'état Active. Vous pouvez appeler l'opération DescribeReservedInstances pour interroger les états de l'instance réservée.

  • Vous ne pouvez modifier les configurations d'une instance réservée que si celle-ci est dans l'état Active.

  • Assurez-vous que la puissance de calcul de l'instance réservée reste inchangée avant et après la modification. Sinon, la modification échoue.

  • Vous ne pouvez pas diviser, fusionner ou modifier la portée d'une instance réservée en même temps.

Pour plus d'informations, consultez Diviser, fusionner ou modifier des instances réservées.

Exemples de requêtes

  • Exemple de requête pour diviser une instance réservée : Diviser une instance réservée régionale dont la portée est la région de Chine (Hangzhou) et qui peut correspondre à deux instances à la demande de type d'instance ecs.g5.xlarge en deux instances réservées régionales dont la portée est la région de Chine (Hangzhou) et qui peuvent chacune correspondre à une instance à la demande de type d'instance ecs.g5.large :

"RegionId":"cn-hangzhou", //L'identifiant de la région.
"ReservedInstanceId":["ecsri-bp1hd03e9uv19e75****"], //L'identifiant de l'instance réservée que vous souhaitez diviser.
"Configuration":[
  {
    "ReservedInstanceName":"testReservedInstanceName1", //Le nom de la nouvelle instance réservée.
    "InstanceType":"ecs.g5.large", //Le type d'instance auquel la nouvelle instance réservée peut correspondre.
    "Scope":"Region", //Le niveau de portée de la nouvelle instance réservée, qui doit être identique au niveau de portée de l'instance réservée d'origine.
    "InstanceAmount":1 //Le nombre d'instances à la demande du type d'instance spécifié auxquelles chaque nouvelle instance réservée peut correspondre.
  },
  {
    "ReservedInstanceName":"testReservedInstanceName2",
    "InstanceType":"ecs.g5.large",
    "Scope":"Region",
    "InstanceAmount":1
  }
]
  • Exemple de requête pour fusionner des instances réservées : Fusionner deux instances réservées zonales dont la portée est la zone H de Hangzhou et qui peuvent correspondre à quatre instances à la demande de type d'instance ecs.g5.xlarge en une instance réservée zonale dont la portée est la zone H de Hangzhou et qui peut correspondre à deux instances à la demande de type d'instance ecs.g5.4xlarge :

"RegionId":"cn-hangzhou", //L'identifiant de la région.
"ReservedInstanceId":["ecsri-bp1hd03e9uv16b75****",""ecsri-bp1hd03e9uv16b76****""], //Les identifiants des instances réservées que vous souhaitez fusionner.
"Configuration":[
  {
    "ReservedInstanceName":"testReservedInstanceName", //Le nom de la nouvelle instance réservée.
    "InstanceType":"ecs.g5.4xlarge", //Le type d'instance auquel la nouvelle instance réservée peut correspondre.
    "Scope":"Zone", //Le niveau de portée de la nouvelle instance réservée, qui doit être identique au niveau de portée des instances réservées d'origine.
    "ZoneId":"cn-hangzhou-h", //
    "InstanceAmount":2 //Le nombre d'instances à la demande du type d'instance spécifié auxquelles la nouvelle instance réservée peut correspondre.
  }
]
  • Exemple de requête pour modifier la portée d'une instance réservée : Modifier une instance réservée régionale dont la portée est la zone H de Hangzhou et qui peut correspondre à six instances à la demande de type d'instance ecs.g5.xlarge en une instance réservée régionale dont la portée est la région de Chine (Hangzhou) et qui peut correspondre à trois instances à la demande de type d'instance ecs.g5.2xlarge.

"RegionId":"cn-hangzhou", //L'identifiant de la région.
"ReservedInstanceId":["ecsri-bp1hd03e9uv16b77****"], //L'identifiant de l'instance réservée dont vous souhaitez modifier la portée.
"Configuration":[
  {
    "ReservedInstanceName":"testReservedInstanceName", //Le nom de la nouvelle instance réservée.
    "InstanceType":"ecs.g5.2xlarge", //Le type d'instance auquel la nouvelle instance réservée peut correspondre.
    "Scope":"Region", //Le niveau de portée de la nouvelle instance réservée.
    "InstanceAmount":3 //Le nombre d'instances à la demande du type d'instance spécifié auxquelles la nouvelle instance réservée peut correspondre.
  }
]

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

update

*ReservedInstance

acs:ecs:{#regionId}:{#accountId}:reservedinstance/{#reservedinstanceId}

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région de l'instance réservée.

Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

cn-hangzhou

ReservedInstanceId

array

Oui

Les identifiants des instances réservées que vous souhaitez modifier. Vous pouvez spécifier jusqu'à 20 identifiants d'instances réservées.

ReservedInstanceId.1="ecsri-bp1cx3****",ReservedInstanceId.2="ecsri-bp15xx2****".....

string

Non

L'identifiant de l'instance réservée.

ecsri-bp15xx2****

Configuration

array<object>

Non

Les configurations des nouvelles instances réservées. Vous pouvez spécifier jusqu'à 100 nouvelles instances réservées.

object

Non

Les configurations de la nouvelle instance réservée.

ReservedInstanceName

string

Non

Le nom de la nouvelle instance réservée.

Le nom doit comporter entre 2 et 128 caractères. Il doit commencer par une lettre et ne peut pas commencer par http:// ou https://. Le nom peut contenir des lettres, des chiffres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).

testReservedInstanceName

ZoneId

string

Non

L'identifiant de la zone de la nouvelle instance réservée.

Ce paramètre est requis lorsque vous définissez Scope sur Zone.

Vous pouvez appeler l'opération DescribeZones pour obtenir la liste des zones la plus récente.

cn-hangzhou-i

Scope

string

Oui

Le niveau de portée de la nouvelle instance réservée. Valeurs valides :

  • Region

  • Zone

Valeur par défaut : Region.

Zone

InstanceType

string

Oui

Les types d'instance auxquels la nouvelle instance réservée peut correspondre.

Remarque

Les types d'instance pris en charge sont continuellement mis à jour. Pour plus d'informations sur les types d'instance pris en charge par les instances réservées, consultez Présentation des instances réservées.

ecs.c5.4xlarge

InstanceAmount

integer

Oui

Le nombre d'instances à la demande du type d'instance spécifié auxquelles la nouvelle instance réservée peut correspondre. La valeur de ce paramètre doit être supérieure ou égale à 1.

1

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

Détails sur l'instance réservée.

ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7

ReservedInstanceIdSets

object

ReservedInstanceId

array

Les identifiants des instances réservées.

string

L'identifiant de l'instance réservée.

"ecsri-bp1cx3****"

Exemples

JSON format

{
  "RequestId": "ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7",
  "ReservedInstanceIdSets": {
    "ReservedInstanceId": [
      "\"ecsri-bp1cx3****\""
    ]
  }
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
400 InvalidParameter.Conflict The specified region and cluster do not match. The specified region and cluster do not correspond to each other.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. The specified Tag.N.Key parameter is invalid.
400 InvalidPeriodUnit.ValueNotSupported The specified parameter PeriodUnit is not valid. The specified PeriodUnit parameter is invalid.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. The specified tag value is invalid.
400 InvalidChargeType.ValueNotSupported ChargeType is not valid.
400 OperationDenied The specified InstanceType or Zone is not authorized for current user.
500 InternalError The request processing has failed due to some unknown error.
403 OperationDenied.NoStock The requested resource is sold out in the specified zone; try other types of resources or other regions and zones. The requested resources are insufficient.
403 OperationDenied Sales of this resource are temporarily suspended in the specified region; please try again later. The requested resource is unavailable in the specified region. Try again later.
403 NodeControllerUnavailable The Node Controller is temporarily unavailable.
403 InvalidParameter.ResourceOwnerAccount ResourceOwnerAccount is Invalid. The specified ResourceOwnerAccount parameter is invalid.
403 Zone.NotOpen The specified zone is not granted to you to buy resources yet.
403 Zone.NotOnSale The specified zone is not available for purchase. The requested resources are unavailable in the specified zone. Try a different instance type or select a different region or zone.
403 Account.Arrearage Your account has been in arrears.
403 InvalidReservedInstanceName.Malformed The specified parameter ReservedInstanceName is invalid.
403 InvalidParameter.Scope The specified parameter 'Scope' is invalid.
403 InvalidReservedInstanceStatus.ValueNotSupported ReservedInstance status is not supported.
403 InvalidReservedInstanceOfferingType.ValueNotSupported The OfferingType is not supported.
403 InvalidReservedInstanceOfferingClass.ValueNotSupported The OfferingClass is not supported.
403 MissingParameter.ZoneId The specified zoneId should be not empty.
403 MissingParameter.InstanceType The instanceType should be not empty.
403 MissingParameter.ReservedInstanceId The ids of reservedInstance can not be empty.
403 MissingParameter.ReservedInstanceConfiguration The configurations of reservedInstance can not be empty.
403 InvalidParameter.SplitOrMerge The Many-to-many of modification is not supported.
403 MissingParameter.InstanceTypeAndAmountBothEmpty The instanceType and amount can not be both empty.
403 InvalidReservedInstancePlatform.ValueNotSupported The Platform is not supported.
403 InvalidParameter.ReservedInstanceName The reservedInstanceName is invalid. reservedInstanceName field value is illegal
403 InvalidReservedInstanceZone.ValueNotSupported The zoneId is not exist.
403 InvalidParameter.ValueNotSupported The instanceTypeFamily of the instance to be changed must be consistent.
403 IncorrectInstanceStatus The status of specified reservedInstance must be active. The operation is not allowed because the instance status does not support it.
403 InvalidPlatform.ValueNotSupported The platform of reservedInstance is invalid.
403 InvalidScope.ValueNotSupported The scope of reservedInstance is invalid. The valid value is Zone or Region.
403 InvalidConfiguration.ValueNotSupported The modification Configuration should not be empty.
403 InvalidZoneId.ValueNotSupported The specified zoneId should be same.
403 InvalidParameter The parameter is invalid.Please check it.
403 InvalidInstanceAmount.ValueNotSupported The instanceAmount is invalid.
403 OperationDenied.OnlyModifyName It is not allowed to modify the ReservedInstanceName only. The reserved instance name cannot be separately modified.
403 InvalidReservedInstanceId.NotFound The specified parameter ReservedInstanceId is invalid.
404 InvalidZoneId.NotFound The ZoneId provided does not exist in our records.

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

Notes de version

Consultez Notes de version pour la liste complète.