Tous les produits
Search
Centre de documentation

:ModifyInstanceMaintenanceAttributes

Dernière mise à jour :Aug 18, 2026

Cette opération permet de modifier les propriétés de maintenance d'une ou plusieurs instances.

Description

Cette opération modifie la politique de maintenance d'une instance. Cette politique comprend les propriétés suivantes :

  • Fenêtre de maintenance : période durant laquelle la maintenance est autorisée.

  • Action de maintenance : comportement défini en cas d'arrêt de l'instance.

Débogage

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

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

ModifyInstanceMaintenanceAttributes

Opération à exécuter. Définissez la valeur sur ModifyInstanceMaintenanceAttributes.

RegionId

String

Oui

cn-hangzhou

ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.

InstanceId.N

RepeatList

Non

i-bp67acfmxazb4ph****

ID de l'instance N. Les valeurs valides de N vont de 1 à 100.

MaintenanceWindow.N.StartTime

String

Non

02:00:00

Heure de début de la fenêtre de maintenance N. L'heure doit correspondre exactement à une heure pleine (0 minute et 0 seconde). Les paramètres MaintenanceWindow.N.StartTime et MaintenanceWindow.N.EndTime doivent être spécifiés simultanément. La valeur de MaintenanceWindow.N.Endtime doit se situer entre 1 et 23 heures après celle de MaintenanceWindow.N.StartTime. Spécifiez l'heure au format HH:mm:ss. L'heure doit être exprimée en UTC+8. Définissez la valeur de N sur 1.

MaintenanceWindow.N.EndTime

String

Non

18:00:00

Heure de fin de la fenêtre de maintenance N. L'heure doit correspondre exactement à une heure pleine (0 minute et 0 seconde). Les paramètres MaintenanceWindow.N.StartTime et MaintenanceWindow.N.EndTime doivent être spécifiés simultanément. La valeur de MaintenanceWindow.N.Endtime doit se situer entre 1 et 23 heures après celle de MaintenanceWindow.N.StartTime. Spécifiez l'heure au format HH:mm:ss. L'heure doit être exprimée en UTC+8. Définissez la valeur de N sur 1.

ActionOnMaintenance

String

Non

AutoRecover

Action de maintenance. Valeurs valides :

  • Stop : arrête l'instance.

  • AutoRecover : récupère automatiquement l'instance.

  • AutoRedeploy : déclenche un basculement de l'instance, ce qui peut endommager les disques de données attachés.

NotifyOnMaintenance

Boolean

Non

false

Indique s'il faut envoyer une notification d'événement avant l'arrêt de l'instance. Valeurs valides :

  • True : envoie une notification d'événement.

  • False : n'envoie pas de notification d'événement.

Valeur par défaut : false.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com?Action=ModifyInstanceMaintenanceAttributes
&InstanceId.1=i-bp67acfmxazb4ph****
&ActionOnMaintenance=AutoRecover
&<Common request parameters>

Exemples de réponses en cas de succès

Format XML

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

<ModifyInstanceMaintenanceAttributesResponse>    
    <RequestId>E69FF3CC-94DD-42EF-8836-F33C45EDF9945ED</RequestId>
<ModifyInstanceMaintenanceAttributesResponse>

Format JSON

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

{
    "RequestId": "E69FF3CC-94DD-42EF-8836-F33C45EDF9945ED"
}

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

404

InvalidInstanceId.NotFound

%s

Erreur renvoyée car l'instance spécifiée n'existe pas.

403

InvalidParameter

%s

Erreur renvoyée car un paramètre spécifié n'est pas valide.

403

OperationDenied.NotInWhiteList

%s

Erreur renvoyée car vous n'êtes pas autorisé à exécuter cette opération. Réessayez une fois l'autorisation obtenue.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.