Todos os produtos
Search
Central de documentação

:StartInstance

Última atualização: Jul 03, 2026

Inicia uma instância do Elastic Compute Service (ECS). Após a chamada da operação, a instância entra no estado Starting.

Observações de uso

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

  • As instâncias ECS a serem iniciadas devem estar no estado Stopped(Stopped).

  • Se OperationLocks na resposta contiver "LockReason" : "security" para uma instância ao consultar suas informações, a instância estará bloqueada por motivos de segurança e não poderá ser iniciada.

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âmetroTipoObrigatórioExemploDescrição
ActionStringSimStartInstance

A operação a ser executada. Defina o valor como StartInstance.

InstanceIdStringSimi-bp67acfmxazb4p****

O ID da instância a ser iniciada.

InitLocalDiskBooleanNãotrue

Especifique se a instância deve ser restaurada ao seu estado inicial de integridade. Este parâmetro aplica-se a instâncias equipadas com discos locais, como d1, i1 e i2. Se um disco local de uma instância d1, i1 ou i2 falhar, use este parâmetro para definir se a instância será restaurada ao estado inicial de integridade durante a inicialização. Valores válidos:

  • true: restaura a instância ao seu estado inicial de integridade na inicialização. Após essa restauração, os dados armazenados nos discos locais da instância serão perdidos.
  • false: não executa nenhuma operação e mantém a instância no estado atual.

Valor padrão: false.

DryRunBooleanNãotrue

Especifique se deve ser executada uma simulação (dry run). Valores válidos:

  • true: realiza apenas a simulação. O sistema verifica seu par de AccessKey, as permissões do usuário RAM e os parâmetros obrigatórios. Se a solicitação falhar na simulação, uma mensagem de erro é retornada. Caso seja aprovada, o código de erro DryRunOperation é retornado.
  • false: executa a simulação e envia a solicitação. Se a solicitação passar na verificação, um código de status HTTP 2XX é retornado e a operação é executada.

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

http(s)://ecs.aliyuncs.com/?Action=StartInstance
&InstanceId=i-bp67acfmxazb4p****
&InitLocalDisk=true
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<StartInstanceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</StartInstanceResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

InvalidParameter.KMSKeyId.NotFound

The specified KMSKeyId does not exist.

Mensagem retornada porque o parâmetro KMSKeyId especificado não existe.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

Indica que 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.

Retornada quando a instância está bloqueada por motivos de segurança.

403

InsufficientBalance

Your account does not have enough balance.

O saldo da sua conta é insuficiente. Adicione fundos à conta e tente novamente.

403

DiskError

IncorrectDiskStatus.

Sinaliza que o estado do disco especificado é inválido.

403

InstanceExpired

The postPaid instance has been expired. Please ensure your account have enough balance.

A instância de pagamento conforme o uso expirou. Quando isso ocorre devido a pagamentos pendentes, a instância entra no estado Expired. Mantenha saldo suficiente em sua conta.

403

InstanceNotReady

The specified instance is not ready for use.

A operação não é suportada no estado atual do recurso. Tente novamente mais tarde.

403

DiskInArrears

The specified operation is denied as your disk has expired.

O disco expirou devido a pagamentos atrasados.

403

OperationDenied.NoStock

The requested resource is sold out in the specified zone; try other types of resources or other regions and zones.

Recursos solicitados indisponíveis na zona especificada. Tente outro tipo de instância ou zona. Chame a operação DescribeZones para consultar recursos disponíveis.

403

OperationDenied.SpotPriceLowerThanPublicPrice

The spot instance price is lower than public price.

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

IncorrectInstanceStatus

%s

A operação não é compatível com o estado atual da instância.

403

InvalidParameter.KMSKeyId.CMKNotEnabled

The CMK needs to be enabled.

A chave mestra do cliente (CMK) não está ativada, embora tenha sido especificado um ID de chave KMS para o disco. Use a operação DescribeKey do KMS para consultar informações sobre a CMK.

403

InvalidParameter.KMSKeyId.KMSUnauthorized

ECS service have no right to access your KMS.

O serviço ECS não tem autorização para acessar seus recursos do KMS.

403

QuotaExceed.ElasticQuota

No additional quota is available for the specified ECS instance type.

O número máximo de instâncias do tipo especificado na região foi atingido. Experimente outra região ou tipo de instância, reduza a quantidade desejada ou solicite aumento de cota no console ECS ou no Quota Center.

403

QuotaExceed.ElasticQuota

The number of the specified ECS instances has exceeded the quota of the specified instance type.

Limite de instâncias do tipo especificado excedido na região. Considere mudar a região, alterar o tipo de instância, diminuir a quantidade ou pedir elevação de cota via console ECS ou Quota Center.

403

QuotaExceed.ElasticQuota

The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.

O total de vCPUs para todos os tipos de instância atingiu o limite na zona. Acesse o console ECS ou o Quota Center para solicitar aumento de cota.

403

QuotaExceed.ElasticQuota

The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.

O limite de instâncias do tipo especificado na região ou o total de vCPUs na zona foi atingido. Solicite aumento de cota no console ECS ou no Quota Center.

403

OperationDenied.HostRepairing

The specified operation is denied as the host of ECS instance is being repaired.

Não é possível executar a operação enquanto a máquina física que hospeda a instância ECS está em reparo.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

O parâmetro InstanceId informado não existe.

500

InternalError

The request processing has failed due to some unknown error.

Ocorreu um erro interno. Tente novamente mais tarde.

500

InternalError

The request processing has failed due to some unknown error, exception or failure.

Falha no processamento devido a erro interno desconhecido. Aguarde e tente novamente.

503

ServiceUnavailable

The request has failed due to a temporary failure of the server.

A solicitação falhou devido a uma indisponibilidade temporária do servidor backend.

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