Amazon Glacier - Developer Guide

1 Amazon S3 GlacierDeveloper GuideAPI Version 2012-06-01 Amazon S3 Glacier Developer GuideAmazon S3 Glacier : Developer GuideCopyright 2018 Amazon Web Services, Inc. and/or its affiliates. All rights 's trademarks and trade dress may not be used in connection with any product or service that is not Amazon 's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon . All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored S3 Glacier Developer GuideTable of ContentsWhat Is Amazon S3 Glacier ?

2 1 Are You a First-Time Glacier User? .. 1 Data 2 Vault .. 2 Archive .. 3 Notification 4 Supported Operations .. 4 Vault Operations .. 5 Archive Operations .. 5 Accessing Amazon S3 Glacier .. 5 Regions and Endpoints .. 6 Getting Started .. 7 Step 1: Before You Begin .. 7 Set Up an AWS Account .. 8 Download the Appropriate AWS SDK .. 10 Step 2: Create a Vault .. 11 Step 3: Upload an Archive to a Vault .. 12 Upload an Archive Using Java .. 13 Upload an Archive Using .NET .. 14 Step 4: Download an Archive from a Vault.

3 15 Download an Archive Using Java .. 16 Download an Archive Using .NET .. 17 Step 5: Delete an Archive from a Vault .. 18 Related Sections .. 18 Delete an Archive Using Java .. 19 Delete an Archive Using .NET .. 20 Step 6: Delete a Vault .. 20 Where Do I Go From Here? .. 21 Working with Vaults .. 22 Vault Operations in Glacier .. 22 Creating and Deleting Vaults .. 22 Retrieving Vault Metadata .. 23 Downloading a Vault Inventory .. 23 Configuring Vault Notifications .. 23 Creating a Vault .. 23 Creating a Vault Using Java.

4 24 Creating a Vault Using .NET .. 26 Creating a Vault Using REST .. 29 Creating a Vault Using the Console .. 29 Retrieving Vault Metadata .. 29 Retrieving Vault Metadata Using Java .. 30 Retrieving Vault Metadata Using .NET .. 31 Retrieving Vault Metadata Using REST .. 33 Downloading a Vault Inventory .. 33 About the Inventory .. 34 Downloading a Vault Inventory Using Java .. 35 Downloading a Vault Inventory Using .NET .. 40 Downloading a Vault Inventory Using REST .. 44 Configuring Vault Notifications .. 45 General Concepts .. 45 Configuring Vault Notifications Using Java.

5 46 Configuring Vault Notifications Using .NET .. 48 API Version 2012-06-01iiiAmazon S3 Glacier Developer GuideConfiguring Vault Notifications Using the REST API .. 50 Configuring Vault Notifications Using the Console .. 50 Deleting a Vault .. 53 Deleting a Vault Using Java .. 53 Deleting a Vault Using .NET .. 54 Deleting a Vault Using REST .. 55 Deleting a Vault Using the Console .. 55 Tagging Vaults .. 55 Tagging Vaults Using the Amazon S3 Glacier Console .. 55 Tagging Vaults Using the Amazon S3 Glacier API .. 56 Related Sections .. 56 Vault Lock.

6 56 Vault Locking Overview .. 57 Vault Locking Using the API .. 57 Working with Archives .. 59 Archive Operations .. 59 Uploading an Archive .. 59 Downloading an Archive .. 60 Deleting an Archive .. 60 Updating an Archive .. 60 Maintaining Client-Side Archive Metadata .. 60 Uploading an Archive .. 60 Options for Uploading an Archive .. 61 Uploading an Archive in a Single Operation .. 61 Uploading Large Archives in Parts .. 67 Downloading an Archive .. 75 Retrieving Archives .. 75 Downloading an Archive Using Java .. 78 Downloading an Archive Using.

7 NET .. 90 Downloading an Archive Using REST .. 100 Deleting an Archive .. 101 Deleting an Archive Using Java .. 101 Deleting an Archive Using .NET .. 103 Deleting an Archive Using REST .. 105 Querying an Archive .. 105 Using the AWS SDKs .. 106 AWS SDKs that Support Glacier .. 106 AWS SDK Libraries for Java and .NET .. 106 What Is the Low-Level API? .. 106 What Is the High-Level API? .. 107 When to Use the High-Level and Low-Level API .. 107 Using the AWS SDK for Java .. 107 Using the Low-Level API .. 108 Using the High-Level API.

8 108 Running Java Examples Using Eclipse .. 109 Setting the Endpoint .. 109 Using the AWS SDK for .NET .. 110 Using the Low-Level API .. 110 Using the High-Level API .. 111 Running .NET 111 Setting the Endpoint .. 111 Authentication and Access Control .. 113 Access Control .. 114 Overview of Managing Access .. 114 Amazon S3 Glacier Resources and Operations .. 115 Understanding Resource Ownership .. 115 API Version 2012-06-01ivAmazon S3 Glacier Developer GuideManaging Access to Resources .. 115 Specifying Policy Elements: Actions, Effects, Resources, and Principals.

9 117 Specifying Conditions in a Policy .. 118 Using Identity-Based Policies (IAM Policies) .. 119 Permissions Required to Use the Amazon S3 Glacier Console .. 119 AWS Managed Policies (Predefined Policies) for Amazon S3 Glacier .. 120 Customer Managed Policy Examples .. 120 Using Resource-Based Policies (Vault Policies) .. 122 Vault Access Policies .. 123 Vault Lock Policies .. 125 Amazon S3 Glacier API Permissions Reference .. 127 Querying Archives with Glacier Select .. 133 Glacier Select Requirements and Limits .. 133 How Do I Query Data Using Glacier Select?

10 133 Glacier Select Output .. 134 Error Handling .. 135 More Info .. 135 Data Retrieval Policies .. 136 Choosing an Amazon S3 Glacier Data Retrieval Policy .. 136 Free Tier Only Policy .. 137 Max Retrieval Rate Policy .. 137No Retrieval Limit Policy .. 137 Using the Amazon S3 Glacier Console to Set Up a Data Retrieval Policy .. 137 Using the Amazon S3 Glacier API to Set Up a Data Retrieval Policy .. 138 Using the Amazon S3 Glacier REST API to Set Up a Data Retrieval Policy .. 138 Using the AWS SDKs to Set Up a Data Retrieval Policy .. 139 Tagging Resources.