Struct Expression 

#[non_exhaustive]
pub struct Expression {
    pub or: Option<Vec<Expression>>,
    pub and: Option<Vec<Expression>>,
    pub not: Option<Box<Expression>>,
    pub dimensions: Option<DimensionValues>,
}

Use Expression to filter in the GetFreeTierUsage API operation.

You can use the following patterns:

• Simple dimension values (Dimensions root operator)

• Complex expressions with logical operators (AND, NOT, and OR root operators).

For simple dimension values, you can set the dimension name, values, and match type for the filters that you plan to use.

Example for simple dimension values

You can filter to match exactly for REGION==us-east-1 OR REGION==us-west-1.

The corresponding Expression appears like the following: { "Dimensions": { "Key": "REGION", "Values": \[ "us-east-1", "us-west-1" \], "MatchOptions": \["EQUALS"\] } }

As shown in the previous example, lists of dimension values are combined with OR when you apply the filter.

For complex expressions with logical operators, you can have nested expressions to use the logical operators and specify advanced filtering.

Example for complex expressions with logical operators

You can filter by ((REGION == us-east-1 OR REGION == us-west-1) OR (SERVICE CONTAINS AWSLambda)) AND (USAGE_TYPE !CONTAINS DataTransfer).

The corresponding Expression appears like the following: { "And": \[ {"Or": \[ {"Dimensions": { "Key": "REGION", "Values": \[ "us-east-1", "us-west-1" \], "MatchOptions": \["EQUALS"\] }}, {"Dimensions": { "Key": "SERVICE", "Values": \["AWSLambda"\], "MatchOptions": \["CONTAINS"\] } } \]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": \["DataTransfer"\], "MatchOptions": \["CONTAINS"\] }}} \] }

In the following Contents, you must specify exactly one of the following root operators.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

or: Option<Vec<Expression>>

Return results that match any of the Expressions that you specified. in the array.

and: Option<Vec<Expression>>

Return results that match all Expressions that you specified in the array.

not: Option<Box<Expression>>

Return results that don’t match the Expression that you specified.

dimensions: Option<DimensionValues>

The specific dimension, values, and match type to filter objects with.

Implementations

impl Expression

pub fn or(&self) -> &[Expression]

Return results that match any of the Expressions that you specified. in the array.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .or.is_none().

pub fn and(&self) -> &[Expression]

Return results that match all Expressions that you specified in the array.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .and.is_none().

pub fn not(&self) -> Option<&Expression>

Return results that don’t match the Expression that you specified.

pub fn dimensions(&self) -> Option<&DimensionValues>

The specific dimension, values, and match type to filter objects with.

impl Expression

pub fn builder() -> ExpressionBuilder

Creates a new builder-style object to manufacture Expression.

Trait Implementations

impl Clone for Expression

fn clone(&self) -> Expression

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Expression

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Expression

fn eq(&self, other: &Expression) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Expression