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
|
ecs:ModifyReservedInstances |
update |
*ReservedInstance
|
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 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 :
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.