[][src]Crate rusoto_ce

The Cost Explorer API enables you to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data, such as the number of daily write operations for Amazon DynamoDB database tables in your production environment.

Service Endpoint

The Cost Explorer API provides the following endpoint:

  • https://ce.us-east-1.amazonaws.com

For information about costs associated with the Cost Explorer API, see AWS Cost Management Pricing.

If you're using the service, you're probably looking for CostExplorerClient and CostExplorer.

Structs

CostCategory

The structure of Cost Categories. This includes detailed metadata and the set of rules for the CostCategory object.

CostCategoryReference

A reference to a Cost Category containing only enough information to identify the Cost Category.

You can use this information to retrieve the full Cost Category information using DescribeCostCategory.

CostCategoryRule

Rules are processed in order. If there are multiple rules that match the line item, then the first rule to match is used to determine that Cost Category value.

CostCategoryValues

The Cost Categories values used for filtering the costs.

CostExplorerClient

A client for the AWS Cost Explorer API.

Coverage

The amount of instance usage that a reservation covered.

CoverageByTime

Reservation coverage for a specified period, in hours.

CoverageCost

How much it costs to run an instance.

CoverageHours

How long a running instance either used a reservation or was On-Demand.

CoverageNormalizedUnits

The amount of instance usage, in normalized units. Normalized units enable you to see your EC2 usage for multiple sizes of instances in a uniform way. For example, suppose you run an xlarge instance and a 2xlarge instance. If you run both instances for the same amount of time, the 2xlarge instance uses twice as much of your reservation as the xlarge instance, even though both instances show only one instance-hour. Using normalized units instead of instance-hours, the xlarge instance used 8 normalized units, and the 2xlarge instance used 16 normalized units.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux Instances.

CreateCostCategoryDefinitionRequest
CreateCostCategoryDefinitionResponse
CurrentInstance

Context about the current instance.

DateInterval

The time period that you want the usage and costs for.

DeleteCostCategoryDefinitionRequest
DeleteCostCategoryDefinitionResponse
DescribeCostCategoryDefinitionRequest
DescribeCostCategoryDefinitionResponse
DimensionValues

The metadata that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

DimensionValuesWithAttributes

The metadata of a specific type that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

EC2InstanceDetails

Details about the Amazon EC2 instances that AWS recommends that you purchase.

EC2ResourceDetails

Details on the Amazon EC2 Resource.

EC2ResourceUtilization

Utilization metrics of the instance.

EC2Specification

The Amazon EC2 hardware specifications that you want AWS to provide recommendations for.

ESInstanceDetails

Details about the Amazon ES instances that AWS recommends that you purchase.

ElastiCacheInstanceDetails

Details about the Amazon ElastiCache instances that AWS recommends that you purchase.

Expression

