Operations Actions Permission-only actions Resource types Condition keys

Actions, resources, and condition keys for Amazon Cost Explorer Service

Amazon Cost Explorer Service (service prefix: ce) 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 Cost Explorer Service
Actions defined by Amazon Cost Explorer Service
Permission-only actions for Amazon Cost Explorer Service
Resource types defined by Amazon Cost Explorer Service
Condition keys for Amazon Cost Explorer Service

API operations defined by Amazon Cost Explorer Service

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
CreateAnomalyMonitor	ce:CreateAnomalyMonitor	Write
CreateAnomalyMonitor	ce:TagResource	Tagging, Write
CreateAnomalySubscription	ce:CreateAnomalySubscription	Write
CreateAnomalySubscription	ce:TagResource	Tagging, Write
CreateCostCategoryDefinition	ce:CreateCostCategoryDefinition	Write
CreateCostCategoryDefinition	ce:TagResource	Tagging, Write
DeleteAnomalyMonitor	ce:DeleteAnomalyMonitor	Write
DeleteAnomalySubscription	ce:DeleteAnomalySubscription	Write
DeleteCostCategoryDefinition	ce:DeleteCostCategoryDefinition	Write
DescribeCostCategoryDefinition	ce:DescribeCostCategoryDefinition	Read
GetAnomalies	ce:GetAnomalies	Read
GetAnomalyMonitors	ce:GetAnomalyMonitors	Read
GetAnomalySubscriptions	ce:GetAnomalySubscriptions	Read
GetApproximateUsageRecords	ce:GetApproximateUsageRecords	Read
GetCommitmentPurchaseAnalysis	ce:GetCommitmentPurchaseAnalysis	Read
GetCostAndUsage	ce:GetCostAndUsage	Read
GetCostAndUsage	aws-portal:ViewBilling	Read
GetCostAndUsageComparisons	ce:GetCostAndUsageComparisons	Read
GetCostAndUsageWithResources	ce:GetCostAndUsageWithResources	Read
GetCostAndUsageWithResources	aws-portal:ViewBilling	Read
GetCostCategories	ce:GetCostCategories	Read
GetCostCategories	aws-portal:ViewBilling	Read
GetCostComparisonDrivers	ce:GetCostComparisonDrivers	Read
GetCostForecast	ce:GetCostForecast	Read
GetCostForecast	aws-portal:ViewBilling	Read
GetDimensionValues	ce:GetDimensionValues	Read
GetDimensionValues	aws-portal:ViewBilling	Read
GetReservationCoverage	ce:GetReservationCoverage	Read
GetReservationCoverage	aws-portal:ViewBilling	Read
GetReservationPurchaseRecommendation	ce:GetReservationPurchaseRecommendation	Read
GetReservationPurchaseRecommendation	aws-portal:ViewBilling	Read
GetReservationUtilization	ce:GetReservationUtilization	Read
GetReservationUtilization	aws-portal:ViewBilling	Read
GetRightsizingRecommendation	ce:GetRightsizingRecommendation	Read
GetRightsizingRecommendation	aws-portal:ViewBilling	Read
GetSavingsPlanPurchaseRecommendationDetails	ce:GetSavingsPlanPurchaseRecommendationDetails	Read
GetSavingsPlanPurchaseRecommendationDetails	aws-portal:ViewBilling	Read
GetSavingsPlansCoverage	ce:GetSavingsPlansCoverage	Read
GetSavingsPlansCoverage	aws-portal:ViewBilling	Read
GetSavingsPlansPurchaseRecommendation	ce:GetSavingsPlansPurchaseRecommendation	Read
GetSavingsPlansPurchaseRecommendation	aws-portal:ViewBilling	Read
GetSavingsPlansUtilization	ce:GetSavingsPlansUtilization	Read
GetSavingsPlansUtilization	aws-portal:ViewBilling	Read
GetSavingsPlansUtilizationDetails	ce:GetSavingsPlansUtilizationDetails	Read
GetSavingsPlansUtilizationDetails	aws-portal:ViewBilling	Read
GetTags	ce:GetTags	Read
GetTags	aws-portal:ViewBilling	Read
GetUsageForecast	ce:GetUsageForecast	Read
GetUsageForecast	aws-portal:ViewBilling	Read
ListCommitmentPurchaseAnalyses	ce:ListCommitmentPurchaseAnalyses	List
ListCostAllocationTagBackfillHistory	ce:ListCostAllocationTagBackfillHistory	List
ListCostAllocationTags	ce:ListCostAllocationTags	List
ListCostAllocationTags	aws-portal:ViewBilling	Read
ListCostCategoryDefinitions	ce:ListCostCategoryDefinitions	List
ListCostCategoryResourceAssociations	ce:ListCostCategoryResourceAssociations	List
ListSavingsPlansPurchaseRecommendationGeneration	ce:ListSavingsPlansPurchaseRecommendationGeneration	List
ListTagsForResource	ce:ListTagsForResource	Read
ProvideAnomalyFeedback	ce:ProvideAnomalyFeedback	Write
StartCommitmentPurchaseAnalysis	ce:StartCommitmentPurchaseAnalysis	Write
StartCostAllocationTagBackfill	ce:StartCostAllocationTagBackfill	Write
StartSavingsPlansPurchaseRecommendationGeneration	ce:StartSavingsPlansPurchaseRecommendationGeneration	Write
TagResource	ce:TagResource	Tagging, Write
UntagResource	ce:UntagResource	Tagging, Write
UpdateAnomalyMonitor	ce:UpdateAnomalyMonitor	Write
UpdateAnomalySubscription	ce:UpdateAnomalySubscription	Write
UpdateCostAllocationTagsStatus	ce:UpdateCostAllocationTagsStatus	Write
UpdateCostAllocationTagsStatus	aws-portal:ModifyBilling	Write
UpdateCostCategoryDefinition	ce:UpdateCostCategoryDefinition	Write

