Google Cloud Life Sciences V2beta Client - Class VirtualMachine (0.7.2)

Reference documentation and code samples for the Google Cloud Life Sciences V2beta Client class VirtualMachine.

Carries information about a Compute Engine VM resource.

Generated from protobuf message google.cloud.lifesciences.v2beta.VirtualMachine

Namespace

Google \ Cloud \ LifeSciences \ V2beta

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ machine_type
string

Required. The machine type of the virtual machine to create. Must be the short name of a standard machine type (such as "n1-standard-1") or a custom machine type (such as "custom-1-4096", where "1" indicates the number of vCPUs and "4096" indicates the memory in MB). See Creating an instance with a custom machine type for more specifications on creating a custom machine type.

↳ preemptible
bool

If true, allocate a preemptible VM.

↳ labels
array| Google\Protobuf\Internal\MapField

Optional set of labels to apply to the VM and any attached disk resources. These labels must adhere to the name and value restrictions on VM labels imposed by Compute Engine. Labels keys with the prefix 'google-' are reserved for use by Google. Labels applied at creation time to the VM. Applied on a best-effort basis to attached disk resources shortly after VM creation.

↳ disks
array< Disk >

The list of disks to create and attach to the VM. Specify either the volumes[] field or the disks[] field, but not both.

↳ network
Network

The VM network configuration.

↳ accelerators
array< Accelerator >

The list of accelerators to attach to the VM.

↳ service_account
ServiceAccount

The service account to install on the VM. This account does not need any permissions other than those required by the pipeline.

↳ boot_disk_size_gb
int

The size of the boot disk, in GB. The boot disk must be large enough to accommodate all of the Docker images from each action in the pipeline at the same time. If not specified, a small but reasonable default value is used.

↳ cpu_platform
string

The CPU platform to request. An instance based on a newer platform can be allocated, but never one with fewer capabilities. The value of this parameter must be a valid Compute Engine CPU platform name (such as "Intel Skylake"). This parameter is only useful for carefully optimized work loads where the CPU platform has a significant impact. For more information about the effect of this parameter, see https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform .

↳ boot_image
string

The host operating system image to use. Currently, only Container-Optimized OS images can be used. The default value is projects/cos-cloud/global/images/family/cos-stable , which selects the latest stable release of Container-Optimized OS. This option is provided to allow testing against the beta release of the operating system to ensure that the new version does not interact negatively with production pipelines. To test a pipeline against the beta release of Container-Optimized OS, use the value projects/cos-cloud/global/images/family/cos-beta .

↳ nvidia_driver_version
string

The NVIDIA driver version to use when attaching an NVIDIA GPU accelerator. The version specified here must be compatible with the GPU libraries contained in the container being executed, and must be one of the drivers hosted in the nvidia-drivers-us-public bucket on Google Cloud Storage.

↳ enable_stackdriver_monitoring
bool

Whether Stackdriver monitoring should be enabled on the VM.

↳ docker_cache_images
array

The Compute Engine Disk Images to use as a Docker cache. The disks will be mounted into the Docker folder in a way that the images present in the cache will not need to be pulled. The digests of the cached images must match those of the tags used or the latest version will still be pulled. The root directory of the ext4 image must contain image and overlay2 directories copied from the Docker directory of a VM where the desired Docker images have already been pulled. Any images pulled that are not cached will be stored on the first cache disk instead of the boot disk. Only a single image is supported.

↳ volumes
array< Volume >

The list of disks and other storage to create or attach to the VM. Specify either the volumes[] field or the disks[] field, but not both.

↳ reservation
string

If specified, the VM will only be allocated inside the matching reservation. It will fail if the VM parameters don't match the reservation.

getMachineType

Required. The machine type of the virtual machine to create. Must be the short name of a standard machine type (such as "n1-standard-1") or a custom machine type (such as "custom-1-4096", where "1" indicates the number of vCPUs and "4096" indicates the memory in MB). See Creating an instance with a custom machine type for more specifications on creating a custom machine type.

Returns
Type
Description
string

setMachineType

Required. The machine type of the virtual machine to create. Must be the short name of a standard machine type (such as "n1-standard-1") or a custom machine type (such as "custom-1-4096", where "1" indicates the number of vCPUs and "4096" indicates the memory in MB). See Creating an instance with a custom machine type for more specifications on creating a custom machine type.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getPreemptible

If true, allocate a preemptible VM.

Returns
Type
Description
bool

setPreemptible

If true, allocate a preemptible VM.

Parameter
Name
Description
var
bool
Returns
Type
Description
$this

getLabels

Optional set of labels to apply to the VM and any attached disk resources.

These labels must adhere to the name and value restrictions on VM labels imposed by Compute Engine. Labels keys with the prefix 'google-' are reserved for use by Google. Labels applied at creation time to the VM. Applied on a best-effort basis to attached disk resources shortly after VM creation.

Returns
Type
Description

setLabels

Optional set of labels to apply to the VM and any attached disk resources.

These labels must adhere to the name and value restrictions on VM labels imposed by Compute Engine. Labels keys with the prefix 'google-' are reserved for use by Google. Labels applied at creation time to the VM. Applied on a best-effort basis to attached disk resources shortly after VM creation.

Parameter
Name
Description
Returns
Type
Description
$this

getDisks

The list of disks to create and attach to the VM.

Specify either the volumes[] field or the disks[] field, but not both.

Returns
Type
Description

setDisks

The list of disks to create and attach to the VM.

Specify either the volumes[] field or the disks[] field, but not both.

Parameter
Name
Description
var
array< Disk >
Returns
Type
Description
$this

