StartInstances - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Inicia instancias de Elastic Compute Service (ECS) que se encuentran en estado Stopped.

Descripción de la operación

Esta operación es asíncrona. Después de llamar a esta operación para iniciar instancias de ECS, la operación establece el estado de las instancias de ECS en Starting y comienza el proceso de inicio. Puede llamar a la operación DescribeInstanceStatus para consultar el estado de las instancias. Cuando el estado de las instancias de ECS cambia a Running, las instancias se han iniciado.

Precauciones

No puede llamar a esta operación para iniciar instancias de ECS que están bloqueadas por motivos de seguridad. Para obtener más información, consulte Comportamiento de la API cuando una instancia está bloqueada por motivos de seguridad.
Las instancias de ECS que desea iniciar deben estar en el estado Stopped (Stopped).
Es posible que las instancias de ECS detenidas en modo económico no se puedan iniciar debido a recursos insuficientes.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ecs:StartInstances

update

*Instance

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba (dry run). Valores válidos: true: realiza solo una ejecución de prueba. El sistema comprueba la solicitud en busca de posibles problemas, incluidos los parámetros obligatorios, la sintaxis de la solicitud y el estado de la instancia. Si la solicitud no supera la ejecución de prueba, se devuelve un mensaje de error. Si la solicitud supera la ejecución de prueba, se devuelve `DRYRUN.SUCCESS`. Nota Si establece `BatchOptimization` en `SuccessFirst` y `DryRun` en true, solo se devuelve `DRYRUN.SUCCESS` independientemente de si la solicitud supera la ejecución de prueba. false: realiza una ejecución de prueba y ejecuta la solicitud real. Si la solicitud supera la ejecución de prueba, se realiza la operación. Valor predeterminado: false.	false
RegionId	string	Sí	El ID de región de la instancia de ECS. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
BatchOptimization	string	No	El modo de operación por lotes. Valores válidos: AllTogether: inicia todas las instancias de ECS al mismo tiempo. Si todas las instancias de ECS se inician correctamente, se devuelve un mensaje de éxito. Si una instancia de ECS no se puede iniciar, ninguna de las instancias especificadas se inicia y se devuelve un mensaje de error. SuccessFirst: inicia cada instancia de ECS por separado. La respuesta contiene los resultados de la operación de cada instancia de ECS. Valor predeterminado: AllTogether.	AllTogether
InstanceId	array	Sí	Los ID de las instancias de ECS. Valores válidos de N: 1 a 100.	i-bp67acfmxazb4p****
	string	No	El ID de la instancia de ECS N.	i-bp67acfmxazb4p****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
InstanceResponses	object
InstanceResponse	array<object>	La información sobre la instancia de ECS, como el estado de cada instancia antes y después de llamar a la operación, y los resultados de la operación.
	object
Code	string	El código de error que se devuelve para la operación en la instancia de ECS. El valor 200 indica que la operación se realizó correctamente. Para obtener más información, consulte la sección "Códigos de error" en este tema.	200
Message	string	El mensaje de error que se devuelve para la operación en la instancia de ECS. El valor success indica que la operación se realizó correctamente. Para obtener más información, consulte la sección "Códigos de error" en este tema.	success
InstanceId	string	El ID de la instancia de ECS.	i-bp67acfmxazb4p****
CurrentStatus	string	El estado de la instancia de ECS después de llamar a la operación.	Starting
PreviousStatus	string	El estado de la instancia de ECS antes de llamar a la operación.	Stopped

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceResponses": {
    "InstanceResponse": [
      {
        "Code": "200",
        "Message": "success",
        "InstanceId": "i-bp67acfmxazb4p****",
        "CurrentStatus": "Starting",
        "PreviousStatus": "Stopped"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be added ECS tag
400	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service account have no right to access your KMS.	The ECS service does not have permission to access your KMS.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	The request is checked and determined as valid.
400	Invalid.PrivatePoolOptions.NoStock	The PrivatePool has been used up.	The capacity of the specified private pool (elastic assurance, capacity reservation) has been used up.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidInstanceId.NotFound	InstanceId should not be null.
403	InvalidParameter.TooManyInstanceIds	Instance ids cannot be more than 100.	InstanceIds cannot be more than 100.
403	Abs.InvalidInstanceIds.MalFormed	The specified instanceIds is not valid.	The specified instance ID is invalid.
403	InstanceExpired	%s	The instance is out of date and the operation cannot be performed.
403	InstanceLockedForSecurity	%s
403	InstanceExpiredOrInArrears	%s
403	IncorrectInstanceStatus	%s	The instance is in a state that does not support the current operation.
403	InvalidInstance.NotFoundSystemDisk	%s	The system disk of the instance is missing.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	Your user-defined maximum hourly price of a spot instance is lower than the current market price.
403	InsufficientBalance	Your account does not have enough balance.
403	InstanceNotReady	The specified instance is not ready for use.
403	OperationDenied.HostRepairing	%s
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	The requested resources are sold out in the specified zone. Try another instance type or zone.
404	InvalidInstanceId.NotFound	%s
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	The specified InstanceId parameter does not exist. You can call the DescribeInstances operation to query the state of the instance.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	The service is currently unavailable. Please try again later.
409	InvalidOperation.Conflict	Request was denied due to conflict with a previous request, please try again later.	A conflicting task exists in the port list.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.