AWS amazonglacier documentation change
Summary
Updated service name references from 'Glacier' to 'Amazon Glacier', added deprecation notice for original standalone Glacier service (no new customers after 2025), and emphasized migration to S3 Glacier storage classes
Security assessment
Changes primarily involve branding updates (service name standardization) and service lifecycle notifications. The deprecation notice is operational guidance rather than a security fix. No security vulnerabilities, encryption changes, access control updates, or authentication mechanisms were modified or documented.
Diff
diff --git a/amazonglacier/latest/dev/api-initiate-job-post.md b/amazonglacier/latest/dev/api-initiate-job-post.md index d21a20883..6194b9a2b 100644 --- a//amazonglacier/latest/dev/api-initiate-job-post.md +++ b//amazonglacier/latest/dev/api-initiate-job-post.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 @@ Initializing an Archive or Vault Inventory Retrieval Job RequestsResponsesExampl -**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 @@ Initializing an Archive or Vault Inventory Retrieval Job RequestsResponsesExampl -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/). @@ -13 +15 @@ If you're looking for archival storage solutions we suggest using the Glacier st -This operation initiates the following types of Amazon Glacier (Glacier) jobs: +This operation initiates the following types of Amazon Glacier (Amazon Glacier) jobs: @@ -45 +47 @@ Retrieving an archive or a vault inventory are asynchronous operations that requ -A data retrieval policy can cause your initiate retrieval job request to fail with a `PolicyEnforcedException`. 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). +A data retrieval policy can cause your initiate retrieval job request to fail with a `PolicyEnforcedException`. For more information about data retrieval policies, see [Amazon Glacier Data Retrieval Policies](./data-retrieval-policy.html). For more information about the `PolicyEnforcedException` exception, see [Error Responses](./api-error-responses.html). @@ -52 +54 @@ A data retrieval policy can cause your initiate retrieval job request to fail wi -The retrieval request is ran asynchronously. When you initiate a retrieval job, Glacier creates a job and returns a job ID in the response. When Glacier completes the job, you can get the job output (archive or inventory data). For information about getting job output, see the [Get Job Output (GET output)](./api-job-output-get.html) operation. +The retrieval request is ran asynchronously. When you initiate a retrieval job, Amazon Glacier creates a job and returns a job ID in the response. When Amazon Glacier completes the job, you can get the job output (archive or inventory data). For information about getting job output, see the [Get Job Output (GET output)](./api-job-output-get.html) operation. @@ -56 +58 @@ The job must complete before you can get its output. To determine when a job is - * Use an Amazon SNS notification— You can specify an Amazon SNS topic to which Glacier can post a notification after the job is completed. You can specify an SNS topic per job request. The notification is sent only after Glacier completes the job. In addition to specifying an SNS topic per job request, you can configure vault notifications for a vault so that job notifications are sent for all retrievals. For more information, see [Set Vault Notification Configuration (PUT notification-configuration)](./api-vault-notifications-put.html). + * Use an Amazon SNS notification— You can specify an Amazon SNS topic to which Amazon Glacier can post a notification after the job is completed. You can specify an SNS topic per job request. The notification is sent only after Amazon Glacier completes the job. In addition to specifying an SNS topic per job request, you can configure vault notifications for a vault so that job notifications are sent for all retrievals. For more information, see [Set Vault Notification Configuration (PUT notification-configuration)](./api-vault-notifications-put.html). @@ -67 +69 @@ The information you get via notification is same that you get by calling [Descri -If for a specific event, you add both the notification configuration on the vault and also specify an SNS topic in your initiate job request, Glacier sends both notifications. For more information, see [Set Vault Notification Configuration (PUT notification-configuration)](./api-vault-notifications-put.html). +If for a specific event, you add both the notification configuration on the vault and also specify an SNS topic in your initiate job request, Amazon Glacier sends both notifications. For more information, see [Set Vault Notification Configuration (PUT notification-configuration)](./api-vault-notifications-put.html). @@ -71 +73 @@ If for a specific event, you add both the notification configuration on the vaul -Glacier updates a vault inventory approximately once a day, starting on the day you first upload an archive to the vault. If there have been no archive additions or deletions to the vault since the last inventory, the inventory date is not updated. When you initiate a job for a vault inventory, Glacier returns the last inventory it generated, which is a point-in-time snapshot and not real-time data. +Amazon Glacier updates a vault inventory approximately once a day, starting on the day you first upload an archive to the vault. If there have been no archive additions or deletions to the vault since the last inventory, the inventory date is not updated. When you initiate a job for a vault inventory, Amazon Glacier returns the last inventory it generated, which is a point-in-time snapshot and not real-time data. @@ -73 +75 @@ Glacier updates a vault inventory approximately once a day, starting on the day -After Glacier creates the first inventory for the vault, it typically takes half a day and up to a day before that inventory is available for retrieval. +After Amazon Glacier creates the first inventory for the vault, it typically takes half a day and up to a day before that inventory is available for retrieval. @@ -75 +77 @@ After Glacier creates the first inventory for the vault, it typically takes half -You might not find it useful to retrieve a vault inventory for each archive upload. However, suppose that you maintain a database on the client-side associating metadata about the archives you upload to Glacier. Then, you might find the vault inventory useful to reconcile information, as needed, in your database with the actual vault inventory. For more information about the data fields returned in an inventory job output, see [Response Body](./api-job-output-get.html#api-job-output-get-responses-elements). +You might not find it useful to retrieve a vault inventory for each archive upload. However, suppose that you maintain a database on the client-side associating metadata about the archives you upload to Amazon Glacier. Then, you might find the vault inventory useful to reconcile information, as needed, in your database with the actual vault inventory. For more information about the data fields returned in an inventory job output, see [Response Body](./api-job-output-get.html#api-job-output-get-responses-elements). @@ -103 +105 @@ When initiating an archive retrieval job, you can specify one of the following o - * **`Bulk`** – Bulk is the lowest-cost tier for Glacier, enabling you to retrieve large amounts, even petabytes, of data inexpensively in a day. Data accessed using the Bulk tier is typically made available within 5–12 hours. + * **`Bulk`** – Bulk is the lowest-cost tier for Amazon Glacier, enabling you to retrieve large amounts, even petabytes, of data inexpensively in a day. Data accessed using the Bulk tier is typically made available within 5–12 hours. @@ -108 +110 @@ When initiating an archive retrieval job, you can specify one of the following o -For more information about expedited and bulk retrievals, see [Retrieving Glacier Archives](./downloading-an-archive-two-steps.html). +For more information about expedited and bulk retrievals, see [Retrieving Amazon Glacier Archives](./downloading-an-archive-two-steps.html). @@ -112 +114 @@ For more information about expedited and bulk retrievals, see [Retrieving Glacie -To initiate a job, you use the HTTP `POST` method and scope the request to the vault's `jobs` subresource. You specify details of the job request in the JSON document of your request. The job type is specified with the `Type` field. Optionally, you can specify an `SNSTopic` field to indicate an Amazon SNS topic to which Glacier can post notification after it completes the job. +To initiate a job, you use the HTTP `POST` method and scope the request to the vault's `jobs` subresource. You specify details of the job request in the JSON document of your request. The job type is specified with the `Type` field. Optionally, you can specify an `SNSTopic` field to indicate an Amazon SNS topic to which Amazon Glacier can post notification after it completes the job. @@ -116 +118 @@ To initiate a job, you use the HTTP `POST` method and scope the request to the v -To post a notification to Amazon SNS, you must create the topic yourself if it doesn't already exist. Glacier doesn't create the topic for you. The topic must have permissions to receive publications from a Glacier vault. Glacier doesn't verify if the vault has permission to publish to the topic. If the permissions are not configured appropriately, you might not receive notification even after the job completes. +To post a notification to Amazon SNS, you must create the topic yourself if it doesn't already exist. Amazon Glacier doesn't create the topic for you. The topic must have permissions to receive publications from a Amazon Glacier vault. Amazon Glacier doesn't verify if the vault has permission to publish to the topic. If the permissions are not configured appropriately, you might not receive notification even after the job completes. @@ -221 +223 @@ _Required_ : Yes -Glacier creates the job. In the response, it returns the URI of the job. +Amazon Glacier creates the job. In the response, it returns the URI of the job.