

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

# Amazon Resource Group Tagging API 的操作、资源和条件键
<a name="list_resourcegroupstaggingapi"></a>

亚马逊资源组标记 API（服务前缀： `tag`) 提供以下特定服务的操作、资源、操作和条件密钥，用于 IAM 权限策略。

参考：
+ 了解如何[配置该服务](https://docs.amazonaws.cn/ARG/latest/userguide/tag-editor.html)。
+ 查看[适用于该服务的 API 操作列表](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/)。
+ 了解如何[使用 IAM](https://docs.amazonaws.cn/ARG/latest/userguide/gettingstarted-prereqs.html) 权限策略保护该服务及其资源。
+ 查看 [编程服务授权参考](https://servicereference.us-east-1.amazonaws.com/v1/tag/tag.json) 用于此服务。

**Topics**
+ [由亚马逊资源组标记 API 定义的 API 操作](#list_resourcegroupstaggingapi-operations)
+ [Amazon Resource Group Tagging API 定义的操作](#list_resourcegroupstaggingapi-actions-as-permissions)
+ [Amazon Resource Group Tagging API 定义的资源类型](#list_resourcegroupstaggingapi-resources-for-iam-policies)
+ [Amazon Resource Group Tagging API 的条件键](#list_resourcegroupstaggingapi-policy-keys)

## 由亚马逊资源组标记 API 定义的 API 操作
<a name="list_resourcegroupstaggingapi-operations"></a>

下表将 API 操作映射到它们授权的 IAM 操作。仅列出具有给定 API 和操作静态值的条件密钥；有关每个操作支持的全套条件密钥，请参阅 [操作表](#list_resourcegroupstaggingapi-actions-as-permissions)。




- **   DescribeReportCreation  **
  - **IAM 操作:**  [tag:DescribeReportCreation](#list_resourcegroupstaggingapi-action-DescribeReportCreation) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetComplianceSummary  **
  - **IAM 操作:**  [tag:GetComplianceSummary](#list_resourcegroupstaggingapi-action-GetComplianceSummary) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetResources  **
  - **IAM 操作:**  [tag:GetResources](#list_resourcegroupstaggingapi-action-GetResources) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetTagKeys  **
  - **IAM 操作:**  [tag:GetTagKeys](#list_resourcegroupstaggingapi-action-GetTagKeys) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   GetTagValues  **
  - **IAM 操作:**  [tag:GetTagValues](#list_resourcegroupstaggingapi-action-GetTagValues) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 读取

- **   ListRequiredTags  **
  - **IAM 操作:**  [tag:ListRequiredTags](#list_resourcegroupstaggingapi-action-ListRequiredTags) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 列表

- **   StartReportCreation  **
  - **IAM 操作:**  [tag:StartReportCreation](#list_resourcegroupstaggingapi-action-StartReportCreation) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 写入

- **   TagResources  **
  - **IAM 操作:**  [tag:TagResources](#list_resourcegroupstaggingapi-action-TagResources) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 标记、写入

- **   UntagResources  **
  - **IAM 操作:**  [tag:UntagResources](#list_resourcegroupstaggingapi-action-UntagResources) 
  - **条件键:** 
  - **可能的值:** 
  - **访问级别:** 标记、写入



## Amazon Resource Group Tagging API 定义的操作
<a name="list_resourcegroupstaggingapi-actions-as-permissions"></a>

您可以在 IAM 策略语句的 `Action` 元素中指定以下操作。对于每个操作，该表列出了该操作支持的资源类型和条件键。可以使用策略授予在 Amazon中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。



| 操作 | 说明 | 资源类型（\* 为必需） | 条件键 | 访问级别 | 
| --- | --- | --- | --- | --- | 
|   [DescribeReportCreation](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_DescribeReportCreation.html)  | 授予描述状态的权限 StartReportCreation 手术 |  |   | 读取 | 
|   [GetComplianceSummary](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetComplianceSummary.html)  | 授予权限以检索有多少资源不符合其有效标签策略的摘要 |  |   | 读取 | 
|   [GetResources](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetResources.html)  | 授予在指定区域中返回已标记或先前标记的资源的权限 Amazon Web Services 区域 用于通话账户 |  |   | 读取 | 
|   [GetTagKeys](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetTagKeys.html)  | 授予返回指定区域中当前正在使用的标签密钥的权限 Amazon Web Services 区域 用于通话账户 |  |   | 读取 | 
|   [GetTagValues](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_GetTagValues.html)  | 授予返回指定密钥中使用的标签值的权限 Amazon Web Services 区域 用于通话账户 |  |   | 读取 | 
|   [ListRequiredTags](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_ListRequiredTags.html)  | 授予权限以列出调用账户中支持的资源类型的必需标签 |  |   | 列表 | 
|   [StartReportCreation](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_StartReportCreation.html)  | 授予权限以开始生成一个报告，其中列出组织中账户的所有已标记资源，以及每个资源是否符合生效标签策略。 |  |   | 写入 | 
|   [TagResources](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_TagResources.html)  | 授予将一个或多个标签应用到指定资源的权限 |  |   | 标记、写入 | 
|   [UntagResources](https://docs.amazonaws.cn/resourcegroupstagging/latest/APIReference/API_UntagResources.html)  | 授予从指定资源中删除指定标签的权限 |  |   | 标记、写入 | 

## Amazon Resource Group Tagging API 定义的资源类型
<a name="list_resourcegroupstaggingapi-resources-for-iam-policies"></a>

Amazon Resource Group Tagging API 不支持在 IAM policy 语句的 `Resource` 元素中指定资源 ARN。

## Amazon Resource Group Tagging API 的条件键
<a name="list_resourcegroupstaggingapi-policy-keys"></a>

Amazon 资源组标记 API 没有可用于的特定服务条件密钥 `Condition` 政策声明的要素。