REST Resource: projects.locations.rolloutKinds

Risorsa: RolloutKind

Un oggetto che descrive varie impostazioni dell'esecuzione dell'implementazione. Include criteri integrati e personalizzabili.

Rappresentazione JSON 
{
  "name": string,
  "unitKind": string,
  "rolloutOrchestrationStrategy": string,
  "maintenancePolicyEnforcement": enum (MaintenancePolicyEnforcement),
  "unitFilter": string,
  "updateUnitKindStrategy": enum (UpdateUnitKindStrategy),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,
  "errorBudget": {
    object (ErrorBudget)
  }
}
Campi
name

string

Identificatore. Il nome della risorsa (URI completo della risorsa) che segue lo schema di denominazione standard:

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

string

Obbligatorio. Immutabile. Il tipo di unità a cui corrisponde questo tipo di implementazione. Le implementazioni derivanti da questo tipo di implementazione avranno come target le unità di questo tipo. In altre parole, definisce la popolazione di unità di destinazione da aggiornare tramite le implementazioni.
rolloutOrchestrationStrategy

string

Facoltativo. La strategia utilizzata per l'esecuzione di un'implementazione. Questo campo è obbligatorio.

Esistono due strategie di valori supportate utilizzate per il controllo: "Google.Cloud.Simple.AllAtOnce" e "Google.Cloud.Simple.OneLocationAtATime".

Un'implementazione con una di queste semplici strategie verrà implementata in tutte le località definite nelle località SaaS del tipo di unità associato.
maintenancePolicyEnforcement

enum (MaintenancePolicyEnforcement)

Facoltativo. Valore tra rigoroso (applica la policy di manutenzione e considera solo le unità con policy di manutenzione), ignora (ignora la policy di manutenzione) e salta (salta le unità con policy di manutenzione)
unitFilter

string

Facoltativo. Stringa di filtro formattata CEL(https://github.com/google/cel-spec) rispetto all'unità. Il filtro verrà applicato per determinare la popolazione di unità idonee. Questo filtro può solo ridurre, ma non espandere l'ambito del lancio.
updateUnitKindStrategy

enum (UpdateUnitKindStrategy)

Facoltativo. La configurazione per l'aggiornamento del tipo di unità. Per impostazione predefinita, il tipo di unità verrà aggiornato all'inizio dell'implementazione.
labels

map (key: string, value: string)

Facoltativo. Le etichette sulla risorsa, che possono essere utilizzate per la categorizzazione, simili alle etichette delle risorse Kubernetes.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Facoltativo. Le annotazioni sono una mappa chiave-valore non strutturata archiviata con una risorsa che può essere impostata da strumenti esterni per archiviare e recuperare metadati arbitrari. Non sono interrogabili e devono essere conservati durante la modifica degli oggetti.

Scopri di più: https://kubernetes.io/docs/user-guide/annotations

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Solo output. Identificatore unico della risorsa. L'UID è unico nello spazio e nel tempo per questa risorsa nell'ambito del servizio. Viene tipicamente generato dal server durante la creazione di una risorsa e non deve essere modificato. L'UID viene utilizzato per identificare in modo unico le risorse quando i nomi risorsa vengono riutilizzati. Deve essere un UUID4.
etag

string

Solo output. Valore opaco che identifica in modo unico una versione o generazione di una risorsa. Può essere usato per confermare che client e server concordano nell'ordine di una risorsa in fase di scrittura.
createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento della risorsa. Qualsiasi modifica apportata alla risorsa dagli utenti deve aggiornare questo valore. Le modifiche a una risorsa apportate dal servizio devono aggiornare questo valore.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
errorBudget

object (ErrorBudget)

Facoltativo. La configurazione per il budget di errore. Se il numero di unità non riuscite supera max(allowedCount, allowed_ratio * totalUnits), l'implementazione verrà sospesa. Se non è impostato, verrà tentato l'aggiornamento di tutte le unità, indipendentemente dal numero di errori riscontrati.

MaintenancePolicyEnforcement

Definisce l'applicazione della policy di manutenzione.

Enum
MAINTENANCE_POLICY_ENFORCEMENT_UNSPECIFIED
MAINTENANCE_POLICY_ENFORCEMENT_STRICT
MAINTENANCE_POLICY_ENFORCEMENT_IGNORED
MAINTENANCE_POLICY_ENFORCEMENT_SKIPPED

UpdateUnitKindStrategy

Enum
UPDATE_UNIT_KIND_STRATEGY_UNSPECIFIED Strategia non specificata.
UPDATE_UNIT_KIND_STRATEGY_ON_START Aggiorna la strategia del tipo di unità all'inizio dell'implementazione.
UPDATE_UNIT_KIND_STRATEGY_NEVER Non aggiornare mai il tipo di unità.

ErrorBudget

La configurazione per il budget di errore. Se il numero di unità non riuscite supera max(allowedCount, allowed_ratio * totalUnits), l'implementazione verrà sospesa.

Rappresentazione JSON 
{
  "allowedCount": integer,
  "allowedPercentage": integer
}
Campi
allowedCount

integer

Facoltativo. Il numero massimo di unità non riuscite consentite in una località senza mettere in pausa l'implementazione.
allowedPercentage

integer

Facoltativo. La percentuale massima di unità consentite per l'errore (0, 100] all'interno di una località senza mettere in pausa l'implementazione.

Metodi

create

 Crea un nuovo tipo di implementazione.

delete

 Elimina un singolo tipo di implementazione.

get

 Recupera un singolo tipo di implementazione.

list

 Recupera una raccolta di tipi di implementazione.

patch

 Aggiorna un singolo tipo di implementazione.