REST Resource: projects.locations.instances

Risorsa: Instance

La definizione di un'istanza di notebook.

Rappresentazione JSON 
{
  "name": string,
  "proxyUri": string,
  "instanceOwners": [
    string
  ],
  "creator": string,
  "state": enum (State),
  "upgradeHistory": [
    {
      object (UpgradeHistoryEntry)
    }
  ],
  "id": string,
  "healthState": enum (HealthState),
  "healthInfo": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "disableProxyAccess": boolean,
  "labels": {
    string: string,
    ...
  },
  "thirdPartyProxyUrl": string,
  "satisfiesPzs": boolean,
  "satisfiesPzi": boolean,
  "enableThirdPartyIdentity": boolean,
  "enableManagedEuc": boolean,
  "enableDeletionProtection": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "gceSetup": {
    object (GceSetup)
  }
  // End of mutually exclusive fields.
}
Campi
name

string

Solo output. Identificatore. Il nome di questa istanza del notebook. Formato: projects/{projectId}/locations/{location}/instances/{instanceId}
proxyUri

string

Solo output. L'endpoint proxy utilizzato per accedere al notebook Jupyter.
instanceOwners[]

string

Facoltativo. Il proprietario di questa istanza dopo la creazione. Formato: alias@example.com

Al momento supporta un solo proprietario. Se non specificato, tutti gli utenti del account di servizio della tua istanza VM possono utilizzare l'istanza.
creator

string

Solo output. Indirizzo email dell'entità che ha inviato la richiesta instances.create originale.
state

enum (State)

Solo output. Lo stato di questa istanza.
upgradeHistory[]

object (UpgradeHistoryEntry)

Solo output. La cronologia degli upgrade di questa istanza.
id

string

Solo output. ID univoco della risorsa.
healthState

enum (HealthState)

Solo output. instance.healthState
healthInfo

map (key: string, value: string)

Solo output. Informazioni aggiuntive sull'integrità dell'istanza. Esempio:

healthInfo": {
  "docker_proxy_agent_status": "1",
  "docker_status": "1",
  "jupyterlab_api_status": "-1",
  "jupyterlab_status": "-1",
  "updated": "2020-10-18 09:40:03.573409"
}

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

Solo output. Ora di creazione dell'istanza.

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. Ora di aggiornamento dell'istanza.

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

boolean

Facoltativo. Se il valore è true, l'istanza del blocco note non verrà registrata con il proxy.
labels

map (key: string, value: string)

Facoltativo. Etichette da applicare a questa istanza. Questi valori possono essere modificati in un secondo momento con il metodo instances.patch.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
thirdPartyProxyUrl

string

Solo output. L'endpoint proxy dei pool di forza lavoro utilizzato per accedere al blocco note Jupyter.
satisfiesPzs

boolean

Solo output. Riservato per uso futuro per la separazione delle zone.
satisfiesPzi

boolean

Solo output. Riservato per uso futuro per l'isolamento delle zone.
enableThirdPartyIdentity

boolean

Facoltativo. Flag che specifica che è possibile accedere a un blocco note con un provider di identità di terze parti.
enableManagedEuc

boolean

Facoltativo. Flag per abilitare le credenziali utente finale gestite per l'istanza.
enableDeletionProtection

boolean

Facoltativo. Se è true, la protezione da eliminazione verrà attivata per questa istanza di Workbench. Se è false, la protezione da eliminazione verrà disattivata per questa istanza di Workbench.
Configurazione dell'istanza del notebook. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
gceSetup

object (GceSetup)

Facoltativo. Configurazione di Compute Engine per il notebook. Utilizza i campi definiti nel blocco note.
Fine dei campi che si escludono a vicenda.

GceSetup

La definizione di come configurare un'istanza VM al di fuori di Risorse e identità.

