## virtualmachine.gdc.goog/v1

Contains API Schema definitions for the virtualmachine.gdc.goog v1 API group.

### AccessManagementConfig

Specifies the `AccessManagement` feature configuration in the guest environment.

*Appears in:*
- [GuestEnvironment](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#guestenvironment)

| Field | Description |
|---|---|
| `enable` *boolean* | Specifies whether to `enable` the `AccessManagement` feature in the VM's guest environment. See the `GuestEnvironment` field description for information about the default value of the field. |

### Compute

Specifies the CPU and memory attributes of a VM.
You must specify *either* `vcpus` and `memory` exclusively, *or* specify only
`VirtualMachineType`.

Specifying `vcpus` without `memory`, or vice versa, creates an invalid
combination.
Specifying `virtualMachineType` while specifying either `vcpus` or `memory`, or
both also creates an invalid combination.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `virtualMachineType` *string* | Specifies the name of the referenced `VirtualMachineType`. The reference requires a predefined, or golden `VirtualMachineType` name. |
| `vcpus` *integer* | Specifies the number of VCPUs that are available to the instance. Specify `vcpus` as an integer. This value must be a multiple of 2, with 2 as the minimum and 128 as the maximum allowed. |
| `memory` *Quantity* | Specifies the amount of physical memory available to the instance. memory must have a minimum value of `1Gi`, and can be up to (including) `400Gi`. |

### ConfidentialInstanceConfig

Specifies the configurations of the confidential VM.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `confidentialInstanceType` *ConfidentialInstanceType* | Specifies the type of Confidential Computing technology. |

### DiskAttachment

Represents the attachment relationship between the `VirtualMachine` and the
`VirtualMachineDisk`.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `boot` *boolean* | Specifies whether this disk is the boot device for the `VirtualMachine`. There must be exactly one disk marked as `boot`. |
| `autoDelete` *boolean* | Specifies whether the disk should be deleted when the `VirtualMachine` is deleted. `AutoDelete` only applies while a disk is attached to a `VirtualMachine`. A `VirtualMachineDisk` lifecycle is decoupled from the `VirtualMachine` once it is no longer referenced in `.spec.disks`. |
| `virtualMachineDiskRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | Refers to a `VirtualMachineDisk` in the same `namespace`. |

### DiskReplicationStatus

*Appears in:*
- [VirtualMachineDiskStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskstatus)

| Field | Description |
|---|---|
| `role` *ReplicationRole* | The role that this disk has in the replication relationship. Valid values are "primary" and "secondary". |
| `primaryDisk` *[ReplicatedDiskInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#replicateddiskinfo)* | The primary disk that this disk is being replicated from, if this disk is a secondary disk. Will be nil for primary disks. |
| `secondaryDisk` *[ReplicatedDiskInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#replicateddiskinfo)* | The secondary disk that this disk is being replicated to, if this disk is a primary disk. Will be nil for secondary disks. |
| `volumeReplicationRelationship` *string* | The name of the volume replication relationship object that is managing the replication. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The latest observations of the replications state. |
| `errorStatus` *ErrorStatus* | A list of any errors that occurred during replication. |

### DiskSource

Defines the source for the disk. Specify exactly one of the supported sources to use to populate a disk.

*Appears in:*
- [VirtualMachineDiskSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskspec)

| Field | Description |
|---|---|
| `image` *[ImageDiskSource](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagedisksource)* | Denotes that the disk is created from a disk Image. |
| `imageFamily` *[ImageFamilySource](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagefamilysource)* | Denotes the name of the image family this image belongs to. User must provide either an image or an image family, but not both. |

### FailureHistory

*Appears in:*
- [VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)

| Field | Description |
|---|---|
| `failureCounter` *integer* | Number of times VM has failed. |
| `failureInfos` *[FailureInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#failureinfo) array* |   |

### FailureInfo

*Appears in:*
- [FailureHistory](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#failurehistory)

| Field | Description |
|---|---|
| `reason` *string* | Failure reason |
| `observedTime` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | Time when failure was observed. |

### FilterSpec

Defines the fine-grained restore Filter.

*Appears in:*
- [VirtualMachineRestoreRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequestspec)

| Field | Description |
|---|---|
| `targetedVirtualMachines` *[VirtualMachineResourceConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineresourceconfig) array* | The set of VMs that needs to be restored. These VMs should be the ones that are part of the VirtualMachineBackup resource that is provided in the same VirtualMachineRestoreRequest. |
| `targetedVirtualMachineDisks` *[VirtualMachineResourceConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineresourceconfig) array* | The set of VMDisks that needs to be restored. These VMDisks should be the ones that are part of the VirtualMachineBackup resource that is provided in the same VirtualMachineRestoreRequest. |
| `virtualMachineDiskOptions` *[VirtualMachineDiskFilterOptions](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskfilteroptions)* | Specifies the filter options for restoring disks. Specifying this field will not restore VirtualMachines, it will only restore VirtualMachineDisks based on selected field in VirtualMachineDiskFilterOptions. This field shouldn't be specified if one of TargetedVirtualMachines or TargetedVirtualMachineDisks is specified. |

### Firmware

Specifies the VM initialization options at boot time.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `type` *string* | Specifies whether to boot via UEFI or BIOS. Defaults to `bios`. Deprecated: Use ShieldConfig.BootType instead. |
| `enableSecureBoot` *boolean* | Enables or disables boot loader certificate verification. This is to assist in blocking modified or malicious code from loading. The default value is `true` if `type` is `uefi`. If `type` is set to `bios`, the default value is `false` and cannot be modified since boot loader certificate verification is not available for BIOS. Deprecated: Use ShieldConfig.EnableSecureBoot instead. |

### GCSReference

Represents the GCS source from which to store the image.

*Appears in:*
- [VirtualMachineImageSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimagespec)

| Field | Description |
|---|---|
| `url` *string* | The URL of the GCS object. |

### GracefulShutdown

GracefulShutdown configures graceful shutdown for a VM.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `connectionDrainTimeoutSeconds` *integer* | ConnectionDrainTimeoutSeconds specifies the grace period after a VM stop, eviction, or deletion is initiated and before the guest is shutdown. |

### GuestEnvironment

Specifies the guest environment configuration.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `accessManagement` *[AccessManagementConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#accessmanagementconfig)* | Specifies the access management configuration. |
| `guestHealthCheck` *[GuestHealthCheck](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#guesthealthcheck)* | Specifies the Guest Health configuration. |

### GuestHealthCheck

Specifies the `GuestHealth` feature configuration in the guest environment.

*Appears in:*
- [GuestEnvironment](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#guestenvironment)

| Field | Description |
|---|---|
| `enable` *boolean* | Specifies whether to `enable` the `GuestHealth` feature in the VM's guest environment. |

### IPAddress

*Appears in:*
- [NetworkInterfaceSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkinterfacespec)

| Field | Description |
|---|---|
| `address` *string* | The IP address. In GDC connected, the address may contain a subnet mask. If subnet mask is not included, /32 is taken as default. For example, 1.2.3.4 will be taken as 1.2.3.4/32. Alternatively, the input can be 1.2.3.4/24. In GDC airgapped, the address may not contain a subnet mask. Subnet information is retrieved from the Subnet object. |
| `managed` *boolean* | Whether the lifecycle of the Subnet associated with this IP address should be managed by the system in GDC airgapped. Unused in GDC connected. If true (default), a Subnet is created automatically for this IP and deleted during VM deletion. If false, the user must have created a Subnet and the Subnet must be in ready status. |

### ImageDestinationReference

Points to the destination to which the image contents are uploaded.
Only one destination can be specified.
Only supported in GDC Connected deployments.
This field is required if the specified `ImageSourceReference` is `GCS`.

*Appears in:*
- [VirtualMachineImageImportSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportspec)

| Field | Description |
|---|---|
| `gcs` *[ImageGCSDestinationReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagegcsdestinationreference)* | The bucket details for an image that is populated to gcs. |

### ImageDiskSource

Reference to the Image Source.

*Appears in:*
- [DiskSource](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#disksource)

| Field | Description |
|---|---|
| `name` *string* | The name of the `VirtualMachineImage` API object. |
| `namespace` *string* | The namespace of the `VirtualMachineImage` API object. For golden images use `vm-system`. For images in the current project, set this as empty or use the current `namespace` value. |

### ImageFamilySource

*Appears in:*
- [DiskSource](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#disksource)

| Field | Description |
|---|---|
| `name` *string* | The name of the image family to be used. |
| `namespace` *string* | The namespace of the image family. For image families of golden images use `vm-system`. For image families in the current project, set this as empty or use the current `namespace` value. |

### ImageGCSDestinationReference

Represents the GCS destination to which to import an image.

*Appears in:*
- [ImageDestinationReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagedestinationreference)

| Field | Description |
|---|---|
| `bucketName` *string* | The GCS Bucket name that holds this image. |

### ImageGCSSourceReference

Represents the GCS source from which to import an image.

*Appears in:*
- [ImageSourceReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagesourcereference)

| Field | Description |
|---|---|
| `bucketName` *string* | The GCS Bucket name that holds this image. |
| `objectName` *string* | The name of the image within the bucket. |

### ImageMetadataInput

The specification for the `VirtualMachineImage`.

*Appears in:*
- [VirtualMachineImageImportSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportspec)

| Field | Description |
|---|---|
| `name` *string* | The image name, such as `ubuntu-20.04-server-cloudimg`. |
| `operatingSystem` *[OSName](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#osname)* | The name of the OS to which this image belongs, such as `ubuntu-2004`. |
| `minimumDiskSize` *Quantity* | The minimum size of the disk to which the image can be applied. This specifies only the recommended size for future disks that are created from this image. It does not represent the size of the image itself. This field is required if the image is being imported from object storage. |
| `family` *string* | Refers to the specific family that a particular image belongs to. |

### ImageObjectStorageSourceReference

Represents the object storage source from which to import an image.

*Appears in:*
- [ImageSourceReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagesourcereference)

| Field | Description |
|---|---|
| `bucketRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | The name of the `Bucket` custom resource that holds this image. The `Bucket` custom resource must be in the same namespace as this object. |
| `objectName` *string* | The name of the image within the bucket. |

### ImagePrepareOptions

Represents the options for image preparation.

*Appears in:*
- [VirtualMachineImageImportSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportspec)

| Field | Description |
|---|---|
| `installGuestEnvironment` *boolean* | Specifies whether to install the GDC air-gapped guest environment. Defaults to `true`. |

### ImageSourceReference

Points to the resource from which the image contents are populated.
Only one source can be specified.

*Appears in:*
- [VirtualMachineImageImportSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportspec)

| Field | Description |
|---|---|
| `diskRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | Specified when the image is populated from an existing `VirtualMachineDisk`. |
| `objectStorage` *[ImageObjectStorageSourceReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imageobjectstoragesourcereference)* | The bucket details for an image that is populated from object storage. |
| `gcs` *[ImageGCSSourceReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagegcssourcereference)* | The bucket details for an image that is populated from gcs. |

### NetworkInterfaceSpec

Specifies the network interface configuration.
In GDC connected, only Network and IPAddresses can be specified.
In GDC airgapped, one of Network, Subnet, or IPAddresses must be specified. Subnet and IPAddresses can optionally be specified together.

*Appears in:*
- [NetworkSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkspec)

| Field | Description |
|---|---|
| `network` *string* | The network that the interface is connected to. In GDC airgapped, valid values are: `default`, `multicast`. |
| `subnet` *string* | The subnet that the interface is connected to in GDC airgapped. Unused in GDC connected. If unspecified, defaults to the default subnet of the specified network. |
| `subnetNamespace` *string* | The namespace that the Subnet the interface is connected to in GDC airgapped. Unused in GDC connected. If unspecified, defaults to the same namespace as the VirtualMachine. |
| `ipAddresses` *[IPAddress](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#ipaddress) array* | The IP address to be assigned to the interface. Only the first IP address is assigned to the interface. In GDC airgapped, an IP address will be dynamically allocated if unspecified. In GDC connected, if the network is configured to use an external DHCP server, this field can optionally be used to specify a static address. If the network is not configured to use an external DHCP server, this field is required. |

### NetworkInterfaceStatus

NetworkInterfaceStatus is the status for the NetworkInterface resource.

*Appears in:*
- [NetworkStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkstatus)

| Field | Description |
|---|---|
| `name` *string* | Name denotes the name of the network interface exposed inside the VM, e.g. "eth0", "eth1". |
| `ipAddresses` *string array* | IpAddresses are the IP addresses assigned to the NetworkInterface. |
| `macAddress` *string* | MacAddress is the MAC address assigned to the NetworkInterface. |
| `subnet` *[SubnetReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#subnetreference)* | Subnet is the Subnet assigned to the NetworkInterface. |

### NetworkPerformanceTier

*Underlying type:* `string`

*Appears in:*
- [NetworkSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkspec)

### NetworkSpec

Specifies the network configuration.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `interfaces` *[NetworkInterfaceSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkinterfacespec) array* | The network interfaces attached to the VM. If no unicast interfaces are specified, a `default` interface is automatically added. Users in a multicast-enabled organization can add the `multicast` interface. The first interface specified will be treated as the default interface when setting up the default route inside the VM. |
| `networkPerformanceTier` *[NetworkPerformanceTier](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkperformancetier)* | Specifies the configuration tier for networking performance on all interfaces in the VM in GDC airgapped. Unused in GDC connected. |

### NetworkStatus

NetworkStatus is the status for the network of the Virtual Machine.

*Appears in:*
- [VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)

| Field | Description |
|---|---|
| `interfaces` *[NetworkInterfaceStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkinterfacestatus) array* |   |

### OSName

*Underlying type:* `string`
The list of valid OSes for use.

*Appears in:*
- [ImageMetadataInput](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagemetadatainput)
- [OperatingSystemSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#operatingsystemspec)

### OperatingSystemSpec

Contains the operating system information of an image.

*Appears in:*
- [VirtualMachineImageSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimagespec)

| Field | Description |
|---|---|
| `name` *[OSName](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#osname)* | The name of the OS to which this image belongs, e.g. "windows-2016". |

### ReplicatedDiskInfo

*Appears in:*
- [DiskReplicationStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#diskreplicationstatus)

| Field | Description |
|---|---|
| `name` *string* | The name of the `VirtualMachineDisk` instance. |
| `zone` *string* | The zone of the `VirtualMachineDisk` instance. |

### SSHSpec

Stores the ssh credentials used to establish the connection.

*Appears in:*
- [VirtualMachineAccessRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequestspec)

| Field | Description |
|---|---|
| `key` *string* | Specifies the public key to program for SSH access. |
| `ttl` *[Duration](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#duration-v1-meta)* | Specifies the length of time for which this key is valid, expressed in hours, minutes and seconds. The default value is `24h0m0s`. |

### ServicePort

ServicePort contains information on service's port.

*Appears in:*
- [VirtualMachineExternalAccessSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccessspec)

| Field | Description |
|---|---|
| `name` *string* | The name of this port within the service. |
| `protocol` *[Protocol](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#protocol-v1-core)* | The IP protocol for this port. Supports "TCP", "UDP", and "SCTP". |
| `port` *integer* | The port that will be exposed by this service. |

### ShieldConfig

Specifies the VM's security-related configurations.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `bootType` *string* | Specifies whether to boot via UEFI or BIOS. Defaults to `bios`. |
| `enableSecureBoot` *boolean* | Enables or disables boot loader certificate verification. This is to assist in blocking modified or malicious code from loading. The default value is `true` if `bootType` is `uefi`. If `bootType` is set to `bios`, the default value is `false` and cannot be modified since boot loader certificate verification is not available for BIOS. |
| `enableVtpm` *boolean* | Whether to emulate a VTPM device. Defaults to `false`. |

### StartupScript

Defines a startup script for a VM.
Supports the specification of a startup script either as a plain text string
or a Kubernetes secret. If the field `script` is specified, then the field
`scriptSecretRef` should not be provided, and vice versa.

*Appears in:*
- [VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)

| Field | Description |
|---|---|
| `name` *string* | Specifies the name of a script. Must match the regex `[\w][\w\-.]*` and be at most 255 characters. If specifying a script for a Windows VM, the name must include a '-' followed by the script extension as a suffix. For example, use the name `hello-world-ps1` for a Powershell script named `hello-world`. |
| `script` *string* | Specifies a plain text string that contains the script. The script content size must be lesser than 2048 bytes. |
| `scriptSecretRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | `ScriptSecretRef` references a secret resource that contains the startup script. When this StartupScript is defined within a VirtualMachine, `ScriptSecretRef` must refer to a zonal Kubernetes `Secret` in the same namespace. When defined within a VirtualMachineTemplate, `ScriptSecretRef` must refer to a global Kubernetes `Secret` in the same namespace. The name specified in `ScriptSecretRef` must exactly match the name of the referenced `Secret` resource. |

### SubnetReference

*Appears in:*
- [NetworkInterfaceStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkinterfacestatus)

| Field | Description |
|---|---|
| `name` *string* | Name is the name of the Subnet. |
| `namespace` *string* | Namespace is the namespace of the Subnet. |

### VMMError

Wrapper for all VMM errors, including error codes.

*Appears in:*
- [VirtualMachineAccessRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequeststatus)
- [VirtualMachineDiskStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskstatus)
- [VirtualMachineExternalAccessStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccessstatus)
- [VirtualMachineImageImportStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportstatus)
- [VirtualMachineImageStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimagestatus)
- [VirtualMachinePasswordResetRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequeststatus)
- [VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)

| Field | Description |
|---|---|
| `code` *string* | The code for the error. It includes a prefix with letters followed by a four-digit numeric code. |
| `message` *string* | The human-readable error message. |

### VirtualMachine

Represents the Virtual Machine's configuration and state.

*Appears in:*
- [VirtualMachineList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinelist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachine` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinespec)* |   |
| `status` *[VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)* |   |

### VirtualMachineAccessRequest

Represents an access request to a VM.

*Appears in:*
- [VirtualMachineAccessRequestList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequestlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineAccessRequest` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineAccessRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequestspec)* |   |
| `status` *[VirtualMachineAccessRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequeststatus)* |   |

### VirtualMachineAccessRequestList

Contains a list of VirtualMachineAccessRequest objects.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineAccessRequestList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineAccessRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequest) array* |   |

