REST Resource: projects.locations.runtimes

Risorsa: runtime

La definizione di un runtime per un'istanza di notebook gestita.

Rappresentazione JSON 
{
  "name": string,
  "state": enum (State),
  "healthState": enum (HealthState),
  "accessConfig": {
    object (RuntimeAccessConfig)
  },
  "softwareConfig": {
    object (RuntimeSoftwareConfig)
  },
  "metrics": {
    object (RuntimeMetrics)
  },
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "runtimeMigrationEligibility": {
    object (RuntimeMigrationEligibility)
  },

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

string

Solo output. Il nome della risorsa del runtime. Formato: projects/{project}/locations/{location}/runtimes/{runtimeId}
state

enum (State)

Solo output. Stato del runtime.
healthState

enum (HealthState)

Solo output. Runtime healthState.
accessConfig

object (RuntimeAccessConfig)

Le impostazioni di configurazione per l'accesso al runtime.
softwareConfig

object (RuntimeSoftwareConfig)

Le impostazioni di configurazione per il software all'interno del runtime.
metrics

object (RuntimeMetrics)

Solo output. Contiene metriche del daemon Runtime, come lo stato del servizio e le statistiche di JupyterLab.
createTime

string (Timestamp format)

Solo output. Ora di creazione del runtime.

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 del runtime.

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

map (key: string, value: string)

Facoltativo. Le etichette da associare a questo notebook o runtime gestito. Le chiavi dell'etichetta devono contenere da 1 a 63 caratteri ed essere conformi allo standard RFC 1035. I valori delle etichette possono essere vuoti, ma, se presenti, devono contenere da 1 a 63 caratteri ed essere conformi allo standard RFC 1035. A un cluster possono essere associate al massimo 32 etichette.

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

object (RuntimeMigrationEligibility)

Solo output. Controlla la fattibilità di una migrazione da GmN a WbI.
Tipo di runtime; al momento supporta solo la VM Compute Engine. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
virtualMachine

object (VirtualMachine)

Utilizza un'immagine VM di Compute Engine per avviare l'istanza del notebook gestito.
Fine dei campi che si escludono a vicenda.
migrated

boolean

Solo output. Valore booleano che indica se è stata eseguita la migrazione di questo notebook a un'istanza di Workbench

VirtualMachine

Runtime che utilizza la macchina virtuale per il calcolo.

Rappresentazione JSON 
{
  "instanceName": string,
  "instanceId": string,
  "virtualMachineConfig": {
    object (VirtualMachineConfig)
  }
}
Campi
instanceName

string

Solo output. Il nome descrittivo dell'istanza Compute Engine gestita.
instanceId

string

Solo output. L'identificatore univoco dell'istanza di Managed Compute Engine.
virtualMachineConfig

object (VirtualMachineConfig)

Impostazioni di configurazione della macchina virtuale.

VirtualMachineConfig

Le impostazioni di configurazione per la macchina virtuale.

Rappresentazione JSON 
{
  "zone": string,
  "machineType": string,
  "containerImages": [
    {
      object (ContainerImage)
    }
  ],
  "dataDisk": {
    object (LocalDisk)
  },
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "shieldedInstanceConfig": {
    object (RuntimeShieldedInstanceConfig)
  },
  "acceleratorConfig": {
    object (RuntimeAcceleratorConfig)
  },
  "network": string,
  "subnet": string,
  "internalIpOnly": boolean,
  "tags": [
    string
  ],
  "guestAttributes": {
    string: string,
    ...
  },
  "metadata": {
    string: string,
    ...
  },
  "labels": {
    string: string,
    ...
  },
  "nicType": enum (NicType),
  "reservedIpRange": string,
  "bootImage": {
    object (BootImage)
  }
}
Campi
zone

string

Solo output. La zona in cui si trova la macchina virtuale. Se utilizzi una richiesta regionale, il servizio Notebook sceglierà una località nella regione di runtime corrispondente. In una richiesta GET, la zona sarà sempre presente. Esempio: * us-central1-b
machineType

string

Obbligatorio. Il tipo di macchina Compute Engine utilizzato per i runtime. Il nome breve è valido. Esempi: * n1-standard-2 * e2-standard-8
containerImages[]

object (ContainerImage)

Facoltativo. Utilizza un elenco di immagini container da utilizzare come kernel nell'istanza notebook.
dataDisk

object (LocalDisk)

Obbligatorio. Impostazioni di configurazione dell'opzione del disco di dati.
encryptionConfig

object (EncryptionConfig)

Facoltativo. Impostazioni di crittografia per il disco di dati della macchina virtuale.
shieldedInstanceConfig

object (RuntimeShieldedInstanceConfig)

Facoltativo. Impostazioni di configurazione dell'istanza Shielded VM.
acceleratorConfig

object (RuntimeAcceleratorConfig)

Facoltativo. La configurazione dell'acceleratore Compute Engine per questo runtime.
network

string

Facoltativo. La rete Compute Engine da utilizzare per le comunicazioni tra macchine. Non può essere specificato con la subnet. Se non vengono specificati né network né subnet, viene utilizzata la rete "default" del progetto, se esiste.

Un URL completo o un URI parziale. Esempi:

  • https://www.googleapis.com/compute/v1/projects/[projectId]/global/networks/default
  • projects/[projectId]/global/networks/default

I runtime sono risorse gestite all'interno dell'infrastruttura Google. I runtime supportano le seguenti configurazioni di rete:

  • Rete gestita da Google (rete e subnet sono vuote)
  • VPC del progetto consumer (rete e subnet sono obbligatorie). Richiede la configurazione dell'accesso privato ai servizi.
  • VPC condiviso (rete e subnet sono obbligatorie). Richiede la configurazione dell'accesso privato ai servizi.
subnet

string

Facoltativo. La subnet di Compute Engine da utilizzare per le comunicazioni tra macchine. Non può essere specificato con la rete.

Sono validi un URL completo o un URI parziale. Esempi:

  • https://www.googleapis.com/compute/v1/projects/[projectId]/regions/us-east1/subnetworks/sub0
  • projects/[projectId]/regions/us-east1/subnetworks/sub0
internalIpOnly

boolean

Facoltativo. Se true, il runtime avrà solo indirizzi IP interni. Per impostazione predefinita, i runtime non sono limitati agli indirizzi IP interni e a ogni VM vengono assegnati indirizzi IP esterni temporanei. Questa limitazione internalIpOnly può essere abilitata solo per le reti abilitate alla subnet e tutte le dipendenze devono essere configurate in modo da essere accessibili senza indirizzi IP esterni.
tags[]

string

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

map (key: string, value: string)

Solo output. Gli attributi guest di Compute Engine. (vedi Attributi guest di progetto e istanza).

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

map (key: string, value: string)

Facoltativo. Le voci di metadati di Compute Engine da aggiungere alla macchina virtuale. (vedi Metadati di progetto e istanza).

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

map (key: string, value: string)

Facoltativo. Le etichette da associare a questo runtime. Le chiavi dell'etichetta devono contenere da 1 a 63 caratteri ed essere conformi allo standard RFC 1035. I valori delle etichette possono essere vuoti, ma, se presenti, devono contenere da 1 a 63 caratteri ed essere conformi allo standard RFC 1035. A un cluster possono essere associate al massimo 32 etichette.

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

enum (NicType)

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

string

Facoltativo. Il nome dell'intervallo IP riservato è utilizzato per il peering VPC. L'allocazione della subnet utilizzerà l'intervallo name, se assegnato.

Esempio: managed-notebooks-range-c

PEERING_RANGE_NAME_3=managed-notebooks-range-c
gcloud compute addresses create $PEERING_RANGE_NAME_3 \
  --global \
  --prefix-length=24 \
  --description="Google Cloud Managed Notebooks Range 24 c" \
  --network=$NETWORK \
  --addresses=192.168.0.0 \
  --purpose=VPC_PEERING

Il valore del campo sarà: managed-notebooks-range-c
bootImage

object (BootImage)

Facoltativo. Metadati dell'immagine di avvio utilizzati per l'upgrade del runtime.

LocalDisk

Una risorsa disco locale collegata.

Rappresentazione JSON 
{
  "autoDelete": boolean,
  "boot": boolean,
  "deviceName": string,
  "guestOsFeatures": [
    {
      object (RuntimeGuestOsFeature)
    }
  ],
  "index": integer,
  "initializeParams": {
    object (LocalDiskInitializeParams)
  },
  "interface": string,
  "kind": string,
  "licenses": [
    string
  ],
  "mode": string,
  "source": string,
  "type": string
}
Campi
autoDelete

boolean

Facoltativo. Solo output. Specifica se il disco verrà eliminato automaticamente quando viene eliminata l'istanza (ma non quando il disco viene scollegato dall'istanza).
boot

