Google Cloud Notebooks V1 Client - Class VirtualMachineConfig (0.5.0)

Reference documentation and code samples for the Google Cloud Notebooks V1 Client class VirtualMachineConfig.

The config settings for virtual machine.

Generated from protobuf message google.cloud.notebooks.v1.VirtualMachineConfig

Namespace

Google \ Cloud \ Notebooks \ V1

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ zone string

Output only. The zone where the virtual machine is located. If using regional request, the notebooks service will pick a location in the corresponding runtime region. On a get request, zone will always be present. Example: * us-central1-b

↳ machine_type string

Required. The Compute Engine machine type used for runtimes. Short name is valid. Examples: * n1-standard-2 * e2-standard-8

↳ container_images array<Google\Cloud\Notebooks\V1\ContainerImage>

Optional. Use a list of container images to use as Kernels in the notebook instance.

↳ data_disk Google\Cloud\Notebooks\V1\LocalDisk

Required. Data disk option configuration settings.

↳ encryption_config Google\Cloud\Notebooks\V1\EncryptionConfig

Optional. Encryption settings for virtual machine data disk.

↳ shielded_instance_config Google\Cloud\Notebooks\V1\RuntimeShieldedInstanceConfig

Optional. Shielded VM Instance configuration settings.

↳ accelerator_config Google\Cloud\Notebooks\V1\RuntimeAcceleratorConfig

Optional. The Compute Engine accelerator configuration for this runtime.

↳ network string

Optional. The Compute Engine network to be used for machine communications. Cannot be specified with subnetwork. If neither network nor subnet is specified, the "default" network of the project is used, if it exists. A full URL or partial URI. Examples: * https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default * projects/[project_id]/global/networks/default Runtimes are managed resources inside Google Infrastructure. Runtimes support the following network configurations: * Google Managed Network (Network & subnet are empty) * Consumer Project VPC (network & subnet are required). Requires configuring Private Service Access. * Shared VPC (network & subnet are required). Requires configuring Private Service Access.

↳ subnet string

Optional. The Compute Engine subnetwork to be used for machine communications. Cannot be specified with network. A full URL or partial URI are valid. Examples: * https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0 * projects/[project_id]/regions/us-east1/subnetworks/sub0

↳ internal_ip_only bool

Optional. If true, runtime will only have internal IP addresses. By default, runtimes are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each vm. This internal_ip_only restriction can only be enabled for subnetwork enabled networks, and all dependencies must be configured to be accessible without external IP addresses.

↳ tags array

Optional. The Compute Engine tags to add to runtime (see Tagging instances).

↳ guest_attributes array|Google\Protobuf\Internal\MapField

Output only. The Compute Engine guest attributes. (see Project and instance guest attributes).

↳ metadata array|Google\Protobuf\Internal\MapField

Optional. The Compute Engine metadata entries to add to virtual machine. (see Project and instance metadata).

↳ labels array|Google\Protobuf\Internal\MapField

Optional. The labels to associate with this runtime. Label keys must contain 1 to 63 characters, and must conform to RFC 1035. Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035. No more than 32 labels can be associated with a cluster.

↳ nic_type int

Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.

↳ reserved_ip_range string

Optional. Reserved IP Range name is used for VPC Peering. The subnetwork allocation will use the range name if it's assigned. Example: managed-notebooks-range-c PEERING_RANGE_NAME_3=managed-notebooks-range-c gcloud compute addresses create $PEERING_RANGE_NAME_3 \ --global \ --prefix-length=24 \ --description="Google Cloud Managed Notebooks Range 24 c" \ --network=$NETWORK \ --addresses=192.168.0.0 \ --purpose=VPC_PEERING Field value will be: managed-notebooks-range-c

↳ boot_image Google\Cloud\Notebooks\V1\VirtualMachineConfig\BootImage

Optional. Boot image metadata used for runtime upgradeability.

getZone

Output only. The zone where the virtual machine is located.

If using regional request, the notebooks service will pick a location in the corresponding runtime region. On a get request, zone will always be present. Example:

  • us-central1-b
Returns
TypeDescription
string

setZone