### VirtualMachineAccessRequestSpec

Defines the `VirtualMachineAccessRequest` specification.

*Appears in:*
- [VirtualMachineAccessRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequest)

| Field | Description |
|---|---|
| `vm` *string* | Specifies the name of the VM to access. |
| `user` *string* | Specifies the username for accessing the VM. |
| `ssh` *[SSHSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#sshspec)* | Holds the ssh credentials used to access the VM. |

### VirtualMachineAccessRequestState

*Underlying type:* `string`
State of `VirtualMachineAccessRequest`.

*Appears in:*
- [VirtualMachineAccessRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequeststatus)

### VirtualMachineAccessRequestStatus

Describes the status of the VirtualMachineAccessRequest.

*Appears in:*
- [VirtualMachineAccessRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequest)

| Field | Description |
|---|---|
| `state` *[VirtualMachineAccessRequestState](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineaccessrequeststate)* | Specifies the state of `VirtualMachineAccessRequest`. |
| `reason` *string* | Indicates the reason for the current status. |
| `message` *string* | Provides additional context for the current status. |
| `processedAt` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | Specifies the time when the request was processed. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Details of observed state. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |

### VirtualMachineAttachedDiskPhase

*Underlying type:* `string`
VirtualMachineAttachedDiskPhase represents the current phase of the
process of attachment of the disk to the VM.
Provided only for hotpluggable disks for now, but in the future may
potentially also be provided for non-hotpluggable disks.

*Appears in:*
- [VirtualMachineAttachedDiskStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineattacheddiskstatus)

### VirtualMachineAttachedDiskStatus

VirtualMachineAttachedDiskStatus holds the observed status of a disk
attached to a VirtualMachine.

*Appears in:*
- [VirtualMachineAttachedDisksInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineattacheddisksinfo)

| Field | Description |
|---|---|
| `name` *string* | Name refers to the name of the disk as defined in the VirtualMachineSpec.Disks\[\*\].VirtualMachineDiskRef.Name. |
| `hotpluggable` *boolean* | Hotpluggable reflects the disk attachment's underlying capability type as part of the status. A 'true' value indicates this is a hotplug attachment, which supports the disk being added to and removed from the VM while it is running. A 'false' or absent value indicates this is a coldplug attachment, which means the disk was attached at boot and requires the VM to be stopped for disk removal. |
| `phase` *[VirtualMachineAttachedDiskPhase](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineattacheddiskphase)* | Phase represents the current phase of the process of attachment of the disk to the VM. Provided only for hotpluggable disks for now, but in the future may potentially also be provided for non-hotpluggable disks. |
| `reason` *string* | Reason provides a brief description for the current disk attachment phase. Provided only for hotpluggable disks for now, but in the future may potentially also be provided for non-hotpluggable disks. |
| `message` *string* | Message provides a more detailed message about the current disk attachment phase. Provided only for hotpluggable disks for now, but in the future may potentially also be provided for non-hotpluggable disks. |

### VirtualMachineAttachedDisksInfo

*Appears in:*
- [VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)

| Field | Description |
|---|---|
| `attachments` *[VirtualMachineAttachedDiskStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineattacheddiskstatus) array* | Attachments provides status of disks attached to the VirtualMachine. Provided only for hotpluggable disks for now, but in the future may potentially also be provided for non-hotpluggable disks. |

### VirtualMachineAttachment

Contains information about which `VirtualMachine` this `VirtualMachineDisk` is
attached to, and how it is attached.

*Appears in:*
- [VirtualMachineDiskStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskstatus)

| Field | Description |
|---|---|
| `nameRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | The name of an attached `VirtualMachine`. |
| `uid` *UID* | The UID of the attached `VirtualMachine`. |
| `autoDelete` *boolean* | Reflective of how the `VirtualMachine` attaches this disk. The disk is deleted when all VMs attached have `autoDelete` set to `true` and all VMs are deleted. If a minimum of one VM has `autoDelete` set to `false`, the disk will not be deleted. |

### VirtualMachineBackup

The Schema for the VirtualMachineBackups API.

*Appears in:*
- [VirtualMachineBackupList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuplist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackup` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineBackupSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupspec)* |   |
| `status` *[VirtualMachineBackupStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupstatus)* |   |

