REST Resource: projects.locations.flagReleases

Ressource: FlagRelease

Eine Sammlung von FlagRevision.

JSON-Darstellung
{
  "name": string,
  "flagRevisions": [
    string
  ],
  "obsoleteFlags": [
    string
  ],
  "unitKind": string,
  "flagSets": [
    string
  ],
  "allFlags": boolean,
  "effectiveFlagRevisions": [
    string
  ],
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string,
  "createTime": string,
  "updateTime": string,

  // Union field release_content can be only one of the following:
  "flagRevisionsRelease": {
    object (FlagRevisionList)
  },
  "flagSetsRelease": {
    object (FlagSetList)
  },
  "allFlagsRelease": boolean
  // End of list of possible types for union field release_content.
}
Felder
name

string

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

"projects/{project}/locations/{location}/flagReleases/{flagReleaseId}"

flagRevisions[]
(deprecated)

string

Optional. Nicht veränderbar. VERALTET: Verwenden Sie stattdessen flagRevisionsRelease. FlagRevisionwird eingeführt. Es kann nur flagRevisions, allFlags oder flagSets festgelegt werden. Sie war früher die ultimative Quelle der Wahrheit und wurde in „effectiveFlagRevisions“ verschoben.

obsoleteFlags[]
(deprecated)

string

Optional. Nicht veränderbar. Veraltet: Verwenden Sie das Feld „state“ in der Ressource „Flag“, um die Bereinigung von Flag-Lebenszyklen zu verwalten, einschließlich des Entfernens aus UnitKind und Units. Flags, die aus der angegebenen UnitKind und allen zugehörigen Units entfernt werden sollen. Wenn Flag hier angegeben ist, werden die zugehörigen FlagRevisions aus UnitKind und Units entfernt.

unitKind

string

Erforderlich. Nicht veränderbar. Die UnitKind, für die diese FlagRelease gilt.

flagSets[]
(deprecated)

string

Optional. Nicht veränderbar. VERALTET: Verwenden Sie stattdessen „flagSetsRelease“. Flag-Sets, die eingeführt werden sollen. Es kann nur flagRevisions, allFlags oder flagSets festgelegt werden.

allFlags
(deprecated)

boolean

Optional. Nicht veränderbar. VERALTET: Verwenden Sie stattdessen „allFlagsRelease“. Führen Sie für alle Flags im angegebenen UnitKind einen Rollout durch. Es kann nur flagRevisions, allFlags oder flagSets festgelegt werden.

effectiveFlagRevisions[]

string

Nur Ausgabe. Ein OUTPUT_ONLY-Feld, das FlagRevision enthält, die eingeführt werden sollen. Dies ist die ultimative Quelle für die Wahrheit darüber, was ein Rollout oder ein UnitOperation enthält.

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".

Union-Feld release_content. Definiert den Inhalt oder Typ dieser Flag-Freigabe. Es kann nur ein Feld in diesem „oneof“ festgelegt werden. Für release_content ist nur einer der folgenden Werte zulässig:
flagRevisionsRelease

object (FlagRevisionList)

Optional. Nicht veränderbar. Gibt an, dass der Release aus einer Liste von Flag-Überarbeitungen besteht.

flagSetsRelease

object (FlagSetList)

Optional. Nicht veränderbar. Gibt an, dass der Release aus einer Liste von Flag-Sets besteht.

allFlagsRelease

boolean

Optional. Nicht veränderbar. Gibt an, dass der Release alle Flags enthält.

FlagRevisionList

Wrapper für eine Liste von Flag-Versionen.

JSON-Darstellung
{
  "revisions": [
    string
  ]
}
Felder
revisions[]

string

Erforderlich. FlagRevisions, die eingeführt werden sollen.

FlagSetList

Wrapper für eine Liste von Flag-Sets.

JSON-Darstellung
{
  "sets": [
    string
  ]
}
Felder
sets[]

string

Erforderlich. Flag-Sets, die eingeführt werden sollen.

Methoden

create

Erstellen Sie einen neuen Flag-Release.

delete

Einzelnen Flag-Release löschen

get

Einzelnen Flag-Release abrufen

list

Eine Sammlung von Flag-Releases abrufen.

patch

Einzelnen Flag-Release aktualisieren.