Package google.cloud.notebooks.v1

Indeks

ManagedNotebookService

Layanan API v1 untuk Managed Notebooks.

CreateRuntime

rpc CreateRuntime(CreateRuntimeRequest) returns (Operation)

Membuat Runtime baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
DeleteRuntime

rpc DeleteRuntime(DeleteRuntimeRequest) returns (Operation)

Menghapus satu Runtime.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
GetRuntime

rpc GetRuntime(GetRuntimeRequest) returns (Runtime)

Mendapatkan detail satu Runtime. Lokasi harus berupa endpoint regional, bukan zonal.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ListRuntimes

rpc ListRuntimes(ListRuntimesRequest) returns (ListRuntimesResponse)

Mencantumkan Runtime dalam project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
MigrateRuntime

rpc MigrateRuntime(MigrateRuntimeRequest) returns (Operation)

Memigrasikan Runtime yang ada ke Instance Workbench baru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ReportRuntimeEvent

rpc ReportRuntimeEvent(ReportRuntimeEventRequest) returns (Operation)

Melaporkan dan memproses peristiwa runtime.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ResetRuntime

rpc ResetRuntime(ResetRuntimeRequest) returns (Operation)

Mereset Managed Notebook Runtime.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
StartRuntime

rpc StartRuntime(StartRuntimeRequest) returns (Operation)

Memulai Managed Notebook Runtime. Lakukan "Start" pada instance GPU; "Resume" pada instance CPU. Lihat: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
StopRuntime

rpc StopRuntime(StopRuntimeRequest) returns (Operation)

Menghentikan Managed Notebook Runtime. Lakukan "Stop" pada instance GPU; "Suspend" pada instance CPU Lihat: https://cloud.google.com/compute/docs/instances/stop-start-instance https://cloud.google.com/compute/docs/instances/suspend-resume-instance

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
SwitchRuntime

rpc SwitchRuntime(SwitchRuntimeRequest) returns (Operation)

Mengganti Runtime Notebook Terkelola.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
UpdateRuntime

rpc UpdateRuntime(UpdateRuntimeRequest) returns (Operation)

Perbarui konfigurasi Notebook Runtime.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

NotebookService

Layanan API v1 untuk Cloud AI Platform Notebooks.

CreateEnvironment

rpc CreateEnvironment(CreateEnvironmentRequest) returns (Operation)

Membuat Lingkungan baru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
CreateExecution

rpc CreateExecution(CreateExecutionRequest) returns (Operation)

Membuat Eksekusi baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
CreateInstance

rpc CreateInstance(CreateInstanceRequest) returns (Operation)

Membuat Instance baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
CreateSchedule

rpc CreateSchedule(CreateScheduleRequest) returns (Operation)

Membuat Notebook Terjadwal baru di project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
DeleteEnvironment

rpc DeleteEnvironment(DeleteEnvironmentRequest) returns (Operation)

Menghapus satu Lingkungan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
DeleteExecution

rpc DeleteExecution(DeleteExecutionRequest) returns (Operation)

Menghapus eksekusi

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
DeleteInstance

rpc DeleteInstance(DeleteInstanceRequest) returns (Operation)

Menghapus satu Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
DeleteSchedule

rpc DeleteSchedule(DeleteScheduleRequest) returns (Operation)

Menghapus jadwal dan semua tugas yang mendasarinya

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
DiagnoseInstance

rpc DiagnoseInstance(DiagnoseInstanceRequest) returns (Operation)

Membuat File Diagnostik dan menjalankan Alat Diagnostik yang diberikan Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
GetEnvironment

rpc GetEnvironment(GetEnvironmentRequest) returns (Environment)

Mendapatkan detail satu Lingkungan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
GetExecution

rpc GetExecution(GetExecutionRequest) returns (Execution)

Mendapatkan detail eksekusi

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
GetInstance

rpc GetInstance(GetInstanceRequest) returns (Instance)

Mendapatkan detail satu Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
GetInstanceHealth

rpc GetInstanceHealth(GetInstanceHealthRequest) returns (GetInstanceHealthResponse)

Memeriksa apakah instance notebook responsif atau tidak.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
GetSchedule

rpc GetSchedule(GetScheduleRequest) returns (Schedule)

Mendapatkan detail jadwal

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
IsInstanceUpgradeable

rpc IsInstanceUpgradeable(IsInstanceUpgradeableRequest) returns (IsInstanceUpgradeableResponse)

Memeriksa apakah instance notebook dapat diupgrade.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ListEnvironments

rpc ListEnvironments(ListEnvironmentsRequest) returns (ListEnvironmentsResponse)

Mencantumkan lingkungan dalam project.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ListExecutions

rpc ListExecutions(ListExecutionsRequest) returns (ListExecutionsResponse)

Mencantumkan eksekusi dalam project dan lokasi tertentu

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ListInstances

rpc ListInstances(ListInstancesRequest) returns (ListInstancesResponse)

Mencantumkan instance dalam project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ListSchedules

rpc ListSchedules(ListSchedulesRequest) returns (ListSchedulesResponse)

Mencantumkan jadwal dalam project dan lokasi tertentu.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
MigrateInstance

rpc MigrateInstance(MigrateInstanceRequest) returns (Operation)

Memigrasikan Notebook yang Dikelola Pengguna yang ada ke Instance Workbench.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
RegisterInstance

rpc RegisterInstance(RegisterInstanceRequest) returns (Operation)

Mendaftarkan instance notebook lama yang ada ke server Notebooks API. Instance lama adalah instance yang dibuat dengan panggilan Compute Engine lama. Secara default, instance ini tidak dapat dikelola oleh Notebooks API. Panggilan ini membuat instance tersebut dapat dikelola oleh Notebooks API.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ReportInstanceInfo

rpc ReportInstanceInfo(ReportInstanceInfoRequest) returns (Operation)

Mengizinkan instance notebook melaporkan informasi instance terbarunya ke server Notebooks API. Server akan menggabungkan informasi yang dilaporkan ke penyimpanan metadata instance. Jangan gunakan metode ini secara langsung.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
ResetInstance

rpc ResetInstance(ResetInstanceRequest) returns (Operation)

Mereset instance notebook.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
RollbackInstance

rpc RollbackInstance(RollbackInstanceRequest) returns (Operation)

Melakukan roll back instance notebook ke versi sebelumnya.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
SetInstanceAccelerator

rpc SetInstanceAccelerator(SetInstanceAcceleratorRequest) returns (Operation)

Memperbarui akselerator tamu dari satu Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
SetInstanceLabels

rpc SetInstanceLabels(SetInstanceLabelsRequest) returns (Operation)

Mengganti semua label Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
SetInstanceMachineType

rpc SetInstanceMachineType(SetInstanceMachineTypeRequest) returns (Operation)

Memperbarui jenis mesin satu Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
StartInstance

rpc StartInstance(StartInstanceRequest) returns (Operation)

Memulai instance notebook.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
StopInstance

rpc StopInstance(StopInstanceRequest) returns (Operation)

Menghentikan instance notebook.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
UpdateInstanceConfig

rpc UpdateInstanceConfig(UpdateInstanceConfigRequest) returns (Operation)

Perbarui konfigurasi Instance Notebook.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
UpdateInstanceMetadataItems

rpc UpdateInstanceMetadataItems(UpdateInstanceMetadataItemsRequest) returns (UpdateInstanceMetadataItemsResponse)

Menambahkan/memperbarui item metadata untuk instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
UpdateShieldedInstanceConfig

rpc UpdateShieldedInstanceConfig(UpdateShieldedInstanceConfigRequest) returns (Operation)

Memperbarui konfigurasi instance Terlindungi dari satu Instance.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.
UpgradeInstance

rpc UpgradeInstance(UpgradeInstanceRequest) returns (Operation)

Mengupgrade instance notebook ke versi terbaru.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ContainerImage

Definisi image container untuk memulai instance notebook dengan lingkungan yang diinstal dalam container.

Kolom
repository

string

Wajib. Jalur ke repositori image container. Contoh: gcr.io/{project_id}/{image_name}
tag

string

Tag image container. Jika tidak ditentukan, defaultnya adalah tag terbaru.

CreateEnvironmentRequest

Permintaan untuk membuat lingkungan notebook.

Kolom
parent

string

Wajib. Format: projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.environments.create
environment_id

string

Wajib. ID unik yang ditentukan pengguna untuk lingkungan ini. environment_id harus memiliki panjang 1 hingga 63 karakter dan hanya berisi huruf kecil, karakter numerik, dan tanda hubung. Karakter pertama harus berupa huruf kecil dan karakter terakhir tidak boleh berupa tanda hubung.
environment

Environment

Wajib. Lingkungan yang akan dibuat.

CreateExecutionRequest

Permintaan untuk membuat eksekusi notebook

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.executions.create
execution_id

string

Wajib. ID unik yang ditentukan pengguna untuk eksekusi ini.
execution

Execution

Wajib. Eksekusi yang akan dibuat.

CreateInstanceRequest

Permintaan untuk membuat instance notebook.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.instances.create
instance_id

string

Wajib. ID unik yang ditentukan pengguna untuk instance ini.
instance

Instance

Wajib. Instance yang akan dibuat.

CreateRuntimeRequest

Permintaan untuk membuat Runtime Notebook Terkelola.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.runtimes.create
runtime_id

string

Wajib. ID unik yang ditentukan pengguna untuk Runtime ini.
runtime

Runtime

Wajib. Runtime yang akan dibuat.
request_id

string

UUID permintaan idempoten.

CreateScheduleRequest

Permintaan untuk notebook terjadwal yang dibuat

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.schedules.create
schedule_id

string

Wajib. ID unik yang ditentukan pengguna untuk jadwal ini.
schedule

Schedule

Wajib. Jadwal yang akan dibuat.

DeleteEnvironmentRequest