Use Expression to filter by cost or by usage. There are two patterns:

  • Simple dimension values - You can set the dimension name and values for the filters that you plan to use. For example, you can filter for REGION==us-east-1 OR REGION==us-west-1. The Expression for that looks like this:

    { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", “us-west-1” ] } }

    The list of dimension values are OR'd together to retrieve cost or usage data. You can create Expression and DimensionValues objects using either with methods or set methods in multiple lines.

  • Compound dimension values with logical operations - You can use multiple Expression types and the logical operators AND/OR/NOT to create a list of one or more Expression objects. This allows you to filter on more advanced options. For example, you can filter on ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGETYPE != DataTransfer). The Expression for that looks like this:

    { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGETYPE", "Values": ["DataTransfer"] }}} ] }

    Because each Expression can have only one operator, the service returns an error if more than one is specified. The following example shows an Expression object that creates an error.

    { "And": [ ... ], "DimensionValues": { "Dimension": "USAGETYPE", "Values": [ "DataTransfer" ] } }

For GetRightsizingRecommendation action, a combination of OR and NOT is not supported. OR is not supported between different dimensions, or dimensions and tags. NOT operators aren't supported. Dimensions are also limited to LINKEDACCOUNT, REGION, or RIGHTSIZING_TYPE.

ForecastResult

The forecast created for your query.

GetCostAndUsageRequest
GetCostAndUsageResponse
GetCostAndUsageWithResourcesRequest
GetCostAndUsageWithResourcesResponse
GetCostForecastRequest
GetCostForecastResponse
GetDimensionValuesRequest
GetDimensionValuesResponse
GetReservationCoverageRequest

You can use the following request parameters to query for how much of your instance usage a reservation covered.

GetReservationCoverageResponse
GetReservationPurchaseRecommendationRequest
GetReservationPurchaseRecommendationResponse
GetReservationUtilizationRequest
GetReservationUtilizationResponse
GetRightsizingRecommendationRequest
GetRightsizingRecommendationResponse
GetSavingsPlansCoverageRequest
GetSavingsPlansCoverageResponse
GetSavingsPlansPurchaseRecommendationRequest
GetSavingsPlansPurchaseRecommendationResponse
GetSavingsPlansUtilizationDetailsRequest
GetSavingsPlansUtilizationDetailsResponse
GetSavingsPlansUtilizationRequest
GetSavingsPlansUtilizationResponse
GetTagsRequest
GetTagsResponse
GetUsageForecastRequest
GetUsageForecastResponse
Group

One level of grouped data in the results.

GroupDefinition

Represents a group when you specify a group by criteria or in the response to a query with a specific grouping.

InstanceDetails

Details about the instances that AWS recommends that you purchase.

ListCostCategoryDefinitionsRequest
ListCostCategoryDefinitionsResponse
MetricValue

The aggregated value for a metric.

ModifyRecommendationDetail

Details on the modification recommendation.

RDSInstanceDetails

Details about the Amazon RDS instances that AWS recommends that you purchase.

RedshiftInstanceDetails

Details about the Amazon Redshift instances that AWS recommends that you purchase.

ReservationAggregates

The aggregated numbers for your reservation usage.

ReservationCoverageGroup

A group of reservations that share a set of attributes.

ReservationPurchaseRecommendation

A specific reservation that AWS recommends for purchase.

ReservationPurchaseRecommendationDetail

Details about your recommended reservation purchase.

ReservationPurchaseRecommendationMetadata

Information about this specific recommendation, such as the timestamp for when AWS made a specific recommendation.

ReservationPurchaseRecommendationSummary

A summary about this recommendation, such as the currency code, the amount that AWS estimates that you could save, and the total amount of reservation to purchase.

ReservationUtilizationGroup

A group of reservations that share a set of attributes.

ResourceDetails

Details on the resource.

ResourceUtilization

Resource utilization of current resource.

ResultByTime

The result that is associated with a time period.

RightsizingRecommendation

Recommendations to rightsize resources.

RightsizingRecommendationConfiguration

Enables you to customize recommendations across two attributes. You can choose to view recommendations for instances within the same instance families or across different instance families. You can also choose to view your estimated savings associated with recommendations with consideration of existing Savings Plans or RI benefits, or neither.

RightsizingRecommendationMetadata

Metadata for this recommendation set.

RightsizingRecommendationSummary

Summary of rightsizing recommendations

SavingsPlansAmortizedCommitment

The amortized amount of Savings Plans purchased in a specific account during a specific time interval.

SavingsPlansCoverage

The amount of Savings Plans eligible usage that is covered by Savings Plans. All calculations consider the On-Demand equivalent of your Savings Plans usage.

SavingsPlansCoverageData

Specific coverage percentage, On-Demand costs, and spend covered by Savings Plans, and total Savings Plans costs for an account.

SavingsPlansDetails

Attribute details on a specific Savings Plan.

SavingsPlansPurchaseRecommendation

Contains your request parameters, Savings Plan Recommendations Summary, and Details.

SavingsPlansPurchaseRecommendationDetail

Details for your recommended Savings Plans.

SavingsPlansPurchaseRecommendationMetadata

Metadata about your Savings Plans Purchase Recommendations.

SavingsPlansPurchaseRecommendationSummary

Summary metrics for your Savings Plans Purchase Recommendations.

SavingsPlansSavings

The amount of savings you're accumulating, against the public On-Demand rate of the usage accrued in an account.

SavingsPlansUtilization

The measurement of how well you are using your existing Savings Plans.

SavingsPlansUtilizationAggregates

The aggregated utilization metrics for your Savings Plans usage.

SavingsPlansUtilizationByTime

The amount of Savings Plans utilization, in hours.

SavingsPlansUtilizationDetail

A single daily or monthly Savings Plans utilization rate, and details for your account. Master accounts in an organization have access to member accounts. You can use GetDimensionValues to determine the possible dimension values.

ServiceSpecification

Hardware specifications for the service that you want recommendations for.

TagValues

The values that are available for a tag.

TargetInstance

Details on recommended instance.

TerminateRecommendationDetail

Details on termination recommendation.

UpdateCostCategoryDefinitionRequest
UpdateCostCategoryDefinitionResponse
UtilizationByTime

The amount of utilization, in hours.

Enums

CreateCostCategoryDefinitionError

Errors returned by CreateCostCategoryDefinition

DeleteCostCategoryDefinitionError

Errors returned by DeleteCostCategoryDefinition

DescribeCostCategoryDefinitionError

Errors returned by DescribeCostCategoryDefinition

GetCostAndUsageError

Errors returned by GetCostAndUsage

GetCostAndUsageWithResourcesError

Errors returned by GetCostAndUsageWithResources

GetCostForecastError

Errors returned by GetCostForecast

GetDimensionValuesError

Errors returned by GetDimensionValues

GetReservationCoverageError

Errors returned by GetReservationCoverage

GetReservationPurchaseRecommendationError

Errors returned by GetReservationPurchaseRecommendation

GetReservationUtilizationError

Errors returned by GetReservationUtilization

GetRightsizingRecommendationError

Errors returned by GetRightsizingRecommendation

GetSavingsPlansCoverageError

Errors returned by GetSavingsPlansCoverage

GetSavingsPlansPurchaseRecommendationError

Errors returned by GetSavingsPlansPurchaseRecommendation

GetSavingsPlansUtilizationDetailsError

Errors returned by GetSavingsPlansUtilizationDetails

GetSavingsPlansUtilizationError

Errors returned by GetSavingsPlansUtilization

GetTagsError

Errors returned by GetTags

GetUsageForecastError

Errors returned by GetUsageForecast

ListCostCategoryDefinitionsError

Errors returned by ListCostCategoryDefinitions

UpdateCostCategoryDefinitionError

Errors returned by UpdateCostCategoryDefinition

Traits

CostExplorer

Trait representing the capabilities of the AWS Cost Explorer API. AWS Cost Explorer clients implement this trait.