Todos los productos
Search
Centro de documentos

:StartInstance

Última actualización: Sep 02, 2026

Inicia una instancia de Elastic Compute Service (ECS). Tras llamar a esta operación, la instancia entra en estado Starting.

Notas de uso

Al llamar a esta operación, considere lo siguiente:

  • Las instancias de ECS que desea iniciar deben estar en el estado Stopped(Stopped).

  • Si OperationLocks en la respuesta contiene "LockReason" : "security" para una instancia al consultar su información, dicha instancia está bloqueada por motivos de seguridad y no se puede iniciar.

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. Esta herramienta genera dinámicamente el código de ejemplo de la operación para distintos SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíStartInstance

La operación que desea ejecutar. Establezca el valor en StartInstance.

InstanceIdStringSíi-bp67acfmxazb4p****

El ID de la instancia que desea iniciar.

InitLocalDiskBooleanNotrue

Indica si se restaura la instancia a su estado inicial saludable. Este parámetro aplica a instancias con discos locales, como las d1, i1 e i2. Si un disco local de una instancia d1, i1 o i2 presenta errores, use este parámetro para especificar si se restaura la instancia a su estado inicial saludable durante el inicio. Valores válidos:

  • true: restaura la instancia a su estado inicial saludable durante el inicio. Tras esta restauración, se pierden los datos almacenados en los discos locales de la instancia.
  • false: no ejecuta ninguna operación y mantiene la instancia en su estado actual.

Valor predeterminado: false.

DryRunBooleanNotrue

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

  • true: ejecuta una prueba en seco. El sistema comprueba su par de AccessKey, los permisos del usuario de RAM y los parámetros obligatorios. Si la solicitud no supera la prueba, se devuelve un mensaje de error. Si la solicitud supera la prueba, se devuelve el código de error DryRunOperation.
  • false: ejecuta una prueba en seco y envía la solicitud. Si la solicitud supera la prueba, se devuelve un código de estado HTTP 2XX y se ejecuta la operación.

Valor predeterminado: false.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

403

InvalidParameter.KMSKeyId.NotFound

The specified KMSKeyId does not exist.

Mensaje de error devuelto porque el parámetro KMSKeyId especificado no existe.

403

IncorrectInstanceStatus

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

Mensaje de error devuelto porque la operación no es compatible mientras el recurso se encuentra en su estado actual.

403

InstanceLockedForSecurity

The specified operation is denied as your instance is locked for security reasons.

Mensaje de error devuelto porque la instancia está bloqueada por motivos de seguridad.

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

DiskError

IncorrectDiskStatus.

Mensaje de error devuelto porque el estado del disco especificado no es válido.

403

InstanceExpired

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

Mensaje de error devuelto porque la instancia pay-as-you-go ha caducado. Cuando una instancia pay-as-you-go se detiene por pago pendiente, entra en estado Expired. Mantenga un saldo suficiente en su cuenta.

403

InstanceNotReady

The specified instance is not ready for use.

Mensaje de error devuelto porque la operación no es compatible mientras el recurso se encuentra en su estado actual. Inténtelo más tarde.

403

DiskInArrears

The specified operation is denied as your disk has expired.

Mensaje de error devuelto porque el disco ha caducado debido a pagos pendientes.

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 u otra zona. Puede llamar a la operación DescribeZones para consultar los recursos disponibles en las zonas.

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 de mercado actual.

403

IncorrectInstanceStatus

%s

Mensaje de error devuelto porque la operación no es compatible mientras la instancia se encuentra en su estado actual.

403

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. Puede llamar a la operación DescribeKey de KMS para consultar la información sobre la CMK especificada.

403

InvalidParameter.KMSKeyId.KMSUnauthorized

ECS service have no right to access your KMS.

Mensaje de error devuelto porque ECS no tiene autorización para acceder a sus recursos de KMS.

403

QuotaExceed.ElasticQuota

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

Mensaje de error devuelto porque se alcanzó el número máximo de instancias del tipo especificado en la región. Pruebe con otra región o tipo de instancia, o reduzca la cantidad de instancias que desea adquirir. También puede ir a la consola de ECS o a Quota Center para solicitar un aumento de cuota.

403

QuotaExceed.ElasticQuota

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

Mensaje de error devuelto porque se alcanzó el número máximo de instancias del tipo especificado en la región. Pruebe con otra región o tipo de instancia, o reduzca la cantidad de instancias que desea adquirir. También puede ir a la consola de ECS o a Quota Center para solicitar un aumento de cuota.

403

QuotaExceed.ElasticQuota

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

Mensaje de error devuelto porque se alcanzó el número máximo de vCPU para todos los tipos de instancia en la zona. Vaya a la consola de ECS o a Quota Center para solicitar un aumento de cuota.

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.

Mensaje de error devuelto porque se alcanzó el número máximo de instancias del tipo especificado en la región o el número máximo de vCPU para todos los tipos de instancia. Vaya a la consola de ECS o a Quota Center para solicitar un aumento de cuota.

403

OperationDenied.HostRepairing

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

Mensaje de error devuelto porque la operación no es compatible mientras se repara el host de la instancia de ECS.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

Mensaje de error devuelto porque el parámetro InstanceId especificado no existe.

500

InternalError

The request processing has failed due to some unknown error.

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

500

InternalError

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

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

503

ServiceUnavailable

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

Mensaje de error devuelto porque la solicitud falló debido a un error temporal del servidor backend.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.