

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

# 的操作、资源和条件键 Amazon 性能详情
<a name="list_pi"></a>

Amazon 性能见解（服务前缀： `pi`) 提供以下特定服务的操作、资源、操作和条件密钥，用于 IAM 权限策略。

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

**Topics**
+ [API 操作定义为 Amazon 性能详情](#list_pi-operations)
+ [动作定义为 Amazon 性能详情](#list_pi-actions-as-permissions)
+ [资源类型定义为 Amazon 性能详情](#list_pi-resources-for-iam-policies)
+ [的条件密钥 Amazon 性能详情](#list_pi-policy-keys)

## API 操作定义为 Amazon 性能详情
<a name="list_pi-operations"></a>

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




- **   CreatePerformanceAnalysisReport  **
  - **IAM 操作:**  [pi:CreatePerformanceAnalysisReport](#list_pi-action-CreatePerformanceAnalysisReport)  / **条件键:**  / **可能的值:**  / **访问级别:** 写入
  - **IAM 操作:**  [pi:TagResource](#list_pi-action-TagResource)  / **条件键:**  / **可能的值:**  / **访问级别:** 标记、写入

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

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

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

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

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

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

- **   ListAvailableResourceDimensions  **
  - **IAM 操作:**  [pi:DescribeDimensionKeys](#list_pi-action-DescribeDimensionKeys)  / **条件键:**  / **可能的值:**  / **访问级别:** 读取
  - **IAM 操作:**  [pi:GetDimensionKeyDetails](#list_pi-action-GetDimensionKeyDetails)  / **条件键:**  / **可能的值:**  / **访问级别:** 读取
  - **IAM 操作:**  [pi:GetResourceMetrics](#list_pi-action-GetResourceMetrics)  / **条件键:**  / **可能的值:**  / **访问级别:** 读取
  - **IAM 操作:**  [pi:ListAvailableResourceDimensions](#list_pi-action-ListAvailableResourceDimensions)  / **条件键:**  / **可能的值:**  / **访问级别:** 读取

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

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

- **   ListPerformanceAnalysisReports  **
  - **IAM 操作:**  [pi:ListPerformanceAnalysisReports](#list_pi-action-ListPerformanceAnalysisReports)  / **条件键:**  / **可能的值:**  / **访问级别:** 列表
  - **IAM 操作:**  [pi:ListTagsForResource](#list_pi-action-ListTagsForResource)  / **条件键:**  / **可能的值:**  / **访问级别:** 列表

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

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

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



## 动作定义为 Amazon 性能详情
<a name="list_pi-actions-as-permissions"></a>

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




- **   [CreatePerformanceAnalysisReport](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html)  **
  - **说明:** 授予通话权限 CreatePerformanceAnalysisReport 用于为指定数据库实例创建性能分析报告的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:RequestTag/${TagKey}](#list_pi-aws_RequestTag___TagKey_)<br />[aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_pi-aws_TagKeys)
  - **访问级别:** 写入

- **   [DeletePerformanceAnalysisReport](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html)  **
  - **说明:** 授予通话权限 DeletePerformanceAnalysisReport 用于删除指定数据库实例的性能分析报告的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [DescribeDimensionKeys](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html)  **
  - **说明:** 授予通话权限 DescribeDimensionKeys 用于检索特定时间段内指标的前 N 个维度密钥的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)<br />[pi:Dimensions](#list_pi-pi_Dimensions)
  - **访问级别:** 读取

- **   [GetDimensionKeyDetails](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html)  **
  - **说明:** 授予通话权限 GetDimensionKeyDetails 用于检索指定维度组属性的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)<br />[pi:Dimensions](#list_pi-pi_Dimensions)
  - **访问级别:** 读取

- **   [GetPerformanceAnalysisReport](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html)  **
  - **说明:** 授予通话权限 GetPerformanceAnalysisReport 用于检索指定数据库实例的性能分析报告的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 读取

- **   [GetResourceMetadata](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_GetResourceMetadata.html)  **
  - **说明:** 授予通话权限 GetResourceMetadata 用于检索不同功能的元数据的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 读取

- **   [GetResourceMetrics](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_GetResourceMetrics.html)  **
  - **说明:** 授予通话权限 GetResourceMetrics 用于在一段时间内检索一组数据源的 PI 指标的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)<br />[pi:Dimensions](#list_pi-pi_Dimensions)
  - **访问级别:** 读取

- **   [ListAvailableResourceDimensions](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html)  **
  - **说明:** 授予通话权限 ListAvailableResourceDimensions 用于检索指定数据库实例上每种指定指标类型可查询的维度的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 读取

- **   [ListAvailableResourceMetrics](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html)  **
  - **说明:** 授予通话权限 ListAvailableResourceMetrics 用于检索可查询指定数据库实例的指定类型的指标的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 读取

- **   [ListPerformanceAnalysisReportRecommendations](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReportRecommendations.html)  **
  - **说明:** 授予通话权限 ListPerformanceAnalysisReportRecommendations 用于检索指定数据库实例的性能分析报告建议的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 列表

- **   [ListPerformanceAnalysisReports](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)  **
  - **说明:** 授予通话权限 ListPerformanceAnalysisReports 用于列出指定数据库实例的性能分析报告的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 列表

- **   [ListTagsForResource](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_ListTagsForResource.html)  **
  - **说明:** 授予通话权限 ListTagsForResource 列出资源标签的 API
  - **资源类型（\* 为必需）:** [metric-resource\*](#list_pi-resource-metric-resource) / **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource) / **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)
  - **访问级别:** 列表

- **   [TagResource](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_TagResource.html)  **
  - **说明:** 授予通话权限 TagResource 标记资源的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:RequestTag/${TagKey}](#list_pi-aws_RequestTag___TagKey_)<br />[aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_pi-aws_TagKeys)
  - **访问级别:** 标记、写入

- **   [UntagResource](https://docs.amazonaws.cn/performance-insights/latest/APIReference/API_UntagResource.html)  **
  - **说明:** 授予通话权限 UntagResource 取消资源标签的 API
  - **资源类型（\* 为必需）:** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_)<br />[aws:TagKeys](#list_pi-aws_TagKeys)
  - **访问级别:** 标记、写入



## 资源类型定义为 Amazon 性能详情
<a name="list_pi-resources-for-iam-policies"></a>

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 `Resource` 元素中使用这些资源类型。



| 资源类型 | ARN | 条件键 | 
| --- | --- | --- | 
|  [metric-resource](https://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/USER_PerfInsights.access-control.html)  | arn:${Partition}:pi:${Region}:${Account}:metrics/${ServiceType}/${Identifier} | [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_) | 
|  [perf-reports-resource](https://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/USER_PerfInsights.access-control.html)  | arn:${Partition}:pi:${Region}:${Account}:perf-reports/${ServiceType}/${Identifier}/${ReportId} | [aws:ResourceTag/${TagKey}](#list_pi-aws_ResourceTag___TagKey_) | 

## 的条件密钥 Amazon 性能详情
<a name="list_pi-policy-keys"></a>

Amazon 性能见解定义了以下条件密钥，这些条件密钥可用于 `Condition` IAM 政策的元素。



| 条件键 | 描述 | 类型 | 
| --- | --- | --- | 
|   [aws:RequestTag/${TagKey}](#condition-keys-requesttag)  | 按请求中传递的标签筛选访问权限 | String | 
|   [aws:ResourceTag/${TagKey}](#condition-keys-resourcetag)  | 按与资源关联的标签筛选访问权限 | String | 
|   [aws:TagKeys](#condition-keys-tagkeys)  | 按请求中传递的标签键筛选访问权限 | ArrayOfString | 
|   [pi:Dimensions](#condition-keys-dimensions)  | 按请求的维度筛选访问权限 | ArrayOfString | 