REST Resource: projects.locations.releases

Recurso: Release

Es una versión nueva que se propagará y se implementará en las unidades. Esto incluye punteros a los planos empaquetados para la activación (p. ej., paquetes de configuración de Helm o Terraform) a través del registro de artefactos.

Representación JSON 
{
  "name": string,
  "unitKind": string,
  "blueprint": {
    object (Blueprint)
  },
  "releaseRequirements": {
    object (ReleaseRequirements)
  },
  "inputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "outputVariables": [
    {
      object (UnitVariable)
    }
  ],
  "inputVariableDefaults": [
    {
      object (UnitVariable)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Campos
name

string

Es el identificador. Nombre del recurso (URI completo del recurso) según el esquema de nombres estándar:

"projects/{project}/locations/{location}/releases/{release}"
unitKind

string

Obligatorio. Inmutable. Es la referencia al UnitKind al que corresponde esta versión (obligatorio e inmutable una vez creado).
blueprint

object (Blueprint)

Es opcional. Los esquemas son imágenes de OCI que contienen todos los artefactos necesarios para aprovisionar una unidad.
releaseRequirements

object (ReleaseRequirements)

Es opcional. Es el conjunto de requisitos que se deben cumplir en la unidad cuando se usa esta versión.
inputVariables[]

object (UnitVariable)

Es opcional. Solo salida. Lista de variables de entrada declaradas en el diseño y que pueden estar presentes con sus valores en la especificación de la unidad
outputVariables[]

object (UnitVariable)

Es opcional. Solo salida. Lista de variables de salida declaradas en el plano y que pueden estar presentes con sus valores en el estado de la unidad
inputVariableDefaults[]

object (UnitVariable)

Es opcional. Es la asignación de variables de entrada a valores predeterminados. Máximo 100
labels

map (key: string, value: string)

Es opcional. Son las etiquetas del recurso, que se pueden usar para la categorización, de forma similar a las etiquetas de recursos de Kubernetes.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Es opcional. Las anotaciones son un mapa clave-valor no estructurado que se almacena con un recurso que herramientas externas pueden establecer para almacenar y recuperar metadatos arbitrarios. No se pueden consultar y deben conservarse cuando se modifican objetos.

Más información: https://kubernetes.io/docs/user-guide/annotations

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo salida. Identificador único del recurso. El UID es único en el tiempo y espacio para este recurso dentro del alcance de este servicio. Normalmente, el servidor lo genera durante la creación correcta de un recurso y no se debe cambiar. El UID se usa para identificar los recursos de manera única en caso de la reutilización de nombres de recursos y debe ser un UUID4.
etag

string

Solo salida. Valor opaco que identifica de manera única a una versión o generación de un recurso. Se puede usar para confirmar que el cliente y el servidor están de acuerdo en el orden del recurso que se escribe.
createTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se creó el recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se actualizó el recurso por última vez. Este valor debe actualizarse en caso de que los usuarios hagan cualquier cambio al recurso. Este valor debería actualizarse si el servicio hace cambios al recurso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Plano

Los esquemas son imágenes de OCI que contienen todos los artefactos necesarios para aprovisionar una unidad. Los metadatos, como el tipo de motor que se usa para accionar el blueprint (p. ej., Terraform, Helm, etc.) y la versión, provendrán del manifiesto de la imagen. Si se omite el nombre de host, se supondrá que es la ruta de acceso regional a Artifact Registry (p. ej., us-east1-docker.pkg.dev).

Representación JSON 
{
  "package": string,
  "engine": string,
  "version": string
}
Campos
package

string

Es opcional. Inmutable. Es el URI de un plano utilizado por la unidad (obligatorio, a menos que se establezcan unitKind o release).
engine

string

Solo salida. Es el tipo de motor que se usa para activar el blueprint, p. ej., terraform, helm, etc.
version

string

Solo salida. Son los metadatos de la versión, si están presentes en el plano.

ReleaseRequirements

Es el conjunto de requisitos que se deben cumplir en la unidad cuando se usa esta versión.

Representación JSON 
{
  "upgradeableFromReleases": [
    string
  ]
}
Campos
upgradeableFromReleases[]

string

Es opcional. Es una lista de versiones desde las que se puede actualizar una unidad a esta (opcional). Si se deja vacío, no se aplicará ninguna restricción. Cuando se proporcione, las solicitudes de actualización de unidades a esta versión verificarán y aplicarán esta restricción.

Métodos

create

 Crea una versión nueva.

delete

 Borra una sola versión.

get

 Recupera una sola versión.

list

 Recupera una colección de versiones.

patch

 Actualiza un solo lanzamiento.