Resource: Runtime
Definisi Runtime untuk instance notebook terkelola.
| Representasi JSON |
|---|
{ "name": string, "state": enum ( |
| Kolom | |
|---|---|
name |
Hanya output. Nama resource runtime. Format: |
state |
Hanya output. Status runtime. |
healthState |
Hanya output. healthState runtime. |
accessConfig |
Setelan konfigurasi untuk mengakses runtime. |
softwareConfig |
Setelan konfigurasi untuk software di dalam runtime. |
metrics |
Hanya output. Berisi metrik daemon Runtime seperti Status layanan dan statistik JupyterLab. |
createTime |
Hanya output. Waktu pembuatan runtime. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
updateTime |
Hanya output. Waktu update runtime. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
labels |
Opsional. Label yang akan dikaitkan dengan Notebook Terkelola 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. Objek yang berisi daftar pasangan |
runtimeMigrationEligibility |
Hanya output. Memeriksa seberapa layak migrasi dari GmN ke WbI. |
| Jenis runtime; saat ini hanya mendukung VM Compute Engine. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons: | |
virtualMachine |
Gunakan image VM Compute Engine untuk memulai instance notebook terkelola. |
| Akhir kolom yang saling eksklusif. | |
migrated |
Hanya output. Bool yang menunjukkan apakah notebook ini telah dimigrasikan ke Instance Workbench |
VirtualMachine
Runtime menggunakan Virtual Machine untuk komputasi.
| Representasi JSON |
|---|
{
"instanceName": string,
"instanceId": string,
"virtualMachineConfig": {
object ( |
| Kolom | |
|---|---|
instanceName |
Hanya output. Nama instance Managed Compute Engine yang mudah digunakan. |
instanceId |
Hanya output. ID unik instance Managed Compute Engine. |
virtualMachineConfig |
Setelan konfigurasi Virtual Machine. |
VirtualMachineConfig
Setelan konfigurasi untuk virtual machine.
| Representasi JSON |
|---|
{ "zone": string, "machineType": string, "containerImages": [ { object ( |
| Kolom | |
|---|---|
zone |
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: * |
machineType |
Wajib. Jenis mesin Compute Engine yang digunakan untuk runtime. Nama pendek valid. Contoh: * |
containerImages[] |
Opsional. Gunakan daftar image container untuk digunakan sebagai Kernel di instance notebook. |
dataDisk |
Wajib. Setelan konfigurasi opsi disk data. |
encryptionConfig |
Opsional. Setelan enkripsi untuk disk data virtual machine. |
shieldedInstanceConfig |
Opsional. Setelan konfigurasi Instance VM Terlindungi. |
acceleratorConfig |
Opsional. Konfigurasi akselerator Compute Engine untuk runtime ini. |
network |
Opsional. Jaringan Compute Engine yang akan digunakan untuk komunikasi mesin. Tidak dapat ditentukan dengan subnetwork. Jika URL lengkap atau URI sebagian. Contoh:
Runtime adalah resource terkelola di dalam Infrastruktur Google. Runtime mendukung konfigurasi jaringan berikut:
|
subnet |
Opsional. Subjaringan Compute Engine yang akan digunakan untuk komunikasi mesin. Tidak dapat ditentukan dengan jaringan. URL lengkap atau URI sebagian yang valid. Contoh:
|
internalIpOnly |
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 |
tags[] |
Opsional. Tag jaringan Compute Engine yang akan ditambahkan ke runtime (lihat Menambahkan tag jaringan). |
guestAttributes |
Hanya output. Atribut tamu Compute Engine. (lihat Atribut tamu project dan instance). Objek yang berisi daftar pasangan |
metadata |
Opsional. Entri metadata Compute Engine yang akan ditambahkan ke virtual machine. (lihat Metadata project dan instance). Objek yang berisi daftar pasangan |
labels |
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. Objek yang berisi daftar pasangan |
nicType |
Opsional. Jenis vNIC yang akan digunakan pada antarmuka ini. Ini dapat berupa gVNIC atau VirtioNet. |
reservedIpRange |
Opsional. Nama Rentang IP yang Dicadangkan digunakan untuk Peering VPC. Alokasi subnetwork akan menggunakan rentang name jika ditetapkan. Contoh: managed-notebooks-range-c Nilai kolom adalah: |
bootImage |
Opsional. Metadata image booting yang digunakan untuk kemampuan upgrade runtime. |
LocalDisk
Resource disk terpasang lokal.
| Representasi JSON |
|---|
{ "autoDelete": boolean, "boot": boolean, "deviceName": string, "guestOsFeatures": [ { object ( |
| Kolom | |
|---|---|
autoDelete |
Opsional. Hanya output. Menentukan apakah disk akan dihapus otomatis saat instance dihapus (tetapi tidak saat disk dilepas dari instance). |
boot |
Opsional. Hanya output. Menunjukkan bahwa ini adalah disk boot. Virtual machine akan menggunakan partisi pertama disk untuk sistem file root-nya. |
deviceName |
Opsional. Hanya output. Menentukan nama perangkat unik pilihan Anda yang tercermin dalam hierarki Jika tidak ditentukan, server akan memilih nama perangkat default untuk diterapkan ke disk ini, dalam bentuk persistent-disk-x, dengan x adalah angka yang ditetapkan oleh Google Compute Engine. Kolom ini hanya berlaku untuk persistent disk. |
guestOsFeatures[] |
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 |
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. |
initializeParams |
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 |
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:
|
kind |
Hanya output. Jenis resource. Selalu hitung#attachedDisk untuk disk yang terpasang. |
licenses[] |
Hanya output. Lisensi yang valid dan terlihat secara publik. |
mode |
Mode untuk melampirkan disk ini, baik
|
source |
Menentukan URL sebagian atau lengkap yang valid ke resource Persistent Disk yang ada. |
type |
Menentukan jenis disk, baik
|
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.
| Representasi JSON |
|---|
{ "type": string } |
| Kolom | |
|---|---|
type |
ID fitur yang didukung. Baca Mengaktifkan fitur sistem operasi tamu untuk melihat daftar opsi yang tersedia. Nilai valid:
|
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.
| Representasi JSON |
|---|
{
"description": string,
"diskName": string,
"diskSizeGb": string,
"diskType": enum ( |
| Kolom | |
|---|---|
description |
Opsional. Berikan properti ini saat membuat disk. |
diskName |
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. |
diskSizeGb |
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. |
diskType |
Hanya input. Jenis boot disk yang terpasang ke instance ini, defaultnya adalah persistent disk standar ( |
labels |
Opsional. Label yang akan diterapkan ke disk ini. Label ini dapat diubah nanti dengan metode disks.setLabels. Kolom ini hanya berlaku untuk persistent disk. Objek yang berisi daftar pasangan |
DiskType
Jenis disk yang mungkin.
| 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. |
EncryptionConfig
Mewakili konfigurasi kunci enkripsi kustom yang dapat diterapkan ke resource. Tindakan ini akan mengenkripsi semua disk di Virtual Machine.
| Representasi JSON |
|---|
{ "kmsKey": string } |
| Kolom | |
|---|---|
kmsKey |
ID resource Cloud KMS dari kunci enkripsi yang dikelola pelanggan yang digunakan untuk melindungi resource, seperti disk. Formatnya adalah sebagai berikut: |
RuntimeShieldedInstanceConfig
Kumpulan opsi Instance Terlindungi. Lihat Image yang menggunakan fitur Shielded VM yang didukung. Tidak semua kombinasi valid.
| Representasi JSON |
|---|
{ "enableSecureBoot": boolean, "enableVtpm": boolean, "enableIntegrityMonitoring": boolean } |
| Kolom | |
|---|---|
enableSecureBoot |
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. |
enableVtpm |
Menentukan apakah instance mengaktifkan vTPM. Diaktifkan secara default. |
enableIntegrityMonitoring |
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. |
RuntimeAcceleratorConfig
Definisi jenis akselerator hardware yang dapat digunakan. Lihat Compute Engine AcceleratorTypes. Contoh:
nvidia-tesla-k80nvidia-tesla-p100nvidia-tesla-v100nvidia-tesla-p4nvidia-tesla-t4nvidia-tesla-a100
| Representasi JSON |
|---|
{
"type": enum ( |
| Kolom | |
|---|---|
type |
Model akselerator. |
coreCount |
Jumlah core 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 akseleratornya adalah Nvidia Tesla T4. |
NVIDIA_TESLA_A100 |
Jenis akselerator 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. |
NicType
Jenis driver vNIC. Defaultnya harus UNSPECIFIED_NIC_TYPE.
| Enum | |
|---|---|
UNSPECIFIED_NIC_TYPE |
Tidak ada jenis yang ditentukan. |
VIRTIO_NET |
VIRTIO |
GVNIC |
GVNIC |
BootImage
Jenis ini tidak memiliki kolom.
Definisi image booting yang digunakan oleh Runtime. Digunakan untuk memfasilitasi kemampuan upgrade runtime.
Negara Bagian
Definisi status runtime ini.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status tidak ditentukan. |
STARTING |
Lapisan komputasi sedang memulai runtime. Model ini belum siap digunakan. |
PROVISIONING |
Lapisan komputasi menginstal framework yang diperlukan dan mendaftarkan runtime dengan proxy notebook. Tidak dapat digunakan. |
ACTIVE |
Runtime saat ini sedang berjalan. Fitur ini siap digunakan. |
STOPPING |
Logika kontrol menghentikan runtime. Tidak dapat digunakan. |
STOPPED |
Runtime dihentikan. Tidak dapat digunakan. |
DELETING |
Runtime sedang dihapus. Tidak dapat digunakan. |
UPGRADING |
Runtime sedang diupgrade. Tidak dapat digunakan. |
INITIALIZING |
Runtime sedang dibuat dan disiapkan. Model ini belum siap digunakan. |
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 kondisi 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. |
RuntimeAccessConfig
Menentukan konfigurasi login untuk Runtime
| Representasi JSON |
|---|
{
"accessType": enum ( |
| Kolom | |
|---|---|
accessType |
Jenis mode akses instance ini. |
runtimeOwner |
Pemilik runtime ini setelah pembuatan. Format: |
proxyUri |
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). |
RuntimeSoftwareConfig
Menentukan pemilihan dan konfigurasi software di dalam runtime. Properti yang akan ditetapkan saat runtime. Kunci properti ditentukan dalam format key:value, misalnya:
idleShutdown: trueidleShutdownTimeout: 180enableHealthMonitoring: true
| Representasi JSON |
|---|
{ "notebookUpgradeSchedule": string, "idleShutdownTimeout": integer, "installGpuDriver": boolean, "customGpuDriverPath": string, "postStartupScript": string, "kernels": [ { object ( |
| Kolom | |
|---|---|
notebookUpgradeSchedule |
Ekspresi cron dalam zona waktu UTC, digunakan untuk menjadwalkan upgrade otomatis instance. Harap ikuti format cron. |
idleShutdownTimeout |
Waktu dalam menit untuk menunggu sebelum mematikan runtime. Default: 180 menit |
installGpuDriver |
Menginstal Driver Nvidia secara otomatis. Default: True |
customGpuDriverPath |
Tentukan jalur Cloud Storage kustom tempat driver GPU disimpan. Jika tidak ditentukan, kami akan otomatis memilih dari driver GPU resmi. |
postStartupScript |
Jalur ke skrip Bash yang otomatis berjalan setelah instance notebook di-boot sepenuhnya. Jalur tersebut harus berupa URL atau jalur Cloud Storage ( |
kernels[] |
Opsional. Gunakan daftar image container untuk digunakan sebagai Kernel di instance notebook. |
postStartupScriptBehavior |
Perilaku untuk skrip pasca-startup. |
enableHealthMonitoring |
Memverifikasi bahwa layanan internal inti sedang berjalan. Default: True |
idleShutdown |
Runtime akan otomatis dimatikan setelah idle_shutdown_time. Default: True |
upgradeable |
Hanya output. Bool yang menunjukkan apakah image yang lebih baru tersedia dalam kelompok image. |
disableTerminal |
Bool yang menunjukkan apakah terminal JupyterLab akan tersedia atau tidak. Default: False |
version |
Khusus output. Versi boot image seperti M100, dari label rilis image. |
mixerDisabled |
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 dijalankan sekali saat pembuatan. |
RUN_EVERY_START |
Menjalankan skrip pasca-startup yang disediakan selama pembuatan di setiap permulaan. |
DOWNLOAD_AND_RUN_EVERY_START |
Mendownload dan menjalankan skrip pasca-startup yang disediakan setiap kali dimulai. |
RuntimeMetrics
Berisi metrik daemon runtime, seperti OS dan kernel serta statistik sesi.
| Representasi JSON |
|---|
{ "systemMetrics": { string: string, ... } } |
| Kolom | |
|---|---|
systemMetrics |
Hanya output. Metrik sistem. Objek yang berisi daftar pasangan |
RuntimeMigrationEligibility
RuntimeMigrationEligibility menampilkan informasi kelayakan migrasi dari GmN ke WbI.
| Representasi JSON |
|---|
{ "warnings": [ enum ( |
| Kolom | |
|---|---|
warnings[] |
Hanya output. Konfigurasi tertentu akan ditetapkan secara default selama migrasi. |
errors[] |
Hanya output. Konfigurasi tertentu membuat GmN tidak memenuhi syarat untuk migrasi otomatis. Migrasi manual diperlukan. |
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 setelah startup. Anda dapat memberikan postStartupScriptOption untuk migrasi secara opsional. |
SINGLE_USER |
GmN ini dikonfigurasi dengan mode pengguna tunggal. Jika ingin, berikan opsi serviceAccount untuk migrasi. |
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. |
Metode |
|
|---|---|
|
Membuat Runtime baru di project dan lokasi tertentu. |
|
Menghapus satu Runtime. |
|
Mendapatkan detail satu Runtime. |
|
Mendapatkan kebijakan kontrol akses untuk resource. |
|
Mencantumkan Runtime dalam project dan lokasi tertentu. |
|
Memigrasikan Runtime yang ada ke Instance Workbench baru. |
|
Perbarui konfigurasi Notebook Runtime. |
|
Melaporkan dan memproses peristiwa runtime. |
|
Mereset Managed Notebook Runtime. |
|
Menetapkan kebijakan kontrol akses pada resource yang ditentukan. |
|
Memulai Managed Notebook Runtime. |
|
Menghentikan Managed Notebook Runtime. |
|
Mengganti Managed Notebook Runtime. |
|
Menampilkan izin yang dimiliki pemanggil pada resource tertentu. |