### VirtualMachineBackupConfig

Contains configuration details for executing the backup, including scope, location,
and volume backup strategy.

*Appears in:*
- [VirtualMachineBackupPlanSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplanspec)
- [VirtualMachineBackupSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupspec)

| Field | Description |
|---|---|
| `backupRepository` *string* | Identifies the secondary storage location for this `VirtualMachineBackupPlan`. This field is meant for internal use only. Provide Backup repository only through VirtualMachineBackupPlanTemplate |
| `backupScope` *[VirtualMachineBackupScope](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupscope)* | Specifies the resource(s) covered by this `VirtualMachineBackupPlan`. |
| `volumeStrategy` *VolumeStrategy* | Declares the strategy to use for backing-up volumes; for example, use a local snapshot vs. using remote or provisioner-specific backup. |

### VirtualMachineBackupList

Contains a list of VirtualMachineBackup.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineBackup](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackup) array* |   |

### VirtualMachineBackupPlan

The Schema for the VirtualMachineBackupPlans API.

*Appears in:*
- [VirtualMachineBackupPlanList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplanlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupPlan` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineBackupPlanSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplanspec)* |   |
| `status` *[VirtualMachineBackupPlanStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplanstatus)* |   |

### VirtualMachineBackupPlanList

Contains a list of VirtualMachineBackupPlan.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupPlanList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineBackupPlan](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplan) array* |   |

### VirtualMachineBackupPlanSpec

Defines a `VirtualMachineBackupPlan` which provides instructions for creating an
underlying `BackupPlan` resource and `ProtectedApplication` to perform backups.

*Appears in:*
- [VirtualMachineBackupPlan](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplan)

| Field | Description |
|---|---|
| `virtualMachineBackupPlanTemplate` *string* | The `VirtualMachineBackupPlanTemplate` must live in the same `namespace` as this vm backup plan. |
| `backupConfig` *[VirtualMachineBackupConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupconfig)* | Defines the configuration and scope of the backup. |
| `backupSchedule` *Schedule* | The scheduled backup creation under this VM backup plan. Schedule is a mutable field which can be edited after creation By default, VM backup plan will be paused |
| `retentionPolicy` *RetentionPolicy* | The lifecycle of backups created under this plan. By default, backups can be deleted without any locking period. Backups are automatically deleted after 35 days by default, and this retention policy can be modified. |
| `deactivated` *boolean* | Specifies whether the plan has been deactivated. Setting this field to 'true' locks the plan meaning no further updates are allowed, including changes to the deactivated field. It also prevents new backups from being created under this plan, both manually or scheduled. Default to 'false'. |

### VirtualMachineBackupPlanStatus

Defines the observed state of `VirtualMachineBackupPlan`.

*Appears in:*
- [VirtualMachineBackupPlan](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplan)

| Field | Description |
|---|---|
| `backupPlan` *string* | The name of the underlying backup plan managed by this `VirtualMachineBackupPlan`, used in GDC air-gapped Org v1 Architecture. |
| `backupPlanStatus` *BackupPlanStatus* | The embedded status of the underlying backup plan. |
| `configBackupPlan` *string* | The name of the underlying config backup plan managed by this `VirtualMachineBackupPlan`. Config here refers to VM and VM Disk, used in GDC air-gapped Org v2 Architecture. |
| `volumeBackupPlan` *string* | The name of the underlying volume backup plan managed by this `VirtualMachineBackupPlan`, used in GDC air-gapped Org v2 Architecture. |
| `lastBackupTime` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | The timestamp for the most recently executed backup. This field is used to schedule next backup |
| `nextBackupTime` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | The timestamp for the next scheduled backup. This field is used to schedule next backup |
| `lastReconcileTime` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | The timestamp of last reconciliation of this resource. |
| `errorMessage` *string* | ErrorMessage holds the error message that occurred during the last reconciliation attempt. This field is optional and will only be populated if an error occurred. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Conditions represents the observations of this VM backup plan's current state. Known condition types: Ready |

### VirtualMachineBackupPlanTemplate

The `VirtualMachineBackupPlanTemplates` API schema.

*Appears in:*
- [VirtualMachineBackupPlanTemplateList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplantemplatelist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupPlanTemplate` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineBackupPlanTemplateSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplantemplatespec)* |   |
| `status` *[VirtualMachineBackupPlanTemplateStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplantemplatestatus)* |   |