Actions defined by Amazon Cost Explorer Service

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
CreateAnomalyMonitor	Grants permission to create a new Anomaly Monitor		aws:RequestTag/${TagKey} aws:TagKeys	Write
CreateAnomalySubscription	Grants permission to create a new Anomaly Subscription		aws:RequestTag/${TagKey} aws:TagKeys	Write
CreateCostCategoryDefinition	Grants permission to create a new Cost Category with the requested name and rules		aws:RequestTag/${TagKey} aws:TagKeys	Write
DeleteAnomalyMonitor	Grants permission to delete an Anomaly Monitor	anomalymonitor*	aws:ResourceTag/${TagKey}	Write
DeleteAnomalySubscription	Grants permission to delete an Anomaly Subscription	anomalysubscription*	aws:ResourceTag/${TagKey}	Write
DeleteCostCategoryDefinition	Grants permission to delete a Cost Category	costcategory*	aws:ResourceTag/${TagKey}	Write
DescribeCostCategoryDefinition	Grants permission to retrieve descriptions such as the name, ARN, rules, definition, and effective dates of a Cost Category	costcategory*	aws:ResourceTag/${TagKey}	Read
GetAnomalies	Grants permission to retrieve anomalies	anomalymonitor*	aws:ResourceTag/${TagKey}	Read
GetAnomalyMonitors	Grants permission to query Anomaly Monitors	anomalymonitor*	aws:ResourceTag/${TagKey}	Read
GetAnomalySubscriptions	Grants permission to query Anomaly Subscriptions	anomalysubscription*	aws:ResourceTag/${TagKey}	Read
GetApproximateUsageRecords	Grants permission to retrieve approximate usage record count for the chosen resource, level, and hourly granularity preferences, derived from the past month's usage			Read
GetCommitmentPurchaseAnalysis	Grants permission to retrieve the commitment purchase analysis for your account			Read
GetCostAndUsage	Grants permission to retrieve the cost and usage metrics for your account	billingview	aws:ResourceTag/${TagKey}	Read
GetCostAndUsageComparisons	Grants permission to retrieve the cost and usage comparisons for your account	billingview	aws:ResourceTag/${TagKey}	Read
GetCostAndUsageWithResources	Grants permission to retrieve the cost and usage metrics with resources for your account	billingview	aws:ResourceTag/${TagKey}	Read
GetCostCategories	Grants permission to query Cost Catagory names and values for a specified time period	billingview	aws:ResourceTag/${TagKey}	Read
GetCostComparisonDrivers	Grants permission to retrieve the cost drivers for your account	billingview	aws:ResourceTag/${TagKey}	Read
GetCostForecast	Grants permission to retrieve a cost forecast for a forecast time period	billingview	aws:ResourceTag/${TagKey}	Read
GetDimensionValues	Grants permission to retrieve all available filter values for a filter for a period of time	billingview	aws:ResourceTag/${TagKey}	Read
GetReservationCoverage	Grants permission to retrieve the reservation coverage for your account			Read
GetReservationPurchaseRecommendation	Grants permission to retrieve the reservation recommendations for your account			Read
GetReservationUtilization	Grants permission to retrieve the reservation utilization for your account			Read
GetRightsizingRecommendation	Grants permission to retrieve the rightsizing recommendations for your account			Read
GetSavingsPlanPurchaseRecommendationDetails	Grants permission to retrieve the Savings Plan recommendation details for your account			Read
GetSavingsPlansCoverage	Grants permission to retrieve the Savings Plans coverage for your account			Read
GetSavingsPlansPurchaseRecommendation	Grants permission to retrieve the Savings Plans recommendations for your account			Read
GetSavingsPlansUtilization	Grants permission to retrieve the Savings Plans utilization for your account			Read
GetSavingsPlansUtilizationDetails	Grants permission to retrieve the Savings Plans utilization details for your account			Read
GetTags	Grants permission to query tags for a specified time period	billingview	aws:ResourceTag/${TagKey}	Read
GetUsageForecast	Grants permission to retrieve a usage forecast for a forecast time period	billingview	aws:ResourceTag/${TagKey}	Read
ListCommitmentPurchaseAnalyses	Grants permission to retrieve a list of your historical commitment purchase analyses			List
ListCostAllocationTagBackfillHistory	Grants permission to list Cost Allocation Tag backfill history			List
ListCostAllocationTags	Grants permission to list Cost Allocation Tags			List
ListCostCategoryDefinitions	Grants permission to retrieve names, ARN, and effective dates for all Cost Categories			List
ListCostCategoryResourceAssociations	Grants permission to retrieve resource associations of all Cost Categories defined in the account			List
ListSavingsPlansPurchaseRecommendationGeneration	Grants permission to retrieve a list of your historical recommendation generations			List
ListTagsForResource	Grants permission to list tags for a Cost Explorer resource	anomalymonitor	aws:ResourceTag/${TagKey}	Read
		anomalysubscription	aws:ResourceTag/${TagKey}
		costcategory	aws:ResourceTag/${TagKey}
ProvideAnomalyFeedback	Grants permission to provide feedback on detected anomalies			Write
StartCommitmentPurchaseAnalysis	Grants permission to request a commitment purchase analysis			Write
StartCostAllocationTagBackfill	Grants permission to request a Cost Allocation Tag backfill			Write
StartSavingsPlansPurchaseRecommendationGeneration	Grants permission to request a Savings Plans recommendation generation			Write
TagResource	Grants permission to tag a Cost Explorer resource	anomalymonitor	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Tagging, Write
		anomalysubscription	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys
		costcategory	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys
UntagResource	Grants permission to remove tags from a Cost Explorer resource	anomalymonitor	aws:ResourceTag/${TagKey} aws:TagKeys	Tagging, Write
		anomalysubscription	aws:ResourceTag/${TagKey} aws:TagKeys
		costcategory	aws:ResourceTag/${TagKey} aws:TagKeys
UpdateAnomalyMonitor	Grants permission to update an existing Anomaly Monitor	anomalymonitor*	aws:ResourceTag/${TagKey}	Write
UpdateAnomalySubscription	Grants permission to update an existing Anomaly Subscription	anomalysubscription*	aws:ResourceTag/${TagKey}	Write
UpdateCostAllocationTagsStatus	Grants permission to update existing Cost Allocation Tags status			Write
UpdateCostCategoryDefinition	Grants permission to update an existing Cost Category	costcategory*	aws:ResourceTag/${TagKey}	Write

Permission-only actions for Amazon Cost Explorer Service

The following actions are defined by Amazon Cost Explorer Service but are not directly invocable through any API operation. They can only be used in IAM policy statements to grant or deny permissions.

Actions	Description	Access level
CreateNotificationSubscription	Grants permission to create Reservation expiration alerts	Write
CreateReport	Grants permission to create Cost Explorer Reports	Write
DeleteNotificationSubscription	Grants permission to delete Reservation expiration alerts	Write
DeleteReport	Grants permission to delete Cost Explorer Reports	Write
DescribeNotificationSubscription	Grants permission to view Reservation expiration alerts	Read
DescribeReport	Grants permission to view Cost Explorer Reports page	Read
GetConsoleActionSetEnforced	Grants permission to view whether existing or fine-grained IAM actions are being used to control authorization to Billing, Cost Management, and Account consoles	Read
GetPreferences	Grants permission to view Cost Explorer Preferences page	Read
UpdateConsoleActionSetEnforced	Grants permission to change whether existing or fine-grained IAM actions will be used to control authorization to Billing, Cost Management, and Account consoles	Write
UpdateNotificationSubscription	Grants permission to update Reservation expiration alerts	Write
UpdatePreferences	Grants permission to edit Cost Explorer Preferences page	Write
UpdateReport	Grants permission to update Cost Explorer Reports	Write

Resource types defined by Amazon Cost Explorer Service

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
anomalymonitor	arn:${Partition}:ce::${Account}:anomalymonitor/${Identifier}	aws:ResourceTag/${TagKey}
anomalysubscription	arn:${Partition}:ce::${Account}:anomalysubscription/${Identifier}	aws:ResourceTag/${TagKey}
billingview	arn:${Partition}:billing::${Account}:billingview/${ResourceId}	aws:ResourceTag/${TagKey}
costcategory	arn:${Partition}:ce::${Account}:costcategory/${Identifier}	aws:ResourceTag/${TagKey}

Condition keys for Amazon Cost Explorer Service

Amazon Cost Explorer Service 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

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 Cost and Usage Report (cur)

Amazon Database Migration Service (dms)