Todos los productos
Search
Centro de documentos

:StartInstances

Última actualización: Sep 11, 2026

Inicia una o más instancias de Elastic Compute Service (ECS) que se encuentran en estado Stopped. Después de llamar a esta operación, las instancias pasan al estado Starting.

Notas de uso

Tenga en cuenta los siguientes puntos cuando llame a esta operación:

  • Las instancias que desea iniciar deben encontrarse en el estado Stopped(Stopped).

  • Si la respuesta contiene {"OperationLocks": {"LockReason" : "security"}} al consultar la información de la instancia, significa que está bloqueada por motivos de seguridad y no se permite ninguna operación sobre ella.

  • Se admiten operaciones por lotes. Use el parámetro BatchOptimization para especificar el modo de operación por lotes.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer, ya que genera de forma dinámica el código de ejemplo para distintos SDK.

Parámetros de solicitud

Parámetro Tipo Obligatorio Ejemplo Descripción
Action String Sí StartInstances

Operación que desea ejecutar. Establezca el valor en StartInstances.

DryRun Boolean No false

Indica si se ejecuta una prueba en seco. Valores válidos:

  • true: ejecuta una prueba en seco. El sistema comprueba los parámetros obligatorios, la sintaxis de la solicitud y el estado de la instancia. Si la solicitud no supera la prueba, se devuelve un mensaje de error. Si la supera, se devuelve DRYRUN.SUCCESS.
    Nota Si establece BatchOptimization en SuccessFirst y DryRun en true, solo se devuelve DRYRUN.SUCCESS, sin importar si la solicitud supera o no la prueba en seco.
  • false: ejecuta una prueba en seco y envía la solicitud. Si la solicitud supera la prueba, se ejecuta la operación.

Valor predeterminado: false.

RegionId String Sí cn-hangzhou

ID de la región de la instancia. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.

BatchOptimization String No AllTogether

Modo de operación por lotes. Valores válidos:

  • AllTogether: en este modo se devuelve un mensaje de éxito si todas las instancias especificadas se inician correctamente. Si una o más instancias no superan la comprobación cuando el parámetro DryRun es false, ninguna se inicia y se devuelve un mensaje de error.
  • SuccessFirst: en este modo cada instancia se inicia de manera independiente. La respuesta contiene los resultados de la operación para cada una de ellas.

Valor predeterminado: AllTogether.

InstanceId.N String Sí i-bp67acfmxazb4p****

ID de la instancia N. Los valores válidos de N van de 1 a 100.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID de la solicitud.

InstanceResponses

Array of InstanceResponse

Detalles de las respuestas específicas de cada instancia. Incluyen el estado antes y después de llamar a la operación, así como los resultados obtenidos.

InstanceResponse

Code

String

200

Código de error devuelto para la instancia. El valor 200 indica que la operación fue exitosa. Para obtener más información, consulte la sección "Códigos de error" de este tema.

Message

String

success

Mensaje de error devuelto para la instancia. El valor success indica que la operación fue exitosa. Para obtener más información, consulte la sección "Códigos de error" de este tema.

InstanceId

String

i-bp67acfmxazb4p****

ID de la instancia.

CurrentStatus

String

Starting

Estado actual de la instancia.

PreviousStatus

String

Stopped

Estado de la instancia antes de llamar a la operación.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=StartInstances
&RegionId=cn-hangzhou
&BatchOptimization=AllTogether
&InstanceId=["i-bp67acfmxazb4p****"]
&Common request parameters

Respuestas de ejemplo exitosas

Formato XML

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

<StartInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Stopped</PreviousStatus>
            <CurrentStatus>Starting</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Stopped</PreviousStatus>
            <CurrentStatus>Starting</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>
</StartInstancesResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Stopped",
      "CurrentStatus" : "Starting",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Stopped",
      "CurrentStatus" : "Starting",
      "Code" : "200"
    }, {
      "Message" : "The specified InstanceId does not exist.",
      "InstanceId" : "i-TestID",
      "PreviousStatus" : "",
      "CurrentStatus" : "",
      "Code" : "InvalidInstanceId.NotFound"
    } ]
  }
}

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 enabled.

Mensaje de error devuelto porque la clave maestra del cliente (CMK) no está habilitada cuando se especifica un ID de clave de KMS para un disco. Llame a la operación DescribeKey de KMS para consultar la información de la CMK indicada.

400

DRYRUN.SUCCESS

This request is a dryrun request with successful result.

Mensaje de error devuelto porque se ejecutó una prueba en seco y la solicitud la superó correctamente.

403

Abs.InvalidInstanceIds.MalFormed

The specified instanceIds is not valid.

Mensaje de error devuelto porque el parámetro InstanceId.N especificado no es válido.

403

IncorrectInstanceStatus

%s

Mensaje de error devuelto porque la operación no es compatible con el estado actual de la instancia.

403

InvalidInstance.NotFoundSystemDisk

%s

Mensaje de error devuelto porque la instancia especificada no tiene disco de sistema y no se puede iniciar. Para obtener más información, consulte el valor del marcador de posición %s en el mensaje de error. Debe llamar a la operación AttachDisk para adjuntar un disco de sistema a la instancia indicada.

403

OperationDenied.NoStock

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

Mensaje de error devuelto porque los recursos solicitados no están disponibles en la zona especificada. Pruebe con otro tipo de instancia o con otra zona. Llame a la operación DescribeZones para consultar los recursos disponibles.

403

OperationDenied.SpotPriceLowerThanPublicPrice

The spot instance price is lower than public price.

Mensaje de error devuelto porque el precio máximo por hora definido por el usuario para una preemptible instance es inferior al precio actual del mercado.

403

InsufficientBalance

Your account does not have enough balance.

Mensaje de error devuelto porque el saldo de su cuenta es insuficiente. Agregue fondos a su cuenta e inténtelo de nuevo.

403

InstanceNotReady

The specified instance is not ready for use.

Mensaje de error devuelto porque la operación no es compatible con el estado actual del recurso. Inténtelo de nuevo más tarde.

404

InvalidInstanceId.NotFound

%s

Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el ID de instancia indicado es válido.

404

InvalidInstanceIds.NotFound

The specified InstanceIds does not exist.

Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el ID de instancia indicado es válido. Llame a la operación DescribeInstances para consultar el estado de instancias específicas.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el ID de instancia indicado es válido.

500

InternalError

The request processing has failed due to some unknown error.

Mensaje de error devuelto porque ocurrió un error interno. Inténtelo de nuevo más tarde.

Para ver la lista de códigos de error, consulte Códigos de error del servicio.