Amazon Rekognition 的操作、资源和条件键 - 服务授权参考
操作资源类型条件键

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

Amazon Rekognition 的操作、资源和条件键

Amazon Rekognition（服务前缀：rekognition）提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考：

Amazon Rekognition 定义的操作

您可以在 IAM 策略语句的 Action 元素中指定以下操作。可以使用策略授予在 AWS中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

“操作” 表的 “访问级别” 列描述了如何对操作进行分类（列出、读取、权限管理或标记）。此分类可以帮助您了解当您在策略中使用操作时，相应操作授予的访问级别。有关访问级别的更多信息，请参阅策略摘要中的访问级别。

操作表的资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值，您必须在策略语句的 Resource 元素中指定策略应用的所有资源（“*”）。通过在 IAM policy 中使用条件来筛选访问权限，以控制是否可以在资源或请求中使用特定标签键。如果操作具有一个或多个必需资源，则调用方必须具有使用这些资源来使用该操作的权限。必需资源在表中以星号 (*) 表示。如果您在 IAM policy 中使用 Resource 元素限制资源访问权限，则必须为每种必需的资源类型添加 ARN 或模式。某些操作支持多种资源类型。如果资源类型是可选的（未指示为必需），则可以选择使用一种可选资源类型。

操作表的条件键列包括可以在策略语句的 Condition 元素中指定的键。有关与服务资源关联的条件键的更多信息，请参阅资源类型表的条件键列。

“操作” 表格的 “依赖操作” 列显示成功调用操作可能需要的其他权限。除了操作本身的权限外，可能还需要这些权限。当操作指定依赖操作时，这些依赖关系可能适用于为该操作定义的其他资源，而不仅仅是表格中列出的第一个资源。

注意

资源条件键在资源类型表中列出。您可以在操作表的资源类型（* 为必需）列中找到应用于某项操作的资源类型的链接。资源类型表中的资源类型包括条件密钥列，这是应用于操作表中操作的资源条件键。

有关下表中各列的详细信息，请参阅操作表。

操作 描述 访问级别 资源类型（* 为必需） 条件键 相关操作
AssociateFaces 授予权限以将多个人脸与单个用户关联 写入

collection*

CompareFaces 授予权限以将源输入图像中的面容与目标输入图像中检测到的每个面容进行比较 读取
CopyProjectVersion 授予将某个现有模型版本复制到某个新模型版本的权限 写入

project*

projectversion*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateCollection 授予在中创建收藏的权限 AWS 区域 写入

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDataset 授予权限以创建新 Amazon Rekognition Custom Labels 数据集 写入

project*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateFaceLivenessSession 授予创建面容直播会话的权限 写入
CreateProject 授予权限以创建 Amazon Rekognition Custom Labels 项目 写入

aws:RequestTag/${TagKey}

aws:TagKeys

CreateProjectVersion 授予权限以开始训练新版本的模型 写入

project*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateStreamProcessor 授予权限以创建 Amazon Rekognition 流处理器 写入

collection*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateUser 授予权限以使用您提供的唯一用户 ID 在集合中创建新用户 写入

collection*

DeleteCollection 授予权限以删除指定的集合 写入

collection*

DeleteDataset 授予权限以删除现有的 Amazon Rekognition Custom Labels 数据集 写入

dataset*

DeleteFaces 授予权限以从集合中删除面容 写入

collection*

DeleteProject 授予权限以删除项目 写入

project*

DeleteProjectPolicy 授予删除附加到某个项目的资源策略的权限 写入

project*

DeleteProjectVersion 授予权限以删除模型 写入

projectversion*

DeleteStreamProcessor 授予权限以删除指定的流处理器 写入

streamprocessor*

DeleteUser 授予权限以基于提供的用户 ID 从集合中删除用户 写入

collection*

DescribeCollection 授予读取有关集合的详细信息的权限 读取

collection*

DescribeDataset 授予权限以描述 Amazon Rekognition Custom Labels 数据集 读取

dataset*

DescribeProjectVersions 授予权限以在 Amazon Rekognition Custom Labels 项目中列出模型版本 读取

project*

DescribeProjects 授予权限以列出 Amazon Rekognition Custom Labels 项目 读取
DescribeStreamProcessor 授予获取有关指定流处理器信息的权限 读取

streamprocessor*

DetectCustomLabels 授予在提供的图像中检测自定义标签的权限 读取

projectversion*

DetectFaces 授予权限以检测作为输入提供的图像中的人脸 读取
DetectLabels 授予权限以检测作为输入提供的图像中的实际标签实例 读取
DetectModerationLabels 授予在输入图像中检测审核标签的权限 读取

projectversion

DetectProtectiveEquipment 授予权限以检测输入图像中的个人防护设备 读取
DetectText 授予权限以检测输入图像中的文本，并将其转换为机器可读的文本 读取
DisassociateFaces 授予权限以移除用户 ID 和 人脸 ID 之间的关联 写入

collection*

DistributeDatasetEntries 授予权限以跨训练数据集和项目的测试数据集分发训练数据集中的条目 写入

dataset*

