Amazon Web Services, Inc.

Amazon Glacier

Amazon Glacier (Glacier) is a storage solution for "cold data." Glacier is an extremely low-cost storage service that provides secure, durable, and…

Developer tools#openapi#cloud

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Amazon Glacier (Glacier) is a storage solution for "cold data."

Glacier is an extremely low-cost storage service that provides secure,
durable, and easy-to-use storage for data backup and archival. With Glacier,
customers can store their data cost effectively for months, years, or decades.
Glacier also enables customers to offload the administrative burdens of operating and
scaling storage to AWS, so they don't have to worry about capacity planning, hardware
provisioning, data replication, hardware failure and recovery, or time-consuming hardware
migrations.

Glacier is a great storage choice when low storage cost is paramount and your
data is rarely retrieved. If your
application requires fast or frequent access to your data, consider using Amazon S3. For
more information, see Amazon Simple Storage Service
(Amazon S3) .

You can store any kind of data in any format. There is no maximum limit on the total
amount of data you can store in Glacier.

If you are a first-time user of Glacier, we recommend that you begin by
reading the following sections in the Amazon Glacier Developer
Guide :

What is
Amazon Glacier - This section of the Developer Guide describes the
underlying data model, the operations it supports, and the AWS SDKs that you can use
to interact with the service.

Getting Started
with Amazon Glacier - The Getting Started section walks you through the
process of creating a vault, uploading archives, creating jobs to download archives,
retrieving the job output, and deleting archives.

