StartInstance - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Inicia uma instância ECS. Você pode iniciar uma instância especificando o ID da instância e, opcionalmente, definindo parâmetros como InitLocalDisk.

Descrição da operação

Esta é uma operação assíncrona. A instância não é iniciada imediatamente após uma chamada bem-sucedida. A instância primeiro entra no estado Starting. Chame DescribeInstanceStatus para consultar o status da instância. Quando o status retornado for Running, a instância foi iniciada.

Antes de começar

Instâncias bloqueadas por motivos de segurança não podem ser iniciadas ao chamar esta operação. Para mais informações, consulte site da China (Impactos dos bloqueios de segurança de recursos nas chamadas de API).
A instância ECS deve estar no estado Stopped (Stopped).
Instâncias no modo econômico podem falhar ao iniciar devido a recursos insuficientes.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:StartInstance

update

*Instância.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância que você deseja iniciar.	i-bp67acfmxazb4p****
InitLocalDisk	boolean	Não	Especifica se a instância deve ser recuperada para seu estado de integridade inicial quando um disco local falhar. Este parâmetro é aplicável a instâncias que usam discos locais, como instâncias nas famílias de instâncias d1, i1 ou i2. Valores válidos: true: Recupera a instância para seu estado de integridade inicial. Aviso Todos os dados armazenados nos discos locais da instância são perdidos. false: Não realiza nenhuma ação e mantém o estado atual. Valor padrão: false.	true
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run, sem executar a solicitação real. Valores válidos: true: realiza apenas um dry run. A instância não é iniciada. O sistema verifica se os parâmetros da solicitação são válidos, se o usuário do Resource Access Management (RAM) tem a autorização necessária e se os parâmetros obrigatórios foram especificados. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro DryRunOperation será retornado. false: envia uma solicitação normal. Se a verificação for bem-sucedida, um código de status HTTP 2XX será retornado e a instância será iniciada. Valor padrão: false.	true

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	LackResource	There's no enough resource on the specified capacity reservation.
400	InvalidDedicatedHost.NotEnoughResource	The specified dedicated host has not enough resource due to host affinity.
400	InvalidInstance.NotFoundSystemDisk	The specified instance does not have system disk.
400	Invalid.PrivatePoolOptions.NoStock	The PrivatePool has been used up.	A capacidade do pool privado especificado (garantia de elasticidade ou reserva de recursos) foi totalmente utilizada.
500	InstanceNotReady	The specified instance is not ready for use.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	A instância à qual o disco está anexado está bloqueada por motivos de segurança.
403	InsufficientBalance	Your account does not have enough balance.
403	DiskError	IncorrectDiskStatus.
403	InstanceExpired	The postPaid instance has been expired.Please ensure your account have enough balance.	A instância de assinatura expirou. Renove a instância antes de realizar esta operação.
403	InstanceNotReady	The specified instance is not ready for use.
403	DiskInArrears	The specified operation is denied as your disk has expired.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	O preço do lance para uma instância spot não pode ser inferior ao preço publicado.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK needs to be added ECS tag.	A tag ECS deve ser adicionada à chave mestra do cliente (CMK).
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	O número de instâncias a serem criadas com o tipo de instância selecionado na região atual excede a cota, ou a cota total de vCPU para todos os tipos de instância foi excedida. Você pode acessar o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	OperationDenied.HostRepairing	The specified operation is denied as the host of ECS instance is being repaired.	A máquina física que hospeda a instância ECS está em manutenção. A operação especificada não é permitida.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	A categoria de disco especificada não existe na zona ou no cluster especificado, ou a zona especificada não corresponde ao cluster.
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.
404	InvalidCapacityReservationId.NotFound	The specified capacity reservation does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	A solicitação de backend expirou. Tente novamente mais tarde.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	O serviço está indisponível no momento. Tente novamente mais tarde.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.