Rappresentazione JSON 
{
  "machineType": string,
  "minCpuPlatform": string,
  "acceleratorConfigs": [
    {
      object (AcceleratorConfig)
    }
  ],
  "serviceAccounts": [
    {
      object (ServiceAccount)
    }
  ],
  "bootDisk": {
    object (BootDisk)
  },
  "dataDisks": [
    {
      object (DataDisk)
    }
  ],
  "shieldedInstanceConfig": {
    object (ShieldedInstanceConfig)
  },
  "networkInterfaces": [
    {
      object (NetworkInterface)
    }
  ],
  "disablePublicIp": boolean,
  "tags": [
    string
  ],
  "metadata": {
    string: string,
    ...
  },
  "systemMetadata": {
    string: string,
    ...
  },
  "enableIpForwarding": boolean,
  "gpuDriverConfig": {
    object (GPUDriverConfig)
  },
  "confidentialInstanceConfig": {
    object (ConfidentialInstanceConfig)
  },
  "instanceId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "vmImage": {
    object (VmImage)
  },
  "containerImage": {
    object (ContainerImage)
  }
  // End of mutually exclusive fields.
}
Campi
machineType

string

Facoltativo. Il tipo di macchina dell'istanza VM. https://cloud.google.com/compute/docs/machine-resource
minCpuPlatform

string

Facoltativo. La piattaforma CPU minima da utilizzare per questa istanza. L'elenco dei valori validi è disponibile all'indirizzo https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform#availablezones
acceleratorConfigs[]

object (AcceleratorConfig)

Facoltativo. Gli acceleratori hardware utilizzati in questa istanza. Se utilizzi acceleratori, assicurati che la configurazione disponga di vCPU e memoria sufficienti per supportare l'machineType che hai selezionato. Al momento supporta solo una configurazione dell'acceleratore.
serviceAccounts[]

object (ServiceAccount)

Facoltativo. Il account di servizio che funge da identità per l'istanza VM. Al momento supporta un solo account di servizio.
bootDisk

object (BootDisk)

Facoltativo. Il disco di avvio della VM.
dataDisks[]

object (DataDisk)

Facoltativo. Dischi di dati collegati all'istanza VM. Al momento supporta solo un disco di dati.
shieldedInstanceConfig

object (ShieldedInstanceConfig)

Facoltativo. Configurazione di Shielded VM. Immagini che utilizzano le funzionalità Shielded VM supportate.
networkInterfaces[]

object (NetworkInterface)

Facoltativo. Le interfacce di rete per la VM. Supporta una sola interfaccia.
disablePublicIp

boolean

Facoltativo. Se è true, a questa istanza VM non verrà assegnato alcun IP esterno.
tags[]

string

Facoltativo. I tag di rete Compute Engine da aggiungere al runtime (vedi Aggiungere tag di rete).
metadata

map (key: string, value: string)

Facoltativo. Metadati personalizzati da applicare a questa istanza.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
systemMetadata

map (key: string, value: string)

Solo output. Rappresenta i metadati gestiti dal sistema per questa istanza: il sottoinsieme di metadata le cui chiavi sono chiavi di sistema Workbench riconosciute.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
enableIpForwarding

boolean

Facoltativo. Flag per attivare o meno l'inoltro IP, valore predefinito false/off. https://cloud.google.com/vpc/docs/using-routes#canipforward
gpuDriverConfig

object (GPUDriverConfig)

Facoltativo. Configurazione dei driver GPU.
confidentialInstanceConfig

object (ConfidentialInstanceConfig)

Facoltativo. Configurazione dell'istanza confidenziale.
instanceId

string

Solo output. L'ID univoco della risorsa istanza Compute Engine.
Tipo di immagine; può essere un'immagine VM o un'immagine container. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
vmImage

object (VmImage)

Facoltativo. Utilizza un'immagine VM di Compute Engine per avviare l'istanza notebook.
containerImage

object (ContainerImage)

Facoltativo. Utilizza un'immagine container per avviare l'istanza del notebook.
Fine dei campi che si escludono a vicenda.

AcceleratorConfig

Una configurazione dell'acceleratore per una definizione di istanza VM di un acceleratore hardware. Tieni presente che non viene eseguito alcun controllo sulle combinazioni di type e coreCount. Le TPU non sono supportate. Consulta la sezione GPU su Compute Engine per trovare una combinazione valida.

Rappresentazione JSON 
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
Campi
type

enum (AcceleratorType)

Facoltativo. Tipo di questo acceleratore.
coreCount

string (int64 format)

Facoltativo. Conteggio dei core di questo acceleratore.

AcceleratorType

Definizione dei tipi di acceleratori hardware che possono essere utilizzati in questa istanza.

