# Class VirtualMachineConfig (1.17.0)

1.17.0 (latest) 1.16.0 1.15.0 1.14.0 1.13.3 1.12.0 1.11.1 1.10.5 1.9.0 1.8.0 1.7.1 1.6.1 1.5.1 1.4.4 1.3.2 1.2.1 1.1.1 1.0.0 0.4.3 0.3.2 0.2.0 0.1.2

    VirtualMachineConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The config settings for virtual machine.

| ## Attributes ||
|---|---|
| **Name** | **Description** |
| `zone` | `str` 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` | `str` Required. The Compute Engine machine type used for runtimes. Short name is valid. Examples: - `n1-standard-2` - `e2-standard-8` |
| `container_images` | `MutableSequence[https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.ContainerImage]` Optional. Use a list of container images to use as Kernels in the notebook instance. |
| `data_disk` | `https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.LocalDisk` Required. Data disk option configuration settings. |
| `encryption_config` | `https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.EncryptionConfig` Optional. Encryption settings for virtual machine data disk. |
| `shielded_instance_config` | `https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.RuntimeShieldedInstanceConfig` Optional. Shielded VM Instance configuration settings. |
| `accelerator_config` | `https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.RuntimeAcceleratorConfig` Optional. The Compute Engine accelerator configuration for this runtime. |
| `network` | `str` 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` | `str` 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` | `MutableSequence[str]` Optional. The Compute Engine tags to add to runtime (see \`Tagging instances |
| `guest_attributes` | `MutableMapping[str, str]` Output only. The Compute Engine guest attributes. (see \`Project and instance guest attributes |
| `metadata` | `MutableMapping[str, str]` Optional. The Compute Engine metadata entries to add to virtual machine. (see \`Project and instance metadata |
| `labels` | `MutableMapping[str, str]` 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 |
| `nic_type` | `https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.VirtualMachineConfig.NicType` Optional. The type of vNIC to be used on this interface. This may be gVNIC or VirtioNet. |
| `reserved_ip_range` | `str` 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` | `https://docs.cloud.google.com/python/docs/reference/notebooks/latest/google.cloud.notebooks_v1.types.VirtualMachineConfig.BootImage` Optional. Boot image metadata used for runtime upgradeability. |

## Classes

### BootImage

    BootImage(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Definition of the boot image used by the Runtime.
Used to facilitate runtime upgradeability.

### GuestAttributesEntry

    GuestAttributesEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `kwargs` | `dict` Keys and values corresponding to the fields of the message. |
| `mapping` | ``Union[dict, `.Message`]`` A dictionary or message to be used to determine the values for this message. |
| `ignore_unknown_fields` | `Optional(bool)` If True, do not raise errors for unknown fields. Only applied if `mapping` is a mapping type or there are keyword parameters. |

### LabelsEntry

    LabelsEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `kwargs` | `dict` Keys and values corresponding to the fields of the message. |
| `mapping` | ``Union[dict, `.Message`]`` A dictionary or message to be used to determine the values for this message. |
| `ignore_unknown_fields` | `Optional(bool)` If True, do not raise errors for unknown fields. Only applied if `mapping` is a mapping type or there are keyword parameters. |

### MetadataEntry

    MetadataEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `kwargs` | `dict` Keys and values corresponding to the fields of the message. |
| `mapping` | ``Union[dict, `.Message`]`` A dictionary or message to be used to determine the values for this message. |
| `ignore_unknown_fields` | `Optional(bool)` If True, do not raise errors for unknown fields. Only applied if `mapping` is a mapping type or there are keyword parameters. |

### NicType

    NicType(value)

The type of vNIC driver. Default should be UNSPECIFIED_NIC_TYPE.