Permintaan untuk menghapus lingkungan notebook.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/environments/{environment_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.environments.delete

DeleteExecutionRequest

Permintaan untuk menghapus eksekusi notebook terjadwal

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/executions/{execution_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.executions.delete

DeleteInstanceRequest

Permintaan untuk menghapus instance notebook.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.delete

DeleteRuntimeRequest

Permintaan untuk menghapus Managed Notebook Runtime.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.runtimes.delete
request_id

string

UUID permintaan idempoten.

DeleteScheduleRequest

Permintaan untuk menghapus Jadwal

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/schedules/{schedule_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.schedules.delete

DiagnoseInstanceRequest

Permintaan untuk membuat file diagnostik instance notebook.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}
diagnostic_config

DiagnosticConfig

Wajib. Menentukan flag yang digunakan untuk menjalankan alat diagnostik
timeout_minutes

int32

Opsional. Jumlah waktu maksimum dalam menit sebelum operasi kehabisan waktu.

DiagnosticConfig

Menentukan flag yang digunakan untuk menjalankan alat diagnostik

Kolom
gcs_bucket

string

Wajib. Lokasi bucket Cloud Storage pengguna (WAJIB). Harus diformat dengan awalan jalur (gs://$GCS_BUCKET).

Izin: Notebook yang Dikelola Pengguna: - storage.buckets.writer: Harus diberikan ke akun layanan project yang terlampir ke VM. Google Managed Notebooks: - storage.buckets.writer: Harus diberikan ke akun layanan project atau kredensial pengguna yang terlampir ke VM, bergantung pada mode autentikasi.

File Log bucket Cloud Storage akan ditulis ke gs://$GCS_BUCKET/$RELATIVE_PATH/$VM_DATE_$TIME.tar.gz
relative_path

string

Opsional. Menentukan jalur penyimpanan relatif di bucket Cloud Storage tempat log diagnostik akan ditulis: Jalur default adalah direktori root bucket Cloud Storage (gs://$GCS_BUCKET/$DATE_$TIME.tar.gz) Contoh jalur lengkap tempat file Log akan ditulis: gs://$GCS_BUCKET/$RELATIVE_PATH/
repair_flag_enabled

bool

Opsional. Mengaktifkan tanda untuk memperbaiki layanan untuk instance
packet_capture_flag_enabled

bool

Opsional. Mengaktifkan tanda untuk mengambil paket dari instance selama 30 detik
copy_home_files_flag_enabled

bool

Opsional. Mengaktifkan tanda untuk menyalin semua konten folder /home/jupyter

EncryptionConfig

Mewakili konfigurasi kunci enkripsi kustom yang dapat diterapkan ke resource. Tindakan ini akan mengenkripsi semua disk di Virtual Machine.

Kolom
kms_key

string

ID resource Cloud KMS dari kunci enkripsi yang dikelola pelanggan yang digunakan untuk melindungi resource, seperti disk. Formatnya adalah sebagai berikut: projects/{PROJECT_ID}/locations/{REGION}/keyRings/{KEY_RING_NAME}/cryptoKeys/{KEY_NAME}

Lingkungan

Definisi lingkungan software yang digunakan untuk memulai instance notebook.

Kolom
name

string

Hanya output. Nama lingkungan ini. Format: projects/{project_id}/locations/{location}/environments/{environment_id}
display_name

string

Nama tampilan lingkungan ini untuk UI.
description

string

Deskripsi singkat lingkungan ini.
post_startup_script

string

Jalur ke skrip Bash yang otomatis berjalan setelah instance notebook di-boot sepenuhnya. Jalur tersebut harus berupa URL atau jalur Cloud Storage. Contoh: "gs://path-to-file/file-name"
create_time

Timestamp

Hanya output. Waktu saat lingkungan ini dibuat.
Kolom union image_type. Jenis lingkungan; dapat berupa salah satu dari image VM atau image container. image_type hanya ada berupa salah satu diantara berikut:
vm_image

VmImage

Gunakan image VM Compute Engine untuk memulai instance notebook.
container_image

ContainerImage

Gunakan image container untuk memulai instance notebook.

Acara

Definisi Peristiwa untuk instance notebook terkelola / semi-terkelola.

Kolom
report_time

Timestamp

Waktu pelaporan peristiwa.
type

EventType

Jenis peristiwa.
details

map<string, string>

Opsional. Detail acara. Kolom ini digunakan untuk meneruskan informasi peristiwa.

EventType

Definisi jenis peristiwa.

Enum
EVENT_TYPE_UNSPECIFIED Peristiwa tidak ditentukan.
IDLE Instance / runtime tidak ada aktivitas
HEARTBEAT Instance / runtime tersedia. Peristiwa ini menunjukkan bahwa komputasi yang mendasari instance / runtime beroperasi.
HEALTH Kondisi instance / runtime tersedia. Peristiwa ini menunjukkan informasi kesehatan instance / runtime.
MAINTENANCE Instance / runtime tersedia. Peristiwa ini memungkinkan instance / runtime mengirimkan informasi Pemeliharaan host ke Control Plane. https://cloud.google.com/compute/docs/gpus/gpu-host-maintenance

Eksekusi

Definisi satu notebook yang dijalankan.

Kolom
execution_template

ExecutionTemplate

metadata eksekusi termasuk nama, spesifikasi hardware, region, label, dll.
name

string

Hanya output. Nama resource eksekusi. Format: projects/{project_id}/locations/{location}/executions/{execution_id}
display_name

string

Hanya output. Nama yang digunakan untuk tujuan UI. Nama hanya boleh berisi karakter alfanumerik dan garis bawah '_'.
description

string

Deskripsi singkat eksekusi ini.
create_time

Timestamp

Hanya output. Waktu Eksekusi dibuat.
update_time

Timestamp

Hanya output. Waktu Eksekusi terakhir diperbarui.
state

State

Hanya output. Status tugas AI Platform yang mendasarinya.
output_notebook_file

string

File notebook output yang dihasilkan oleh eksekusi ini
job_uri

string

Hanya output. URI tugas eksternal yang digunakan untuk menjalankan notebook.

Negara Bagian

Deskripsi enum status tugas AIP pokok.

Enum
STATE_UNSPECIFIED Status tugas tidak ditentukan.
QUEUED Tugas baru saja dibuat dan pemrosesan belum dimulai.
PREPARING Layanan sedang bersiap untuk menjalankan tugas.
RUNNING Tugas sedang dalam proses.
SUCCEEDED Tugas berhasil diselesaikan.
FAILED Tugas gagal. error_message harus berisi detail kegagalan.
CANCELLING Tugas sedang dibatalkan. error_message harus menjelaskan alasan pembatalan.
CANCELLED Tugas telah dibatalkan. error_message harus menjelaskan alasan pembatalan.
EXPIRED Lowongan telah berakhir (relevan dengan lowongan Platform Agen) https://cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/JobState
INITIALIZING Eksekusi sedang dibuat.

ExecutionTemplate

Deskripsi workload eksekusi notebook.

Kolom
scale_tier
(deprecated)

ScaleTier

Wajib. Tingkat skala hardware yang digunakan untuk eksekusi notebook. TIDAK DIGUNAKAN LAGI Akan dihentikan. Karena saat ini hanya CUSTOM yang didukung.
master_type

string

Menentukan jenis mesin virtual yang akan digunakan untuk pekerja master tugas pelatihan Anda. Anda harus menentukan kolom ini jika scaleTier ditetapkan ke CUSTOM.

Anda dapat menggunakan jenis mesin Compute Engine tertentu secara langsung di kolom ini. Berikut adalah jenis-jenis yang didukung:

  • 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

Atau, Anda dapat menggunakan jenis mesin lama berikut:

  • 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

Terakhir, jika Anda ingin menggunakan TPU untuk pelatihan, tentukan cloud_tpu di kolom ini. Pelajari lebih lanjut opsi konfigurasi khusus untuk pelatihan dengan TPU.
accelerator_config

SchedulerAcceleratorConfig

Konfigurasi (jumlah dan jenis akselerator) untuk hardware yang menjalankan eksekusi notebook.
labels

map<string, string>

Label untuk eksekusi. Jika eksekusi dijadwalkan, kolom yang disertakan adalah 'nbs-scheduled'. Jika tidak, ini adalah eksekusi langsung, dan kolom yang disertakan akan menjadi 'nbs-immediate'. Gunakan kolom untuk mengindeks secara efisien di antara berbagai jenis eksekusi.
input_notebook_file

string

Jalur ke file notebook yang akan dieksekusi. Harus berada di bucket Google Cloud Storage. Format: gs://{bucket_name}/{folder}/{notebook_file_name} Contoh: gs://notebook_user/scheduled_notebooks/sentiment_notebook.ipynb
container_image_uri

string

URI Image Container ke Contoh DLVM: 'gcr.io/deeplearning-platform-release/base-cu100' Contoh lainnya dapat ditemukan di: https://cloud.google.com/ai-platform/deep-learning-containers/docs/choosing-container
output_notebook_folder

string

Jalur ke folder notebook yang akan ditulis. Harus berada di jalur bucket Google Cloud Storage. Format: gs://{bucket_name}/{folder} Contoh: gs://notebook_user/scheduled_notebooks
params_yaml_file

string

Parameter yang akan diganti di notebook selama eksekusi. Lihat https://papermill.readthedocs.io/en/latest/usage-parameterize.html tentang cara menentukan parameter dalam notebook input dan meneruskannya di sini dalam file YAML. Contoh: gs://notebook_user/scheduled_notebooks/sentiment_notebook_params.yaml
parameters

string

Parameter yang digunakan dalam notebook 'input_notebook_file'.
service_account

string

Alamat email akun layanan yang akan digunakan saat menjalankan eksekusi. Anda harus memiliki izin iam.serviceAccounts.actAs untuk akun layanan yang ditentukan.
job_type

JobType

Jenis Tugas yang akan digunakan pada eksekusi ini.
kernel_spec

string

Nama spesifikasi kernel yang akan digunakan. Parameter ini harus ditentukan jika nama spesifikasi kernel pada target eksekusi tidak cocok dengan nama dalam file notebook input.
tensorboard

string

Nama resource Agent Platform [Tensorboard] yang akan diupload log Tensorboard-nya oleh eksekusi ini. Format: projects/{project}/locations/{location}/tensorboards/{tensorboard}
Kolom union job_parameters. Parameter untuk jenis eksekusi. CATATAN: Saat ini tidak ada parameter tambahan untuk tugas VertexAI. job_parameters hanya ada berupa salah satu diantara berikut:
dataproc_parameters

DataprocParameters

Parameter yang digunakan dalam eksekusi JobType Dataproc.
vertex_ai_parameters

VertexAIParameters

Parameter yang digunakan dalam eksekusi JobType Agent Platform.

DataprocParameters

Parameter yang digunakan dalam eksekusi JobType Dataproc.

Kolom
cluster

string

URI untuk cluster yang digunakan untuk menjalankan eksekusi Dataproc. Format: projects/{PROJECT_ID}/regions/{REGION}/clusters/{CLUSTER_NAME}

JobType

Backend yang digunakan untuk eksekusi ini.

Enum
JOB_TYPE_UNSPECIFIED Tidak ada jenis yang ditentukan.
VERTEX_AI Tugas Kustom di aiplatform.googleapis.com. Nilai default untuk eksekusi.
DATAPROC Jalankan eksekusi di cluster dengan Dataproc sebagai tugas. https://cloud.google.com/dataproc/docs/reference/rest/v1/projects.regions.jobs

ScaleTier

Wajib. Menentukan jenis mesin, jumlah replika untuk pekerja dan server parameter.

Enum
SCALE_TIER_UNSPECIFIED Tingkat Skala tidak ditentukan.
BASIC Satu instance pekerja. Tingkatan ini cocok untuk mempelajari cara menggunakan Cloud ML, dan untuk bereksperimen dengan model baru menggunakan set data kecil.
STANDARD_1 Banyak pekerja dan beberapa server parameter.
PREMIUM_1 Sejumlah besar pekerja dengan banyak server parameter.
BASIC_GPU Instance pekerja tunggal dengan GPU K80.
BASIC_TPU Satu instance pekerja dengan Cloud TPU.
CUSTOM

Tingkat KUSTOM bukan tingkat yang ditetapkan, tetapi memungkinkan Anda menggunakan spesifikasi cluster Anda sendiri. Saat menggunakan tingkat ini, tetapkan nilai untuk mengonfigurasi cluster pemrosesan Anda sesuai dengan panduan berikut:

  • Anda harus menyetel ExecutionTemplate.masterType untuk menentukan jenis mesin yang akan digunakan untuk node master Anda. Ini adalah satu-satunya setelan yang diperlukan.

SchedulerAcceleratorConfig

Definisi akselerator hardware. Perhatikan bahwa tidak semua kombinasi type dan core_count valid. Lihat GPU di Compute Engine untuk menemukan kombinasi yang valid. TPU tidak didukung.

Kolom
type

SchedulerAcceleratorType

Jenis akselerator ini.
core_count

int64

Jumlah inti akselerator ini.

SchedulerAcceleratorType

Jenis akselerator hardware untuk tugas AI Platform Training.

Enum
SCHEDULER_ACCELERATOR_TYPE_UNSPECIFIED Jenis akselerator tidak ditentukan. Default ke tanpa 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

Parameter yang digunakan dalam eksekusi JobType Agent Platform.

Kolom
network

string

Nama lengkap jaringan Compute Engine tempat Tugas akan di-peering. Contoh, projects/12345/global/networks/myVPC. Format memiliki bentuk projects/{project}/global/networks/{network}. Dengan {project} adalah nomor project, seperti 12345, dan {network} adalah nama jaringan.

Akses layanan pribadi harus sudah dikonfigurasi untuk jaringan tersebut. Jika tidak ditentukan, tugas tidak di-peering dengan jaringan apa pun.
env

map<string, string>

Variabel lingkungan. Maksimal 100 variabel lingkungan dapat ditentukan dan bersifat unik. Contoh: GCP_BUCKET=gs://my-bucket/samples/

GetEnvironmentRequest

Permintaan untuk mendapatkan lingkungan notebook.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/environments/{environment_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.environments.get

GetExecutionRequest

Permintaan untuk mendapatkan eksekusi notebook terjadwal

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/executions/{execution_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.executions.get

GetInstanceHealthRequest

Permintaan untuk memeriksa apakah instance notebook responsif atau tidak.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.getHealth

GetInstanceHealthResponse

Respons untuk memeriksa apakah instance notebook responsif atau tidak.

Kolom
health_state

HealthState

Hanya output. health_state runtime.
health_info

map<string, string>

Hanya output. Informasi tambahan tentang kondisi instance. 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

Apakah instance responsif atau tidak.

Enum
HEALTH_STATE_UNSPECIFIED Substatus instance tidak diketahui.
HEALTHY Instance diketahui dalam kondisi baik (misalnya, daemon penting sedang berjalan). Berlaku untuk status AKTIF.
UNHEALTHY Instance diketahui dalam kondisi tidak sehat (misalnya, daemon penting tidak berjalan). Berlaku untuk status AKTIF.
AGENT_NOT_INSTALLED Instance belum menginstal agen pemantauan kondisi. Berlaku untuk status AKTIF.
AGENT_NOT_RUNNING Agen pemantauan kondisi instance tidak berjalan. Berlaku untuk status AKTIF.

GetInstanceRequest

Permintaan untuk mendapatkan instance notebook.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.get

GetRuntimeRequest

Permintaan untuk mendapatkan Managed Notebook Runtime.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.runtimes.get

GetScheduleRequest

Permintaan untuk mendapatkan notebook terjadwal.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/schedules/{schedule_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.schedules.get

Instance

Definisi instance notebook.

Kolom
name

string

Hanya output. Nama instance notebook ini. Format: projects/{project_id}/locations/{location}/instances/{instance_id}
post_startup_script

string

Jalur ke skrip Bash yang otomatis berjalan setelah instance notebook di-boot sepenuhnya. Jalur tersebut harus berupa URL atau jalur Cloud Storage (gs://path-to-file/file-name).
proxy_uri

string

Hanya output. Endpoint proxy yang digunakan untuk mengakses notebook Jupyter.
instance_owners[]

string

Hanya input. Pemilik instance ini setelah dibuat. Format: alias@example.com

Saat ini hanya mendukung satu pemilik. Jika tidak ditentukan, semua pengguna akun layanan dari akun layanan instance VM Anda dapat menggunakan instance tersebut.
service_account

string

Akun layanan di instance ini, yang memberikan akses ke layanan Google Cloud lainnya. Anda dapat menggunakan akun layanan apa pun dalam project yang sama, tetapi Anda harus memiliki izin pengguna akun layanan untuk menggunakan instance.

Jika tidak ditentukan, akun layanan default Compute Engine akan digunakan.
service_account_scopes[]

string

Opsional. URI cakupan akun layanan yang akan disertakan dalam instance Compute Engine.

Jika tidak ditentukan, cakupan berikut akan ditentukan: - https://www.googleapis.com/auth/cloud-platform - https://www.googleapis.com/auth/userinfo.email Jika tidak menggunakan cakupan default, Anda memerlukan setidaknya: https://www.googleapis.com/auth/compute
machine_type

string

Wajib. Jenis mesin Compute Engine instance ini.
accelerator_config

AcceleratorConfig

Akselerator hardware yang digunakan pada instance ini. Jika Anda menggunakan akselerator, pastikan konfigurasi Anda memiliki vCPU dan memori yang cukup untuk mendukung machine_type yang telah Anda pilih.
state

State

Hanya output. Status instance ini.
install_gpu_driver

bool

Apakah pengguna akhir mengizinkan Google Cloud menginstal driver GPU di instance ini. Jika kolom ini kosong atau disetel ke salah (false), driver GPU tidak akan diinstal. Hanya berlaku untuk instance dengan GPU.
custom_gpu_driver_path

string

Tentukan jalur Cloud Storage kustom tempat driver GPU disimpan. Jika tidak ditentukan, kami akan otomatis memilih dari driver GPU resmi.
boot_disk_type

DiskType

Hanya input. Jenis boot disk yang terpasang ke instance ini, defaultnya adalah persistent disk standar (PD_STANDARD).
boot_disk_size_gb

int64

Hanya input. Ukuran boot disk dalam GB yang terpasang ke instance ini, hingga maksimum 64000 GB (64 TB). Nilai minimum yang direkomendasikan adalah 100 GB. Jika tidak ditentukan, nilai defaultnya adalah 100.
data_disk_type

DiskType

Hanya input. Jenis disk data yang terpasang ke instance ini, defaultnya adalah persistent disk standar (PD_STANDARD).
data_disk_size_gb

int64

Hanya input. Ukuran disk data dalam GB yang terpasang ke instance ini, hingga maksimum 64000 GB (64 TB). Anda dapat memilih ukuran disk data berdasarkan ukuran notebook dan data Anda. Jika tidak ditentukan, nilai defaultnya adalah 100.
no_remove_data_disk

bool

Hanya input. Jika benar (true), disk data tidak akan dihapus otomatis saat menghapus instance.
disk_encryption

DiskEncryption

Hanya input. Metode enkripsi disk yang digunakan pada boot disk dan disk data, defaultnya adalah GMEK.
kms_key

string

Hanya input. Kunci KMS yang digunakan untuk mengenkripsi disk, hanya berlaku jika disk_encryption adalah CMEK. Format: projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

Pelajari lebih lanjut cara menggunakan kunci enkripsi Anda sendiri.
disks[]

Disk

Hanya output. Disk terpasang ke instance notebook.
shielded_instance_config

ShieldedInstanceConfig

Opsional. Konfigurasi Shielded VM. Image yang menggunakan fitur Shielded VM yang didukung.
no_public_ip

bool

Jika benar (true), tidak ada IP eksternal yang akan ditetapkan ke instance ini.
no_proxy_access

bool

Jika benar, instance notebook tidak akan didaftarkan ke proxy.
network

string

Nama VPC tempat instance ini berada. Format: projects/{project_id}/global/networks/{network_id}
subnet

string

Nama subnet tempat instance ini berada. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
labels

map<string, string>

Label yang akan diterapkan ke instance ini. Label ini dapat diubah nanti dengan metode setLabels.
metadata

map<string, string>

Metadata kustom yang akan diterapkan ke instance ini. Misalnya, untuk menentukan bucket Cloud Storage untuk pencadangan otomatis, Anda dapat menggunakan tag metadata gcs-data-bucket. Format: "--metadata=gcs-data-bucket=BUCKET".
tags[]

string

Opsional. Tag jaringan Compute Engine yang akan ditambahkan ke runtime (lihat Menambahkan tag jaringan).
upgrade_history[]

UpgradeHistoryEntry

Histori upgrade instance ini.
nic_type

NicType

Opsional. Jenis vNIC yang akan digunakan pada antarmuka ini. Ini dapat berupa gVNIC atau VirtioNet.
reservation_affinity

ReservationAffinity

Opsional. Afinitas reservasi opsional. Menetapkan kolom ini akan menerapkan Zonal Compute Reservation yang ditentukan ke instance notebook ini.
creator

string

Hanya output. Alamat email entitas yang mengirim permintaan CreateInstance asli.
can_ip_forward

bool

Opsional. Flag untuk mengaktifkan penerusan IP atau tidak, defaultnya salah/nonaktif. https://cloud.google.com/vpc/docs/using-routes#canipforward
create_time

Timestamp

Hanya output. Waktu pembuatan instance.
update_time

Timestamp

Hanya output. Waktu update instance.
instance_migration_eligibility

InstanceMigrationEligibility

Hanya output. Memeriksa seberapa layak migrasi dari UmN ke WbI.
Kolom union environment. Jenis lingkungan; dapat berupa salah satu dari image VM atau image container. environment hanya ada berupa salah satu diantara berikut:
vm_image

VmImage

Gunakan image VM Compute Engine untuk memulai instance notebook.
container_image

ContainerImage

Gunakan image container untuk memulai instance notebook.
migrated

bool

Hanya output. Bool yang menunjukkan apakah notebook ini telah dimigrasikan ke Instance Workbench

AcceleratorConfig

Definisi akselerator hardware. Perhatikan bahwa tidak semua kombinasi type dan core_count valid. Lihat GPU di Compute Engine untuk menemukan kombinasi yang valid. TPU tidak didukung.

Kolom
type

AcceleratorType

Jenis akselerator ini.
core_count

int64

Jumlah inti akselerator ini.

AcceleratorType

Definisi jenis akselerator hardware yang dapat digunakan pada instance ini.

Enum
ACCELERATOR_TYPE_UNSPECIFIED Jenis akselerator tidak ditentukan.
NVIDIA_TESLA_K80 Jenis akselerator adalah Nvidia Tesla K80.
NVIDIA_TESLA_P100 Jenis akselerator adalah Nvidia Tesla P100.
NVIDIA_TESLA_V100 Jenis akselerator adalah Nvidia Tesla V100.
NVIDIA_TESLA_P4 Jenis akselerator adalah Nvidia Tesla P4.
NVIDIA_TESLA_T4 Jenis akselerator adalah Nvidia Tesla T4.
NVIDIA_TESLA_A100 Jenis akselerator adalah Nvidia Tesla A100.
NVIDIA_L4 Jenis akselerator adalah Nvidia Tesla L4.
NVIDIA_A100_80GB Jenis akseleratornya adalah Nvidia Tesla A100 80 GB.
NVIDIA_TESLA_T4_VWS Jenis akselerator adalah NVIDIA Tesla T4 Virtual Workstations.
NVIDIA_TESLA_P100_VWS Jenis akselerator adalah NVIDIA Tesla P100 Virtual Workstations.
NVIDIA_TESLA_P4_VWS Jenis akselerator adalah NVIDIA Tesla P4 Virtual Workstations.
NVIDIA_H100_80GB Jenis akselerator adalah NVIDIA H100 80 GB.
NVIDIA_H100_MEGA_80GB Jenis akselerator adalah NVIDIA H100 Mega 80 GB.
TPU_V2 (Segera hadir) Jenis akselerator adalah TPU V2.
TPU_V3 (Segera hadir) Jenis akselerator adalah TPU V3.

Disk

Resource disk yang terpasang ke instance.

Kolom
auto_delete

bool

Menunjukkan apakah disk akan dihapus otomatis jika instance dihapus (tidak dihapus otomatis saat disk dilepaskan dari instance).
boot

bool

Menunjukkan bahwa ini adalah boot disk. Mesin virtual akan menggunakan partisi pertama disk untuk sistem file root miliknya.
device_name

string

Menunjukkan nama perangkat unik pilihan Anda yang dicerminkan dalam pohon /dev/disk/by-id/google-* sistem operasi Linux yang berjalan dalam instance. Nama ini dapat digunakan untuk mereferensikan perangkat untuk pemasangan, perubahan ukuran, dan lainnya dari dalam instance.

Jika tidak ditentukan, server memilih nama perangkat default untuk diterapkan pada disk ini dalam bentuk persistent-disk-x, di mana x adalah angka yang ditunjuk oleh Google Compute Engine.Kolom ini hanya berlaku untuk persistent disk.
disk_size_gb

int64

Menunjukkan ukuran disk dalam GB berbasis 2.
guest_os_features[]

GuestOsFeature

Menunjukkan daftar fitur yang akan diaktifkan di sistem operasi tamu. Hanya berlaku untuk image yang dapat di-boot. Baca Mengaktifkan fitur sistem operasi tamu untuk melihat daftar opsi yang tersedia.
index

int64

Indeks berbasis nol untuk disk ini, dengan 0 dicadangkan untuk boot disk. Jika Anda memiliki banyak disk yang terpasang ke instance, setiap disk akan memiliki nomor indeks yang unik.
interface

string

Menunjukkan antarmuka disk yang akan digunakan untuk melampirkan disk ini, yaitu SCSI atau NVME. Defaultnya adalah SCSI. Persistent disk harus selalu menggunakan SCSI dan permintaan akan gagal jika Anda mencoba melampirkan persistent disk dalam format selain SCSI. SSD Lokal dapat menggunakan NVMe atau SCSI. Untuk mengetahui karakteristik performa SCSI melalui NVMe, lihat Performa SSD lokal. Nilai valid:

  • NVME
  • SCSI
kind

string

Jenis resource. Selalu hitung#attachedDisk untuk disk yang terpasang.
licenses[]

string

Daftar lisensi yang terlihat secara publik. Dicadangkan untuk penggunaan Google. Lisensi mewakili data penagihan dan penggunaan gabungan untuk image publik dan marketplace.
mode

string

Mode untuk melampirkan disk ini, baik READ_WRITE maupun READ_ONLY. Jika tidak ditentukan, defaultnya adalah melampirkan disk dalam mode READ_WRITE. Nilai valid:

  • READ_ONLY
  • READ_WRITE
source

string

Menunjukkan URL sebagian atau penuh yang valid ke resource Persistent Disk yang ada.
type

string

Menunjukkan jenis disk, baik SCRATCH atau PERSISTENT. Nilai valid:

  • PERSISTENT
  • SCRATCH

GuestOsFeature

Fitur OS tamu untuk boot disk.

Kolom
type

string

ID fitur yang didukung. Baca Mengaktifkan fitur sistem operasi tamu untuk melihat daftar opsi yang tersedia. Nilai valid:

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

DiskEncryption

Definisi opsi enkripsi disk.

Enum
DISK_ENCRYPTION_UNSPECIFIED Enkripsi disk tidak ditentukan.
GMEK Gunakan kunci enkripsi yang dikelola Google untuk mengenkripsi disk boot.
CMEK Gunakan kunci enkripsi yang dikelola pelanggan untuk mengenkripsi boot disk.

DiskType

Kemungkinan jenis disk untuk instance notebook.

Enum
DISK_TYPE_UNSPECIFIED Jenis disk belum ditetapkan.
PD_STANDARD Jenis persistent disk standar.
PD_SSD Jenis persistent disk SSD.
PD_BALANCED Jenis persistent disk seimbang.
PD_EXTREME Jenis persistent disk ekstrem.

NicType

Jenis driver vNIC. Default-nya harus UNSPECIFIED_NIC_TYPE.

Enum
UNSPECIFIED_NIC_TYPE Tidak ada jenis yang ditentukan.
VIRTIO_NET VIRTIO
GVNIC GVNIC

ShieldedInstanceConfig

Kumpulan opsi Instance Terlindungi. Lihat Image yang menggunakan fitur Shielded VM yang didukung. Tidak semua kombinasi valid.

Kolom
enable_secure_boot

bool

Menentukan apakah instance mengaktifkan Booting Aman.

Booting Aman membantu memastikan bahwa sistem hanya menjalankan software asli dengan memverifikasi tanda tangan digital semua komponen booting, dan menghentikan proses booting jika verifikasi tanda tangan gagal. Dinonaktifkan secara default.
enable_vtpm

bool

Menentukan apakah instance mengaktifkan vTPM. Diaktifkan secara default.
enable_integrity_monitoring

bool

Menentukan apakah instance mengaktifkan pemantauan integritas.

Mengaktifkan pemantauan dan pengesahan integritas booting instance. Pengesahan dilakukan terhadap dasar pengukuran kebijakan integritas. Baseline ini awalnya berasal dari image boot yang secara implisit tepercaya saat instance dibuat. Diaktifkan secara default.

Negara Bagian

Definisi status instance ini.

Enum
STATE_UNSPECIFIED Negara bagian tidak ditentukan.
STARTING Logika kontrol sedang memulai instance.
PROVISIONING Logika kontrol menginstal framework yang diperlukan dan mendaftarkan instance dengan proxy notebook
ACTIVE Instance sedang berjalan.
STOPPING Logika kontrol menghentikan instance.
STOPPED Instance dihentikan.
DELETED Instance dihapus.
UPGRADING Instance sedang diupgrade.
INITIALIZING Instance sedang dibuat.
REGISTERING Instance sedang didaftarkan.
SUSPENDING Instance sedang ditangguhkan.
SUSPENDED Instance ditangguhkan.

UpgradeHistoryEntry

Entri histori upgrade image VM.

Kolom
snapshot

string

Snapshot disk booting instance notebook ini sebelum upgrade.
vm_image

string

Image VM sebelum upgrade instance ini.
container_image

string

Image container sebelum upgrade instance ini.
framework

string

Framework instance notebook ini.
version

string

Versi instance notebook sebelum upgrade ini.
state

State

Status entri histori upgrade instance ini.
create_time

Timestamp

Waktu saat entri histori upgrade instance ini dibuat.
target_image
(deprecated)

string

Image VM Target. Format: ainotebooks-vm/project/image-name/name.
action

Action

Tindakan. Rollback atau Upgrade.
target_version

string

Versi VM Target, seperti m63.

Tindakan

Definisi operasi entri histori upgrade ini.

Enum
ACTION_UNSPECIFIED Operasi tidak ditentukan.
UPGRADE Upgrade.
ROLLBACK Rollback.

Negara Bagian

Definisi status entri histori upgrade ini.

Enum
STATE_UNSPECIFIED Negara bagian tidak ditentukan.
STARTED Upgrade instance dimulai.
SUCCEEDED Upgrade instance berhasil.
FAILED Upgrade instance gagal.

InstanceConfig

Konfigurasi instance notebook yang dapat diupdate.

Kolom
notebook_upgrade_schedule

string

Ekspresi cron di zona waktu UTC, yang digunakan untuk menjadwalkan upgrade otomatis instance. Harap ikuti format cron.
enable_health_monitoring

bool

Memverifikasi bahwa layanan internal inti sedang berjalan.

InstanceMigrationEligibility

InstanceMigrationEligibility mewakili informasi kelayakan migrasi dari UmN ke WbI.

Kolom
warnings[]

Warning

Hanya output. Konfigurasi tertentu akan ditetapkan ke default selama migrasi.
errors[]

Error

Hanya output. Konfigurasi tertentu membuat UmN tidak memenuhi syarat untuk migrasi otomatis. Migrasi manual diperlukan.

Error

Pesan error migrasi berarti konfigurasi tertentu membuat UmN tidak memenuhi syarat untuk migrasi otomatis. Migrasi manual diperlukan.

Enum
ERROR_UNSPECIFIED Jenis default.
DATAPROC_HUB UmN menggunakan Dataproc Hub dan tidak dapat dimigrasikan.

Peringatan

Pesan peringatan migrasi berarti konfigurasi tertentu akan disetel ke default selama migrasi.

Enum
WARNING_UNSPECIFIED Jenis default.
UNSUPPORTED_MACHINE_TYPE UmN menggunakan jenis mesin yang tidak didukung di WbI. VM akan dimigrasikan dengan jenis mesin default e2-standard-4. Pengguna dapat mengubah jenis mesin setelah migrasi.
UNSUPPORTED_ACCELERATOR_TYPE UmN menggunakan jenis akselerator yang tidak didukung di WbI. Aplikasi akan dimigrasikan tanpa akselerator. Pengguna dapat melampirkan akselerator setelah migrasi.
UNSUPPORTED_OS UmN menggunakan sistem operasi yang tidak didukung di WbI (misalnya, Debian 10, Ubuntu). Debian 10 akan digantikan dengan Debian 11 di WbI.
NO_REMOVE_DATA_DISK UmN ini dikonfigurasi dengan no_remove_data_disk, yang tidak lagi tersedia di WbI.
GCS_BACKUP UmN ini dikonfigurasi dengan fitur pencadangan Cloud Storage, yang tidak lagi tersedia di WbI.
POST_STARTUP_SCRIPT UmN ini dikonfigurasi dengan skrip setelah startup. Anda dapat memberikan post_startup_script_option untuk migrasi secara opsional.

IsInstanceUpgradeableRequest

Permintaan untuk memeriksa apakah instance notebook dapat diupgrade.

Kolom
notebook_instance

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada notebookInstance resource yang ditentukan:

  • notebooks.instances.checkUpgradability
type

UpgradeType

Opsional. UpgradeType opsional. Menyetel kolom ini akan menelusuri image komputasi tambahan untuk mengupgrade instance ini.

IsInstanceUpgradeableResponse

Respons untuk memeriksa apakah instance notebook dapat diupgrade.

Kolom
upgradeable

bool

Jika instance dapat diupgrade.
upgrade_version

string

Versi yang akan diupgrade instance ini jika memanggil endpoint upgrade. Kolom ini hanya akan diisi jika field upgradeable bernilai benar (true).
upgrade_info

string

Informasi tambahan tentang upgrade.
upgrade_image

string

Link mandiri gambar baru yang akan diupgrade instance ini jika memanggil endpoint upgrade. Kolom ini hanya akan diisi jika field upgradeable bernilai benar (true).

ListEnvironmentsRequest

Permintaan untuk mencantumkan lingkungan.

Kolom
parent

string

Wajib. Format: projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.environments.list
page_size

int32

Ukuran maksimum yang ditampilkan dari panggilan daftar.
page_token

string

Token halaman yang ditampilkan sebelumnya yang dapat digunakan untuk melanjutkan listingan dari hasil terakhir.

ListEnvironmentsResponse

Respons untuk mencantumkan lingkungan.

Kolom
environments[]

Environment

Daftar lingkungan yang ditampilkan.
next_page_token

string

Token halaman yang dapat digunakan untuk melanjutkan pencantuman dari hasil terakhir dalam panggilan daftar berikutnya.
unreachable[]

string

Lokasi yang tidak dapat dijangkau.

ListExecutionsRequest

Permintaan untuk mencantumkan eksekusi notebook terjadwal.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.executions.list
page_size

int32

Ukuran maksimum yang ditampilkan dari panggilan daftar.
page_token

string

Token halaman yang ditampilkan sebelumnya yang dapat digunakan untuk melanjutkan listingan dari hasil terakhir.
filter

string

Filter diterapkan pada eksekusi yang dihasilkan. Saat ini hanya mendukung pemfilteran eksekusi menurut schedule_id yang ditentukan. Format: schedule_id=<Schedule_ID>
order_by

string

Urutkan menurut kolom.

ListExecutionsResponse

Respons untuk mencantumkan eksekusi notebook terjadwal

Kolom
executions[]

Execution

Daftar instance yang ditampilkan.
next_page_token

string

Token halaman yang dapat digunakan untuk melanjutkan pencantuman dari hasil terakhir dalam panggilan daftar berikutnya.
unreachable[]

string

ID eksekusi yang tidak dapat dijangkau. Contoh:

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

ListInstancesRequest

Permintaan untuk mencantumkan instance notebook.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.instances.list
page_size

int32

Ukuran maksimum yang ditampilkan dari panggilan daftar.
page_token

string

Token halaman yang ditampilkan sebelumnya yang dapat digunakan untuk melanjutkan listingan dari hasil terakhir.
order_by

string

Opsional. Urutkan hasil. Nilai yang didukung adalah "name", "name desc", atau "" (tidak diurutkan).
filter

string

Opsional. Filter daftar.

ListInstancesResponse

Respons untuk mencantumkan instance notebook.

Kolom
instances[]

Instance

Daftar instance yang ditampilkan.
next_page_token

string

Token halaman yang dapat digunakan untuk melanjutkan pencantuman dari hasil terakhir dalam panggilan daftar berikutnya.
unreachable[]

string

Lokasi yang tidak dapat dijangkau. Misalnya, ['us-west1-a', 'us-central1-b']. ListInstancesResponse hanya akan berisi instance atau unreachables,

ListRuntimesRequest

Permintaan untuk mencantumkan Managed Notebook Runtime.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.runtimes.list
page_size

int32

Ukuran maksimum yang ditampilkan dari panggilan daftar.
page_token

string

Token halaman yang ditampilkan sebelumnya yang dapat digunakan untuk melanjutkan listingan dari hasil terakhir.
order_by

string

Opsional. Urutkan hasil. Nilai yang didukung adalah "name", "name desc", atau "" (tidak diurutkan).
filter

string

Opsional. Filter daftar.

ListRuntimesResponse

Respons untuk mencantumkan Runtime Notebook Terkelola.

Kolom
runtimes[]

Runtime

Daftar Runtime yang ditampilkan.
next_page_token

string

Token halaman yang dapat digunakan untuk melanjutkan pencantuman dari hasil terakhir dalam panggilan daftar berikutnya.
unreachable[]

string

Lokasi yang tidak dapat dijangkau. Misalnya, ['us-west1', 'us-central1']. ListRuntimesResponse hanya akan berisi runtime atau unreachables.

ListSchedulesRequest

Permintaan untuk mencantumkan tugas notebook terjadwal.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.schedules.list
page_size

int32

Ukuran maksimum yang ditampilkan dari panggilan daftar.
page_token

string

Token halaman yang ditampilkan sebelumnya yang dapat digunakan untuk melanjutkan listingan dari hasil terakhir.
filter

string

Filter diterapkan ke jadwal yang dihasilkan.
order_by

string

Kolom untuk mengurutkan hasil.

ListSchedulesResponse

Respons untuk mencantumkan tugas notebook terjadwal.

Kolom
schedules[]

Schedule

Daftar instance yang ditampilkan.
next_page_token

string

Token halaman yang dapat digunakan untuk melanjutkan pencantuman dari hasil terakhir dalam panggilan daftar berikutnya.
unreachable[]

string

Jadwal yang tidak dapat dijangkau. Contoh:

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

LocalDisk

Resource disk terpasang lokal.

Kolom
auto_delete

bool

Opsional. Hanya output. Menentukan apakah disk akan dihapus otomatis jika instance dihapus (tidak dihapus otomatis saat disk dilepaskan dari instance).
boot

bool

Opsional. Hanya output. Menunjukkan bahwa ini adalah boot disk. Mesin virtual akan menggunakan partisi pertama disk untuk sistem file root miliknya.
device_name

string

Opsional. Hanya output. Menentukan nama perangkat unik pilihan Anda yang dicerminkan dalam pohon /dev/disk/by-id/google-* sistem operasi Linux yang beroperasi dalam instance. Nama ini dapat digunakan untuk mereferensikan perangkat untuk pemasangan, perubahan ukuran, dan lainnya dari dalam instance.

Jika tidak ditentukan, server memilih nama perangkat default untuk diterapkan pada disk ini dalam bentuk persistent-disk-x, di mana x adalah angka yang ditunjuk oleh Google Compute Engine. Kolom ini hanya berlaku untuk persistent disk.
guest_os_features[]

RuntimeGuestOsFeature

Hanya output. Menunjukkan daftar fitur yang akan diaktifkan di sistem operasi tamu. Hanya berlaku untuk image yang dapat di-boot. Baca Mengaktifkan fitur sistem operasi tamu untuk melihat daftar opsi yang tersedia.
index

int32

Hanya output. Indeks berbasis nol untuk disk ini, dengan 0 dicadangkan untuk boot disk. Jika Anda memiliki banyak disk yang terpasang ke instance, setiap disk akan memiliki nomor indeks yang unik.
initialize_params

LocalDiskInitializeParams

Hanya input. Menentukan parameter untuk disk baru yang akan dibuat bersama instance baru. Gunakan parameter inisialisasi untuk membuat boot disk atau SSD lokal yang terpasang ke instance baru.

Properti ini tidak dapat muncul bersamaan dengan properti sumber; Anda hanya dapat menentukan salah satunya, tetapi tidak keduanya.
interface

string

Menentukan antarmuka disk yang akan digunakan untuk melampirkan disk ini, yaitu SCSI atau NVME. Defaultnya adalah SCSI. Persistent disk harus selalu menggunakan SCSI dan permintaan akan gagal jika Anda mencoba melampirkan persistent disk dalam format selain SCSI. SSD Lokal dapat menggunakan NVMe atau SCSI. Untuk mengetahui karakteristik performa SCSI melalui NVMe, lihat Performa SSD lokal. Nilai valid:

  • NVME
  • SCSI
kind

string

Hanya output. Jenis resource. Selalu hitung#attachedDisk untuk disk yang terpasang.
licenses[]

string

Hanya output. Lisensi yang valid dan dapat dilihat secara publik.
mode

string

Mode untuk melampirkan disk ini, baik READ_WRITE maupun READ_ONLY. Jika tidak ditentukan, defaultnya adalah melampirkan disk dalam mode READ_WRITE. Nilai valid:

  • READ_ONLY
  • READ_WRITE
source

string

Menentukan URL sebagian atau lengkap yang valid ke resource Persistent Disk yang ada.
type

string

Menentukan jenis disk, baik SCRATCH atau PERSISTENT. Jika tidak ditentukan, defaultnya adalah PERSISTENT. Nilai valid:

  • PERSISTENT
  • SCRATCH

RuntimeGuestOsFeature

Opsional. Daftar fitur yang akan diaktifkan di sistem operasi tamu. Hanya berlaku untuk image yang dapat di-boot. Baca Mengaktifkan fitur sistem operasi tamu untuk melihat daftar opsi yang tersedia. Fitur OS tamu untuk boot disk.

Kolom
type

string

ID fitur yang didukung. Baca Mengaktifkan fitur sistem operasi tamu untuk melihat daftar opsi yang tersedia.

Nilai valid:

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

LocalDiskInitializeParams

Hanya input. Menentukan parameter untuk disk baru yang akan dibuat bersama instance baru. Gunakan parameter inisialisasi untuk membuat boot disk atau SSD lokal yang terpasang ke runtime baru. Properti ini tidak dapat muncul bersamaan dengan properti sumber; Anda hanya dapat menentukan salah satunya, tetapi tidak keduanya.

Kolom
description

string

Opsional. Berikan properti ini saat membuat disk.
disk_name

string

Opsional. Menentukan nama disk. Jika tidak ditentukan, defaultnya adalah menggunakan nama instance. Jika disk dengan nama instance sudah ada di zona/region tertentu, nama baru akan dibuat secara otomatis.
disk_size_gb

int64

Opsional. Menentukan ukuran disk dalam GB berbasis 2. Jika tidak ditentukan, ukuran disk akan sama dengan ukuran image (biasanya 10 GB). Jika ditentukan, ukuran harus sama dengan atau lebih besar dari 10 GB. Default 100 GB.
disk_type

DiskType

Hanya input. Jenis boot disk yang terpasang ke instance ini, defaultnya adalah persistent disk standar (PD_STANDARD).
labels

map<string, string>

Opsional. Label yang akan diterapkan ke disk ini. Label ini dapat diubah nanti dengan metode disks.setLabels. Kolom ini hanya berlaku untuk persistent disk.

DiskType

Kemungkinan jenis disk.

Enum
DISK_TYPE_UNSPECIFIED Jenis disk belum ditetapkan.
PD_STANDARD Jenis persistent disk standar.
PD_SSD Jenis persistent disk SSD.
PD_BALANCED Jenis persistent disk seimbang.
PD_EXTREME Jenis persistent disk ekstrem.

MigrateInstanceRequest

Permintaan untuk memigrasikan Notebook yang Dikelola Pengguna ke Instance Workbench.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan satu atau beberapa izin IAM berikut pada name resource yang ditentukan:

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

PostStartupScriptOption

Opsional. Menentukan perilaku skrip pasca-startup selama migrasi.

PostStartupScriptOption

Menentukan perilaku skrip pasca-startup selama migrasi.

Enum
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED Opsi skrip pasca-startup tidak ditentukan. Default-nya adalah POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Tidak memigrasikan skrip pasca-startup ke Instance Workbench baru.
POST_STARTUP_SCRIPT_OPTION_RERUN Download ulang dan jalankan kembali skrip pasca-startup yang sama sebagai Notebook yang Dikelola Pengguna.

MigrateInstanceResponse

Jenis ini tidak memiliki kolom.

Jenis respons pesan kosong untuk MigrateInstance.

MigrateRuntimeRequest

Permintaan untuk memigrasikan Runtime ke Instance Workbench.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan satu atau beberapa izin IAM berikut pada name resource yang ditentukan:

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

string

Opsional. Nama VPC tempat Instance baru berada. Hal ini diperlukan jika Runtime menggunakan jaringan yang dikelola Google. Jika Runtime menggunakan jaringan milik pelanggan, Runtime akan menggunakan kembali VPC yang sama, dan kolom ini harus kosong. Format: projects/{project_id}/global/networks/{network_id}
subnet

string

Opsional. Nama subnet tempat Instance baru berada. Hal ini diperlukan jika Runtime menggunakan jaringan yang dikelola Google. Jika Runtime menggunakan jaringan milik pelanggan, Runtime akan menggunakan kembali subnet yang sama, dan kolom ini harus kosong. Format: projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
service_account

string

Opsional. Akun layanan yang akan disertakan dalam instance Compute Engine dari Instance Workbench baru saat Runtime menggunakan mode "hanya satu pengguna" untuk izin. Jika tidak ditentukan, akun layanan default Compute Engine akan digunakan. Saat Runtime menggunakan mode akun layanan untuk izin, Runtime akan menggunakan kembali akun layanan yang sama, dan kolom ini harus kosong.
request_id

string

Opsional. UUID permintaan idempoten.
post_startup_script_option

PostStartupScriptOption

Opsional. Menentukan perilaku skrip pasca-startup selama migrasi.

PostStartupScriptOption

Menentukan perilaku skrip pasca-startup selama migrasi.

Enum
POST_STARTUP_SCRIPT_OPTION_UNSPECIFIED Opsi skrip pasca-startup tidak ditentukan. Default-nya adalah POST_STARTUP_SCRIPT_OPTION_SKIP.
POST_STARTUP_SCRIPT_OPTION_SKIP Tidak memigrasikan skrip pasca-startup ke Instance Workbench baru.
POST_STARTUP_SCRIPT_OPTION_RERUN Download ulang dan jalankan kembali skrip startup postingan yang sama seperti Notebook yang Dikelola Google.

OperationMetadata

Mewakili metadata operasi yang berjalan lama.

Kolom
create_time

Timestamp

Waktu pembuatan operasi.
end_time

Timestamp

Waktu selesainya operasi.
target

string

Jalur resource yang ditentukan server untuk target operasi.
verb

string

Nama kata kerja yang dijalankan oleh operasi.
status_message

string

Status operasi yang dapat dibaca manusia, jika ada.
requested_cancellation

bool

Mengidentifikasi apakah pengguna telah meminta pembatalan operasi. Operasi yang berhasil dibatalkan memiliki nilai google.longrunning.Operation.error dengan google.rpc.Status.code 1, yang sesuai dengan Code.CANCELLED.
api_version

string

Versi API yang digunakan untuk memulai operasi.
endpoint

string

Nama endpoint API operasi ini.

RegisterInstanceRequest

Permintaan untuk mendaftarkan instance notebook.

Kolom
parent

string

Wajib. Format: parent=projects/{project_id}/locations/{location}

Otorisasi memerlukan izin IAM berikut pada parent resource yang ditentukan:

  • notebooks.instances.create
instance_id

string

Wajib. ID unik yang ditentukan pengguna untuk instance ini. instance_id harus memiliki panjang 1 hingga 63 karakter dan hanya berisi huruf kecil, karakter numerik, dan tanda hubung. Karakter pertama harus berupa huruf kecil dan karakter terakhir tidak boleh berupa tanda hubung.

ReportInstanceInfoRequest

Permintaan agar instance notebook melaporkan informasi ke Notebooks API.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}
vm_id

string

Wajib. Token hardware VM untuk mengautentikasi VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
metadata

map<string, string>

Metadata yang dilaporkan ke Notebooks API. Nilai ini akan digabungkan ke penyimpanan metadata instance

ReportRuntimeEventRequest

Permintaan untuk melaporkan Peristiwa Notebook Terkelola.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • iam.permissions.none
vm_id

string

Wajib. Token hardware VM untuk mengautentikasi VM. https://cloud.google.com/compute/docs/instances/verifying-instance-identity
event

Event

Wajib. Acara yang akan dilaporkan.

ReservationAffinity

Afinitas Reservasi untuk menggunakan reservasi Zonal.

Kolom
consume_reservation_type

Type

Opsional. Jenis reservasi yang akan digunakan
key

string

Opsional. Sesuai dengan kunci label resource reservasi.
values[]

string

Opsional. Sesuai dengan nilai label resource reservasi.

Jenis

Menunjukkan apakah akan menggunakan kapasitas dari reservasi atau tidak.

Enum
TYPE_UNSPECIFIED Jenis default.
NO_RESERVATION Jangan menggunakan kapasitas yang dialokasikan.
ANY_RESERVATION Memakai reservasi yang tersedia.
SPECIFIC_RESERVATION Harus memakai dari reservasi tertentu. Harus menentukan kolom nilai kunci untuk menentukan reservasi.

ResetInstanceRequest

Permintaan untuk mereset instance notebook

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.reset

ResetRuntimeRequest

Permintaan untuk mereset Managed Notebook Runtime.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.runtimes.reset
request_id

string

UUID permintaan idempoten.

RollbackInstanceRequest

Permintaan untuk mengembalikan instance notebook ke versi sebelumnya

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • iam.permissions.none
target_snapshot

string

Wajib. Snapshot untuk rollback. Contoh: projects/test-project/global/snapshots/krwlzipynril.

Runtime

Definisi Runtime untuk instance notebook terkelola.

Kolom
name

string

Hanya output. Nama resource runtime. Format: projects/{project}/locations/{location}/runtimes/{runtimeId}
state

State

Hanya output. Status runtime.
health_state

HealthState

Hanya output. health_state runtime.
access_config

RuntimeAccessConfig

Setelan konfigurasi untuk mengakses runtime.
software_config

RuntimeSoftwareConfig

Setelan konfigurasi untuk software di dalam runtime.
metrics

RuntimeMetrics

Hanya output. Berisi metrik daemon Runtime seperti Status layanan dan statistik JupyterLab.
create_time

Timestamp

Hanya output. Waktu pembuatan runtime.
update_time

Timestamp

Hanya output. Waktu update runtime.
labels

map<string, string>

Opsional. Label yang akan dikaitkan dengan Managed Notebook atau Runtime ini. Kunci label harus berisi 1 hingga 63 karakter, dan harus sesuai dengan RFC 1035. Nilai label boleh kosong, tetapi, jika ada, harus berisi 1 hingga 63 karakter, dan harus sesuai dengan RFC 1035. Maksimal 32 label dapat dikaitkan dengan cluster.
runtime_migration_eligibility

RuntimeMigrationEligibility

Hanya output. Memeriksa kelayakan migrasi dari GmN ke WbI.
Kolom union runtime_type. Jenis runtime; saat ini hanya mendukung VM Compute Engine. runtime_type hanya ada berupa salah satu diantara berikut:
virtual_machine

VirtualMachine

Gunakan image VM Compute Engine untuk memulai instance notebook terkelola.
migrated

bool

Hanya output. Bool yang menunjukkan apakah notebook ini telah dimigrasikan ke Instance Workbench

HealthState

Substatus runtime.

Enum
HEALTH_STATE_UNSPECIFIED Substatus runtime tidak diketahui.
HEALTHY Runtime diketahui dalam kondisi responsif (misalnya, daemon penting sedang berjalan). Berlaku untuk status ACTIVE.
UNHEALTHY Runtime diketahui dalam status tidak sehat (misalnya, daemon penting tidak berjalan) Berlaku untuk status AKTIF.
AGENT_NOT_INSTALLED Runtime belum menginstal agen pemantauan kondisi. Berlaku untuk status AKTIF.
AGENT_NOT_RUNNING Agen pemantauan kondisi runtime tidak berjalan. Berlaku untuk status AKTIF.

Negara Bagian

Definisi status runtime ini.

Enum
STATE_UNSPECIFIED Negara bagian tidak ditentukan.
STARTING Lapisan komputasi memulai runtime. Model ini belum siap digunakan.
PROVISIONING Lapisan komputasi menginstal framework yang diperlukan dan mendaftarkan runtime dengan proxy notebook. Fitur ini tidak dapat digunakan.
ACTIVE Runtime sedang berjalan. Fitur ini siap digunakan.
STOPPING Logika kontrol menghentikan runtime. Fitur ini tidak dapat digunakan.
STOPPED Runtime dihentikan. Fitur ini tidak dapat digunakan.
DELETING Runtime sedang dihapus. Fitur ini tidak dapat digunakan.
UPGRADING Runtime sedang diupgrade. Fitur ini tidak dapat digunakan.
INITIALIZING Runtime sedang dibuat dan disiapkan. Model ini belum siap digunakan.

RuntimeAcceleratorConfig

Definisi jenis akselerator hardware yang dapat digunakan. Lihat Compute Engine AcceleratorTypes. Contoh:

  • nvidia-tesla-k80
  • nvidia-tesla-p100
  • nvidia-tesla-v100
  • nvidia-tesla-p4
  • nvidia-tesla-t4
  • nvidia-tesla-a100
Kolom
type

AcceleratorType

Model akselerator.
core_count

int64

Jumlah inti akselerator ini.

AcceleratorType

Jenis akselerator ini.

Enum
ACCELERATOR_TYPE_UNSPECIFIED Jenis akselerator tidak ditentukan.
NVIDIA_TESLA_K80

Jenis akselerator adalah Nvidia Tesla K80.
NVIDIA_TESLA_P100 Jenis akselerator adalah Nvidia Tesla P100.
NVIDIA_TESLA_V100 Jenis akselerator adalah Nvidia Tesla V100.
NVIDIA_TESLA_P4 Jenis akselerator adalah Nvidia Tesla P4.
NVIDIA_TESLA_T4 Jenis akselerator adalah Nvidia Tesla T4.
NVIDIA_TESLA_A100 Jenis akseleratornya adalah Nvidia Tesla A100 - 40 GB.
NVIDIA_L4 Jenis akselerator adalah Nvidia L4.
TPU_V2 (Segera hadir) Jenis akselerator adalah TPU V2.
TPU_V3 (Segera hadir) Jenis akselerator adalah TPU V3.
NVIDIA_TESLA_T4_VWS Jenis akselerator adalah NVIDIA Tesla T4 Virtual Workstations.
NVIDIA_TESLA_P100_VWS Jenis akselerator adalah NVIDIA Tesla P100 Virtual Workstations.
NVIDIA_TESLA_P4_VWS Jenis akselerator adalah NVIDIA Tesla P4 Virtual Workstations.

RuntimeAccessConfig

Menentukan konfigurasi login untuk Runtime

Kolom
access_type

RuntimeAccessType

Jenis mode akses instance ini.
runtime_owner

string

Pemilik runtime ini setelah pembuatan. Format: alias@example.com Saat ini hanya mendukung satu pemilik.
proxy_uri

string

Hanya output. Endpoint proxy yang digunakan untuk mengakses runtime.

RuntimeAccessType

Kemungkinan cara untuk mengakses runtime. Mode autentikasi. Saat ini hanya mendukung: Pengguna Tunggal.

Enum
RUNTIME_ACCESS_TYPE_UNSPECIFIED Akses tidak ditentukan.
SINGLE_USER Login pengguna tunggal.
SERVICE_ACCOUNT Mode Akun Layanan. Dalam mode Akun Layanan, pembuat Runtime akan menentukan SA yang ada di project konsumen. Menggunakan kolom Akun Layanan Runtime. Pengguna yang mengakses Runtime memerlukan izin ActAs (Pengguna Akun Layanan).

RuntimeMetrics

Berisi metrik daemon runtime, seperti OS dan kernel serta statistik sesi.

Kolom
system_metrics

map<string, string>

Hanya output. Metrik sistem.

RuntimeMigrationEligibility

RuntimeMigrationEligibility mewakili informasi kelayakan migrasi dari GmN ke WbI.

Kolom
warnings[]

Warning

Hanya output. Konfigurasi tertentu akan ditetapkan ke default selama migrasi.
errors[]

Error

Hanya output. Konfigurasi tertentu membuat GmN tidak memenuhi syarat untuk migrasi otomatis. Migrasi manual diperlukan.

Error

Pesan error migrasi berarti konfigurasi tertentu membuat GmN tidak memenuhi syarat untuk migrasi otomatis. Migrasi manual diperlukan.

Enum
ERROR_UNSPECIFIED Jenis default.
CUSTOM_CONTAINER GmN dikonfigurasi dengan container kustom dan tidak dapat dimigrasikan.

Peringatan

Pesan peringatan migrasi berarti konfigurasi tertentu akan disetel ke default selama migrasi.

Enum
WARNING_UNSPECIFIED Jenis default.
UNSUPPORTED_ACCELERATOR_TYPE GmN menggunakan jenis akselerator yang tidak didukung di WbI. Aplikasi akan dimigrasikan tanpa akselerator. Pengguna dapat melampirkan akselerator setelah migrasi.
UNSUPPORTED_OS GmN menggunakan sistem operasi yang tidak didukung di WbI (misalnya, Debian 10). Debian 10 akan digantikan dengan Debian 11 di WbI.
RESERVED_IP_RANGE GmN ini dikonfigurasi dengan rentang IP yang dicadangkan, yang tidak lagi berlaku di WbI.
GOOGLE_MANAGED_NETWORK GmN ini dikonfigurasi dengan jaringan yang dikelola Google. Berikan opsi network dan subnet untuk migrasi.
POST_STARTUP_SCRIPT GmN ini dikonfigurasi dengan skrip pasca-startup. Anda dapat memberikan post_startup_script_option untuk migrasi secara opsional.
SINGLE_USER GmN ini dikonfigurasi dengan mode pengguna tunggal. Anda dapat memberikan opsi service_account untuk migrasi.

RuntimeShieldedInstanceConfig

Kumpulan opsi Instance Terlindungi. Lihat Image yang menggunakan fitur Shielded VM yang didukung. Tidak semua kombinasi valid.

Kolom
enable_secure_boot

bool

Menentukan apakah instance mengaktifkan Booting Aman.

Booting Aman membantu memastikan bahwa sistem hanya menjalankan software asli dengan memverifikasi tanda tangan digital semua komponen booting, dan menghentikan proses booting jika verifikasi tanda tangan gagal. Dinonaktifkan secara default.
enable_vtpm

bool

Menentukan apakah instance mengaktifkan vTPM. Diaktifkan secara default.
enable_integrity_monitoring

bool

Menentukan apakah instance mengaktifkan pemantauan integritas.

Mengaktifkan pemantauan dan pengesahan integritas booting instance. Pengesahan dilakukan terhadap dasar pengukuran kebijakan integritas. Baseline ini awalnya berasal dari image boot yang secara implisit tepercaya saat instance dibuat. Diaktifkan secara default.

RuntimeSoftwareConfig

Menentukan pemilihan dan konfigurasi software di dalam runtime. Properti yang akan ditetapkan pada runtime. Kunci properti ditentukan dalam format key:value, misalnya:

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

string

Ekspresi cron di zona waktu UTC, yang digunakan untuk menjadwalkan upgrade otomatis instance. Harap ikuti format cron.
idle_shutdown_timeout

int32

Waktu dalam menit untuk menunggu sebelum mematikan runtime. Default: 180 menit
install_gpu_driver

bool

Instal Driver Nvidia secara otomatis. Default: True
custom_gpu_driver_path

string

Tentukan jalur Cloud Storage kustom tempat driver GPU disimpan. Jika tidak ditentukan, kami akan otomatis memilih dari driver GPU resmi.
post_startup_script

string

Jalur ke skrip Bash yang otomatis berjalan setelah instance notebook di-boot sepenuhnya. Jalur tersebut harus berupa URL atau jalur Cloud Storage (gs://path-to-file/file-name).
kernels[]

ContainerImage

Opsional. Gunakan daftar image container untuk digunakan sebagai Kernel di instance notebook.
post_startup_script_behavior

PostStartupScriptBehavior

Perilaku untuk skrip pasca-startup.
enable_health_monitoring

bool

Memverifikasi bahwa layanan internal inti sedang berjalan. Default: True
idle_shutdown

bool

Runtime akan otomatis dimatikan setelah idle_shutdown_time. Default: True
upgradeable

bool

Hanya output. Bool yang menunjukkan apakah image yang lebih baru tersedia dalam kelompok image.
disable_terminal

bool

Bool yang menunjukkan apakah terminal JupyterLab akan tersedia atau tidak. Default: False
version

string

Output saja. Versi image boot seperti M100, dari label rilis image.
mixer_disabled

bool

Bool yang menunjukkan apakah klien mixer harus dinonaktifkan. Default: False

PostStartupScriptBehavior

Perilaku untuk skrip pasca-startup.

Enum
POST_STARTUP_SCRIPT_BEHAVIOR_UNSPECIFIED Perilaku skrip pasca-startup tidak ditentukan. Hanya akan berjalan satu kali saat pembuatan.
RUN_EVERY_START Menjalankan skrip pasca-startup yang disediakan selama pembuatan di setiap awal.
DOWNLOAD_AND_RUN_EVERY_START Mendownload dan menjalankan skrip pasca-startup yang disediakan di setiap permulaan.

Jadwal

Definisi jadwal.

Kolom
name

string

Hanya output. Nama jadwal ini. Format: projects/{project_id}/locations/{location}/schedules/{schedule_id}
display_name

string

Hanya output. Nama tampilan yang digunakan untuk tujuan UI. Nama hanya boleh berisi karakter alfanumerik, tanda hubung -, dan garis bawah _.
description

string

Deskripsi singkat lingkungan ini.
state

State
cron_schedule

string

Jadwal berformat cron-tab yang digunakan untuk menjalankan tugas. Format: menit, jam, hari dalam sebulan, bulan, hari dalam seminggu, misalnya 0 0 * * WED = setiap hari Rabu Contoh lainnya: https://crontab.guru/examples.html
time_zone

string

Zona waktu yang menjadi dasar cron_schedule. Nilai kolom ini harus berupa nama zona waktu dari database tz. Database TZ: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Perhatikan bahwa beberapa zona waktu mencakup ketentuan untuk waktu musim panas. Aturan untuk waktu musim panas ditentukan oleh tz yang dipilih. Untuk UTC, gunakan string "utc". Jika zona waktu tidak ditentukan, zona waktu defaultnya adalah UTC (juga dikenal sebagai GMT).
create_time

Timestamp

Hanya output. Waktu pembuatan jadwal.
update_time

Timestamp

Hanya output. Waktu jadwal terakhir diperbarui.
execution_template

ExecutionTemplate

Template Eksekusi Notebook yang sesuai dengan jadwal ini.
recent_executions[]

Execution

Hanya output. Nama eksekusi terbaru yang dipicu dari jadwal ini dan statusnya yang sesuai.

Negara Bagian

Status tugas.

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
ENABLED Tugas berjalan normal.
PAUSED Tugas dijeda oleh pengguna. Tidak akan dieksekusi. Pengguna dapat menjeda tugas secara sengaja menggunakan Cloud Scheduler.
DISABLED Tugas dinonaktifkan oleh sistem karena terjadi error. Pengguna tidak dapat secara langsung menonaktifkan tugas.
UPDATE_FAILED Status tugas yang dihasilkan dari operasi CloudScheduler.UpdateJob yang gagal. Untuk memulihkan tugas dari status ini, coba lagi CloudScheduler.UpdateJob hingga respons berhasil diterima.
INITIALIZING Sumber daya jadwal sedang dibuat.
DELETING Resource jadwal sedang dihapus.

SetInstanceAcceleratorRequest

Permintaan untuk menyetel akselerator instance.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.setAccelerator
type

AcceleratorType

Wajib. Jenis akselerator ini.
core_count

int64

Wajib. Jumlah inti akselerator ini. Perhatikan bahwa tidak semua kombinasi type dan core_count valid. Lihat GPU di Compute Engine untuk menemukan kombinasi yang valid. TPU tidak didukung.

SetInstanceLabelsRequest

Permintaan untuk menyetel label instance.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.setLabels
labels

map<string, string>

Label yang akan diterapkan ke instance ini. Label ini dapat diubah nanti dengan metode setLabels

SetInstanceMachineTypeRequest

Permintaan untuk menyetel jenis mesin instance.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.setMachineType
machine_type

string

Wajib. Jenis mesin Compute Engine.

StartInstanceRequest

Permintaan untuk memulai instance notebook

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.start

StartRuntimeRequest

Permintaan untuk memulai Managed Notebook Runtime.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.runtimes.start
request_id

string

UUID permintaan idempoten.

StopInstanceRequest

Permintaan untuk menghentikan instance notebook

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.stop

StopRuntimeRequest

Permintaan untuk menghentikan Managed Notebook Runtime.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.runtimes.stop
request_id

string

UUID permintaan idempoten.

SwitchRuntimeRequest

Permintaan untuk mengganti Managed Notebook Runtime.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/runtimes/{runtime_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.runtimes.switch
machine_type

string

jenis mesin.
accelerator_config

RuntimeAcceleratorConfig

konfigurasi akselerator.
request_id

string

UUID permintaan idempoten.

UpdateInstanceConfigRequest

Permintaan untuk memperbarui konfigurasi instance.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.updateConfig
config

InstanceConfig

Konfigurasi instance yang akan diperbarui.

UpdateInstanceMetadataItemsRequest

Permintaan untuk menambahkan/mengubah item metadata untuk instance.

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.updateConfig
items

map<string, string>

Item metadata yang akan ditambahkan/diperbarui untuk instance.

UpdateInstanceMetadataItemsResponse

Respons untuk menambahkan/mengubah item metadata untuk instance.

Kolom
items

map<string, string>

Peta item yang ditambahkan/diperbarui ke/dalam metadata.

UpdateRuntimeRequest

Permintaan untuk memperbarui konfigurasi Managed Notebook.

Kolom
runtime

Runtime

Wajib. Runtime yang akan diperbarui.

Otorisasi memerlukan izin IAM berikut pada runtime resource yang ditentukan:

  • notebooks.runtimes.update
update_mask

FieldMask

Wajib. Menentukan jalur, yang terkait dengan Runtime, dari kolom yang akan diperbarui. Misalnya, untuk mengubah kernel konfigurasi software, parameter update_mask akan ditentukan sebagai software_config.kernels, dan isi permintaan PATCH akan menentukan nilai baru, sebagai berikut:

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

Saat ini, hanya kolom berikut yang dapat diperbarui:

  • 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 permintaan idempoten.

UpdateShieldedInstanceConfigRequest

Permintaan untuk memperbarui konfigurasi Instance Terlindungi untuk instance notebook. Anda hanya dapat menggunakan metode ini pada instance yang dihentikan

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.updateShieldInstanceConfig
shielded_instance_config

ShieldedInstanceConfig

Konfigurasi ShieldedInstance yang akan diupdate.

UpgradeInstanceRequest

Permintaan untuk mengupgrade instance notebook

Kolom
name

string

Wajib. Format: projects/{project_id}/locations/{location}/instances/{instance_id}

Otorisasi memerlukan izin IAM berikut pada name resource yang ditentukan:

  • notebooks.instances.upgrade
type

UpgradeType

Opsional. UpgradeType opsional. Menetapkan kolom ini akan menelusuri image komputasi tambahan untuk mengupgrade instance ini.

UpgradeType

Definisi jenis upgrade yang dapat digunakan pada instance ini.

Enum
UPGRADE_TYPE_UNSPECIFIED Jenis upgrade tidak ditentukan.
UPGRADE_FRAMEWORK Mengupgrade framework ML.
UPGRADE_OS Upgrade Sistem Operasi.
UPGRADE_CUDA Upgrade CUDA.
UPGRADE_ALL Upgrade Semua (OS, Framework, dan CUDA).

VirtualMachine

Runtime menggunakan Virtual Machine untuk komputasi.

Kolom
instance_name

string

Hanya output. Nama instance Managed Compute Engine yang mudah digunakan.
instance_id

string

Hanya output. ID unik instance Managed Compute Engine.
virtual_machine_config

VirtualMachineConfig

Setelan konfigurasi Mesin Virtual.

VirtualMachineConfig

Setelan konfigurasi untuk virtual machine.

Kolom
zone

string

Hanya output. Zona tempat virtual machine berada. Jika menggunakan permintaan regional, layanan notebook akan memilih lokasi di region runtime yang sesuai. Pada permintaan get, zona akan selalu ada. Contoh: * us-central1-b
machine_type

string

Wajib. Jenis mesin Compute Engine yang digunakan untuk runtime. Nama pendek valid. Contoh: * n1-standard-2 * e2-standard-8
container_images[]

ContainerImage

Opsional. Gunakan daftar image container untuk digunakan sebagai Kernel di instance notebook.
data_disk

LocalDisk

Wajib. Setelan konfigurasi opsi disk data.
encryption_config

EncryptionConfig

Opsional. Setelan enkripsi untuk disk data virtual machine.
shielded_instance_config

RuntimeShieldedInstanceConfig

Opsional. Setelan konfigurasi Instance Shielded VM.
accelerator_config

RuntimeAcceleratorConfig

Opsional. Konfigurasi akselerator Compute Engine untuk runtime ini.
network

string

Opsional. Jaringan Compute Engine yang akan digunakan untuk komunikasi mesin. Tidak dapat ditentukan dengan subnetwork. Jika network maupun subnet tidak ditentukan, jaringan "default" project akan digunakan, jika ada.

URL lengkap atau URI parsial. Contoh:

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

Runtime adalah resource terkelola di dalam Infrastruktur Google. Runtime mendukung konfigurasi jaringan berikut:

  • Jaringan Terkelola Google (Jaringan & subnet kosong)
  • VPC Project Konsumen (jaringan & subnet diperlukan). Memerlukan konfigurasi Private Service Access.
  • VPC Bersama (jaringan & subnet diperlukan). Memerlukan konfigurasi Private Service Access.
subnet

string

Opsional. Subnetwork Compute Engine yang akan digunakan untuk komunikasi mesin. Tidak dapat ditentukan dengan jaringan.

URL lengkap atau URI sebagian valid. Contoh:

  • 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

Opsional. Jika benar (true), runtime hanya akan memiliki alamat IP internal. Secara default, runtime tidak dibatasi ke alamat IP internal, dan akan memiliki alamat IP eksternal sementara yang ditetapkan ke setiap VM. Pembatasan internal_ip_only ini hanya dapat diaktifkan untuk jaringan yang mendukung subnetwork, dan semua dependensi harus dikonfigurasi agar dapat diakses tanpa alamat IP eksternal.
tags[]

string

Opsional. Tag jaringan Compute Engine yang akan ditambahkan ke runtime (lihat Menambahkan tag jaringan).
guest_attributes

map<string, string>

Hanya output. Atribut tamu Compute Engine. (lihat Atribut tamu project dan instance).
metadata

map<string, string>

Opsional. Entri metadata Compute Engine yang akan ditambahkan ke virtual machine. (lihat Metadata project dan instance).
labels

map<string, string>

Opsional. Label yang akan dikaitkan dengan runtime ini. Kunci label harus berisi 1 hingga 63 karakter, dan harus sesuai dengan RFC 1035. Nilai label boleh kosong, tetapi, jika ada, harus berisi 1 hingga 63 karakter, dan harus sesuai dengan RFC 1035. Maksimal 32 label dapat dikaitkan dengan cluster.
nic_type

NicType

Opsional. Jenis vNIC yang akan digunakan pada antarmuka ini. Ini dapat berupa gVNIC atau VirtioNet.
reserved_ip_range

string

Opsional. Nama Rentang IP yang Dicadangkan digunakan untuk Peering VPC. Alokasi subnetwork akan menggunakan rentang name jika ditetapkan.

Contoh: 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

Nilai kolom akan menjadi: managed-notebooks-range-c
boot_image

BootImage

Opsional. Metadata image booting yang digunakan untuk kemampuan upgrade runtime.

BootImage

Jenis ini tidak memiliki kolom.

Definisi image booting yang digunakan oleh Runtime. Digunakan untuk memfasilitasi kemampuan upgrade runtime.

NicType

Jenis driver vNIC. Default-nya harus UNSPECIFIED_NIC_TYPE.

Enum
UNSPECIFIED_NIC_TYPE Tidak ada jenis yang ditentukan.
VIRTIO_NET VIRTIO
GVNIC GVNIC

VmImage

Definisi image virtual machine Compute Engine kustom untuk memulai instance notebook dengan lingkungan yang diinstal langsung di VM.

Kolom
project

string

Wajib. Nama project Google Cloud tempat image VM ini berada. Format: {project_id}
Kolom union image. Referensi ke image VM Compute Engine eksternal. image hanya ada berupa salah satu diantara berikut:
image_name

string

Gunakan nama image VM untuk menemukan image.
image_family

string

Gunakan kelompok image VM ini untuk menemukan image; image terbaru dalam kelompok ini akan digunakan.