本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 管理对 Amazon DocumentDB 资源的访问权限
每个 AWS 资源都归人所有 AWS 账户，创建或访问资源的权限受权限策略的约束。账户管理员可以向 IAM 身份（即用户、群组和角色）附加权限策略，某些服务（例如 AWS Lambda）还支持向资源附加权限策略。
**注意**
*账户管理员* (或管理员用户) 是具有管理员权限的用户。有关更多信息，请参阅*《IAM 用户指南》*中的 [IAM 最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)。
**Topics**
+ [Amazon DocumentDB 资源和操作](#CreatingIAMPolicies-RDS)
+ [了解资源所有权](#UsingWithRDS.IAM.AccessControl.ResourceOwner)
+ [管理对 资源的访问](#UsingWithRDS.IAM.AccessControl.ManagingAccess)
+ [指定策略元素：操作、效果、资源和主体](#SpecifyingIAMPolicyActions-RDS)
+ [在策略中指定条件](#SpecifyingIAMPolicyConditions-RDS)
## Amazon DocumentDB 资源和操作
在 Amazon DocumentDB 中，主要资源是*集群*。Amazon DocumentDB 支持可配合主要资源一起使用的其他资源，如*实例*、*参数组*和*事件订阅*。这些资源称作*子资源*。
这些资源和子资源具有与之关联的唯一 Amazon 资源名称 (ARNs)，如下表所示。
| **资源类型** | **ARN 格式** |
| --- | --- |
| Cluster | `arn:aws:rds:region:account-id:cluster:db-cluster-name` |
| 集群参数组 | `arn:aws:rds:region:account-id:cluster-pg:cluster-parameter-group-name` |
| 集群快照 | `arn:aws:rds:region:account-id:cluster-snapshot:cluster-snapshot-name` |
| 实例 | `arn:aws:rds:region:account-id:db:db-instance-name` |
| 安全组 | `arn:aws:rds:region:account-id:secgrp:security-group-name` |
| 子网组 | `arn:aws:rds:region:account-id:subgrp:subnet-group-name` |
Amazon DocumentDB 提供一组操作来处理 Amazon DocumentDB 资源。有关可用操作的列表，请参阅[操作](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_Operations.html)。
## 了解资源所有权
*资源所有者* AWS 账户 是创建资源的人。也就是说，资源所有者是 AWS 账户 对创建资源的请求进行身份验证的*委托人实体*（根账户、IAM 用户或 IAM 角色）。以下示例说明了它的工作原理：
+ 如果您使用您的 AWS 账户 根账户证书创建亚马逊文档数据库资源（例如实例），则您 AWS 账户 就是亚马逊文档数据库资源的所有者。
+ 如果您在中创建 IAM 用户 AWS 账户 并向该用户授予创建 Amazon DocumentDB 资源的权限，则该用户可以创建 Amazon DocumentDB 资源。但是，用户所属的您 AWS 账户拥有亚马逊 DocumentDB 资源。
+ 如果您在中创建 AWS 账户 具有创建 Amazon DocumentDB 资源的权限的 IAM 角色，则任何能够担任该角色的人都可以创建 Amazon DocumentDB 资源。该角色所属的您 AWS 账户拥有亚马逊 DocumentDB 资源。
## 管理对 资源的访问
*权限策略*规定谁可以访问哪些内容。下一节介绍创建权限策略时的可用选项。
**注意**
本节讨论在 Amazon DocumentDB 背景下使用 IAM。这里不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档，请参阅《IAM 用户指南》中的[什么是 IAM？](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html)。有关 IAM policy 略语法和说明的信息，请参阅 *IAM 用户指南*中的 [AWSIAM 策略参考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html)。
附加到 IAM 身份的策略称作*基于身份的*策略 (IAM policy)。附加到资源的策略称作*基于资源的* 策略。Amazon DocumentDB 只支持基于身份的策略（IAM 策略）。
**Topics**
+ [基于身份的策略（IAM 策略）](#UsingWithRDS.IAM.AccessControl.ManagingAccess.IdentityBased)
+ [基于资源的策略](#UsingWithRDS.IAM.AccessControl.ManagingAccess.ResourceBased)
### 基于身份的策略（IAM 策略）
您可以向 IAM 身份附加策略。例如，您可以执行以下操作：
+ **将权限策略附加到您账户中的用户或组**：账户管理员可以使用与特定用户关联的权限策略授予该用户创建 Amazon DocumentDB 资源（如实例）的权限。
+ **向角色附加权限策略（授予跨账户权限）**：您可以向 IAM 角色附加基于身份的权限策略，以授予跨账户的权限。例如，管理员可以创建一个角色来向其他人 AWS 账户 或 AWS 服务授予跨账户权限，如下所示：
1. 账户 A 管理员可以创建一个 IAM 角色，然后向该角色附加授予其访问账户 A 中资源的权限策略。
1. 账户 A 管理员可以把信任策略附加至用来标识账户 B 的角色，账户 B 由此可以作为主体代入该角色。
1. 然后，账户 B 管理员可以将代入该角色的权限委托给账户 B 中的任何用户。这样，账户 B 中的用户就可以创建或访问账户 A 中的资源。如果您想向 AWS 服务授予担任该角色的权限，则信任策略中的委托人也可以是 AWS 服务委托人。
有关使用 IAM 委托权限的更多信息，请参阅《IAM 用户指南》**中的[访问权限管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html)。
以下是允许 ID 为 `123456789012` 的用户为您的 AWS 账户创建实例的示例策略。新实例必须使用以 `default` 开头的选项组和参数组，并且它必须使用 `default` 子网组。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowCreateDBInstanceOnly",
"Effect": "Allow",
"Action": [
"rds:CreateDBInstance"
],
"Resource": [
"arn:aws:rds:*:123456789012:db:test*",
"arn:aws:rds:*:123456789012:pg:cluster-pg:default*",
"arn:aws:rds:*:123456789012:subgrp:default"
]
}
]
}
```
------
有关配合 Amazon DocumentDB 使用基于身份的策略的更多信息，请参阅 [将基于身份的策略（IAM 策略）用于 Amazon DocumentDB](UsingWithRDS.IAM.AccessControl.IdentityBased.md)。有关用户、组、角色和权限的更多信息，请参阅《IAM 用户指南》[https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)中的*身份（用户、组和角色）*。
### 基于资源的策略
其他服务如 Amazon Simple Storage Service (Amazon S3) 支持基于资源的权限策略。例如，您可以将策略附加到 Amazon S3 存储桶以管理对该存储桶的访问权限。Amazon DocumentDB 不支持基于资源的策略。
## 指定策略元素：操作、效果、资源和主体
对于每种 Amazon DocumentDB 资源（请参阅 [Amazon DocumentDB 资源和操作](#CreatingIAMPolicies-RDS)），该服务都定义一组 API 操作。有关更多信息，请参阅[操作](https://docs.aws.amazon.com/redshift/latest/APIReference/API_Operations.html)。要对这些 API 操作授予权限，Amazon DocumentDB 定义了一组您可以在策略中指定的操作。执行一个 API 操作可能需要多个操作的权限。
以下是基本的策略元素：
+ **资源**：在策略中，您可以使用 Amazon 资源名称（ARN）标识策略应用到的资源。
+ **操作**：您可以使用操作关键字标识要允许或拒绝的资源操作。例如，`rds:DescribeDBInstances` 权限允许用户执行 `DescribeDBInstances` 操作。
+ **效果**：您可以指定当用户请求特定操作（可以是允许或拒绝）时的效果。如果没有显式授予（允许）对资源的访问权限，则隐式拒绝访问。您也可显式拒绝对资源的访问，这样可确保用户无法访问该资源，即使有其他策略授予了访问权限的情况下也是如此。
+ **主体**：在基于身份的策略（IAM 策略）中，附加了策略的用户是隐式主体。对于基于资源的策略，您可以指定要接收权限的用户、账户、服务或其他实体（仅适用于基于资源的策略）。Amazon DocumentDB 不支持基于资源的策略。
有关 IAM 策略语法和描述的更多信息，请参阅《IAM 用户指南》**中的 [AWS IAM 策略参考](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies.html)。
有关显示所有 Amazon DocumentDB API 操作及它们适用的资源的表，请参阅 [Amazon DocumentDB API 权限：操作、资源和条件参考](UsingWithRDS.IAM.ResourcePermissions.md)。
## 在策略中指定条件
当您授予权限时，可使用 IAM 策略语言来指定规定策略何时生效的条件。例如，您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息，请参阅《IAM 用户指南》**中的[条件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#Condition)。
要表示条件，您可以使用预定义的条件键。Amazon DocumentDB 没有可以在 IAM policy略中使用的服务专属上下文密钥。有关可用于所有服务的全局条件上下文密钥列表，请参阅* IAM 用户指南*中的[可提供条件密钥](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html#AvailableKeys)。