StartInstance - - Centre de documentation Alibaba Cloud

Remarques d'utilisation

Lorsque vous appelez cette opération, tenez compte des points suivants :

Les instances ECS que vous souhaitez démarrer doivent être dans l'état Stopped (Stopped).
Si OperationLocks contient "LockReason" : "security" pour une instance lorsque vous interrogez ses informations, cela signifie que l'instance est verrouillée pour des raisons de sécurité et ne peut pas être démarrée.

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

Parameter	Type	Required	Example	Description
Action	String	Yes	StartInstance	L'opération à effectuer. Définissez la valeur sur StartInstance.
InstanceId	String	Yes	i-bp67acfmxazb4p****	ID de l'instance à démarrer.
InitLocalDisk	Boolean	No	true	Indique s'il faut restaurer l'instance à son état de santé initial. Ce paramètre s'applique aux instances équipées de disques locaux, telles que les instances d1, i1 et i2. Si un disque local d'une instance d1, i1 ou i2 tombe en panne, utilisez ce paramètre pour spécifier si l'instance doit être restaurée à son état de santé initial au démarrage. Valeurs possibles : true : restaure l'instance à son état de santé initial au démarrage. Après la restauration de l'instance à son état initial, les données stockées sur les disques locaux de l'instance sont perdues. false : n'effectue aucune opération et maintient l'instance dans son état actuel. Valeur par défaut : false.
DryRun	Boolean	No	true	Indique s'il faut effectuer une simulation (dry run). Valeurs possibles : true : effectue une simulation. Le système vérifie votre paire AccessKey, les autorisations de l'utilisateur RAM et les paramètres requis. Si la requête échoue à la simulation, un message d'erreur est renvoyé. Si la requête réussit la simulation, le code d'erreur DryRunOperation est renvoyé. false : effectue une simulation et envoie la requête. Si la requête réussit la simulation, un code d'état HTTP 2XX est renvoyé et l'opération est effectuée. Valeur par défaut : false.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID de la requête.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=StartInstance
&InstanceId=i-bp67acfmxazb4p****
&InitLocalDisk=true
&Common request parameters

Exemples de réponses réussies

Format XML

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

<StartInstanceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</StartInstanceResponse>

Format JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist.	Le message d'erreur indique que le paramètre KMSKeyId spécifié n'existe pas.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Le message d'erreur indique que 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.	Le message d'erreur indique que l'instance est verrouillée pour des raisons de sécurité.
403	InsufficientBalance	Your account does not have enough balance.	Le message d'erreur indique que le solde de votre compte est insuffisant. Approvisionnez votre compte et réessayez.
403	DiskError	IncorrectDiskStatus.	Le message d'erreur indique que l'état du disque spécifié n'est pas valide.
403	InstanceExpired	The postPaid instance has been expired. Please ensure your account have enough balance.	Le message d'erreur indique que l'instance prépayée a expiré. Lorsqu'une instance prépayée est arrêtée en raison d'un impayé, elle passe à l'état Expired. Veillez à maintenir un solde de compte suffisant.
403	InstanceNotReady	The specified instance is not ready for use.	Le message d'erreur indique que l'opération n'est pas prise en charge tant que la ressource se trouve dans l'état actuel. Réessayez ultérieurement.
403	DiskInArrears	The specified operation is denied as your disk has expired.	Le message d'erreur indique que le disque a expiré en raison d'impayés.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Le message d'erreur indique que les ressources demandées ne sont pas disponibles dans la zone spécifiée. Essayez un autre type d'instance ou une autre zone. Vous pouvez appeler l'opération DescribeZones pour interroger les ressources disponibles dans les zones.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	Le message d'erreur indique que le prix horaire maximal défini par l'utilisateur pour une instance preemptible est inférieur au prix actuel du marché.
403	IncorrectInstanceStatus	%s	Le message d'erreur indique que 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.	Le message d'erreur indique que la clé maître client (CMK) n'est pas activée lorsqu'un ID de clé KMS est spécifié pour un disque. 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.	Le message d'erreur indique qu'ECS n'est pas autorisé à accéder à vos ressources KMS.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Le message d'erreur indique que le nombre maximal d'instances du type d'instance spécifié dans la région a été atteint. Vous pouvez essayer une autre région ou un autre type d'instance, ou réduire le nombre d'instances que vous souhaitez acheter. Vous pouvez également accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	Le message d'erreur indique que le nombre maximal d'instances du type d'instance spécifié dans la région a été atteint. Vous pouvez essayer une autre région ou un autre type d'instance, ou réduire le nombre d'instances que vous souhaitez acheter. Vous pouvez également accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Le message d'erreur indique que le nombre maximal de vCPU pour tous les types d'instance a été atteint dans la zone. Vous pouvez accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Le message d'erreur indique que le nombre maximal d'instances du type d'instance spécifié dans la région a été atteint ou que le nombre maximal de vCPU pour tous les types d'instance a été atteint. Vous pouvez accéder à la console ECS ou au Quota Center pour demander une augmentation de quota.
403	OperationDenied.HostRepairing	The specified operation is denied as the host of ECS instance is being repaired.	Le message d'erreur indique que l'opération n'est pas prise en charge tant que la machine physique qui héberge l'instance ECS est en cours de réparation.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Le message d'erreur indique que le paramètre InstanceId spécifié n'existe pas.
500	InternalError	The request processing has failed due to some unknown error.	Le message d'erreur indique qu'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.	Le message d'erreur indique qu'une erreur interne s'est produite. Réessayez ultérieurement.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Le message d'erreur indique que la requête a échoué en raison d'une défaillance temporaire du serveur backend.

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