boolean

Facoltativo. Solo output. Indica che si tratta di un disco di avvio. La macchina virtuale utilizzerà la prima partizione del disco per il file system root.
deviceName

string

Facoltativo. Solo output. Specifica un nome univoco del dispositivo a tua scelta che viene visualizzato nell'albero /dev/disk/by-id/google-* di un sistema operativo Linux in esecuzione all'interno dell'istanza. Questo nome può essere utilizzato per fare riferimento al dispositivo ai fini del montaggio, del ridimensionamento e così via dall'interno dell'istanza.

Se non viene specificato, il server sceglie un nome di dispositivo predefinito da applicare a questo disco, nel formato persistent-disk-x, dove x è un numero assegnato da Google Compute Engine. Questo campo è applicabile solo ai dischi permanenti.
guestOsFeatures[]

object (RuntimeGuestOsFeature)

Solo output. Indica un elenco di funzionalità da attivare sul sistema operativo guest. Applicabile solo alle immagini avviabili. Consulta la sezione Attivazione delle funzionalità del sistema operativo guest per un elenco delle opzioni disponibili.
index

integer

Solo output. Un indice a base zero per questo disco, dove 0 è riservato al disco di avvio. Se a un'istanza sono collegati molti dischi, ogni disco avrà un numero di indice univoco.
initializeParams

