REST Resource: projects.locations.privateClouds.upgrades

Ressource: Upgrade

Hier wird das Upgrade der privaten Cloud beschrieben.

JSON-Darstellung 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "endTime": string,
  "state": enum (State),
  "type": enum (Type),
  "description": string,
  "estimatedDuration": string,
  "schedule": {
    object (Schedule)
  },
  "version": string,
  "etag": string,
  "uid": string,
  "componentUpgrades": [
    {
      object (VmwareUpgradeComponent)
    }
  ],
  "startVersion": string,
  "targetVersion": string
}
Felder
name

string

Nur Ausgabe. ID. Der Ressourcenname der privaten Cloud Upgrade. Ressourcennamen sind schemalose URIs, die den Konventionen unter https://cloud.google.com/apis/design/resource_names entsprechen. Beispiel: projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade
createTime

string (Timestamp format)

Nur Ausgabe. Nur Ausgabe. Erstellungszeitpunkt dieser Ressource.

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. Nur Ausgabe. Zeitpunkt der letzten Aktualisierung dieser Ressource.

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. Nur Ausgabe. Ende des Upgrades.

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

enum (State)

Nur Ausgabe. Der aktuelle Status des Upgrades.
type

enum (Type)

Nur Ausgabe. Nur Ausgabe. Der Typ des Upgrades.
description

string

Nur Ausgabe. Nur Ausgabe. Die Beschreibung des Upgrades. Damit werden zusätzliche Informationen zum Upgrade der privaten Cloud bereitgestellt, z. B. der Zweck des Upgrades, die im Upgrade enthaltenen Änderungen oder andere relevante Informationen zum Upgrade.
estimatedDuration

string (Duration format)

Nur Ausgabe. Nur Ausgabe. Die geschätzte Gesamtdauer des Upgrades. Anhand dieser Informationen können Sie Upgrades so planen oder terminieren, dass Unterbrechungen minimiert werden. Beachten Sie, dass die geschätzte Dauer nur ein Schätzwert ist. Die tatsächliche Dauer des Upgrades kann variieren.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
schedule

object (Schedule)

Planen Sie die Details für das Upgrade.
version

string

Nur Ausgabe.

etag

string

Das ETag für die Upgrade-Ressource. Wenn es bei der Aktualisierung angegeben wird, muss es mit dem ETag des Servers übereinstimmen.
uid

string

Nur Ausgabe. Vom System generierte eindeutige Kennung für die Ressource.
componentUpgrades[]

object (VmwareUpgradeComponent)

Nur Ausgabe. Nur Ausgabe. Die Liste der Komponentenupgrades.
startVersion

string

Nur Ausgabe. Nur Ausgabe. Die Startversion
targetVersion

string

Nur Ausgabe. Nur Ausgabe. Die Zielversion

Bundesland

Mögliche Status der privaten Cloud Upgrade.

Enums
STATE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
SCHEDULED Das Upgrade ist geplant, wurde aber noch nicht gestartet.
ONGOING Das Upgrade wird gerade ausgeführt und ist noch nicht abgeschlossen.
SUCCEEDED Die Umstellung ist abgeschlossen.
PAUSED Das Upgrade ist derzeit pausiert.
FAILED Das Upgrade ist fehlgeschlagen.
CANCELLING Das Upgrade wird gerade abgebrochen.
CANCELLED Das Upgrade wurde abgebrochen.
RESCHEDULING Das Upgrade wird gerade verschoben.

Typ

Mögliche Upgradetypen. In Zukunft können weitere Typen hinzugefügt werden.

Enums
TYPE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
VSPHERE_UPGRADE Upgrade von VMware-Komponenten, wenn eine Hauptversion verfügbar ist. 7.0u2 –> 7.0u3.
VSPHERE_PATCH Patchen von VMware-Komponenten, wenn eine Nebenversion verfügbar ist. 7.0u2c –> 7.0u2d.
WORKAROUND Behelfslösungen sind Hotfixes für Sicherheitslücken oder Probleme, die angewendet werden, um die bekannte Sicherheitslücke oder das Problem zu beheben, bis ein Patch oder Update veröffentlicht wird. Die Beschreibung des Upgrades enthält weitere Informationen.
FIRMWARE_UPGRADE Firmware-Upgrade für das in der privaten Cloud verwendete VMware-Produkt.
SWITCH_UPGRADE Switch-Upgrade.
OTHER Der Upgradetyp, der in keine andere Kategorie fällt.
INFRASTRUCTURE_UPGRADE Infrastruktur-Upgrade bei der Wartung von BM-Knoten.

