Package google.cloud.notebooks.v1

Indice

ManagedNotebookService

Servizio API v1 per Notebook gestiti.

CreateRuntime

rpc CreateRuntime(CreateRuntimeRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
DeleteRuntime

rpc DeleteRuntime(DeleteRuntimeRequest) returns (Operation)

Elimina un singolo runtime.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
GetRuntime

rpc GetRuntime(GetRuntimeRequest) returns (Runtime)

Recupera i dettagli di un singolo runtime. La località deve essere un endpoint regionale anziché di zona.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ListRuntimes

rpc ListRuntimes(ListRuntimesRequest) returns (ListRuntimesResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
MigrateRuntime

rpc MigrateRuntime(MigrateRuntimeRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ReportRuntimeEvent

rpc ReportRuntimeEvent(ReportRuntimeEventRequest) returns (Operation)

Genera report ed elabora un evento di runtime.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ResetRuntime

rpc ResetRuntime(ResetRuntimeRequest) returns (Operation)

Reimposta un runtime del notebook gestito.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
StartRuntime

rpc StartRuntime(StartRuntimeRequest) returns (Operation)

Avvia un runtime di notebook gestito. Esegui "Avvia" sulle istanze GPU; "Riprendi" sulle istanze CPU. Vedi: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
StopRuntime

rpc StopRuntime(StopRuntimeRequest) returns (Operation)

Arresta un runtime di notebook gestito. Esegui "Arresta" sulle istanze GPU; "Sospendi" sulle istanze CPU. Vedi: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
SwitchRuntime

rpc SwitchRuntime(SwitchRuntimeRequest) returns (Operation)

Cambia il runtime di un notebook gestito.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
UpdateRuntime

rpc UpdateRuntime(UpdateRuntimeRequest) returns (Operation)

Aggiorna la configurazione di runtime del notebook.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.

NotebookService

Servizio API v1 per Cloud AI Platform Notebooks.

CreateEnvironment

rpc CreateEnvironment(CreateEnvironmentRequest) returns (Operation)

Crea un nuovo ambiente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
CreateExecution

rpc CreateExecution(CreateExecutionRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
CreateInstance

rpc CreateInstance(CreateInstanceRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
CreateSchedule

rpc CreateSchedule(CreateScheduleRequest) returns (Operation)

Crea un nuovo notebook pianificato in un progetto e una località specifici.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
DeleteEnvironment

rpc DeleteEnvironment(DeleteEnvironmentRequest) returns (Operation)

Elimina un singolo ambiente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
DeleteExecution

rpc DeleteExecution(DeleteExecutionRequest) returns (Operation)

Elimina l'esecuzione

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
DeleteInstance

rpc DeleteInstance(DeleteInstanceRequest) returns (Operation)

Elimina una singola istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
DeleteSchedule

rpc DeleteSchedule(DeleteScheduleRequest) returns (Operation)

Elimina la pianificazione e tutti i job sottostanti

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
DiagnoseInstance

rpc DiagnoseInstance(DiagnoseInstanceRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
GetEnvironment

rpc GetEnvironment(GetEnvironmentRequest) returns (Environment)

Recupera i dettagli di un singolo ambiente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
GetExecution

rpc GetExecution(GetExecutionRequest) returns (Execution)

Recupera i dettagli delle esecuzioni

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
GetInstance

rpc GetInstance(GetInstanceRequest) returns (Instance)

Recupera i dettagli di una singola istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
GetInstanceHealth

rpc GetInstanceHealth(GetInstanceHealthRequest) returns (GetInstanceHealthResponse)

Verifica se un'istanza notebook è in stato integro.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
GetSchedule

rpc GetSchedule(GetScheduleRequest) returns (Schedule)

Recupera i dettagli della pianificazione

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
IsInstanceUpgradeable

rpc IsInstanceUpgradeable(IsInstanceUpgradeableRequest) returns (IsInstanceUpgradeableResponse)

Controlla se è possibile eseguire l'upgrade di un'istanza notebook.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ListEnvironments

rpc ListEnvironments(ListEnvironmentsRequest) returns (ListEnvironmentsResponse)

Elenca gli ambienti in un progetto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ListExecutions

rpc ListExecutions(ListExecutionsRequest) returns (ListExecutionsResponse)

Elenca le esecuzioni in un progetto e una località specifici

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ListInstances

rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ListSchedules

rpc ListSchedules(ListSchedulesRequest) returns (ListSchedulesResponse)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
MigrateInstance

rpc MigrateInstance(MigrateInstanceRequest) returns (Operation)

Esegue la migrazione di un notebook gestito dall'utente esistente alle istanze di Workbench.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
RegisterInstance

rpc RegisterInstance(RegisterInstanceRequest) returns (Operation)

Registra un'istanza di notebook legacy esistente nel server dell'API Notebooks. Le istanze legacy sono istanze create con le chiamate Compute Engine legacy. Non sono gestibili dall'API Notebooks pronte all'uso. Questa chiamata rende queste istanze gestibili dall'API Notebooks.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ReportInstanceInfo

rpc ReportInstanceInfo(ReportInstanceInfoRequest) returns (Operation)

Consente alle istanze notebook di segnalare le informazioni più recenti sull'istanza al server API Notebooks. Il server unirà le informazioni segnalate all'archivio dei metadati dell'istanza. Non utilizzare questo metodo direttamente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
ResetInstance

rpc ResetInstance(ResetInstanceRequest) returns (Operation)

Reimposta un'istanza notebook.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
RollbackInstance

rpc RollbackInstance(RollbackInstanceRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
SetInstanceAccelerator

rpc SetInstanceAccelerator(SetInstanceAcceleratorRequest) returns (Operation)

Aggiorna gli acceleratori guest di una singola istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
SetInstanceLabels

rpc SetInstanceLabels(SetInstanceLabelsRequest) returns (Operation)

Sostituisce tutte le etichette di un'istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
SetInstanceMachineType

rpc SetInstanceMachineType(SetInstanceMachineTypeRequest) returns (Operation)

Aggiorna il tipo di macchina di una singola istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
StartInstance

rpc StartInstance(StartInstanceRequest) returns (Operation)

Avvia un'istanza di notebook.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
StopInstance

rpc StopInstance(StopInstanceRequest) returns (Operation)

Arresta un'istanza notebook.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
UpdateInstanceConfig

rpc UpdateInstanceConfig(UpdateInstanceConfigRequest) returns (Operation)

Aggiorna le configurazioni dell'istanza di notebook.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
UpdateInstanceMetadataItems

rpc UpdateInstanceMetadataItems(UpdateInstanceMetadataItemsRequest) returns (UpdateInstanceMetadataItemsResponse)

Aggiungi/aggiorna elementi di metadati per un'istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
UpdateShieldedInstanceConfig

rpc UpdateShieldedInstanceConfig(UpdateShieldedInstanceConfigRequest) returns (Operation)

Aggiorna la configurazione dell'istanza schermata di una singola istanza.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.
UpgradeInstance

rpc UpgradeInstance(UpgradeInstanceRequest) returns (Operation)

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per saperne di più, consulta la Authentication Overview.

ContainerImage

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

Campi
repository

string

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

string

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

CreateEnvironmentRequest

Richiesta di creazione di un ambiente notebook.

Campi
parent

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.environments.create
environment_id

string

Obbligatorio. ID univoco definito dall'utente di questo ambiente. environment_id deve contenere da 1 a 63 caratteri e solo lettere minuscole, caratteri numerici e trattini. Il primo carattere deve essere una lettera minuscola e l'ultimo non può essere un trattino.
environment

Environment

Obbligatorio. L'ambiente da creare.

CreateExecutionRequest

Richiesta di creazione dell'esecuzione del notebook

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.executions.create
execution_id

string

Obbligatorio. ID univoco definito dall'utente di questa esecuzione.
execution

Execution

Obbligatorio. L'esecuzione da creare.

CreateInstanceRequest

Richiesta di creazione di un'istanza di notebook.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.instances.create
instance_id

string

Obbligatorio. ID univoco definito dall'utente di questa istanza.
instance

Instance

Obbligatorio. L'istanza da creare.

CreateRuntimeRequest

Richiesta di creazione di un runtime di notebook gestiti.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.runtimes.create
runtime_id

string

Obbligatorio. ID univoco definito dall'utente di questo runtime.
runtime

Runtime

Obbligatorio. Il runtime da creare.
request_id

string

UUID della richiesta idempotente.

CreateScheduleRequest

Richiesta di notebook pianificati creati

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.schedules.create
schedule_id

string

Obbligatorio. ID univoco definito dall'utente di questa pianificazione.
schedule

Schedule

Obbligatorio. La pianificazione da creare.

DeleteEnvironmentRequest

Richiesta di eliminazione di un ambiente notebook.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/environments/{environment_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.environments.delete

DeleteExecutionRequest

Richiesta di eliminazione di un'esecuzione pianificata del notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/executions/{execution_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.executions.delete

DeleteInstanceRequest

Richiesta di eliminazione di un'istanza di notebook.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.delete

DeleteRuntimeRequest

Richiesta di eliminazione di un runtime di Managed Notebooks.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.runtimes.delete
request_id

string

UUID della richiesta idempotente.

DeleteScheduleRequest

Richiesta di eliminazione di una programmazione

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/schedules/{schedule_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.schedules.delete

DiagnoseInstanceRequest

Richiesta di creazione di un file di diagnostica dell'istanza di blocco note.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}
diagnostic_config

DiagnosticConfig

Obbligatorio. Definisce i flag utilizzati per eseguire lo strumento di diagnostica
timeout_minutes

int32

Facoltativo. Quantità massima di tempo in minuti prima del timeout dell'operazione.

DiagnosticConfig

Definisce i flag utilizzati per eseguire lo strumento di diagnostica

Campi
gcs_bucket

string

Obbligatorio. (OBBLIGATORIO) Posizione del bucket Cloud Storage dell'utente. Deve essere formattato con il prefisso del percorso (gs://$GCS_BUCKET).

Autorizzazioni: User Managed Notebooks: - storage.buckets.writer: deve essere concesso al account di servizio del progetto collegato alla VM. Google Managed Notebooks: - storage.buckets.writer: deve essere concesso al account di servizio del progetto o alle credenziali utente associate alla VM a seconda della modalità di autenticazione.

Il file di log del bucket Cloud Storage verrà scritto in gs://$GCS_BUCKET/$RELATIVE_PATH/$VM_DATE_$TIME.tar.gz
relative_path

string

Facoltativo. Definisce il percorso di archiviazione relativo nel bucket Cloud Storage in cui verranno scritti i log di diagnostica: il percorso predefinito sarà la directory radice del bucket Cloud Storage (gs://$GCS_BUCKET/$DATE_$TIME.tar.gz). Esempio di percorso completo in cui verrà scritto il file di log: gs://$GCS_BUCKET/$RELATIVE_PATH/
repair_flag_enabled

bool

Facoltativo. Attiva il flag per il servizio di riparazione per l'istanza
packet_capture_flag_enabled

bool

Facoltativo. Attiva il flag per acquisire pacchetti dall'istanza per 30 secondi
copy_home_files_flag_enabled

bool

Facoltativo. Attiva il flag per copiare tutti i contenuti della cartella /home/jupyter

EncryptionConfig

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

Campi
kms_key

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}

Ambiente

Definizione di un ambiente software utilizzato per avviare un'istanza notebook.

Campi
name

string

Solo output. Il nome di questo ambiente. Formato: projects/{project_id}/locations/{location}/environments/{environment_id}
display_name

string

Nome visualizzato di questo ambiente per la UI.
description

string

Una breve descrizione di questo ambiente.
post_startup_script

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. Esempio: "gs://path-to-file/file-name"
create_time

Timestamp

Solo output. L'ora in cui è stato creato questo ambiente.
Campo unione image_type. Tipo di ambiente; può essere un'immagine VM o un'immagine container. image_type può essere solo uno dei seguenti tipi:
vm_image

VmImage

Utilizza un'immagine VM di Compute Engine per avviare l'istanza del blocco note.
container_image

ContainerImage

Utilizza un'immagine container per avviare l'istanza del blocco note.

Evento

La definizione di un evento per un'istanza di notebook gestita / semigestita.

Campi
report_time

Timestamp

Ora della segnalazione dell'evento.
type

EventType

Tipo di evento.
details

map<string, string>

Facoltativo. Dettagli dell'evento. Questo campo viene utilizzato per trasmettere le informazioni sugli eventi.

EventType

La definizione dei tipi di eventi.

Enum
EVENT_TYPE_UNSPECIFIED L'evento non è specificato.
IDLE L'istanza / il runtime è inattivo
HEARTBEAT L'istanza / il runtime è disponibile. Questo evento indica che l'istanza / il runtime di calcolo sottostante è operativo.
HEALTH L'integrità dell'istanza / del runtime è disponibile. Questo evento indica le informazioni sull'integrità dell'istanza / del runtime.
MAINTENANCE L'istanza / il runtime è disponibile. Questo evento consente all'istanza / al runtime di inviare informazioni sulla manutenzione dell'host al Control Plane. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance

Esecuzione

La definizione di un singolo notebook eseguito.

Campi
execution_template

ExecutionTemplate

execute metadata including name, hardware spec, region, labels, etc.
name

string

Solo output. Il nome della risorsa dell'esecuzione. Formato: projects/{project_id}/locations/{location}/executions/{execution_id}
display_name

string

Solo output. Nome utilizzato per scopi dell'interfaccia utente. Il nome può contenere solo caratteri alfanumerici e trattini bassi "_".
description

string

Una breve descrizione di questa esecuzione.
create_time

Timestamp

Solo output. L'ora in cui è stata creata l'esecuzione.
update_time

Timestamp

Solo output. Ora dell'ultimo aggiornamento dell'esecuzione.
state

State

Solo output. Stato del job AI Platform sottostante.
output_notebook_file

string

File del notebook di output generato da questa esecuzione
job_uri

string

Solo output. L'URI del job esterno utilizzato per eseguire il notebook.

Stato

Descrizione dell'enumerazione dello stato del job AIP sottostante.

Enum
STATE_UNSPECIFIED Lo stato del job non è specificato.
QUEUED Il job è stato appena creato e l'elaborazione non è ancora iniziata.
PREPARING Il servizio si sta preparando per l'esecuzione del job.
RUNNING Il job è in corso.
SUCCEEDED Il job è stato completato correttamente.
FAILED Il job non è riuscito. error_message deve contenere i dettagli dell'errore.
CANCELLING Il job è in fase di annullamento. error_message deve descrivere il motivo dell'annullamento.
CANCELLED Il job è stato annullato. error_message deve descrivere il motivo dell'annullamento.
EXPIRED Il job è scaduto (pertinente per i job di Agent Platform) https://cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/JobState
INITIALIZING È in corso la creazione dell'esecuzione.

ExecutionTemplate

La descrizione di un carico di lavoro di esecuzione del notebook.

Campi
scale_tier
(deprecated)

ScaleTier

Obbligatorio. Livello di scalabilità dell'hardware utilizzato per l'esecuzione del notebook. DEPRECATO Verrà ritirato. Al momento è supportato solo CUSTOM.
master_type

string

Specifica il tipo di macchina virtuale da utilizzare per il worker master del job di addestramento. Devi specificare questo campo quando scaleTier è impostato su CUSTOM.

Puoi utilizzare determinati tipi di macchine Compute Engine direttamente in questo campo. Sono supportati i seguenti tipi:

  • n1-standard-4
  • n1-standard-8
  • n1-standard-16
  • n1-standard-32
  • n1-standard-64
  • n1-standard-96
  • n1-highmem-2
  • n1-highmem-4
  • n1-highmem-8
  • n1-highmem-16
  • n1-highmem-32
  • n1-highmem-64
  • n1-highmem-96
  • n1-highcpu-16
  • n1-highcpu-32
  • n1-highcpu-64
  • n1-highcpu-96

In alternativa, puoi utilizzare i seguenti tipi di macchine legacy:

  • standard
  • large_model
  • complex_model_s
  • complex_model_m
  • complex_model_l
  • standard_gpu
  • complex_model_m_gpu
  • complex_model_l_gpu
  • standard_p100
  • complex_model_m_p100
  • standard_v100
  • large_model_v100
  • complex_model_m_v100
  • complex_model_l_v100

Infine, se vuoi utilizzare una TPU per l'addestramento, specifica cloud_tpu in questo campo. Scopri di più sulle opzioni di configurazione speciali per l'addestramento con le TPU.
accelerator_config

SchedulerAcceleratorConfig

Configurazione (conteggio e tipo di acceleratore) per l'hardware che esegue l'esecuzione del notebook.
labels

map<string, string>

Etichette per l'esecuzione. Se l'esecuzione è pianificata, verrà incluso un campo denominato "nbs-scheduled". In caso contrario, si tratta di un'esecuzione immediata e il campo incluso sarà "nbs-immediate". Utilizza i campi per indicizzare in modo efficiente i vari tipi di esecuzione.
input_notebook_file

string

Percorso del file notebook da eseguire. Deve trovarsi in un bucket Google Cloud Storage. Formato: gs://{bucket_name}/{folder}/{notebook_file_name} Esempio: gs://notebook_user/scheduled_notebooks/sentiment_notebook.ipynb
container_image_uri

string

URI dell'immagine container per un esempio di DLVM: "gcr.io/deeplearning-platform-release/base-cu100". Altri esempi sono disponibili all'indirizzo: https://cloud.google.com/ai-platform/deep-learning-containers/docs/choosing-container
output_notebook_folder

string

Percorso della cartella del notebook in cui scrivere. Deve trovarsi in un percorso del bucket Google Cloud Storage. Formato: gs://{bucket_name}/{folder} Esempio: gs://notebook_user/scheduled_notebooks
params_yaml_file

string

Parametri da sostituire nel notebook durante l'esecuzione. Consulta la pagina https://papermill.readthedocs.io/en/latest/usage-parameterize.html per informazioni su come specificare i parametri nel notebook di input e trasferirli qui in un file YAML. Esempio: gs://notebook_user/scheduled_notebooks/sentiment_notebook_params.yaml
parameters

string

Parametri utilizzati nel notebook "input_notebook_file".
service_account

string

L'indirizzo email di un account di servizio da utilizzare durante l'esecuzione. Devi disporre dell'autorizzazione iam.serviceAccounts.actAs per il account di servizio specificato.
job_type

JobType

Il tipo di job da utilizzare in questa esecuzione.
kernel_spec

string

Nome della specifica del kernel da utilizzare. Questo valore deve essere specificato se il nome della specifica del kernel nella destinazione di esecuzione non corrisponde a quello nel file del notebook di input.
tensorboard

string

Il nome di una risorsa [TensorBoard] di Agent Platform a cui questa esecuzione caricherà i log di TensorBoard. Formato: projects/{project}/locations/{location}/tensorboards/{tensorboard}
Campo unione job_parameters. Parametri per un tipo di esecuzione. NOTA: al momento non sono disponibili parametri aggiuntivi per i job Vertex AI. job_parameters può essere solo uno dei seguenti tipi:
dataproc_parameters

DataprocParameters

Parametri utilizzati nelle esecuzioni di JobType Dataproc.
vertex_ai_parameters

VertexAIParameters

Parametri utilizzati nelle esecuzioni di JobType di Agent Platform.

DataprocParameters

Parametri utilizzati nelle esecuzioni di JobType Dataproc.

Campi
cluster

string

URI del cluster utilizzato per eseguire l'esecuzione di Dataproc. Formato: projects/{PROJECT_ID}/regions/{REGION}/clusters/{CLUSTER_NAME}

JobType

Il backend utilizzato per questa esecuzione.

Enum
JOB_TYPE_UNSPECIFIED Nessun tipo specificato.
VERTEX_AI Job personalizzato in aiplatform.googleapis.com. Valore predefinito per un'esecuzione.
DATAPROC Esegui l'esecuzione su un cluster con Dataproc come job. https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs

ScaleTier

Obbligatorio. Specifica i tipi di macchine, il numero di repliche per i worker e i server dei parametri.

Enum
SCALE_TIER_UNSPECIFIED Livello di scalabilità non specificato.
BASIC Una singola istanza worker. Questo livello è adatto per imparare a utilizzare Cloud ML e per sperimentare nuovi modelli utilizzando piccoli set di dati.
STANDARD_1 Molti worker e alcuni server dei parametri.
PREMIUM_1 Un numero elevato di worker con molti server dei parametri.
BASIC_GPU Una singola istanza worker con una GPU K80.
BASIC_TPU Una singola istanza worker con una Cloud TPU.
CUSTOM

Il livello CUSTOM non è un livello predefinito, ma ti consente di utilizzare le tue specifiche del cluster. Quando utilizzi questo livello, imposta i valori per configurare il cluster di elaborazione in base a queste linee guida:

  • Devi impostare ExecutionTemplate.masterType per specificare il tipo di macchina da utilizzare per il nodo master. Questa è l'unica impostazione obbligatoria.

SchedulerAcceleratorConfig

Definizione di un acceleratore hardware. Tieni presente che non tutte le combinazioni di type e core_count sono valide. Consulta la sezione GPU su Compute Engine per trovare una combinazione valida. Le TPU non sono supportate.

Campi
type

SchedulerAcceleratorType

Tipo di questo acceleratore.
core_count

int64

Conteggio dei core di questo acceleratore.

SchedulerAcceleratorType

Tipi di acceleratori hardware per i job di AI Platform Training.

Enum
SCHEDULER_ACCELERATOR_TYPE_UNSPECIFIED Tipo di acceleratore non specificato. Il valore predefinito è nessuna GPU.
NVIDIA_TESLA_K80 GPU Nvidia Tesla K80.
NVIDIA_TESLA_P100 GPU Nvidia Tesla P100.
NVIDIA_TESLA_V100 GPU Nvidia Tesla V100.
NVIDIA_TESLA_P4 GPU Nvidia Tesla P4.
NVIDIA_TESLA_T4 GPU Nvidia Tesla T4.
NVIDIA_TESLA_A100 GPU Nvidia Tesla A100.
TPU_V2 TPU v2.
TPU_V3 TPU v3.

VertexAIParameters

Parametri utilizzati nelle esecuzioni di JobType di Agent Platform.

Campi
network

string

Il nome completo della rete Compute Engine verso cui deve essere eseguito il peering del job. Ad esempio, projects/12345/global/networks/myVPC. Formato ha la forma projects/{project}/global/networks/{network}. Dove {project} è un numero di progetto, ad esempio 12345, e {network} è un nome di rete.

L'accesso privato ai servizi deve essere già configurato per la rete. Se non specificato, il job non viene sottoposto a peering con alcuna rete.
env

map<string, string>

Variabili di ambiente. È possibile specificare al massimo 100 variabili di ambiente, che devono essere univoche. Esempio: GCP_BUCKET=gs://my-bucket/samples/

GetEnvironmentRequest

Richiesta per ottenere un ambiente notebook.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/environments/{environment_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.environments.get

GetExecutionRequest

Richiesta per ottenere l'esecuzione pianificata del notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/executions/{execution_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.executions.get

GetInstanceHealthRequest

Richiesta di controllo dell'integrità di un'istanza notebook.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.getHealth

GetInstanceHealthResponse

Risposta per verificare se un'istanza notebook è integra.

Campi
health_state

HealthState

Solo output. Runtime health_state.
health_info

map<string, string>

Solo output. Informazioni aggiuntive sull'integrità dell'istanza. Example: healthInfo": { "docker_proxy_agent_status": "1", "docker_status": "1", "jupyterlab_api_status": "-1", "jupyterlab_status": "-1", "updated": "2020-10-18 09:40:03.573409" }

HealthState

Se un'istanza è integra o meno.

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.

GetInstanceRequest

Richiesta di ottenere un'istanza notebook.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.get

GetRuntimeRequest

Richiesta di ottenere un runtime di Managed Notebook.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.runtimes.get

GetScheduleRequest

Richiesta per ottenere il notebook pianificato.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/schedules/{schedule_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.schedules.get

Istanza

La definizione di un'istanza notebook.

Campi
name

string

Solo output. Il nome di questa istanza del notebook. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}
post_startup_script

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).
proxy_uri

string

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

string

Solo input. 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 dell'account di servizio possono utilizzare l'istanza.
service_account

string

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 viene specificato, viene utilizzato il service account Compute Engine predefinito.
service_account_scopes[]

string

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
machine_type

string

Obbligatorio. Il tipo di macchina Compute Engine di questa istanza.
accelerator_config

AcceleratorConfig

L'acceleratore hardware utilizzato in questa istanza. Se utilizzi acceleratori, assicurati che la configurazione disponga di vCPU e memoria sufficienti per supportare il machine_type che hai selezionato.
state

State

Solo output. Lo stato di questa istanza.
install_gpu_driver

bool

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 GPU non verrà installato. Applicabile solo alle istanze con GPU.
custom_gpu_driver_path

string

Specifica un percorso Cloud Storage personalizzato in cui è memorizzato il driver della GPU. Se non specificati, scegliamo automaticamente tra i driver GPU ufficiali.
boot_disk_type

DiskType

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

int64

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

DiskType

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

int64

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

bool

Solo input. Se è true, il disco di dati non verrà eliminato automaticamente quando viene eliminata l'istanza.
disk_encryption

DiskEncryption

Solo input. Metodo di crittografia del disco utilizzato sui dischi di avvio e dati, il valore predefinito è GMEK.
kms_key

string

Solo input. La chiave KMS utilizzata per criptare i dischi, applicabile solo se disk_encryption è CMEK. Formato: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

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

Disk

Solo output. Dischi collegati all'istanza del notebook.
shielded_instance_config

ShieldedInstanceConfig

Facoltativo. Configurazione di Shielded VM. Immagini che utilizzano le funzionalità Shielded VM supportate.
no_public_ip

bool

Se è vero, a questa istanza non verrà assegnato alcun IP esterno.
no_proxy_access

bool

Se il valore è true, l'istanza del notebook non verrà registrata con il proxy.
network

string

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

string

Il nome della subnet in cui si trova questa istanza. Formato: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
labels

map<string, string>

Etichette da applicare a questa istanza. Questi possono essere modificati in un secondo momento con il metodo setLabels.
metadata

map<string, string>

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 gcs-data-bucket. Formato: "--metadata=gcs-data-bucket=BUCKET".
tags[]

string

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

UpgradeHistoryEntry

La cronologia degli upgrade di questa istanza.
nic_type

NicType

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

ReservationAffinity

Facoltativo. L'affinità di prenotazione facoltativa. Se imposti questo campo, la prenotazione di Compute Engine di zona specificata verrà applicata a questa istanza notebook.
creator

string

Solo output. Indirizzo email dell'entità che ha inviato la richiesta CreateInstance originale.
can_ip_forward

bool

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

Timestamp

Solo output. Ora di creazione dell'istanza.
update_time

Timestamp

Solo output. Ora di aggiornamento dell'istanza.
instance_migration_eligibility

InstanceMigrationEligibility

Solo output. Verifica la fattibilità di una migrazione da UmN a WbI.
Campo unione environment. Tipo di ambiente; può essere un'immagine VM o un'immagine container. environment può essere solo uno dei seguenti tipi:
vm_image

VmImage

Utilizza un'immagine VM di Compute Engine per avviare l'istanza del blocco note.
container_image

ContainerImage

Utilizza un'immagine container per avviare l'istanza del blocco note.
migrated

bool

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 core_count sono valide. Consulta la sezione GPU su Compute Engine per trovare una combinazione valida. Le TPU non sono supportate.

Campi
type

AcceleratorType

Tipo di questo acceleratore.
core_count

int64

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 è NVIDIA Tesla P100 Virtual Workstations.
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.

Disco

Una risorsa disco collegata a un'istanza.

Campi
auto_delete

bool

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

bool

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

string

Indica un nome univoco del dispositivo a tua scelta che viene riflesso 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 al fine di eseguire operazioni come montaggio, ridimensionamento e così via direttamente dall'istanza.

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

int64

Indica le dimensioni del disco in GB base 2.
guest_os_features[]

GuestOsFeature

Indica 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.
index

int64

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

string

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:

  • NVME
  • SCSI
kind

string

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

string

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

string

La modalità di collegamento di questo disco, READ_WRITE o READ_ONLY. Se non specificato, il valore predefinito è l'attacco del disco in modalità READ_WRITE. Valori validi:

  • READ_ONLY
  • READ_WRITE
source

string

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

string

Indica il tipo di disco: SCRATCH o PERSISTENT. Valori validi:

  • PERSISTENT
  • SCRATCH

GuestOsFeature

Funzionalità del sistema operativo guest per il disco di avvio.

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

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.

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.

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

ShieldedInstanceConfig

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

Campi
enable_secure_boot

bool

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. Disabilitato per impostazione predefinita.
enable_vtpm

bool

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

bool

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

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.
REGISTERING L'istanza è in fase di registrazione.
SUSPENDING L'istanza è in fase di sospensione.
SUSPENDED L'istanza è sospesa.

UpgradeHistoryEntry

La voce della cronologia di upgrade dell'immagine VM.

Campi
snapshot

string

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

string

L'immagine VM prima dell'upgrade di questa istanza.
container_image

string

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

string

Il framework di questa istanza notebook.
version

string

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

State

Lo stato di questa voce della cronologia di upgrade dell'istanza.
create_time

Timestamp

L'ora in cui viene creata questa voce della cronologia dell'upgrade dell'istanza.
target_image
(deprecated)

string

Immagine VM di destinazione. Formato: ainotebooks-vm/project/image-name/name.
action

Action

Azione. Esegui il rollback o l'upgrade.
target_version

string

Versione VM di destinazione, ad esempio m63.

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.

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.

InstanceConfig

Configurazioni delle istanze notebook che possono essere aggiornate.

Campi
notebook_upgrade_schedule

string

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

bool

Verifica che i servizi interni principali siano in esecuzione.

InstanceMigrationEligibility

InstanceMigrationEligibility rappresenta le informazioni sulla fattibilità di una migrazione da UmN a WbI.

Campi
warnings[]

Warning

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

Error

Solo output. Alcune configurazioni rendono l'UmN non idoneo per una migrazione automatica. È necessaria una migrazione manuale.

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.

Avviso

Un messaggio di avviso relativo alla 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 no_remove_data_disk, 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 post_startup_script_option per la migrazione.

IsInstanceUpgradeableRequest

Richiesta di controllo per verificare se è possibile eseguire l'upgrade di un'istanza notebook.

Campi
notebook_instance

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa notebookInstance specificata:

  • notebooks.instances.checkUpgradability
type

UpgradeType

Facoltativo. UpgradeType facoltativo. Se imposti questo campo, verranno cercate immagini di calcolo aggiuntive per eseguire l'upgrade di questa istanza.

IsInstanceUpgradeableResponse

Risposta per verificare se è possibile eseguire l'upgrade di un'istanza notebook.

Campi
upgradeable

bool

Se è possibile eseguire l'upgrade di un'istanza.
upgrade_version

string

La versione a cui verrà eseguito l'upgrade di questa istanza se viene chiamato l'endpoint di upgrade. Questo campo verrà compilato solo se field_upgradeable è true.
upgrade_info

string

Informazioni aggiuntive sull'upgrade.
upgrade_image

string

Il nuovo self-link dell'immagine a cui verrà eseguito l'upgrade di questa istanza se viene chiamato l'endpoint di upgrade. Questo campo verrà compilato solo se field_upgradeable è true.

ListEnvironmentsRequest

Richiesta di ambienti di elenco.

Campi
parent

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.environments.list
page_size

int32

Dimensione massima di ritorno della chiamata di elenco.
page_token

string

Un token di pagina restituito in precedenza che può essere utilizzato per continuare l'elenco dall'ultimo risultato.

ListEnvironmentsResponse

Risposta per l'elenco degli ambienti.

Campi
environments[]

Environment

Un elenco di ambienti restituiti.
next_page_token

string

Un token di pagina che può essere utilizzato per continuare l'elenco dall'ultimo risultato nella chiamata dell'elenco successivo.
unreachable[]

string

Località non raggiungibili.

ListExecutionsRequest

Richiesta di elencare le esecuzioni di notebook pianificate.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.executions.list
page_size

int32

Dimensione massima di ritorno della chiamata di elenco.
page_token

string

Un token di pagina restituito in precedenza che può essere utilizzato per continuare l'elenco dall'ultimo risultato.
filter

string

Filtro applicato alle esecuzioni risultanti. Al momento supporta solo il filtraggio delle esecuzioni in base a un schedule_id specificato. Formato: schedule_id=<Schedule_ID>
order_by

string

Ordina per campo.

ListExecutionsResponse

Risposta per l'elenco delle esecuzioni di notebook pianificate

Campi
executions[]

Execution

Un elenco di istanze restituite.
next_page_token

string

Token di pagina che può essere utilizzato per continuare l'elenco dall'ultimo risultato nella chiamata dell'elenco successivo.
unreachable[]

string

ID esecuzione non raggiungibili. Ad esempio:

['projects/{project_id}/location/{location}/executions/imagenet_test1',
 'projects/{project_id}/location/{location}/executions/classifier_train1']

ListInstancesRequest

Richiesta di elencare le istanze di notebook.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.instances.list
page_size

int32

Dimensione massima di ritorno della chiamata di elenco.
page_token

string

Un token di pagina restituito in precedenza che può essere utilizzato per continuare l'elenco dall'ultimo risultato.
order_by

string

Facoltativo. Ordina i risultati. I valori supportati sono "name", "name desc" o "" (non ordinato).
filter

string

Facoltativo. Filtro elenco.

ListInstancesResponse

Risposta per elencare le istanze di Notebooks.

Campi
instances[]

Instance

Un elenco di istanze restituite.
next_page_token

string

Token di pagina che può essere utilizzato per continuare l'elenco dall'ultimo risultato nella chiamata dell'elenco successivo.
unreachable[]

string

Località non raggiungibili. Ad esempio, ['us-west1-a', 'us-central1-b']. Una ListInstancesResponse conterrà solo istanze o elementi non raggiungibili,

ListRuntimesRequest

Richiesta di elencare gli ambienti di runtime dei blocchi note gestiti.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.runtimes.list
page_size

int32

Dimensione massima di ritorno della chiamata di elenco.
page_token

string

Un token di pagina restituito in precedenza che può essere utilizzato per continuare l'elenco dall'ultimo risultato.
order_by

string

Facoltativo. Ordina i risultati. I valori supportati sono "name", "name desc" o "" (non ordinato).
filter

string

Facoltativo. Filtro elenco.

ListRuntimesResponse

Risposta per l'elenco dei runtime di Managed Notebook.

Campi
runtimes[]

Runtime

Un elenco di runtime restituiti.
next_page_token

string

Token di pagina che può essere utilizzato per continuare l'elenco dall'ultimo risultato nella chiamata dell'elenco successivo.
unreachable[]

string

Località non raggiungibili. Ad esempio, ['us-west1', 'us-central1']. Una ListRuntimesResponse conterrà solo runtime o unreachables,

ListSchedulesRequest

Richiesta di elencare il job notebook pianificato.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.schedules.list
page_size

int32

Dimensione massima di ritorno della chiamata di elenco.
page_token

string

Un token di pagina restituito in precedenza che può essere utilizzato per continuare l'elenco dall'ultimo risultato.
filter

string

Filtro applicato alle pianificazioni risultanti.
order_by

string

Campo in base al quale ordinare i risultati.

ListSchedulesResponse

Risposta per l'elenco dei job del notebook pianificati.

Campi
schedules[]

Schedule

Un elenco di istanze restituite.
next_page_token

string

Token di pagina che può essere utilizzato per continuare l'elenco dall'ultimo risultato nella chiamata dell'elenco successivo.
unreachable[]

string

Programmazioni non raggiungibili. Ad esempio:

['projects/{project_id}/location/{location}/schedules/monthly_digest',
 'projects/{project_id}/location/{location}/schedules/weekly_sentiment']

LocalDisk

Una risorsa disco locale collegato.

Campi
auto_delete

bool

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

bool

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

string

Facoltativo. Solo output. Specifica un nome univoco del dispositivo a tua scelta che viene riflesso 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 al fine di eseguire operazioni come montaggio, ridimensionamento e così via direttamente dall'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.
guest_os_features[]

RuntimeGuestOsFeature

Solo output. Indica 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.
index

int32

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

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à è reciprocamente esclusiva della 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à di collegamento di questo disco, READ_WRITE o READ_ONLY. Se non specificato, il valore predefinito è l'attacco del 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.

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à è reciprocamente esclusiva della proprietà sorgente. Puoi definire solo una delle due, ma non entrambe.

Campi
description

string

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

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

int64

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

DiskType

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

map<string, string>

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

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.

MigrateInstanceRequest

Richiesta di migrazione di un notebook gestito dall'utente alle istanze di Workbench.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede una o più delle seguenti autorizzazioni IAM per la risorsa name specificata:

  • notebooks.instances.get
  • notebooks.instances.create
post_startup_script_option

PostStartupScriptOption

Facoltativo. Specifica il comportamento dello script post-avvio durante la migrazione.

PostStartupScriptOption

Specifica il comportamento dello script post-avvio durante la migrazione.

Enum
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED L'opzione dello script post-avvio non è specificata. Il valore predefinito è POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Non eseguire la migrazione dello script post-avvio alla nuova istanza Workbench.
POST_STARTUP_SCRIPT_OPTION_RERUN Scarica di nuovo ed esegui di nuovo lo stesso script post-avvio del notebook gestito dall'utente.

MigrateInstanceResponse

Questo tipo non contiene campi.

Tipo di risposta del messaggio vuoto per MigrateInstance.

MigrateRuntimeRequest

Richiesta di migrazione di un runtime a un'istanza di Workbench.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede una o più delle seguenti autorizzazioni IAM per la risorsa name specificata:

  • notebooks.runtimes.get
  • notebooks.instances.create
network

string

Facoltativo. Il nome del VPC in cui si trova la nuova istanza. Questo passaggio è obbligatorio se il runtime utilizza la rete gestita da Google. Se il runtime utilizza una rete di proprietà del cliente, riutilizzerà lo stesso VPC e questo campo deve essere vuoto. Formato: projects/{project_id}/global/networks/{network_id}
subnet

string

Facoltativo. Il nome della subnet in cui si trova la nuova istanza. Questo passaggio è obbligatorio se il runtime utilizza la rete gestita da Google. Se il runtime utilizza la rete di proprietà del cliente, riutilizzerà la stessa subnet e questo campo deve essere vuoto. Formato: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
service_account

string

Facoltativo. Il account di servizio da includere nell'istanza Compute Engine della nuova istanza Workbench quando il runtime utilizza la modalità "solo singolo utente" per l'autorizzazione. Se non viene specificato, viene utilizzato il service account Compute Engine predefinito. Quando il runtime utilizza la modalità account di servizio per l'autorizzazione, riutilizza lo stesso account di servizio e questo campo deve essere vuoto.
request_id

string

Facoltativo. UUID della richiesta idempotente.
post_startup_script_option

PostStartupScriptOption

Facoltativo. Specifica il comportamento dello script post-avvio durante la migrazione.

PostStartupScriptOption

Specifica il comportamento dello script post-avvio durante la migrazione.

Enum
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED L'opzione dello script post-avvio non è specificata. Il valore predefinito è POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Non eseguire la migrazione dello script post-avvio alla nuova istanza Workbench.
POST_STARTUP_SCRIPT_OPTION_RERUN Scarica di nuovo ed esegui lo stesso script post-avvio del notebook gestito da Google.

OperationMetadata

Rappresenta i metadati dell'operazione a lunga esecuzione.

Campi
create_time

Timestamp

L'ora in cui è stata creata l'operazione.
end_time

Timestamp

L'ora in cui è terminata l'esecuzione dell'operazione.
target

string

Percorso della risorsa definito dal server per la destinazione dell'operazione.
verb

string

Nome del verbo eseguito dall'operazione.
status_message

string

Stato dell'operazione leggibile, se presente.
requested_cancellation

bool

Indica se l'utente ha richiesto l'annullamento dell'operazione. Le operazioni annullate correttamente hanno un valore google.longrunning.Operation.error con un google.rpc.Status.code pari a 1, corrispondente a Code.CANCELLED.
api_version

string

Versione dell'API utilizzata per avviare l'operazione.
endpoint

string

Nome dell'endpoint API di questa operazione.

RegisterInstanceRequest

Richiesta di registrazione di un'istanza notebook.

Campi
parent

string

Obbligatorio. Formato: parent=projects/{project_id}/locations/{location}

L'autorizzazione richiede il seguente permesso IAM per la risorsa parent specificata:

  • notebooks.instances.create
instance_id

string

Obbligatorio. ID univoco definito dall'utente di questa istanza. instance_id deve contenere da 1 a 63 caratteri e solo lettere minuscole, caratteri numerici e trattini. Il primo carattere deve essere una lettera minuscola e l'ultimo non può essere un trattino.

ReportInstanceInfoRequest

Richiesta di istanze notebook per segnalare informazioni all'API Notebooks.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}
vm_id

string

Obbligatorio. Il token hardware della VM per l'autenticazione della VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
metadata

map<string, string>

I metadati segnalati all'API Notebooks. Verrà unito all'archivio dei metadati dell'istanza

ReportRuntimeEventRequest

Richiesta di segnalazione di un evento del notebook gestito.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • iam.permissions.none
vm_id

string

Obbligatorio. Il token hardware della VM per l'autenticazione della VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
event

Event

Obbligatorio. L'evento da segnalare.

ReservationAffinity

Affinità di prenotazione per l'utilizzo della prenotazione a livello di zona.

Campi
consume_reservation_type

Type

Facoltativo. Tipo di prenotazione da consumare
key

string

Facoltativo. Corrisponde alla chiave di etichetta della risorsa di prenotazione.
values[]

string

Facoltativo. Corrisponde ai valori etichetta della risorsa di prenotazione.

Tipo

Indica se utilizzare o meno la capacità di una prenotazione.

Enum
TYPE_UNSPECIFIED Tipo predefinito.
NO_RESERVATION Non consumare 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.

ResetInstanceRequest

Richiesta di reimpostazione di un'istanza notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.reset

ResetRuntimeRequest

Richiesta di reimpostazione di un runtime di notebook gestito.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.runtimes.reset
request_id

string

UUID della richiesta idempotente.

RollbackInstanceRequest

Richiesta di rollback di un'istanza di notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • iam.permissions.none
target_snapshot

string

Obbligatorio. Lo snapshot per il rollback. Esempio: projects/test-project/global/snapshots/krwlzipynril.

Runtime

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

Campi
name

string

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

State

Solo output. Stato del runtime.
health_state

HealthState

Solo output. Runtime health_state.
access_config

RuntimeAccessConfig

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

RuntimeSoftwareConfig

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

RuntimeMetrics

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

Timestamp

Solo output. Ora di creazione del runtime.
update_time

Timestamp

Solo output. Ora di aggiornamento del runtime.
labels

map<string, string>

Facoltativo. Le etichette da associare a questo notebook o runtime gestito. Le chiavi delle etichette 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.
runtime_migration_eligibility

RuntimeMigrationEligibility

Solo output. Verifica la fattibilità di una migrazione da GmN a WbI.
Campo unione runtime_type. Tipo di runtime; al momento supporta solo la VM Compute Engine. runtime_type può essere solo uno dei seguenti tipi:
virtual_machine

VirtualMachine

Utilizza un'immagine VM di Compute Engine per avviare l'istanza del blocco note gestito.
migrated

bool

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

HealthState

Il substato 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.

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 blocco note. Non può essere utilizzato.
ACTIVE Il runtime è attualmente in esecuzione. È pronto per l'uso.
STOPPING La logica di controllo sta interrompendo l'esecuzione. 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.

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
Campi
type

AcceleratorType

Modello dell'acceleratore.
core_count

int64

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 è NVIDIA Tesla P100 Virtual Workstations.
NVIDIA_TESLA_P4_VWS Il tipo di acceleratore è workstation virtuali NVIDIA Tesla P4.

RuntimeAccessConfig

Specifica la configurazione di accesso per Runtime

Campi
access_type

RuntimeAccessType

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

string

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

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 solo utente.

Enum
RUNTIME_ACCESS_TYPE_UNSPECIFIED Accesso non specificato.
SINGLE_USER Accesso per singolo utente.
SERVICE_ACCOUNT Modalità service account. In 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 al runtime devono disporre dell'autorizzazione ActAs (utente service account).

RuntimeMetrics

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

Campi
system_metrics

map<string, string>

Solo output. Le metriche di sistema.

RuntimeMigrationEligibility

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

Campi
warnings[]

Warning

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

Error

Solo output. Alcune configurazioni rendono l'account Google Merchant Center non idoneo per una migrazione automatica. È necessaria una migrazione manuale.

Errore

Un messaggio di errore di migrazione indica che determinate configurazioni rendono l'account Google 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.

Avviso

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

Enum
WARNING_UNSPECIFIED Tipo predefinito.
UNSUPPORTED_ACCELERATOR_TYPE Il gruppo di nodi 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 notebook 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 post_startup_script_option per la migrazione.
SINGLE_USER Questo GmN è configurato con la modalità utente singolo. (Facoltativo) Fornisci l'opzione service_account per la migrazione.

RuntimeShieldedInstanceConfig

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

Campi
enable_secure_boot

bool

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. Disabilitato per impostazione predefinita.
enable_vtpm

bool

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

bool

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

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:

  • idle_shutdown: true
  • idle_shutdown_timeout: 180
  • enable_health_monitoring: true
Campi
notebook_upgrade_schedule

string

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

int32

Tempo in minuti di attesa prima dell'arresto del runtime. Predefinito: 180 minuti
install_gpu_driver

bool

Installa automaticamente il driver Nvidia. Valore predefinito: true
custom_gpu_driver_path

string

Specifica un percorso Cloud Storage personalizzato in cui è memorizzato il driver della GPU. Se non specificati, scegliamo automaticamente tra i driver GPU ufficiali.
post_startup_script

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[]

ContainerImage

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

PostStartupScriptBehavior

Comportamento dello script di avvio post-installazione.
enable_health_monitoring

bool

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

bool

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

bool

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

bool

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

string

Solo output. Versione dell'immagine di avvio, ad esempio M100, dall'etichetta di rilascio dell'immagine.
mixer_disabled

bool

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

PostStartupScriptBehavior

Comportamento dello script di avvio post-installazione.

Enum
POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED Comportamento dello script di avvio 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.

Pianifica

La definizione di una programmazione.

Campi
name

string

Solo output. Il nome di questa pianificazione. Formato: projects/{project_id}/locations/{location}/schedules/{schedule_id}
display_name

string

Solo output. Nome visualizzato utilizzato a scopo di UI. Il nome può contenere solo caratteri alfanumerici, trattini - e trattini bassi _.
description

string

Una breve descrizione di questo ambiente.
state

State
cron_schedule

string

Pianificazione in formato cron-tab in base alla quale verrà eseguito il job. Formato: minuto, ora, giorno del mese, mese, giorno della settimana, ad es.0 0 * * WED = ogni mercoledì. Altri esempi: https://crontab.guru/examples.html
time_zone

string

Fuso orario su cui si basa cron_schedule. Il valore di questo campo deve essere un nome di fuso orario del database tz. Database TZ: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Tieni presente che alcuni fusi orari includono una disposizione per l'ora legale. Le regole per l'ora legale sono determinate dal fuso orario scelto. Per UTC, utilizza la stringa "utc". Se non viene specificato un fuso orario, il valore predefinito sarà UTC (noto anche come GMT).
create_time

Timestamp

Solo output. Ora in cui è stata creata la pianificazione.
update_time

Timestamp

Solo output. Ora dell'ultimo aggiornamento della pianificazione.
execution_template

ExecutionTemplate

Template di esecuzione del notebook corrispondente a questa pianificazione.
recent_executions[]

Execution

Solo output. I nomi delle esecuzioni più recenti attivate da questa pianificazione e i relativi stati.

Stato

Stato del job.

Enum
STATE_UNSPECIFIED Stato non specificato.
ENABLED Il job viene eseguito normalmente.
PAUSED Il job viene messo in pausa dall'utente. Non verrà eseguito. Un utente può mettere in pausa intenzionalmente il job utilizzando Cloud Scheduler.
DISABLED Il job è disattivato dal sistema a causa di un errore. L'utente non può impostare direttamente un job da disattivare.
UPDATE_FAILED Lo stato del job risultante da un'operazione CloudScheduler.UpdateJob non riuscita. Per recuperare un job da questo stato, riprova CloudScheduler.UpdateJob finché non ricevi una risposta riuscita.
INITIALIZING La risorsa di pianificazione è in fase di creazione.
DELETING La risorsa di pianificazione è in fase di eliminazione.

SetInstanceAcceleratorRequest

Richiesta di impostazione dell'acceleratore dell'istanza.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.setAccelerator
type

AcceleratorType

Obbligatorio. Tipo di questo acceleratore.
core_count

int64

Obbligatorio. Conteggio dei core di questo acceleratore. Tieni presente che non tutte le combinazioni di type e core_count sono valide. Consulta la sezione GPU su Compute Engine per trovare una combinazione valida. Le TPU non sono supportate.

SetInstanceLabelsRequest

Richiesta di impostazione delle etichette dell'istanza.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.setLabels
labels

map<string, string>

Etichette da applicare a questa istanza. Questi possono essere modificati in un secondo momento con il metodo setLabels

SetInstanceMachineTypeRequest

Richiesta di impostazione del tipo di macchina dell'istanza.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.setMachineType
machine_type

string

Obbligatorio. Il tipo di macchina Compute Engine.

StartInstanceRequest

Richiesta di avvio di un'istanza di notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.start

StartRuntimeRequest

Richiesta di avvio di un runtime del notebook gestito.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.runtimes.start
request_id

string

UUID della richiesta idempotente.

StopInstanceRequest

Richiesta di arresto di un'istanza di notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.stop

StopRuntimeRequest

Richiesta di arresto di un runtime di Managed Notebooks.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.runtimes.stop
request_id

string

UUID della richiesta idempotente.

SwitchRuntimeRequest

Richiesta di cambio di un runtime del notebook gestito.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.runtimes.switch
machine_type

string

tipo di macchina.
accelerator_config

RuntimeAcceleratorConfig

configurazione dell'acceleratore.
request_id

string

UUID della richiesta idempotente.

UpdateInstanceConfigRequest

Richiesta di aggiornamento delle configurazioni dell'istanza.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.updateConfig
config

InstanceConfig

Le configurazioni dell'istanza da aggiornare.

UpdateInstanceMetadataItemsRequest

Richiesta di aggiunta/modifica di elementi di metadati per un'istanza.

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.updateConfig
items

map<string, string>

Elementi di metadati da aggiungere/aggiornare per l'istanza.

UpdateInstanceMetadataItemsResponse

Risposta per l'aggiunta/modifica di elementi di metadati per un'istanza.

Campi
items

map<string, string>

Mappa degli elementi aggiunti/aggiornati ai/nei metadati.

UpdateRuntimeRequest

Richiesta di aggiornamento di una configurazione di Managed Notebook.

Campi
runtime

Runtime

Obbligatorio. Il runtime da aggiornare.

L'autorizzazione richiede il seguente permesso IAM per la risorsa runtime specificata:

  • notebooks.runtimes.update
update_mask

FieldMask

Obbligatorio. Specifica il percorso, relativo a Runtime, del campo da aggiornare. Ad esempio, per modificare i kernel di configurazione del software, il parametro update_mask verrebbe specificato come software_config.kernels e il corpo della richiesta PATCH specificherebbe il nuovo valore, come segue:

{
  "software_config":{
    "kernels": [{
       'repository':
       'gcr.io/deeplearning-platform-release/pytorch-gpu', 'tag':
       'latest' }],
    }
}

Al momento, è possibile aggiornare solo i seguenti campi:

  • software_config.kernels
  • software_config.post_startup_script
  • software_config.custom_gpu_driver_path
  • software_config.idle_shutdown
  • software_config.idle_shutdown_timeout
  • software_config.disable_terminal
  • labels
request_id

string

UUID della richiesta idempotente.

UpdateShieldedInstanceConfigRequest

Richiesta di aggiornamento della configurazione dell'istanza schermata per un'istanza di notebook. Puoi utilizzare questo metodo solo su un'istanza arrestata

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.updateShieldInstanceConfig
shielded_instance_config

ShieldedInstanceConfig

Configurazione di ShieldedInstance da aggiornare.

UpgradeInstanceRequest

Richiesta di upgrade di un'istanza di notebook

Campi
name

string

Obbligatorio. Formato: projects/{project_id}/locations/{location}/instances/{instance_id}

L'autorizzazione richiede il seguente permesso IAM per la risorsa name specificata:

  • notebooks.instances.upgrade
type

UpgradeType

Facoltativo. UpgradeType facoltativo. Se imposti questo campo, verranno cercate immagini di calcolo aggiuntive per eseguire l'upgrade di questa istanza.

UpgradeType

Definizione dei tipi di upgrade che possono essere utilizzati su questa istanza.

Enum
UPGRADE_TYPE_UNSPECIFIED Il tipo di upgrade non è specificato.
UPGRADE_FRAMEWORK Esegui l'upgrade del framework ML.
UPGRADE_OS Esegui l'upgrade del sistema operativo.
UPGRADE_CUDA Esegui l'upgrade di CUDA.
UPGRADE_ALL Esegui l'upgrade di tutto (sistema operativo, framework e CUDA).

VirtualMachine

Runtime che utilizza la macchina virtuale per il calcolo.

Campi
instance_name

string

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

string

Solo output. L'identificatore univoco dell'istanza di Compute Engine gestita.
virtual_machine_config

VirtualMachineConfig

Impostazioni di configurazione della macchina virtuale.

VirtualMachineConfig

Le impostazioni di configurazione per la macchina virtuale.

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
machine_type

string

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

ContainerImage

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

LocalDisk

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

EncryptionConfig

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

RuntimeShieldedInstanceConfig

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

RuntimeAcceleratorConfig

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

string

Facoltativo. La rete Compute Engine da utilizzare per le comunicazioni delle 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/[project_id]/global/networks/default
  • projects/[project_id]/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 (i campi Rete e Subnet sono vuoti)
  • 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 Compute Engine da utilizzare per le comunicazioni delle 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/[project_id]/regions/us-east1/subnetworks/sub0
  • projects/[project_id]/regions/us-east1/subnetworks/sub0
internal_ip_only

bool

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 internal_ip_only 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).
guest_attributes

map<string, string>

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

map<string, string>

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

map<string, string>

Facoltativo. Le etichette da associare a questo runtime. Le chiavi delle etichette 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.
nic_type

NicType

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

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
boot_image

BootImage

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

BootImage

Questo tipo non contiene campi.

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

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

VmImage

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

Campi
project

string

Obbligatorio. Il nome del progetto Google Cloud a cui appartiene questa immagine VM. Formato: {project_id}
Campo unione image. Il riferimento a un'immagine VM di Compute Engine esterna. image può essere solo uno dei seguenti tipi:
image_name

string

Utilizza il nome dell'immagine VM per trovare l'immagine.
image_family

string

Utilizza questa famiglia di immagini VM per trovare l'immagine. Verrà utilizzata l'immagine più recente di questa famiglia.