REST Resource: projects.locations.instances

Ressource: Instanz

Die Definition einer Notebook-Instanz.

JSON-Darstellung 
{
  "name": string,
  "postStartupScript": string,
  "proxyUri": string,
  "instanceOwners": [
    string
  ],
  "serviceAccount": string,
  "serviceAccountScopes": [
    string
  ],
  "machineType": string,
  "acceleratorConfig": {
    object (AcceleratorConfig)
  },
  "state": enum (State),
  "installGpuDriver": boolean,
  "customGpuDriverPath": string,
  "bootDiskType": enum (DiskType),
  "bootDiskSizeGb": string,
  "dataDiskType": enum (DiskType),
  "dataDiskSizeGb": string,
  "noRemoveDataDisk": boolean,
  "diskEncryption": enum (DiskEncryption),
  "kmsKey": string,
  "disks": [
    {
      object (Disk)
    }
  ],
  "shieldedInstanceConfig": {
    object (ShieldedInstanceConfig)
  },
  "noPublicIp": boolean,
  "noProxyAccess": boolean,
  "network": string,
  "subnet": string,
  "labels": {
    string: string,
    ...
  },
  "metadata": {
    string: string,
    ...
  },
  "tags": [
    string
  ],
  "upgradeHistory": [
    {
      object (UpgradeHistoryEntry)
    }
  ],
  "nicType": enum (NicType),
  "reservationAffinity": {
    object (ReservationAffinity)
  },
  "creator": string,
  "canIpForward": boolean,
  "createTime": string,
  "updateTime": string,
  "instanceMigrationEligibility": {
    object (InstanceMigrationEligibility)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "vmImage": {
    object (VmImage)
  },
  "containerImage": {
    object (ContainerImage)
  }
  // End of mutually exclusive fields.
  "migrated": boolean
}
Felder
name

string

Nur Ausgabe. Der Name dieser Notebook-Instanz. Format: projects/{projectId}/locations/{location}/instances/{instanceId}
postStartupScript

string

Pfad zu einem Bash-Script, das nach dem vollständigen Booten einer Notebook-Instanz automatisch ausgeführt wird. Der Pfad muss eine URL oder ein Cloud Storage-Pfad (gs://path-to-file/file-name) sein.
proxyUri

string

Nur Ausgabe. Der Proxy-Endpunkt, der für den Zugriff auf das Jupyter-Notebook verwendet wird.
instanceOwners[]

string

Nur Eingabe. Der Eigentümer dieser Instanz nach der Erstellung. Format: alias@example.com

Derzeit wird nur ein Inhaber unterstützt. Wenn nicht angegeben, können alle Dienstkontonutzer des Dienstkontos Ihrer VM-Instanz die Instanz verwenden.
serviceAccount

string

Das Dienstkonto auf dieser Instanz, das Zugriff auf andere Google Cloud-Dienste bietet. Sie können jedes Dienstkonto innerhalb desselben Projekts verwenden, allerdings benötigen Sie die Berechtigung als Dienstkontonutzer, um die Instanz verwenden zu können.

Wenn nicht angegeben, wird das Compute Engine-Standarddienstkonto verwendet.
serviceAccountScopes[]

string

Optional. Die URIs der Dienstkontobereiche, die in Compute Engine-Instanzen enthalten sein sollen.

Wenn keine Angabe erfolgt, werden die folgenden Bereiche definiert: – https://www.googleapis.com/auth/cloud-platform – https://www.googleapis.com/auth/userinfo.email Wenn Sie keine Standardbereiche verwenden, benötigen Sie mindestens: https://www.googleapis.com/auth/compute
machineType

string

Erforderlich. Der Compute Engine-Maschinentyp dieser Instanz.
acceleratorConfig

object (AcceleratorConfig)

Der auf dieser Instanz verwendete Hardwarebeschleuniger. Wenn Sie Beschleuniger verwenden, muss Ihre Konfiguration genügend vCPUs und Arbeitsspeicher für die ausgewählte machineType haben.
state

enum (State)

Nur Ausgabe. Der Status dieser Instanz.
installGpuDriver

boolean

Gibt an, ob der Endnutzer Google Cloud autorisiert, einen GPU-Treiber auf dieser Instanz zu installieren. Wenn dieses Feld leer ist oder auf „false“ gesetzt ist, wird der GPU-Treiber nicht installiert. Gilt nur für Instanzen mit GPUs.
customGpuDriverPath

string

Geben Sie einen benutzerdefinierten Cloud Storage-Pfad an, in dem der GPU-Treiber gespeichert ist. Wenn nichts angegeben ist, wählen wir automatisch aus offiziellen GPU-Treibern aus.
bootDiskType

enum (DiskType)

Nur Eingabe. Der Typ des Bootlaufwerks, das an diese Instanz angehängt ist. Der Standardwert ist ein nichtflüchtiger Standardspeicher (PD_STANDARD).
bootDiskSizeGb

string (int64 format)

Nur Eingabe. Die Größe des Bootlaufwerks in GB, das an diese Instanz angehängt ist, bis zu einem Maximum von 64.000 GB (64 TB). Der empfohlene Mindestwert beträgt 100 GB. Wenn keine Angabe erfolgt, wird standardmäßig 100 verwendet.
dataDiskType

enum (DiskType)

Nur Eingabe. Der Typ des an diese Instanz angehängten Datenlaufwerks. Der Standardwert ist ein nichtflüchtiger Standardspeicher (PD_STANDARD).
dataDiskSizeGb

string (int64 format)

Nur Eingabe. Die Größe des Datenlaufwerks in GB, das an diese Instanz angehängt ist, bis zu einem Maximum von 64.000 GB (64 TB). Sie können die Größe des Datenträgers basierend auf der Größe Ihrer Notebooks und Daten auswählen. Wenn keine Angabe erfolgt, wird standardmäßig 100 verwendet.
noRemoveDataDisk

boolean

Nur Eingabe. Wenn „true“, wird das Datenlaufwerk beim Löschen der Instanz nicht automatisch gelöscht.
diskEncryption

enum (DiskEncryption)

Nur Eingabe. Die auf den Boot- und Datenlaufwerken verwendete Laufwerkverschlüsselungsmethode. Der Standardwert ist GMEK.
kmsKey

string

Nur Eingabe. Der KMS-Schlüssel, der zum Verschlüsseln der Laufwerke verwendet wird. Gilt nur, wenn „diskEncryption“ CMEK ist. Format: projects/{projectId}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id}

Weitere Informationen zum Verwenden eigener Verschlüsselungsschlüssel
disks[]

object (Disk)

Nur Ausgabe. Der Notebook-Instanz angehängte Laufwerke.
shieldedInstanceConfig

object (ShieldedInstanceConfig)

Optional. Shielded VM-Konfiguration. Images, die unterstützte Shielded VM-Funktionen verwenden.
noPublicIp

boolean

Wenn „true“, wird dieser Instanz keine externe IP-Adresse zugewiesen.
noProxyAccess

boolean

Wenn „true“, wird die Notebook-Instanz nicht beim Proxy registriert.
network

string

Der Name der VPC, in der sich diese Instanz befindet. Format: projects/{projectId}/global/networks/{network_id}
subnet

string

Der Name des Subnetzes, in dem sich diese Instanz befindet. Format: projects/{projectId}/regions/{region}/subnetworks/{subnetwork_id}
labels

map (key: string, value: string)

Labels, die auf diese Instanz angewendet werden sollen. Diese können später mit der Methode „setLabels“ geändert werden.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
metadata

map (key: string, value: string)

Benutzerdefinierte Metadaten, die auf diese Instanz angewendet werden sollen. Wenn Sie beispielsweise einen Cloud Storage-Bucket für die automatische Sicherung angeben möchten, können Sie das Metadaten-Tag gcs-data-bucket verwenden. Format: "--metadata=gcs-data-bucket=BUCKET".

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
tags[]

string

Optional. Die Compute Engine-Netzwerk-Tags, die der Laufzeit hinzugefügt werden sollen (siehe Netzwerk-Tags hinzufügen).
upgradeHistory[]

object (UpgradeHistoryEntry)

Der Upgradeverlauf dieser Instanz.
nicType

enum (NicType)

Optional. Der Typ der vNIC, die auf dieser Schnittstelle verwendet werden soll. Das kann gVNIC oder VirtioNet sein.
reservationAffinity

object (ReservationAffinity)

Optional. Die optionale Reservierungsaffinität. Wenn Sie dieses Feld festlegen, wird die angegebene zonale Compute-Reservierung auf diese Notebook-Instanz angewendet.
creator

string

Nur Ausgabe. E‑Mail-Adresse der Organisation, die die ursprüngliche Anfrage „instances.create“ gesendet hat.
canIpForward

boolean

Optional. Flag zum Aktivieren oder Deaktivieren der IP-Weiterleitung. Standardmäßig ist „false“/„off“ festgelegt. https://cloud.google.com/vpc/docs/using-routes#canipforward
createTime

string (Timestamp format)

Nur Ausgabe. Erstellungszeitpunkt der Instanz.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Uhrzeit der Instanzaktualisierung.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
instanceMigrationEligibility

object (InstanceMigrationEligibility)

Nur Ausgabe. Prüft, wie machbar eine Migration von UmN zu WbI ist.
Typ der Umgebung; kann „VM-Image“ oder „Container-Image“ sein. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
vmImage

object (VmImage)

Verwenden Sie ein Compute Engine-VM-Image, um die Notebook-Instanz zu starten.
containerImage

object (ContainerImage)

Verwenden Sie ein Container-Image, um die Notebook-Instanz zu starten.
Ende der sich gegenseitig ausschließenden Felder.
migrated

boolean

Nur Ausgabe. Boolescher Wert, der angibt, ob dieses Notebook zu einer Workbench-Instanz migriert wurde

AcceleratorConfig

Definition eines Hardwarebeschleunigers. Hinweis: Nicht alle Kombinationen von type und coreCount sind gültig. Eine gültige Kombination finden Sie unter GPUs in Compute Engine. TPUs werden nicht unterstützt.

JSON-Darstellung 
{
  "type": enum (AcceleratorType),
  "coreCount": string
}
Felder
type

enum (AcceleratorType)

Typ dieses Beschleunigers.
coreCount

string (int64 format)

Anzahl der Kerne dieses Beschleunigers.

AcceleratorType

Definition der Arten von Hardwarebeschleunigern, die auf dieser Instanz verwendet werden können.

Enums
ACCELERATOR_TYPE_UNSPECIFIED Der Beschleunigertyp ist nicht angegeben.
NVIDIA_TESLA_K80 Der Beschleunigertyp ist Nvidia Tesla K80.
NVIDIA_TESLA_P100 Der Beschleunigertyp ist Nvidia Tesla P100.
NVIDIA_TESLA_V100 Der Beschleunigertyp ist Nvidia Tesla V100.
NVIDIA_TESLA_P4 Der Beschleunigertyp ist Nvidia Tesla P4.
NVIDIA_TESLA_T4 Der Beschleunigertyp ist Nvidia Tesla T4.
NVIDIA_TESLA_A100 Der Beschleunigertyp ist Nvidia Tesla A100.
NVIDIA_L4 Der Beschleunigertyp ist Nvidia Tesla L4.
NVIDIA_A100_80GB Der Beschleunigertyp ist Nvidia Tesla A100 80 GB.
NVIDIA_TESLA_T4_VWS Der Beschleunigertyp ist NVIDIA Tesla T4 Virtual Workstations.
NVIDIA_TESLA_P100_VWS Der Beschleunigertyp ist NVIDIA Tesla P100 Virtual Workstations.
NVIDIA_TESLA_P4_VWS Der Beschleunigertyp ist NVIDIA Tesla P4 Virtual Workstations.
NVIDIA_H100_80GB Der Beschleunigertyp ist NVIDIA H100 mit 80 GB.
NVIDIA_H100_MEGA_80GB Der Beschleunigertyp ist NVIDIA H100 Mega mit 80 GB.
TPU_V2 (Demnächst verfügbar) Der Beschleunigertyp ist TPU V2.
TPU_V3 (Demnächst verfügbar) Der Beschleunigertyp ist TPU V3.

Bundesland

Die Definition der Zustände dieser Instanz.

Enums
STATE_UNSPECIFIED Der Status ist nicht angegeben.
STARTING Die Steuerungslogik startet die Instanz.
PROVISIONING Die Steuerungslogik installiert die erforderlichen Frameworks und registriert die Instanz beim Notebook-Proxy.
ACTIVE Die Instanz wird ausgeführt.
STOPPING Die Steuerungslogik beendet die Instanz.
STOPPED Die Instanz wurde angehalten.
DELETED Die Instanz wird gelöscht.
UPGRADING Die Instanz wird aktualisiert.
INITIALIZING Die Instanz wird gerade erstellt.
REGISTERING Die Instanz wird registriert.
SUSPENDING Die Instanz wird angehalten.
SUSPENDED Die Instanz wurde gesperrt.

DiskType

Mögliche Laufwerkstypen für Notebook-Instanzen.

Enums
DISK_TYPE_UNSPECIFIED Der Laufwerkstyp wurde nicht festgelegt.
PD_STANDARD Nichtflüchtiger Standardspeicher
PD_SSD Typ des nichtflüchtiger SSD-Speicher.
PD_BALANCED Typ des abgestimmten nichtflüchtigen Speichers.
PD_EXTREME Typ des extrem nichtflüchtigen Speichers.

DiskEncryption

Definition der Optionen für die Laufwerkverschlüsselung.

Enums
DISK_ENCRYPTION_UNSPECIFIED Die Laufwerksverschlüsselung ist nicht angegeben.
GMEK Verwenden Sie von Google verwaltete Verschlüsselungsschlüssel, um das Bootlaufwerk zu verschlüsseln.
CMEK Verwenden Sie vom Kunden verwaltete Verschlüsselungsschlüssel, um das Bootlaufwerk zu verschlüsseln.

Laufwerk

Eine an eine Instanz angehängte Laufwerksressource.

JSON-Darstellung 
{
  "autoDelete": boolean,
  "boot": boolean,
  "deviceName": string,
  "diskSizeGb": string,
  "guestOsFeatures": [
    {
      object (GuestOsFeature)
    }
  ],
  "index": string,
  "interface": string,
  "kind": string,
  "licenses": [
    string
  ],
  "mode": string,
  "source": string,
  "type": string
}
Felder
autoDelete

boolean

Gibt an, ob das Laufwerk automatisch gelöscht wird, wenn die Instanz gelöscht wird (nicht jedoch, wenn das Laufwerk von der Instanz getrennt wird).
boot

boolean

Gibt an, dass es sich um ein Bootlaufwerk handelt. Die VM verwendet die erste Partition der Festplatte für ihr Stammdateisystem.
deviceName

string

Gibt einen eindeutigen Gerätenamen Ihrer Wahl an, der im /dev/disk/by-id/google-*-Baum eines Linux-Betriebssystems in der Instanz angezeigt wird. Mit diesem Namen kann das Gerät z. B. aus der Instanz heraus bereitgestellt oder in der Größe angepasst werden.

Wenn nicht angegeben, wählt der Server einen Standardgerätenamen aus, der auf dieses Laufwerk angewendet werden soll. Er hat das Format „persistent-disk-x“, wobei „x“ eine Nummer ist, die von Google Compute Engine zugewiesen wird. Dieses Feld gilt nur für nichtflüchtige Speicher.
diskSizeGb

string (int64 format)

Gibt die Größe des Laufwerks in GB (Basis 2) an.
guestOsFeatures[]

object (GuestOsFeature)

Gibt eine Liste der Funktionen an, die im Gastbetriebssystem aktiviert werden sollen. Gilt nur für bootfähige Images. Eine Liste der verfügbaren Optionen finden Sie unter Gastbetriebssystem-Funktionen aktivieren.
index

string (int64 format)

Ein nullbasierter Index für dieses Laufwerk, wobei 0 für das Bootlaufwerk reserviert ist. Wenn viele Laufwerke an eine Instanz angehängt sind, hat jedes Laufwerk eine eindeutige Indexnummer.
interface

string

Gibt die Laufwerkschnittstelle an, die zum Anhängen dieses Laufwerks verwendet werden soll. Dies kann entweder SCSI oder NVME sein. Der Standardwert ist SCSI. Für nichtflüchtige Speicher muss immer SCSI verwendet werden. Der Vorgang schlägt fehl, wenn Sie versuchen, einen nichtflüchtigen Speicher in einem anderen Format als SCSI anzuhängen. Lokale SSDs können entweder NVME oder SCSI verwenden. Informationen zu den Leistungsmerkmalen von SCSI über NVMe finden Sie unter Leistung lokaler SSDs. Zulässige Werte:

  • NVME
  • SCSI
kind

string

Typ der Ressource. Berechnen Sie immer „compute#attachedDisk“ für angehängte Laufwerke.
licenses[]

string

Eine Liste öffentlich sichtbarer Lizenzen. Für die Nutzung durch Google reserviert. Eine Lizenz umfasst Abrechnungs- und aggregierte Nutzungsdaten für öffentliche und Marketplace-Bilder.
mode

string

Der Modus, in dem dieses Laufwerk angehängt werden soll, entweder READ_WRITE oder READ_ONLY. Wenn nichts angegeben ist, wird das Laufwerk standardmäßig im Modus READ_WRITE angehängt. Zulässige Werte:

  • READ_ONLY
  • READ_WRITE
source

string

Gibt eine gültige Teil- oder vollständige URL zu einer vorhandenen Persistent Disk-Ressource an.
type

string

Gibt den Typ der Festplatte an, entweder SCRATCH oder PERSISTENT. Zulässige Werte:

  • PERSISTENT
  • SCRATCH

GuestOsFeature

Gastbetriebssystem-Features für das Bootlaufwerk.

JSON-Darstellung 
{
  "type": string
}
Felder
type

string

Die ID einer unterstützten Funktion. Eine Liste der verfügbaren Optionen finden Sie unter Gastbetriebssystem-Funktionen aktivieren. Zulässige Werte:

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

ShieldedInstanceConfig

Eine Reihe von Optionen für Shielded Instances. Weitere Informationen finden Sie unter Images mit unterstützten Shielded VM-Funktionen. Nicht alle Kombinationen sind gültig.

JSON-Darstellung 
{
  "enableSecureBoot": boolean,
  "enableVtpm": boolean,
  "enableIntegrityMonitoring": boolean
}
Felder
enableSecureBoot

boolean

Gibt an, ob für die Instanz Secure Boot aktiviert ist.

Secure Boot sorgt dafür, dass das System nur authentische Software ausführt. Dazu wird die digitale Signatur aller Bootkomponenten überprüft und der Bootvorgang angehalten, wenn die Signaturüberprüfung fehlschlägt. Standardmäßig deaktiviert.
enableVtpm

boolean

Gibt an, ob vTPM für die Instanz aktiviert ist. Standardmäßig aktiviert.
enableIntegrityMonitoring

boolean

Definiert, ob für die Instanz Integritätsmonitoring aktiviert ist.

Ermöglicht das Monitoring und die Attestierung der Bootintegrität der Instanz. Die Attestierung erfolgt anhand der Referenz der Integritätsrichtlinie. Diese Baseline wird anfangs aus dem implizit vertrauenswürdigen Boot-Image abgeleitet, wenn die Instanz erstellt wird. Standardmäßig aktiviert.

UpgradeHistoryEntry

Der Eintrag des VM-Image-Upgrade-Verlaufs.

JSON-Darstellung 
{
  "snapshot": string,
  "vmImage": string,
  "containerImage": string,
  "framework": string,
  "version": string,
  "state": enum (State),
  "createTime": string,
  "targetImage": string,
  "action": enum (Action),
  "targetVersion": string
}
Felder
snapshot

string

Der Snapshot des Bootlaufwerks dieser Notebook-Instanz vor dem Upgrade.
vmImage

string

Das VM-Image vor diesem Instanz-Upgrade.
containerImage

string

Das Container-Image vor dem Upgrade dieser Instanz.
framework

string

Das Framework dieser Notebook-Instanz.
version

string

Die Version der Notebook-Instanz vor diesem Upgrade.
state

enum (State)

Der Status dieses Eintrags im Upgradeverlauf der Instanz.
createTime

string (Timestamp format)

Der Zeitpunkt, zu dem dieser Eintrag im Upgradeverlauf der Instanz erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
targetImage
(deprecated)

string

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

enum (Action)

Aktion Rollback oder Upgrade
targetVersion

string

Ziel-VM-Version, z. B. „m63“.

Bundesland

Die Definition der Status dieses Upgradeverlaufseintrags.

Enums
STATE_UNSPECIFIED Der Status ist nicht angegeben.
STARTED Das Upgrade der Instanz wurde gestartet.
SUCCEEDED Das Instanzupgrade wurde durchgeführt.
FAILED Das Instanzupgrade ist fehlgeschlagen.

Aktion

Die Definition der Vorgänge dieses Upgradeverlaufseintrags.

Enums
ACTION_UNSPECIFIED Vorgang ist nicht angegeben.
UPGRADE Upgrade durchführen.
ROLLBACK Rollback auslösen.

NicType

Der Typ des vNIC-Treibers. Der Standardwert sollte UNSPECIFIED_NIC_TYPE sein.

Enums
UNSPECIFIED_NIC_TYPE Kein Typ angegeben.
VIRTIO_NET VIRTIO
GVNIC GVNIC

ReservationAffinity

Reservierungsaffinität für die Nutzung einer zonalen Reservierung.

JSON-Darstellung 
{
  "consumeReservationType": enum (Type),
  "key": string,
  "values": [
    string
  ]
}
Felder
consumeReservationType

enum (Type)

Optional. Art der zu nutzenden Reservierung
key

string

Optional. Entspricht dem Labelschlüssel der Reservierungsressource.
values[]

string

Optional. Entspricht den Labelwerten der Reservierungsressource.

Typ

Gibt an, ob Kapazität aus einer Reservierung genutzt werden soll.

Enums
TYPE_UNSPECIFIED Standardtyp.
NO_RESERVATION Keine Nutzung der zugewiesenen Kapazität.
ANY_RESERVATION Jede verfügbare Reservierung nutzen.
SPECIFIC_RESERVATION Muss aus einer bestimmten Reservierung genutzt werden. Sie müssen Schlüsselwertfelder zum Angeben der Reservierungen angeben.

InstanceMigrationEligibility

InstanceMigrationEligibility stellt die Machbarkeitsinformationen für eine Migration von UmN zu WbI dar.

JSON-Darstellung 
{
  "warnings": [
    enum (Warning)
  ],
  "errors": [
    enum (Error)
  ]
}
Felder
warnings[]

enum (Warning)

Nur Ausgabe. Bestimmte Konfigurationen werden während der Migration auf die Standardeinstellungen zurückgesetzt.
errors[]

enum (Error)

Nur Ausgabe. Bei bestimmten Konfigurationen ist eine automatische Migration nicht möglich. Eine manuelle Migration ist erforderlich.

Warnung

Eine Migrationswarnung bedeutet, dass bestimmte Konfigurationen während der Migration auf die Standardeinstellungen zurückgesetzt werden.

Enums
WARNING_UNSPECIFIED Standardtyp.
UNSUPPORTED_MACHINE_TYPE Die UmN verwendet einen Maschinentyp, der in WbI nicht unterstützt wird. Es wird mit dem Standardmaschinentyp „e2-standard-4“ migriert. Nutzer können den Maschinentyp nach der Migration ändern.
UNSUPPORTED_ACCELERATOR_TYPE Das UmN verwendet einen Beschleunigertyp, der in WbI nicht unterstützt wird. Es wird ohne Beschleuniger migriert. Nutzer können einen Beschleuniger nach der Migration anhängen.
UNSUPPORTED_OS Die UmN verwendet ein Betriebssystem, das in WbI nicht unterstützt wird (z.B. Debian 10, Ubuntu). Es wird in WbI durch Debian 11 ersetzt.
NO_REMOVE_DATA_DISK Diese UmN ist mit „noRemoveDataDisk“ konfiguriert, das in WbI nicht mehr verfügbar ist.
GCS_BACKUP Dieses UmN ist mit dem Feature für Cloud Storage-Sicherungen konfiguriert, das in WbI nicht mehr verfügbar ist.
POST_STARTUP_SCRIPT Für diese UmN ist ein Post-Startscript konfiguriert. Geben Sie optional die postStartupScriptOption für die Migration an.

Fehler

Eine Fehlermeldung zur Migration bedeutet, dass bestimmte Konfigurationen dazu führen, dass ein UmN nicht für eine automatische Migration infrage kommt. Eine manuelle Migration ist erforderlich.

Enums
ERROR_UNSPECIFIED Standardtyp.
DATAPROC_HUB Die UmN verwendet Dataproc Hub und kann nicht migriert werden.

Methoden

create

 Erstellt eine neue Instanz in einem angegebenen Projekt und an einem angegebenen Ort.

delete

 Löscht eine einzelne Instanz.

diagnose

 Erstellt eine Diagnosedatei und führt das Diagnosetool für eine Instanz aus.

get

 Ruft Details zu einer einzelnen Instanz ab.

getIamPolicy

 Ruft die Zugriffssteuerungsrichtlinie für eine Ressource ab.

getInstanceHealth

 Prüft, ob eine Notebook-Instanz fehlerfrei ist.

isUpgradeable

 Prüft, ob eine Notebook-Instanz aktualisiert werden kann.

list

 Listet Instanzen in einem bestimmten Projekt und an einem bestimmten Standort auf.

migrate

 Migriert ein vorhandenes nutzerverwaltetes Notebook zu Workbench-Instanzen.

register

 Registriert eine vorhandene Legacy-Notebookinstanz beim Notebooks API-Server.

report

 Ermöglicht es Notebook-Instanzen, ihre neuesten Instanzinformationen an den Notebooks API-Server zu senden.

reset

 Setzt eine Notebook-Instanz zurück.

rollback

 Führt ein Rollback einer Notebook-Instanz auf die vorherige Version durch.

setAccelerator

 Aktualisiert die Gastbeschleuniger einer einzelnen Instanz.

setIamPolicy

 Legt die Zugriffssteuerungsrichtlinie für die angegebene Ressource fest.

setLabels

 Ersetzt alle Labels einer Instanz.

setMachineType

 Aktualisiert den Maschinentyp einer einzelnen Instanz.

start

 Startet eine Notebook-Instanz.

stop

 Beendet eine Notebook-Instanz.

testIamPermissions

 Gibt die Berechtigungen des Aufrufers für die angegebene Ressource zurück.

updateConfig

 Notebook-Instanzkonfigurationen aktualisieren

updateMetadataItems

 Metadatenelemente für eine Instanz hinzufügen oder aktualisieren.

updateShieldedInstanceConfig

 Aktualisiert die Konfiguration der abgeschirmten Instanz einer einzelnen Instanz.

upgrade

 Führt ein Upgrade einer Notebook-Instanz auf die neueste Version durch.