Deployments: stop

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