Resource: Instance
Definisi instance notebook.
| Representasi JSON |
|---|
{ "name": string, "postStartupScript": string, "proxyUri": string, "instanceOwners": [ string ], "serviceAccount": string, "serviceAccountScopes": [ string ], "machineType": string, "acceleratorConfig": { object ( |
| Kolom | |
|---|---|
name |
Hanya output. Nama instance notebook ini. Format: |
postStartupScript |
Jalur ke skrip Bash yang otomatis berjalan setelah instance notebook di-boot sepenuhnya. Jalur tersebut harus berupa URL atau jalur Cloud Storage ( |
proxyUri |
Hanya output. Endpoint proxy yang digunakan untuk mengakses notebook Jupyter. |
instanceOwners[] |
Hanya input. Pemilik instance ini setelah dibuat. Format: Saat ini hanya mendukung satu pemilik. Jika tidak ditentukan, semua pengguna akun layanan dari akun layanan instance VM Anda dapat menggunakan instance tersebut. |
serviceAccount |
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. |
serviceAccountScopes[] |
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 |
machineType |
Wajib. Jenis mesin Compute Engine instance ini. |
acceleratorConfig |
Akselerator hardware yang digunakan pada instance ini. Jika Anda menggunakan akselerator, pastikan konfigurasi Anda memiliki vCPU dan memori yang cukup untuk mendukung |
state |
Hanya output. Status instance ini. |
installGpuDriver |
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. |
customGpuDriverPath |
Tentukan jalur Cloud Storage kustom tempat driver GPU disimpan. Jika tidak ditentukan, kami akan otomatis memilih dari driver GPU resmi. |
bootDiskType |
Hanya input. Jenis boot disk yang terpasang ke instance ini, defaultnya adalah persistent disk standar ( |
bootDiskSizeGb |
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, defaultnya adalah 100. |
dataDiskType |
Hanya input. Jenis disk data yang terpasang ke instance ini, defaultnya adalah persistent disk standar ( |
dataDiskSizeGb |
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, defaultnya adalah 100. |
noRemoveDataDisk |
Hanya input. Jika benar (true), disk data tidak akan dihapus otomatis saat menghapus instance. |
diskEncryption |
Hanya input. Metode enkripsi disk yang digunakan pada boot disk dan disk data, defaultnya adalah GMEK. |
kmsKey |
Hanya input. Kunci KMS yang digunakan untuk mengenkripsi disk, hanya berlaku jika diskEncryption adalah CMEK. Format: Pelajari lebih lanjut cara menggunakan kunci enkripsi Anda sendiri. |
disks[] |
Hanya output. Disk terpasang ke instance notebook. |
shieldedInstanceConfig |
Opsional. Konfigurasi Shielded VM. Image yang menggunakan fitur Shielded VM yang didukung. |
noPublicIp |
Jika benar (true), tidak ada IP eksternal yang akan ditetapkan ke instance ini. |
noProxyAccess |
Jika benar, instance notebook tidak akan didaftarkan dengan proxy. |
network |
Nama VPC tempat instance ini berada. Format: |
subnet |
Nama subnet tempat instance ini berada. Format: |
labels |
Label yang akan diterapkan ke instance ini. Label ini dapat diubah nanti dengan metode setLabels. Objek yang berisi daftar pasangan |
metadata |
Metadata kustom yang akan diterapkan ke instance ini. Misalnya, untuk menentukan bucket Cloud Storage untuk pencadangan otomatis, Anda dapat menggunakan tag metadata Objek yang berisi daftar pasangan |
tags[] |
Opsional. Tag jaringan Compute Engine yang akan ditambahkan ke runtime (lihat Menambahkan tag jaringan). |
upgradeHistory[] |
Histori upgrade instance ini. |
nicType |
Opsional. Jenis vNIC yang akan digunakan pada antarmuka ini. Ini dapat berupa gVNIC atau VirtioNet. |
reservationAffinity |
Opsional. Afinitas reservasi opsional. Menetapkan kolom ini akan menerapkan Zonal Compute Reservation yang ditentukan ke instance notebook ini. |
creator |
Hanya output. Alamat email entitas yang mengirim permintaan instances.create asli. |
canIpForward |
Opsional. Flag untuk mengaktifkan penerusan IP atau tidak, defaultnya adalah salah/nonaktif. https://cloud.google.com/vpc/docs/using-routes#canipforward |
createTime |
Hanya output. Waktu pembuatan instance. 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 instance. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
instanceMigrationEligibility |
Hanya output. Memeriksa seberapa layak migrasi dari UmN ke WbI. |
| Jenis lingkungan; dapat berupa image VM atau image container. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons: | |
vmImage |
Gunakan image VM Compute Engine untuk memulai instance notebook. |
containerImage |
Gunakan image container untuk memulai instance notebook. |
| Akhir kolom yang saling eksklusif. | |
migrated |
Hanya output. Bool yang menunjukkan apakah notebook ini telah dimigrasikan ke Instance Workbench |
AcceleratorConfig
Definisi akselerator hardware. Perhatikan bahwa tidak semua kombinasi type dan coreCount valid. Lihat GPU di Compute Engine untuk menemukan kombinasi yang valid. TPU tidak didukung.
| Representasi JSON |
|---|
{
"type": enum ( |
| Kolom | |
|---|---|
type |
Jenis akselerator ini. |
coreCount |
Jumlah core 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 akseleratornya adalah Nvidia Tesla T4. |
NVIDIA_TESLA_A100 |
Jenis akseleratornya adalah Nvidia Tesla A100. |
NVIDIA_L4 |
Jenis akselerator adalah Nvidia Tesla L4. |
NVIDIA_A100_80GB |
Jenis akselerator 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. |
Negara Bagian
Definisi status instance ini.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status tidak ditentukan. |
STARTING |
Logika kontrol 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. |
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. |
DiskEncryption
Definisi opsi enkripsi disk.
| Enum | |
|---|---|
DISK_ENCRYPTION_UNSPECIFIED |
Enkripsi disk tidak ditentukan. |
GMEK |
Gunakan kunci enkripsi yang dikelola Google untuk mengenkripsi boot disk. |
CMEK |
Gunakan kunci enkripsi yang dikelola pelanggan untuk mengenkripsi boot disk. |
Disk
Resource disk yang terpasang ke instance.
| Representasi JSON |
|---|
{
"autoDelete": boolean,
"boot": boolean,
"deviceName": string,
"diskSizeGb": string,
"guestOsFeatures": [
{
object ( |
| Kolom | |
|---|---|
autoDelete |
Menunjukkan apakah disk akan dihapus otomatis saat instance dihapus (tetapi tidak saat disk dilepas dari instance). |
boot |
Menunjukkan bahwa ini adalah disk boot. Virtual machine akan menggunakan partisi pertama disk untuk sistem file root-nya. |
deviceName |
Menunjukkan 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. |
diskSizeGb |
Menunjukkan ukuran disk dalam GB berbasis 2. |
guestOsFeatures[] |
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 |
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 |
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:
|
kind |
Jenis resource. Selalu hitung#attachedDisk untuk disk yang terpasang. |
licenses[] |
Daftar lisensi yang terlihat secara publik. Dicadangkan untuk penggunaan Google. Lisensi mewakili data penagihan dan penggunaan gabungan untuk image publik dan marketplace. |
mode |
Mode untuk melampirkan disk ini, baik
|
source |
Menunjukkan URL sebagian atau penuh yang valid ke resource Persistent Disk yang ada. |
type |
Menunjukkan jenis disk, baik
|
GuestOsFeature
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:
|
ShieldedInstanceConfig
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. |
UpgradeHistoryEntry
Entri histori upgrade image VM.
| Representasi JSON |
|---|
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum ( |
| Kolom | |
|---|---|
snapshot |
Snapshot boot disk instance notebook ini sebelum upgrade. |
vmImage |
Image VM sebelum upgrade instance ini. |
containerImage |
Image container sebelum upgrade instance ini. |
framework |
Framework instance notebook ini. |
version |
Versi instance notebook sebelum upgrade ini. |
state |
Status entri histori upgrade instance ini. |
createTime |
Waktu saat entri histori upgrade instance ini dibuat. Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: |
targetImage |
Image VM Target. Format: |
action |
Tindakan. Rollback atau Upgrade. |
targetVersion |
Versi VM Target, seperti m63. |
Negara Bagian
Definisi status entri histori upgrade ini.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Status tidak ditentukan. |
STARTED |
Upgrade instance dimulai. |
SUCCEEDED |
Upgrade instance berhasil. |
FAILED |
Upgrade instance gagal. |
Tindakan
Definisi operasi entri histori upgrade ini.
| Enum | |
|---|---|
ACTION_UNSPECIFIED |
Operasi tidak ditentukan. |
UPGRADE |
Upgrade. |
ROLLBACK |
Rollback. |
NicType
Jenis driver vNIC. Defaultnya harus UNSPECIFIED_NIC_TYPE.
| Enum | |
|---|---|
UNSPECIFIED_NIC_TYPE |
Tidak ada jenis yang ditentukan. |
VIRTIO_NET |
VIRTIO |
GVNIC |
GVNIC |
ReservationAffinity
Afinitas Reservasi untuk menggunakan reservasi Zonal.
| Representasi JSON |
|---|
{
"consumeReservationType": enum ( |
| Kolom | |
|---|---|
consumeReservationType |
Opsional. Jenis reservasi yang akan digunakan |
key |
Opsional. Sesuai dengan kunci label resource reservasi. |
values[] |
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. |
InstanceMigrationEligibility
InstanceMigrationEligibility mewakili informasi kelayakan migrasi dari UmN ke WbI.
| Representasi JSON |
|---|
{ "warnings": [ enum ( |
| Kolom | |
|---|---|
warnings[] |
Hanya output. Konfigurasi tertentu akan ditetapkan secara default selama migrasi. |
errors[] |
Hanya output. Konfigurasi tertentu membuat UmN 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_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 noRemoveDataDisk, 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 postStartupScriptOption untuk migrasi secara opsional. |
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. |
Metode |
|
|---|---|
|
Membuat Instance baru di project dan lokasi tertentu. |
|
Menghapus satu Instance. |
|
Membuat File Diagnostik dan menjalankan Alat Diagnostik yang diberikan Instance. |
|
Mendapatkan detail satu Instance. |
|
Mendapatkan kebijakan kontrol akses untuk resource. |
|
Memeriksa apakah instance notebook responsif atau tidak. |
|
Memeriksa apakah instance notebook dapat diupgrade. |
|
Mencantumkan instance di project dan lokasi tertentu. |
|
Memigrasikan Notebook yang Dikelola Pengguna yang ada ke Instance Workbench. |
|
Mendaftarkan instance notebook lama yang ada ke server Notebooks API. |
|
Memungkinkan instance notebook melaporkan informasi instance terbarunya ke server Notebooks API. |
|
Mereset instance notebook. |
|
Melakukan roll back instance notebook ke versi sebelumnya. |
|
Memperbarui akselerator tamu dari satu Instance. |
|
Menetapkan kebijakan kontrol akses pada resource yang ditentukan. |
|
Mengganti semua label Instance. |
|
Memperbarui jenis mesin satu Instance. |
|
Memulai instance notebook. |
|
Menghentikan instance notebook. |
|
Menampilkan izin yang dimiliki pemanggil pada resource tertentu. |
|
Perbarui konfigurasi Instance Notebook. |
|
Menambahkan/memperbarui item metadata untuk instance. |
|
Memperbarui konfigurasi Instance terlindungi dari satu Instance. |
|
Mengupgrade instance notebook ke versi terbaru. |