### VirtualMachineBackupPlanTemplateList

Contains a list of VirtualMachineBackupPlanTemplate.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupPlanTemplateList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineBackupPlanTemplate](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplantemplate) array* |   |

### VirtualMachineBackupPlanTemplateSpec

Defines the template that the `VirtualMachineBackupPlans` use for deriving common parameters.

*Appears in:*
- [VirtualMachineBackupPlanTemplate](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupplantemplate)

| Field | Description |
|---|---|
| `backupRepository` *string* | The name of a `BackupRepository` resource. |

### VirtualMachineBackupRequest

The Schema for the VirtualMachineBackupRequests API.

*Appears in:*
- [VirtualMachineBackupRequestList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuprequestlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupRequest` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineBackupRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuprequestspec)* |   |
| `status` *[VirtualMachineBackupRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuprequeststatus)* |   |

### VirtualMachineBackupRequestList

Contains a list of VirtualMachineBackupRequest.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineBackupRequestList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineBackupRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuprequest) array* |   |

### VirtualMachineBackupRequestSpec

Defines the desired state of `VirtualMachineBackupRequest`.

*Appears in:*
- [VirtualMachineBackupRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuprequest)

| Field | Description |
|---|---|
| `virtualMachineBackupPlanTemplate` *string* | The name of the `VirtualMachineBackupPlanTemplate` resource used to generate a `VirtualMachineBackupPlan`. Re-uses the pre-existing `VirtualMachineBackupPlan` made from this template, if there is one. The `VirtualMachineBackupPlanTemplate` must live in the same `namespace` as this request. Specify **only one** of either `VirtualMachineBackupPlanTemplate` OR `VirtualMachineBackupPlan`. |
| `virtualMachineBackupPlan` *string* | The virtual machine backup plan which this request uses for adhoc request with backup scope VirtualMachine and VirtualMachineDisk fields should be omitted when this field is provided The `VirtualMachineBackupPlan` must live in the same `namespace` as this request. |
| `virtualMachine` *string* | The `VirtualMachine` that is being backed up. This is used with the `VirtualMachineBackupPlanTemplate` to automatically generate a `VirtualMachineBackupPlan` if one does not exist. Specify **only one** of either `VirtualMachine` OR `VirtualMachineDisk`. When `virtualMachine` is specified, the backup strategy is always `ProvisionerSpecific`. |
| `virtualMachineDisk` *string* | The `VirtualMachineDisk` being backed-up. This is used with `VirtualMachineBackupPlanTemplate` to automatically generate a `VirtualMachineBackupPlan` if one does not exist. When `virtualMachineDisk` is specified to be backed-up, the backup strategy is `SnapshotOnly`. Specify **only one** of either `VirtualMachine` OR `VirtualMachineDisk`. |
| `virtualMachineBackupName` *string* | The name of the `VirtualMachineBackup` to be created. The backup is always created in the same namespace as the request. |
| `deleteLockDays` *integer* | Optional. The number of days from the creation of this backup during which backup deletion is blocked. The value must not exceed 90 days, and must be less than or equal to `retainDays`. If set to `0`, deletion is not blocked. If omitted, this value falls back to the associated backup plan's configuration. |
| `retainDays` *integer* | Optional. The number of days to keep this backup for, after which it is automatically deleted. The value must not exceed 90 days. If set to `0`, the backup is not automatically deleted. If omitted, this value falls back to the associated backup plan's configuration. Setting this value too high can lead to storage exhaustion, while setting it too low can increase the risk of data loss. |

### VirtualMachineBackupRequestStatus

Defines the observed state of VirtualMachineBackupRequest.

*Appears in:*
- [VirtualMachineBackupRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackuprequest)

| Field | Description |
|---|---|
| `timeToExpire` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | When this ephemeral resource will be deleted. |
| `statusField` *StatusFields* | Describes the observed state of the VirtualMachineBackupRequest |

### VirtualMachineBackupScope

Defines the scope of resources for the `VirtualMachineBackupPlan` to capture.

*Appears in:*
- [VirtualMachineBackupConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupconfig)

| Field | Description |
|---|---|
| `selectedVirtualMachines` *[VirtualMachineResourceConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineresourceconfig) array* | Specifies the VMs for the `VirtualMachineBackupPlan` to capture. |
| `selectedVirtualMachineDisks` *[VirtualMachineResourceConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineresourceconfig) array* | Specifies the disks for this `VirtualMachineBackupPlan` to capture. |
| `vmResourceLabelSelector` *object (keys:string, values:string)* | Specifies the label(s) selecting one/multiple VM or VM disk resources in same namespace as backup plan |

### VirtualMachineBackupSpec

Defines the desired state of `VirtualMachineBackup`.

*Appears in:*
- [VirtualMachineBackup](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackup)

| Field | Description |
|---|---|
| `virtualMachineBackupPlan` *string* | The name of the `VirtualMachineBackupPlan` from which this `VirtualMachineBackup` was created. This `VirtualMachineBackupPlan` exists in the same `namespace` as the `VirtualMachineBackupPlan`. |
| `backupConfig` *[VirtualMachineBackupConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupconfig)* | Defines the configuration and scope of the backup. |
| `retentionPolicy` *[VirtualMachineRetentionPolicy](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineretentionpolicy)* | Optional. Defines the retention policy settings for the backup. |

### VirtualMachineRetentionPolicy

Defines the retention policy settings for the backup.

*Appears in:*
- [VirtualMachineBackupSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupspec)

| Field | Description |
|---|---|
| `deleteLockDays` *integer* | Optional. The number of days from the creation of this backup during which backup deletion is blocked. The value must not exceed 90 days. If set to `0`, deletion is not blocked. |
| `retainDays` *integer* | Optional. The number of days to keep this backup for, after which it is automatically deleted. The value must not exceed 90 days. If set to `0`, the backup is not automatically deleted. |

### VirtualMachineBackupStatus

Defines the observed state of a `VirtualMachineBackup`.

*Appears in:*
- [VirtualMachineBackup](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackup)

| Field | Description |
|---|---|
| `backup` *string* | The name of the underlying backup which this `VirtualMachineBackup` references. The backup must be in the same `namespace` as this VM backup, used in GDC air-gapped Org v1 Architecture. |
| `backupStatus` *[BackupStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#backupstatus)* | The status of the underlying backup(s) which this `VirtualMachineBackup` references, used in GDC air-gapped Org v1 Architecture. |
| `configBackup` *string* | The name of the underlying Config Backup which this `VirtualMachineBackup` references. Config refers to VM and VM Disk. The config backup must be in the same `namespace` as this VM backup, used in GDC air-gapped Org v2 Architecture. |
| `configBackupStatus` *[BackupStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#backupstatus)* | The status of the underlying config backup which this `VirtualMachineBackup` references, used in GDC air-gapped Org v2 Architecture. |
| `volumeBackup` *string* | The name of the underlying Volume Backup which this `VirtualMachineBackup` references. The volume backup must be in the same `namespace` as this VM backup, used in GDC air-gapped Org v2 Architecture. |
| `volumeBackupStatus` *[BackupStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#backupstatus)* | The status of the underlying volume backup which this `VirtualMachineBackup` references, used in GDC air-gapped Org v2 Architecture. |
| `backedUpVirtualMachines` *string array* | Lists the names of all VMs that are included in this backup. |
| `backedUpVirtualMachineDisks` *string array* | Lists the names of all the VM disks that are included in this backup. If this backup is a disk snapshot, this is a list of VM disks that you provide. If this is a VM backup, it is the list of the disks which back that VM. |
| `successfulVMBackupJobs` *integer* | Count of successful VMBackupJobs it represents the number of VM Resources that have been successfully backed up. This will be populated once the backup ends |
| `failedVMBackupJobs` *integer* | Count of failed VMBackupJobs it represents the number of VM Resources that have failed to be backed up. This will be populated once the backup ends |
| `successfulVirtualMachines` *string array* | Lists the names of VMs that were successfully backed up. |
| `failedVirtualMachines` *string array* | Lists the names of VMs that failed to be backed up. |
| `successfulVirtualMachineDisks` *string array* | Lists the names of VM disks that were successfully backed up. |
| `failedVirtualMachineDisks` *string array* | Lists the names of VM disks that failed to be backed up. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Conditions represents the observations of this VM backup's current state. Known condition types: Succeeded |

### VirtualMachineDeleteBackupRequest

The Schema for the `VirtualMachineDeleteBackupRequests` API.

*Appears in:*
- [VirtualMachineDeleteBackupRequestList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedeletebackuprequestlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineDeleteBackupRequest` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineDeleteBackupRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedeletebackuprequestspec)* |   |
| `status` *[VirtualMachineDeleteBackupRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedeletebackuprequeststatus)* |   |

