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 ? .. 1 Are You a First-Time Glacier User? .. 1 Data 2 Vault .. 2 Archive .. 3 Notification 4 Supported Operations.

2 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 .. 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.

3 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 .. 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.

4 45 General Concepts .. 45 Configuring Vault Notifications Using Java .. 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 .. 56 Vault Locking Overview .. 57 Vault Locking Using the API .. 57 Working with Archives .. 59 Archive Operations.

5 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 .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 .

6 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 .. 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.

7 115 Specifying Policy Elements: Actions, Effects, Resources, and Principals .. 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? .. 133 Glacier Select Output .. 134 Error Handling .. 135 More Info .. 135 Data Retrieval Policies.

8 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 .. 140 Tagging Basics .. 140 Tag Restrictions .. 140 Tracking Costs Using Tagging .. 141 Managing Access Control with Tagging .. 141 Related Sections .. 141 Audit Logging with AWS CloudTrail .. 142 Amazon S3 Glacier Information in CloudTrail .. 142 Understanding Amazon S3 Glacier Log File Entries.

9 143 API Reference .. 145 Common Request Headers .. 145 Common Response Headers .. 147 Signing Requests .. 148 Example Signature Calculation .. 149 Calculating Signatures for the Streaming Operations .. 150 Computing 151 Tree Hash Example 1: Uploading an archive in a single request .. 152 Tree Hash Example 2: Uploading an archive using a multipart upload .. 153 Computing the Tree Hash of a File .. 154 Receiving Checksums When Downloading Data .. 160 Error Responses .. 161 Example 1: Describe Job request with a job ID that does not exist .. 163 Example 2: List Jobs request with an invalid value for the request parameter .. 164 Vault Operations .. 165 Abort Vault Lock .. 165 Add Tags To Vault .. 167 Create Vault .. 169 Complete Vault Lock.

10 171 Delete Vault .. 173 Delete Vault Access Policy .. 175 Delete Vault Notifications .. 177 API Version 2012-06-01vAmazon S3 Glacier Developer GuideDescribe Vault .. 179 Get Vault Access Policy .. 181 Get Vault Lock .. 184 Get Vault Notifications .. 187 Initiate Vault Lock .. 189 List Tags For Vault .. 192 List Vaults .. 194 Remove Tags From Vault .. 198 Set Vault Access Policy .. 201 Set Vault Notification Configuration .. 203 Archive Operations .. 205 Delete Archive .. 205 Upload Archive .. 207 Multipart Upload Operations .. 211 Abort Multipart Upload .. 211 Complete Multipart Upload .. 213 Initiate Multipart Upload .. 216 List Parts .. 219 List Multipart Uploads .. 224 Upload Part .. 229 Job 232 Describe 233 Get Job 240 Initiate 246 List 256 Data Types Used in Job Operations.