StopInstances - - Centro de documentación de Alibaba Cloud

Detiene una o más instancias de Elastic Compute Service (ECS) que se encuentran en estado Running. Después de invocar la operación, el estado de las instancias cambia a Stopping y posteriormente a Stopped.

Notas de uso

Si la respuesta contiene {"OperationLocks": {"LockReason" : "security"}} al consultar la información de una instancia, significa que la instancia está bloqueada por motivos de seguridad y no se permite realizar ninguna operación sobre ella.
Si el modo económico está habilitado para instancias pay-as-you-go, establezca StoppedMode en KeepCharging para activar el modo estándar en dichas instancias. Posteriormente, cuando las instancias se detienen en modo estándar, se siguen generando cargos, pero se conservan los recursos del tipo de instancia y las direcciones IP públicas.
Se admiten operaciones por lotes. Utilice 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, se recomienda invocar esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	StopInstances	La operación que desea ejecutar. Establezca el valor en StopInstances.
DryRun	Boolean	No	false	Especifica si se debe realizar una prueba en seco. Valores válidos: true: realiza 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 solicitud supera la 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 o no la prueba en seco. false: realiza 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	El ID de región de la instancia. Invoque la operación DescribeRegions para consultar la lista de regiones más reciente.
ForceStop	Boolean	No	false	Especifica si se debe detener la instancia de forma forzada. Valores válidos: true: detiene la instancia de forma forzada. Esta operación equivale a apagar la energía en escenarios comunes. Se pierden los datos en caché que no se hayan escrito en los dispositivos de almacenamiento de la instancia. false: detiene la instancia de forma normal. Valor predeterminado: false.
StoppedMode	String	No	KeepCharging	El modo de detención de la instancia pay-as-you-go. Valores válidos: StopCharging: modo económico. Para obtener información sobre las condiciones bajo las cuales `StopCharging` surte efecto, consulte la sección "Condiciones para habilitar el modo económico" en Modo económico. KeepCharging: modo estándar. Cuando la instancia se detiene en modo estándar, se siguen generando cargos. Valor predeterminado: Si se cumplen las condiciones para habilitar el modo económico y usted ha habilitado este modo en la consola de ECS, el valor predeterminado es StopCharging. Para obtener más información, consulte la sección "Habilitar el modo económico" en `Modo económico`. De lo contrario, el valor predeterminado es `KeepCharging`.
BatchOptimization	String	No	AllTogether	El 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 detienen correctamente. Si una o más de las instancias especificadas fallan en la comprobación al establecer el parámetro DryRun en false, ninguna de las instancias se detiene y se devuelve un mensaje de error. SuccessFirst: En este modo, cada instancia se detiene por separado. La respuesta contiene los resultados de la operación para cada instancia. Valor predeterminado: AllTogether.
InstanceId.N	String	Sí	i-bp67acfmxazb4p****	El ID de la instancia N. Valores válidos de N: 1 a 100.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	1C488B66-B819-4D14-8711-C4EAAA13AC01	El ID de la solicitud.
InstanceResponses	Array of InstanceResponse		Detalles sobre las respuestas específicas de cada instancia, que contienen el estado de cada una antes y después de invocar la operación, así como los resultados correspondientes.
InstanceResponse
Code	String	200	El código de error devuelto para la instancia. El valor 200 indica éxito. Para obtener más información, consulte la sección "Códigos de error" en este tema.
Message	String	success	El 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" en este tema.
InstanceId	String	i-bp67acfmxazb4p****	El ID de la instancia.
CurrentStatus	String	Stopping	El estado actual de la instancia.
PreviousStatus	String	Running	El estado de la instancia antes de invocar la operación.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=StopInstances
&InstanceId.1=i-bp67acfmxazb4p****
&InstanceId.2=i-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&ForceStop=false
&StoppedMode=KeepCharging
$BatchOptimization=SuccessFirst
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

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

<StopInstancesResponse>
    <RequestId>FF53E96D-3F1A-42F0-8373-1C2B39D72D44</RequestId>
    <InstanceResponses>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</CurrentStatus>
            <Code>200</Code>
        </InstanceResponse>
        <InstanceResponse>
            <Message>success</Message>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <PreviousStatus>Running</PreviousStatus>
            <CurrentStatus>Stopping</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>
</StopInstancesResponse>

Formato JSON

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

{
  "RequestId" : "FF53E96D-3F1A-42F0-8373-1C2B39D72D44",
  "InstanceResponses" : {
    "InstanceResponse" : [ {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "Code" : "200"
    }, {
      "Message" : "success",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "PreviousStatus" : "Running",
      "CurrentStatus" : "Stopping",
      "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. Invoque la operación DescribeKey de KMS para consultar la información sobre la CMK especificada.
400	DRYRUN.SUCCESS	This request is a dryrun request with successful result.	Mensaje de error devuelto porque se realizó 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	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 más tarde.
404	InvalidInstanceId.NotFound	%s	Mensaje de error devuelto porque la instancia especificada no existe. Compruebe si el ID de instancia especificado es válido.
404	InvalidInstanceIds.NotFound	The specified InstanceIds does not exist.	Mensaje de error devuelto porque el ID de instancia especificado no existe. Compruebe si el ID de instancia especificado es válido. Invoque 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 especificado 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 más tarde.

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