Detiene una operación en curso. Esto no revierte el trabajo que ya se completó, pero evita que se inicie cualquier trabajo nuevo. Pruébalo ahora.
Solicitud
Solicitud HTTP
POST https://www.googleapis.com/deploymentmanager/v2beta/projects/project/global/deployments/deployment/stop
Parámetros
Nombre del parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta de acceso | ||
deployment |
string |
Es el nombre de la implementación para esta solicitud. |
project |
string |
: Es el ID del proyecto de esta solicitud. |
Autorización
Esta solicitud requiere autorización con al menos uno de los siguientes permisos:
Alcance |
---|
https://www.googleapis.com/auth/cloud-platform |
https://www.googleapis.com/auth/ndev.cloudman |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona los datos con la siguiente estructura:
{ "fingerprint": bytes }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
fingerprint |
bytes |
Especifica una huella digital para las solicitudes de "stop()</". Una huella digital es un valor generado de forma aleatoria que se debe proporcionar en las solicitudes de "stop()`" para realizar un bloqueo optimista. Esto garantiza la simultaneidad optimista para que la implementación no tenga solicitudes en conflicto (p.ej., si alguien intenta realizar una nueva solicitud de actualización mientras otro usuario intenta detener una solicitud de actualización en curso, esto evitaría una colisión). Deployment Manager genera la huella digital inicialmente y cambia después de cada solicitud para modificar una implementación. Para obtener el valor de la huella digital más reciente, realiza una solicitud "get()" en la implementación. |
Respuesta
Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:
{ "kind": "deploymentmanager#operation", "id": unsigned long, "creationTimestamp": string, "name": string, "zone": string, "clientOperationId": string, "operationType": string, "targetLink": string, "targetId": unsigned long, "status": string, "statusMessage": string, "user": string, "progress": integer, "insertTime": string, "startTime": string, "endTime": string, "error": { "errors": [ { "code": string, "location": string, "message": string } ] }, "warnings": [ { "code": string, "message": string, "data": [ { "key": string, "value": string } ] } ], "httpErrorStatusCode": integer, "httpErrorMessage": string, "selfLink": string, "region": string, "description": string }
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
kind |
string |
[Solo salida] Tipo de recurso. Siempre "compute#operation" para los recursos de operación. | |
id |
unsigned long |
[Solo salida] Es el identificador único de la operación. El servidor define este identificador. | |
creationTimestamp |
string |
[Obsoleto] Este campo dejó de estar disponible. | |
name |
string |
[Solo salida] Nombre de la operación. | |
zone |
string |
[Solo salida] La URL de la zona en la que reside la operación. Solo se aplica cuando se realizan operaciones por zona. | |
clientOperationId |
string |
[Solo salida] Es el valor de "requestId" si lo proporcionaste en la solicitud. De lo contrario, no está presente. | |
operationType |
string |
[Solo salida] Es el tipo de operación, como "insert", "update" o "delete", etcétera. | |
targetLink |
string |
[Solo salida] Es la URL del recurso que modifica la operación. En el caso de las operaciones relacionadas con la creación de una instantánea, este campo apunta al disco persistente desde el que se creó la instantánea. | |
targetId |
unsigned long |
[Solo salida] El ID de destino único, que identifica una encarnación específica del recurso de destino. | |
status |
string |
[Solo salida] Es el estado de la operación, que puede ser uno de los siguientes: "PENDING", "RUNNING" o "DONE". | |
statusMessage |
string |
[Solo salida] Es una descripción textual opcional del estado actual de la operación. | |
user |
string |
[Solo salida] Es el usuario que solicitó la operación, por ejemplo, "user@example.com". | |
progress |
integer |
[Solo salida] Es un indicador de progreso opcional que varía de 0 a 100. No es necesario que sea lineal ni que admita ningún nivel de detalle de las operaciones. No se debe usar para adivinar cuándo se completará la operación. Esta cantidad debe aumentar de forma monótona a medida que avanza la operación. | |
insertTime |
string |
[Solo salida] La hora en que se solicitó esta operación. Este valor está en formato de texto RFC3339. | |
startTime |
string |
[Solo salida] Es la hora en que el servidor inició esta operación. Este valor está en formato de texto RFC3339. | |
endTime |
string |
[Solo salida] La hora en que se completó esta operación. Este valor está en formato de texto RFC3339. | |
error |
object |
[Solo salida] Si se generan errores durante el procesamiento de la operación, se completará este campo. | |
error.errors[] |
list |
[Solo salida] Es el array de errores que se encontraron durante el procesamiento de esta operación. | |
error.errors[].code |
string |
[Solo salida] Es el identificador de tipo de error de este error. | |
error.errors[].location |
string |
[Solo salida] Indica el campo de la solicitud que causó el error. Esta propiedad es opcional. | |
error.errors[].message |
string |
[Solo salida] Es un mensaje de error opcional legible por humanos. | |
warnings[] |
list |
[Solo salida] Si se generan mensajes de advertencia durante el procesamiento de la operación, se completará este campo. | |
warnings[].code |
string |
[Solo salida] Un código de advertencia, si corresponde. Por ejemplo, Compute Engine muestra NO_RESULTS_ON_PAGE si no hay resultados en la respuesta. |
|
warnings[].message |
string |
[Solo salida] Es una descripción legible por humanos del código de advertencia. | |
warnings[].data[] |
list |
[Solo salida] Metadatos sobre esta advertencia en formato key: value . Por ejemplo: "data": [ { "key": "scope", "value": "zones/us-east1-d" } |
|
warnings[].data[].key |
string |
[Solo salida] Es una clave que proporciona más detalles sobre la advertencia que se muestra. Por ejemplo, en el caso de las advertencias en las que no hay resultados en una solicitud de lista para una zona en particular, esta clave podría ser scope y el valor de la clave podría ser el nombre de la zona. Otros ejemplos pueden ser una clave que indica un recurso obsoleto y un reemplazo sugerido, o una advertencia sobre una configuración de red no válida (por ejemplo, si una instancia intenta realizar el reenvío de IP, pero no está habilitado para ello). |
|
warnings[].data[].value |
string |
[Solo salida] Un valor de datos de advertencia que corresponde a la clave. | |
httpErrorStatusCode |
integer |
[Solo salida] Si la operación falla, este campo contiene el código de estado de error HTTP que se muestra. Por ejemplo, un "404" significa que no se encontró el recurso. | |
httpErrorMessage |
string |
[Solo salida] Si la operación falla, este campo contiene el mensaje de error HTTP que se muestra, como “NO ENCONTRADO”. | |
selfLink |
string |
[Solo salida] URL definida por el servidor para el recurso. | |
region |
string |
[Solo salida] La URL de la región en la que reside la operación. Solo se aplica cuando se realizan operaciones regionales. | |
description |
string |
[Solo salida] Es una descripción textual de la operación, que se establece cuando se crea. |
Pruébala
Usa el Explorador de APIs que aparece a continuación para llamar a este método en datos en vivo y ver la respuesta.