AWS amazonglacier documentation change
Summary
Updated branding and terminology from 'S3 Glacier' to 'Glacier' throughout the documentation, removed redundant 'S3' references in storage class names, and adjusted links/headings for consistency.
Security assessment
The changes are purely branding/terminology updates (e.g., 'S3 Glacier' → 'Glacier') and do not introduce or modify any security-related content. Existing security practices like checksum verification for data integrity are mentioned but not altered. No evidence of addressing vulnerabilities or adding new security features.
Diff
diff --git a/amazonglacier/latest/dev/downloading-an-archive-using-java.md b/amazonglacier/latest/dev/downloading-an-archive-using-java.md index 045fe0ba0..9dfb0a767 100644 --- a//amazonglacier/latest/dev/downloading-an-archive-using-java.md +++ b//amazonglacier/latest/dev/downloading-an-archive-using-java.md @@ -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 S3 Glacier service using Vaults and the original REST API from 2012.** +**This page is only for existing customers of the Glacier service using Vaults and the original REST API from 2012.** @@ -9 +9 @@ 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 S3 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 [S3 Glacier storage classes](https://aws.amazon.com/s3/storage-classes/glacier/) and [Long-term data storage using S3 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 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. @@ -11 +11 @@ If you're looking for archival storage solutions we suggest using the S3 Glacier -# Downloading an Archive in Amazon S3 Glacier Using the AWS SDK for Java +# Downloading an Archive in Amazon Glacier Using the AWS SDK for Java @@ -36 +36 @@ The following Java code example downloads an archive from a vault (`examplevault -For step-by-step instructions to run this sample, see [Running Java Examples for Amazon S3 Glacier Using Eclipse](./using-aws-sdk-for-java.html#setting-up-and-testing-sdk-java). You need to update the code as shown with an existing archive ID and the local file path where you want to save the downloaded archive. +For step-by-step instructions to run this sample, see [Running Java Examples for Amazon Glacier Using Eclipse](./using-aws-sdk-for-java.html#setting-up-and-testing-sdk-java). You need to update the code as shown with an existing archive ID and the local file path where you want to save the downloaded archive. @@ -94 +94 @@ 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 S3 Glacier (S3 Glacier) to post a job completion message, by creating an instance of the `InitiateJobRequest` class. S3 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 (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. @@ -108 +108 @@ 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 S3 Glacier to prepare only a portion of the archive. For example, you can update the preceding request by adding the following statement to request S3 Glacier to prepare only the 1 MB to 2 MB portion of the archive. +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. @@ -127 +127 @@ You can optionally specify a byte range to request S3 Glacier to prepare only a -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, S3 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, Glacier sends a message to that topic after it completes the job. @@ -129 +129 @@ You must wait until the job output is ready for you to download. If you have eit -You can also poll S3 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 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 +133 @@ You can also poll S3 Glacier by calling the `describeJob` method to determine th -You provide the request information such as the job ID and vault name by creating an instance of the `GetJobOutputRequest` class. The output that S3 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 Glacier returns is available in the `GetJobOutputResult` object. @@ -149 +149 @@ The preceding code snippet downloads the entire job output. You can optionally r -In response to your `GetJobOutput` call, S3 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, 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 +151 @@ In response to your `GetJobOutput` call, S3 Glacier returns the checksum of the -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 S3 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 Glacier sent in the response. @@ -153 +153 @@ 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 S3 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 S3 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 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. @@ -168 +168 @@ The example performs the following tasks: -S3 Glacier sends a notification to this topic after it completes the job. +Glacier sends a notification to this topic after it completes the job. @@ -176 +176 @@ 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 S3 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 Glacier can publish a notification to the topic after it completes the job. @@ -418 +418 @@ If there is a message, parse the JSON and check if the job completed successfull -The following Java code example retrieves an archive from S3 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 Glacier. The code example downloads the job output in chunks by specifying byte range in a `GetJobOutputRequest` object.