AWS amazonglacier documentation change
Summary
Updated service name references from 'S3 Glacier' to 'Glacier' throughout the documentation, removed redundant 'S3' branding in storage class names and links, and adjusted terminology consistency.
Security assessment
The changes are purely branding/nomenclature updates (removing 'S3' from service names) and do not alter security mechanisms. The documentation still describes the same SHA256 tree hash verification process and integrity checks, but there is no evidence of addressing a security vulnerability or introducing new security features.
Diff
diff --git a/amazonglacier/latest/dev/api-multipart-complete-upload.md b/amazonglacier/latest/dev/api-multipart-complete-upload.md index 20a0235c4..35046c539 100644 --- a//amazonglacier/latest/dev/api-multipart-complete-upload.md +++ b//amazonglacier/latest/dev/api-multipart-complete-upload.md @@ -7 +7 @@ DescriptionRequestsResponsesExampleRelated 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 @@ DescriptionRequestsResponsesExampleRelated 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. @@ -15 +15 @@ If you're looking for archival storage solutions we suggest using the S3 Glacier -You call this multipart upload operation to inform Amazon S3 Glacier (S3 Glacier) that all the archive parts have been uploaded and S3 Glacier can now assemble the archive from the uploaded parts. +You call this multipart upload operation to inform Amazon Glacier (Glacier) that all the archive parts have been uploaded and Glacier can now assemble the archive from the uploaded parts. @@ -19 +19 @@ For information about multipart upload, see [Uploading Large Archives in Parts ( -After assembling and saving the archive to the vault, S3 Glacier returns the archive ID of the newly created archive resource. After you upload an archive, you should save the archive ID returned to retrieve the archive at a later point. +After assembling and saving the archive to the vault, Glacier returns the archive ID of the newly created archive resource. After you upload an archive, you should save the archive ID returned to retrieve the archive at a later point. @@ -21 +21 @@ After assembling and saving the archive to the vault, S3 Glacier returns the arc -In the request, you must include the computed SHA256 tree hash of the entire archive you have uploaded. For information about computing a SHA256 tree hash, see [Computing Checksums](./checksum-calculations.html). On the server side, S3 Glacier also constructs the SHA256 tree hash of the assembled archive. If the values match, S3 Glacier saves the archive to the vault; otherwise, it returns an error, and the operation fails. The [List Parts (GET uploadID)](./api-multipart-list-parts.html) operation returns list of parts uploaded for a specific multipart upload. It includes checksum information for each uploaded part that can be used to debug a bad checksum issue. +In the request, you must include the computed SHA256 tree hash of the entire archive you have uploaded. For information about computing a SHA256 tree hash, see [Computing Checksums](./checksum-calculations.html). On the server side, Glacier also constructs the SHA256 tree hash of the assembled archive. If the values match, Glacier saves the archive to the vault; otherwise, it returns an error, and the operation fails. The [List Parts (GET uploadID)](./api-multipart-list-parts.html) operation returns list of parts uploaded for a specific multipart upload. It includes checksum information for each uploaded part that can be used to debug a bad checksum issue. @@ -23 +23 @@ In the request, you must include the computed SHA256 tree hash of the entire arc -Additionally, S3 Glacier also checks for any missing content ranges. When uploading parts, you specify range values identifying where each part fits in the final assembly of the archive. When assembling the final archive S3 Glacier checks for any missing content ranges and if there are any missing content ranges, S3 Glacier returns an error and the Complete Multipart Upload operation fails. +Additionally, Glacier also checks for any missing content ranges. When uploading parts, you specify range values identifying where each part fits in the final assembly of the archive. When assembling the final archive Glacier checks for any missing content ranges and if there are any missing content ranges, Glacier returns an error and the Complete Multipart Upload operation fails. @@ -29 +29 @@ Complete Multipart Upload is an idempotent operation. After your first successfu -To complete a multipart upload, you send an HTTP POST request to the URI of the upload ID that S3 Glacier created in response to your Initiate Multipart Upload request. This is the same URI you used when uploading parts. In addition to the common required headers, you must include the result of the SHA256 tree hash of the entire archive and the total size of the archive in bytes. +To complete a multipart upload, you send an HTTP POST request to the URI of the upload ID that Glacier created in response to your Initiate Multipart Upload request. This is the same URI you used when uploading parts. In addition to the common required headers, you must include the result of the SHA256 tree hash of the entire archive and the total size of the archive in bytes. @@ -57 +57 @@ Name | Description | Required -`x-amz-sha256-tree-hash` | The SHA256 tree hash of the entire archive. It is the tree hash of SHA256 tree hash of the individual parts. If the value you specify in the request does not match the SHA256 tree hash of the final assembled archive as computed by S3 Glacier, S3 Glacier returns an error and the request fails. Type: String Default: None Constraints: None | Yes +`x-amz-sha256-tree-hash` | The SHA256 tree hash of the entire archive. It is the tree hash of SHA256 tree hash of the individual parts. If the value you specify in the request does not match the SHA256 tree hash of the final assembled archive as computed by Glacier, Glacier returns an error and the request fails. Type: String Default: None Constraints: None | Yes @@ -65 +65 @@ This operation does not use request elements. -Amazon S3 Glacier (S3 Glacier) creates a SHA256 tree hash of the entire archive. If the value matches the SHA256 tree hash of the entire archive you specified in the request, S3 Glacier adds the archive to the vault. In response it returns the HTTP `Location` header with the URL path of the newly added archive resource. If the archive size or SHA256 that you sent in the request does not match, S3 Glacier will return an error and the upload remains in the incomplete state. It is possible to retry the Complete Multipart Upload operation later with correct values, at which point you can successfully create an archive. If a multipart upload does not complete, then eventually S3 Glacier will reclaim the upload ID. +Amazon Glacier (Glacier) creates a SHA256 tree hash of the entire archive. If the value matches the SHA256 tree hash of the entire archive you specified in the request, Glacier adds the archive to the vault. In response it returns the HTTP `Location` header with the URL path of the newly added archive resource. If the archive size or SHA256 that you sent in the request does not match, Glacier will return an error and the upload remains in the incomplete state. It is possible to retry the Complete Multipart Upload operation later with correct values, at which point you can successfully create an archive. If a multipart upload does not complete, then eventually Glacier will reclaim the upload ID. @@ -82 +82 @@ Name | Description -`Location` | The relative URI path of the newly created archive. This URL includes the archive ID that is generated by S3 Glacier. Type: String +`Location` | The relative URI path of the newly created archive. This URL includes the archive ID that is generated by Glacier. Type: String @@ -106 +106 @@ In this example, an HTTP POST request is sent to the URI that was returned by an -The following example response shows that S3 Glacier successfully created an archive from the parts you uploaded. The response includes the archive ID with complete path. +The following example response shows that Glacier successfully created an archive from the parts you uploaded. The response includes the archive ID with complete path. @@ -133 +133 @@ You can now send HTTP requests to the URI of the newly added resource/archive. F - * [Identity and Access Management for Amazon S3 Glacier](./security-iam.html) + * [Identity and Access Management for Amazon Glacier](./security-iam.html)