

 **此页面仅适用于使用文件库和 2012 年原始 REST API 的 Amazon Glacier 服务的现有客户。**

如果您正在寻找归档存储解决方案，建议使用 Amazon S3 中的 Amazon Glacier 存储类别 S3 Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive。要了解有关这些存储选项的更多信息，请参阅 [Amazon Glacier 存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)。

Amazon Glacier（最初基于保管库的独立服务）不再接受新客户。Amazon Glacier 是一项独立的服务 APIs ，拥有自己的服务，可将数据存储在文件库中，不同于亚马逊 S3 和 Amazon S3 Glacier 存储类别。在 Amazon Glacier 中，您现有的数据将确保安全，并且可以无限期地访问。无需进行迁移。对于低成本、长期的存档存储， AWS 建议[使用 Amazon S3 Glacier 存储类别，这些存储类别](https://aws.amazon.com/s3/storage-classes/glacier/)基于S3存储桶 APIs、完全 AWS 区域 可用性、更低的成本和 AWS 服务集成，可提供卓越的客户体验。如果您希望加强功能，可以考虑使用我们的 [AWS 将数据从 Amazon Glacier 文件库传输到 Amazon S3 Glacier 存储类别的解决方案指南](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)，迁移到 Amazon S3 Glacier 存储类别。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Amazon Glacier 基于身份的策略示例
<a name="security_iam_id-based-policy-examples"></a>

默认情况下，用户和角色没有创建或修改 Amazon Glacier 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》**中的[创建 IAM 策略（控制台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。

有关 Amazon Glacier 定义的操作和资源类型（包括每种资源类型的格式）的详细信息，请参阅《*服务授权参考*》中的 [Amazon Glacier 操作、资源和条件密钥](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3glacier.html)。 ARNs 

以下是一个策略示例，该策略使用标识该地区所有文件库的 Amazon 资源名称 (`glacier:CreateVault`ARN`glacier:ListVaults`) 授予对资源执行三项与 Amazon Glacier 文件库相关的操作（、`glacier:DescribeVault`和）的权限。`us-west-2` AWS ARNs 唯一标识 AWS 资源。有关与 Amazon Glacier 配合 ARNs 使用的更多信息，请参阅[Amazon Glacier 的策略资源](security_iam_service-with-iam.md#security_iam_service-with-iam-id-based-policies-resources)。

------
#### [ JSON ]

****  

```
      {
         "Version":"2012-10-17",		 	 	 
         "Statement": [
            {
               "Effect": "Allow",
               "Action": [
               "glacier:CreateVault",
               "glacier:DescribeVault",
               "glacier:ListVaults"
               ],
               "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/*"
            }
         ]
      }
```

------

此策略授予在 `us-west-2` 区域中创建、列出和获取文件库描述的权限。ARN 结尾处的通配符（\$1）表示此语句可匹配任何文件库名称。

**重要**  
在授予使用 `glacier:CreateVault` 操作创建文件库的权限时，您必须指定通配符（\$1），因为您在创建文件库之前不知道文件库的名称。

**Topics**
+ [策略最佳实践](#security_iam_service-with-iam-policy-best-practices)
+ [使用 Amazon Glacier 控制台](#security_iam_id-based-policy-examples-console)
+ [允许用户查看他们自己的权限](#id-based-policy-view-own-permissions)
+ [客户托管策略示例](#id-based-policy-customer-managed)

## 策略最佳实践
<a name="security_iam_service-with-iam-policy-best-practices"></a>

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 Amazon Glacier 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：
+ **开始使用 AWS 托管策略并转向最低权限权限** — 要开始向用户和工作负载授予权限，请使用为许多常见用例授予权限的*AWS 托管策略*。它们在你的版本中可用 AWS 账户。我们建议您通过定义针对您的用例的 AWS 客户托管策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》**中的 [AWS 托管策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)或[工作职能的AWS 托管策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)。
+ **应用最低权限**：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为*最低权限许可*。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的策略和权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。
+ **使用 IAM 策略中的条件进一步限制访问权限**：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果服务操作是通过特定 AWS 服务的（例如）使用的，则也可以使用条件来授予对服务操作的访问权限 CloudFormation。有关更多信息，请参阅《IAM 用户指南》**中的 [IAM JSON 策略元素：条件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)。
+ **使用 IAM Access Analyzer 验证您的 IAM 策略，以确保权限的安全性和功能性**：IAM Access Analyzer 会验证新策略和现有策略，以确保策略符合 IAM 策略语言（JSON）和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》**中的[使用 IAM Access Analyzer 验证策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重身份验证 (MFA**)-如果 AWS 账户您的场景需要 IAM 用户或根用户，请启用 MFA 以提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》**中的[使用 MFA 保护 API 访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)。

有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》**中的 [IAM 中的安全最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。

## 使用 Amazon Glacier 控制台
<a name="security_iam_id-based-policy-examples-console"></a>

要访问 Amazon Glacier 控制台，您必须具有一组最低的权限。这些权限必须允许您列出和查看有关您的 AWS 账户中 Amazon Glacier 资源的详细信息。如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。

对于仅调用 AWS CLI 或 AWS API 的用户，您无需为其设置最低控制台权限。相反，只允许访问与其尝试执行的 API 操作相匹配的操作。

Amazon Glacier 控制台为您提供了一个创建和管理 Amazon Glacier 文件库的集成环境。至少要向您创建的 IAM 身份授予执行 `glacier:ListVaults` 操作的权限才能查看 Amazon Glacier 控制台，如以下示例所示。

------
#### [ JSON ]

****  

```
         {
               "Version":"2012-10-17",		 	 	 
               "Statement": [
                  {
                     "Action": [
                     "glacier:ListVaults"     
                     ],
                     "Effect": "Allow",
                     "Resource": "*"
                  }
               ]
            }
```

------

AWS 通过提供由创建和管理的独立 IAM 策略来解决许多常见用例 AWS。托管策略可针对常见使用案例授予必要权限，因此，您无需自行调查具体需要哪些权限。有关更多信息，请参阅《IAM 用户指南》**中的 [AWS 托管式策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies)。

以下 AWS 托管策略仅适用于 Amazon Glacier，您可以将其附加到账户中的用户：

 
+ **AmazonGlacierReadOnlyAccess**— 通过授予对 Amazon Glacier 的只读访问权限 AWS 管理控制台。
+ **AmazonGlacierFullAccess**— 授予通过 Amazon Glacier 的完全访问权限 AWS 管理控制台。

 

此外，您还可以创建自定义 IAM 策略，以授予 Amazon Glacier API 操作和资源的相关权限。您可以将这些自定义策略附加到您为 Amazon Glacier 文件库创建的自定义 IAM 角色。

下一节中讨论的两个 Amazon Glacier AWS 托管策略都授予权限`glacier:ListVaults`。

有关更多信息，请参阅《IAM 用户指南》**中的[为用户添加权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。

## 允许用户查看他们自己的权限
<a name="id-based-policy-view-own-permissions"></a>

该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 AWS CLI 或 AWS API 以编程方式完成此操作的权限。

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}
```

## 客户托管策略示例
<a name="id-based-policy-customer-managed"></a>

本节的用户策略示例介绍如何授予各 Amazon Glacier 操作的权限。这些策略在您使用 Amazon Glacier REST API、亚马逊 SDKs AWS CLI、或亚马逊 Glacier 管理控制台（如果适用）时起作用。

**注意**  
所有示例都使用美国西部（俄勒冈）区域 (`us-west-2`)，并包含虚构账户。 IDs

**Topics**
+ [示例 1：允许用户从文件库下载档案](#vault-access-policy-example-init-jobs)
+ [示例 2：允许用户创建文件库和配置通知](#vault-access-policy-example-create-vault)
+ [示例 3：允许用户将档案上传到特定文件库](#vault-access-policy-example-upload-archives)
+ [示例 4：授予用户对特定文件库的完全权限](#vault-access-policy-example-full-permission)

### 示例 1：允许用户从文件库下载档案
<a name="vault-access-policy-example-init-jobs"></a>

要下载档案，您首先要启动任务以检索档案。在检索任务完成后，您可以下载数据。以下示例策略授予执行 `glacier:InitiateJob` 操作以启动任务（这将允许用户从文件库中检索档案或文件库清单）的权限和执行 `glacier:GetJobOutput` 操作以下载检索到的数据的权限。此策略还授予执行 `glacier:DescribeJob` 操作的权限，以便用户能够获取任务状态。有关更多信息，请参阅[启动任务（POST jobs）](api-initiate-job-post.md)。

此策略授予对名为 `examplevault` 的文件库的这些权限。您可以从 [Amazon Glacier 控制台](https://console.aws.amazon.com/glacier/home)获取文件库 ARN，也可以通过调用[描述文件库（GET vault）](api-vault-get.md)或[列出文件库（GET vaults）](api-vaults-get.md) API 操作以编程方式获取文件库 ARN。

### 示例 2：允许用户创建文件库和配置通知
<a name="vault-access-policy-example-create-vault"></a>

以下示例策略授予在 `Resource` 元素所指定的 us-west-2 区域中创建文件库以及配置通知的权限。有关使用通知的更多信息，请参阅[在 Amazon Glacier 中配置文件库通知](configuring-notifications.md)。该政策还授予 AWS 在该地区列出文件库并获取特定文件库描述的权限。

**重要**  
在授予使用 `glacier:CreateVault` 操作创建文件库的权限时，您必须在 `Resource` 值中指定通配符（\$1），因为您在创建文件库之前不知道文件库的名称。

### 示例 3：允许用户将档案上传到特定文件库
<a name="vault-access-policy-example-upload-archives"></a>

以下示例策略授予将档案上传到 us-west-2 区域中的特定文件库的权限。借助这些权限，用户可以使用[上传档案（POST archive）](api-archive-post.md)API 操作一次性上传整个档案，或者使用[启动分段上传（POST multipart-uploads）](api-multipart-initiate-upload.md)API 操作分段上传。



### 示例 4：授予用户对特定文件库的完全权限
<a name="vault-access-policy-example-full-permission"></a>

以下示例策略授予对名为 `examplevault` 的文件库执行所有 Amazon Glacier 操作的权限。