Enum
ACCELERATOR_TYPE_UNSPECIFIED Il tipo di acceleratore non è specificato.
NVIDIA_TESLA_P100

Deprecato: utilizza NVIDIA_TESLA_T4 (N1) o NVIDIA_L4 (G2). La GPU NVIDIA Tesla P100 è in fase di ritiro a livello di flotta da parte di Compute Engine e non è più disponibile per le nuove istanze.
NVIDIA_TESLA_V100 Il tipo di acceleratore è Nvidia Tesla V100.
NVIDIA_TESLA_P4 Il tipo di acceleratore è Nvidia Tesla P4.
NVIDIA_TESLA_T4 Il tipo di acceleratore è Nvidia Tesla T4.
NVIDIA_TESLA_A100 Il tipo di acceleratore è Nvidia Tesla A100 - 40 GB.
NVIDIA_A100_80GB Il tipo di acceleratore è Nvidia Tesla A100 - 80 GB.
NVIDIA_L4 Il tipo di acceleratore è Nvidia Tesla L4.
NVIDIA_H100_80GB Il tipo di acceleratore è Nvidia Tesla H100 - 80 GB.
NVIDIA_H100_MEGA_80GB Il tipo di acceleratore è Nvidia Tesla H100 - MEGA 80 GB.
NVIDIA_H200_141GB Il tipo di acceleratore è Nvidia Tesla H200 - 141 GB.
NVIDIA_TESLA_T4_VWS Il tipo di acceleratore è workstation virtuali NVIDIA Tesla T4.
NVIDIA_TESLA_P100_VWS

Deprecato: utilizza NVIDIA_TESLA_T4_VWS. La GPU NVIDIA Tesla P100 (workstation virtuali) verrà ritirata a livello di flotta da Compute Engine e non è più disponibile per le nuove istanze.
NVIDIA_TESLA_P4_VWS Il tipo di acceleratore è workstation virtuali NVIDIA Tesla P4.
NVIDIA_B200 Il tipo di acceleratore è NVIDIA B200.
NVIDIA_RTX6000 NVIDIA RTX 6000.

ServiceAccount

Un account di servizio che funge da identità.

Rappresentazione JSON 
{
  "email": string,
  "scopes": [
    string
  ]
}
Campi
email

string

Facoltativo. Indirizzo email del account di servizio.
scopes[]

string

Solo output. L'elenco degli ambiti da rendere disponibili per questo account di servizio. Impostato dal CLH su https://www.googleapis.com/auth/cloud-platform

VmImage

Definizione di un'immagine di macchina virtuale Compute Engine personalizzata per avviare un'istanza notebook con l'ambiente installato direttamente sulla VM.

Rappresentazione JSON 
{
  "project": string,
  "imageDescription": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "name": string,
  "family": string
  // End of mutually exclusive fields.
}
Campi
project

string

Obbligatorio. Il nome del progetto Google Cloud a cui appartiene questa immagine VM. Formato: {projectId}
imageDescription

string

Solo output. Una descrizione leggibile da una persona dell'immagine in esecuzione sull'istanza (ad esempio "Debian 11, Python 3.10"), derivata al momento della lettura dalla configurazione di rilascio dell'immagine (l'origine della verità). Imposta "Personalizzato" per le immagini del disco di avvio non riconosciute.
Il riferimento a un'immagine VM Compute Engine esterna. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
name

string

Facoltativo. Utilizza il nome dell'immagine VM per trovare l'immagine.
family

string

Facoltativo. Utilizza questa famiglia di immagini VM per trovare l'immagine. Verrà utilizzata l'immagine più recente di questa famiglia.
Fine dei campi che si escludono a vicenda.

ContainerImage

Definizione di un'immagine container per avviare un'istanza notebook con l'ambiente installato in un container.

Rappresentazione JSON 
{
  "repository": string,
  "tag": string
}
Campi
repository

string

Obbligatorio. Il percorso del repository dell'immagine container. Ad esempio: gcr.io/{projectId}/{imageName}
tag

string

Facoltativo. Il tag dell'immagine container. Se non specificato, il valore predefinito è l'ultimo tag.

BootDisk

La definizione di un disco di avvio.

Rappresentazione JSON 
{
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string
}
Campi
diskSizeGb

string (int64 format)

