AWS amazonglacier documentation change
Summary
Updated service branding from 'Glacier' to 'Amazon Glacier' and added deprecation notice for the standalone Glacier service. Added migration guidance to S3 Glacier storage classes.
Security assessment
The changes primarily involve branding updates (Glacier → Amazon Glacier) and service lifecycle announcements (deprecation notice). While the deprecation notice mentions data security ('Your existing data will remain secure'), this is a general assurance rather than addressing a specific security vulnerability. The checksum verification process mentioned is an existing security practice, but no new security documentation was added.
Diff
diff --git a/amazonglacier/latest/dev/downloading-an-archive-using-java.md b/amazonglacier/latest/dev/downloading-an-archive-using-java.md index 9dfb0a767..0c8f4bdff 100644 --- a//amazonglacier/latest/dev/downloading-an-archive-using-java.md +++ b//amazonglacier/latest/dev/downloading-an-archive-using-java.md @@ -3 +3 @@ -[Documentation](/index.html)[Amazon S3 Glacier](/glacier/index.html)[Developer Guide](introduction.html) +[Documentation](/index.html)[Amazon Glacier](/glacier/index.html)[Developer Guide](introduction.html) @@ -7 +7 @@ Downloading an Archive Using the High-Level API of the AWS SDK for JavaDownloadi -**This page is only for existing customers of the Glacier service using Vaults and the original REST API from 2012.** +**This page is only for existing customers of the Amazon Glacier service using Vaults and the original REST API from 2012.** @@ -9 +9,3 @@ Downloading an Archive Using the High-Level API of the AWS SDK for JavaDownloadi -If you're looking for archival storage solutions we suggest using the Glacier storage classes in Amazon S3, **S3 Glacier Instant Retrieval** , **S3 Glacier Flexible Retrieval** , and **S3 Glacier Deep Archive**. To learn more about these storage options, see [Glacier storage classes](https://aws.amazon.com/s3/storage-classes/glacier/) and [Long-term data storage using Glacier storage classes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/glacier-storage-classes) in the _Amazon S3 User Guide_. These storage classes use the Amazon S3 API, are available in all regions, and can be managed within the Amazon S3 console. They offer features like Storage Cost Analysis, Storage Lens, advanced optional encryption features, and more. +If you're looking for archival storage solutions, we recommend using the Amazon Glacier storage classes in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, and S3 Glacier Deep Archive. To learn more about these storage options, see [Amazon Glacier storage classes](https://aws.amazon.com/s3/storage-classes/glacier/). + +Amazon Glacier (original standalone vault-based service) will no longer accept new customers starting December 15, 2025, with no impact to existing customers. Amazon Glacier is a standalone service with its own APIs that stores data in vaults and is distinct from Amazon S3 and the Amazon S3 Glacier storage classes. Your existing data will remain secure and accessible in Amazon Glacier indefinitely. No migration is required. For low-cost, long-term archival storage, AWS recommends the [Amazon S3 Glacier storage classes](https://aws.amazon.com/s3/storage-classes/glacier/), which deliver a superior customer experience with S3 bucket-based APIs, full AWS Region availability, lower costs, and AWS service integration. If you want enhanced capabilities, consider migrating to Amazon S3 Glacier storage classes by using our [AWS Solutions Guidance for transferring data from Amazon Glacier vaults to Amazon S3 Glacier storage classes](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). @@ -94 +96 @@ You need to specify an AWS Region from where you want to download the archive. A -You provide job information, such as the archive ID of the archive you want to download and the optional Amazon SNS topic to which you want Amazon Glacier (Glacier) to post a job completion message, by creating an instance of the `InitiateJobRequest` class. Glacier returns a job ID in response. The response is available in an instance of the `InitiateJobResult` class. +You provide job information, such as the archive ID of the archive you want to download and the optional Amazon SNS topic to which you want Amazon Glacier (Amazon Glacier) to post a job completion message, by creating an instance of the `InitiateJobRequest` class. Amazon Glacier returns a job ID in response. The response is available in an instance of the `InitiateJobResult` class. @@ -108 +110 @@ You provide job information, such as the archive ID of the archive you want to d -You can optionally specify a byte range to request Glacier to prepare only a portion of the archive. For example, you can update the preceding request by adding the following statement to request Glacier to prepare only the 1 MB to 2 MB portion of the archive. +You can optionally specify a byte range to request Amazon Glacier to prepare only a portion of the archive. For example, you can update the preceding request by adding the following statement to request Amazon Glacier to prepare only the 1 MB to 2 MB portion of the archive. @@ -127 +129 @@ You can optionally specify a byte range to request Glacier to prepare only a por -You must wait until the job output is ready for you to download. If you have either set a notification configuration on the vault identifying an Amazon Simple Notification Service (Amazon SNS) topic or specified an Amazon SNS topic when you initiated a job, Glacier sends a message to that topic after it completes the job. +You must wait until the job output is ready for you to download. If you have either set a notification configuration on the vault identifying an Amazon Simple Notification Service (Amazon SNS) topic or specified an Amazon SNS topic when you initiated a job, Amazon Glacier sends a message to that topic after it completes the job. @@ -129 +131 @@ You must wait until the job output is ready for you to download. If you have eit -You can also poll Glacier by calling the `describeJob` method to determine the job completion status. Although, using an Amazon SNS topic for notification is the recommended approach. +You can also poll Amazon Glacier by calling the `describeJob` method to determine the job completion status. Although, using an Amazon SNS topic for notification is the recommended approach. @@ -133 +135 @@ You can also poll Glacier by calling the `describeJob` method to determine the j -You provide the request information such as the job ID and vault name by creating an instance of the `GetJobOutputRequest` class. The output that Glacier returns is available in the `GetJobOutputResult` object. +You provide the request information such as the job ID and vault name by creating an instance of the `GetJobOutputRequest` class. The output that Amazon Glacier returns is available in the `GetJobOutputResult` object. @@ -149 +151 @@ The preceding code snippet downloads the entire job output. You can optionally r -In response to your `GetJobOutput` call, Glacier returns the checksum of the portion of the data you downloaded, if certain conditions are met. For more information, see [Receiving Checksums When Downloading Data](./checksum-calculations-range.html). +In response to your `GetJobOutput` call, Amazon Glacier returns the checksum of the portion of the data you downloaded, if certain conditions are met. For more information, see [Receiving Checksums When Downloading Data](./checksum-calculations-range.html). @@ -151 +153 @@ In response to your `GetJobOutput` call, Glacier returns the checksum of the por -To verify there are no errors in the download, you can then compute the checksum on the client-side and compare it with the checksum Glacier sent in the response. +To verify there are no errors in the download, you can then compute the checksum on the client-side and compare it with the checksum Amazon Glacier sent in the response. @@ -153 +155 @@ To verify there are no errors in the download, you can then compute the checksum -For an archive retrieval job with the optional range specified, when you get the job description, it includes the checksum of the range you are retrieving (SHA256TreeHash). You can use this value to further verify the accuracy of the entire byte range that you later download. For example, if you initiate a job to retrieve a tree-hash aligned archive range and then download output in chunks such that each of your `GetJobOutput` requests return a checksum, then you can compute checksum of each portion you download on the client-side and then compute the tree hash. You can compare it with the checksum Glacier returns in response to your describe job request to verify that the entire byte range you have downloaded is the same as the byte range that is stored in Glacier. +For an archive retrieval job with the optional range specified, when you get the job description, it includes the checksum of the range you are retrieving (SHA256TreeHash). You can use this value to further verify the accuracy of the entire byte range that you later download. For example, if you initiate a job to retrieve a tree-hash aligned archive range and then download output in chunks such that each of your `GetJobOutput` requests return a checksum, then you can compute checksum of each portion you download on the client-side and then compute the tree hash. You can compare it with the checksum Amazon Glacier returns in response to your describe job request to verify that the entire byte range you have downloaded is the same as the byte range that is stored in Amazon Glacier. @@ -168 +170 @@ The example performs the following tasks: -Glacier sends a notification to this topic after it completes the job. +Amazon Glacier sends a notification to this topic after it completes the job. @@ -176 +178 @@ The example attaches a policy to the queue to enable the Amazon SNS topic to pos -In the job request, the Amazon SNS topic that was created is specified so that Glacier can publish a notification to the topic after it completes the job. +In the job request, the Amazon SNS topic that was created is specified so that Amazon Glacier can publish a notification to the topic after it completes the job. @@ -418 +420 @@ If there is a message, parse the JSON and check if the job completed successfull -The following Java code example retrieves an archive from Glacier. The code example downloads the job output in chunks by specifying byte range in a `GetJobOutputRequest` object. +The following Java code example retrieves an archive from Amazon Glacier. The code example downloads the job output in chunks by specifying byte range in a `GetJobOutputRequest` object.