Endpoints 32

  • GETList parts/:accountId/vaults/:vaultName/multipart-uploads/:uploadId?marker=string&limit=0This operation lists the parts of an archive that have been uploaded in a specific multipart upload. You can make this request at any time during an…
  • PUTUpload multipart part/:accountId/vaults/:vaultName/multipart-uploads/:uploadIdThis operation uploads a part of an archive. You can upload archive parts in any order. You can also upload them in parallel. You can upload up to 10,000…
  • POSTComplete multipart upload/:accountId/vaults/:vaultName/multipart-uploads/:uploadIdYou call this operation to inform Amazon Glacier (Glacier) that all the archive parts have been uploaded and that Glacier can now assemble the archive from…
  • DELETEAbort multipart upload/:accountId/vaults/:vaultName/multipart-uploads/:uploadIdThis operation aborts a multipart upload identified by the upload ID. After the Abort Multipart Upload request succeeds, you cannot upload any more parts to…
  • GETGet vault lock/:accountId/vaults/:vaultName/lock-policyThis operation retrieves the following attributes from the lock-policy subresource set on the specified vault: The vault lock policy set on the vault. The…
  • POSTInitiate vault lock/:accountId/vaults/:vaultName/lock-policyThis operation initiates the vault locking process by doing the following: Installing a vault lock policy on the specified vault. Setting the lock state of…
  • DELETEAbort vault lock/:accountId/vaults/:vaultName/lock-policyThis operation aborts the vault locking process if the vault lock is not in the Locked state. If the vault lock is in the Locked state when this operation is…
  • GETList tags for vault/:accountId/vaults/:vaultName/tagsThis operation lists all the tags attached to a vault. The operation returns an empty map if there are no tags. For more information about tags, see Tagging…
  • POSTRemove tags from vault/:accountId/vaults/:vaultName/tags?operation=removeThis operation removes one or more tags from the set of tags attached to a vault. For more information about tags, see Tagging Amazon Glacier Resources . This…
  • POSTComplete vault lock/:accountId/vaults/:vaultName/lock-policy/:lockIdThis operation completes the vault locking process by transitioning the vault lock from the InProgress state to the Locked state, which causes the vault lock…
  • GETDescribe vault/:accountId/vaults/:vaultNameThis operation returns information about a vault, including the vault's Amazon Resource Name (ARN), the date the vault was created, the number of archives it…
  • PUTCreate vault/:accountId/vaults/:vaultNameThis operation creates a new vault with the specified name. The name of the vault must be unique within a region for an AWS account. You can create up to…
  • DELETEDelete vault/:accountId/vaults/:vaultNameThis operation deletes a vault. Amazon Glacier will delete a vault only if there are no archives in the vault as of the last inventory and there have been no…
  • DELETEDelete archive/:accountId/vaults/:vaultName/archives/:archiveIdThis operation deletes an archive from a vault. Subsequent requests to initiate a retrieval of this archive will fail. Archive retrievals that are in progress…
  • GETGet vault access policy/:accountId/vaults/:vaultName/access-policyThis operation retrieves the access-policy subresource set on the vault; for more information on setting this subresource, see Set Vault Access Policy (PUT…
  • PUTSet vault access policy/:accountId/vaults/:vaultName/access-policyThis operation configures an access policy for a vault and will overwrite an existing policy. To configure a vault access policy, send a PUT request to the…
  • DELETEDelete vault access policy/:accountId/vaults/:vaultName/access-policyThis operation deletes the access policy associated with the specified vault. The operation is eventually consistent; that is, it might take some time for…
  • GETGet vault notifications/:accountId/vaults/:vaultName/notification-configurationThis operation retrieves the notification-configuration subresource of the specified vault. For information about setting a notification configuration on a…
  • PUTSet vault notifications/:accountId/vaults/:vaultName/notification-configurationThis operation configures notifications that will be sent when specific events happen to a vault. By default, you don't get any notifications. To configure…
  • DELETEDelete vault notifications/:accountId/vaults/:vaultName/notification-configurationThis operation deletes the notification configuration set for a vault. The operation is eventually consistent; that is, it might take some time for Amazon…
  • GETDescribe job/:accountId/vaults/:vaultName/jobs/:jobIdThis operation returns information about a job you previously initiated, including the job initiation date, the user who initiated the job, the job status…
  • GETGet data retrieval policy/:accountId/policies/data-retrievalThis operation returns the current data retrieval policy for the account and region specified in the GET request. For more information about data retrieval…
  • PUTSet data retrieval policy/:accountId/policies/data-retrievalThis operation sets and then enacts a data retrieval policy in the region specified in the PUT request. You can set one policy per region for an AWS account.…
  • GETGet job output/:accountId/vaults/:vaultName/jobs/:jobId/outputThis operation downloads the output of the job you initiated using InitiateJob . Depending on the job type you specified when you initiated the job, the…
  • GETList jobs/:accountId/vaults/:vaultName/jobs?limit=0&marker=string&statuscode=string&completed=stringThis operation lists jobs for a vault, including jobs that are in-progress and jobs that have recently finished. The List Job operation returns a list of…
  • POSTInitiate job/:accountId/vaults/:vaultName/jobsThis operation initiates a job of the specified type, which can be a select, an archival retrieval, or a vault retrieval. For more information about using…
  • GETList multipart uploads/:accountId/vaults/:vaultName/multipart-uploads?limit=0&marker=stringThis operation lists in-progress multipart uploads for the specified vault. An in-progress multipart upload is a multipart upload that has been initiated by…
  • POSTInitiate multipart upload/:accountId/vaults/:vaultName/multipart-uploadsThis operation initiates a multipart upload. Amazon Glacier creates a multipart upload resource and returns its ID in the response. The multipart upload ID is…
  • GETList provisioned capacity/:accountId/provisioned-capacityThis operation lists the provisioned capacity units for the specified AWS account.
  • POSTPurchase provisioned capacity/:accountId/provisioned-capacityThis operation purchases a provisioned capacity unit for an AWS account.
  • GETList vaults/:accountId/vaults?marker=string&limit=0This operation lists all vaults owned by the calling user's account. The list returned in the response is ASCII-sorted by vault name. By default, this…
  • POSTUpload archive/:accountId/vaults/:vaultName/archivesThis operation adds an archive to a vault. This is a synchronous operation, and for a successful upload, your data is durably persisted. Amazon Glacier…

API details

Base URL
https://glacier.{region}.amazonaws.com
Authentication
AWS Signature Version 4 (requests signed with your AWS access key)
Operations
32 operations on 16 pathsGET 13POST 8DELETE 6PUT 5
Description format
AWS Smithy model, API version 2012-06-01

How to test the Amazon Glacier in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Amazon Glacier collection, without the publisher's secrets.
  3. Add your credentialsThis API uses AWS Signature Version 4 (requests signed with your AWS access key). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List parts” (GET /:accountId/vaults/:vaultName/multipart-uploads/:uploadId?marker=string&limit=0), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Amazon Glacier?

Amazon Glacier (Glacier) is a storage solution for "cold data." Glacier is an extremely low-cost storage service that provides secure, durable, and… It is listed under Developer tools and has 32 endpoints.

Who publishes the Amazon Glacier?

It is listed from Amazon Web Services, Inc.'s public API description (an OpenAPI document), not published by Amazon Web Services, Inc. on Swastik Codes. Anyone who controls amazonaws.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Amazon Glacier?

Requests go to https://glacier.{region}.amazonaws.com. Endpoint paths are added to this base URL.

How do I authenticate with the Amazon Glacier?

With AWS Signature Version 4 (requests signed with your AWS access key).

How many endpoints does the Amazon Glacier have?

32 operations on 16 paths (13 GET, 8 POST, 6 DELETE, 5 PUT).

Is forking the Amazon Glacier free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.