StopInstance - - Centre de documentation Alibaba Cloud

Description

Si vous appelez l'opération DescribeInstances pour interroger les détails d'une instance et que OperationLocks dans la réponse contient "LockReason": "security", l'instance est verrouillée pour des raisons de sécurité et ne peut pas être arrêtée. Pour plus d'informations, consultez la section Comportement de l'API lorsqu'une instance est verrouillée pour des raisons de sécurité.
Si le mode économique est activé, définissez StoppedMode sur KeepCharging pour activer le mode standard. Après l'arrêt de votre instance en mode standard, la facturation se poursuit et les ressources de type d'instance ainsi que l'adresse IP publique sont conservées.

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 l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	StopInstance	Opération à effectuer. Définissez la valeur sur StopInstance.
InstanceId	String	Oui	i-bp67acfmxazb4ph****	ID de l'instance.
ConfirmStop	Boolean	Non	true	Ce paramètre sera supprimé à l'avenir et n'est conservé qu'à des fins de compatibilité. Nous vous recommandons de l'ignorer.
ForceStop	Boolean	Non	false	Indique s'il faut forcer l'arrêt de l'instance. Valeurs possibles : true : force l'arrêt de l'instance. false : arrête l'instance normalement. Valeur par défaut : false.
StoppedMode	String	Non	KeepCharging	Mode d'arrêt de l'instance avec paiement à l'utilisation. Valeurs possibles : StopCharging : mode économique. Pour savoir comment `StopCharging` prend effet, consultez la section « Prérequis » de la rubrique Mode économique. KeepCharging : mode standard. La facturation se poursuit après l'arrêt de l'instance en mode standard. Valeur par défaut : si les prérequis nécessaires à l'activation du mode économique sont remplis et que vous avez activé ce mode dans la console ECS, la valeur par défaut est StopCharging. Pour plus d'informations, consultez la section « Activer le mode économique » de la rubrique `Mode économique`. Sinon, la valeur par défaut est `KeepCharging`.
DryRun	Boolean	Non	true	Indique s'il faut vérifier la validité de la requête sans l'envoyer réellement. Valeur par défaut : false. Valeurs possibles : true : vérifie la validité de la requête sans l'envoyer. Les éléments vérifiés incluent les paramètres obligatoires, les limites de service, les ressources ECS disponibles et le format de la requête. Si la vérification échoue, le code d'erreur correspondant est renvoyé. Si la vérification réussit, le code d'erreur `DryRunOperation` est renvoyé. false : vérifie la validité de la requête et l'envoie si la vérification réussit. Valeur par défaut : false.
Hibernate	Boolean	Non	hide	Remarque Ce paramètre est actuellement en aperçu sur invitation et n'est pas disponible pour tous les utilisateurs.

Paramètres de réponse

Paramètre

Type

Exemple

Description

RequestId

String

1C488B66-B819-4D14-8711-C4EAAA13AC01

ID de la requête.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-bp67acfmxazb4ph****
&ForceStop=false
&StoppedMode=KeepCharging
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<StopInstanceResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>

Format JSON

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

{
  "RequestId" : "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Codes d'erreur

Code d'état HTTP

Code d'erreur

Message d'erreur

Description

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

L'opération n'est pas prise en charge tant que la ressource se trouve dans l'état actuel.

403

InstanceLockedForSecurity

The specified operation is denied as your instance is locked for security reasons.

L'opération n'est pas prise en charge tant que l'instance est verrouillée pour des raisons de sécurité.

403

DiskError

IncorrectDiskStatus

L'état du disque spécifié n'est pas valide.

403

InstanceType.ParameterMismatch

The input parameter ConfirmStop must be true when an instance have localstorage.

Le paramètre ConfirmStop est défini sur false pour l'instance qui utilise un stockage local.

403

InstanceExpiredOrInArrears

The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).

L'instance d'abonnement a expiré. Renouvelez l'instance et réessayez ultérieurement.

403

InvalidInstanceId.NotSupport

Classic network Instance does not support this operation.

L'opération n'est pas prise en charge par l'instance située dans le réseau classique.

403

InvalidInstanceId.NotSupport

Pre pay instance does not support this operation.

L'opération n'est pas prise en charge par l'instance d'abonnement.

403

InvalidInstanceId.NotSupport

Local disk instance does not support this operation.

L'opération n'est pas prise en charge par l'instance qui utilise des disques locaux.

403

InvalidInstanceId.NotSupport

Spot instance does not support this operation.

L'opération n'est pas prise en charge par l'instance préemptible.

403

IncorrectInstanceStatus

%s

L'opération n'est pas prise en charge tant que l'instance se trouve dans l'état actuel.

403

InvalidParameter.KMSKeyId.CMKNotEnabled

The CMK needs to be enabled.

La clé maître cliente (CMK) spécifiée par le paramètre KMSKeyId n'est pas activée. Vous pouvez appeler l'opération DescribeKey de KMS pour interroger les informations relatives à la CMK spécifiée.

403

InvalidParameter.KMSKeyId.KMSUnauthorized

ECS service have no right to access your KMS.

ECS n'est pas autorisé à accéder à vos ressources KMS.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Le paramètre InstanceId spécifié n'est pas valide.

500

InternalError

The request processing has failed due to some unknown error.

Une erreur interne s'est produite. Réessayez ultérieurement.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Une erreur interne s'est produite. Réessayez ultérieurement.

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