Resource: Instance
The definition of a notebook instance.
JSON representation |
---|
{ "name": string, "postStartupScript": string, "proxyUri": string, "instanceOwners": [ string ], "serviceAccount": string, "machineType": string, "acceleratorConfig": { object ( |
Fields | |
---|---|
name |
Output only. The name of this notebook instance. Format: |
postStartupScript |
Path to a Bash script that automatically runs after a notebook instance fully boots up. The path must be a URL or Cloud Storage path (gs://path-to-file/file-name). |
proxyUri |
Output only. The proxy endpoint that is used to access the Jupyter notebook. |
instanceOwners[] |
Input only. The owner of this instance after creation. Format: Currently supports one owner only. If not specified, all of the service account users of your VM instance's service account can use the instance. |
serviceAccount |
The service account on this instance, giving access to other Google Cloud services. You can use any service account within the same project, but you must have the service account user permission to use the instance. If not specified, the Compute Engine default service account is used. |
machineType |
Required. The Compute Engine machine type of this instance. |
acceleratorConfig |
The hardware accelerator used on this instance. If you use accelerators, make sure that your configuration has enough vCPUs and memory to support the |
state |
Output only. The state of this instance. |
installGpuDriver |
Whether the end user authorizes Google Cloud to install GPU driver on this instance. If this field is empty or set to false, the GPU driver won't be installed. Only applicable to instances with GPUs. |
customGpuDriverPath |
Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers. |
bootDiskType |
Input only. The type of the boot disk attached to this instance, defaults to standard persistent disk ( |
bootDiskSizeGb |
Input only. The size of the boot disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). The minimum recommended value is 100 GB. If not specified, this defaults to 100. |
dataDiskType |
Input only. The type of the data disk attached to this instance, defaults to standard persistent disk ( |
dataDiskSizeGb |
Input only. The size of the data disk in GB attached to this instance, up to a maximum of 64000 GB (64 TB). You can choose the size of the data disk based on how big your notebooks and data are. If not specified, this defaults to 100. |
noRemoveDataDisk |
Input only. If true, the data disk will not be auto deleted when deleting the instance. |
diskEncryption |
Input only. Disk encryption method used on the boot and data disks, defaults to GMEK. |
kmsKey |
Input only. The KMS key used to encrypt the disks, only applicable if diskEncryption is CMEK. Format: Learn more about using your own encryption keys. |
noPublicIp |
If true, no public IP will be assigned to this instance. |
noProxyAccess |
If true, the notebook instance will not register with the proxy. |
network |
The name of the VPC that this instance is in. Format: |
subnet |
The name of the subnet that this instance is in. Format: |
labels |
Labels to apply to this instance. These can be later modified by the setLabels method. An object containing a list of |
metadata |
Custom metadata to apply to this instance. An object containing a list of |
nicType |
Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. |
reservationAffinity |
Optional. The optional reservation affinity. Setting this field will apply the specified Zonal Compute Reservation to this notebook instance. |
canIpForward |
Optional. Flag to enable ip forwarding or not, default false/off. https://cloud.google.com/vpc/docs/using-routes#canipforward |
createTime |
Output only. Instance creation time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Output only. Instance update time. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
Union field environment . Type of the environment; can be one of VM image, or container image. environment can be only one of the following: |
|
vmImage |
Use a Compute Engine VM image to start the notebook instance. |
containerImage |
Use a container image to start the notebook instance. |
AcceleratorConfig
Definition of a hardware accelerator. Note that not all combinations of type
and coreCount
are valid. services.check GPUs on Compute Engine to find a valid combination. TPUs are not supported.
JSON representation |
---|
{
"type": enum ( |
Fields | |
---|---|
type |
Type of this accelerator. |
coreCount |
Count of cores of this accelerator. |
AcceleratorType
Definition of the types of hardware accelerators that can be used on this instance.
Enums | |
---|---|
ACCELERATOR_TYPE_UNSPECIFIED |
Accelerator type is not specified. |
NVIDIA_TESLA_K80 |
Accelerator type is Nvidia Tesla K80. |
NVIDIA_TESLA_P100 |
Accelerator type is Nvidia Tesla P100. |
NVIDIA_TESLA_V100 |
Accelerator type is Nvidia Tesla V100. |
NVIDIA_TESLA_P4 |
Accelerator type is Nvidia Tesla P4. |
NVIDIA_TESLA_T4 |
Accelerator type is Nvidia Tesla T4. |
NVIDIA_TESLA_T4_VWS |
Accelerator type is NVIDIA Tesla T4 Virtual Workstations. |
NVIDIA_TESLA_P100_VWS |
Accelerator type is NVIDIA Tesla P100 Virtual Workstations. |
NVIDIA_TESLA_P4_VWS |
Accelerator type is NVIDIA Tesla P4 Virtual Workstations. |
TPU_V2 |
(Coming soon) Accelerator type is TPU V2. |
TPU_V3 |
(Coming soon) Accelerator type is TPU V3. |
State
The definition of the states of this instance.
Enums | |
---|---|
STATE_UNSPECIFIED |
State is not specified. |
STARTING |
The control logic is starting the instance. |
PROVISIONING |
The control logic is installing required frameworks and registering the instance with notebook proxy |
ACTIVE |
The instance is running. |
STOPPING |
The control logic is stopping the instance. |
STOPPED |
The instance is stopped. |
DELETED |
The instance is deleted. |
UPGRADING |
The instance is upgrading. |
INITIALIZING |
The instance is being created. |
REGISTERING |
The instance is getting registered. |
SUSPENDING |
The instance is suspending. |
SUSPENDED |
The instance is suspended. |
DiskType
Possible disk types for notebook instances.
Enums | |
---|---|
DISK_TYPE_UNSPECIFIED |
Disk type not set. |
PD_STANDARD |
Standard persistent disk type. |
PD_SSD |
SSD persistent disk type. |
PD_BALANCED |
Balanced persistent disk type. |
DiskEncryption
Definition of the disk encryption options.
Enums | |
---|---|
DISK_ENCRYPTION_UNSPECIFIED |
Disk encryption is not specified. |
GMEK |
Use Google managed encryption keys to encrypt the boot disk. |
CMEK |
Use customer managed encryption keys to encrypt the boot disk. |
NicType
The type of vNIC driver.
Enums | |
---|---|
UNSPECIFIED_NIC_TYPE |
No type specified. Default should be UNSPECIFIED_NIC_TYPE. |
VIRTIO_NET |
VIRTIO. Default in Notebooks DLVM. |
GVNIC |
GVNIC. Alternative to VIRTIO. https://github.com/GoogleCloudPlatform/compute-virtual-ethernet-linux |
ReservationAffinity
Reservation Affinity for consuming Zonal reservation.
JSON representation |
---|
{
"consumeReservationType": enum ( |
Fields | |
---|---|
consumeReservationType |
Optional. Type of reservation to consume |
key |
Optional. Corresponds to the label key of reservation resource. |
values[] |
Optional. Corresponds to the label values of reservation resource. |
Type
Indicates whether to consume capacity from an reservation or not.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Default type. |
NO_RESERVATION |
Do not consume from any allocated capacity. |
ANY_RESERVATION |
Consume any reservation available. |
SPECIFIC_RESERVATION |
Must consume from a specific reservation. Must specify key value fields for specifying the reservations. |
Methods |
|
---|---|
|
Creates a new Instance in a given project and location. |
|
Deletes a single Instance. |
|
Gets details of a single Instance. |
|
Gets the access control policy for a resource. |
(deprecated) |
Check if a notebook instance is upgradable. |
|
Lists instances in a given project and location. |
|
Registers an existing legacy notebook instance to the Notebooks API server. |
|
Allows notebook instances to report their latest instance information to the Notebooks API server. |
|
Resets a notebook instance. |
|
Updates the guest accelerators of a single Instance. |
|
Sets the access control policy on the specified resource. |
|
Updates the labels of an Instance. |
|
Updates the machine type of a single Instance. |
|
Starts a notebook instance. |
|
Stops a notebook instance. |
|
Returns permissions that a caller has on the specified resource. |
(deprecated) |
Upgrades a notebook instance to the latest version. |
(deprecated) |
Allows notebook instances to call this endpoint to upgrade themselves. |