Table Options #

• GetCostAndUsage ([]CustomGetCostAndUsageInput) (nullable)

CustomGetCostAndUsageInput #

• Granularity (string)

  Sets the Amazon Web Services cost granularity to MONTHLY or DAILY , or HOURLY . If Granularity isn't set, the response object doesn't include the Granularity , either MONTHLY or DAILY , or HOURLY .

  This member is required.
• Metrics ([]string) (nullable)

  Which metrics are returned in the query. For more information about blended and unblended rates, see Why does the "blended" annotation appear on some line items in my bill?.

  Valid values are AmortizedCost , BlendedCost , NetAmortizedCost , NetUnblendedCost , NormalizedUsageAmount , UnblendedCost , and UsageQuantity .

  If you return the UsageQuantity metric, the service aggregates all usage numbers without taking into account the units. For example, if you aggregate usageQuantity across all of Amazon EC2, the results aren't meaningful because Amazon EC2 compute hours and data transfer are measured in different units (for example, hours and GB). To get more meaningful UsageQuantity metrics, filter by UsageType or UsageTypeGroups .

  Metrics is required for GetCostAndUsage requests.

  This member is required.
• TimePeriod (DateInterval) (nullable)

  Sets the start date and end date for retrieving Amazon Web Services costs. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01 , then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01 .

  This member is required.
• BillingViewArn (string) (nullable)

  The Amazon Resource Name (ARN) that uniquely identifies a specific billing view. The ARN is used to specify which particular billing view you want to interact with or retrieve information from when making API calls related to Amazon Web Services Billing and Cost Management features. The BillingViewArn can be retrieved by calling the ListBillingViews API.
• Filter (Expression) (nullable)

  Filters Amazon Web Services costs by different dimensions. For example, you can specify SERVICE and LINKED_ACCOUNT and get the costs that are associated with that account's usage of that service. You can nest Expression objects to define any combination of dimension filters. For more information, see Expression.

  Valid values for MatchOptions for Dimensions are EQUALS and CASE_SENSITIVE .

  Valid values for MatchOptions for CostCategories and Tags are EQUALS , ABSENT , and CASE_SENSITIVE . Default values are EQUALS and CASE_SENSITIVE .
• GroupBy ([]GroupDefinition) (nullable)

  You can group Amazon Web Services costs using up to two different groups, either dimensions, tag keys, cost categories, or any two group by types.

  Valid values for the DIMENSION type are AZ , INSTANCE_TYPE , LEGAL_ENTITY_NAME , INVOICING_ENTITY , LINKED_ACCOUNT , OPERATION , PLATFORM , PURCHASE_TYPE , SERVICE , TENANCY , RECORD_TYPE , and USAGE_TYPE .

  When you group by the TAG type and include a valid tag key, you get all tag values, including empty strings.

DateInterval

• End (string) (nullable)

  The end of the time period. The end date is exclusive. For example, if end is 2017-05-01 , Amazon Web Services retrieves cost and usage data from the start date up to, but not including, 2017-05-01 .

  This member is required.
• Start (string) (nullable)

  The beginning of the time period. The start date is inclusive. For example, if start is 2017-01-01 , Amazon Web Services retrieves cost and usage data starting at 2017-01-01 up to the end date. The start date must be equal to or no later than the current date to avoid a validation error.

  This member is required.

Expression

• And ([]Expression) (nullable)

  Return results that match both Dimension objects.
• CostCategories (CostCategoryValues) (nullable)

  The filter that's based on CostCategory values.
• Dimensions (DimensionValues) (nullable)

  The specific Dimension to use for Expression .
• Not (Expression) (nullable)

  Return results that don't match a Dimension object.
• Or ([]Expression) (nullable)

  Return results that match either Dimension object.
• Tags (TagValues) (nullable)

  The specific Tag to use for Expression .

CostCategoryValues

• Key (string) (nullable)

  The unique name of the Cost Category.
• MatchOptions ([]string) (nullable)

  The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category. The default values for MatchOptions is EQUALS and CASE_SENSITIVE .
• Values ([]string) (nullable)

  The specific value of the Cost Category.

DimensionValues

• Key (string)

  The names of the metadata types that you can use to filter and group your results. For example, AZ returns a list of Availability Zones.

  Not all dimensions are supported in each API. Refer to the documentation for each specific API to see what is supported.

  LINKED_ACCOUNT_NAME and SERVICE_CODE can only be used in CostCategoryRule.

  ANOMALY_TOTAL_IMPACT_ABSOLUTE and ANOMALY_TOTAL_IMPACT_PERCENTAGE can only be used in AnomalySubscriptions.
• MatchOptions ([]string) (nullable)

  The match options that you can use to filter your results.

  MatchOptions is only applicable for actions related to Cost Category and Anomaly Subscriptions. Refer to the documentation for each specific API to see what is supported.

  The default values for MatchOptions are EQUALS and CASE_SENSITIVE .
• Values ([]string) (nullable)

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

TagValues

• Key (string) (nullable)

  The key for the tag.
• MatchOptions ([]string) (nullable)

  The match options that you can use to filter your results. MatchOptions is only applicable for actions related to Cost Category. The default values for MatchOptions are EQUALS and CASE_SENSITIVE .
• Values ([]string) (nullable)

  The specific value of the tag.

GroupDefinition

• Key (string) (nullable)

  The string that represents a key for a specified group.
• Type (string)

  The string that represents the type of group.