Resource: Instance
Definisi instance notebook.
| Representasi JSON |
|---|
{ "name": string, "proxyUri": string, "instanceOwners": [ string ], "creator": string, "state": enum ( |
| Kolom | |
|---|---|
name |
Hanya output. ID. Nama instance notebook ini. Format: |
proxyUri |
Hanya output. Endpoint proxy yang digunakan untuk mengakses notebook Jupyter. |
instanceOwners[] |
Opsional. 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. |
creator |
Hanya output. Alamat email entitas yang mengirim permintaan instances.create asli. |
state |
Hanya output. Status instance ini. |
upgradeHistory[] |
Hanya output. Histori upgrade instance ini. |
id |
Hanya output. ID unik resource. |
healthState |
Hanya output. healthState instance. |
healthInfo |
Hanya output. Informasi tambahan tentang kondisi instance. Contoh: Objek yang berisi daftar pasangan |
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: |
disableProxyAccess |
Opsional. Jika benar, instance notebook tidak akan didaftarkan ke proxy. |
labels |
Opsional. Label yang akan diterapkan ke instance ini. Setelan ini dapat diubah nanti dengan metode instances.patch. Objek yang berisi daftar pasangan |
thirdPartyProxyUrl |
Hanya output. Endpoint proxy kumpulan tenaga kerja yang digunakan untuk mengakses notebook Jupyter. |
satisfiesPzs |
Hanya output. Dicadangkan untuk penggunaan mendatang untuk Pemisahan Zona. |
satisfiesPzi |
Hanya output. Dicadangkan untuk penggunaan mendatang untuk Isolasi Zona. |
enableThirdPartyIdentity |
Opsional. Tanda yang menentukan bahwa notebook dapat diakses dengan penyedia identitas pihak ketiga. |
enableManagedEuc |
Opsional. Flag untuk mengaktifkan kredensial pengguna akhir terkelola untuk instance. |
enableDeletionProtection |
Opsional. Jika benar (true), perlindungan penghapusan akan diaktifkan untuk Instance Workbench ini. Jika salah (false), perlindungan penghapusan akan dinonaktifkan untuk Instance Workbench ini. |
Kolom union infrastructure. Penyiapan untuk instance Notebook. infrastructure hanya ada berupa salah satu diantara berikut: |
|
gceSetup |
Opsional. Penyiapan Compute Engine untuk notebook. Menggunakan kolom yang ditentukan notebook. |
GceSetup
Definisi cara mengonfigurasi instance VM di luar Resources and Identity.
| Representasi JSON |
|---|
{ "machineType": string, "minCpuPlatform": string, "acceleratorConfigs": [ { object ( |
| Kolom | |
|---|---|
machineType |
Opsional. Jenis mesin instance VM. https://cloud.google.com/compute/docs/machine-resource |
minCpuPlatform |
Opsional. Platform CPU minimum yang akan digunakan untuk instance ini. Daftar nilai yang valid dapat ditemukan di https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform#availablezones |
acceleratorConfigs[] |
Opsional. Akselerator hardware yang digunakan pada instance ini. Jika Anda menggunakan akselerator, pastikan konfigurasi Anda memiliki vCPU dan memori yang cukup untuk mendukung |
serviceAccounts[] |
Opsional. Akun layanan yang berfungsi sebagai identitas untuk instance VM. Saat ini hanya mendukung satu akun layanan. |
bootDisk |
Opsional. Boot disk untuk VM. |
dataDisks[] |
Opsional. Disk data yang terpasang ke instance VM. Saat ini hanya mendukung satu disk data. |
shieldedInstanceConfig |
Opsional. Konfigurasi Shielded VM. Image yang menggunakan fitur Shielded VM yang didukung. |
networkInterfaces[] |
Opsional. Antarmuka jaringan untuk VM. Hanya mendukung satu antarmuka. |
disablePublicIp |
Opsional. Jika benar (true), tidak ada IP eksternal yang akan ditetapkan ke instance VM ini. |
tags[] |
Opsional. Tag jaringan Compute Engine yang akan ditambahkan ke runtime (lihat Menambahkan tag jaringan). |
metadata |
Opsional. Metadata kustom yang akan diterapkan ke instance ini. Objek yang berisi daftar pasangan |
enableIpForwarding |
Opsional. Flag untuk mengaktifkan penerusan IP atau tidak, defaultnya salah/nonaktif. https://cloud.google.com/vpc/docs/using-routes#canipforward |
gpuDriverConfig |
Opsional. Konfigurasi untuk driver GPU. |
confidentialInstanceConfig |
Opsional. Konfigurasi instance rahasia. |
instanceId |
Hanya output. ID unik resource instance Compute Engine. |
Kolom union image. Jenis image; dapat berupa salah satu dari image VM atau image container. image hanya ada berupa salah satu diantara berikut: |
|
vmImage |
Opsional. Gunakan image VM Compute Engine untuk memulai instance notebook. |
containerImage |
Opsional. Gunakan image container untuk memulai instance notebook. |
AcceleratorConfig
Konfigurasi akselerator untuk instance VM. Definisi akselerator hardware. Perhatikan bahwa tidak ada pemeriksaan pada kombinasi type dan coreCount. TPU tidak didukung. Lihat GPU di Compute Engine untuk menemukan kombinasi yang valid.
| Representasi JSON |
|---|
{
"type": enum ( |
| Kolom | |
|---|---|
type |
Opsional. Jenis akselerator ini. |
coreCount |
Opsional. 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_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_A100_80GB |
Jenis akseleratornya adalah Nvidia Tesla A100 - 80 GB. |
NVIDIA_L4 |
Jenis akselerator adalah Nvidia Tesla L4. |
NVIDIA_H100_80GB |
Jenis akseleratornya adalah Nvidia Tesla H100 - 80 GB. |
NVIDIA_H100_MEGA_80GB |
Jenis akselerator adalah Nvidia Tesla H100 - MEGA 80 GB. |
NVIDIA_H200_141GB |
Jenis akseleratornya adalah Nvidia Tesla H200 - 141 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_B200 |
Jenis akselerator adalah NVIDIA B200. |
ServiceAccount
Akun layanan yang bertindak sebagai identitas.
| Representasi JSON |
|---|
{ "email": string, "scopes": [ string ] } |
| Kolom | |
|---|---|
email |
Opsional. Alamat email akun layanan. |
scopes[] |
Hanya output. Daftar cakupan yang akan tersedia untuk akun layanan ini. Ditetapkan oleh CLH ke https://www.googleapis.com/auth/cloud-platform |
VmImage
Definisi image virtual machine Compute Engine kustom untuk memulai instance notebook dengan lingkungan yang diinstal langsung di VM.
| Representasi JSON |
|---|
{ "project": string, // Union field |
| Kolom | |
|---|---|
project |
Wajib. Nama project Google Cloud tempat image VM ini berada. Format: |
Kolom union image. Referensi ke image VM Compute Engine eksternal. image hanya ada berupa salah satu diantara berikut: |
|
name |
Opsional. Gunakan nama image VM untuk menemukan image. |
family |
Opsional. Gunakan kelompok image VM ini untuk menemukan image; image terbaru dalam kelompok ini akan digunakan. |
ContainerImage
Definisi image container untuk memulai instance notebook dengan lingkungan yang diinstal dalam container.
| Representasi JSON |
|---|
{ "repository": string, "tag": string } |
| Kolom | |
|---|---|
repository |
Wajib. Jalur ke repositori image container. Contoh: |
tag |
Opsional. Tag image container. Jika tidak ditentukan, defaultnya adalah tag terbaru. |
BootDisk
Definisi boot disk.
| Representasi JSON |
|---|
{ "diskSizeGb": string, "diskType": enum ( |
| Kolom | |
|---|---|
diskSizeGb |
Opsional. Ukuran boot disk dalam GB yang terpasang ke instance ini, hingga maksimum 64000 GB (64 TB). Jika tidak ditentukan, nilai ini akan ditetapkan secara default ke nilai yang direkomendasikan, yaitu 150 GB. |
diskType |
Opsional. Menunjukkan jenis disk. |
diskEncryption |
Opsional. Hanya input. Metode enkripsi disk yang digunakan pada boot disk dan disk data, defaultnya adalah GMEK. |
kmsKey |
Opsional. 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. |
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. |
HYPERDISK_BALANCED |
Mewakili jenis persistent disk Hyperdisk Balanced. Dapat digunakan sebagai boot disk atau disk data. |
HYPERDISK_EXTREME |
Mewakili jenis persistent disk Hyperdisk Extreme. Hanya dapat digunakan sebagai disk data. |
HYPERDISK_THROUGHPUT |
Menunjukkan jenis persistent disk Hyperdisk Throughput. Hanya dapat digunakan sebagai disk data. |
HYPERDISK_BALANCED_HIGH_AVAILABILITY |
Mewakili jenis persistent disk Hyperdisk Balanced High Availability. Dapat digunakan sebagai boot disk atau disk data. |
HYPERDISK_ML |
Mewakili jenis persistent disk Hyperdisk ML. Dapat digunakan sebagai boot disk atau disk data. |
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. |
DataDisk
Resource disk yang terpasang ke instance.
| Representasi JSON |
|---|
{ "diskSizeGb": string, "diskType": enum ( |
| Kolom | |
|---|---|
diskSizeGb |
Opsional. Ukuran disk dalam GB yang terpasang ke instance VM ini, hingga maksimum 64000 GB (64 TB). Jika tidak ditentukan, nilai defaultnya adalah 100. |
diskType |
Opsional. Hanya input. Menunjukkan jenis disk. |
diskEncryption |
Opsional. Hanya input. Metode enkripsi disk yang digunakan pada boot disk dan disk data, defaultnya adalah GMEK. |
kmsKey |
Opsional. 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. |
resourcePolicies[] |
Opsional. Kebijakan resource yang akan diterapkan ke disk data. |
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 |
Opsional. Menentukan apakah instance VM 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 |
Opsional. Menentukan apakah instance VM mengaktifkan vTPM. |
enableIntegrityMonitoring |
Opsional. Menentukan apakah pemantauan integritas diaktifkan untuk instance VM. Mengaktifkan pemantauan dan pengesahan integritas booting instance VM. Pengesahan dilakukan terhadap dasar pengukuran kebijakan integritas. Baseline ini awalnya berasal dari image boot yang secara implisit tepercaya saat instance VM dibuat. |
NetworkInterface
Definisi resource antarmuka jaringan yang terpasang ke VM.
| Representasi JSON |
|---|
{ "network": string, "subnet": string, "nicType": enum ( |
| Kolom | |
|---|---|
network |
Opsional. Nama VPC tempat instance VM ini berada. Format: |
subnet |
Opsional. Nama subnet tempat instance VM ini berada. Format: |
nicType |
Opsional. Jenis vNIC yang akan digunakan pada antarmuka ini. Ini dapat berupa gVNIC atau VirtioNet. |
accessConfigs[] |
Opsional. Array konfigurasi untuk antarmuka ini. Saat ini, hanya satu konfigurasi akses, ONE_TO_ONE_NAT, yang didukung. Jika tidak ada accessConfigs yang ditentukan, instance akan memiliki akses internet eksternal melalui alamat IP eksternal sementara. |
NicType
Jenis driver vNIC. Defaultnya harus NIC_TYPE_UNSPECIFIED.
| Enum | |
|---|---|
NIC_TYPE_UNSPECIFIED |
Tidak ada jenis yang ditentukan. |
VIRTIO_NET |
VIRTIO |
GVNIC |
GVNIC |
AccessConfig
Konfigurasi akses yang terpasang ke antarmuka jaringan instance.
| Representasi JSON |
|---|
{ "externalIp": string } |
| Kolom | |
|---|---|
externalIp |
Alamat IP eksternal yang dikaitkan dengan instance ini. Tentukan alamat IP eksternal statis yang tidak digunakan dan tersedia untuk project atau biarkan kolom ini tidak ditentukan untuk menggunakan IP dari kumpulan alamat IP sementara yang digunakan bersama. Jika Anda menentukan alamat IP eksternal statis, alamat tersebut harus berada di region yang sama dengan zona instance. |
GPUDriverConfig
Konfigurasi driver GPU
| Representasi JSON |
|---|
{ "enableGpuDriver": boolean, "customGpuDriverPath": string } |
| Kolom | |
|---|---|
enableGpuDriver |
Opsional. Apakah pengguna akhir mengizinkan Google Cloud menginstal driver GPU di instance VM ini. Jika kolom ini kosong atau disetel ke salah (false), driver GPU tidak akan diinstal. Hanya berlaku untuk instance dengan GPU. |
customGpuDriverPath |
Opsional. Tentukan jalur Cloud Storage kustom tempat driver GPU disimpan. Jika tidak ditentukan, kami akan otomatis memilih dari driver GPU resmi. |
ConfidentialInstanceConfig
Serangkaian opsi Instance Rahasia.
| Representasi JSON |
|---|
{
"confidentialInstanceType": enum ( |
| Kolom | |
|---|---|
confidentialInstanceType |
Opsional. Menentukan jenis teknologi yang digunakan oleh instance rahasia. |
ConfidentialInstanceType
Jenis instance rahasia.
| Enum | |
|---|---|
CONFIDENTIAL_INSTANCE_TYPE_UNSPECIFIED |
Tidak ada jenis yang ditentukan. Jangan gunakan nilai ini. |
SEV |
AMD Secure Encrypted Virtualization. |
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. |
SUSPENDING |
Instance sedang ditangguhkan. |
SUSPENDED |
Instance ditangguhkan. |
UpgradeHistoryEntry
Entri histori upgrade image VM.
| Representasi JSON |
|---|
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum ( |
| Kolom | |
|---|---|
snapshot |
Opsional. Snapshot disk booting instance notebook ini sebelum upgrade. |
vmImage |
Opsional. Image VM sebelum upgrade instance ini. |
containerImage |
Opsional. Image container sebelum upgrade instance ini. |
framework |
Opsional. Framework instance notebook ini. |
version |
Opsional. Versi instance notebook sebelum upgrade ini. |
state |
Hanya output. Status entri histori upgrade instance ini. |
createTime |
Tidak dapat diubah. 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: |
action |
Opsional. Tindakan. Rollback atau Upgrade. |
targetVersion |
Opsional. Versi VM Target, seperti m63. |
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. |
Tindakan
Definisi operasi entri histori upgrade ini.
| Enum | |
|---|---|
ACTION_UNSPECIFIED |
Operasi tidak ditentukan. |
UPGRADE |
Upgrade. |
ROLLBACK |
Rollback. |
HealthState
Status respons instance.
| 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. |
Metode |
|
|---|---|
|
Memeriksa apakah instance notebook dapat diupgrade. |
|
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. |
|
Menampilkan berbagai parameter konfigurasi. |
|
Mendapatkan kebijakan kontrol akses untuk resource. |
|
Mencantumkan instance dalam project dan lokasi tertentu. |
|
UpdateInstance memperbarui Instance. |
|
Mereset instance notebook. |
|
Ubah ukuran disk instance notebook ke kapasitas yang lebih tinggi. |
|
RestoreInstance memulihkan Instance dari BackupSource. |
|
Melakukan roll back instance notebook ke versi sebelumnya. |
|
Menetapkan kebijakan kontrol akses pada resource yang ditentukan. |
|
Memulai instance notebook. |
|
Menghentikan instance notebook. |
|
Menampilkan izin yang dimiliki pemanggil pada resource tertentu. |
|
Mengupgrade instance notebook ke versi terbaru. |