REST Resource: projects.locations.privateClouds.upgrades

Risorsa: Upgrade

Descrive l'upgrade del cloud privato.

Rappresentazione JSON 
{
  "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
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa del cloud privato Upgrade. I nomi delle risorse sono URI senza schema che seguono le convenzioni riportate in https://cloud.google.com/apis/design/resource_names. Ad esempio: projects/my-project/locations/us-west1-a/privateClouds/my-cloud/upgrades/my-upgrade.
createTime

string (Timestamp format)

Solo output. Solo output. Data e ora 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. Solo output. Data e ora dell'ultimo aggiornamento di questa 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".
endTime

string (Timestamp format)

Solo output. Solo output. Ora di fine dell'upgrade.

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

enum (State)

Solo output. Lo stato attuale dell'upgrade.
type

enum (Type)

Solo output. Solo output. Il tipo di upgrade.
description

string

Solo output. Solo output. La descrizione dell'upgrade. Queste informazioni vengono utilizzate per fornire dettagli aggiuntivi sull'upgrade del cloud privato, ad esempio lo scopo dell'upgrade, le modifiche incluse o qualsiasi altra informazione pertinente.
estimatedDuration

string (Duration format)

Solo output. Solo output. La durata totale stimata dell'upgrade. Queste informazioni possono essere utilizzate per pianificare o programmare gli upgrade in modo da ridurre al minimo le interruzioni. Tieni presente che la durata stimata è solo una stima. La durata effettiva dell'upgrade può variare.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
schedule

object (Schedule)

Dettagli della pianificazione dell'upgrade.
version

string

Solo output.

etag

string

L'etag per la risorsa di upgrade. Se fornito durante l'aggiornamento, deve corrispondere all'etag del server.
uid

string

Solo output. Identificatore univoco generato dal sistema per la risorsa.
componentUpgrades[]

object (VmwareUpgradeComponent)

Solo output. Solo output. L'elenco degli upgrade dei componenti.
startVersion

string

Solo output. Solo output. La versione iniziale
targetVersion

string

Solo output. Solo output. La versione di destinazione

Stato

Stati possibili del cloud privato Upgrade.

Enum
STATE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
SCHEDULED L'upgrade è pianificato, ma non è ancora iniziato.
ONGOING L'upgrade è attualmente in corso e non è ancora stato completato.
SUCCEEDED L'upgrade è stato completato correttamente.
PAUSED L'upgrade è attualmente in pausa.
FAILED L'upgrade non è riuscito.
CANCELLING L'upgrade è in fase di annullamento.
CANCELLED L'upgrade è stato annullato.
RESCHEDULING L'upgrade è in fase di riprogrammazione.

Tipo

Possibili tipi di upgrade. In futuro potranno essere aggiunti altri tipi.

Enum
TYPE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
VSPHERE_UPGRADE Upgrade dei componenti VMware quando è disponibile una versione principale. 7.0u2 -> 7.0u3.
VSPHERE_PATCH Applicazione di patch ai componenti VMware quando è disponibile una versione secondaria. 7.0u2c -> 7.0u2d.
WORKAROUND Le soluzioni alternative sono correzioni rapide per vulnerabilità o problemi applicate per mitigare la vulnerabilità o il problema noto fino al rilascio di una patch o di un aggiornamento. La descrizione dell'upgrade conterrà ulteriori dettagli.
FIRMWARE_UPGRADE Aggiornamento del firmware per il prodotto VMware utilizzato nel cloud privato.
SWITCH_UPGRADE Cambia upgrade.
OTHER Il tipo di upgrade che non rientra in nessun'altra categoria.
INFRASTRUCTURE_UPGRADE Upgrade dell'infrastruttura durante la manutenzione dei nodi BM.

Pianifica

Pianifica l'upgrade.

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

string (Timestamp format)

Obbligatorio. L'ora di inizio pianificata per l'upgrade.

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

object (TimeWindow)

Obbligatorio. Finestre temporali settimanali per le attività di upgrade. Il server esegue le attività di upgrade durante questi periodi di tempo per ridurre al minimo le interruzioni.
constraints

object (Constraints)

Solo output. Solo output. Vincoli applicati alla pianificazione. Questi vincoli devono essere applicabili al momento di qualsiasi riprogrammazione.
editWindow

object (Interval)

Solo output. Solo output. Il programma è aperto alle modifiche durante questo intervallo di tempo o finestra.
lastEditor

enum (Editor)

Solo output. Solo output. Indica chi ha modificato più di recente la pianificazione dell'upgrade. Il valore viene aggiornato ogni volta che l'upgrade viene riprogrammato.

TimeWindow

Rappresenta la finestra temporale per eseguire le attività di upgrade.

Rappresentazione JSON 
{
  "dayOfWeek": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "duration": string
}
Campi
dayOfWeek

enum (DayOfWeek)

Obbligatorio. Giorno della settimana per questa finestra.
startTime

object (TimeOfDay)

Obbligatorio. Ora in UTC in cui inizia la finestra.
duration

string (Duration format)

Obbligatorio. La durata della finestra. La durata massima consentita per qualsiasi finestra è di 24 ore.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY Mercoledì
THURSDAY Giovedì
FRIDAY Venerdì
SATURDAY Sabato
SUNDAY Domenica

TimeOfDay

Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire i secondi intercalari. I tipi correlati sono google.type.Date e google.protobuf.Timestamp.

Rappresentazione JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Campi
hours

integer

Ore di un giorno nel formato 24 ore. Deve essere maggiore o uguale a 0 e in genere deve essere minore o uguale a 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività.
minutes

integer

Minuti di un'ora. Deve essere maggiore o uguale a 0 e minore o uguale a 59.
seconds

integer

Secondi di un minuto. Deve essere maggiore o uguale a 0 e in genere minore o uguale a 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari.
nanos

integer

Frazioni di secondi, in nanosecondi. Deve essere maggiore o uguale a 0 e minore o uguale a 999.999.999.

Vincoli

Vincoli da applicare durante la modifica di una pianificazione. Questi vincoli garantiscono il rispetto dei requisiti specifici di Upgrade.

Rappresentazione JSON 
{
  "minHoursDay": integer,
  "minHoursWeek": integer,
  "rescheduleDateRange": {
    object (Interval)
  },
  "disallowedIntervals": [
    {
      object (WeeklyTimeInterval)
    }
  ]
}
Campi
minHoursDay

integer

Solo output. Per ogni giorno selezionato deve essere assegnato un numero minimo di ore per le attività di upgrade. Questo è un minimo; la pianificazione dell'upgrade può prevedere più ore per il giorno specificato.
minHoursWeek

integer

Solo output. Il numero minimo di ore settimanali deve essere assegnato alle attività di upgrade. Questo è solo un minimo; il programma può assegnare più ore settimanali.
rescheduleDateRange

object (Interval)

Solo output. Solo output. L'utente può riprogrammare solo un upgrade che inizia in questo intervallo.
disallowedIntervals[]

object (WeeklyTimeInterval)

Solo output. Solo output. Un elenco di intervalli in cui non sono consentiti periodi di manutenzione. Qualsiasi finestra temporale che si sovrappone a uno di questi intervalli verrà considerata non valida.

Intervallo

Rappresenta un intervallo di tempo, codificato come timestamp di inizio (incluso) e timestamp di fine (escluso).

L'inizio deve essere inferiore o uguale alla fine. Se l'inizio è uguale alla fine, l'intervallo è vuoto (non corrisponde a nessun orario). Se non vengono specificati né l'inizio né la fine, l'intervallo corrisponde a qualsiasi orario.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string
}
Campi
startTime