object (LocalDiskInitializeParams)

Solo input. Specifica i parametri per un nuovo disco che verrà creato insieme alla nuova istanza. Utilizza i parametri di inizializzazione per creare dischi di avvio o SSD locali collegati alla nuova istanza.

Questa proprietà si esclude a vicenda con la proprietà sorgente; puoi definire solo una delle due, ma non entrambe.
interface

string

Specifica l'interfaccia del disco da utilizzare per collegare questo disco, che è SCSI o NVME. Il valore predefinito è SCSI. I dischi permanenti devono sempre utilizzare SCSI e la richiesta non andrà a buon fine se tenti di collegare un disco permanente in un formato diverso da SCSI. Le unità SSD locali possono utilizzare NVMe o SCSI. Per le caratteristiche di prestazioni di SCSI su NVMe, consulta Prestazioni SSD locali. Valori validi:

  • NVME
  • SCSI
kind

string

Solo output. Il tipo di risorsa. Calcola sempre compute#attachedDisk per i dischi collegati.
licenses[]

string

Solo output. Qualsiasi licenza valida visibile pubblicamente.
mode

string

La modalità in cui collegare questo disco, ovvero READ_WRITE o READ_ONLY. Se non specificato, il valore predefinito è collegare il disco in modalità READ_WRITE. Valori validi:

  • READ_ONLY
  • READ_WRITE
source

string

Specifica un URL parziale o completo valido per una risorsa Persistent Disk esistente.
type

string

Specifica il tipo di disco, SCRATCH o PERSISTENT. Se non specificato, il valore predefinito è PERSISTENT. Valori validi:

  • PERSISTENT
  • SCRATCH

RuntimeGuestOsFeature

Facoltativo. Un elenco di funzionalità da attivare sul sistema operativo guest. Applicabile solo alle immagini avviabili. Leggi Attivazione delle funzionalità del sistema operativo guest per visualizzare un elenco delle opzioni disponibili. Funzionalità del sistema operativo guest per il disco di avvio.

Rappresentazione JSON 
{
  "type": string
}
Campi
type

string

L'ID di una funzionalità supportata. Leggi Attivazione delle funzionalità del sistema operativo guest per visualizzare un elenco delle opzioni disponibili.

Valori validi:

  • FEATURE_TYPE_UNSPECIFIED
  • MULTI_IP_SUBNET
  • SECURE_BOOT
  • UEFI_COMPATIBLE
  • VIRTIO_SCSI_MULTIQUEUE
  • WINDOWS

LocalDiskInitializeParams

