REST Resource: projects.locations.fleetPackages.rollouts

Ressource: Rollout

Die Rollout-Ressource stellt eine Instanz des FleetPackage-Rollout-Vorgangs in einer Flotte dar. Dies ist eine vom System generierte Ressource, die für Endnutzer Lesezugriff hat. Sie wird hauptsächlich vom Dienst verwendet, um die Änderungen in FleetPackage und andere Änderungen in der Umgebung zu verarbeiten.

JSON-Darstellung 
{
  "name": string,
  "release": string,
  "rolloutStrategy": {
    object (RolloutStrategy)
  },
  "info": {
    object (RolloutInfo)
  },
  "deletionPropagationPolicy": enum (DeletionPropagationPolicy),
  "createTime": string,
  "updateTime": string
}
Felder
name

string

ID. Name des Roll-outs. Das Format ist projects/{project}/locations/{location}/fleetPackages/{fleetPackage}/rollouts/[a-z][a-z0-9\-]{0,62}.
release

string

Verweis auf die Einführung von Release.
rolloutStrategy

object (RolloutStrategy)

Roll-out-Strategie für die Einführung von FleetPackage in Clustern.
info

object (RolloutInfo)

Aktuelle Details zum Roll-out.
deletionPropagationPolicy

enum (DeletionPropagationPolicy)

Richtlinie für die Verteilung des Löschens des Rollouts.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Roll-out 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 Zeitpunkt, zu dem der Roll-out zuletzt aktualisiert 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".

RolloutInfo

RolloutInfo stellt den Status von FleetPackage in allen Clustern dar, auf die die Einführung ausgerichtet ist.

JSON-Darstellung 
{
  "state": enum (State),
  "startTime": string,
  "endTime": string,
  "message": string,
  "rolloutStrategyInfo": {
    object (RolloutStrategyInfo)
  }
}
Felder
state

enum (State)

Nur Ausgabe. „State“ enthält den Gesamtstatus des Roll-outs.
startTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem der Roll-out gestartet 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"
endTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Roll-out abgeschlossen 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"
message

string

Nur Ausgabe. Nachricht mit zusätzlichen Informationen zur Einführung.
rolloutStrategyInfo

object (RolloutStrategyInfo)

Nur Ausgabe. Informationen zur Roll-out-Strategie geben den Status der Ausführung der Roll-out-Strategie an.

Bundesland

Status des Roll‑outs

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
COMPLETED Roll-out abgeschlossen.
SUSPENDED Einführung angehalten.
ABORTED Roll-out abgebrochen. Ein bereits laufender Roll-out wurde beendet, weil sich die Flottenmitgliedschaften geändert haben oder das Flottenpaket gelöscht wurde.
IN_PROGRESS Roll-out läuft.
STALLED Einführung angehalten.
CANCELLED Roll-out abgebrochen. Der vorgeschlagene Roll-out wurde von Anfang an als ungültig oder nicht durchführbar eingestuft, da Probleme mit dem Paket, der Version oder der Variantkonfiguration vorlagen.
ABORTING Roll-out wird abgebrochen.

RolloutStrategyInfo

RolloutStrategyInfo stellt den Ausführungsstatus verschiedener Arten von Roll-out-Strategien dar. Nur das Feld, das der in der Rollout-Ressource angegebenen Rollout-Strategie entspricht, wird ausgefüllt.

JSON-Darstellung 
{

  // Union field strategy can be only one of the following:
  "allAtOnceStrategyInfo": {
    object (AllAtOnceStrategyInfo)
  },
  "rollingStrategyInfo": {
    object (RollingStrategyInfo)
  }
  // End of list of possible types for union field strategy.
}
Felder
Union-Feld strategy. „Strategy“ steht für das Ergebnis der Anwendung einer der Rollout-Strategien. Für strategy ist nur einer der folgenden Werte zulässig:
allAtOnceStrategyInfo

object (AllAtOnceStrategyInfo)

„AllAtOnceStrategyInfo“ stellt den Status der Ausführung der „AllAtOnce“-Roll-out-Strategie dar.
rollingStrategyInfo

object (RollingStrategyInfo)

RollingStrategyInfo stellt den Status der Ausführung der Rolling-Rollout-Strategie dar.

AllAtOnceStrategyInfo

„AllAtOnceStrategyInfo“ stellt den Ausführungsstatus der Roll‑out-Strategie „AllAtOnce“ dar.

JSON-Darstellung 
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
Felder
clusters[]

object (ClusterInfo)

Unsortierte Liste. Bereitstellungsstatus des Ressourcen-Bundles für alle Zielcluster.

ClusterInfo