Zeitplan

Zeitplan für das Upgrade.

JSON-Darstellung 
{
  "startTime": string,
  "weeklyWindows": [
    {
      object (TimeWindow)
    }
  ],
  "constraints": {
    object (Constraints)
  },
  "editWindow": {
    object (Interval)
  },
  "lastEditor": enum (Editor)
}
Felder
startTime

string (Timestamp format)

Erforderlich. Die geplante Startzeit für das Upgrade.

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"
weeklyWindows[]

object (TimeWindow)

Erforderlich. Wöchentliche Zeitfenster für Upgrade-Aktivitäten. Der Server führt während dieser Zeitfenster Upgrade-Aktivitäten aus, um Störungen zu minimieren.
constraints

object (Constraints)

Nur Ausgabe. Nur Ausgabe. Einschränkungen für den Zeitplan. Diese Einschränkungen sollten zum Zeitpunkt einer Terminverschiebung gelten.
editWindow

object (Interval)

Nur Ausgabe. Nur Ausgabe. Der Zeitplan kann während dieses Zeitintervalls oder Zeitfensters bearbeitet werden.
lastEditor

enum (Editor)

Nur Ausgabe. Nur Ausgabe. Gibt an, wer den Upgrade-Zeitplan zuletzt bearbeitet hat. Der Wert wird immer dann aktualisiert, wenn das Upgrade neu geplant wird.

TimeWindow

Stellt das Zeitfenster für die Durchführung von Upgrade-Aktivitäten dar.

JSON-Darstellung 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Felder
dayOfWeek

enum (DayOfWeek)

Erforderlich. Wochentag für dieses Zeitfenster.
startTime

object (TimeOfDay)

Erforderlich. Zeit in UTC, zu der das Zeitfenster beginnt.
duration

string (Duration format)

Erforderlich. Die Dauer des Zeitfensters. Die maximal zulässige Dauer für ein beliebiges Fenster beträgt 24 Stunden.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

DayOfWeek

Steht für einen Wochentag.

Enums
DAY_OF_WEEK_UNSPECIFIED Der Wochentag ist nicht angegeben.
MONDAY Montag
TUESDAY Dienstag
WEDNESDAY Mittwoch
THURSDAY Donnerstag
FRIDAY Freitag
SATURDAY Samstag
SUNDAY Sonntag

TimeOfDay

Stellt eine Tageszeit dar. Das Datum und die Zeitzone sind entweder nicht relevant oder werden an anderer Stelle angegeben. Eine API kann Schaltsekunden zulassen. Vergleichbare Typen sind google.type.Date und google.protobuf.Timestamp.

JSON-Darstellung 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Felder
hours

integer

Stunden eines Tages im 24-Stunden-Format. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 23 sein. Eine API kann den Wert "24:00:00" für Szenarien wie Geschäftsschlusszeit zulassen.
minutes

integer

Minuten einer Stunde. Muss größer oder gleich 0 und kleiner oder gleich 59 sein.
seconds

integer

Sekunden einer Minute. Muss größer oder gleich 0 und in der Regel kleiner oder gleich 59 sein. Eine API kann den Wert 60 zulassen, wenn sie Schaltsekunden zulässt.
nanos

integer

Sekundenbruchteile in Nanosekunden. Muss größer oder gleich 0 und kleiner oder gleich 999.999.999 sein.

Einschränkungen

Einschränkungen, die beim Bearbeiten eines Zeitplans angewendet werden sollen. Diese Einschränkungen sorgen dafür, dass die Upgrade-spezifischen Anforderungen erfüllt werden.

JSON-Darstellung 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
Felder
minHoursDay

integer

Nur Ausgabe. Für die Upgrade-Aktivitäten muss für jeden ausgewählten Tag eine Mindestanzahl von Stunden eingeplant werden. Dies ist ein Mindestwert. Im Upgrade-Zeitplan können für den jeweiligen Tag mehr Stunden vorgesehen sein.
minHoursWeek

integer

Nur Ausgabe. Für die Upgrade-Aktivitäten muss eine Mindestanzahl an Wochenstunden eingeplant werden. Das ist nur ein Mindestwert. Im Zeitplan können mehr Wochenstunden zugewiesen werden.
rescheduleDateRange

object (Interval)

Nur Ausgabe. Nur Ausgabe. Der Nutzer kann nur ein Upgrade verschieben, das innerhalb dieses Zeitraums beginnt.
disallowedIntervals[]

object (WeeklyTimeInterval)