Solo input. Specifica i parametri per un nuovo disco che verrà creato insieme alla nuova istanza. Utilizza i parametri di inizializzazione per creare dischi di avvio o SSD locali collegati al nuovo runtime. Questa proprietà si esclude a vicenda con la proprietà sorgente; puoi definire solo una delle due, ma non entrambe.

Rappresentazione JSON 
{
  "description": string,
  "diskName": string,
  "diskSizeGb": string,
  "diskType": enum (DiskType),
  "labels": {
    string: string,
    ...
  }
}
Campi
description

string

Facoltativo. Fornisci questa proprietà durante la creazione del disco.
diskName

string

Facoltativo. Specifica il nome del disco. Se non specificato, il valore predefinito è l'utilizzo del nome dell'istanza. Se il disco con il nome dell'istanza esiste già nella zona/regione specificata, verrà generato automaticamente un nuovo nome.
diskSizeGb

string (int64 format)

Facoltativo. Specifica le dimensioni del disco in GB in base 2. Se non viene specificato, il disco avrà le stesse dimensioni dell'immagine (di solito 10 GB). Se specificata, la dimensione deve essere maggiore o uguale a 10 GB. Valore predefinito 100 GB.
diskType

enum (DiskType)

Solo input. Il tipo di disco di avvio collegato a questa istanza, il cui valore predefinito è Standard Persistent Disk (PD_STANDARD).
labels

map (key: string, value: string)

Facoltativo. Etichette da applicare a questo disco. Questi possono essere modificati in un secondo momento con il metodo disks.setLabels. Questo campo è applicabile solo ai dischi permanenti.

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

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.

EncryptionConfig

Rappresenta una configurazione personalizzata della chiave di crittografia che può essere applicata a una risorsa. Verranno criptati tutti i dischi nella macchina virtuale.

Rappresentazione JSON 
{
  "kmsKey": string
}
Campi
kmsKey

string

L'identificatore di risorsa Cloud KMS della chiave di crittografia gestita dal cliente utilizzata per proteggere una risorsa, ad esempio un disco. Ha il seguente formato: projects/{PROJECT_ID}/locations/{REGION}/keyRings/{KEY_RING_NAME}/cryptoKeys/{KEY_NAME}

RuntimeShieldedInstanceConfig

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

Definisce se l'istanza ha 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

Definisce se l'istanza ha vTPM abilitato. Abilitato per impostazione predefinita.
enableIntegrityMonitoring

boolean

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

Consente il monitoraggio e l'attestazione dell'integrità in fase di avvio dell'istanza. 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. Abilitato per impostazione predefinita.

RuntimeAcceleratorConfig

Definizione dei tipi di acceleratori hardware che possono essere utilizzati. Consulta Compute Engine AcceleratorTypes. Esempi:

  • nvidia-tesla-k80
  • nvidia-tesla-p100
  • nvidia-tesla-v100
  • nvidia-tesla-p4
  • nvidia-tesla-t4
  • nvidia-tesla-a100
Rappresentazione JSON 
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
Campi
type

enum (AcceleratorType)

Modello di acceleratore.
coreCount

string (int64 format)

Conteggio dei core di questo acceleratore.

AcceleratorType

Tipo di questo acceleratore.

Enum
ACCELERATOR_TYPE_UNSPECIFIED Il tipo di acceleratore non è specificato.
NVIDIA_TESLA_K80

Il tipo di acceleratore è Nvidia Tesla K80.
NVIDIA_TESLA_P100 Il tipo di acceleratore è Nvidia Tesla P100.
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_L4 Il tipo di acceleratore è Nvidia L4.
TPU_V2 (Disponibile a breve) Il tipo di acceleratore è TPU V2.
TPU_V3 (Disponibile a breve) Il tipo di acceleratore è TPU V3.
NVIDIA_TESLA_T4_VWS Il tipo di acceleratore è workstation virtuali NVIDIA Tesla T4.
NVIDIA_TESLA_P100_VWS Il tipo di acceleratore è workstation virtuali NVIDIA Tesla P100.
NVIDIA_TESLA_P4_VWS Il tipo di acceleratore è workstation virtuali NVIDIA Tesla P4.

NicType

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

Enum
UNSPECIFIED_NIC_TYPE Nessun tipo specificato.
VIRTIO_NET VIRTIO
GVNIC gVNIC

