

# Acciones, recursos y claves de condición para AWS Información de rendimiento
<a name="list_pi"></a>

AWS Performance Insights (prefijo de servicio:`pi`) proporciona las siguientes operaciones, recursos, acciones y claves de condición específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:
+ Obtenga información para [configurar este servicio](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html).
+ Vea una [lista de las operaciones de API disponibles para este servicio](https://docs.aws.amazon.com/performance-insights/latest/APIReference/).
+ Obtenga información sobre cómo proteger este servicio y sus recursos [mediante las políticas de permisos de IAM](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.access-control.html).
+ Consulte la referencia de [autorización de servicio programática de este servicio](https://servicereference.us-east-1.amazonaws.com/v1/pi/pi.json).

**Topics**
+ [Las operaciones de la API se definen mediante AWS Información de rendimiento](#list_pi-operations)
+ [Acciones definidas por AWS Información de rendimiento](#list_pi-actions-as-permissions)
+ [Tipos de recursos definidos por AWS Información de rendimiento](#list_pi-resources-for-iam-policies)
+ [Claves de condición para AWS Información de rendimiento](#list_pi-policy-keys)

## Las operaciones de la API se definen mediante AWS Información de rendimiento
<a name="list_pi-operations"></a>

En la siguiente tabla, se asignan las operaciones de la API a las acciones de IAM que autorizan. Solo se muestran las claves de condición que tienen valores estáticos para la API y la acción determinadas; para ver el conjunto completo de claves de condición que admite cada acción, consulte la [tabla de acciones](#list_pi-actions-as-permissions).




- **   CreatePerformanceAnalysisReport  **
  - **Acción de IAM:**  [pi: CreatePerformanceAnalysisReport](#list_pi-action-CreatePerformanceAnalysisReport)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Escritura
  - **Acción de IAM:**  [pi: TagResource](#list_pi-action-TagResource)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Etiquetar, escribir

- **   DeletePerformanceAnalysisReport  **
  - **Acción de IAM:**  [pi: DeletePerformanceAnalysisReport](#list_pi-action-DeletePerformanceAnalysisReport) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Escritura

- **   DescribeDimensionKeys  **
  - **Acción de IAM:**  [pi: DescribeDimensionKeys](#list_pi-action-DescribeDimensionKeys) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   GetDimensionKeyDetails  **
  - **Acción de IAM:**  [pi: GetDimensionKeyDetails](#list_pi-action-GetDimensionKeyDetails) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   GetPerformanceAnalysisReport  **
  - **Acción de IAM:**  [pi: GetPerformanceAnalysisReport](#list_pi-action-GetPerformanceAnalysisReport) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   GetResourceMetadata  **
  - **Acción de IAM:**  [pi: GetResourceMetadata](#list_pi-action-GetResourceMetadata) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   GetResourceMetrics  **
  - **Acción de IAM:**  [pi: GetResourceMetrics](#list_pi-action-GetResourceMetrics) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   ListAvailableResourceDimensions  **
  - **Acción de IAM:**  [pi: DescribeDimensionKeys](#list_pi-action-DescribeDimensionKeys)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Lectura
  - **Acción de IAM:**  [pi: GetDimensionKeyDetails](#list_pi-action-GetDimensionKeyDetails)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Lectura
  - **Acción de IAM:**  [pi: GetResourceMetrics](#list_pi-action-GetResourceMetrics)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Lectura
  - **Acción de IAM:**  [pi: ListAvailableResourceDimensions](#list_pi-action-ListAvailableResourceDimensions)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Lectura

- **   ListAvailableResourceMetrics  **
  - **Acción de IAM:**  [pi: ListAvailableResourceMetrics](#list_pi-action-ListAvailableResourceMetrics) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Lectura

- **   ListPerformanceAnalysisReportRecommendations  **
  - **Acción de IAM:**  [pi: ListPerformanceAnalysisReportRecommendations](#list_pi-action-ListPerformanceAnalysisReportRecommendations) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Enumeración

- **   ListPerformanceAnalysisReports  **
  - **Acción de IAM:**  [pi: ListPerformanceAnalysisReports](#list_pi-action-ListPerformanceAnalysisReports)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Enumeración
  - **Acción de IAM:**  [pi: ListTagsForResource](#list_pi-action-ListTagsForResource)  / **Clave de condición:**  / **Valores posibles:**  / **Nivel de acceso:** Enumeración

- **   ListTagsForResource  **
  - **Acción de IAM:**  [pi: ListTagsForResource](#list_pi-action-ListTagsForResource) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Enumeración

- **   TagResource  **
  - **Acción de IAM:**  [pi: TagResource](#list_pi-action-TagResource) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Etiquetar, escribir

- **   UntagResource  **
  - **Acción de IAM:**  [pi: UntagResource](#list_pi-action-UntagResource) 
  - **Clave de condición:** 
  - **Valores posibles:** 
  - **Nivel de acceso:** Etiquetar, escribir



## Acciones definidas por AWS Información de rendimiento
<a name="list_pi-actions-as-permissions"></a>

Puede especificar las siguientes acciones en el elemento `Action` de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.




- **   [CreatePerformanceAnalysisReport](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_CreatePerformanceAnalysisReport.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la CreatePerformanceAnalysisReport API a fin de crear un informe de análisis de rendimiento para una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} RequestTag TagKey](#list_pi-aws_RequestTag___TagKey_)<br />[aws: ResourceTag /$ {} TagKey](#list_pi-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_pi-aws_TagKeys)
  - **Nivel de acceso:** Escritura

- **   [DeletePerformanceAnalysisReport](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DeletePerformanceAnalysisReport.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la DeletePerformanceAnalysisReport API a fin de eliminar un informe de análisis de rendimiento de una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Escritura

- **   [DescribeDimensionKeys](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_DescribeDimensionKeys.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la DescribeDimensionKeys API para recuperar las N claves de dimensión principales de una métrica durante un período de tiempo específico
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)<br />[PI: Dimensiones](#list_pi-pi_Dimensions)
  - **Nivel de acceso:** Lectura

- **   [GetDimensionKeyDetails](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetDimensionKeyDetails.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la GetDimensionKeyDetails API para recuperar los atributos del grupo de dimensiones especificado
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)<br />[PI: Dimensiones](#list_pi-pi_Dimensions)
  - **Nivel de acceso:** Lectura

- **   [GetPerformanceAnalysisReport](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetPerformanceAnalysisReport.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la GetPerformanceAnalysisReport API a fin de recuperar un informe de análisis de rendimiento para una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [GetResourceMetadata](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetadata.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la GetResourceMetadata API para recuperar los metadatos de diferentes funciones
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [GetResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_GetResourceMetrics.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la GetResourceMetrics API para recuperar las métricas de IP de un conjunto de fuentes de datos durante un período de tiempo
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)<br />[PI: Dimensiones](#list_pi-pi_Dimensions)
  - **Nivel de acceso:** Lectura

- **   [ListAvailableResourceDimensions](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceDimensions.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la ListAvailableResourceDimensions API a fin de recuperar las dimensiones que se pueden consultar para cada tipo de métrica especificado en una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [ListAvailableResourceMetrics](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListAvailableResourceMetrics.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la ListAvailableResourceMetrics API a fin de recuperar métricas de los tipos especificados que se pueden consultar para una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Lectura

- **   [ListPerformanceAnalysisReportRecommendations](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReportRecommendations.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la ListPerformanceAnalysisReportRecommendations API a fin de recuperar las recomendaciones de un informe de análisis de rendimiento para una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Enumeración

- **   [ListPerformanceAnalysisReports](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListPerformanceAnalysisReports.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la ListPerformanceAnalysisReports API para enumerar los informes de análisis de rendimiento de una instancia de base de datos específica
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Enumeración

- **   [ListTagsForResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_ListTagsForResource.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la ListTagsForResource API para enumerar las etiquetas de un recurso
  - **Tipos de recursos (\*necesarios):** [recurso métrico\*](#list_pi-resource-metric-resource) / **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource) / **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)
  - **Nivel de acceso:** Enumeración

- **   [TagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_TagResource.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la TagResource API para etiquetar un recurso
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} RequestTag TagKey](#list_pi-aws_RequestTag___TagKey_)<br />[aws: ResourceTag /$ {} TagKey](#list_pi-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_pi-aws_TagKeys)
  - **Nivel de acceso:** Etiquetar, escribir

- **   [UntagResource](https://docs.aws.amazon.com/performance-insights/latest/APIReference/API_UntagResource.html)  **
  - **Description (Descripción):** Otorga permiso para llamar a la UntagResource API para eliminar la etiqueta de un recurso
  - **Tipos de recursos (\*necesarios):** [perf-reports-resource\*](#list_pi-resource-perf-reports-resource)
  - **Claves de condición:** [aws: /$ {} ResourceTag TagKey](#list_pi-aws_ResourceTag___TagKey_)<br />[AWS: TagKeys](#list_pi-aws_TagKeys)
  - **Nivel de acceso:** Etiquetar, escribir



## Tipos de recursos definidos por AWS Información de rendimiento
<a name="list_pi-resources-for-iam-policies"></a>

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento `Resource` de las instrucciones de política de permisos de IAM.



| Tipos de recurso | ARN | Claves de condición | 
| --- | --- | --- | 
| [recurso métrico](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.access-control.html)  | arn: $ {Partition} :pi: $ {Region} :$ {Account} :metrics/$ {} /$ {Identifier} ServiceType | [AWSTagKey: /$ {} ResourceTag](#list_pi-aws_ResourceTag___TagKey_) | 
| [recurso perf-reports-](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.access-control.html)  | arn: $ {Partition} :pi: $ {Region} :$ {Account} :perf-reports/$ {} /$ {Identifier} /$ {} ServiceType ReportId | [awsTagKey: /$ {} ResourceTag](#list_pi-aws_ResourceTag___TagKey_) | 

## Claves de condición para AWS Información de rendimiento
<a name="list_pi-policy-keys"></a>

AWS Performance Insights define las siguientes claves de condición que se pueden utilizar en el `Condition` elemento de una política de IAM.



| Claves de condición | Descripción | Tipo | 
| --- | --- | --- | 
|  [aws: RequestTag /$ {} TagKey](#condition-keys-requesttag)  | Filtra el acceso por las etiquetas que se pasan en la solicitud | Cadena | 
|  [aws: ResourceTag /$ {} TagKey](#condition-keys-resourcetag)  | Filtra el acceso por las etiquetas asociadas al recurso | Cadena | 
|  [AWS: TagKeys](#condition-keys-tagkeys)  | Filtra el acceso por las claves de etiquetas que se pasan en la solicitud | ArrayOfString | 
|  [PI: Dimensiones](#condition-keys-dimensions)  | Filtra el acceso según las dimensiones solicitadas | ArrayOfString | 