Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

适用于 Amazon OpenSearch Ingestion 的 Identity and Access Management

Amazon Identity and Access Management（IAM）是一项 Amazon Web Services 服务，可以帮助管理员安全地控制对 Amazon 资源的访问。IAM 管理员控制谁可以通过身份验证（登录）以及获得授权（拥有权限）使用 OpenSearch Ingestion 资源。IAM 是一项无需额外费用即可使用的 Amazon Web Services 服务。

适用于 OpenSearch Ingestion 的基于身份的策略

支持基于身份的策略：是

基于身份的策略是可附加到身份（如 IAM 用户、用户组或角色）的 JSON 权限策略文档。这些策略控制用户和角色可在何种条件下对哪些资源执行哪些操作。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》中的使用客户管理型策略定义自定义 IAM 权限。

通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。要了解可在 JSON 策略中使用的所有元素，请参阅《IAM 用户指南》中的 IAM JSON 策略元素引用。

适用于 OpenSearch Ingestion 的基于身份的策略示例

要查看 OpenSearch Ingestion 基于身份的策略的示例，请参阅 适用于 OpenSearch Ingestion 的基于身份的策略示例。

适用于 OpenSearch Ingestion 的策略操作

支持策略操作：是

JSON 策略的 Action 元素描述可用于在策略中允许或拒绝访问的操作。策略操作通常与关联的 Amazon API 操作同名。有一些例外情况，例如没有匹配 API 操作的仅限权限 操作。还有一些操作需要在策略中执行多个操作。这些附加操作称为相关操作。

在策略中包含操作以授予执行关联操作的权限。

OpenSearch Ingestion 中的策略操作在操作前使用以下前缀：

osis

要在单个语句中指定多项操作，请使用逗号将它们隔开。

"Action": [
      "osis:action1",
      "osis:action2"
         ]

您可以使用通配符 (*) 指定多个操作。例如，要指定以单词 List 开头的所有操作，包括以下操作：

"Action": "osis:List*"

要查看 OpenSearch Ingestion 基于身份的策略的示例，请参阅 适用于 OpenSearch 无服务器的基于身份的策略示例。

适用于 OpenSearch Ingestion 的策略资源

支持策略资源：是

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说，哪个主体可以对什么资源执行操作，以及在什么条件下执行。

Resource JSON 策略元素指定要向其应用操作的一个或多个对象。作为最佳实践，请使用其 Amazon 资源名称（ARN）指定资源。对于不支持资源级权限的操作，请使用通配符（*）来指示此语句应用于所有资源。

"Resource": "*"

Amazon OpenSearch Ingestion 的策略条件键

支持特定于服务的策略条件键：否

管理员可以使用 Amazon JSON 策略来指定谁有权访问什么内容。也就是说，哪个主体可以对什么资源执行操作，以及在什么条件下执行。

Condition 元素指定语句何时根据定义的标准执行。您可以创建使用条件运算符（例如，等于或小于）的条件表达式，以使策略中的条件与请求中的值相匹配。要查看所有 Amazon 全局条件键，请参阅《IAM 用户指南》中的 Amazon 全局条件上下文键。

要查看 OpenSearch Ingestion 条件键的列表，请参阅《服务授权参考》中的适用于 Amazon OpenSearch Ingestion 的条件键。要了解您可以对哪些操作和资源使用条件键，请参阅 Amazon OpenSearch Ingestion 定义的操作。

包含 OpenSearch Ingestion 的 ABAC

支持 ABAC（策略中的标签）：是

基于属性的访问权限控制（ABAC）是一种授权策略，该策略基于称为标签的属性来定义权限。您可以将标签附加到 IAM 实体和 Amazon 资源，然后设计 ABAC 策略，以支持在主体的标签与资源上的标签匹配时执行操作。

要基于标签控制访问，您需要使用 aws:ResourceTag/key-name、aws:RequestTag/key-name 或 aws:TagKeys 条件键在策略的条件元素中提供标签信息。

如果某个服务对于每种资源类型都支持所有这三个条件键，则对于该服务，该值为是。如果某个服务仅对于部分资源类型支持所有这三个条件键，则该值为部分。

有关 ABAC 的更多信息，请参阅《IAM 用户指南》中的使用 ABAC 授权定义权限。要查看设置 ABAC 步骤的教程，请参阅《IAM 用户指南》中的使用基于属性的访问权限控制（ABAC）。

