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

Observações de uso

As instâncias ECS a serem reiniciadas devem estar no estado Running(Running).
Há suporte para operações em lote. Use o parâmetro BatchOptimization para especificar o modo de operação em lote.
A reinicialização forçada (ForceReboot) é suportada. Essa ação equivale a desligar e ligar novamente um servidor tradicional, o que pode causar perda de dados ainda não gravados no block storage pelo sistema operacional da instância.
Ao consultar informações de uma instância ECS, todas as operações ficam proibidas se a resposta contiver {"OperationLocks": {"LockReason" : "security"}}.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	RebootInstances	A operação a ser executada. Defina o valor como RebootInstances.
DryRun	Boolean	Não	false	Define se apenas uma simulação será realizada, sem executar a solicitação real. Valores válidos: true: executa apenas a simulação. O sistema verifica possíveis problemas na solicitação, incluindo valores de parâmetros ausentes, sintaxe incorreta e limites de serviço. Se a simulação falhar, uma mensagem de erro será retornada. Caso seja aprovada, `DRYRUN.SUCCESS` será retornado. Nota Se você definir `BatchOptimization` como `SuccessFirst` e `DryRun` como true, apenas `DRYRUN.SUCCESS` será retornado, independentemente do resultado da simulação. false: realiza a simulação e executa a solicitação real. A operação ocorre somente se a simulação for bem-sucedida. Valor padrão: false.
RegionId	String	Sim	cn-hangzhou	ID da região da instância. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
ForceReboot	Boolean	Não	false	Indica se a instância deve ser reiniciada forçadamente. Valores válidos: true: reinicia a instância de forma forçada. Equivalente a desligar o equipamento abruptamente. Dados em cache não persistidos nos dispositivos de armazenamento da instância serão perdidos. false: reinicia a instância normalmente. Valor padrão: false.
BatchOptimization	String	Não	AllTogether	Modo de operação em lote. Valores válidos: AllTogether: Retorna uma mensagem de sucesso apenas se todas as instâncias especificadas forem reiniciadas com êxito. Quando DryRun é false e alguma instância falha na verificação, nenhuma delas é reiniciada e o sistema retorna uma mensagem de erro. SuccessFirst: Processa cada instância individualmente. A resposta inclui os resultados da operação para cada instância separadamente. Valor padrão: AllTogether.
InstanceId.N	String	Sim	i-bp67acfmxazb4p****	ID da instância N.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
InstanceResponses	Array of InstanceResponse		Respostas específicas das instâncias, contendo o status antes e depois da chamada da operação, além dos resultados obtidos.
InstanceResponse
Code	String	200	Código de erro retornado para a instância. O valor 200 indica sucesso na operação. Consulte a seção "Códigos de erro" neste tópico para mais detalhes.
Message	String	success	Mensagem de erro associada à instância. O valor Success confirma que a operação foi concluída com êxito. Veja a seção "Códigos de erro" neste tópico para mais informações.
InstanceId	String	i-bp1g6zv0ce8oghu7****	ID da instância.
CurrentStatus	String	Stopping	Status atual da instância.
PreviousStatus	String	Running	Status da instância antes da execução da operação.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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

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

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.	A chave mestra do cliente (CMK) não está ativada, embora seu ID tenha sido especificado para um disco. Chame a operação DescribeKey do KMS para consultar informações sobre a CMK indicada.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Simulação executada e aprovada com sucesso.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Valor inválido para InstanceId.N.
403	IncorrectInstanceStatus	%s	Não é possível executar a operação no estado atual da instância.
403	InvalidInstance.NotFoundSystemDisk	%s	A instância especificada não possui disco de sistema e não pode ser iniciada. Consulte o valor do placeholder %s na mensagem de erro para mais detalhes. Utilize a operação AttachDisk para vincular um disco de sistema à instância.
403	InsufficientBalance	Your account does not have enough balance.	Saldo insuficiente na conta. Adicione fundos e tente novamente.
403	InstanceNotReady	The specified instance is not ready for use.	O recurso não está pronto para uso no estado atual. Tente novamente mais tarde.
404	InvalidInstanceId.NotFound	%s	Instância especificada não encontrada. Verifique se o ID informado é válido.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	Instância especificada não localizada. Confirme se o ID está correto. Use a operação DescribeInstances para verificar o status de instâncias específicas.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Instância não encontrada. Valide se o ID da instância está correto.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente posteriormente.

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