github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/d/ebs_snapshot_ids.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_ebs_snapshot_ids"
     4  sidebar_current: "docs-aws-datasource-ebs-snapshot-ids"
     5  description: |-
     6    Provides a list of EBS snapshot IDs.
     7  ---
     8  
     9  # aws\_ebs\_snapshot\_ids
    10  
    11  Use this data source to get a list of EBS Snapshot IDs matching the specified
    12  criteria.
    13  
    14  ## Example Usage
    15  
    16  ```hcl
    17  data "aws_ebs_snapshot_ids" "ebs_volumes" {
    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  * `owners` - (Optional) Returns the snapshots owned by the specified owner id. Multiple owners can be specified.
    37  
    38  * `restorable_by_user_ids` - (Optional) One or more AWS accounts IDs that can create volumes from the snapshot.
    39  
    40  * `filter` - (Optional) One or more name/value pairs to filter off of. There are
    41  several valid keys, for a full reference, check out
    42  [describe-volumes in the AWS CLI reference][1].
    43  
    44  ## Attributes Reference
    45  
    46  `ids` is set to the list of EBS snapshot IDs, sorted by creation time in
    47  descending order.
    48  
    49  [1]: http://docs.aws.amazon.com/cli/latest/reference/ec2/describe-snapshots.html