github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/aws/d/ebs_snapshot.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_ebs_snapshot"
     4  sidebar_current: "docs-aws-datasource-ebs-snapshot"
     5  description: |-
     6    Get information on an EBS Snapshot.
     7  ---
     8  
     9  # aws\_ebs\_snapshot
    10  
    11  Use this data source to get information about an EBS Snapshot for use when provisioning EBS Volumes
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  data "aws_ebs_snapshot" "ebs_volume" {
    17    most_recent = true
    18    owners      = ["self"]
    19  
    20    filter {
    21      name   = "volume-size"
    22      values = ["40"]
    23    }
    24  
    25    filter {
    26      name   = "tag:Name"
    27      values = ["Example"]
    28    }
    29  }
    30  ```
    31  
    32  ## Argument Reference
    33  
    34  The following arguments are supported:
    35  
    36  * `most_recent` - (Optional) If more than one result is returned, use the most recent snapshot.
    37  
    38  * `owners` - (Optional) Returns the snapshots owned by the specified owner id. Multiple owners can be specified.
    39  
    40  * `snapshot_ids` - (Optional) Returns information on a specific snapshot_id.
    41  
    42  * `restorable_by_user_ids` - (Optional) One or more AWS accounts IDs that can create volumes from the snapshot.
    43  
    44  * `filter` - (Optional) One or more name/value pairs to filter off of. There are
    45  several valid keys, for a full reference, check out
    46  [describe-volumes in the AWS CLI reference][1].
    47  
    48  
    49  ## Attributes Reference
    50  
    51  The following attributes are exported:
    52  
    53  * `id` - The snapshot ID (e.g. snap-59fcb34e).
    54  * `snapshot_id` - The snapshot ID (e.g. snap-59fcb34e).
    55  * `description` - A description for the snapshot
    56  * `owner_id` - The AWS account ID of the EBS snapshot owner.
    57  * `owner_alias` - Value from an Amazon-maintained list (`amazon`, `aws-marketplace`, `microsoft`) of snapshot owners.
    58  * `volume_id` - The volume ID (e.g. vol-59fcb34e).
    59  * `encrypted` - Whether the snapshot is encrypted.
    60  * `volume_size` - The size of the drive in GiBs.
    61  * `kms_key_id` - The ARN for the KMS encryption key.
    62  * `data_encryption_key_id` - The data encryption key identifier for the snapshot.
    63  * `state` - The snapshot state.
    64  * `tags` - A mapping of tags for the resource.
    65  
    66  [1]: http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-snapshots.html