ModifyReservedInstances - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Tenez compte des points suivants :

Pour plus d'informations sur les limites relatives aux instances réservées, consultez la section « Limits » de la rubrique Overview.
Avant d'appeler cette opération pour fractionner une instance réservée, assurez-vous de bien connaître les limites applicables. Pour en savoir plus, consultez la rubrique Split a reserved instance.
Avant d'appeler cette opération pour fusionner des instances réservées, assurez-vous de bien connaître les limites applicables. Pour en savoir plus, consultez la rubrique Merge reserved instances.
Avant d'appeler cette opération pour modifier une instance réservée, assurez-vous de bien connaître les limites et les méthodes de modification. Pour en savoir plus, consultez la rubrique Modify a reserved instance.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyReservedInstances	Opération à effectuer. Définissez la valeur sur ModifyReservedInstances.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance réservée. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
ReservedInstanceId.N	String	No	ecsri-bp15xx2****	ID de l'instance réservée N. Valeurs possibles pour N : 1 à 20.
Configuration.N.ReservedInstanceName	String	No	testReservedInstanceName	Nom de l'instance réservée N. Valeurs possibles pour N : 1 à 100. 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://. Il peut contenir des chiffres, des lettres, des deux-points (:), des traits de soulignement (_) et des traits d'union (-).
Configuration.N.ZoneId	String	No	cn-hangzhou-i	ID de zone de l'instance réservée N. Valeurs possibles pour N : 1 à 100. Ce paramètre est requis lorsque `Scope` est défini sur `Zone`. Appelez l'opération DescribeZones pour obtenir la liste des zones les plus récentes.
Configuration.N.Scope	String	Yes	Zone	Portée de l'instance réservée N. Valeurs possibles : Region Zone Valeurs possibles pour N : 1 à 100. Valeur par défaut : Region.
Configuration.N.InstanceType	String	Yes	ecs.c5,4xlarge	Type d'instance que l'instance réservée N peut faire correspondre. Valeurs possibles pour N : 1 à 100. Remarque Les types d'instances applicables sont mis à jour en continu. Pour plus d'informations, consultez la section « Attributes » de la rubrique Reserved instance overview.
Configuration.N.InstanceAmount	Integer	Yes	1	Nombre d'instances à la demande du même type d'instance que l'instance réservée N peut faire correspondre. La valeur de ce paramètre doit être supérieure ou égale à 1. Valeurs possibles pour N : 1 à 100.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7	ID de la requête.
ReservedInstanceIdSets	Array of String	{"ReservedInstanceId":"ecsri-bp1cx3","ecsri-bp15xx2"]}	ID des instances réservées.

Exemples

Exemple de requête

http(s)://ecs.aliyuncs.com/?Action=ModifyReservedInstances
&RegionId=cn-hangzhou
&ReservedInstanceId.1=ecsri-bp1cx3****
&ReservedInstanceId.2=ecsri-bp15xx2****
&Configuration.1.InstanceType=ecs.c5.4xlarge
&Configuration.1.Scope=Zone
&Configuration.2.InstanceType=ecs.g5.4xlarge
&Configuration.2.Scope=Region
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<ModifyReservedInstancesResponse>
    <ReservedInstanceIdSets>
        <ReservedInstanceId>ecsri-bp1cx3****</ReservedInstanceId>
        <ReservedInstanceId>ecsri-bp15xx2****</ReservedInstanceId>
    </ReservedInstanceIdSets>
    <RequestId>ED9E4A5F-FF4D-4C96-BE80-6B4227060DD7</RequestId>
</ModifyReservedInstancesResponse>

Format JSON

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

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Vous n'êtes pas autorisé à utiliser ce type d'instance.
400	InvalidParameter.Conflict	The specified region and cluster do not match.	La région et le cluster spécifiés ne correspondent pas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	La valeur Tag.N.Key n'est pas valide.
400	RegionUnauthorized	%s	Vous n'êtes pas autorisé à effectuer l'opération dans cette région. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
400	Zone.NotOnSale	%s	Les ressources demandées ne sont pas disponibles dans la zone spécifiée. %s est une variable. Un message d'erreur est renvoyé dynamiquement en fonction des conditions d'appel.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	La valeur PeriodUnit n'est pas valide.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	La valeur Tag.N.Value n'est pas valide.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid.	Cette méthode de facturation n'est pas prise en charge. Sélectionnez une autre méthode 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.	Les ressources demandées ne sont pas disponibles dans la zone spécifiée. Essayez un autre type d'instance ou une autre zone. Appelez l'opération DescribeZones pour interroger les ressources disponibles.
403	OperationDenied	Sales of this resource are temporarily suspended in the specified region; please try again later.	La ressource demandée n'est pas disponible dans la région spécifiée. Réessayez ultérieurement.
403	NodeControllerUnavailable	The Node Controller is temporarily unavailable.	Le contrôleur de nœud est temporairement indisponible.
403	OperationDenied	The resource is out of usage.	L'instance n'est pas dans l'état Running. Démarrez l'instance ou vérifiez si l'opération spécifiée n'est pas valide.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.	La valeur ResourceOwnerAccount n'est pas valide.
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.	Vous n'êtes pas autorisé à acheter des ressources dans la zone spécifiée.
403	Zone.NotOnSale	The specified zone is not available for purchase.	Les ressources demandées ne sont pas disponibles dans la zone spécifiée. Essayez d'autres types d'instance ou sélectionnez d'autres régions ou zones.
403	InvalidParameter.NotMatch	%s	Valeur de paramètre non valide. Vérifiez l'existence de conflits de paramètres.
403	Account.Arrearage	Your account has been in arrears.	Le solde du compte est insuffisant. Ajoutez des fonds au compte et réessayez.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Cette opération ne peut pas être effectuée sur la ressource dans son état actuel.
403	OperationDenied.OnlyModifyName	It is not allowed to modify the ReservedInstanceName only.	Le nom de l'instance réservée ne peut pas être modifié séparément.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.
500	InternalError	%s	Une erreur interne s'est produite.

Pour obtenir la liste des codes d'erreur, consultez la rubrique Codes d'erreur de service.