リソース: インスタンス
ノートブック インスタンスの定義。
| JSON 表現 |
|---|
{ "name": string, "postStartupScript": string, "proxyUri": string, "instanceOwners": [ string ], "serviceAccount": string, "serviceAccountScopes": [ string ], "machineType": string, "acceleratorConfig": { object ( |
| フィールド | |
|---|---|
name |
出力専用。このノートブック インスタンスの名前。形式: |
postStartupScript |
ノートブック インスタンスが完全に起動した後に自動的に実行される Bash スクリプトのパス。パスは、URL または Cloud Storage パス( |
proxyUri |
出力専用。Jupyter ノートブックへのアクセスに使用されるプロキシ エンドポイント。 |
instanceOwners[] |
入力専用。作成後のこのインスタンスのオーナー。形式: 現在、サポートされているオーナーは 1 人のみです。指定しない場合、VM インスタンスのサービス アカウントのすべてのサービス アカウント ユーザーがインスタンスを使用できます。 |
serviceAccount |
このインスタンスのサービス アカウント。他の Google Cloud サービスへのアクセス権が付与されます。同じプロジェクト内ではどのサービス アカウントでも使用できますが、インスタンスを使用するには、サービス アカウント ユーザー権限が必要です。 指定しない場合は、Compute Engine のデフォルト サービス アカウントが使用されます。 |
serviceAccountScopes[] |
省略可。Compute Engine インスタンスに含めるサービス アカウント スコープの URI。 指定しない場合は、次のスコープが定義されます。- https://www.googleapis.com/auth/cloud-platform- https://www.googleapis.com/auth/userinfo.emailデフォルトのスコープを使用しない場合は、少なくとも https://www.googleapis.com/auth/compute が必要です。 |
machineType |
必須。このインスタンスの Compute Engine マシンタイプ。 |
acceleratorConfig |
このインスタンスで使用されるハードウェア アクセラレータ。アクセラレータを使用する場合は、選択した |
state |
出力専用。このインスタンスの状態。 |
installGpuDriver |
エンドユーザーが Google Cloud にこのインスタンスへの GPU ドライバのインストールを承認するかどうか。このフィールドが空の場合、または false に設定されている場合、GPU ドライバはインストールされません。GPU を使用するインスタンスにのみ適用されます。 |
customGpuDriverPath |
GPU ドライバが保存されているカスタム Cloud Storage パスを指定します。指定しない場合、公式の GPU ドライバから自動的に選択されます。 |
bootDiskType |
入力専用。このインスタンスにアタッチされているブートディスクのタイプ。デフォルトは標準永続ディスク( |
bootDiskSizeGb |
入力専用。このインスタンスにアタッチされているブートディスクのサイズ(GB)。最大 64, 000 GB(64 TB)。推奨される最小値は 100 GB です。指定しない場合、デフォルトは 100 です。 |
dataDiskType |
入力専用。このインスタンスにアタッチされているデータディスクのタイプ。デフォルトは標準永続ディスク( |
dataDiskSizeGb |
入力専用。このインスタンスにアタッチされているデータディスクのサイズ(GB 単位)。最大 64, 000 GB(64 TB)。ノートブックとデータのサイズに基づいて、データディスクのサイズを選択できます。指定しない場合、デフォルトは 100 です。 |
noRemoveDataDisk |
入力専用。true の場合、インスタンスを削除してもデータディスクは自動的に削除されません。 |
diskEncryption |
入力専用。ブートディスクとデータディスクで使用されるディスク暗号化方式。デフォルトは GMEK です。 |
kmsKey |
入力専用。ディスクの暗号化に使用される KMS 鍵。diskEncryption が CMEK の場合にのみ適用されます。形式: 詳細については、独自の暗号鍵の使用をご覧ください。 |
disks[] |
出力専用。ノートブック インスタンスにアタッチされたディスク。 |
shieldedInstanceConfig |
省略可。Shielded VM の構成。サポートされている Shielded VM 機能を使用するイメージ。 |
noPublicIp |
true の場合、このインスタンスに外部 IP は割り当てられません。 |
noProxyAccess |
true の場合、ノートブック インスタンスはプロキシに登録されません。 |
network |
このインスタンスが存在する VPC の名前。形式: |
subnet |
このインスタンスが存在するサブネットの名前。形式: |
labels |
このインスタンスに適用するラベル。これらは、setLabels メソッドで後から変更できます。
|
metadata |
このインスタンスに適用するカスタム メタデータ。たとえば、自動バックアップ用の Cloud Storage バケットを指定するには、
|
tags[] |
省略可。ランタイムに追加する Compute Engine ネットワーク タグ(ネットワーク タグを追加するをご覧ください)。 |
upgradeHistory[] |
このインスタンスのアップグレード履歴。 |
nicType |
省略可。このインターフェースで使用する vNIC のタイプ。gVNIC または VirtioNet のいずれかになります。 |
reservationAffinity |
省略可。省略可能な予約アフィニティ。このフィールドを設定すると、指定されたゾーン コンピューティング予約がこのノートブック インスタンスに適用されます。 |
creator |
出力専用。元の instances.create リクエストを送信したエンティティのメールアドレス。 |
canIpForward |
省略可。IP 転送を有効にするかどうかを示すフラグ。デフォルトは false(オフ)です。https://cloud.google.com/vpc/docs/using-routes#canipforward |
createTime |
出力専用。インスタンスの作成時間。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
updateTime |
出力専用。インスタンスの更新時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
instanceMigrationEligibility |
出力専用。UmN から WbI への移行の実現可能性を確認します。 |
| 環境のタイプ。VM イメージまたはコンテナ イメージのいずれかになります。以下は、相互に排他的なフィールドのリストです。レスポンスに設定されるフィールドは、最大 1 つです。 | |
vmImage |
Compute Engine VM イメージを使用してノートブック インスタンスを起動します。 |
containerImage |
コンテナ イメージを使用してノートブック インスタンスを起動します。 |
| 相互に排他的なフィールドの終わり。 | |
migrated |
出力専用。このノートブックが Workbench インスタンスに移行されたかどうかを示すブール値 |
AcceleratorConfig
ハードウェア アクセラレータの定義。type と coreCount のすべての組み合わせが有効であるわけではありません。有効な組み合わせについては、Compute Engine の GPU をご覧ください。TPU はサポートされていません。
| JSON 表現 |
|---|
{
"type": enum ( |
| フィールド | |
|---|---|
type |
このアクセラレータのタイプ。 |
coreCount |
このアクセラレータのコア数。 |
AcceleratorType
このインスタンスで使用できるハードウェア アクセラレータのタイプの定義。
| 列挙型 | |
|---|---|
ACCELERATOR_TYPE_UNSPECIFIED |
アクセラレータ タイプが指定されていません。 |
NVIDIA_TESLA_K80 |
アクセラレータ タイプは Nvidia Tesla K80 です。 |
NVIDIA_TESLA_P100 |
アクセラレータ タイプは Nvidia Tesla P100 です。 |
NVIDIA_TESLA_V100 |
アクセラレータのタイプは Nvidia Tesla V100 です。 |
NVIDIA_TESLA_P4 |
アクセラレータ タイプは Nvidia Tesla P4 です。 |
NVIDIA_TESLA_T4 |
アクセラレータ タイプは Nvidia Tesla T4 です。 |
NVIDIA_TESLA_A100 |
アクセラレータ タイプは Nvidia Tesla A100 です。 |
NVIDIA_L4 |
アクセラレータ タイプは Nvidia Tesla L4 です。 |
NVIDIA_A100_80GB |
アクセラレータ タイプは Nvidia Tesla A100 80 GB です。 |
NVIDIA_TESLA_T4_VWS |
アクセラレータ タイプは NVIDIA Tesla T4 仮想ワークステーションです。 |
NVIDIA_TESLA_P100_VWS |
アクセラレータ タイプは NVIDIA Tesla P100 仮想ワークステーションです。 |
NVIDIA_TESLA_P4_VWS |
アクセラレータ タイプは NVIDIA Tesla P4 仮想ワークステーションです。 |
NVIDIA_H100_80GB |
アクセラレータ タイプは NVIDIA H100 80 GB です。 |
NVIDIA_H100_MEGA_80GB |
アクセラレータ タイプは NVIDIA H100 Mega 80 GB です。 |
TPU_V2 |
(近日公開)アクセラレータ タイプは TPU V2 です。 |
TPU_V3 |
(近日公開)アクセラレータ タイプは TPU V3 です。 |
状態
このインスタンスの状態の定義。
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
状態が指定されていません。 |
STARTING |
制御ロジックがインスタンスを起動しています。 |
PROVISIONING |
制御ロジックは、必要なフレームワークをインストールし、インスタンスをノートブック プロキシに登録します。 |
ACTIVE |
インスタンスは実行中です。 |
STOPPING |
制御ロジックがインスタンスを停止しています。 |
STOPPED |
インスタンスは停止しています。 |
DELETED |
インスタンスが削除された場合。 |
UPGRADING |
インスタンスがアップグレード中です。 |
INITIALIZING |
インスタンスを作成しています。 |
REGISTERING |
インスタンスが登録されています。 |
SUSPENDING |
インスタンスは一時停止中です。 |
SUSPENDED |
インスタンスは一時停止されています。 |
DiskType
ノートブック インスタンスで使用できるディスクタイプ。
| 列挙型 | |
|---|---|
DISK_TYPE_UNSPECIFIED |
ディスクタイプが設定されていません。 |
PD_STANDARD |
標準永続ディスクタイプ。 |
PD_SSD |
SSD 永続ディスクのタイプ。 |
PD_BALANCED |
バランス永続ディスクタイプ。 |
PD_EXTREME |
エクストリーム永続ディスクタイプ。 |
DiskEncryption
ディスク暗号化オプションの定義。
| 列挙型 | |
|---|---|
DISK_ENCRYPTION_UNSPECIFIED |
ディスク暗号化が指定されていません。 |
GMEK |
Google が管理する暗号鍵を使用してブートディスクを暗号化します。 |
CMEK |
顧客管理の暗号鍵を使用してブートディスクを暗号化します。 |
ディスク
インスタンスにアタッチされたディスク リソース。
| JSON 表現 |
|---|
{
"autoDelete": boolean,
"boot": boolean,
"deviceName": string,
"diskSizeGb": string,
"guestOsFeatures": [
{
object ( |
| フィールド | |
|---|---|
autoDelete |
インスタンスが削除されたときにディスクが自動的に削除されるかどうかを示します(ディスクがインスタンスから切り離されたときは削除されません)。 |
boot |
これがブートディスクであることを示します。仮想マシンは、ディスクの最初のパーティションをルート ファイルシステムに使用します。 |
deviceName |
インスタンス内で実行されている Linux オペレーティング システムの 指定しない場合、サーバーはこのディスクに適用するデフォルトのデバイス名を選択します。このデバイス名の形式は persistent-disk-x であり、x は Google Compute Engine により割り当てられた番号です。このフィールドは Persistent Disk にのみ適用されます。 |
diskSizeGb |
ディスクのサイズを 2 進数の GB 単位で示します。 |
guestOsFeatures[] |
ゲスト オペレーティング システムで有効にする機能のリストを示します。ブート可能なイメージにのみ適用されます。使用可能なオプションの一覧については、ゲスト オペレーティング システムの機能を有効にするをご覧ください。 |
index |
このディスクの 0 から始まるインデックス。0 はブートディスク用に予約されています。インスタンスに複数のディスクがアタッチされている場合、各ディスクには一意のインデックス番号が割り当てられます。 |
interface |
このディスクのアタッチに使用するディスク インターフェース(SCSI または NVME)を示します。デフォルトは SCSI です。永続ディスクは常に SCSI を使用する必要があります。SCSI 以外の形式で永続ディスクをアタッチしようとすると、リクエストは失敗します。ローカル SSD は NVMe または SCSI のいずれかを使用できます。NVMe 経由の SCSI のパフォーマンス特性については、ローカル SSD のパフォーマンスをご覧ください。有効な値:
|
kind |
リソースのタイプ。アタッチされたディスクの compute#attachedDisk を常に計算します。 |
licenses[] |
一般公開されているライセンスのリスト。Google で使用するために予約されています。ライセンスは、パブリック イメージと Marketplace イメージの課金データと使用状況の集計データを表します。 |
mode |
このディスクをアタッチするモード(
|
source |
既存の Persistent Disk リソースへの有効な部分 URL または完全 URL を示します。 |
type |
ディスクのタイプ(
|
GuestOsFeature
ブートディスクのゲスト OS の機能。
| JSON 表現 |
|---|
{ "type": string } |
| フィールド | |
|---|---|
type |
サポートされている機能の ID。使用可能なオプションの一覧については、ゲスト オペレーティング システムの機能を有効にするをご覧ください。有効な値:
|
ShieldedInstanceConfig
一連のシールド インスタンス オプション。サポートされている Shielded VM 機能を使用するイメージをご覧ください。すべての組み合わせが有効なわけではありません。
| JSON 表現 |
|---|
{ "enableSecureBoot": boolean, "enableVtpm": boolean, "enableIntegrityMonitoring": boolean } |
| フィールド | |
|---|---|
enableSecureBoot |
インスタンスでセキュアブートを有効にするかどうかを定義します。 セキュアブートは、すべてのブート コンポーネントのデジタル署名を検証し、署名検証が失敗した場合にブートプロセスを停止することで、システムで正規のソフトウェアのみが実行されるようにします。デフォルトでは無効にされています。 |
enableVtpm |
インスタンスで vTPM が有効になっているかどうかを定義します。デフォルトで有効になっています。 |
enableIntegrityMonitoring |
インスタンスで整合性モニタリングを有効にするかどうかを定義します。 インスタンスの起動時の整合性のモニタリングと証明書取得を有効にします。構成証明は、整合性ポリシー ベースラインに対して実行されます。このベースラインは、インスタンスの作成時に、暗黙的に信頼されているブートイメージから派生します。デフォルトで有効になっています。 |
UpgradeHistoryEntry
VM イメージのアップグレード履歴のエントリ。
| JSON 表現 |
|---|
{ "snapshot": string, "vmImage": string, "containerImage": string, "framework": string, "version": string, "state": enum ( |
| フィールド | |
|---|---|
snapshot |
アップグレード前のこのノートブック インスタンスのブートディスクのスナップショット。 |
vmImage |
このインスタンスのアップグレード前の VM イメージ。 |
containerImage |
このインスタンスのアップグレード前のコンテナ イメージ。 |
framework |
このノートブック インスタンスのフレームワーク。 |
version |
このアップグレード前のノートブック インスタンスのバージョン。 |
state |
このインスタンス アップグレード履歴エントリの状態。 |
createTime |
このインスタンス アップグレード履歴エントリが作成された時刻。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
targetImage |
ターゲット VM イメージ。形式: |
action |
アクション:ロールバックまたはアップグレード。 |
targetVersion |
ターゲット VM バージョン(m63 など)。 |
状態
このアップグレード履歴エントリの状態の定義。
| 列挙型 | |
|---|---|
STATE_UNSPECIFIED |
状態が指定されていません。 |
STARTED |
インスタンスのアップグレードが開始されます。 |
SUCCEEDED |
インスタンスのアップグレードが成功しました。 |
FAILED |
インスタンスのアップグレードが失敗しました。 |
アクション
このアップグレード履歴エントリのオペレーションの定義。
| 列挙型 | |
|---|---|
ACTION_UNSPECIFIED |
オペレーションが指定されていません。 |
UPGRADE |
アップグレードしてください。 |
ROLLBACK |
Rollback のインスタンスを発生させることができます。 |
NicType
vNIC ドライバのタイプ。デフォルトは UNSPECIFIED_NIC_TYPE にする必要があります。
| 列挙型 | |
|---|---|
UNSPECIFIED_NIC_TYPE |
タイプが指定されていません。 |
VIRTIO_NET |
Virtio |
GVNIC |
GVNIC |
ReservationAffinity
ゾーン予約を使用するための予約アフィニティ。
| JSON 表現 |
|---|
{
"consumeReservationType": enum ( |
| フィールド | |
|---|---|
consumeReservationType |
省略可。使用する予約のタイプ |
key |
省略可。予約リソースのラベルキーに対応します。 |
values[] |
省略可。予約リソースのラベル値に対応します。 |
タイプ
予約から容量を消費するかどうかを示します。
| 列挙型 | |
|---|---|
TYPE_UNSPECIFIED |
デフォルトのタイプ。 |
NO_RESERVATION |
割り当てられた容量を使用しない。 |
ANY_RESERVATION |
利用可能な予約を使用します。 |
SPECIFIC_RESERVATION |
特定の予約から使用する必要があります。予約を指定するためのキー値フィールドを指定する必要があります。 |
InstanceMigrationEligibility
InstanceMigrationEligibility は、UmN から WbI への移行の実現可能性に関する情報を表します。
| JSON 表現 |
|---|
{ "warnings": [ enum ( |
| フィールド | |
|---|---|
warnings[] |
出力専用。移行時に、特定の構成はデフォルト設定になります。 |
errors[] |
出力専用。特定の構成では、UmN は自動移行の対象外になります。手動移行が必要です。 |
警告
移行警告メッセージは、移行中に特定の構成がデフォルト設定になることを意味します。
| 列挙型 | |
|---|---|
WARNING_UNSPECIFIED |
デフォルトのタイプ。 |
UNSUPPORTED_MACHINE_TYPE |
UmN で、WbI でサポートされていないマシンタイプが使用されています。デフォルトのマシンタイプ e2-standard-4 で移行されます。移行後にマシンタイプを変更できます。 |
UNSUPPORTED_ACCELERATOR_TYPE |
UmN で、WbI でサポートされていないアクセラレータ タイプが使用されています。アクセラレータなしで移行されます。アクセラレータは移行後に接続できます。 |
UNSUPPORTED_OS |
UmN が WbI でサポートされていないオペレーティング システム(Debian 10、Ubuntu など)を使用している。WbI では Debian 11 に置き換えられます。 |
NO_REMOVE_DATA_DISK |
この UmN は noRemoveDataDisk で構成されていますが、これは WbI では使用できなくなりました。 |
GCS_BACKUP |
この UmN は、WbI で利用できなくなった Cloud Storage のバックアップ機能で構成されています。 |
POST_STARTUP_SCRIPT |
この UmN は、起動スクリプトで構成されています。必要に応じて、移行の postStartupScriptOption を指定してください。 |
エラー
移行エラー メッセージは、特定の構成により UmN が自動移行の対象外になっていることを意味します。手動移行が必要です。
| 列挙型 | |
|---|---|
ERROR_UNSPECIFIED |
デフォルトのタイプ。 |
DATAPROC_HUB |
UmN は Dataproc Hub を使用しており、移行できません。 |
メソッド |
|
|---|---|
|
指定されたプロジェクトとロケーションで新しいインスタンスを作成します。 |
|
1 つのインスタンスを削除します。 |
|
インスタンスを指定して診断ファイルを作成し、診断ツールを実行します。 |
|
1 つのインスタンスの詳細を取得します。 |
|
リソースのアクセス制御ポリシーを取得します。 |
|
ノートブック インスタンスが正常かどうかを確認します。 |
|
ノートブック インスタンスをアップグレードできるかどうかを確認します。 |
|
指定されたプロジェクトとロケーションのインスタンスを一覧表示します。 |
|
既存のユーザー管理ノートブックを Workbench インスタンスに移行します。 |
|
既存の以前のノートブック インスタンスを Notebooks API サーバーに登録します。 |
|
ノートブック インスタンスが最新のインスタンス情報を Notebooks API サーバーに報告できるようにします。 |
|
ノートブック インスタンスをリセットします。 |
|
ノートブック インスタンスを以前のバージョンにロールバックします。 |
|
単一インスタンスのゲスト アクセラレータを更新します。 |
|
指定したリソースにアクセス制御ポリシーを設定します。 |
|
インスタンスのすべてのラベルを置き換えます。 |
|
単一インスタンスのマシンタイプを更新します。 |
|
ノートブック インスタンスを起動します。 |
|
ノートブック インスタンスを停止します。 |
|
指定したリソースに対して呼び出し元が持っている権限を返します。 |
|
ノートブック インスタンスの構成を更新します。 |
|
インスタンスのメタデータ項目を追加または更新します。 |
|
単一インスタンスのシールドされたインスタンス構成を更新します。 |
|
ノートブック インスタンスを最新バージョンにアップグレードします。 |