string (Timestamp format)

Facoltativo. Inizio inclusivo dell'intervallo.

Se specificato, un timestamp corrispondente a questo intervallo dovrà essere uguale o successivo all'inizio.

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

string (Timestamp format)

Facoltativo. Fine esclusiva dell'intervallo.

Se specificato, un timestamp corrispondente a questo intervallo dovrà essere precedente alla fine.

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

WeeklyTimeInterval

Rappresenta un intervallo di tempo che si estende su più giorni della settimana. Finché non saranno supportati i fusi orari locali, questo intervallo sarà in formato UTC.

Rappresentazione JSON 
{
  "startDay": enum (DayOfWeek),
  "startTime": {
    object (TimeOfDay)
  },
  "endDay": enum (DayOfWeek),
  "endTime": {
    object (TimeOfDay)
  }
}
Campi
startDay

enum (DayOfWeek)

Solo output. Il giorno in cui inizia l'intervallo.
startTime

object (TimeOfDay)

Solo output. L'ora del giorno di inizio dell'intervallo.
endDay

enum (DayOfWeek)

Solo output. Il giorno in cui termina l'intervallo. Può essere uguale al giorno di inizio.
endTime

object (TimeOfDay)

Solo output. L'ora del giorno finale in cui termina l'intervallo.

Editor

I valori possibili di Chi ha modificato la pianificazione dell'upgrade identificano gruppi o entità anziché singoli individui.

Enum
EDITOR_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
SYSTEM L'upgrade è pianificato dal sistema o dal servizio interno.
USER L'upgrade è pianificato dall'utente finale.

VmwareUpgradeComponent

Risorsa di upgrade per componente

Rappresentazione JSON 
{
  "componentType": enum (VmwareComponentType),
  "state": enum (State)
}
Campi
componentType

enum (VmwareComponentType)

Solo output. Tipo di componente
state

enum (State)

Solo output. Stato dell'upgrade del componente.

VmwareComponentType

Il tipo di componente VMware

Enum
VMWARE_COMPONENT_TYPE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
VCENTER vcenter
ESXI nodi ESXi + nodi di trasporto
NSXT_UC nsxt upgrade coordinator
NSXT_EDGE nsxt edges cluster
NSXT_MGR nsxt managers/management plane
HCX hcx
VSAN Cluster VSAN
DVS Interruttore DVS
NAMESERVER_VM VM nameserver
KMS_VM VM KMS utilizzata per la crittografia vSAN
WITNESS_VM VM replica in caso di PC esteso
NSXT nsxt
CLUSTER Il cluster viene utilizzato in caso di corrispondenza generica
VM_TOOLS Strumenti VMware.

Stato

State definisce lo stato attuale di un upgrade

Enum
STATE_UNSPECIFIED Il valore predefinito. Questo valore non deve mai essere utilizzato.
RUNNING L'upgrade del componente è in corso
PAUSED L'upgrade del componente è in pausa. Verrà ripreso alla ripresa del job di upgrade
SUCCEEDED L'upgrade del componente è stato completato correttamente
FAILED L'upgrade del componente non è riuscito. Questo stato verrà ripristinato se l'upgrade viene ripreso o rimarrà invariato
NOT_STARTED L'upgrade del componente non è ancora iniziato
NOT_APPLICABLE L'upgrade del componente non è applicabile in questo upgrade. Verrà saltato.

Metodi

get

 Recupera una risorsa Upgrade del cloud privato in base al nome della risorsa.

list

 Elenca i Upgrades passati, in corso e futuri per il cloud privato specificato.

patch

 Aggiorna la risorsa Upgrade del cloud privato.