BootImage

Questo tipo non ha campi.

Definizione dell'immagine di avvio utilizzata dal runtime. Utilizzato per facilitare l'upgrade del runtime.

Stato

La definizione degli stati di questo runtime.

Enum
STATE_UNSPECIFIED Lo stato non è specificato.
STARTING Il livello di calcolo sta avviando il runtime. Non è pronto per l'uso.
PROVISIONING Il livello di calcolo sta installando i framework richiesti e registrando il runtime con il proxy del notebook. Non può essere utilizzato.
ACTIVE Il runtime è attualmente in esecuzione. È pronto per l'uso.
STOPPING La logica di controllo sta interrompendo il runtime. Non può essere utilizzato.
STOPPED Il runtime è stato arrestato. Non può essere utilizzato.
DELETING Il runtime è in fase di eliminazione. Non può essere utilizzato.
UPGRADING L'ambiente di runtime è in fase di upgrade. Non può essere utilizzato.
INITIALIZING Il runtime è in fase di creazione e configurazione. Non è pronto per l'uso.

HealthState

Lo stato secondario di runtime.

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

RuntimeAccessConfig

Specifica la configurazione di accesso per Runtime

Rappresentazione JSON 
{
  "accessType": enum (RuntimeAccessType),
  "runtimeOwner": string,
  "proxyUri": string
}
Campi
accessType

enum (RuntimeAccessType)

Il tipo di modalità di accesso di questa istanza.
runtimeOwner

string

Il proprietario di questo runtime dopo la creazione. Formato: alias@example.com al momento supporta un solo proprietario.
proxyUri

string

Solo output. L'endpoint proxy utilizzato per accedere al runtime.

RuntimeAccessType

Possibili modi per accedere al runtime. Modalità di autenticazione. Al momento supporta solo un singolo utente.

Enum
RUNTIME_ACCESS_TYPE_UNSPECIFIED Accesso non specificato.
SINGLE_USER Accesso di un singolo utente.
SERVICE_ACCOUNT Modalità service account. Nella modalità Service Account, il creatore del runtime specifica un service account esistente nel progetto consumer. Utilizzo del campo Service Account di runtime. Gli utenti che accedono a Runtime devono disporre dell'autorizzazione ActAs (Service Account User).

RuntimeSoftwareConfig

Specifica la selezione e la configurazione del software all'interno del runtime. Le proprietà da impostare in fase di runtime. Le chiavi delle proprietà sono specificate nel formato key:value, ad esempio:

  • idleShutdown: true
  • idleShutdownTimeout: 180
  • enableHealthMonitoring: true
Rappresentazione JSON 
{
  "notebookUpgradeSchedule": string,
  "idleShutdownTimeout": integer,
  "installGpuDriver": boolean,
  "customGpuDriverPath": string,
  "postStartupScript": string,
  "kernels": [
    {
      object (ContainerImage)
    }
  ],
  "postStartupScriptBehavior": enum (PostStartupScriptBehavior),
  "enableHealthMonitoring": boolean,
  "idleShutdown": boolean,
  "upgradeable": boolean,
  "disableTerminal": boolean,
  "version": string,
  "mixerDisabled": boolean
}
Campi
notebookUpgradeSchedule

string

Espressione cron nel fuso orario UTC, utilizzata per pianificare l'upgrade automatico dell'istanza. Segui il formato cron.
idleShutdownTimeout

integer

Tempo in minuti di attesa prima di arrestare il runtime. Valore predefinito: 180 minuti
installGpuDriver

boolean

Installa automaticamente il driver Nvidia. Valore predefinito: true
customGpuDriverPath

string

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

string