### VirtualMachineDeleteBackupRequestList

Contains a list of `VirtualMachineDeleteBackupRequest`.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineDeleteBackupRequestList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineDeleteBackupRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedeletebackuprequest) array* |   |

### VirtualMachineDeleteBackupRequestSpec

Defines the desired state of `VirtualMachineDeleteBackupRequest`.

*Appears in:*
- [VirtualMachineDeleteBackupRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedeletebackuprequest)

| Field | Description |
|---|---|
| `virtualMachineBackupRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | The name of the `VirtualMachineBackup` to delete. This request is always created in the same `namespace` as the backup. |
| `targetedVMBackupJobNames` *string array* | The set of VMBackupJob Names that need to be deleted. This can be used when entire VM Backup is not required to be deleted but only subset of backups of VMs need to be deleted. List of VMBackupJob CRs for a given VM Backup can be searched using the label {"backup.gdc.goog/backup-name": + "-vb"} All the targeted VMBackupJobs should be part of the same referenced VirtualMachineBackup. If the list is empty, all the VMBackupJobs associated with the given VirtualMachineBackup will be deleted. Once a subset of VM Backups are deleted, complete restore of the VM Backup will not include those VMs. |

### VirtualMachineDeleteBackupRequestStatus

Defines the observed state of `VirtualMachineDeleteBackupRequest`.

*Appears in:*
- [VirtualMachineDeleteBackupRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedeletebackuprequest)

| Field | Description |
|---|---|
| `timeToExpire` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | Defines the time to delete this ephemeral resource. |
| `statusField` *StatusFields* | Describes the observed state of the `VirtualMachineDeleteBackupRequest`. |

### VirtualMachineDisk

Schema for the virtualmachinedisks API.

*Appears in:*
- [VirtualMachineDiskList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedisklist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineDisk` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineDiskSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskspec)* |   |
| `status` *[VirtualMachineDiskStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinediskstatus)* |   |

