REST Resource: projects.locations.flags

Ressource: Flag

Stellt ein einzelnes Flag dar.

JSON-Darstellung 
{
  "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
}
Felder
name

string

ID. Der Ressourcenname (vollständiger URI der Ressource) gemäß dem Standardbenennungsschema:

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

string

Erforderlich. Nicht veränderbar. In Laufzeitbewertungs-APIs verwendeter Flag-Schlüssel (OpenFeature). Maximale Länge: 256 Bytes.
valueType
(deprecated)

enum (FlagValueType)

Optional. Nicht veränderbar. Nicht mehr unterstützt: Verwenden Sie stattdessen flagValueType. Typ des Flag-Werts.
flagValueType

enum (ValueType)

Optional. Nicht veränderbar. Typ des Flag-Werts.
evaluationSpec

object (EvaluationSpec)

Optional. Gibt an, wie der Flag-Wert ausgewertet werden soll.

Wenn ein boolesches Flag ohne Angabe von „evaluationSpec“ erstellt wird, werden standardmäßig zwei Standardvarianten erstellt: „Aktiviert“ (mit „boolValue“ = „true“) und „Deaktiviert“ (mit „boolValue“ = „false“). „Deaktiviert“ wird als „defaultTarget“ festgelegt.
unitKind

string

Erforderlich. Nicht veränderbar. UnitKind, die dieses Flag verwenden können.
description

string

Optional. Beschreibung des Flags. Maximale Länge: 500 Bytes.
variants[]

object (FlagVariant)

Optional. Eine Liste von Varianten.
flagSet

string

Optional. Die Flag-Gruppe, zu der dieses Flag gehört.
state

enum (State)

Optional. Aktueller Status des Flags.
labels

map (key: string, value: string)

Optional. Die Labels der Ressource, die zur Kategorisierung verwendet werden können, ähnlich wie Kubernetes-Ressourcenlabels.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
annotations

map (key: string, value: string)

Optional. „Annotations“ ist eine unstrukturierte Schlüssel/Wert-Zuordnung, die mit einer Ressource gespeichert wird und von externen Tools festgelegt werden kann, um beliebige Metadaten zu speichern und abzurufen. Sie können nicht abgefragt werden und sollten beim Ändern von Objekten beibehalten werden.

Weitere Informationen: https://kubernetes.io/docs/user-guide/annotations

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
uid

string

Nur Ausgabe. Die eindeutige Kennzeichnung der Ressource. Die UID gilt zeitlich und räumlich im Rahmen des Dienstes nur für diese eine Ressource. Sie wird in der Regel nach dem Erstellen der Ressource vom Server generiert und darf nicht geändert werden. Die UID dient dazu, Ressourcen, deren Namen wiederverwendet werden, eindeutig zu kennzeichnen. Dies sollte eine UUID4 sein.
etag

string

Nur Ausgabe. Ein opaker Wert, der eine Version oder Generation einer Ressource eindeutig kennzeichnet. Damit kann bestätigt werden, dass Client und Server der Reihenfolge einer Ressource, die gerade geschrieben wird, zustimmen.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Ressource zuletzt aktualisiert wurde. Wenn Nutzer Änderungen an der Ressource vornehmen, muss dieser Wert aktualisiert werden. Gleiches gilt bei Änderungen an der Ressource durch den Dienst.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

FlagValueType

Enums
FLAG_VALUE_TYPE_UNSPECIFIED
FLAG_VALUE_TYPE_BOOL Boolescher Flag-Werttyp.
FLAG_VALUE_TYPE_INT Ganzzahliger Flag-Werttyp.
FLAG_VALUE_TYPE_STRING Flag-Werttyp „String“.
FLAG_VALUE_TYPE_DOUBLE Double-Flag-Typ.

ValueType

Typ des Flag-Werts.

Enums
FLAG_VALUE_TYPE_UNSPECIFIED Nicht angegebener Typ des Flag-Werts.
FLAG_VALUE_TYPE_BOOLEAN Boolescher Flag-Werttyp.
FLAG_VALUE_TYPE_INTEGER Ganzzahliger Flag-Werttyp.
FLAG_VALUE_TYPE_STRING Flag-Werttyp „String“.
FLAG_VALUE_TYPE_DOUBLE Doppelter Flag-Werttyp.

FlagVariant

Eine Variante ist ein Bezeichner für einen Wert (einem Wert zugewiesener Name).

JSON-Darstellung 
{
  "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.
}
Felder
id

string

Erforderlich. Varianten-ID. Maximale Länge: 128 Bytes.
trackingId

string

Optional. „trackingId“ ist je nach Name und Wert der Variante im Rahmen des Dienstes eindeutig. Sie wird in der Regel vom Server generiert und darf nicht geändert werden. Mit „trackingId“ werden Varianten eindeutig identifiziert und nachverfolgt.
description

string

Optional. Eine für Menschen lesbare Beschreibung der Funktion oder Bedeutung dieser Variante.
Union-Feld value. „value“ ist ein einzelner Flag-Wert für die Variante. Für value ist nur einer der folgenden Werte zulässig:
booleanValue

boolean

Optional. Boolescher Variantenwert.
integerValue

string (int64 format)

Optional. Ganzzahliger Variantenwert.
stringValue

string

Optional. String-Variantenwert.
doubleValue

number

Optional. Doppelter Variantenwert.

Bundesland

„State“ definiert den Status des Flags.

Enums
FLAG_STATE_UNSPECIFIED Der Status der Kennzeichnung ist nicht angegeben.
FLAG_STATE_IN_DEVELOPMENT Das Flag befindet sich in der Entwicklungsphase.
FLAG_STATE_ACTIVE Die Markierung ist aktiv.
FLAG_STATE_SUNSETTING Das Flag ist veraltet.
FLAG_STATE_CLEANUP Die Markierung befindet sich im Bereinigungsstatus.

Methoden

create

 Neue Markierung erstellen

delete

 Einzelnes Flag löschen

get

 Einzelnes Flag abrufen

list

 Eine Sammlung von Markierungen abrufen.

patch

 Einzelnes Flag aktualisieren