Risorsa: Instance
La definizione di un'istanza notebook.
| Rappresentazione JSON |
|---|
{ "name": string, "proxyUri": string, "instanceOwners": [ string ], "creator": string, "state": enum ( |
| Campi | |
|---|---|
name |
Solo output. Identificatore. Il nome di questa istanza del notebook. Formato: |
proxyUri |
Solo output. L'endpoint proxy utilizzato per accedere al notebook Jupyter. |
instanceOwners[] |
Facoltativo. 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 dell'account di servizio possono utilizzare l'istanza. |
creator |
Solo output. Indirizzo email dell'entità che ha inviato la richiesta instances.create originale. |
state |
Solo output. Lo stato di questa istanza. |
upgradeHistory[] |
Solo output. La cronologia degli upgrade di questa istanza. |
id |
Solo output. ID univoco della risorsa. |
healthState |
Solo output. instanceHealthState. |
healthInfo |
Solo output. Informazioni aggiuntive sull'integrità dell'istanza. Esempio: Un oggetto contenente un elenco di coppie |
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: |
disableProxyAccess |
Facoltativo. Se il valore è true, l'istanza del notebook non verrà registrata con il proxy. |
labels |
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 |
thirdPartyProxyUrl |
Solo output. L'endpoint proxy dei pool di forza lavoro utilizzato per accedere al notebook Jupyter. |
satisfiesPzs |
Solo output. Riservato per l'uso futuro per la separazione delle zone. |
satisfiesPzi |
Solo output. Riservato per l'uso futuro per l'isolamento della zona. |
enableThirdPartyIdentity |
Facoltativo. Flag che specifica che è possibile accedere a un blocco note con un provider di identità di terze parti. |
enableManagedEuc |
Facoltativo. Flag per abilitare le credenziali utente finale gestite per l'istanza. |
enableDeletionProtection |
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. |
Campo unione infrastructure. Configurazione dell'istanza notebook. infrastructure può essere solo uno dei seguenti tipi: |
|
gceSetup |
Facoltativo. Configurazione di Compute Engine per il blocco note. Utilizza i campi definiti nel blocco note. |
GceSetup
La definizione di come configurare un'istanza VM al di fuori di Risorse e identità.
| Rappresentazione JSON |
|---|
{ "machineType": string, "minCpuPlatform": string, "acceleratorConfigs": [ { object ( |
| Campi | |
|---|---|
machineType |
Facoltativo. Il tipo di macchina dell'istanza VM. https://cloud.google.com/compute/docs/machine-resource |
minCpuPlatform |
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[] |
Facoltativo. Gli acceleratori hardware utilizzati in questa istanza. Se utilizzi acceleratori, assicurati che la configurazione disponga di vCPU e memoria sufficienti per supportare il |
serviceAccounts[] |
Facoltativo. Il account di servizio che funge da identità per l'istanza VM. Al momento supporta un solo account di servizio. |
bootDisk |
Facoltativo. Il disco di avvio della VM. |
dataDisks[] |
Facoltativo. Dischi di dati collegati all'istanza VM. Al momento supporta solo un disco di dati. |
shieldedInstanceConfig |
Facoltativo. Configurazione di Shielded VM. Immagini che utilizzano le funzionalità Shielded VM supportate. |
networkInterfaces[] |
Facoltativo. Le interfacce di rete per la VM. Supporta una sola interfaccia. |
disablePublicIp |
Facoltativo. Se è true, a questa istanza VM non verrà assegnato alcun IP esterno. |
tags[] |
Facoltativo. I tag di rete Compute Engine da aggiungere al runtime (vedi Aggiungere tag di rete). |
metadata |
Facoltativo. Metadati personalizzati da applicare a questa istanza. Un oggetto contenente un elenco di coppie |
enableIpForwarding |
Facoltativo. Flag per attivare o meno l'inoltro IP, il valore predefinito è false/off. https://cloud.google.com/vpc/docs/using-routes#canipforward |
gpuDriverConfig |
Facoltativo. Configurazione dei driver GPU. |
confidentialInstanceConfig |
Facoltativo. Configurazione dell'istanza confidenziale. |
instanceId |
Solo output. L'ID univoco della risorsa istanza di Compute Engine. |
Campo unione image. Tipo di immagine; può essere un'immagine VM o un'immagine container. image può essere solo uno dei seguenti tipi: |
|
vmImage |
Facoltativo. Utilizza un'immagine VM di Compute Engine per avviare l'istanza del blocco note. |
containerImage |
Facoltativo. Utilizza un'immagine container per avviare l'istanza del blocco note. |
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 ( |
| Campi | |
|---|---|
type |
Facoltativo. Tipo di questo acceleratore. |
coreCount |
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 |
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_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 |
Il tipo di acceleratore è NVIDIA Tesla P100 Virtual Workstations. |
NVIDIA_TESLA_P4_VWS |
Il tipo di acceleratore è workstation virtuali NVIDIA Tesla P4. |
NVIDIA_B200 |
Il tipo di acceleratore è NVIDIA B200. |
ServiceAccount
Un account di servizio che funge da identità.
| Rappresentazione JSON |
|---|
{ "email": string, "scopes": [ string ] } |
| Campi | |
|---|---|
email |
Facoltativo. Indirizzo email del account di servizio. |
scopes[] |
Solo output. L'elenco degli ambiti da rendere disponibili per questo account di servizio. Impostato da 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, // Union field |
| Campi | |
|---|---|
project |
Obbligatorio. Il nome del progetto Google Cloud a cui appartiene questa immagine VM. Formato: |
Campo unione image. Il riferimento a un'immagine VM di Compute Engine esterna. image può essere solo uno dei seguenti tipi: |
|
name |
Facoltativo. Utilizza il nome dell'immagine VM per trovare l'immagine. |
family |
Facoltativo. Utilizza questa famiglia di immagini VM per trovare l'immagine. Verrà utilizzata l'immagine più recente di questa famiglia. |
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 |
Obbligatorio. Il percorso del repository dell'immagine container. Ad esempio: |
tag |
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 ( |
| Campi | |
|---|---|
diskSizeGb |
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 |
Facoltativo. Indica il tipo di disco. |
diskEncryption |
Facoltativo. Solo input. Metodo di crittografia del disco utilizzato sui dischi di avvio e dati, il valore predefinito è GMEK. |
kmsKey |
Facoltativo. 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. |
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 a un'istanza.
| Rappresentazione JSON |
|---|
{ "diskSizeGb": string, "diskType": enum ( |
| Campi | |
|---|---|
diskSizeGb |
Facoltativo. La dimensione 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 |
Facoltativo. Solo input. Indica il tipo di disco. |
diskEncryption |
Facoltativo. Solo input. Metodo di crittografia del disco utilizzato sui dischi di avvio e dati, il valore predefinito è GMEK. |
kmsKey |
Facoltativo. 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. |
resourcePolicies[] |
Facoltativo. I criteri della risorsa da applicare al disco di dati. |
ShieldedInstanceConfig
Un insieme di opzioni di Shielded Instance. 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 |
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. Disabilitato per impostazione predefinita. |
enableVtpm |
Facoltativo. Definisce se la vTPM è abilitata nell'istanza VM. |
enableIntegrityMonitoring |
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 baseline dei criteri di integrità. Questa baseline viene inizialmente derivata dall'immagine di avvio implicitamente attendibile quando viene creata l'istanza VM. |
NetworkInterface
La definizione di una risorsa di interfaccia di rete collegata a una VM.
| Rappresentazione JSON |
|---|
{ "network": string, "subnet": string, "nicType": enum ( |
| Campi | |
|---|---|
network |
Facoltativo. Il nome del VPC in cui si trova questa istanza VM. Formato: |
subnet |
Facoltativo. Il nome della subnet in cui si trova questa istanza VM. Formato: |
nicType |
Facoltativo. Il tipo di vNIC da utilizzare su questa interfaccia. Può essere gVNIC o VirtioNet. |
accessConfigs[] |
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. |
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 |
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 |
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 GPU non verrà installato. Applicabile solo alle istanze con GPU. |
customGpuDriverPath |
Facoltativo. Specifica un percorso Cloud Storage personalizzato in cui è memorizzato il driver della GPU. Se non specificati, scegliamo automaticamente tra i driver GPU ufficiali. |
ConfidentialInstanceConfig
Un insieme di opzioni di istanza confidenziale.
| Rappresentazione JSON |
|---|
{
"confidentialInstanceType": enum ( |
| Campi | |
|---|---|
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 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. |
UpgradeHistoryEntry
La voce della cronologia di upgrade dell'immagine VM.
| Rappresentazione JSON |
|---|
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum ( |
| Campi | |
|---|---|
snapshot |
Facoltativo. Lo snapshot del disco di avvio di questa istanza notebook prima dell'upgrade. |
vmImage |
Facoltativo. L'immagine VM prima dell'upgrade di questa istanza. |
containerImage |
Facoltativo. L'immagine container prima dell'upgrade di questa istanza. |
framework |
Facoltativo. Il framework di questa istanza notebook. |
version |
Facoltativo. La versione dell'istanza notebook prima di questo upgrade. |
state |
Solo output. Lo stato di questa voce della cronologia di upgrade dell'istanza. |
createTime |
Immutabile. L'ora in cui viene creata questa voce della cronologia dell'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: |
action |
Facoltativo. Azione. Esegui il rollback o l'upgrade. |
targetVersion |
Facoltativo. Versione 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 si trova in uno stato non integro (ad esempio, i daemon critici non sono in esecuzione). Si applica allo stato ACTIVE. |
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 dello stato di integrità dell'istanza non è in esecuzione. Si applica allo stato ATTIVO. |
Metodi |
|
|---|---|
|
Controlla se è possibile eseguire l'upgrade di un'istanza notebook. |
|
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. |
|
Restituisce vari parametri di configurazione. |
|
Recupera la policy di controllo dell'accesso per una risorsa. |
|
Elenca le istanze in un progetto e una località specifici. |
|
UpdateInstance aggiorna un'istanza. |
|
Reimposta un'istanza notebook. |
|
Ridimensiona un disco dell'istanza notebook a una capacità superiore. |
|
RestoreInstance ripristina un'istanza da un BackupSource. |
|
Esegue il rollback di un'istanza di notebook alla versione precedente. |
|
Imposta la policy di controllo dell'accesso sulla risorsa specificata. |
|
Avvia un'istanza di notebook. |
|
Arresta un'istanza notebook. |
|
Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata. |
|
Esegue l'upgrade di un'istanza di notebook all'ultima versione. |