RebootInstances - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Les instances ECS à redémarrer doivent être à l'état Running(Running).
Les opérations par lot sont prises en charge. Utilisez le paramètre BatchOptimization pour spécifier le mode d'opération par lot.
Le redémarrage forcé (ForceReboot) est pris en charge. Un redémarrage forcé équivaut à éteindre puis redémarrer un serveur traditionnel. Cela peut entraîner la perte des données non écrites sur le stockage de blocs du système d'exploitation de l'instance.
Lorsque vous interrogez les informations d'une instance ECS, toutes les opérations sont interdites sur l'instance si la réponse contient {"OperationLocks": {"LockReason" : "security"}}.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. 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	RebootInstances	Opération à effectuer. Définissez la valeur sur RebootInstances.
DryRun	Boolean	No	false	Indique s'il faut effectuer uniquement un test à blanc, sans exécuter la requête réelle. Valeurs possibles : true : effectue uniquement un test à blanc. Le système vérifie la requête pour détecter d'éventuels problèmes, notamment les valeurs de paramètres manquantes, la syntaxe de requête incorrecte et les limites de service. Si la requête échoue au test à blanc, un message d'erreur est renvoyé. Si la requête réussit le test à blanc, `DRYRUN.SUCCESS` est renvoyé. Remarque Si vous définissez `BatchOptimization` sur `SuccessFirst` et `DryRun` sur true, seul `DRYRUN.SUCCESS` est renvoyé, que la requête réussisse ou non le test à blanc. false : effectue un test à blanc et exécute la requête réelle. Si la requête réussit le test à blanc, l'opération est effectuée. Valeur par défaut : false.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ForceReboot	Boolean	No	false	Indique s'il faut redémarrer l'instance de force. Valeurs possibles : true : redémarre l'instance de force. Cette opération équivaut à une mise hors tension classique. Les données en cache non écrites sur les périphériques de stockage de l'instance sont perdues. false : redémarre l'instance normalement. Valeur par défaut : false.
BatchOptimization	String	No	AllTogether	Mode d'opération par lot. Valeurs possibles : AllTogether : dans ce mode, un message de succès est renvoyé si toutes les instances spécifiées sont redémarrées. Si une ou plusieurs des instances spécifiées échouent à la vérification lorsque vous définissez DryRun sur false, aucune des instances spécifiées n'est redémarrée et un message d'erreur est renvoyé. SuccessFirst : dans ce mode, chaque instance est redémarrée séparément. La réponse contient les résultats de l'opération pour chaque instance. Valeur par défaut : AllTogether.
InstanceId.N	String	Yes	i-bp67acfmxazb4p****	ID de l'instance N.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
InstanceResponses	Array of InstanceResponse		Réponses spécifiques à l'instance, contenant l'état de chaque instance avant et après l'appel de l'opération ainsi que les résultats de l'opération.
InstanceResponse
Code	String	200	Code d'erreur renvoyé pour l'instance. La valeur de retour 200 indique que l'opération a réussi. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
Message	String	success	Message d'erreur renvoyé pour l'instance. La valeur de retour Success indique que l'opération a réussi. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
InstanceId	String	i-bp1g6zv0ce8oghu7****	ID de l'instance.
CurrentStatus	String	Stopping	État actuel de l'instance.
PreviousStatus	String	Running	État de l'instance avant l'appel de l'opération.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=RebootInstances
&InstanceId.1=i-bp1g6zv0ce8oghu7****
&InstanceId.2=i-bp1g6zv0ce8oghu7****
&InstanceId.3=i-TestID
&RegionId=cn-hangzhou
&ForceReboot=false
$BatchOptimization=SuccessFirst
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<RebootInstancesResponse>
    <RequestId>FF53E96D-3F1A-42F0-8373-1C2B39D72D44</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp1g6zv0ce8oghu7****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp1g6zv0ce8oghu7****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>The specified InstanceId does not exist.</Message>
            <InstanceId>i-TestID</InstanceId>
            <PreviousStatus/>
            <CurrentStatus/>
            <Code>InvalidInstanceId.NotFound</Code>
        </InstanceResponse>
    </InstanceResponses>
</RebootInstancesResponse>

Format JSON

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

{
  "RequestId" : "FF53E96D-3F1A-42F0-8373-1C2B39D72D44",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp1g6zv0ce8oghu7****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp1g6zv0ce8oghu7****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "Code" : "200"
    }, {
      "Message" : "The specified InstanceId does not exist.",
      "InstanceId" : "i-TestID",
      "PreviousStatus" : "",
      "CurrentStatus" : "",
      "Code" : "InvalidInstanceId.NotFound"
    } ]
  }
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	La clé maître cliente (CMK) n'est pas activée lorsque l'ID de la CMK est spécifié pour un disque. Appelez l'opération DescribeKey de KMS pour obtenir les informations relatives à la CMK spécifiée.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Un test à blanc est effectué et la requête réussit le test à blanc.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Valeur InstanceId.N non valide.
403	IncorrectInstanceStatus	%s	L'opération ne peut pas être effectuée sur l'instance dans son état actuel.
403	InvalidInstance.NotFoundSystemDisk	%s	L'instance spécifiée ne possède pas de disque système et ne peut pas être démarrée. Pour plus d'informations, consultez la valeur de retour de l'espace réservé %s dans le message d'erreur. Appelez l'opération AttachDisk pour attacher un disque système à l'instance spécifiée.
403	InsufficientBalance	Your account does not have enough balance.	Le solde du compte est insuffisant. Approvisionnez votre compte et réessayez.
403	InstanceNotReady	The specified instance is not ready for use.	L'opération ne peut pas être effectuée sur la ressource dans son état actuel. Réessayez ultérieurement.
404	InvalidInstanceId.NotFound	%s	L'instance spécifiée est introuvable. Vérifiez si l'ID d'instance spécifié est valide.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	L'instance spécifiée est introuvable. Vérifiez si l'ID d'instance spécifié est correct. Appelez l'opération DescribeInstances pour interroger l'état d'instances spécifiques.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	L'instance est introuvable. Vérifiez si l'ID d'instance est correct.
500	InternalError	The request processing has failed due to some unknown error.	Une erreur interne s'est produite. Réessayez ultérieurement.

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