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

Descrição

Se você chamar a operação DescribeInstances para consultar os detalhes de uma instância e OperationLocks na resposta contiver "LockReason": "security", a instância estará bloqueada por motivos de segurança e não poderá ser interrompida. Para mais informações, consulte Comportamento da API quando uma instância é bloqueada por motivos de segurança.
Caso o modo econômico esteja ativado, defina StoppedMode como KeepCharging para ative o modo padrão. Assim, após a interrupção da instância no modo padrão, a cobrança continua, mas o tipo de instância e o endereço IP público são mantidos.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta 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	StopInstance	A operação a ser executada. Defina o valor como StopInstance.
InstanceId	String	Sim	i-bp67acfmxazb4ph****	O ID da instância.
ConfirmStop	Boolean	Não	true	Este parâmetro será removido futuramente e permanece apenas para garantir compatibilidade. Recomendamos ignorá-lo.
ForceStop	Boolean	Não	false	Defina se a instância deve ser forçada a parar. Valores válidos: true: força a interrupção da instância. false: interrompe a instância normalmente. Valor padrão: false.
StoppedMode	String	Não	KeepCharging	O modo de interrupção da instância com pagamento conforme o uso. Valores válidos: StopCharging: modo econômico. Para saber como `StopCharging` entra em vigor, consulte a seção "Pré-requisitos" em Modo econômico. KeepCharging: modo padrão. A cobrança pela instância continua mesmo após ela ser interrompida neste modo. Valor padrão: Se os pré-requisitos para ativar o modo econômico forem atendidos e você tiver ativado esse modo no console ECS, o valor padrão será StopCharging. Para mais detalhes, veja a seção "Ativar modo econômico" em `Modo econômico`. Caso contrário, o valor padrão será `KeepCharging`.
DryRun	Boolean	Não	true	Indica se a validade da solicitação deve ser verificada sem executá-la de fato. Valor padrão: false. Valores válidos: true: A validade da solicitação é verificada, mas a requisição não é enviada. Os itens verificados incluem parâmetros obrigatórios, limites de serviço, recursos ECS disponíveis e formato da solicitação. Se a verificação falhar, o código de erro correspondente é retornado. Em caso de sucesso, o código de erro `DryRunOperation` é retornado. false: A validade da solicitação é verificada e, se aprovada, a requisição é executada. Valor padrão: false.
Hibernate	Boolean	Não	hide	Nota Atualmente, este parâmetro está em visualização por convite e indisponível para usuários gerais.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	1C488B66-B819-4D14-8711-C4EAAA13AC01	O ID da solicitação.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

<StopInstanceResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>

Formato JSON

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

{
  "RequestId" : "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Códigos de erro

Código de status HTTP	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 é suportada enquanto o recurso estiver no estado atual.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Mensagem retornada porque a operação não é suportada enquanto a instância estiver bloqueada por motivos de segurança.
403	DiskError	IncorrectDiskStatus	Mensagem retornada porque o estado do disco especificado é inválido.
403	InstanceType.ParameterMismatch	The input parameter ConfirmStop must be true when an instance have localstorage.	Mensagem retornada porque o parâmetro ConfirmStop foi definido como false para uma instância que utiliza armazenamento local.
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	InvalidInstanceId.NotSupport	Classic network Instance does not support this operation.	Mensagem retornada porque a operação não é suportada pela instância localizada na rede clássica.
403	InvalidInstanceId.NotSupport	Pre pay instance does not support this operation.	Mensagem retornada porque a operação não é suportada pela instância por assinatura.
403	InvalidInstanceId.NotSupport	Local disk instance does not support this operation.	Mensagem retornada porque a operação não é suportada pela instância que utiliza discos locais.
403	InvalidInstanceId.NotSupport	Spot instance does not support this operation.	Mensagem retornada porque a operação não é suportada pela instância preemptível.
403	IncorrectInstanceStatus	%s	Mensagem retornada porque a operação não é suportada enquanto a instância estiver no estado atual.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.	Mensagem retornada porque a chave mestra do cliente (CMK) especificada pelo parâmetro KMSKeyId não está ativada. Chame a operação DescribeKey do KMS para consultar informações sobre a CMK especificada.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Mensagem retornada porque o ECS não tem autorização para acessar seus recursos do KMS.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensagem retornada porque o parâmetro InstanceId especificado é inválido.
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 à ocorrência de um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, visite o Centro de Erros da API.