getNetwork

The VM network configuration.

Returns
Type
Description
Network |null

hasNetwork

clearNetwork

setNetwork

The VM network configuration.

Parameter
Name
Description
var
Returns
Type
Description
$this

getAccelerators

The list of accelerators to attach to the VM.

Returns
Type
Description

setAccelerators

The list of accelerators to attach to the VM.

Parameter
Name
Description
var
array< Accelerator >
Returns
Type
Description
$this

getServiceAccount

The service account to install on the VM. This account does not need any permissions other than those required by the pipeline.

Returns
Type
Description

hasServiceAccount

clearServiceAccount

setServiceAccount

The service account to install on the VM. This account does not need any permissions other than those required by the pipeline.

Parameter
Name
Description
Returns
Type
Description
$this

getBootDiskSizeGb

The size of the boot disk, in GB. The boot disk must be large enough to accommodate all of the Docker images from each action in the pipeline at the same time. If not specified, a small but reasonable default value is used.

Returns
Type
Description
int

setBootDiskSizeGb

The size of the boot disk, in GB. The boot disk must be large enough to accommodate all of the Docker images from each action in the pipeline at the same time. If not specified, a small but reasonable default value is used.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getCpuPlatform

The CPU platform to request. An instance based on a newer platform can be allocated, but never one with fewer capabilities. The value of this parameter must be a valid Compute Engine CPU platform name (such as "Intel Skylake"). This parameter is only useful for carefully optimized work loads where the CPU platform has a significant impact.

For more information about the effect of this parameter, see https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform .

Returns
Type
Description
string

setCpuPlatform

The CPU platform to request. An instance based on a newer platform can be allocated, but never one with fewer capabilities. The value of this parameter must be a valid Compute Engine CPU platform name (such as "Intel Skylake"). This parameter is only useful for carefully optimized work loads where the CPU platform has a significant impact.

For more information about the effect of this parameter, see https://cloud.google.com/compute/docs/instances/specify-min-cpu-platform .

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getBootImage

The host operating system image to use.

Currently, only Container-Optimized OS images can be used. The default value is projects/cos-cloud/global/images/family/cos-stable , which selects the latest stable release of Container-Optimized OS. This option is provided to allow testing against the beta release of the operating system to ensure that the new version does not interact negatively with production pipelines. To test a pipeline against the beta release of Container-Optimized OS, use the value projects/cos-cloud/global/images/family/cos-beta .

Returns
Type
Description
string

setBootImage

The host operating system image to use.

Currently, only Container-Optimized OS images can be used. The default value is projects/cos-cloud/global/images/family/cos-stable , which selects the latest stable release of Container-Optimized OS. This option is provided to allow testing against the beta release of the operating system to ensure that the new version does not interact negatively with production pipelines. To test a pipeline against the beta release of Container-Optimized OS, use the value projects/cos-cloud/global/images/family/cos-beta .

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getNvidiaDriverVersion

The NVIDIA driver version to use when attaching an NVIDIA GPU accelerator.

The version specified here must be compatible with the GPU libraries contained in the container being executed, and must be one of the drivers hosted in the nvidia-drivers-us-public bucket on Google Cloud Storage.

Returns
Type
Description
string

setNvidiaDriverVersion

The NVIDIA driver version to use when attaching an NVIDIA GPU accelerator.

The version specified here must be compatible with the GPU libraries contained in the container being executed, and must be one of the drivers hosted in the nvidia-drivers-us-public bucket on Google Cloud Storage.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getEnableStackdriverMonitoring

Whether Stackdriver monitoring should be enabled on the VM.

Returns
Type
Description
bool

setEnableStackdriverMonitoring

Whether Stackdriver monitoring should be enabled on the VM.

Parameter
Name
Description
var
bool
Returns
Type
Description
$this

getDockerCacheImages

The Compute Engine Disk Images to use as a Docker cache. The disks will be mounted into the Docker folder in a way that the images present in the cache will not need to be pulled. The digests of the cached images must match those of the tags used or the latest version will still be pulled.

The root directory of the ext4 image must contain image and overlay2 directories copied from the Docker directory of a VM where the desired Docker images have already been pulled. Any images pulled that are not cached will be stored on the first cache disk instead of the boot disk. Only a single image is supported.

Returns
Type
Description

setDockerCacheImages

The Compute Engine Disk Images to use as a Docker cache. The disks will be mounted into the Docker folder in a way that the images present in the cache will not need to be pulled. The digests of the cached images must match those of the tags used or the latest version will still be pulled.

The root directory of the ext4 image must contain image and overlay2 directories copied from the Docker directory of a VM where the desired Docker images have already been pulled. Any images pulled that are not cached will be stored on the first cache disk instead of the boot disk. Only a single image is supported.

Parameter
Name
Description
var
string[]
Returns
Type
Description
$this

getVolumes

The list of disks and other storage to create or attach to the VM.

Specify either the volumes[] field or the disks[] field, but not both.

Returns
Type
Description

setVolumes

The list of disks and other storage to create or attach to the VM.

Specify either the volumes[] field or the disks[] field, but not both.

Parameter
Name
Description
var
array< Volume >
Returns
Type
Description
$this

getReservation

If specified, the VM will only be allocated inside the matching reservation. It will fail if the VM parameters don't match the reservation.

Returns
Type
Description
string

setReservation

If specified, the VM will only be allocated inside the matching reservation. It will fail if the VM parameters don't match the reservation.

Parameter
Name
Description
var
string
Returns
Type
Description
$this
Design a Mobile Site
View Site in Mobile | Classic
Share by: