Operations Actions Resource types Condition keys

Actions, resources, and condition keys for Amazon Performance Insights

Amazon Performance Insights (service prefix: pi) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

Learn how to configure this service.
View a list of the API operations available for this service.
Learn how to secure this service and its resources by using IAM permission policies.
View the programmatic service authorization reference for this service.

Topics

API operations defined by Amazon Performance Insights
Actions defined by Amazon Performance Insights
Resource types defined by Amazon Performance Insights
Condition keys for Amazon Performance Insights

API operations defined by Amazon Performance Insights

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation	IAM action	Access level
CreatePerformanceAnalysisReport	pi:CreatePerformanceAnalysisReport	Write
CreatePerformanceAnalysisReport	pi:TagResource	Tagging, Write
DeletePerformanceAnalysisReport	pi:DeletePerformanceAnalysisReport	Write
DescribeDimensionKeys	pi:DescribeDimensionKeys	Read
GetDimensionKeyDetails	pi:GetDimensionKeyDetails	Read
GetPerformanceAnalysisReport	pi:GetPerformanceAnalysisReport	Read
GetResourceMetadata	pi:GetResourceMetadata	Read
GetResourceMetrics	pi:GetResourceMetrics	Read
ListAvailableResourceDimensions	pi:DescribeDimensionKeys	Read
	pi:GetDimensionKeyDetails	Read
	pi:GetResourceMetrics	Read
	pi:ListAvailableResourceDimensions	Read
ListAvailableResourceMetrics	pi:ListAvailableResourceMetrics	Read
ListPerformanceAnalysisReportRecommendations	pi:ListPerformanceAnalysisReportRecommendations	List
ListPerformanceAnalysisReports	pi:ListPerformanceAnalysisReports	List
ListPerformanceAnalysisReports	pi:ListTagsForResource	List
ListTagsForResource	pi:ListTagsForResource	List
TagResource	pi:TagResource	Tagging, Write
UntagResource	pi:UntagResource	Tagging, Write

Actions defined by Amazon Performance Insights

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in Amazon. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions	Description	Resource types (*required)	Condition keys	Access level
CreatePerformanceAnalysisReport	Grants permission to call CreatePerformanceAnalysisReport API to create a Performance Analysis Report for a specified DB instance	perf-reports-resource*	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Write
DeletePerformanceAnalysisReport	Grants permission to call DeletePerformanceAnalysisReport API to delete a Performance Analysis Report for a specified DB instance	perf-reports-resource*	aws:ResourceTag/${TagKey}	Write
DescribeDimensionKeys	Grants permission to call DescribeDimensionKeys API to retrieve the top N dimension keys for a metric for a specific time period	metric-resource*	aws:ResourceTag/${TagKey} pi:Dimensions	Read
GetDimensionKeyDetails	Grants permission to call GetDimensionKeyDetails API to retrieve the attributes of the specified dimension group	metric-resource*	aws:ResourceTag/${TagKey} pi:Dimensions	Read
GetPerformanceAnalysisReport	Grants permission to call GetPerformanceAnalysisReport API to retrieve a Performance Analysis Report for a specified DB instance	perf-reports-resource*	aws:ResourceTag/${TagKey}	Read
GetResourceMetadata	Grants permission to call GetResourceMetadata API to retrieve the metadata for different features	metric-resource*	aws:ResourceTag/${TagKey}	Read
GetResourceMetrics	Grants permission to call GetResourceMetrics API to retrieve PI metrics for a set of data sources, over a time period	metric-resource*	aws:ResourceTag/${TagKey} pi:Dimensions	Read
ListAvailableResourceDimensions	Grants permission to call ListAvailableResourceDimensions API to retrieve the dimensions that can be queried for each specified metric type on a specified DB instance	metric-resource*	aws:ResourceTag/${TagKey}	Read
ListAvailableResourceMetrics	Grants permission to call ListAvailableResourceMetrics API to retrieve metrics of the specified types that can be queried for a specified DB instance	metric-resource*	aws:ResourceTag/${TagKey}	Read
ListPerformanceAnalysisReportRecommendations	Grants permission to call ListPerformanceAnalysisReportRecommendations API to retrieve a Performance Analysis Report Recommendations for a specified DB instance	perf-reports-resource*	aws:ResourceTag/${TagKey}	List
ListPerformanceAnalysisReports	Grants permission to call ListPerformanceAnalysisReports API to list Performance Analysis Reports for a specified DB instance	perf-reports-resource*	aws:ResourceTag/${TagKey}	List
ListTagsForResource	Grants permission to call ListTagsForResource API to list tags for a resource	metric-resource*	aws:ResourceTag/${TagKey}	List
ListTagsForResource		perf-reports-resource*	aws:ResourceTag/${TagKey}	List
TagResource	Grants permission to call TagResource API to tag a resource	perf-reports-resource*	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Tagging, Write
UntagResource	Grants permission to call UntagResource API to untag a resource	perf-reports-resource*	aws:ResourceTag/${TagKey} aws:TagKeys	Tagging, Write

Resource types defined by Amazon Performance Insights

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types	ARN	Condition keys
metric-resource	arn:${Partition}:pi:${Region}:${Account}:metrics/${ServiceType}/${Identifier}	aws:ResourceTag/${TagKey}
perf-reports-resource	arn:${Partition}:pi:${Region}:${Account}:perf-reports/${ServiceType}/${Identifier}/${ReportId}	aws:ResourceTag/${TagKey}

Condition keys for Amazon Performance Insights

Amazon Performance Insights defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys	Description	Type
aws:RequestTag/${TagKey}	Filters access by the tags that are passed in the request	String
aws:ResourceTag/${TagKey}	Filters access by the tags associated with the resource	String
aws:TagKeys	Filters access by the tag keys that are passed in the request	ArrayOfString
pi:Dimensions	Filters access by the requested dimensions	ArrayOfString

Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Amazon Payments (payments)

Amazon Price List (pricing)