NAME
Paws::CostExplorer::Expression
USAGE
This class represents one of two things:
Arguments in a call to a service
Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object.
As an example, if Att1 is expected to be a Paws::CostExplorer::Expression object:
$service_obj->Method(Att1 => { And => $value, ..., Tags => $value });
Results returned from an API call
Use accessors for each attribute. If Att1 is expected to be an Paws::CostExplorer::Expression object:
$result = $service_obj->Method(...);
$result->Att1->And
DESCRIPTION
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
. ForGetRightsizingRecommendation
, the Region is a full name (for example,REGION==US East (N. Virginia)
. TheExpression
example looks like:{ "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
andDimensionValues
objects using eitherwith*
methods orset*
methods in multiple lines.Compound dimension values with logical operations - You can use multiple
Expression
types and the logical operatorsAND/OR/NOT
to create a list of one or moreExpression
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 (USAGE_TYPE != DataTransfer)
. TheExpression
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": "USAGE_TYPE", "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 anExpression
object that creates an error.{ "And": [ ... ], "DimensionValues": { "Dimension": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }
For the 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 LINKED_ACCOUNT
, REGION
, or RIGHTSIZING_TYPE
.
For the GetReservationPurchaseRecommendation
action, only NOT is supported. AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT
.
ATTRIBUTES
And => ArrayRef[Paws::CostExplorer::Expression]
Return results that match both Dimension
objects.
CostCategories => Paws::CostExplorer::CostCategoryValues
The filter based on CostCategory
values.
Dimensions => Paws::CostExplorer::DimensionValues
The specific Dimension
to use for Expression
.
Not => Paws::CostExplorer::Expression
Return results that don't match a Dimension
object.
Or => ArrayRef[Paws::CostExplorer::Expression]
Return results that match either Dimension
object.
Tags => Paws::CostExplorer::TagValues
The specific Tag
to use for Expression
.
SEE ALSO
This class forms part of Paws, describing an object used in Paws::CostExplorer
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues