REST Resource: projects.locations.flags

Risorsa: Flag

Rappresenta un singolo flag.

Rappresentazione JSON 
{
  "name": string,
  "key": string,
  "valueType": enum (FlagValueType),
  "flagValueType": enum (ValueType),
  "evaluationSpec": {
    object (EvaluationSpec)
  },
  "unitKind": string,
  "description": string,
  "variants": [
    {
      object (FlagVariant)
    }
  ],
  "flagSet": string,
  "state": enum (State),
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string
}
Campi
name

string

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

"projects/{project}/locations/{location}/flags/{flagId}"
key

string

Obbligatorio. Immutabile. Chiave flag utilizzata nelle API di valutazione di runtime (OpenFeature). Lunghezza massima: 256 byte.
valueType
(deprecated)

enum (FlagValueType)

Facoltativo. Immutabile. Deprecato: utilizza flagValueType. Tipo di valore del flag.
flagValueType

enum (ValueType)

Facoltativo. Immutabile. Tipo di valore del flag.
evaluationSpec

object (EvaluationSpec)

Facoltativo. Specifica di come deve essere valutato il valore del flag.

Se viene creato un flag booleano senza specificare un evaluationSpec, vengono create per impostazione predefinita due varianti predefinite, "Enabled" (con boolValue = true) e "Disabled" (con boolValue = false), e "Disabled" viene impostata come defaultTarget.
unitKind

string

Obbligatorio. Immutabile. UnitKind che può utilizzare questo flag.
description

string

Facoltativo. Descrizione del flag. Lunghezza massima: 500 byte.
variants[]

object (FlagVariant)

Facoltativo. Un elenco di varianti.
flagSet

string

Facoltativo. Il set di flag a cui appartiene questo flag.
state

enum (State)

Facoltativo. Stato attuale del flag.
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".

FlagValueType

Enum
FLAG_VALUE_TYPE_UNSPECIFIED
FLAG_VALUE_TYPE_BOOL Tipo di valore del flag booleano.
FLAG_VALUE_TYPE_INT Tipo di valore del flag intero.
FLAG_VALUE_TYPE_STRING Tipo di valore del flag stringa.
FLAG_VALUE_TYPE_DOUBLE Tipo di doppio flag.

ValueType

Tipo di valore del flag.

Enum
FLAG_VALUE_TYPE_UNSPECIFIED Tipo di valore del flag non specificato.
FLAG_VALUE_TYPE_BOOLEAN Tipo di valore del flag booleano.
FLAG_VALUE_TYPE_INTEGER Tipo di valore del flag intero.
FLAG_VALUE_TYPE_STRING Tipo di valore del flag stringa.
FLAG_VALUE_TYPE_DOUBLE Tipo di valore del flag Double.

FlagVariant

La variante è un identificatore per un valore (nome assegnato a un valore).

Rappresentazione JSON 
{
  "id": string,
  "trackingId": string,
  "description": string,

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "integerValue": string,
  "stringValue": string,
  "doubleValue": number
  // End of list of possible types for union field value.
}
Campi
id

string

Obbligatorio. ID variante. Lunghezza massima: 128 byte.
trackingId

string

(Facoltativo) trackingId è univoco a seconda del nome e del valore della variante nell'ambito del servizio. Viene tipicamente generato dal server e non deve essere modificato. trackingId viene utilizzato per identificare e monitorare in modo univoco le varianti.
description

string

Facoltativo. Una descrizione leggibile di cosa fa o rappresenta questa variante.
Campo unione value. value è un singolo valore del flag per la variante. value può essere solo uno dei seguenti tipi:
booleanValue

boolean

Facoltativo. Valore della variante booleana.
integerValue

string (int64 format)

Facoltativo. Valore della variante intera.
stringValue

string

Facoltativo. Valore della variante stringa.
doubleValue

number

Facoltativo. Valore della variante doppio.

Stato

State definisce lo stato del flag.

Enum
FLAG_STATE_UNSPECIFIED Lo stato del flag non è specificato.
FLAG_STATE_IN_DEVELOPMENT Il flag è in stato di sviluppo.
FLAG_STATE_ACTIVE Il flag è in stato attivo.
FLAG_STATE_SUNSETTING Il flag è in stato ritirato.
FLAG_STATE_CLEANUP Il flag è in stato di pulizia.

Metodi

create

 Crea un nuovo flag.

delete

 Eliminare un singolo flag.

get

 Recupera un singolo flag.

list

 Recupera una raccolta di flag.

patch

 Aggiorna un singolo flag.