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

Descrição

Somente instâncias no estado Running podem ser reiniciadas.
Após a chamada desta operação, o status da instância muda para Starting.
É possível forçar a reinicialização de uma instância. A reinicialização forçada (ForceStop) equivale a um desligamento abrupto. Essa operação pode causar perda de dados se houver informações não gravadas em disco na instância.
Se você chamar a operação DescribeInstances para consultar os detalhes de uma instância e o campo OperationLocks na resposta contiver "LockReason": "security", a instância estará bloqueada por motivos de segurança e não poderá ser parada. Para mais informações, consulte Comportamento da API quando uma instância é bloqueada por motivos de segurança.

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	RebootInstance	A operação a ser executada. Defina o valor como RebootInstance.
InstanceId	String	Sim	i-bp67acfmxazb4ph****	O ID da instância.
ForceStop	Boolean	Não	false	Especifica se a instância deve ser parada à força para reinicialização. Valores válidos: true: para a instância de maneira forçada. Esta operação equivale a um desligamento abrupto. Dados em cache não gravados em armazenamento persistente serão perdidos. false: para a instância normalmente. Este é o valor padrão.
DryRun	Boolean	Não	false	Indica se deve ser realizada uma simulação (dry run). Valores válidos: true: executa a simulação. O sistema verifica os parâmetros obrigatórios, o formato da solicitação, limites de serviço e recursos ECS disponíveis. Se a solicitação falhar na simulação, uma mensagem de erro será retornada. Caso seja aprovada, o código de erro `DryRunOperation` será retornado. false: execute a simulação e envia a solicitação. Se aprovada na verificação, a instância será reiniciada. Valor padrão: false.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplo de resposta de sucesso

Formato XML

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

<RebootInstanceResponse>
    <RequestId>F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A</RequestId>
</RebootInstanceResponse>

Formato JSON

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

{
  "RequestId" : "F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensagem retornada porque a operação não é compatível com o estado atual da instância.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Mensagem retornada porque a operação não é compatível enquanto a instância está bloqueada por motivos de segurança.
403	DiskError	IncorrectDiskStatus.	Mensagem retornada porque o estado do disco especificado é inválido.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).	Mensagem retornada porque a instância por assinatura expirou. Renove a instância e tente novamente.
403	IncorrectInstanceStatus	%s	Mensagem retornada indicando que a operação não é compatível com o estado atual da instância.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensagem retornada porque a instância especificada não existe. Verifique se o parâmetro InstanceId informado é válido e tente novamente.
500	InternalError	The request processing has failed due to some unknown error.	Mensagem retornada devido à ocorrência de um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Mensagem retornada devido a uma falha ou exceção interna desconhecida durante o processamento. Tente novamente posteriormente.

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