有关标记 OpenSearch Ingestion 资源的更多信息，请参阅 标记 Amazon OpenSearch Ingestion 管道。

配合使用临时凭证与 OpenSearch Ingestion

支持临时凭证：是

临时凭证提供对 Amazon 资源的短期访问权限，并且是在您使用联合身份验证或切换角色时自动创建的。Amazon 建议您动态生成临时凭证，而不是使用长期访问密钥。有关更多信息，请参阅《IAM 用户指南》中的 IAM 中的临时安全凭证和使用 IAM 的 Amazon Web Services 服务。

适用于 OpenSearch Ingestion 的服务相关角色

支持服务相关角色：是

服务相关角色是一种与 Amazon Web Services 服务 相关的服务角色。服务可以代入代表您执行操作的角色。服务相关角色显示在您的 Amazon Web Services 账户 中，并由该服务拥有。IAM 管理员可以查看但不能编辑服务相关角色的权限。

OpenSearch Ingestion 使用名为 AWSServiceRoleForAmazonOpenSearchIngestionService 的服务相关角色。名为 AWSServiceRoleForOpensearchIngestionSelfManagedVpce 的服务相关角色也适用于使用自主管理型 VPC 端点的管道。有关创建和管理 OpenSearch Ingestion 服务相关角色的详细信息，请参阅 使用服务相关角色创建 OpenSearch Ingestion 管道。

适用于 OpenSearch Ingestion 的基于身份的策略示例

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

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》中的创建 IAM 策略（控制台）。

有关 Amazon OpenSearch Ingestion 定义的操作和资源类型的详细信息，包括每种资源类型的 ARN 格式，请参阅《服务授权参考》中的适用于 Amazon OpenSearch Ingestion 的操作、资源和条件键。

策略最佳实践

基于身份的策略非常强大。它们确定某人是否可以创建、访问或删除您账户中的 OpenSearch Ingestion 资源。这些操作可能会使 Amazon Web Services 账户 产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 OpenSearch Ingestion 资源。这些操作可能会使 Amazon Web Services 账户 产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：

有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》中的 IAM 中的安全最佳实践。

在控制台中使用 OpenSearch Ingestion

要在 OpenSearch Service 控制台中访问 OpenSearch Ingestion，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您的 Amazon 账户中的 OpenSearch Ingestion 资源的详细信息。如果您创建的基于身份的策略比所需的最低权限更严格，则无法为具有该策略的实体（如 IAM 角色）正常运行控制台。

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

以下策略允许用户在 OpenSearch Service 控制台中访问 OpenSearch Ingestion：

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Resource": "*",
            "Effect": "Allow",
            "Action": [
                "osis:ListPipelines",
                "osis:GetPipeline",
                "osis:ListPipelineBlueprints",
                "osis:GetPipelineBlueprint",
                "osis:GetPipelineChangeProgress"
            ]
        }
    ]
}

或者，您可以使用 AmazonOpenSearchIngestionReadOnlyAccess Amazon Web Services 托管策略，该策略授予对所有 Amazon Web Services 账户 的 OpenSearch Ingestion 资源的只读访问权限。

管理 OpenSearch Ingestion 管道

此策略是“管道管理员”策略的示例，该策略允许用户管理和支配 Amazon OpenSearch Ingestion 管道。用户可以创建、查看和删除管道。

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Resource": "arn:aws:osis:us-east-1:111122223333:pipeline/*",
            "Action": [
                "osis:CreatePipeline",
                "osis:DeletePipeline",
                "osis:UpdatePipeline",
                "osis:ValidatePipeline",
                "osis:StartPipeline",
                "osis:StopPipeline"
            ],
            "Effect": "Allow"
        },
        {
            "Resource": "*",
            "Action": [
                "osis:ListPipelines",
                "osis:GetPipeline",
                "osis:ListPipelineBlueprints",
                "osis:GetPipelineBlueprint",
                "osis:GetPipelineChangeProgress"
            ],
            "Effect": "Allow"
        }
    ]
}

将数据提取到 OpenSearch Ingestion 管道

此示例策略允许用户或其他实体将数据摄取到其账户中的 Amazon OpenSearch Ingestion 管道中。用户无法修改管道。

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Resource": "arn:aws:osis:us-east-1:123456789012:pipeline/*",
            "Action": [
                "osis:Ingest"
            ],
            "Effect": "Allow"
        }
    ]
}