Output only. The zone where the virtual machine is located.

If using regional request, the notebooks service will pick a location in the corresponding runtime region. On a get request, zone will always be present. Example:

  • us-central1-b
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getMachineType

Required. The Compute Engine machine type used for runtimes.

Short name is valid. Examples:

  • n1-standard-2
  • e2-standard-8
Returns
TypeDescription
string

setMachineType

Required. The Compute Engine machine type used for runtimes.

Short name is valid. Examples:

  • n1-standard-2
  • e2-standard-8
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getContainerImages

Optional. Use a list of container images to use as Kernels in the notebook instance.

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setContainerImages

Optional. Use a list of container images to use as Kernels in the notebook instance.

Parameter
NameDescription
var array<Google\Cloud\Notebooks\V1\ContainerImage>
Returns
TypeDescription
$this

getDataDisk

Required. Data disk option configuration settings.

Returns
TypeDescription
Google\Cloud\Notebooks\V1\LocalDisk|null

hasDataDisk

clearDataDisk

setDataDisk

Required. Data disk option configuration settings.

Parameter
NameDescription
var Google\Cloud\Notebooks\V1\LocalDisk
Returns
TypeDescription
$this

getEncryptionConfig

Optional. Encryption settings for virtual machine data disk.

Returns
TypeDescription
Google\Cloud\Notebooks\V1\EncryptionConfig|null

hasEncryptionConfig

clearEncryptionConfig

setEncryptionConfig

Optional. Encryption settings for virtual machine data disk.

Parameter
NameDescription
var Google\Cloud\Notebooks\V1\EncryptionConfig
Returns
TypeDescription
$this

getShieldedInstanceConfig

Optional. Shielded VM Instance configuration settings.

Returns
TypeDescription
Google\Cloud\Notebooks\V1\RuntimeShieldedInstanceConfig|null

hasShieldedInstanceConfig

clearShieldedInstanceConfig

setShieldedInstanceConfig

Optional. Shielded VM Instance configuration settings.

Parameter
NameDescription
var Google\Cloud\Notebooks\V1\RuntimeShieldedInstanceConfig
Returns
TypeDescription
$this

getAcceleratorConfig

Optional. The Compute Engine accelerator configuration for this runtime.

Returns
TypeDescription
Google\Cloud\Notebooks\V1\RuntimeAcceleratorConfig|null

hasAcceleratorConfig

clearAcceleratorConfig

setAcceleratorConfig

Optional. The Compute Engine accelerator configuration for this runtime.

Parameter
NameDescription
var Google\Cloud\Notebooks\V1\RuntimeAcceleratorConfig
Returns
TypeDescription
$this

getNetwork

Optional. The Compute Engine network to be used for machine communications. Cannot be specified with subnetwork. If neither network nor subnet is specified, the "default" network of the project is used, if it exists.

A full URL or partial URI. Examples:

  • https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default
  • projects/[project_id]/global/networks/default Runtimes are managed resources inside Google Infrastructure. Runtimes support the following network configurations:
  • Google Managed Network (Network & subnet are empty)
  • Consumer Project VPC (network & subnet are required). Requires configuring Private Service Access.
  • Shared VPC (network & subnet are required). Requires configuring Private Service Access.
Returns
TypeDescription
string

setNetwork

Optional. The Compute Engine network to be used for machine communications. Cannot be specified with subnetwork. If neither network nor subnet is specified, the "default" network of the project is used, if it exists.

A full URL or partial URI. Examples:

  • https://www.googleapis.com/compute/v1/projects/[project_id]/global/networks/default
  • projects/[project_id]/global/networks/default Runtimes are managed resources inside Google Infrastructure. Runtimes support the following network configurations:
  • Google Managed Network (Network & subnet are empty)
  • Consumer Project VPC (network & subnet are required). Requires configuring Private Service Access.
  • Shared VPC (network & subnet are required). Requires configuring Private Service Access.
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getSubnet

Optional. The Compute Engine subnetwork to be used for machine communications. Cannot be specified with network.

A full URL or partial URI are valid. Examples:

  • https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0
  • projects/[project_id]/regions/us-east1/subnetworks/sub0
