blob: 33ad9dc772afe27e820a107fd0beea26a62fdfce [file] [log] [blame]
---
subcategory: "Compute Engine"
description: |-
Get information about a Google Compute Persistent disks.
---
# google\_compute\_disk
Get information about a Google Compute Persistent disks.
[the official documentation](https://cloud.google.com/compute/docs/disks) and its [API](https://cloud.google.com/compute/docs/reference/latest/disks).
## Example Usage
```hcl
data "google_compute_disk" "persistent-boot-disk" {
name = "persistent-boot-disk"
project = "example"
}
resource "google_compute_instance" "default" {
# ...
boot_disk {
source = data.google_compute_disk.persistent-boot-disk.self_link
auto_delete = false
}
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) The name of a specific disk.
- - -
* `zone` - (Optional) A reference to the zone where the disk resides.
* `project` - (Optional) The ID of the project in which the resource belongs.
If it is not provided, the provider project is used.
## Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
* `id` - an identifier for the resource with format `projects/{{project}}/zones/{{zone}}/disks/{{name}}`
* `label_fingerprint` -
The fingerprint used for optimistic locking of this resource. Used
internally during updates.
* `creation_timestamp` -
Creation timestamp in RFC3339 text format.
* `last_attach_timestamp` -
Last attach timestamp in RFC3339 text format.
* `last_detach_timestamp` -
Last detach timestamp in RFC3339 text format.
* `users` -
Links to the users of the disk (attached instances) in form:
project/zones/zone/instances/instance
* `source_image_id` -
The ID value of the image used to create this disk. This value
identifies the exact image that was used to create this persistent
disk. For example, if you created the persistent disk from an image
that was later deleted and recreated under the same name, the source
image ID would identify the exact version of the image that was used.
* `source_snapshot_id` -
The unique ID of the snapshot used to create this disk. This value
identifies the exact snapshot that was used to create this persistent
disk. For example, if you created the persistent disk from a snapshot
that was later deleted and recreated under the same name, the source
snapshot ID would identify the exact version of the snapshot that was
used.
* `description` -
The optional description of this resource.
* `labels` - All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Terraform, other clients and services.
* `size` -
Size of the persistent disk, specified in GB.
* `physical_block_size_bytes` -
Physical block size of the persistent disk, in bytes.
* `type` -
URL of the disk type resource describing which disk type to use to
create the disk.
* `image` -
The image from which to initialize this disk.
* `zone` -
A reference to the zone where the disk resides.
* `source_image_encryption_key` -
The customer-supplied encryption key of the source image.
* `snapshot` -
The source snapshot used to create this disk.
* `source_snapshot_encryption_key` -
(Optional)
The customer-supplied encryption key of the source snapshot.
* `self_link` - The URI of the created resource.