StartInstances - - Centre de documentation Alibaba Cloud

Notes d'utilisation

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

Les instances que vous souhaitez démarrer doivent être à l'état Stopped(Stopped).
Si la réponse contient {"OperationLocks": {"LockReason" : "security"}} lorsque vous interrogez les informations de l'instance, celle-ci est verrouillée pour des raisons de sécurité et toutes les opérations sont interdites.
Les opérations par lot sont prises en charge. Utilisez le paramètre BatchOptimization pour spécifier le mode d'opération par lot.

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	StartInstances	L'opération que vous souhaitez effectuer. Définissez la valeur sur StartInstances.
DryRun	Boolean	No	false	Indique s'il faut effectuer un test à blanc. Valeurs possibles : true : effectue un test à blanc. Le système vérifie les paramètres requis, la syntaxe de la requête et l'état de l'instance. 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 envoie la requête. 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	L'ID de région de l'instance. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
BatchOptimization	String	No	AllTogether	Le 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 démarrées. Si une ou plusieurs des instances spécifiées échouent à la vérification lorsque vous définissez le paramètre DryRun sur false, aucune des instances spécifiées ne peut être démarrée et un message d'erreur est renvoyé. SuccessFirst : dans ce mode, chaque instance est dé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****	L'ID de l'instance N. Valeurs possibles de N : 1 à 100.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	L'ID de la requête.
InstanceResponses	Array of InstanceResponse		Détails des réponses spécifiques à l'instance, qui contiennent 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	Le code d'erreur renvoyé pour l'instance. La valeur de retour 200 indique un succès. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
Message	String	success	Le message d'erreur renvoyé pour l'instance. Une valeur de retour « success » indique le succès de l'opération. Pour plus d'informations, consultez la section « Codes d'erreur » de cette rubrique.
InstanceId	String	i-bp67acfmxazb4p****	L'ID de l'instance.
CurrentStatus	String	Starting	L'état actuel de l'instance.
PreviousStatus	String	Stopped	L'état de l'instance avant l'appel de l'opération.

Exemples

Exemples de requêtes

http(s)://ecs.aliyuncs.com/?Action=StartInstances
&RegionId=cn-hangzhou
&BatchOptimization=AllTogether
&InstanceId=["i-bp67acfmxazb4p****"]
&Common request parameters

Exemples de réponses réussies

Format XML

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

<StartInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Stopped</PreviousStatus>
            <CurrentStatus>Starting</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Stopped</PreviousStatus>
            <CurrentStatus>Starting</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>
</StartInstancesResponse>

Format JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Stopped",
      "CurrentStatus" : "Starting",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Stopped",
      "CurrentStatus" : "Starting",
      "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.	Le message d'erreur renvoyé car 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 sur la CMK spécifiée.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Le message d'erreur renvoyé car un test à blanc est effectué et la requête réussit le test à blanc.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Le message d'erreur renvoyé car le paramètre InstanceId.N spécifié n'est pas valide.
403	IncorrectInstanceStatus	%s	Le message d'erreur renvoyé car l'opération n'est pas prise en charge tant que l'instance se trouve dans l'état actuel.
403	InvalidInstance.NotFoundSystemDisk	%s	Le message d'erreur renvoyé car l'instance spécifiée ne possède aucun 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. Vous devez appeler l'opération AttachDisk pour attacher un disque système à l'instance spécifiée.
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 renvoyé car 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.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	Le message d'erreur renvoyé car le prix horaire maximal défini par l'utilisateur pour une instance préemptible est inférieur au prix du marché actuel.
403	InsufficientBalance	Your account does not have enough balance.	Le message d'erreur renvoyé car le solde de votre compte est insuffisant. Approvisionnez votre compte et réessayez.
403	InstanceNotReady	The specified instance is not ready for use.	Le message d'erreur renvoyé car l'opération n'est pas prise en charge tant que la ressource se trouve dans l'état actuel. Réessayez ultérieurement.
404	InvalidInstanceId.NotFound	%s	Le message d'erreur renvoyé car l'instance spécifiée n'existe pas. Vérifiez si l'ID d'instance spécifié est valide.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	Le message d'erreur renvoyé car l'instance spécifiée n'existe pas. Vérifiez si l'ID d'instance spécifié est valide. Vous pouvez appeler l'opération DescribeInstances pour interroger l'état d'instances spécifiques.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Le message d'erreur renvoyé car l'instance spécifiée n'existe pas. Vérifiez si l'ID d'instance spécifié est valide.
500	InternalError	The request processing has failed due to some unknown error.	Le message d'erreur renvoyé car 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.