Facoltativo. La dimensione del disco di avvio in GB collegato a questa istanza, fino a un massimo di 64.000 GB (64 TB). Se non specificato, il valore predefinito è il valore consigliato di 150 GB.
diskType

enum (DiskType)

Facoltativo. Indica il tipo di disco.
diskEncryption

enum (DiskEncryption)

Facoltativo. Metodo di crittografia del disco utilizzato sui dischi di avvio e dati, il valore predefinito è GMEK.
kmsKey

string

Facoltativo. La chiave KMS utilizzata per criptare i dischi, applicabile solo se diskEncryption è CMEK. Formato: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

Scopri di più sull'utilizzo delle tue chiavi di crittografia.

DiskType

Tipi di disco possibili.

Enum
DISK_TYPE_UNSPECIFIED Tipo di disco non impostato.
PD_STANDARD Tipo di Standard disco permanente.
PD_SSD Tipo di disco permanente SSD.
PD_BALANCED Tipo di disco permanente bilanciato.
PD_EXTREME Tipo di disco permanente con carico estremo.
HYPERDISK_BALANCED Rappresenta il tipo di disco permanente Hyperdisk Balanced. Può essere utilizzato come disco di avvio o disco di dati.
HYPERDISK_EXTREME Rappresenta il tipo di disco permanente Hyperdisk Extreme. Può essere utilizzato solo come disco di dati.
HYPERDISK_THROUGHPUT Rappresenta il tipo di disco permanente Hyperdisk Throughput. Può essere utilizzato solo come disco di dati.
HYPERDISK_BALANCED_HIGH_AVAILABILITY Rappresenta il tipo di disco permanente Hyperdisk Balanced High Availability. Può essere utilizzato come disco di avvio o disco di dati.
HYPERDISK_ML Rappresenta il tipo di disco permanente Hyperdisk ML. Può essere utilizzato come disco di avvio o disco di dati.

DiskEncryption

Definizione delle opzioni di crittografia del disco.

Enum
DISK_ENCRYPTION_UNSPECIFIED La crittografia del disco non è specificata.
GMEK Utilizza le chiavi di crittografia gestite da Google per criptare il disco di avvio.
CMEK Utilizza le chiavi di crittografia gestite dal cliente per criptare il disco di avvio.

DataDisk

Una risorsa disco collegata all'istanza.

Rappresentazione JSON 
{
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string,
  "resourcePolicies": [
    string
  ]
}
Campi
diskSizeGb

string (int64 format)

Facoltativo. Le dimensioni del disco in GB collegato a questa istanza VM, fino a un massimo di 64.000 GB (64 TB). Se non specificato, il valore predefinito è 100.
diskType

enum (DiskType)

Facoltativo. Indica il tipo di disco.
diskEncryption

enum (DiskEncryption)

Facoltativo. Metodo di crittografia del disco utilizzato sui dischi di avvio e dati, il valore predefinito è GMEK.
kmsKey

string

Facoltativo. La chiave KMS utilizzata per criptare i dischi, applicabile solo se diskEncryption è CMEK. Formato: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

Scopri di più sull'utilizzo delle tue chiavi di crittografia.
resourcePolicies[]

string

Facoltativo. Le policy delle risorse da applicare al disco di dati.

ShieldedInstanceConfig

Un insieme di opzioni di istanza schermata. Consulta Immagini che utilizzano le funzionalità Shielded VM supportate. Non tutte le combinazioni sono valide.

Rappresentazione JSON 
{
  "enableSecureBoot": boolean,
  "enableVtpm": boolean,
  "enableIntegrityMonitoring": boolean
}
Campi
enableSecureBoot

boolean

Facoltativo. Definisce se l'istanza VM ha l'avvio protetto abilitato.

Avvio protetto contribuisce ad assicurare che il sistema esegua solo software autentici verificando la firma digitale di tutti i componenti di avvio e interrompendo il processo di avvio se la firma non supera la verifica. Disattivato per impostazione predefinita.
enableVtpm

boolean

Facoltativo. Definisce se la vTPM è abilitata per l'istanza VM.
enableIntegrityMonitoring

boolean

Facoltativo. Definisce se il monitoraggio dell'integrità è abilitato per l'istanza VM.

