---
title: Compute Engine Machine Image
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Compute Engine Machine Image
---

# Compute Engine Machine Image

A Compute Engine Machine Image in Google Cloud is a resource that stores all the configuration, metadata, and disk data needed to create new virtual machine instances. It captures the full state of a VM, including attached disks and instance properties, allowing consistent replication, backup, and deployment of identical environments across projects or regions.

```
gcp.compute_machine_image
```

## Fields

| Title                       | ID   | Type          | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                           | Description |
| --------------------------- | ---- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                        | core | string        |
| ancestors                   | core | array<string> |
| creation_timestamp          | core | timestamp     | Output only. [Output Only] The creation timestamp for this machine image inRFC3339 text format.                                                                                                                                                                                                                                                                                                                                                     |
| datadog_display_name        | core | string        |
| description                 | core | string        | An optional description of this resource. Provide this property when you create the resource.                                                                                                                                                                                                                                                                                                                                                       |
| gcp_status                  | core | string        | [Output Only] The status of the machine image. One of the following values: INVALID, CREATING, READY, DELETING, and UPLOADING. Possible values: ['CREATING', 'DELETING', 'INVALID', 'READY', 'UPLOADING']. Values descriptions: ['', '', '', '', '']                                                                                                                                                                                                |
| guest_flush                 | core | bool          | [Input Only] Whether to attempt an application consistent machine image by informing the OS to prepare for the snapshot process.                                                                                                                                                                                                                                                                                                                    |
| id                          | core | string        | Output only. [Output Only] A unique identifier for this machine image. The server defines this identifier.                                                                                                                                                                                                                                                                                                                                          |
| instance_properties         | core | json          | [Output Only] Properties of source instance                                                                                                                                                                                                                                                                                                                                                                                                         |
| kind                        | core | string        | Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.                                                                                                                                                                                                                                                                                                                                                |
| labels                      | core | array<string> | Labels to apply to this machine image. These can be later modified by the setLabels method.                                                                                                                                                                                                                                                                                                                                                         |
| name                        | core | string        | Name of the resource; provided by the client when the resource is created. The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. |
| organization_id             | core | string        |
| parent                      | core | string        |
| project_id                  | core | string        |
| project_number              | core | string        |
| region_id                   | core | string        |
| resource_name               | core | string        |
| satisfies_pzi               | core | bool          | Output only. Reserved for future use.                                                                                                                                                                                                                                                                                                                                                                                                               |
| satisfies_pzs               | core | bool          | Output only. [Output Only] Reserved for future use.                                                                                                                                                                                                                                                                                                                                                                                                 |
| saved_disks                 | core | json          | Output only. An array of Machine Image specific properties for disks attached to the source instance                                                                                                                                                                                                                                                                                                                                                |
| self_link                   | core | string        | Output only. [Output Only] The URL for this machine image. The server defines this URL.                                                                                                                                                                                                                                                                                                                                                             |
| source_disk_encryption_keys | core | json          | [Input Only] Thecustomer-supplied encryption key of the disks attached to the source instance. Required if the source disk is protected by a customer-supplied encryption key.                                                                                                                                                                                                                                                                      |
| source_instance             | core | string        | The source instance used to create the machine image. You can provide this as a partial or full URL to the resource. For example, the following are valid values: - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance - projects/project/zones/zone/instances/instance                                                                                                                                           |
| source_instance_properties  | core | json          | Output only. [Output Only] DEPRECATED: Please use instance_properties instead for source instance related properties. New properties will not be added to this field.                                                                                                                                                                                                                                                                               |
| storage_locations           | core | array<string> | The regional or multi-regional Cloud Storage bucket location where themachine image is stored.                                                                                                                                                                                                                                                                                                                                                      |
| tags                        | core | hstore_csv    |
| total_storage_bytes         | core | int64         | Output only. [Output Only] Total size of the storage used by the machine image.                                                                                                                                                                                                                                                                                                                                                                     |
| zone_id                     | core | string        |
