StopInstances - Parar instâncias do ECS - : Central de Documentação do Alibaba Cloud

Observações de uso

Se a resposta contiver {"OperationLocks": {"LockReason" : "security"}} ao consultar as informações de uma instância, a instância estará bloqueada por motivos de segurança e todas as operações nela serão proibidas.
Caso o modo econômico esteja ativado para instâncias de pagamento conforme o uso, defina StoppedMode como KeepCharging para habilitar o modo padrão nessas instâncias. Assim, após interromper as instâncias no modo padrão, a cobrança continua, mas os recursos do tipo de instância e os endereços IP públicos são mantidos.
Operações em lote são suportadas. 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	StopInstances	A operação a ser executada. Defina o valor como StopInstances.
DryRun	Boolean	Não	false	Especifica se deve executar uma simulação (dry run). Valores válidos: true: executa 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. Caso a solicitação seja aprovada, o sistema retorna `DRYRUN.SUCCESS`. Nota Se você definir `BatchOptimization` como `SuccessFirst` e `DryRun` como true, apenas `DRYRUN.SUCCESS` será retornado, independentemente de a solicitação passar ou não na simulação. false: executa uma simulação e envia a solicitação. Se a solicitação for aprovada na simulação, a operação é executada. 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.
ForceStop	Boolean	Não	false	Especifica se deve interromper a instância à força. Valores válidos: true: interrompe a instância forçadamente. Esta operação equivale ao desligamento abrupto em cenários comuns. Dados em cache ainda não gravados nos dispositivos de armazenamento da instância serão perdidos. false: interrompe a instância normalmente. Valor padrão: false.
StoppedMode	String	Não	KeepCharging	O modo de interrupção da instância de pagamento conforme o uso. Valores válidos: StopCharging: modo econômico. Para obter informações sobre as condições nas quais `StopCharging` entra em vigor, consulte a seção "Condições para ativar o modo econômico" em Modo econômico. KeepCharging: modo padrão. Após interromper a instância neste modo, a cobrança continua. Valor padrão: Se as condições para ativar o modo econômico forem atendidas 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 é `KeepCharging`.
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 interrompidas. Se uma ou mais instâncias falharem na verificação quando o parâmetro DryRun estiver definido como false, nenhuma das instâncias especificadas poderá ser interrompida e o sistema retornará uma mensagem de erro. SuccessFirst: Neste modo, cada instância é interrompida separadamente. A resposta contém os resultados da operação para cada instância individualmente. 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	1C488B66-B819-4D14-8711-C4EAAA13AC01	O ID da solicitação.
InstanceResponses	Array of InstanceResponse		Detalhes sobre as respostas específicas da instância, que contêm o status de cada instância antes e depois da chamada da operação, além dos resultados da operação.
InstanceResponse
Code	String	200	O código de erro retornado para a instância. O valor de retorno 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 de retorno Success indica êxito na operação. 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	Stopping	O estado atual da instância.
PreviousStatus	String	Running	O estado da instância antes da chamada da operação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=StopInstances
&InstanceId.1=i-bp67acfmxazb4p****
&InstanceId.2=i-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&ForceStop=false
&StoppedMode=KeepCharging
$BatchOptimization=SuccessFirst
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<StopInstancesResponse>
    <RequestId>FF53E96D-3F1A-42F0-8373-1C2B39D72D44</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</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>
</StopInstancesResponse>

Formato JSON

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

{
  "RequestId" : "FF53E96D-3F1A-42F0-8373-1C2B39D72D44",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "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.	Mensagem de erro 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 de erro retornada porque uma simulação foi executada e a solicitação foi aprovada.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	Mensagem de erro retornada porque o parâmetro InstanceId.N especificado é inválido.
403	IncorrectInstanceStatus	%s	Mensagem de erro retornada porque a operação não é suportada enquanto a instância está no estado atual.
403	InsufficientBalance	Your account does not have enough balance.	Mensagem de erro 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 de erro retornada porque a operação não é suportada enquanto o recurso está no estado atual. Tente novamente mais tarde.
404	InvalidInstanceId.NotFound	%s	Mensagem de erro 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 de erro retornada porque o ID da instância especificado 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 de erro 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 de erro 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.