API Permissions Reference
When you are setting up How Amazon S3 Glacier works with IAM and writing a permissions policy that you can attach to an IAM identity (identity-based policies) or a resource (resource-based policies), you can use the following table as a reference. The table lists each S3 Glacier API operation, the corresponding actions for which you can grant permissions to perform the action, and the Amazon resource for which you can grant the permissions.
You specify the actions in the policy's Action
element, and you specify the resource value in the policy's Resource
element. Also, you can use the IAM policy language Condition
element to specify when a policy should take effect.
To specify an action, use the glacier:
prefix followed by the API operation name (for example, glacier:CreateVault
). For most S3 Glacier actions, Resource
is the vault on which you want to grant the permissions. You specify a vault as the Resource
value by using the vault ARN. To express conditions, you use predefined condition keys. For more information, see Resource-based policies within S3 Glacier.
The following table lists actions that can be used with identity-based policies and resource-based policies.
Note
Some actions can only be used with identity-based policies. These actions are marked by an asterisk (*) after the name of the API operation in the first column.
If you see an expand arrow (↗) in the upper-right corner of the table, you can open the table in a new window. To close the window, choose the close button (X) in the lower-right corner.
Amazon S3 Glacier API and Required Permissions
for Actions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
S3 Glacier API Operations | Required Permissions (API Actions) | Resources | Condition Keys | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Abort Multipart Upload (DELETE uploadID) | glacier:AbortMultipartUpload |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Abort Vault Lock (DELETE lock-policy) | glacier:AbortVaultLock |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Add Tags To Vault (POST tags add) | glacier:AddTagsToVault |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Complete Multipart Upload (POST uploadID) | glacier:CompleteMultipartUpload |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Complete Vault Lock (POST lockId) | glacier:CompleteVaultLock |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Create Vault (PUT vault) * | glacier:CreateVault |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Delete Archive (DELETE archive) | glacier:DeleteArchive |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Delete Vault (DELETE vault) | glacier:DeleteVault |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Delete Vault Access Policy (DELETE access-policy) | glacier:DeleteVaultAccessPolicy |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Delete Vault Notifications (DELETE notification-configuration) | glacier:DeleteVaultNotifications |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Describe Job (GET JobID) | glacier:DescribeJob |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Describe Vault (GET vault) | glacier:DescribeVault |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get Data Retrieval Policy (GET policy) * | glacier:GetDataRetrievalPolicy |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get Job Output (GET output) | glacier:GetJobOutput |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get Vault Access Policy (GET access-policy) | glacier:GetVaultAccessPolicy |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get Vault Lock (GET lock-policy) | glacier:GetVaultLock |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Get Vault Notifications (GET notification-configuration) | glacier:GetVaultNotifications |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Initiate Job (POST jobs) | glacier:InitiateJob |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Initiate Multipart Upload (POST multipart-uploads) | glacier:InitiateMultipartUpload |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Initiate Vault Lock (POST lock-policy) | glacier:InitiateVaultLock |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List Jobs (GET jobs) | glacier:ListJobs |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List Multipart Uploads (GET multipart-uploads) | glacier:ListMultipartUploads |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List Parts (GET uploadID) | glacier:ListParts |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List Tags For Vault (GET tags) | glacier:ListTagsForVault |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List Vaults (GET vaults) | glacier:ListVaults |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Remove Tags From Vault (POST tags remove) | glacier:RemoveTagsFromVault |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set Data Retrieval Policy (PUT policy) * | glacier:SetDataRetrievalPolicy |
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set Vault Access Policy (PUT access-policy) | glacier:SetVaultAccessPolicy |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Set Vault Notification Configuration (PUT notification-configuration) | glacier:SetVaultNotifications |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Upload Archive (POST archive) | glacier:UploadArchive |
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Upload Part (PUT uploadID) | glacier:UploadMultipartPart |
|
|