ClusterInfo stellt den Status eines Ressourcenpaket-Roll-outs für einen Cluster dar.

JSON-Darstellung 
{
  "membership": string,
  "desired": {
    object (ResourceBundleDeploymentInfo)
  },
  "initial": {
    object (ResourceBundleDeploymentInfo)
  },
  "current": {
    object (ResourceBundleDeploymentInfo)
  },
  "state": enum (State),
  "messages": [
    string
  ],
  "startTime": string,
  "endTime": string
}
Felder
membership

string

Nur Ausgabe. gkehub-Mitgliedschaft des Zielclusters
desired

object (ResourceBundleDeploymentInfo)

Nur Ausgabe. Der gewünschte Status für das Ressourcenbündel.
initial

object (ResourceBundleDeploymentInfo)

Nur Ausgabe. Anfangszustand des Ressourcen-Bundles vor der Bereitstellung.
current

object (ResourceBundleDeploymentInfo)

Nur Ausgabe. Aktueller Status des Ressourcen-Bundles.
state

enum (State)

Nur Ausgabe. Status des Roll-outs für den Cluster.
messages[]

string

Nur Ausgabe. Unsortierte Liste. Nachrichten enthalten zusätzliche Informationen zur Bereitstellung.
startTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für den Beginn des Abgleichs.

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

string (Timestamp format)

Nur Ausgabe. Zeitstempel für das Ende des Abgleichs.

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

ResourceBundleDeploymentInfo

ResourceBundleDeploymentInfo stellt den Status eines Resource Bundle-Deployments dar.

JSON-Darstellung 
{
  "release": string,
  "version": string,
  "variant": string,
  "syncState": enum (SyncState),
  "messages": [
    string
  ]
}
Felder
release

string

Nur Ausgabe. Bezieht sich auf einen ResourceBundle-Release.
version

string

Nur Ausgabe. Bezieht sich auf eine Version des ResourceBundle-Release.
variant

string

Nur Ausgabe. Bezieht sich auf eine Variante in einer ResourceBundle-Version.
syncState

enum (SyncState)

Nur Ausgabe. Synchronisierungsstatus der ResourceBundle-Bereitstellung.
messages[]

string

Nur Ausgabe. Unsortierte Liste. Nachrichten enthalten Informationen zur ResourceBundle-Bereitstellung. Geben Sie beispielsweise im Falle eines Fehlers den Grund für den Fehler an. Bei einer ausstehenden Bereitstellung enthalten Nachrichten den Grund dafür, warum die Bereitstellung des neuen Releases aussteht.

SyncState

Synchronisierungsstatus der Bereitstellung des Ressourcen-Bundles.

Enums
SYNC_STATE_UNSPECIFIED Nicht angegebener Zustand.
RECONCILING Abgleichstatus.
STALLED Status „Angehalten“.
SYNCED Synchronisierter Status.
PENDING Status „Ausstehend“
ERROR Fehlerstatus.
DELETION_PENDING Status „Zum Löschen vorgemerkt“
DELETING Bundesland wird gelöscht.
DELETED Gelöschter Bundesstaat.

Bundesland

Status des Roll-outs für den Cluster.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
WAITING Wartestatus.
IN_PROGRESS Status „In Bearbeitung“
STALLED Status „Angehalten“.
COMPLETED Abgeschlossener Status
ABORTED Status „Abgebrochen“. Ein bereits laufender Roll-out wurde beendet, weil sich die Flottenmitgliedschaften geändert haben oder das Flottenpaket gelöscht wurde.
CANCELLED Status „Abgebrochen“. Der vorgeschlagene Roll-out wurde von Anfang an als ungültig oder nicht durchführbar eingestuft, da Probleme mit dem Paket, der Version oder der Variantkonfiguration vorlagen.
ERROR Fehlerstatus.
UNCHANGED Unveränderter Status.
SKIPPED Übersprungener Status.

RollingStrategyInfo

RollingStrategyInfo stellt den Ausführungsstatus der Rolling-Rollout-Strategie dar.

JSON-Darstellung 
{
  "clusters": [
    {
      object (ClusterInfo)
    }
  ]
}
Felder
clusters[]

object (ClusterInfo)

Unsortierte Liste. Bereitstellungsstatus des Ressourcen-Bundles für alle Zielcluster.

Methoden

abort

 Roll-out abbrechen

get

 Ruft Details zu einem einzelnen Roll-out ab.

list

 Listet Rollouts in einem bestimmten Projekt, an einem bestimmten Standort und für ein bestimmtes Flottenpaket auf.

resume

 Roll‑out fortsetzen

suspend

 Roll-out anhalten