GetCelebrityInfo 授予权限以读取名人姓名和其他信息 读取
GetCelebrityRecognition 授予权限以读取异步名人识别任务在存储视频中找到的名人识别结果 读取
GetContentModeration 授予权限以读取异步内容审核任务在存储视频中找到的内容审核分析结果 读取
GetFaceDetection 授予权限以读取异步人脸检测任务在存储视频中找到的面容检测结果 读取
GetFaceLivenessSessionResults 授予获取面容直播会话结果的权限 读取
GetFaceSearch 授予权限以读取异步人脸搜索任务在存储视频中找到的匹配集合面容 读取
GetLabelDetection 授予权限以读取异步标签检测任务在存储视频中找到的标签检测结果 读取
GetMediaAnalysisJob 授予读取对 S3 中作业结果的引用以及有关媒体分析作业的其他信息的权限 读取
GetPersonTracking 授予权限以读取异步人员跟踪任务在存储视频中检测到的人员列表 读取
GetSegmentDetection 授予权限以读取异步片段检测任务在存储视频中找到的视频片段 读取
GetTextDetection 授予权限以获取异步文本检测任务在存储视频中找到的文本 读取
IndexFaces 授予权限以便使用输入图像中检测到的面容更新现有集合 写入

collection*

ListCollections 授予权限以读取账户中的集合 ID 读取
ListDatasetEntries 授予权限以列出现有 Amazon Rekognition Custom Labels 数据集中的数据集条目 读取

dataset*

ListDatasetLabels 授予权限以列出数据集中的标签 读取

dataset*

ListFaces 授予权限以读取指定集合中的面容元数据 读取

collection*

ListMediaAnalysisJobs 授予读取媒体分析作业列表的权限 读取
ListProjectPolicies 授予列出附加到某个项目的资源策略的权限 读取

project*

ListStreamProcessors 授予权限以获取流处理器列表 列表
ListTagsForResource 授予权限以返回与资源关联的标签的列表 读取

collection

dataset

project

projectversion

streamprocessor

ListUsers 授予列出权限 UserIds 和 UserStatus 读取

collection*

PutProjectPolicy 授予将某个资源策略附加到某个项目的权限 写入

project*

RecognizeCelebrities 授予权限以检测输入图像中的名人 读取
SearchFaces 授予权限以在指定集合中搜索提供的面容 ID 读取

collection*

SearchFacesByImage 授予权限以在指定集合中搜索输入图像中的最大面容 读取

collection*

SearchUsers 授予权限以在指定集合中搜索具有给定人脸 ID 或 用户 ID 的用户匹配结果 读取

collection*

SearchUsersByImage 授予权限以通过使用输入图像中的最大人脸在指定集合中搜索用户匹配结果 读取

collection*

StartCelebrityRecognition 授予权限以开始对存储视频中的名人开始异步识别 写入
StartContentModeration 授予权限以对存储视频中明显或暗示性的成人内容开始异步检测 写入
StartFaceDetection 授予权限以开始在存储视频中进行面容异步检测 写入
StartFaceLivenessSession 授予为面容直播会话开启流媒体视频的权限 写入
StartFaceSearch 授予权限以根据存储视频中检测到的面容在集合中开始异步搜索匹配的面容 写入

collection*

StartLabelDetection 授予权限以开始在存储视频中进行标签异步检测 写入
StartMediaAnalysisJob 授予启动媒体分析作业的权限 写入

projectversion

StartPersonTracking 授予权限以在存储视频中开始人员的异步跟踪 写入
StartProjectVersion 授予权限以开始运行模型版本 写入

projectversion*

StartSegmentDetection 授予权限以开始在存储视频中进行分段异步检测 写入
StartStreamProcessor 授予权限以开始运行流处理器 写入

streamprocessor*

StartTextDetection 授予权限以开始在存储视频中进行文本异步检测 写入
StopProjectVersion 授予权限以停止正在运行的模型版本 写入

projectversion*

StopStreamProcessor 授予权限以停止正在运行的流处理器 写入

streamprocessor*

TagResource 授予权限以将一个或多个标签添加到资源中 Tagging

collection

dataset

project

projectversion

streamprocessor

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource 授予从资源删除一个或多个标签的权限 标记

collection

dataset

project

projectversion

streamprocessor

aws:TagKeys

UpdateDatasetEntries 授予在数据集中添加或更新一条或多条 JSON 行（条目）的权限 写入

dataset*

UpdateStreamProcessor 授予修改流处理器属性的权限 写入

streamprocessor*

Amazon Rekognition 定义的资源类型

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 Resource 元素中使用这些资源类型。操作表中的每个操作指定了可以使用该操作指定的资源类型。您也可以在策略中包含条件键，从而定义资源类型。这些键显示在资源类型表的最后一列。有关下表中各列的详细信息，请参阅资源类型表。

资源类型 ARN 条件键
collection arn:${Partition}:rekognition:${Region}:${Account}:collection/${CollectionId}

aws:ResourceTag/${TagKey}

streamprocessor arn:${Partition}:rekognition:${Region}:${Account}:streamprocessor/${StreamprocessorId}

aws:ResourceTag/${TagKey}

project arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/${CreationTimestamp}

aws:ResourceTag/${TagKey}

projectversion arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/version/${VersionName}/${CreationTimestamp}

aws:ResourceTag/${TagKey}

dataset arn:${Partition}:rekognition:${Region}:${Account}:project/${ProjectName}/dataset/${DatasetType}/${CreationTimestamp}

aws:ResourceTag/${TagKey}

Amazon Rekognition 的条件键

Amazon Rekognition 定义了以下条件键，可用于 IAM policy 的 Condition 元素。您可以使用这些键进一步细化应用策略语句的条件。有关下表中各列的详细信息，请参阅条件键表。

要查看适用于所有服务的全局条件密钥，请参阅AWS 全局条件上下文密钥。

条件键 描述 类型
aws:RequestTag/${TagKey} 按请求中传递的标签筛选访问权限 字符串
aws:ResourceTag/${TagKey} 按与资源关联的标签筛选访问权限 字符串
aws:TagKeys 按请求中传递的标签键筛选访问权限 ArrayOfString