Class Instance
The definition of a notebook instance.
Implements
Inherited Members
Namespace: Google.Apis.AIPlatformNotebooks.v1.Data
Assembly: Google.Apis.AIPlatformNotebooks.v1.dll
Syntax
public class Instance : IDirectResponseSchema
Properties
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 machine_type you have
selected.
Declaration
[JsonProperty("acceleratorConfig")]
public virtual AcceleratorConfig AcceleratorConfig { get; set; }
Property Value
| Type | Description |
|---|---|
| AcceleratorConfig |
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.
Declaration
[JsonProperty("bootDiskSizeGb")]
public virtual long? BootDiskSizeGb { get; set; }
Property Value
| Type | Description |
|---|---|
| long? |
BootDiskType
Input only. The type of the boot disk attached to this instance, defaults to standard persistent disk
(PD_STANDARD).
Declaration
[JsonProperty("bootDiskType")]
public virtual string BootDiskType { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
CanIpForward
Optional. Flag to enable ip forwarding or not, default false/off. https://cloud.google.com/vpc/docs/using-routes#canipforward
Declaration
[JsonProperty("canIpForward")]
public virtual bool? CanIpForward { get; set; }
Property Value
| Type | Description |
|---|---|
| bool? |
ContainerImage
Use a container image to start the notebook instance.
Declaration
[JsonProperty("containerImage")]
public virtual ContainerImage ContainerImage { get; set; }
Property Value
| Type | Description |
|---|---|
| ContainerImage |
CreateTime
object representation of CreateTimeRaw.
Declaration
[JsonIgnore]
[Obsolete("This property is obsolete and may behave unexpectedly; please use CreateTimeDateTimeOffset instead.")]
public virtual object CreateTime { get; set; }
Property Value
| Type | Description |
|---|---|
| object |
CreateTimeDateTimeOffset
DateTimeOffset representation of CreateTimeRaw.
Declaration
[JsonIgnore]
public virtual DateTimeOffset? CreateTimeDateTimeOffset { get; set; }
Property Value
| Type | Description |
|---|---|
| DateTimeOffset? |
CreateTimeRaw
Output only. Instance creation time.
Declaration
[JsonProperty("createTime")]
public virtual string CreateTimeRaw { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Creator
Output only. Email address of entity that sent original CreateInstance request.
Declaration
[JsonProperty("creator")]
public virtual string Creator { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
CustomGpuDriverPath
Specify a custom Cloud Storage path where the GPU driver is stored. If not specified, we'll automatically choose from official GPU drivers.
Declaration
[JsonProperty("customGpuDriverPath")]
public virtual string CustomGpuDriverPath { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
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.
Declaration
[JsonProperty("dataDiskSizeGb")]
public virtual long? DataDiskSizeGb { get; set; }
Property Value
| Type | Description |
|---|---|
| long? |
DataDiskType
Input only. The type of the data disk attached to this instance, defaults to standard persistent disk
(PD_STANDARD).
Declaration
[JsonProperty("dataDiskType")]
public virtual string DataDiskType { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
DiskEncryption
Input only. Disk encryption method used on the boot and data disks, defaults to GMEK.
Declaration
[JsonProperty("diskEncryption")]
public virtual string DiskEncryption { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Disks
Output only. Attached disks to notebook instance.
Declaration
[JsonProperty("disks")]
public virtual IList<Disk> Disks { get; set; }
Property Value
| Type | Description |
|---|---|
| IList<Disk> |
ETag
The ETag of the item.
Declaration
public virtual string ETag { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
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.
Declaration
[JsonProperty("installGpuDriver")]
public virtual bool? InstallGpuDriver { get; set; }
Property Value
| Type | Description |
|---|---|
| bool? |
InstanceMigrationEligibility
Output only. Checks how feasible a migration from UmN to WbI is.
Declaration
[JsonProperty("instanceMigrationEligibility")]
public virtual InstanceMigrationEligibility InstanceMigrationEligibility { get; set; }
Property Value
| Type | Description |
|---|---|
| InstanceMigrationEligibility |
InstanceOwners
Input only. The owner of this instance after creation. Format: alias@example.com 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.
Declaration
[JsonProperty("instanceOwners")]
public virtual IList<string> InstanceOwners { get; set; }
Property Value
| Type | Description |
|---|---|
| IList<string> |
KmsKey
Input only. The KMS key used to encrypt the disks, only applicable if disk_encryption is CMEK. Format:
projects/{project_id}/locations/{location}/keyRings/{key_ring_id}/cryptoKeys/{key_id} Learn more about
using your own encryption keys.
Declaration
[JsonProperty("kmsKey")]
public virtual string KmsKey { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Labels
Labels to apply to this instance. These can be later modified by the setLabels method.
Declaration
[JsonProperty("labels")]
public virtual IDictionary<string, string> Labels { get; set; }
Property Value
| Type | Description |
|---|---|
| IDictionary<string, string> |
MachineType
Required. The Compute Engine machine type of this instance.
Declaration
[JsonProperty("machineType")]
public virtual string MachineType { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Metadata
Custom metadata to apply to this instance. For example, to specify a Cloud Storage bucket for automatic
backup, you can use the gcs-data-bucket metadata tag. Format: "--metadata=gcs-data-bucket=BUCKET".
Declaration
[JsonProperty("metadata")]
public virtual IDictionary<string, string> Metadata { get; set; }
Property Value
| Type | Description |
|---|---|
| IDictionary<string, string> |
Migrated
Output only. Bool indicating whether this notebook has been migrated to a Workbench Instance
Declaration
[JsonProperty("migrated")]
public virtual bool? Migrated { get; set; }
Property Value
| Type | Description |
|---|---|
| bool? |
Name
Output only. The name of this notebook instance. Format:
projects/{project_id}/locations/{location}/instances/{instance_id}
Declaration
[JsonProperty("name")]
public virtual string Name { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Network
The name of the VPC that this instance is in. Format: projects/{project_id}/global/networks/{network_id}
Declaration
[JsonProperty("network")]
public virtual string Network { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
NicType
Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.
Declaration
[JsonProperty("nicType")]
public virtual string NicType { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
NoProxyAccess
If true, the notebook instance will not register with the proxy.
Declaration
[JsonProperty("noProxyAccess")]
public virtual bool? NoProxyAccess { get; set; }
Property Value
| Type | Description |
|---|---|
| bool? |
NoPublicIp
If true, no external IP will be assigned to this instance.
Declaration
[JsonProperty("noPublicIp")]
public virtual bool? NoPublicIp { get; set; }
Property Value
| Type | Description |
|---|---|
| bool? |
NoRemoveDataDisk
Input only. If true, the data disk will not be auto deleted when deleting the instance.
Declaration
[JsonProperty("noRemoveDataDisk")]
public virtual bool? NoRemoveDataDisk { get; set; }
Property Value
| Type | Description |
|---|---|
| bool? |
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).
Declaration
[JsonProperty("postStartupScript")]
public virtual string PostStartupScript { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
ProxyUri
Output only. The proxy endpoint that is used to access the Jupyter notebook.
Declaration
[JsonProperty("proxyUri")]
public virtual string ProxyUri { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
ReservationAffinity
Optional. The optional reservation affinity. Setting this field will apply the specified Zonal Compute Reservation to this notebook instance.
Declaration
[JsonProperty("reservationAffinity")]
public virtual ReservationAffinity ReservationAffinity { get; set; }
Property Value
| Type | Description |
|---|---|
| ReservationAffinity |
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.
Declaration
[JsonProperty("serviceAccount")]
public virtual string ServiceAccount { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
ServiceAccountScopes
Optional. The URIs of service account scopes to be included in Compute Engine instances. If not specified, the following scopes are defined: - https://www.googleapis.com/auth/cloud-platform - https://www.googleapis.com/auth/userinfo.email If not using default scopes, you need at least: https://www.googleapis.com/auth/compute
Declaration
[JsonProperty("serviceAccountScopes")]
public virtual IList<string> ServiceAccountScopes { get; set; }
Property Value
| Type | Description |
|---|---|
| IList<string> |
ShieldedInstanceConfig
Optional. Shielded VM configuration. Images using supported Shielded VM features.
Declaration
[JsonProperty("shieldedInstanceConfig")]
public virtual ShieldedInstanceConfig ShieldedInstanceConfig { get; set; }
Property Value
| Type | Description |
|---|---|
| ShieldedInstanceConfig |
State
Output only. The state of this instance.
Declaration
[JsonProperty("state")]
public virtual string State { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Subnet
The name of the subnet that this instance is in. Format:
projects/{project_id}/regions/{region}/subnetworks/{subnetwork_id}
Declaration
[JsonProperty("subnet")]
public virtual string Subnet { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
Tags
Optional. The Compute Engine network tags to add to runtime (see Add network tags).
Declaration
[JsonProperty("tags")]
public virtual IList<string> Tags { get; set; }
Property Value
| Type | Description |
|---|---|
| IList<string> |
UpdateTime
object representation of UpdateTimeRaw.
Declaration
[JsonIgnore]
[Obsolete("This property is obsolete and may behave unexpectedly; please use UpdateTimeDateTimeOffset instead.")]
public virtual object UpdateTime { get; set; }
Property Value
| Type | Description |
|---|---|
| object |
UpdateTimeDateTimeOffset
DateTimeOffset representation of UpdateTimeRaw.
Declaration
[JsonIgnore]
public virtual DateTimeOffset? UpdateTimeDateTimeOffset { get; set; }
Property Value
| Type | Description |
|---|---|
| DateTimeOffset? |
UpdateTimeRaw
Output only. Instance update time.
Declaration
[JsonProperty("updateTime")]
public virtual string UpdateTimeRaw { get; set; }
Property Value
| Type | Description |
|---|---|
| string |
UpgradeHistory
The upgrade history of this instance.
Declaration
[JsonProperty("upgradeHistory")]
public virtual IList<UpgradeHistoryEntry> UpgradeHistory { get; set; }
Property Value
| Type | Description |
|---|---|
| IList<UpgradeHistoryEntry> |
VmImage
Use a Compute Engine VM image to start the notebook instance.
Declaration
[JsonProperty("vmImage")]
public virtual VmImage VmImage { get; set; }
Property Value
| Type | Description |
|---|---|
| VmImage |