Percorso di uno script Bash che viene eseguito automaticamente dopo l'avvio completo di un'istanza notebook. Il percorso deve essere un URL o un percorso Cloud Storage (gs://path-to-file/file-name).
kernels[]

object (ContainerImage)

Facoltativo. Utilizza un elenco di immagini container da utilizzare come kernel nell'istanza notebook.
postStartupScriptBehavior

enum (PostStartupScriptBehavior)

Comportamento dello script di avvio post-esecuzione.
enableHealthMonitoring

boolean

Verifica che i servizi interni principali siano in esecuzione. Valore predefinito: true
idleShutdown

boolean

Il runtime verrà arrestato automaticamente dopo idle_shutdown_time. Valore predefinito: true
upgradeable

boolean

Solo output. Valore booleano che indica se è disponibile un'immagine più recente in una famiglia di immagini.
disableTerminal

boolean

Valore booleano che indica se il terminale JupyterLab sarà disponibile o meno. Valore predefinito: False
version

string

Versione di sola uscita dell'immagine di avvio, ad esempio M100, dall'etichetta di rilascio dell'immagine.
mixerDisabled

boolean

Valore booleano che indica se il client mixer deve essere disattivato. Valore predefinito: False

PostStartupScriptBehavior

Comportamento dello script di avvio post-esecuzione.

Enum
POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED Comportamento dello script di avvio posticipato non specificato. Verrà eseguito una sola volta al momento della creazione.
RUN_EVERY_START Esegue lo script di avvio fornito durante la creazione a ogni avvio.
DOWNLOAD_AND_RUN_EVERY_START Scarica ed esegue lo script di avvio fornito a ogni avvio.

RuntimeMetrics

Contiene metriche del daemon di runtime, come statistiche su sistema operativo, kernel e sessioni.

Rappresentazione JSON 
{
  "systemMetrics": {
    string: string,
    ...
  }
}
Campi
systemMetrics

map (key: string, value: string)

Solo output. Le metriche di sistema.

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

RuntimeMigrationEligibility

RuntimeMigrationEligibility rappresenta le informazioni sulla fattibilità di una migrazione da GmN a WbI.

Rappresentazione JSON 
{
  "warnings": [
    enum (Warning)
  ],
  "errors": [
    enum (Error)
  ]
}
Campi
warnings[]

enum (Warning)

Solo output. Durante la migrazione verranno impostate alcune configurazioni predefinite.
errors[]

enum (Error)

Solo output. Alcune configurazioni rendono il GmN non idoneo per una migrazione automatica. È necessaria una migrazione manuale.

Avviso

Un messaggio di avviso di migrazione indica che alcune configurazioni verranno impostate come predefinite durante la migrazione.

Enum
WARNING_UNSPECIFIED Tipo predefinito.
UNSUPPORTED_ACCELERATOR_TYPE Il GmN utilizza un tipo di acceleratore non supportato in WbI. Verrà eseguita la migrazione senza un acceleratore. Gli utenti possono collegare un acceleratore dopo la migrazione.
UNSUPPORTED_OS Il nodo di gestione utilizza un sistema operativo non supportato in WbI (ad es. Debian 10). Verrà sostituito con Debian 11 in WbI.
RESERVED_IP_RANGE Questo GmN è configurato con un intervallo IP riservato, che non è più applicabile in WbI.
GOOGLE_MANAGED_NETWORK Questo GmN è configurato con una rete gestita da Google. Fornisci le opzioni network e subnet per la migrazione.
POST_STARTUP_SCRIPT Questo GmN è configurato con uno script post-avvio. Se vuoi, fornisci il postStartupScriptOption per la migrazione.
SINGLE_USER Questo GmN è configurato con la modalità utente singolo. Se vuoi, fornisci l'opzione serviceAccount per la migrazione.

Errore

Un messaggio di errore di migrazione indica che alcune configurazioni rendono l'account Google Merchant Center non idoneo per una migrazione automatica. È necessaria una migrazione manuale.

Enum
ERROR_UNSPECIFIED Tipo predefinito.
CUSTOM_CONTAINER Il GmN è configurato con contenitori personalizzati e non può essere migrato.

Metodi

create

 Crea un nuovo runtime in un progetto e una località specifici.

delete

 Elimina un singolo runtime.

get

 Recupera i dettagli di un singolo runtime.

getIamPolicy

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

list

 Elenca i runtime in un progetto e una località specifici.

migrate

 Esegui la migrazione di un runtime esistente a una nuova istanza Workbench.

patch

 Aggiorna la configurazione di runtime del notebook.

reportEvent

 Segnala ed elabora un evento di runtime.

reset

 Reimposta un runtime del notebook gestito.

setIamPolicy

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

start

 Avvia un runtime di notebook gestito.

stop

 Arresta un runtime del notebook gestito.

switch

 Cambia il runtime di un notebook gestito.

testIamPermissions

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