github.com/turtlemonvh/terraform@v0.6.9-0.20151204001754-8e40b6b855e8/website/source/docs/providers/aws/r/glacier_vault.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_glacier_vault"
     4  sidebar_current: "docs-aws-resource-glacier-vault"
     5  description: |-
     6    Provides a Glacier Vault.
     7  ---
     8  
     9  # aws\_glacier\_vault
    10  
    11  Provides a Glacier Vault Resource. You can refer to the [Glacier Developer Guide](http://docs.aws.amazon.com/amazonglacier/latest/dev/working-with-vaults.html) for a full explanation of the Glacier Vault functionality
    12  
    13  ~> **NOTE:** When removing a Glacier Vault, the Vault must be empty.
    14  
    15  ## Example Usage
    16  
    17  ```
    18  resource "aws_sns_topic" "aws_sns_topic" {
    19    name = "glacier-sns-topic"
    20  }
    21  
    22  resource "aws_glacier_vault" "my_archive" {
    23      name = "MyArchive"
    24  
    25      notification {
    26        sns_topic = "${aws_sns_topic.aws_sns_topic.arn}"
    27        events = ["ArchiveRetrievalCompleted","InventoryRetrievalCompleted"]
    28      }
    29  
    30      access_policy = <<EOF
    31  {
    32      "Version":"2012-10-17",
    33      "Statement":[
    34         {
    35            "Sid": "add-read-only-perm",
    36            "Principal": "*",
    37            "Effect": "Allow",
    38            "Action": [
    39               "glacier:InitiateJob",
    40               "glacier:GetJobOutput"
    41            ],
    42            "Resource": "arn:aws:glacier:eu-west-1:432981146916:vaults/MyArchive"
    43         }
    44      ]
    45  }
    46  EOF
    47  
    48      tags {
    49        Test = "MyArchive"
    50      }
    51  }
    52  ```
    53  
    54  ## Argument Reference
    55  
    56  The following arguments are supported:
    57  
    58  * `name` - (Required) The name of the Vault. Names can be between 1 and 255 characters long and the valid characters are a-z, A-Z, 0-9, '\_' (underscore), '-' (hyphen), and '.' (period).
    59  * `access_policy` - (Optional) The policy document. This is a JSON formatted string.
    60    The heredoc syntax or `file` function is helpful here. Use the [Glacier Developer Guide](https://docs.aws.amazon.com/amazonglacier/latest/dev/vault-access-policy.html) for more information on Glacier Vault Policy
    61  * `notification` - (Optional) The notifications for the Vault. Fields documented below.
    62  * `tags` - (Optional) A mapping of tags to assign to the resource.
    63  
    64  **notification** supports the following:
    65  
    66  * `events` - (Required) You can configure a vault to publish a notification for `ArchiveRetrievalCompleted` and `InventoryRetrievalCompleted` events.
    67  * `sns_topic` - (Required) The SNS Topic ARN.
    68  
    69  ## Attributes Reference
    70  
    71  The following attributes are exported:
    72  
    73  * `location` - The URI of the vault that was created.
    74  * `arn` - The ARN of the vault.