### VirtualMachineDiskFilterOptions

Specifies the filter options for restoring disks.

*Appears in:*
- [FilterSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#filterspec)

| Field | Description |
|---|---|
| `allDisks` *boolean* | Specifies that all disks from VirtualMachineBackup needs to be restored. |

### VirtualMachineDiskList

Contains a list of VirtualMachineDisk.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineDiskList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineDisk](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedisk) array* |   |

### VirtualMachineDiskSpec

Defines the desired state of `VirtualMachineDisk`.

*Appears in:*
- [VirtualMachineDisk](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedisk)

| Field | Description |
|---|---|
| `source` *[DiskSource](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#disksource)* | Specifies the source from which the disk contents are populated. If this field is omitted a blank disk gets provisioned. |
| `size` *Quantity* | Specifies the size of the disk: 5GiB, 600MiB, and so on. Size must be specified for a blank disk. For disks from other sources, the size depends on the source. For image source, the size is optional and is inferred as being equivalent to `Image.spec.minimumDiskSize`. If the size is specified it has to be greater than the `Image.spec.minimumDiskSize`. |
| `type` *DiskType* | Specifies the type of the disk. Defaults to `Standard`. In GDC air-gapped, supported types are: `Standard`, `Local`, `Performance`. In GDC connected, supported types are: `Standard`. |

### VirtualMachineDiskStatus

Defines the observed state of VirtualMachineDisk.

*Appears in:*
- [VirtualMachineDisk](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinedisk)

| Field | Description |
|---|---|
| `phase` *VirtualMachineDiskPhase* | The current phase of the Disk. |
| `progress` *VirtualMachineDiskProgress* | Progress is the current progress of the Disk provision. Value is between 0 and 100 inclusive, N/A if not available. |
| `size` *Quantity* | The current size of the disk. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The latest observations of the `VirtualMachineDisk` state. |
| `virtualMachineAttachments` *[VirtualMachineAttachment](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineattachment) array* | The list of `VirtualMachine` instances to which the `VirtualMachineDisk` is attached. |
| `replicationStatus` *[DiskReplicationStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#diskreplicationstatus)* | The status of disk replication. |
| `provisionTime` *[Duration](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#duration-v1-meta)* | The time taken to provision the `VirtualMachineDisk` and to reach a `Ready` state. The time taken to provision the `VirtualMachineDisk` and to reach a `Ready` state. For example, this is the time spent downloading an image, and so on. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |

### VirtualMachineExternalAccess

Represents the request of accessing the external
VRF for a VirtualMachine.

*Appears in:*
- [VirtualMachineExternalAccessList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccesslist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineExternalAccess` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineExternalAccessSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccessspec)* |   |
| `status` *[VirtualMachineExternalAccessStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccessstatus)* |   |

### VirtualMachineExternalAccessList

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineExternalAccessList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineExternalAccess](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccess) array* |   |

### VirtualMachineExternalAccessSpec

Defines the specification of the `VirtualMachineExternalAccess` object.

*Appears in:*
- [VirtualMachineExternalAccess](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccess)

| Field | Description |
|---|---|
| `enabled` *boolean* | Specifies whether the external vrf is accessible for the VirtualMachine. |
| `ports` *[ServicePort](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#serviceport) array* | The list of ports that are exposed by the VirtualMachine ingress service. |

### VirtualMachineExternalAccessStatus

Defines the observed state of the `VirtualMachineExternalAccess` object.

*Appears in:*
- [VirtualMachineExternalAccess](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineexternalaccess)

| Field | Description |
|---|---|
| `ingressIP` *string* | IngressIP specifies the IP address on the VirtualMachine ingress service. |
| `egressIP` *string* | EgressIP specifies the IP address on the egress NAT which is used by the VirtualMachine. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Details of observed state. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |

### VirtualMachineImage

Represents the disk image that can be used on virtual machine.

*Appears in:*
- [VirtualMachineImageList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimagelist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineImage` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineImageSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimagespec)* |   |
| `status` *[VirtualMachineImageStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimagestatus)* |   |

### VirtualMachineImageImport

Represents the operation to import and convert
VM resources that contain data; for example, to import and convert
'VirtualMachineDisk`into a`VirtualMachineImage\`.

*Appears in:*
- [VirtualMachineImageImportList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineImageImport` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineImageImportSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportspec)* |   |
| `status` *[VirtualMachineImageImportStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimportstatus)* |   |

### VirtualMachineImageImportList

A list of `VirtualMachineImageImport` objects.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineImageImportList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineImageImport](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimport) array* |   |

### VirtualMachineImageImportSpec

Specifies the source and metadata for the image
that you want to create.

*Appears in:*
- [VirtualMachineImageImport](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimport)

| Field | Description |
|---|---|
| `source` *[ImageSourceReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagesourcereference)* | Refers to the resource from which contents are imported. The source must be from the same namespace. |
| `destination` *[ImageDestinationReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagedestinationreference)* | Refers to the resource to which contents are imported. Only supported in GDC Connected deployments. This field is required if the specified `ImageSourceReference` is `GCS`. |
| `imageMetadata` *[ImageMetadataInput](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imagemetadatainput)* | Specifies the properties of the `VirtualMachineImage` you want to create. |
| `prepareImage` *boolean* | Specifies whether to prepare this image for a GDC air-gapped deployment with a value to, for example, install the required packages. If this is not specified, preparation occurs only if the image is from object storage. |
| `prepareOptions` *[ImagePrepareOptions](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#imageprepareoptions)* | These are the options for image preparation. This is only valid when `prepareImage` is `true`. |

### VirtualMachineImageImportStatus

Provides the image import status.

*Appears in:*
- [VirtualMachineImageImport](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimageimport)

| Field | Description |
|---|---|
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Provide the `Ready` status of the import progress. |
| `imageName` *string* | Refers to the `VirtualMachineImage` once successfully created. The image is in the same namespace as the image import. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |

### VirtualMachineImageList

Contains a list of `VirtualMachineImage` objects.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineImageList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineImage](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimage) array* |   |

### VirtualMachineImageSpec

Defines the specification of the virtual machine image.

*Appears in:*
- [VirtualMachineImage](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimage)

| Field | Description |
|---|---|
| `operatingSystem` *[OperatingSystemSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#operatingsystemspec)* | The details of the OS. |
| `minimumDiskSize` *Quantity* | The minimum size of the disk the image can be applied to. This specifies only the recommended size for the future disks that are created from this image. It does not represent the size of the Image itself. |
| `gcs` *[GCSReference](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#gcsreference)* | Refers to the GCS resource from which image are stored. |
| `family` *string* | Refers to the specific family that a particular image belongs to. |
| `buildTime` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | The timestamp when the virtual machine image build process was initiated. |

### VirtualMachineImageStatus

Contains the observed state of the `VirtualMachineImage` object.

*Appears in:*
- [VirtualMachineImage](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineimage)

| Field | Description |
|---|---|
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | The conditions of the virtual machine image. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |
| `storageLocation` *string* | The zone where this virtual machine image is stored. |

### VirtualMachineList

Contains a list of `VirtualMachine` objects.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachine](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachine) array* |   |

### VirtualMachinePasswordResetRequest

Represents a password reset request for a given VM.

*Appears in:*
- [VirtualMachinePasswordResetRequestList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequestlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachinePasswordResetRequest` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachinePasswordResetRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequestspec)* |   |
| `status` *[VirtualMachinePasswordResetRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequeststatus)* |   |

### VirtualMachinePasswordResetRequestList

Contains a list of `VirtualMachinePasswordResetRequest` resources.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachinePasswordResetRequestList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachinePasswordResetRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequest) array* |   |

### VirtualMachinePasswordResetRequestSpec

Defines the `VirtualMachinePasswordResetRequest` specification.

*Appears in:*
- [VirtualMachinePasswordResetRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequest)

| Field | Description |
|---|---|
| `vmName` *string* | The name of the VM to request a password reset. This field is immutable and cannot be updated after creating a password reset request. |
| `user` *string* | The name of the user to perform the password reset for a specified VM. This field is immutable and cannot be updated after creating a password reset request. |
| `publicKey` *string* | The public key to encrypt the new password for a VM. This field is immutable and cannot be updated after creating a password reset request. |

### VirtualMachinePasswordResetRequestState

*Underlying type:* `string`
Defines the state of a `VirtualMachinePasswordResetRequest` resource.

*Appears in:*
- [VirtualMachinePasswordResetRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequeststatus)

### VirtualMachinePasswordResetRequestStatus

Describes the status of the `VirtualMachinePasswordResetRequest` resource.

*Appears in:*
- [VirtualMachinePasswordResetRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequest)

| Field | Description |
|---|---|
| `state` *[VirtualMachinePasswordResetRequestState](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinepasswordresetrequeststate)* | The state of the `VirtualMachinePasswordResetRequest` resource. |
| `reason` *string* | The reason for the current status of the resource. |
| `message` *string* | A field that provides additional information for the current status. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Details of observed state. |
| `processedAt` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | A field that specifies the time when the request processed. |
| `encryptedPassword` *string* | The new password encrypted using the public key provided in the request and encoded using base64. To decrypt the password, use base64 to decode the string and decrypt the result using RSA decryption. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |

### VirtualMachineProvisionTime

Tracks the VirtualMachine provision time.

*Appears in:*
- [VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)

| Field | Description |
|---|---|
| `initProvisionTime` *[Duration](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#duration-v1-meta)* | Time taken for the first VM provision. i.e. Time taken from the object being created till the VM is in running status. |
| `lastProvisionTime` *[Duration](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#duration-v1-meta)* | Time taken for the most recent VM provision. It can be equal to InitProvisionTime if the VM is only being provisioned once. |

### VirtualMachineResourceConfig

Specifies a VM resource and additional parameters for backing up that resource.

*Appears in:*
- [FilterSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#filterspec)
- [VirtualMachineBackupScope](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinebackupscope)

| Field | Description |
|---|---|
| `resourceName` *string* | The name of the resource being backed up. It must exist in the same `namespace` as the plan. |

### VirtualMachineRestore

The Schema for the VirtualMachineRestores API.

*Appears in:*
- [VirtualMachineRestoreList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorelist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineRestore` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineRestoreSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorespec)* |   |
| `status` *[VirtualMachineRestoreStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorestatus)* |   |

### VirtualMachineRestoreList

Contains a list of VirtualMachineRestore.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineRestoreList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineRestore](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestore) array* |   |

### VirtualMachineRestoreRequest

The Schema for the VirtualMachineRestoreRequests API.

*Appears in:*
- [VirtualMachineRestoreRequestList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequestlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineRestoreRequest` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineRestoreRequestSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequestspec)* |   |
| `status` *[VirtualMachineRestoreRequestStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequeststatus)* |   |

### VirtualMachineRestoreRequestList

Contains a list of VirtualMachineRestoreRequest.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineRestoreRequestList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineRestoreRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequest) array* |   |

### VirtualMachineRestoreRequestSpec

Defines the desired state of `VirtualMachineRestoreRequest`.

*Appears in:*
- [VirtualMachineRestoreRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequest)

| Field | Description |
|---|---|
| `virtualMachineBackup` *string* | The name of the VM backup that to restore. The `VirtualMachineBackup` resides in the same `namespace` as does this `VirtualMachineRestoreRequest`. |
| `restoreName` *string* | The name given to the `VirtualMachineRestore` resource created. |
| `restoredResourceName` *string* | The prefix given to the resources which are restored by `VirtualMachineBackup`. The name of the restored resource would be the prefix + name of backed up resource. |
| `restoredResourceDescription` *string* | The description given to the newly created resource. |
| `filter` *[FilterSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#filterspec)* | The filters that can be used to refine the VM resource selection during the Restore. |
| `targetNamespace` *string* | The namespace where the VM will be restored, if not provided the original namespace from the backup will be used. Supported only for cluster node VMs restores. |

### VirtualMachineRestoreRequestStatus

Defines the observed state of `VirtualMachineRestoreRequest`.

*Appears in:*
- [VirtualMachineRestoreRequest](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestorerequest)

| Field | Description |
|---|---|
| `timeToExpire` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | When this ephemeral resource will be deleted. |
| `statusField` *StatusFields* | Describes the observed state of the `VirtualMachineRestoreRequest`. |

### VirtualMachineRestoreSpec

Defines the desired state of `VirtualMachineRestore`.

*Appears in:*
- [VirtualMachineRestore](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestore)

| Field | Description |
|---|---|
| `virtualMachineBackup` *string* | The name of the VM backup that this `VirtualMachineRestore` is restoring. The `VirtualMachineBackup` is in the same `namespace` as this `VirtualMachineRestore`. |
| `targetVirtualMachines` *string array* | The list of all VMs. created when the underlying restore is successful. |
| `targetVirtualMachineDisks` *string array* | The list of all VM disks. created when the underlying restore is successful. |

### VirtualMachineRestoreStatus

Defines the observed state of `VirtualMachineRestore`.

*Appears in:*
- [VirtualMachineRestore](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinerestore)

| Field | Description |
|---|---|
| `restore` *string* | The name of the underlying restore which this `VirtualMachineRestore` references. The restore must be in the same `namespace` as this VM backup, used in GDC air-gapped Org v1 Architecture. |
| `restoreStatus` *[RestoreStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#restorestatus)* | The status of the underlying restore which this `VirtualMachineRestore` references. Used in GDC air-gapped Org v1 Architecture. |
| `configRestore` *string* | The name of the underlying Config Restore which this `VirtualMachineRestore` references. Config refers to VM and VM Disk. The config restore must be in the same `namespace` as this VM Restore, used in GDC air-gapped Org v2 Architecture. |
| `configRestoreStatus` *[RestoreStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#restorestatus)* | The status of the underlying config restore which this `VirtualMachineRestore` references, used in GDC air-gapped Org v2 Architecture. |
| `volumeRestore` *string* | The name of the underlying Volume Restore which this `VirtualMachineRestore` references. The volume restore must be in the same `namespace` as this VM Restore, used in GDC air-gapped Org v2 Architecture. |
| `volumeRestoreStatus` *[RestoreStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#restorestatus)* | The status of the underlying volume restore which this `VirtualMachineRestore` references, used in GDC air-gapped Org v2 Architecture. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Conditions represents the observations of this VM Restore's current state. Known condition types: Succeeded |

### VirtualMachineSpec

Defines the specification of the Virtual Machine.

*Appears in:*
- [VirtualMachine](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachine)

| Field | Description |
|---|---|
| `runningState` *VirtualMachineRunningState* | Indicates the requested running state of the VirtualMachine. Defaults to Running. |
| `disks` *[DiskAttachment](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#diskattachment) array* | Specifies the list of disks attached to this vm. There must be exactly one boot disk. Changes to disk attachments require a reboot to take effect. |
| `compute` *[Compute](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#compute)* | Specifies the CPU and Memory of the VM. CPU and Memory can be defined directly or through the VirtualMachineType. Changes to Compute require a reboot to take effect. Compute is immutable when the VM is in `Unknown` state. |
| `confidentialInstanceConfig` *[ConfidentialInstanceConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#confidentialinstanceconfig)* | Specifies the configurations of the confidential VM. |
| `startupScripts` *[StartupScript](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#startupscript) array* | Specifies the list of startup scripts for the VM. Linux VMs must have `cloud-init` installed for `StartupScripts` to take effect. The scripts are executed in alphabetical order, based on the name of each startup script. In Windows VMs the type of script impacts the order of execution. Scripts are executed in the order ps1, bat, cmd. If two scripts are of the same type they are executed in alphabetical order, based on the name. |
| `guestEnvironment` *[GuestEnvironment](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#guestenvironment)* | Specifies the VM's guest environment configuration. If the field is nil the `enable` field in `AccessManagement` is `true` by default. Otherwise, the non-nil configuration for each sub-feature inside the structure overrides the default configuration of the sub-feature. |
| `firmware` *[Firmware](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#firmware)* | Specifies the VM initialization options at boot time. |
| `shieldConfig` *[ShieldConfig](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#shieldconfig)* | Specifies the VM's security-related configurations. |
| `network` *[NetworkSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkspec)* | Specifies the network configuration. |
| `templateRef` *[LocalObjectReference](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#localobjectreference-v1-core)* | TemplateRef specifies the `VirtualMachineTemplate` to use as a base for this VM and refers to a `VirtualMachineTemplate` in the same namespace. The properties defined in the template will be used to create the VM. If other fields in the `VirtualMachineSpec` are set directly when `TemplateRef` is set, the values specified in the `VirtualMachineSpec` will take precedence over the values sourced from the `TemplateRef`. |
| `gracefulShutdown` *[GracefulShutdown](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#gracefulshutdown)* | GracefulShutdown configures graceful shutdown for the VM. This section is mutable even after the VM is running. If not specified, default connectionDrainTimeoutSeconds of 60 seconds will be applied. |

### VirtualMachineStatus

Contains the observed state of the Virtual Machine.

*Appears in:*
- [VirtualMachine](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachine)

| Field | Description |
|---|---|
| `state` *VirtualMachineState* | Observed state of the VM. |
| `reason` *VirtualMachineStateReason* | Reason why the VM is in the observed state. Populated if applicable for the observed state. |
| `message` *string* | Additional details about the state of the VM. |
| `network` *[NetworkStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#networkstatus)* | Status of the VM networks. |
| `disks` *[VirtualMachineAttachedDisksInfo](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineattacheddisksinfo)* | Disks provides information about disks attached to the VirtualMachine. Provided only for hotpluggable disks for now, but in the future may potentially also be provided for non-hotpluggable disks. |
| `conditions` *[Condition](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#condition-v1-meta) array* | Details of observed state. |
| `stateTransitionTime` *object (keys:VirtualMachineState, values:[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta))* | Last transition time of each state. Deprecated: Use TransitionTime instead. |
| `transitionTime` *[VirtualMachineTransitionTime](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetransitiontime) array* | Last transition time of each transition. |
| `provisionTime` *[VirtualMachineProvisionTime](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachineprovisiontime)* | Time taken to provision the VM. |
| `failureHistory` *[FailureHistory](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#failurehistory)* | FailureHistory tracks recent VM failures. |
| `errors` *[VMMError](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#vmmerror) array* | A list of any errors that occurred during the reconciliation of this resource. |

### VirtualMachineTransitionTime

VirtualMachineTransitionTime represents a transition time with a key.

*Appears in:*
- [VirtualMachineStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinestatus)

| Field | Description |
|---|---|
| `transition` *VirtualMachineTransitionKey* | Transition is the transition key. |
| `time` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | Time is the last transition time. |

### VirtualMachineType

Defines the CPU and Memory resource of a VM.

*Appears in:*
- [VirtualMachineTypeList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetypelist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineType` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[VirtualMachineTypeSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetypespec)* |   |
| `status` *[VirtualMachineTypeStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetypestatus)* |   |

### VirtualMachineTypeList

VirtualMachineTypeList contains a list of VirtualMachineType.

| Field | Description |
|---|---|
| `apiVersion` *string* | `virtualmachine.gdc.goog/v1` |
| `kind` *string* | `VirtualMachineTypeList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[VirtualMachineType](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetype) array* |   |

### VirtualMachineTypeSpec

Defines the configurations of a `VirtualMachineType`.

*Appears in:*
- [VirtualMachineType](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetype)

| Field | Description |
|---|---|
| `vcpus` *integer* | Specifies the number of VCPUs that are available to the instance. Specify `vcpus` as an integer that is a multiple of 2, between 2 and 128, inclusive. |
| `memory` *Quantity* | Specifies the amount of physical memory available to the instance. `memory` must have a value that is between 1G and 400G, inclusive. |

### VirtualMachineTypeStatus

*Appears in:*
- [VirtualMachineType](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/virtualmachine/v1/virtualmachine-v1.md.txt#virtualmachinetype)

| Field | Description |
|---|---|
| `supported` *boolean* | Specifies if given vmtype is supported or not by the underlying hardware |