REST Resource: projects.locations.rolloutKinds

Recurso: RolloutKind

Es un objeto que describe varios parámetros de configuración de la ejecución de la versión. Incluye políticas integradas y personalizables.

Representación JSON 
{
  "name": string,
  "unitKind": string,
  "rolloutOrchestrationStrategy": string,
  "unitFilter": string,
  "updateUnitKindStrategy": enum (UpdateUnitKindStrategy),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "errorBudget": {
    object (ErrorBudget)
  }
}
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}/rolloutKinds/{rolloutKindId}"
unitKind

string

Obligatorio. Inmutable. Es el UnitKind al que corresponde este tipo de lanzamiento. Los lanzamientos que se originen a partir de este tipo de lanzamiento se segmentarán para las unidades de este tipo de unidad. En otras palabras, esto define la población de unidades objetivo que se actualizarán con las versiones.
rolloutOrchestrationStrategy

string

Es opcional. Es la estrategia que se usa para ejecutar un lanzamiento. Este campo es obligatorio.

Hay dos estrategias de valores admitidas que se usan para controlar: "Google.Cloud.Simple.AllAtOnce" y "Google.Cloud.Simple.OneLocationAtATime".

Un lanzamiento con una de estas estrategias simples se realizará en todas las ubicaciones definidas en las ubicaciones de SaaS del UnitKind asociado.
unitFilter

string

Es opcional. Cadena de filtro con formato de CEL(https://github.com/google/cel-spec) en relación con Unit. Se aplicará el filtro para determinar la población de unidades aptas. Este filtro solo puede reducir, pero no expandir el alcance del lanzamiento.
updateUnitKindStrategy

enum (UpdateUnitKindStrategy)

Es opcional. Es la configuración para actualizar el tipo de unidad. De forma predeterminada, el tipo de unidad se actualizará al inicio del lanzamiento.
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".
errorBudget

object (ErrorBudget)

Es opcional. Es la configuración del porcentaje de error aceptable. Si la cantidad de unidades con errores supera max(allowedCount, allowed_ratio * totalUnits), se pausará el lanzamiento. Si no se configura, se intentarán actualizar todas las unidades, independientemente de la cantidad de errores que se produzcan.

UpdateUnitKindStrategy

Enums
UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED No se especificó la estrategia.
UPDATE_UNIT_KIND_STRATEGY_ON_START Actualiza la estrategia de tipo de unidad en el inicio del lanzamiento.
UPDATE_UNIT_KIND_STRATEGY_NEVER Nunca actualiza el tipo de unidad.

ErrorBudget

Es la configuración del porcentaje de error aceptable. Si la cantidad de unidades con errores supera max(allowedCount, allowed_ratio * totalUnits), se pausará el lanzamiento.

Representación JSON 
{
  "allowedCount": integer,
  "allowedPercentage": integer
}
Campos
allowedCount

integer

Es opcional. Es la cantidad máxima de unidades con errores que se permiten en una ubicación sin pausar el lanzamiento.
allowedPercentage

integer

Es opcional. Es el porcentaje máximo de unidades que pueden fallar (0, 100] en una ubicación sin detener la implementación.

Métodos

create

 Crea un nuevo tipo de lanzamiento.

delete

 Borra un solo tipo de lanzamiento.

get

 Recupera un solo tipo de lanzamiento.

list

 Recupera una colección de tipos de lanzamientos.

patch

 Actualiza un solo tipo de lanzamiento.