Amazon S3 Glacier
开发人员指南 (API 版本 2012-06-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

管理您的 Amazon S3 Glacier 资源的访问权限概述

每个 AWS 资源都归某个 AWS 账户所有,创建和访问资源的权限由权限策略进行管理。账户管理员可以向 IAM 身份(即:用户、组和角色)附加权限策略,某些服务(如 Amazon S3 Glacier (Glacier))也支持向资源附加权限策略。

注意

账户管理员(或管理员用户)是具有管理员权限的用户。有关更多信息,请参阅 IAM 用户指南 中的 IAM 最佳实践

在授予权限时,您要决定谁获得权限,获得对哪些资源的权限,以及您允许对这些资源执行的具体操作。

Amazon S3 Glacier 资源和操作

在 Glacier 中,主要资源为文件库。Glacier 仅支持文件库级别的策略。换言之,在 IAM 策略中,您指定的 Resource 值可以为某个特定的文件库或特定 AWS 区域中的一组文件库。Glacier 不支持档案级别的权限。

对于所有 Glacier 操作,Resource 指定要授予其权限的文件库。这些资源具有关联的唯一 Amazon 资源名称 (ARN)(如下表所示),您可以在 ARN 中使用通配符 (*) 来匹配任何文件库名称。

资源类型 ARN 格式
文件库 arn:aws:glacier:region:account-id:vaults/vault-name
名称以“example”开头的文件库 arn:aws:glacier:region:account-id:vaults/example*
一个地区的所有文件库 arn:aws:glacier:region:account-id:vaults/*

Glacier 提供一组操作用来处理 Glacier 资源。有关可用操作的信息,请参阅 Glacier 的 API 参考

了解资源所有权

资源所有者 是创建资源的 AWS 账户。也就是说,资源所有者是委托人实体(根账户、IAM 用户或 IAM 角色)的 AWS 账户。以下示例说明了它的工作原理:

  • 如果使用您的 AWS 账户的根账户凭证来创建 Glacier 文件库,则您的 AWS 账户就是该资源的所有者(在 Glacier 中,资源就是 Glacier 文件库)。

  • 如果您在您的 AWS 账户中创建 IAM 用户并向该用户授予创建 Glacier 文件库的权限,则该用户可以创建 Glacier 文件库。但是,您的 AWS 账户(即该用户所属的账户)拥有这些 Glacier 文件库资源。

  • 如果您在您的 AWS 账户中创建具有创建 Glacier 文件库的权限的 IAM 角色,则能够代入该角色的任何人都可以创建 Glacier 文件库。您的 AWS 账户(即该角色所属的账户)拥有 Glacier 文件库资源。

管理对资源的访问

权限策略 规定谁可以访问哪些内容。下一节介绍创建权限策略时的可用选项。

注意

本节讨论如何在 Glacier 范围内使用 IAM。它不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档,请参阅 IAM 用户指南 中的什么是 IAM?。有关 IAM 策略语法和说明的信息,请参阅 IAM 用户指南中的 AWS IAM 策略参考

附加到 IAM 身份的策略称为基于身份的 策略(IAM 策略),而附加到资源的策略称为基于资源的 策略。Glacier 支持基于身份的策略(IAM 策略)和基于资源的策略。

基于身份的策略(IAM 策略)

您可以向 IAM 身份挂载策略。例如,您可以执行以下操作:

  • 向您账户中的用户或组附加权限策略– 账户管理员可以使用与特定用户关联的权限策略向该用户授予创建 Glacier 文件库的权限。

  • 向角色附加权限策略(授予跨账户权限)– 您可以向 IAM 角色附加基于身份的权限策略,以授予跨账户的权限。例如,账户 A 中的管理员可以创建一个角色,以向其他 AWS 账户(如账户 B)或某项 AWS 服务授予跨账户权限,如下所述:

    1. 账户 A 管理员可以创建一个 IAM 角色,然后向该角色附加授予其访问账户 A 中资源的权限策略。

    2. 账户 A 管理员可以向将账户 B 标识为能够担任该角色的委托人的角色附加信任策略。

    3. 之后,账户 B 管理员可以委派权限,指派账户 B 中的任何用户担任该角色。这样,账户 B 中的用户就可以创建或访问账户 A 中的资源了。如果您需要授予 AWS 服务权限来担任该角色,则信任策略中的委托人也可以是 AWS 服务委托人。

    有关使用 IAM 委派权限的更多信息,请参阅 IAM 用户指南 中的访问权限管理

以下是一个示例策略,该策略使用标识 us-west-2 AWS 区域中的所有文件库的 Amazon 资源名称 (ARN) 来授予对资源执行 3 项与 Glacier 文件库相关的操作(glacier:CreateVaultglacier:DescribeVaultglacier:ListVaults)的权限。ARN 用于唯一地标识 AWS 资源。有关与 Glacier 结合使用的 ARN 的更多信息,请参阅 Amazon S3 Glacier 资源和操作

{ "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 结尾处的通配符 (*) 表示此语句可匹配任何文件库名称。

重要

在授予使用 glacier:CreateVault 操作创建文件库的权限时,您必须指定通配符 (*),因为您在创建文件库之前不知道文件库的名称。

有关对 Glacier 使用基于身份的策略的更多信息,请参阅为 Amazon S3 Glacier 使用基于身份的策略(IAM 策略)。有关用户、组、角色和权限的更多信息,请参阅 IAM 用户指南 中的身份(用户、组和角色)

 

基于资源的策略(Amazon S3 Glacier 文件库策略)

每个 Glacier 文件库都可以有关联的基于资源的权限策略。对于 Glacier,Glacier 文件库是主要资源,基于资源的策略称作文件库策略

可使用 Glacier 文件库策略按以下方式管理权限:

  • 在单个文件库策略而不是单个用户策略中管理您账户中的用户权限。

  • 作为使用 IAM 角色的替代方案,可以管理跨账户权限。

Glacier 文件库可以有一个文件库访问策略和一个文件库锁定策略与之关联。Glacier 文件库访问策略 是一种基于资源的策略,可用于管理对文件库的权限。文件库锁定策略 是可锁定的文件库访问策略。在锁定文件库锁定策略后,无法更改策略。可以使用文件库锁定策略来实施合规性控制。

可以使用文件库策略向所有用户授予权限,也可以通过直接将策略挂载到文件库资源来仅允许几个 AWS 账户访问文件库。例如,可以使用 Glacier 文件库策略向所有 AWS 账户授予只读权限或向几个 AWS 账户授予上传档案的权限。

在您需要与其他 AWS 账户共享您的文件库时,可使用文件库策略轻松授予跨账户访问权。例如,只需在文件库策略中包含另一个 AWS 账户和允许的操作,即可向使用该账户的业务合作伙伴授予对该文件库的只读访问权。您可以通过此方式向多个用户授予跨账户访问权,并通过一个位置查看文件库访问策略中具有跨账户访问权的所有用户。有关针对跨账户访问的文件库策略的示例,请参阅示例 1:授予特定的 Amazon S3 Glacier 操作的跨账户权限

下面是一个 Glacier 文件库策略(基于资源的策略)的示例。该示例策略向所有 AWS 账户授予执行 glacier:InitiateJobglacier:GetJobOutput 操作的权限。该策略允许任何 AWS 账户从指定的文件库中检索数据。

{ "Version":"2012-10-17", "Statement":[ { "Sid": "add-read-only-perm", "Principal": "*", "Effect": "Allow", "Action": [ "glacier:InitiateJob", "glacier:GetJobOutput" ], "Resource": [ "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault" ] } ] }

有关为 Glacier 使用文件库策略的更多信息,请参阅使用适用于 Amazon S3 Glacier 的基于资源的策略(文件库策略)。有关与基于资源的策略相对的 IAM 角色(基于身份的策略)的其他信息,请参阅 IAM 用户指南 中的 IAM 角色与基于资源的策略有何不同

指定策略元素:操作、效果、资源和委托人

对于每种 Glacier 资源,该服务都定义了一组 API 操作(请参阅 Glacier 的 API 参考)。为授予这些 API 操作的权限,Glacier 定义了一组您可以在策略中指定的操作。请注意,执行某项 API 操作可能需要执行多个操作的权限。在授予特定操作的权限时,您也可以标识允许或拒绝对其执行操作的资源。

以下是最基本的策略元素:

  • Resource – 在策略中,您可以使用 Amazon 资源名称 (ARN) 标识策略应用到的资源。有关更多信息,请参阅Amazon S3 Glacier 资源和操作

  • Actions – 您可以使用操作关键字标识要允许或拒绝的资源操作。

    例如,glacier:CreateVault 权限允许执行 Glacier Create Vault 操作的用户权限。

  • Effect – 您可以指定当用户请求特定操作(可以是允许或拒绝)时的效果。如果没有显式授予 (允许) 对资源的访问权限,则隐式拒绝访问。您也可显式拒绝对资源的访问,这样可确保用户无法访问该资源,即使有其他策略授予了访问权限的情况下也是如此。

  • Principal – 在基于身份的策略(IAM 策略)中,附加了策略的用户是隐式委托人。对于基于资源的策略,您可以指定要接收权限的用户、账户、服务或其他实体 (仅适用于基于资源的策略)。

有关 IAM 策略语法和说明的更多信息,请参阅 IAM 用户指南 中的 AWS IAM 策略参考

有关显示所有 Glacier API 操作及其适用的资源的表,请参阅 Amazon S3 Glacier API 权限:操作、资源和条件参考

在策略中指定条件

当您授予权限时,可使用 IAM 策略语言来指定规定策略何时生效的条件。例如,您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息,请参阅 IAM 用户指南 中的条件

AWS 为支持通过 IAM 进行访问控制的所有 AWS 服务提供了一组预定义条件键(称作 AWS 范围条件键)。AWS 范围条件键使用前缀 aws。Glacier 在文件库访问和文件库锁定策略中支持所有 AWS 范围条件键。例如,您可以使用 aws:MultiFactorAuthPresent 条件键要求在请求执行操作时进行多重验证 (MFA)。有关更多信息和 AWS 范围条件键的列表,请参阅 IAM 用户指南 中的可用的条件键

注意

条件键区分大小写。

此外,Glacier 自身也提供条件键,您可以在 IAM 权限策略的 Condition 元素中包含这些条件键。Glacier – 特定的条件键仅在授予 Glacier 特定的权限时适用。Glacier 条件键名称的前缀为 glacier:。下表显示了适用于 Glacier 资源的 Glacier 条件键。

Glacier 条件键 说明 值类型
glacier:ArchiveAgeInDays 用于估算存档已在文件库中存储的时间长度(以天为单位)。 整数
glacier:ResourceTag/TagKey 允许您在策略中使用标签。有关资源标记的信息,请参阅使用标签管理访问控制 字符串

有关使用 Glacier 特定的条件键的示例,请参阅使用文件库锁定策略的 Amazon S3 Glacier 访问控制

相关主题