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

Detiene una instancia de ECS. Puede elegir diferentes métodos de apagado, modos de detención y modos de operación por lotes para detener la instancia.

Descripción de la operación

Esta operación es asíncrona. La instancia no se detiene inmediatamente. Después de una llamada correcta, la instancia primero entra en el estado Stopping. Puede invocar DescribeInstanceStatus para consultar el estado de la instancia. Cuando el estado devuelto es Stopped, la instancia se detiene correctamente.

Antes de comenzar

Las instancias bloqueadas por motivos de seguridad no se pueden detener mediante esta operación. Para obtener más información, consulte Efectos del bloqueo de seguridad de recursos en las llamadas a la API.
Después de habilitar el modo económico para las instancias en una VPC, puede configurar StoppedMode=KeepCharging en Configuración para habilitar el modo de detención estándar. Después de detener la instancia de ECS, la facturación continúa y se conservan el inventario del tipo de instancia de ECS y la dirección IP de Internet.

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:StopInstance

update

*Instance.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceId	string	Sí	El ID de la instancia.	i-bp67acfmxazb4ph****
ConfirmStop	boolean	No	Este parámetro se está descontinuando y se conserva solo con fines de compatibilidad. Ignore este parámetro al llamar a esta operación.	true
ForceStop	boolean	No	Especifica si se debe detener forzosamente la instancia. Valores válidos: true: detiene forzosamente la instancia. Esto equivale a una operación típica de apagado. Se pierden todos los datos en caché que no se hayan escrito en el dispositivo de almacenamiento. false: detiene la instancia de forma normal. Valor predeterminado: false.	false
StoppedMode	string	No	El modo de detención de una instancia de ECS de pago por uso. Valores válidos: StopCharging: modo económico. Después de habilitar el modo económico: La facturación se suspende para los recursos de cómputo (vCPU, memoria y GPU), las tarifas de licencia de imagen y el modo de pago por ancho de banda para direcciones IP públicas estáticas. La facturación continúa para los discos de sistema, los discos de datos y el modo de pago por ancho de banda para direcciones IP elásticas (EIP). Debido a que se recuperan los recursos de cómputo, la instancia puede fallar al iniciarse por inventario insuficiente. En este caso, inténtelo de nuevo más tarde o cambie el tipo de instancia. Si una EIP está asociada con la instancia antes de detenerla, la dirección IP permanece sin cambios después de reiniciarla. De lo contrario, la dirección IP pública estática puede cambiar, pero la dirección IP privada permanece sin cambios. Para obtener más información, consulte Modo económico. Importante Si la instancia no admite el modo económico, la API no devuelve un error. La instancia se detiene de forma prioritaria. Los tipos de instancia que no admiten el modo económico incluyen instancias con discos locales e instancias de suscripción. KeepCharging: modo de detención estándar. La facturación continúa después de detener la instancia. Valor predeterminado: Si habilita el modo económico para instancias en una VPC en la consola de ECS (para obtener más información, consulte Habilitar el modo económico de forma predeterminada) y se cumplen las condiciones, el valor predeterminado es `StopCharging`. De lo contrario, el valor predeterminado es `KeepCharging`.	KeepCharging
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba (dry run). Valores válidos: true: realiza una ejecución de prueba sin detener la instancia. El sistema comprueba si se especifican los parámetros requeridos, si el formato de la solicitud es válido, si se cumplen los límites del servicio y si el inventario de ECS es suficiente. Si la comprobación falla, se devuelve el error correspondiente. Si la comprobación es correcta, se devuelve el código de error `DryRunOperation`. false: realiza una solicitud normal. Después de que la comprobación es correcta, la instancia se detiene. Valor predeterminado: false.	true
Hibernate	boolean	No	Nota Este parámetro está en vista previa por invitación y no está disponible para su uso.	hide

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	1C488B66-B819-4D14-8711-C4EAAA13AC01

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.Encrypted.KmsNotEnable	The operation failed because KMS is not activated. Please activate KMS in the KMS console and try again.
400	DiskError	IncorrectDiskStatus.	El disco especificado se encuentra en un estado no válido.
500	InternalError	The request processing has failed due to some unknown error.
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.	La instancia a la que está conectado el disco está bloqueada por motivos de seguridad.
403	InstanceType.ParameterMismatch	The input parameter ConfirmStop must be true when an instance have localstorage.	Cuando la instancia utiliza almacenamiento local, el parámetro ConfirmStop debe establecerse en true.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	InvalidInstanceId.NotSupport	Classic network Instance does not support this operation.	Esta operación no es compatible con instancias spot.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK needs to be added ECS tag
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	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.	La operación no está permitida porque la instancia no cumple los requisitos para habilitar la opción de hibernación.
403	HibernationConfigured.NotEnabled	The instance hibernation configured option is not enabled.
403	InvalidOperation.KMSKeyIdNotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
403	InvalidOperation.KMSServiceNotOpen	KMS service is currently not open.	Key Management Service (KMS) no se ha activado.
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	La instancia especificada no existe. Verifique si el ID de la instancia es correcto.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	El servicio no está disponible actualmente. Inténtelo de nuevo más tarde.

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.