Consente il monitoraggio e l'attestazione dell'integrità in fase di avvio dell'istanza VM. L'attestazione viene eseguita rispetto alla base di riferimento dei criteri di integrità. Questa baseline viene inizialmente derivata dall'immagine di avvio implicitamente attendibile al momento della creazione dell'istanza VM.

NetworkInterface

La definizione di una risorsa di interfaccia di rete collegata a una VM.

Rappresentazione JSON 
{
  "network": string,
  "subnet": string,
  "nicType": enum (NicType),
  "accessConfigs": [
    {
      object (AccessConfig)
    }
  ],
  "internalIp": string
}
Campi
network

string

Facoltativo. Il nome del VPC in cui si trova questa istanza VM. Formato: projects/{projectId}/global/networks/{network_id}
subnet

string

Facoltativo. Il nome della subnet in cui si trova questa istanza VM. Formato: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
nicType

enum (NicType)

Facoltativo. Il tipo di vNIC da utilizzare su questa interfaccia. Può essere gVNIC o VirtioNet.
accessConfigs[]

object (AccessConfig)

Facoltativo. Un array di configurazioni per questa interfaccia. Al momento è supportata solo una configurazione di accesso, ONE_TO_ONE_NAT. Se non viene specificato alcun accessConfigs, l'istanza avrà un accesso a internet esterno tramite un indirizzo IP esterno temporaneo.
internalIp

string

Facoltativo. Un indirizzo IP interno associato a questa istanza. Specifica un indirizzo IP interno statico non utilizzato disponibile per la subnet in cui si trova questa istanza o lascia questo campo non definito per utilizzare un IP dall'intervallo temporaneo della subnet.

NicType

Il tipo di driver vNIC. Il valore predefinito deve essere NIC_TYPE_UNSPECIFIED.

Enum
NIC_TYPE_UNSPECIFIED Nessun tipo specificato.
VIRTIO_NET VIRTIO
GVNIC gVNIC

AccessConfig

Una configurazione di accesso collegata all'interfaccia di rete di un'istanza.

Rappresentazione JSON 
{
  "externalIp": string
}
Campi
externalIp

string

Facoltativo. Un indirizzo IP esterno associato a questa istanza. Specifica un indirizzo IP esterno statico non utilizzato disponibile per il progetto o lascia questo campo non definito per utilizzare un IP da un pool condiviso di indirizzi IP temporanei. Se specifichi un indirizzo IP esterno statico, questo deve trovarsi nella stessa regione della zona dell'istanza.

GPUDriverConfig

Una configurazione del driver GPU

Rappresentazione JSON 
{
  "enableGpuDriver": boolean,
  "customGpuDriverPath": string
}
Campi
enableGpuDriver

boolean

Facoltativo. Indica se l'utente finale autorizza Google Cloud a installare il driver della GPU su questa istanza VM. Se questo campo è vuoto o impostato su false, il driver della GPU non verrà installato. Applicabile solo alle istanze con GPU.
customGpuDriverPath

string

Facoltativo. Specifica un percorso Cloud Storage personalizzato in cui è archiviato il driver della GPU. Se non specificati, sceglieremo automaticamente tra i driver GPU ufficiali.

ConfidentialInstanceConfig

Un insieme di opzioni per le istanze confidenziali.

Rappresentazione JSON 
{
  "confidentialInstanceType": enum (ConfidentialInstanceType)
}
Campi
confidentialInstanceType

enum (ConfidentialInstanceType)

Facoltativo. Definisce il tipo di tecnologia utilizzata dall'istanza confidenziale.

ConfidentialInstanceType

Il tipo di istanza confidenziale.

Enum
CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED Nessun tipo specificato. Non utilizzare questo valore.
SEV AMD Secure Encrypted Virtualization.

Stato

La definizione degli stati di questa istanza.

Enum
STATE_UNSPECIFIED Lo stato non è specificato.
STARTING La logica di controllo sta avviando l'istanza.
PROVISIONING La logica di controllo installa i framework richiesti e registra l'istanza con il proxy del notebook
ACTIVE L'istanza è in esecuzione.
STOPPING La logica di controllo sta arrestando l'istanza.
STOPPED L'istanza è stata arrestata.
DELETED L'istanza è stata eliminata.
UPGRADING È in corso l'upgrade dell'istanza.
INITIALIZING L'istanza è in fase di creazione.
SUSPENDING L'istanza è in fase di sospensione.
SUSPENDED L'istanza è sospesa.
ORPHANED L'istanza non ha una VM. Un upgrade ha rimosso l'originale e non è stato possibile creare la sostituzione. Il disco di dati e gli eventuali snapshot sono intatti. Riprova l'upgrade per completarlo o esegui il rollback dell'istanza allo snapshot acquisito prima dell'inizio.

