StartInstances - : Central de Documentação do Alibaba Cloud

Observações de uso

Ao chamar esta operação, observe os seguintes pontos:

As instâncias a serem iniciadas devem estar no estado Stopped(Stopped).
Se a resposta contiver {"OperationLocks": {"LockReason" : "security"}} ao consultar informações da instância, a instância estará bloqueada por motivos de segurança e todas as operações nela serão proibidas.
Há suporte a operações em lote. Use o parâmetro BatchOptimization para especificar o modo de operação em lote.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	StartInstances	A operação a ser executada. Defina o valor como StartInstances.
DryRun	Boolean	Não	false	Especifica se deve ser executada uma simulação (dry run). Valores válidos: true: execute uma simulação. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e o status da instância. Se a solicitação falhar na simulação, o sistema retorna uma mensagem de erro. Se a solicitação passar na simulação, o sistema retorna `DRYRUN.SUCCESS`. Nota Se você definir `BatchOptimization` como `SuccessFirst` e `DryRun` como true, o sistema retorna apenas `DRYRUN.SUCCESS`, independentemente de a solicitação passar ou não na simulação. false: execute uma simulação e envie a solicitação. Se a solicitação passar na simulação, o sistema executa a operação. Valor padrão: false.
RegionId	String	Sim	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
BatchOptimization	String	Não	AllTogether	O modo de operação em lote. Valores válidos: AllTogether: neste modo, o sistema retorna uma mensagem de sucesso se todas as instâncias especificadas forem iniciadas. Caso uma ou mais instâncias falhem na verificação quando o parâmetro DryRun estiver definido como false, nenhuma das instâncias especificadas será iniciada e o sistema retornará uma mensagem de erro. SuccessFirst: neste modo, cada instância é iniciada separadamente. A resposta contém os resultados da operação de cada instância. Valor padrão: AllTogether.
InstanceId.N	String	Sim	i-bp67acfmxazb4p****	O ID da instância N. Valores válidos de N: 1 a 100.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	O ID da solicitação.
InstanceResponses	Array of InstanceResponse		Detalhes sobre as respostas específicas de cada instância, incluindo o status antes e depois da chamada da operação e os resultados obtidos.
InstanceResponse
Code	String	200	O código de erro retornado para a instância. O valor 200 indica sucesso. Para mais informações, consulte a seção "Códigos de erro" neste tópico.
Message	String	success	A mensagem de erro retornada para a instância. O valor success indica que a operação foi bem-sucedida. Para mais informações, consulte a seção "Códigos de erro" neste tópico.
InstanceId	String	i-bp67acfmxazb4p****	O ID da instância.
CurrentStatus	String	Starting	O estado atual da instância.
PreviousStatus	String	Stopped	O estado da instância antes da chamada da operação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato 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>

Formato 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"
    } ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Mensagem retornada porque a chave mestra do cliente (CMK) não está ativada quando um ID de chave KMS é especificado para um disco. Chame a operação DescribeKey do KMS para consultar as informações sobre a CMK especificada.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Mensagem retornada porque uma simulação foi executada e a solicitação passou na validação.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Mensagem retornada porque o parâmetro InstanceId.N especificado é inválido.
403	IncorrectInstanceStatus	%s	Mensagem retornada porque a operação não é suportada enquanto a instância está no estado atual.
403	InvalidInstance.NotFoundSystemDisk	%s	Mensagem retornada porque a instância especificada não possui disco de sistema e não pode ser iniciada. Para mais detalhes, consulte o valor do placeholder %s na mensagem de erro. É necessário chamar a operação AttachDisk para anexar um disco de sistema à instância especificada.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.	Mensagem retornada porque os recursos solicitados estão indisponíveis na zona especificada. Tente outro tipo de instância ou outra zona. Chame a operação DescribeZones para consultar os recursos disponíveis.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	Mensagem retornada porque o preço máximo horário definido pelo usuário para uma instância preemptível é inferior ao preço de mercado atual.
403	InsufficientBalance	Your account does not have enough balance.	Mensagem retornada porque o saldo da sua conta é insuficiente. Adicione fundos à sua conta e tente novamente.
403	InstanceNotReady	The specified instance is not ready for use.	Mensagem retornada porque a operação não é suportada enquanto o recurso está no estado atual. Tente novamente mais tarde.
404	InvalidInstanceId.NotFound	%s	Mensagem retornada porque a instância especificada não existe. Verifique se o ID da instância especificado é válido.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	Mensagem retornada porque a instância especificada não existe. Verifique se o ID da instância especificado é válido. Chame a operação DescribeInstances para consultar o status de instâncias específicas.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensagem retornada porque a instância especificada não existe. Verifique se o ID da instância especificado é válido.
500	InternalError	The request processing has failed due to some unknown error.	Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.