Returns
TypeDescription
string

setSubnet

Optional. The Compute Engine subnetwork to be used for machine communications. Cannot be specified with network.

A full URL or partial URI are valid. Examples:

  • https://www.googleapis.com/compute/v1/projects/[project_id]/regions/us-east1/subnetworks/sub0
  • projects/[project_id]/regions/us-east1/subnetworks/sub0
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getInternalIpOnly

Optional. If true, runtime will only have internal IP addresses. By default, runtimes are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each vm. This internal_ip_only restriction can only be enabled for subnetwork enabled networks, and all dependencies must be configured to be accessible without external IP addresses.

Returns
TypeDescription
bool

setInternalIpOnly

Optional. If true, runtime will only have internal IP addresses. By default, runtimes are not restricted to internal IP addresses, and will have ephemeral external IP addresses assigned to each vm. This internal_ip_only restriction can only be enabled for subnetwork enabled networks, and all dependencies must be configured to be accessible without external IP addresses.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getTags

Optional. The Compute Engine tags to add to runtime (see Tagging instances).

Returns
TypeDescription
Google\Protobuf\Internal\RepeatedField

setTags

Optional. The Compute Engine tags to add to runtime (see Tagging instances).

Parameter
NameDescription
var string[]
Returns
TypeDescription
$this

getGuestAttributes

Output only. The Compute Engine guest attributes. (see Project and instance guest attributes).

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setGuestAttributes

Output only. The Compute Engine guest attributes. (see Project and instance guest attributes).

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getMetadata

Optional. The Compute Engine metadata entries to add to virtual machine. (see Project and instance metadata).

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setMetadata

Optional. The Compute Engine metadata entries to add to virtual machine. (see Project and instance metadata).

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getLabels

Optional. The labels to associate with this runtime.

Label keys must contain 1 to 63 characters, and must conform to RFC 1035. Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035. No more than 32 labels can be associated with a cluster.

Returns
TypeDescription
Google\Protobuf\Internal\MapField

setLabels

Optional. The labels to associate with this runtime.

Label keys must contain 1 to 63 characters, and must conform to RFC 1035. Label values may be empty, but, if present, must contain 1 to 63 characters, and must conform to RFC 1035. No more than 32 labels can be associated with a cluster.

Parameter
NameDescription
var array|Google\Protobuf\Internal\MapField
Returns
TypeDescription
$this

getNicType

Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.

Returns
TypeDescription
int

setNicType

Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getReservedIpRange

Optional. Reserved IP Range name is used for VPC Peering.

The subnetwork allocation will use the range name if it's assigned. Example: managed-notebooks-range-c PEERING_RANGE_NAME_3=managed-notebooks-range-c gcloud compute addresses create $PEERING_RANGE_NAME_3 \ --global \ --prefix-length=24 \ --description="Google Cloud Managed Notebooks Range 24 c" \ --network=$NETWORK \ --addresses=192.168.0.0 \ --purpose=VPC_PEERING Field value will be: managed-notebooks-range-c

Returns
TypeDescription
string

setReservedIpRange

Optional. Reserved IP Range name is used for VPC Peering.

The subnetwork allocation will use the range name if it's assigned. Example: managed-notebooks-range-c PEERING_RANGE_NAME_3=managed-notebooks-range-c gcloud compute addresses create $PEERING_RANGE_NAME_3 \ --global \ --prefix-length=24 \ --description="Google Cloud Managed Notebooks Range 24 c" \ --network=$NETWORK \ --addresses=192.168.0.0 \ --purpose=VPC_PEERING Field value will be: managed-notebooks-range-c

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getBootImage

Optional. Boot image metadata used for runtime upgradeability.

Returns
TypeDescription
Google\Cloud\Notebooks\V1\VirtualMachineConfig\BootImage|null

hasBootImage

clearBootImage

setBootImage

Optional. Boot image metadata used for runtime upgradeability.

Parameter
NameDescription
var Google\Cloud\Notebooks\V1\VirtualMachineConfig\BootImage
Returns
TypeDescription
$this