Deployments

Precaución: Esta es una versión obsoleta de la API de Deployment Manager. En su lugar, usa la versión más reciente de la API.

Una implementación es una colección de recursos que se implementan y administran juntos mediante el uso de un archivo de configuración.

Para obtener una lista de los métodos de este recurso, consulta el final de esta página.

Representaciones de recursos

{
  "id": unsigned long,
  "insertTime": string,
  "updateTime": string,
  "name": string,
  "description": string,
  "fingerprint": bytes,
  "manifest": string,
  "update": {
    "errors": [
      string
    ],
    "manifest": string
  },
  "target": {
    "config": string,
    "imports": [
      {
        "name": string,
        "content": string
      }
    ]
  },
  "state": string,
  "intent": string
}

Nombre de la propiedad	Valor	Descripción	Notas
description	string	Es una descripción opcional de la implementación que proporciona el usuario.
fingerprint	bytes	Especifica una huella digital para las solicitudes de update(). Una huella digital es un valor generado de forma aleatoria que se debe proporcionar en las solicitudes de update() para realizar un bloqueo optimista. Esto garantiza la simultaneidad optimista para que solo se pueda realizar una actualización a la vez. El Administrador de implementaciones genera la huella digital inicialmente y cambia después de cada solicitud para modificar los datos. Para obtener el valor de huella digital más reciente, realiza una solicitud get() a una implementación.
id	unsigned long	[Solo salida] Es el identificador único del recurso que define el servidor.
insertTime	string	[Solo salida] Marca de tiempo en la que se creó la implementación, en formato de texto RFC3339 .
intent	string	[Solo entrada] Especifica cómo Deployment Manager debe aplicar esta plantilla. Las opciones posibles son PREVIEW, UPDATE y CANCEL. PREVIEW crea una implementación y recursos “shell”, pero no crea instancias de estos recursos. Esto te permite obtener una vista previa de cómo se verá tu implementación. Puedes usar este intent para obtener una vista previa de las actualizaciones de las implementaciones o de las implementaciones nuevas. Debes proporcionar un target.config con una configuración para este intent. Después de obtener una vista previa de una implementación, puedes implementar tus recursos realizando una solicitud con el intent UPDATE o puedes CANCEL la vista previa por completo. Ten en cuenta que la implementación seguirá existiendo después de que canceles la vista previa y deberás borrarla por separado si quieres quitarla. UPDATE realiza una actualización de los recursos subyacentes en una implementación. Si proporcionas un campo target.config propagado con esta solicitud, Deployment Manager usará esa configuración para realizar una actualización. Si ya habías visto una vista previa de esta actualización y no proporcionas un target.config o proporcionas un target.config vacío, Deployment Manager usará la última configuración de la que se realizó una vista previa. CANCEL cancela una actualización que se encuentra en PREVIEW o UPDATE, pero no deshace los cambios que ya se hayan realizado.
manifest	string	[Solo salida] Es la URL del manifiesto que representa el último manifiesto que se implementó correctamente.
name	string	Es el nombre del recurso que proporciona el cliente cuando lo crea. El nombre debe tener entre 1 y 63 caracteres y cumplir con RFC1035. Específicamente, el nombre debe tener entre 1 y 63 caracteres y coincidir con la expresión regular [a-z]([-a-z0-9]*[a-z0-9])?, lo que significa que el primer carácter debe ser una letra minúscula y los siguientes deben ser un guion, una letra minúscula o un dígito, excepto el último carácter, que no puede ser un guion.
state	string	[Solo salida] Es el estado actual de la implementación. Puede ser DEPLOYED, DEPLOYMENT_FAILED, PREVIEWING, UPDATING y CANCELING.
target	nested object	[Solo entrada] Son los parámetros que definen tu implementación, incluida la configuración de la implementación y las plantillas relevantes.
target.config	string	Es la configuración que se usará para esta implementación.
target.imports[]	list	Especifica los archivos que se importarán para esta configuración. Se puede usar para importar plantillas o cualquier otro archivo. Por ejemplo, puedes importar un archivo de texto para usarlo en una plantilla.
target.imports[].content	string	El contenido del archivo.
target.imports[].name	string	Es el nombre del archivo.
update	nested object	[Solo salida] Si Deployment Manager está actualizando o mostrando una vista previa de una actualización de esta implementación, la configuración actualizada aparecerá aquí.
update.errors[]	list	[Solo salida] Es la lista de todos los errores que se encontraron cuando se intentó aplicar la actualización.
update.manifest	string	[Solo salida] URL del manifiesto que representa la configuración de actualización de esta implementación.
updateTime	string	[Solo salida] Marca de tiempo de la actualización de la implementación, en formato de texto RFC3339 .

Métodos

borrar

Borra una implementación y todos los recursos que contiene.

get

Obtiene información sobre una implementación específica.

insertar

Crea una implementación y todos los recursos que describe el manifiesto de implementación.

lista

Enumera todas las implementaciones de un proyecto determinado.

patch

Actualiza una implementación y todos los recursos que describe el manifiesto de implementación. Este método es compatible con la semántica de parches.

actualización

Actualiza una implementación y todos los recursos que describe el manifiesto de implementación.