REST Resource: projects.locations.rolloutKinds

Recurso: RolloutKind

Um objeto que descreve várias configurações da execução do lançamento. Inclui políticas integradas e personalizáveis.

Representação 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

Identificador. O nome do recurso (URI completo do recurso) seguindo o esquema de nomenclatura padrão:

"projects/{project}/locations/{location}/rolloutKinds/{rolloutKindId}"
unitKind

string

Obrigatório. Imutável. UnitKind a que esse tipo de lançamento corresponde. Os lançamentos desse tipo vão segmentar as unidades desse tipo. Em outras palavras, isso define a população de unidades de destino que serão atualizadas por lançamentos.
rolloutOrchestrationStrategy

string

Opcional. A estratégia usada para executar um lançamento. Este campo é obrigatório.

Há duas estratégias de valores compatíveis usadas para controle: "Google.Cloud.Simple.AllAtOnce" e "Google.Cloud.Simple.OneLocationAtATime".

Um lançamento com uma dessas estratégias simples será feito em todos os locais definidos nos locais de SaaS do UnitKind associado.
unitFilter

string

Opcional. String de filtro formatada em CEL(https://github.com/google/cel-spec) em relação a "Unit". O filtro será aplicado para determinar a população de unidades qualificadas. Esse filtro só pode reduzir, mas não expandir o escopo do lançamento.
updateUnitKindStrategy

enum (UpdateUnitKindStrategy)

Opcional. A configuração para atualizar o tipo de unidade. Por padrão, o tipo de unidade será atualizado no início do lançamento.
labels

map (key: string, value: string)

Opcional. Os rótulos no recurso, que podem ser usados para categorização, semelhantes aos rótulos de recursos do Kubernetes.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Opcional. Anotações é um mapa de chave-valor não estruturado armazenado com um recurso que pode ser definido por ferramentas externas para armazenar e recuperar metadados arbitrários. Elas não podem ser consultadas e precisam ser preservadas ao modificar objetos.

Mais informações: https://kubernetes.io/docs/user-guide/annotations

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Apenas saída. O identificador exclusivo do recurso. O UID é exclusivo no tempo e espaço para esse recurso no escopo do serviço. Geralmente, ele é gerado pelo servidor quando um recurso é criado com sucesso e não pode ser modificado. O UID é usado para identificar exclusivamente recursos com reutilização de nome de recurso. Deve ser um UUID4.
etag

string

Apenas saída. Um valor opaco que identifica exclusivamente uma versão ou geração de um recurso. Pode ser usado para confirmar que o cliente e o servidor concordam com a ordenação de um recurso em criação.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora da última atualização do recurso. Qualquer mudança que for feita pelos usuários no recurso vai atualizar esse valor. As mudanças de um recurso feitas pelo serviço devem atualizar esse valor.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
errorBudget

object (ErrorBudget)

Opcional. A configuração da margem de erro. Se o número de unidades com falha exceder max(allowedCount, allowed_ratio * totalUnits), o lançamento será pausado. Se não for definido, todas as unidades vão tentar ser atualizadas, independente do número de falhas encontradas.

UpdateUnitKindStrategy

Tipos enumerados
UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED Estratégia não especificada.
UPDATE_UNIT_KIND_STRATEGY_ON_START Atualize a estratégia de tipo de unidade no início do lançamento.
UPDATE_UNIT_KIND_STRATEGY_NEVER Nunca atualize o tipo de unidade.

ErrorBudget

A configuração da margem de erro. Se o número de unidades com falha exceder max(allowedCount, allowed_ratio * totalUnits), o lançamento será pausado.

Representação JSON 
{
  "allowedCount": integer,
  "allowedPercentage": integer
}
Campos
allowedCount

integer

Opcional. O número máximo de unidades com falha permitidas em um local sem pausar o lançamento.
allowedPercentage

integer

Opcional. A porcentagem máxima de unidades permitidas para falhar (0, 100] em um local sem pausar o lançamento.

Métodos

create

 Crie um tipo de lançamento.

delete

 Exclui um único tipo de lançamento.

get

 Recupera um único tipo de lançamento.

list

 Recupera uma coleção de tipos de lançamento.

patch

 Atualiza um único tipo de lançamento.