AWS amazonglacier documentation change
Summary
Updated service name references from 'S3 Glacier' to 'Glacier' throughout the document, adjusted links, and simplified branding terminology.
Security assessment
The changes are purely branding/naming convention updates (removing 'S3' from service names) and link adjustments. No security vulnerabilities, encryption changes, access control modifications, or incident-related content was introduced or altered. Existing security-related mentions (e.g., encryption features, data retrieval policies) remain unchanged in substance.
Diff
diff --git a/amazonglacier/latest/dev/downloading-an-archive-two-steps.md b/amazonglacier/latest/dev/downloading-an-archive-two-steps.md index af3553f67..65a75d3bd 100644 --- a//amazonglacier/latest/dev/downloading-an-archive-two-steps.md +++ b//amazonglacier/latest/dev/downloading-an-archive-two-steps.md @@ -7 +7 @@ Archive Retrieval OptionsRanged Archive Retrievals -**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 @@ Archive Retrieval OptionsRanged Archive Retrievals -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 -# Retrieving S3 Glacier Archives +# Retrieving Glacier Archives @@ -13 +13 @@ If you're looking for archival storage solutions we suggest using the S3 Glacier -Retrieving an archive from Amazon S3 Glacier is an asynchronous operation in which you first initiate a job, and then download the output after the job is completed. To initiate an archive retrieval job, you use the [Initiate Job (POST jobs)](./api-initiate-job-post.html) REST API operation or the equivalent in the AWS CLI, or the AWS SDKs. +Retrieving an archive from Amazon Glacier is an asynchronous operation in which you first initiate a job, and then download the output after the job is completed. To initiate an archive retrieval job, you use the [Initiate Job (POST jobs)](./api-initiate-job-post.html) REST API operation or the equivalent in the AWS CLI, or the AWS SDKs. @@ -24 +24 @@ Retrieving an archive from Amazon S3 Glacier is an asynchronous operation in whi -Retrieving an archive from S3 Glacier is a two-step process. The following is an overview of this process. +Retrieving an archive from Glacier is a two-step process. The following is an overview of this process. @@ -30 +30 @@ Retrieving an archive from S3 Glacier is a two-step process. The following is an - 1. Get the ID of the archive that you want to retrieve. You can get the archive ID from an inventory of the vault. You can get the archive ID with the REST API, AWS CLI, or AWS SDKs. For more information, see [Downloading a Vault Inventory in Amazon S3 Glacier](./vault-inventory.html). + 1. Get the ID of the archive that you want to retrieve. You can get the archive ID from an inventory of the vault. You can get the archive ID with the REST API, AWS CLI, or AWS SDKs. For more information, see [Downloading a Vault Inventory in Amazon Glacier](./vault-inventory.html). @@ -32 +32 @@ Retrieving an archive from S3 Glacier is a two-step process. The following is an - 2. Initiate a job that requests S3 Glacier to prepare an entire archive or a portion of the archive for subsequent download by using the [Initiate Job (POST jobs)](./api-initiate-job-post.html) operation. + 2. Initiate a job that requests Glacier to prepare an entire archive or a portion of the archive for subsequent download by using the [Initiate Job (POST jobs)](./api-initiate-job-post.html) operation. @@ -34 +34 @@ Retrieving an archive from S3 Glacier is a two-step process. The following is an -When you initiate a job, S3 Glacier returns a job ID in the response and runs the job asynchronously. (You cannot download the job output until after the job is completed, as described in Step 2.) +When you initiate a job, Glacier returns a job ID in the response and runs the job asynchronously. (You cannot download the job output until after the job is completed, as described in Step 2.) @@ -38 +38 @@ When you initiate a job, S3 Glacier returns a job ID in the response and runs th -For Standard retrievals only, a data retrieval policy can cause your `Initiate Job` request to fail with a `PolicyEnforcedException` exception. For more information about data retrieval policies, see [S3 Glacier Data Retrieval Policies](./data-retrieval-policy.html). For more information about the `PolicyEnforcedException` exception, see [Error Responses](./api-error-responses.html). +For Standard retrievals only, a data retrieval policy can cause your `Initiate Job` request to fail with a `PolicyEnforcedException` exception. For more information about data retrieval policies, see [Glacier Data Retrieval Policies](./data-retrieval-policy.html). For more information about the `PolicyEnforcedException` exception, see [Error Responses](./api-error-responses.html). @@ -40 +40 @@ For Standard retrievals only, a data retrieval policy can cause your `Initiate J -When required, you can restore large segments of the data stored in S3 Glacier. For more information about restoring data from the S3 Glacier storage classes, see [ Storage Classes for Archiving Objects]( https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html#sc-glacier) in the _Amazon Simple Storage Service User Guide_. +When required, you can restore large segments of the data stored in Glacier. For more information about restoring data from the Glacier storage classes, see [ Storage Classes for Archiving Objects]( https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html#sc-glacier) in the _Amazon Simple Storage Service User Guide_. @@ -49 +49 @@ You can download all bytes or specify a byte range to download only a portion of -S3 Glacier must complete a job before you can get its output. After completion, a job does not expire for at least 24 hours, which means that you can download the output within the 24-hour period after the job is completed. The restore can expire any time after 24 hours from the completion of the job. To determine if your job is complete, check its status by using one of the following options: +Glacier must complete a job before you can get its output. After completion, a job does not expire for at least 24 hours, which means that you can download the output within the 24-hour period after the job is completed. The restore can expire any time after 24 hours from the completion of the job. To determine if your job is complete, check its status by using one of the following options: @@ -51 +51 @@ S3 Glacier must complete a job before you can get its output. After completion, - * **Wait for a job-completion notification** – You can specify an Amazon Simple Notification Service (Amazon SNS) topic to which S3 Glacier can post a notification after the job is completed. S3 Glacier sends a notification only after it completes the job. + * **Wait for a job-completion notification** – You can specify an Amazon Simple Notification Service (Amazon SNS) topic to which Glacier can post a notification after the job is completed. Glacier sends a notification only after it completes the job. @@ -53 +53 @@ S3 Glacier must complete a job before you can get its output. After completion, -You can specify an Amazon SNS topic for a job when you initiate the job. In addition to specifying an Amazon SNS topic in your job request, if your vault has notifications set for archive retrieval events, then S3 Glacier also publishes a notification to that SNS topic. For more information, see [Configuring Vault Notifications in Amazon S3 Glacier](./configuring-notifications.html). +You can specify an Amazon SNS topic for a job when you initiate the job. In addition to specifying an Amazon SNS topic in your job request, if your vault has notifications set for archive retrieval events, then Glacier also publishes a notification to that SNS topic. For more information, see [Configuring Vault Notifications in Amazon Glacier](./configuring-notifications.html). @@ -55 +55 @@ You can specify an Amazon SNS topic for a job when you initiate the job. In addi - * **Request job information explicitly** – You can also use the S3 Glacier `Describe Job` API operation ([Describe Job (GET JobID)](./api-describe-job-get.html)) to periodically poll for job information. However, we recommend using Amazon SNS notifications. + * **Request job information explicitly** – You can also use the Glacier `Describe Job` API operation ([Describe Job (GET JobID)](./api-describe-job-get.html)) to periodically poll for job information. However, we recommend using Amazon SNS notifications. @@ -66 +66 @@ The information that you get by using an Amazon SNS notification is the same as -When initiating a job to retrieve an archive, you can specify one of the following retrieval options, based on your access time and cost requirements. For information about retrieval pricing, see [Amazon S3 Glacier Pricing](https://aws.amazon.com/s3/glacier/pricing/). +When initiating a job to retrieve an archive, you can specify one of the following retrieval options, based on your access time and cost requirements. For information about retrieval pricing, see [Amazon Glacier Pricing](https://aws.amazon.com/s3/glacier/pricing/). @@ -72 +72 @@ When initiating a job to retrieve an archive, you can specify one of the followi - * **Bulk** – Bulk retrievals are the lowest-cost S3 Glacier retrieval option, which you can use to retrieve large amounts, even petabytes, of data inexpensively in a day. Bulk retrievals are typically completed within 5–12 hours. + * **Bulk** – Bulk retrievals are the lowest-cost Glacier retrieval option, which you can use to retrieve large amounts, even petabytes, of data inexpensively in a day. Bulk retrievals are typically completed within 5–12 hours. @@ -93 +93 @@ If your workload requires highly reliable and predictable access to a subset of -You can purchase provisioned capacity units by using the S3 Glacier console, the [Purchase Provisioned Capacity (POST provisioned-capacity)](./api-PurchaseProvisionedCapacity.html) REST API operation, the AWS SDKs, or the AWS CLI. For provisioned capacity pricing information, see [Amazon S3 Glacier Pricing](https://aws.amazon.com/s3/glacier/pricing/). +You can purchase provisioned capacity units by using the Glacier console, the [Purchase Provisioned Capacity (POST provisioned-capacity)](./api-PurchaseProvisionedCapacity.html) REST API operation, the AWS SDKs, or the AWS CLI. For provisioned capacity pricing information, see [Amazon Glacier Pricing](https://aws.amazon.com/s3/glacier/pricing/). @@ -99 +99 @@ If the start date is on the 31st day of a month, the expiration date is the last -###### To purchase provisioned capacity by using the Amazon S3 Glacier console +###### To purchase provisioned capacity by using the Amazon Glacier console @@ -101 +101 @@ If the start date is on the 31st day of a month, the expiration date is the last - 1. Sign in to the AWS Management Console and open the S3 Glacier console at [https://console.aws.amazon.com/glacier/home](https://console.aws.amazon.com/glacier/home). + 1. Sign in to the AWS Management Console and open the Glacier console at [https://console.aws.amazon.com/glacier/home](https://console.aws.amazon.com/glacier/home). @@ -116 +116 @@ If the start date is on the 31st day of a month, the expiration date is the last -When you retrieve an archive from S3 Glacier, you can optionally specify a range, or portion, of the archive to retrieve. The default is to retrieve the whole archive. Specifying a range of bytes can be helpful when you want to do the following: +When you retrieve an archive from Glacier, you can optionally specify a range, or portion, of the archive to retrieve. The default is to retrieve the whole archive. Specifying a range of bytes can be helpful when you want to do the following: @@ -118 +118 @@ When you retrieve an archive from S3 Glacier, you can optionally specify a range - * Manage your data downloads – S3 Glacier allows retrieved data to be downloaded for 24 hours after the retrieval request is completed. Therefore, you might want to retrieve only portions of the archive so that you can manage the schedule of downloads within the given download window. + * Manage your data downloads – Glacier allows retrieved data to be downloaded for 24 hours after the retrieval request is completed. Therefore, you might want to retrieve only portions of the archive so that you can manage the schedule of downloads within the given download window.