AWS amazonglacier documentation change
Summary
Updated service branding from 'S3 Glacier' to 'Glacier' and adjusted references to storage classes and API documentation. Clarified checksum verification process for job outputs.
Security assessment
The changes primarily involve branding terminology updates (e.g., 'S3 Glacier' to 'Glacier') and documentation consistency improvements. While checksum verification is mentioned for data integrity, this is standard operational guidance rather than addressing a specific security vulnerability. No new security features or vulnerabilities are introduced.
Diff
diff --git a/amazonglacier/latest/dev/api-job-output-get.md b/amazonglacier/latest/dev/api-job-output-get.md index ac7ba59b8..95e764e4a 100644 --- a//amazonglacier/latest/dev/api-job-output-get.md +++ b//amazonglacier/latest/dev/api-job-output-get.md @@ -7 +7 @@ DescriptionRequestsResponsesExamplesRelated Sections -**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 @@ DescriptionRequestsResponsesExamplesRelated Sections -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. @@ -19 +19 @@ You can download all the job output or download a portion of the output by speci -For archive retrieval jobs, you should also verify that the size is what you expected. If you download a portion of the output, the expected size is based on the range of bytes you specified. For example, if you specify a range of `bytes=0-1048575`, you should verify your download size is 1,048,576 bytes. If you download an entire archive, the expected size is the size of the archive when you uploaded it to Amazon S3 Glacier (S3 Glacier). The expected size is also returned in the headers from the **Get Job Output** response. +For archive retrieval jobs, you should also verify that the size is what you expected. If you download a portion of the output, the expected size is based on the range of bytes you specified. For example, if you specify a range of `bytes=0-1048575`, you should verify your download size is 1,048,576 bytes. If you download an entire archive, the expected size is the size of the archive when you uploaded it to Amazon Glacier (Glacier). The expected size is also returned in the headers from the **Get Job Output** response. @@ -21 +21 @@ For archive retrieval jobs, you should also verify that the size is what you exp -In the case of an archive retrieval job, depending on the byte range you specify, S3 Glacier returns the checksum for the portion of the data. To ensure the portion you downloaded is the correct data, compute the checksum on the client, verify that the values match, and verify that the size is what you expected. +In the case of an archive retrieval job, depending on the byte range you specify, Glacier returns the checksum for the portion of the data. To ensure the portion you downloaded is the correct data, compute the checksum on the client, verify that the values match, and verify that the size is what you expected. @@ -23 +23 @@ In the case of an archive retrieval job, depending on the byte range you specify -A job ID does not expire for at least 24 hours after S3 Glacier completes the job. That is, you can download the job output within the 24-hour period after S3 Glacier completes the job. +A job ID does not expire for at least 24 hours after Glacier completes the job. That is, you can download the job output within the 24-hour period after Glacier completes the job. @@ -58 +58 @@ Name | Description | Required - 4. After downloading all the parts of the job output, you have a list of eight checksum values. Compute the tree hash of these values to find the checksum of the entire output. Using the [Describe Job (GET JobID)](./api-describe-job-get.html) operation, obtain job information of the job that provided you the output. The response includes the checksum of the entire archive stored in S3 Glacier. You compare this value with the checksum you computed to ensure you have downloaded the entire archive content with no errors. + 4. After downloading all the parts of the job output, you have a list of eight checksum values. Compute the tree hash of these values to find the checksum of the entire output. Using the [Describe Job (GET JobID)](./api-describe-job-get.html) operation, obtain job information of the job that provided you the output. The response includes the checksum of the entire archive stored in Glacier. You compare this value with the checksum you computed to ensure you have downloaded the entire archive content with no errors. @@ -86 +86 @@ Header | Description -`Content-Range` | The range of bytes returned by S3 Glacier. If only partial output is downloaded, the response provides the range of bytes S3 Glacier returned. For example, `bytes 0-1048575/8388608` returns the first 1 MB from 8 MB. For more information about the `Content-Range` header, go to [Content-Range Header Field Definition](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Type: String +`Content-Range` | The range of bytes returned by Glacier. If only partial output is downloaded, the response provides the range of bytes Glacier returned. For example, `bytes 0-1048575/8388608` returns the first 1 MB from 8 MB. For more information about the `Content-Range` header, go to [Content-Range Header Field Definition](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Type: String @@ -103 +103 @@ Type: String -S3 Glacier returns the job output in the response body. Depending on the job type, the output can be the archive contents or the vault inventory. In case of a vault inventory, by default the inventory list is returned as the following JSON body. +Glacier returns the job output in the response body. Depending on the job type, the output can be the archive contents or the vault inventory. In case of a vault inventory, by default the inventory list is returned as the following JSON body. @@ -159 +159 @@ _Type_ : A string representation in the ISO 8601 date format, for example `2013- -The UTC date and time of the last inventory for the vault that was completed after changes to the vault. Even though S3 Glacier prepares a vault inventory once a day, the inventory date is only updated if there have been archive additions or deletions to the vault since the last inventory. +The UTC date and time of the last inventory for the vault that was completed after changes to the vault. Even though Glacier prepares a vault inventory once a day, the inventory date is only updated if there have been archive additions or deletions to the vault since the last inventory. @@ -186 +186 @@ _Type_ : String -For information about Amazon S3 Glacier exceptions and error messages, see [Error Responses](./api-error-responses.html). +For information about Amazon Glacier exceptions and error messages, see [Error Responses](./api-error-responses.html). @@ -194 +194 @@ The following example shows the request for a job that retrieves an archive. -This example retrieves data prepared by S3 Glacier in response to your initiate archive retrieval job request. +This example retrieves data prepared by Glacier in response to your initiate archive retrieval job request. @@ -251 +251 @@ The following is an example response of an inventory retrieval job. Note that th -This example retrieves only a portion of the archive prepared by S3 Glacier in response to your initiate archive retrieval job request. The request uses the optional `Range` header to retrieve only the first 1,024 bytes. +This example retrieves only a portion of the archive prepared by Glacier in response to your initiate archive retrieval job request. The request uses the optional `Range` header to retrieve only the first 1,024 bytes. @@ -265 +265 @@ This example retrieves only a portion of the archive prepared by S3 Glacier in r -The following successful response shows the `206 Partial Content` response. In this case, the response also includes a `Content-Range` header that specifies the range of bytes S3 Glacier returns. +The following successful response shows the `206 Partial Content` response. In this case, the response also includes a `Content-Range` header that specifies the range of bytes Glacier returns. @@ -283 +283 @@ The following successful response shows the `206 Partial Content` response. In t - * [Identity and Access Management for Amazon S3 Glacier](./security-iam.html) + * [Identity and Access Management for Amazon Glacier](./security-iam.html)