Risorsa: Instance
La definizione di un'istanza di notebook.
| Rappresentazione JSON |
|---|
{ "name": string, "postStartupScript": string, "proxyUri": string, "instanceOwners": [ string ], "serviceAccount": string, "serviceAccountScopes": [ string ], "machineType": string, "acceleratorConfig": { object ( |
| Campi | |
|---|---|
name |
Solo output. Il nome di questa istanza del notebook. Formato: |
postStartupScript |
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 ( |
proxyUri |
Solo output. L'endpoint proxy utilizzato per accedere al notebook Jupyter. |
instanceOwners[] |
Solo input. Il proprietario di questa istanza dopo la creazione. Formato: Al momento supporta un solo proprietario. Se non specificato, tutti gli utenti del account di servizio della tua istanza VM possono utilizzare l'istanza. |
serviceAccount |
Il account di servizio su questa istanza, che consente l'accesso ad altri servizi Google Cloud. Puoi utilizzare qualsiasi account di servizio all'interno dello stesso progetto, ma devi disporre dell'autorizzazione Utente account di servizio per utilizzare l'istanza. Se non specificato, viene utilizzato l'account di servizio predefinito di Compute Engine. |
serviceAccountScopes[] |
Facoltativo. Gli URI degli ambiti del account di servizio da includere nelle istanze di Compute Engine. Se non vengono specificati, vengono definiti i seguenti ambiti: - https://www.googleapis.com/auth/cloud-platform - https://www.googleapis.com/auth/userinfo.email Se non utilizzi gli ambiti predefiniti, devi avere almeno: https://www.googleapis.com/auth/compute |
machineType |
Obbligatorio. Il tipo di macchina Compute Engine di questa istanza. |
acceleratorConfig |
L'acceleratore hardware utilizzato in questa istanza. Se utilizzi acceleratori, assicurati che la configurazione disponga di vCPU e memoria sufficienti per supportare l' |
state |
Solo output. Lo stato di questa istanza. |
installGpuDriver |
Indica se l'utente finale autorizza Google Cloud a installare il driver GPU su questa istanza. Se questo campo è vuoto o impostato su false, il driver della GPU non verrà installato. Applicabile solo alle istanze con GPU. |
customGpuDriverPath |
Specifica un percorso Cloud Storage personalizzato in cui è archiviato il driver della GPU. Se non specificati, sceglieremo automaticamente tra i driver GPU ufficiali. |
bootDiskType |
Solo input. Il tipo di disco di avvio collegato a questa istanza, il cui valore predefinito è Standard Persistent Disk ( |
bootDiskSizeGb |
Solo input. La dimensione del disco di avvio in GB collegato a questa istanza, fino a un massimo di 64.000 GB (64 TB). Il valore minimo consigliato è 100 GB. Se non specificato, il valore predefinito è 100. |
dataDiskType |
Solo input. Il tipo di disco dati collegato a questa istanza, il cui valore predefinito è il disco permanente standard ( |
dataDiskSizeGb |
Solo input. La dimensione del disco dati in GB collegato a questa istanza, fino a un massimo di 64.000 GB (64 TB). Puoi scegliere le dimensioni del disco di dati in base alle dimensioni dei notebook e dei dati. Se non specificato, il valore predefinito è 100. |
noRemoveDataDisk |
Solo input. Se è true, il disco di dati non verrà eliminato automaticamente quando viene eliminata l'istanza. |
diskEncryption |
Solo input. Metodo di crittografia del disco utilizzato sui dischi di avvio e dati, il valore predefinito è GMEK. |
kmsKey |
Solo input. La chiave KMS utilizzata per criptare i dischi, applicabile solo se diskEncryption è CMEK. Formato: Scopri di più sull'utilizzo delle tue chiavi di crittografia. |
disks[] |
Solo output. Dischi collegati all'istanza del notebook. |
shieldedInstanceConfig |
Facoltativo. Configurazione di Shielded VM. Immagini che utilizzano le funzionalità Shielded VM supportate. |
noPublicIp |
Se è true, a questa istanza non verrà assegnato alcun IP esterno. |
noProxyAccess |
Se il valore è true, l'istanza del blocco note non verrà registrata con il proxy. |
network |
Il nome del VPC in cui si trova questa istanza. Formato: |
subnet |
Il nome della subnet in cui si trova questa istanza. Formato: |
labels |
Etichette da applicare a questa istanza. Questi possono essere modificati in un secondo momento con il metodo setLabels. Un oggetto contenente un elenco di coppie |
metadata |
Metadati personalizzati da applicare a questa istanza. Ad esempio, per specificare un bucket Cloud Storage per il backup automatico, puoi utilizzare il tag di metadati Un oggetto contenente un elenco di coppie |
tags[] |
Facoltativo. I tag di rete Compute Engine da aggiungere al runtime (vedi Aggiungere tag di rete). |
upgradeHistory[] |
La cronologia degli upgrade di questa istanza. |
nicType |
Facoltativo. Il tipo di vNIC da utilizzare su questa interfaccia. Può essere gVNIC o VirtioNet. |
reservationAffinity |
Facoltativo. L'affinità di prenotazione facoltativa. Se imposti questo campo, la prenotazione di Compute zonale specificata verrà applicata a questa istanza del notebook. |
creator |
Solo output. Indirizzo email dell'entità che ha inviato la richiesta instances.create originale. |
canIpForward |
Facoltativo. Flag per attivare o meno l'inoltro IP, valore predefinito false/off. https://cloud.google.com/vpc/docs/using-routes#canipforward |
createTime |
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: |
updateTime |
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: |
instanceMigrationEligibility |
Solo output. Controlla la fattibilità di una migrazione da UmN a WbI. |
| Tipo di ambiente; 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 |
Utilizza un'immagine VM di Compute Engine per avviare l'istanza notebook. |
containerImage |
Utilizza un'immagine container per avviare l'istanza del notebook. |
| Fine dei campi che si escludono a vicenda. | |
migrated |
Solo output. Valore booleano che indica se è stata eseguita la migrazione di questo notebook a un'istanza di Workbench |
AcceleratorConfig
Definizione di un acceleratore hardware. Tieni presente che non tutte le combinazioni di type e coreCount sono valide. Consulta la sezione GPU su Compute Engine per trovare una combinazione valida. Le TPU non sono supportate.
| Rappresentazione JSON |
|---|
{
"type": enum ( |
| Campi | |
|---|---|
type |
Tipo di questo acceleratore. |
coreCount |
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_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. |
NVIDIA_L4 |
Il tipo di acceleratore è Nvidia Tesla L4. |
NVIDIA_A100_80GB |
Il tipo di acceleratore è Nvidia Tesla A100 da 80 GB. |
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. |
NVIDIA_H100_80GB |
Il tipo di acceleratore è NVIDIA H100 da 80 GB. |
NVIDIA_H100_MEGA_80GB |
Il tipo di acceleratore è NVIDIA H100 Mega da 80 GB. |
TPU_V2 |
(Disponibile a breve) Il tipo di acceleratore è TPU V2. |
TPU_V3 |
(Disponibile a breve) Il tipo di acceleratore è TPU V3. |
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. |
REGISTERING |
L'istanza è in fase di registrazione. |
SUSPENDING |
L'istanza è in fase di sospensione. |
SUSPENDED |
L'istanza è sospesa. |
DiskType
Possibili tipi di dischi per le istanze notebook.
| 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. |
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. |
Disco
Una risorsa disco collegata all'istanza.
| Rappresentazione JSON |
|---|
{
"autoDelete": boolean,
"boot": boolean,
"deviceName": string,
"diskSizeGb": string,
"guestOsFeatures": [
{
object ( |
| Campi | |
|---|---|
autoDelete |
Indica se il disco verrà eliminato automaticamente quando viene eliminata l'istanza (ma non quando il disco viene scollegato dall'istanza). |
boot |
Indica che si tratta di un disco di avvio. La macchina virtuale utilizzerà la prima partizione del disco per il file system root. |
deviceName |
Indica un nome univoco del dispositivo a tua scelta che viene visualizzato nell'albero Se non 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. |
diskSizeGb |
Indica le dimensioni del disco in GB base 2. |
guestOsFeatures[] |
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 |
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. |
interface |
Indica l'interfaccia disco da utilizzare per collegare questo disco, ovvero 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:
|
kind |
Il tipo di risorsa. Calcola sempre compute#attachedDisk per i dischi collegati. |
licenses[] |
Un elenco di licenze visibili pubblicamente. Riservato all'utilizzo da parte di Google. Una licenza rappresenta i dati di fatturazione e di utilizzo aggregati per le immagini pubbliche e del marketplace. |
mode |
La modalità in cui collegare questo disco, ovvero
|
source |
Indica un URL parziale o completo valido per una risorsa Persistent Disk esistente. |
type |
Indica il tipo di disco:
|
GuestOsFeature
Funzionalità del sistema operativo guest per il disco di avvio.
| Rappresentazione JSON |
|---|
{ "type": string } |
| Campi | |
|---|---|
type |
L'ID di una funzionalità supportata. Consulta la sezione Attivazione delle funzionalità del sistema operativo guest per un elenco delle opzioni disponibili. Valori validi:
|
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 |
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 |
Definisce se l'istanza ha vTPM abilitato. Abilitato per impostazione predefinita. |
enableIntegrityMonitoring |
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. |
UpgradeHistoryEntry
La voce della cronologia degli upgrade delle immagini VM.
| Rappresentazione JSON |
|---|
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum ( |
| Campi | |
|---|---|
snapshot |
Lo snapshot del disco di avvio di questa istanza notebook prima dell'upgrade. |
vmImage |
L'immagine VM prima dell'upgrade di questa istanza. |
containerImage |
L'immagine container prima dell'upgrade di questa istanza. |
framework |
Il framework di questa istanza notebook. |
version |
La versione dell'istanza notebook prima di questo upgrade. |
state |
Lo stato di questa voce della cronologia degli upgrade dell'istanza. |
createTime |
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: |
targetImage |
Immagine VM di destinazione. Formato: |
action |
Azione. Esegui il rollback o l'upgrade. |
targetVersion |
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. |
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 |
ReservationAffinity
Affinità di prenotazione per l'utilizzo della prenotazione a livello di zona.
| Rappresentazione JSON |
|---|
{
"consumeReservationType": enum ( |
| Campi | |
|---|---|
consumeReservationType |
Facoltativo. Tipo di prenotazione da utilizzare |
key |
Facoltativo. Corrisponde alla chiave di etichetta della risorsa di prenotazione. |
values[] |
Facoltativo. Corrisponde ai valori etichetta della risorsa di prenotazione. |
Tipo
Indica se consumare o meno la capacità di una prenotazione.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Tipo predefinito. |
NO_RESERVATION |
Non consumare da alcuna capacità allocata. |
ANY_RESERVATION |
Consuma qualsiasi prenotazione disponibile. |
SPECIFIC_RESERVATION |
Deve consumare una prenotazione specifica. Devi specificare i campi chiave-valore per specificare le prenotazioni. |
InstanceMigrationEligibility
InstanceMigrationEligibility rappresenta le informazioni sulla fattibilità di una migrazione da UmN a WbI.
| Rappresentazione JSON |
|---|
{ "warnings": [ enum ( |
| Campi | |
|---|---|
warnings[] |
Solo output. Durante la migrazione verranno impostate alcune configurazioni predefinite. |
errors[] |
Solo output. Alcune configurazioni rendono l'UmN 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_MACHINE_TYPE |
L'UmN utilizza un tipo di macchina non supportato in WbI. Verrà eseguita la migrazione con il tipo di macchina predefinito e2-standard-4. Gli utenti possono modificare il tipo di macchina dopo la migrazione. |
UNSUPPORTED_ACCELERATOR_TYPE |
L'UMN utilizza un tipo di acceleratore non supportato in WbI. Verrà eseguita la migrazione senza un acceleratore. L'utente può collegare un acceleratore dopo la migrazione. |
UNSUPPORTED_OS |
L'UmN utilizza un sistema operativo non supportato in WbI (ad es. Debian 10, Ubuntu). Verrà sostituito con Debian 11 in WbI. |
NO_REMOVE_DATA_DISK |
Questo UmN è configurato con noRemoveDataDisk, che non è più disponibile in WbI. |
GCS_BACKUP |
Questo UmN è configurato con la funzionalità di backup di Cloud Storage, che non è più disponibile in WbI. |
POST_STARTUP_SCRIPT |
Questo UmN è configurato con uno script post-avvio. Se vuoi, fornisci il postStartupScriptOption per la migrazione. |
Errore
Un messaggio di errore di migrazione indica che alcune configurazioni rendono l'UMN non idoneo per una migrazione automatica. È necessaria una migrazione manuale.
| Enum | |
|---|---|
ERROR_UNSPECIFIED |
Tipo predefinito. |
DATAPROC_HUB |
L'UmN utilizza Dataproc Hub e non può essere migrato. |
Metodi |
|
|---|---|
|
Crea una nuova istanza in un progetto e una località specifici. |
|
Elimina una singola istanza. |
|
Crea un file di diagnostica ed esegue lo strumento di diagnostica per una determinata istanza. |
|
Recupera i dettagli di una singola istanza. |
|
Recupera la policy di controllo dell'accesso per una risorsa. |
|
Verifica se un'istanza notebook è integra. |
|
Controlla se un'istanza notebook è aggiornabile. |
|
Elenca le istanze in un progetto e una località specifici. |
|
Esegue la migrazione di un notebook gestito dall'utente esistente alle istanze di Workbench. |
|
Registra un'istanza notebook legacy esistente nel server dell'API Notebooks. |
|
Consente alle istanze notebook di segnalare le informazioni più recenti sull'istanza al server API Notebooks. |
|
Reimposta un'istanza di notebook. |
|
Esegue il rollback di un'istanza notebook alla versione precedente. |
|
Aggiorna gli acceleratori guest di una singola istanza. |
|
Imposta la policy di controllo dell'accesso sulla risorsa specificata. |
|
Sostituisce tutte le etichette di un'istanza. |
|
Aggiorna il tipo di macchina di una singola istanza. |
|
Avvia un'istanza notebook. |
|
Arresta un'istanza di notebook. |
|
Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata. |
|
Aggiorna le configurazioni dell'istanza notebook. |
|
Aggiungi/aggiorna elementi di metadati per un'istanza. |
|
Aggiorna la configurazione dell'istanza schermata di una singola istanza. |
|
Esegue l'upgrade di un'istanza notebook all'ultima versione. |