Nur Ausgabe. Nur Ausgabe. Eine Liste von Intervallen, in denen Wartungsfenster nicht zulässig sind. Alle Zeiträume, die sich mit einem dieser Intervalle überschneiden, gelten als ungültig.

Intervall

Stellt ein Zeitintervall dar, das als Zeitstempelstart (einschließlich) und Zeitstempelende (ausschließlich) codiert ist.

Der Start muss kleiner oder gleich dem Ende sein. Wenn der Start dem Ende entspricht, ist das Intervall leer (die Zeit ist null). Wenn sowohl der Start als auch das Ende nicht angegeben sind, entspricht das Intervall einer beliebigen Zeit.

JSON-Darstellung 
{
  "startTime": string,
  "endTime": string
}
Felder
startTime

string (Timestamp format)

Optional. Eingeschlossener Start des Intervalls.

Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, gleich dem Start sein oder darauf folgen.

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)

Optional. Ausgeschlossenes Ende des Intervalls.

Wenn angegeben, muss ein Zeitstempel, der diesem Intervall entspricht, vor dem Ende liegen.

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

WeeklyTimeInterval

Stellt ein Zeitintervall dar, das sich über mehrere Wochentage erstreckt. Bis lokale Zeitzonen unterstützt werden, wird dieses Intervall in UTC angegeben.

JSON-Darstellung 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
Felder
startDay

enum (DayOfWeek)

Nur Ausgabe. Der Tag, an dem das Intervall beginnt.
startTime

object (TimeOfDay)

Nur Ausgabe. Die Uhrzeit am Starttag, zu der das Intervall beginnt.
endDay

enum (DayOfWeek)

Nur Ausgabe. Der Tag, an dem das Intervall endet. Kann mit dem Starttag identisch sein.
endTime

object (TimeOfDay)

Nur Ausgabe. Die Uhrzeit am Enddatum, zu der das Intervall endet.

Editor

Mögliche Werte für „Wer hat den Upgrade-Zeitplan bearbeitet?“ Der Wert identifiziert Gruppen oder Einheiten anstelle von Einzelpersonen.

Enums
EDITOR_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
SYSTEM Das Upgrade wird vom System oder einem internen Dienst geplant.
USER Das Upgrade wird vom Endnutzer geplant.

VmwareUpgradeComponent

Ressource für das Upgrade pro Komponente

JSON-Darstellung 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
Felder
componentType

enum (VmwareComponentType)

Nur Ausgabe. Komponententyp
state

enum (State)

Nur Ausgabe. Upgrade-Status der Komponente.

VmwareComponentType

Der Typ der VMware-Komponente

Enums
VMWARE_COMPONENT_TYPE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
VCENTER vcenter
ESXI ESXi-Knoten + Transportknoten
NSXT_UC nsxt-Upgradekoordinator
NSXT_EDGE NSX-T-Edge-Cluster
NSXT_MGR NSXT-Manager/Verwaltungsebene
HCX hcx
VSAN VSAN-Cluster
DVS DVS-Schalter
NAMESERVER_VM Nameserver-VMs
KMS_VM Für die vSAN-Verschlüsselung verwendete KMS-VM
WITNESS_VM Witness-VM bei Stretch-PC
NSXT nsxt
CLUSTER Cluster wird bei weitgehend passenden Keywords verwendet
VM_TOOLS VMware-Tools

Bundesland

„State“ definiert den aktuellen Status eines Upgrades.

Enums
STATE_UNSPECIFIED Der Standardwert. Dieser Wert sollte niemals verwendet werden.
RUNNING Upgrade der Komponente läuft
PAUSED Das Upgrade der Komponente ist pausiert. Wird fortgesetzt, wenn der Upgrade-Job fortgesetzt wird
SUCCEEDED Das Upgrade der Komponente wurde abgeschlossen.
FAILED Das Upgrade der Komponente ist fehlgeschlagen. Wird zu „Fortsetzen“ geändert, wenn das Upgrade fortgesetzt wird, oder bleibt unverändert
NOT_STARTED Das Upgrade der Komponente wurde noch nicht gestartet
NOT_APPLICABLE Das Upgrade der Komponente ist bei diesem Upgrade nicht anwendbar. Sie wird übersprungen.

Methoden

get

 Ruft eine Upgrade-Ressource für eine private Cloud anhand ihres Ressourcennamens ab.

list

 Listet vergangene, laufende und anstehende Upgrades für die angegebene private Cloud auf.

patch

 Aktualisieren Sie die Upgrade-Ressource der privaten Cloud.