UpgradeHistoryEntry

La voce della cronologia degli upgrade delle immagini VM.

Rappresentazione JSON 
{
  "snapshot": string,
  "vmImage": string,
  "containerImage": string,
  "framework": string,
  "version": string,
  "state": enum (State),
  "createTime": string,
  "action": enum (Action),
  "targetVersion": string
}
Campi
snapshot

string

Facoltativo. Lo snapshot del disco di avvio di questa istanza notebook prima dell'upgrade.
vmImage

string

Facoltativo. L'immagine VM prima dell'upgrade di questa istanza.
containerImage

string

Facoltativo. L'immagine container prima dell'upgrade di questa istanza.
framework

string

Facoltativo. Il framework di questa istanza notebook.
version

string

Facoltativo. La versione dell'istanza notebook prima di questo upgrade.
state

enum (State)

Solo output. Lo stato di questa voce della cronologia degli upgrade dell'istanza.
createTime

string (Timestamp format)

Immutabile. L'ora in cui viene creata questa voce della cronologia di upgrade dell'istanza.

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

enum (Action)

Facoltativo. Azione. Esegui il rollback o l'upgrade.
targetVersion

string

Facoltativo. Versione della VM di destinazione, ad esempio m63.

Stato

La definizione degli stati di questa voce della cronologia degli upgrade.

Enum
STATE_UNSPECIFIED Lo stato non è specificato.
STARTED È stato avviato l'upgrade dell'istanza.
SUCCEEDED L'upgrade dell'istanza è stato completato.
FAILED L'upgrade dell'istanza non è riuscito.

Azione

La definizione delle operazioni di questa voce della cronologia degli upgrade.

Enum
ACTION_UNSPECIFIED L'operazione non è specificata.
UPGRADE Fai l'upgrade.
ROLLBACK Rollback.

HealthState

Lo stato di integrità dell'istanza.

Enum
HEALTH_STATE_UNSPECIFIED Il sottostato dell'istanza è sconosciuto.
HEALTHY È noto che l'istanza è in stato integro (ad esempio, i daemon critici sono in esecuzione). Si applica allo stato ACTIVE.
UNHEALTHY È noto che l'istanza è in uno stato non integro (ad esempio, i daemon critici non sono in esecuzione). Si applica allo stato ATTIVO.
AGENT_NOT_INSTALLED L'istanza non ha installato l'agente di monitoraggio dell'integrità. Si applica allo stato ATTIVO.
AGENT_NOT_RUNNING L'agente di monitoraggio dell'integrità dell'istanza non è in esecuzione. Si applica allo stato ATTIVO.

Metodi

checkUpgradability

 Controlla se un'istanza notebook è aggiornabile.

create

 Crea una nuova istanza in un progetto e una località specifici.

delete

 Elimina una singola istanza.

diagnose

 Crea un file di diagnostica ed esegue lo strumento di diagnostica per una determinata istanza.

get

 Recupera i dettagli di una singola istanza.

getConfig

 Restituisce vari parametri di configurazione.

getIamPolicy

 Recupera la policy di controllo dell'accesso per una risorsa.

list

 Elenca le istanze in un progetto e una località specifici.

patch

 UpdateInstance aggiorna un'istanza.

reset

 Reimposta un'istanza di notebook.

resizeDisk

 Ridimensiona un disco dell'istanza notebook a una capacità superiore.

restore

 RestoreInstance ripristina un'istanza da un BackupSource.

rollback

 Esegue il rollback di un'istanza notebook alla versione precedente.

setIamPolicy

 Imposta la policy di controllo dell'accesso sulla risorsa specificata.

start

 Avvia un'istanza notebook.

stop

 Arresta un'istanza di notebook.

testIamPermissions

 Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata.

upgrade

 Esegue l'upgrade di un'istanza notebook all'ultima versione.