You are viewing documentation for version 3 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: Aws::CostExplorer::Types::GetDimensionValuesRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb

Overview

Note:

When making an API call, you may pass GetDimensionValuesRequest data as a hash:

{
  search_string: "SearchString",
  time_period: { # required
    start: "YearMonthDay", # required
    end: "YearMonthDay", # required
  },
  dimension: "AZ", # required, accepts AZ, INSTANCE_TYPE, LINKED_ACCOUNT, OPERATION, PURCHASE_TYPE, REGION, SERVICE, USAGE_TYPE, USAGE_TYPE_GROUP, RECORD_TYPE, OPERATING_SYSTEM, TENANCY, SCOPE, PLATFORM, SUBSCRIPTION_ID, LEGAL_ENTITY_NAME, DEPLOYMENT_OPTION, DATABASE_ENGINE, CACHE_ENGINE, INSTANCE_TYPE_FAMILY
  context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS
  next_page_token: "NextPageToken",
}

Instance Attribute Summary collapse

Instance Attribute Details

#contextString

The context for the call to GetDimensionValues. This can be RESERVATIONS or COST_AND_USAGE. The default value is COST_AND_USAGE. If the context is set to RESERVATIONS, the resulting dimension values can be used in the GetReservationUtilization action. If the context is set to COST_AND_USAGE, the resulting dimension values can be used in the GetCostAndUsage operation.

If you set the context to CostAndUsage, you can use the following dimensions for searching:

  • AZ - The Availability Zone. An example is us-east-1a.

  • INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.

  • LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the AWS ID of the member account

  • OPERATION - The action performed. Examples include RunInstance and CreateBucket.

  • PURCHASE_TYPE - The reservation type of the purchase to which this usage is related. Examples include: On Demand Instances and Standard Reserved Instances

  • SERVICE - The AWS service such as DynamoDB.

  • USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues action includes a unit attribute, examples of which include GB and Hrs.

  • USAGE_TYPE_GROUP - The grouping of common usage types. An example is EC2: CloudWatch – Alarms. The response for this action includes a unit attribute.

  • RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax refunds, and credits.

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

  • AZ - The Availability Zone. An example is us-east-1a.

  • INSTANCE_TYPE - The type of EC2 instance. An example is m4.xlarge.

  • LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the AWS ID of the member account

  • PLATFORM - The operating system. Examples are Windows or Linux.

  • REGION - The AWS region.

  • SCOPE - The scope of a reserved instance (RI). Values are regional or a single availability zone.

  • TENANCY - The tenancy of a resource. Examples are shared or dedicated.

Returns:

  • (String)


555
556
557
558
559
560
561
562
# File 'gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb', line 555

class GetDimensionValuesRequest < Struct.new(
  :search_string,
  :time_period,
  :dimension,
  :context,
  :next_page_token)
  include Aws::Structure
end

#dimensionString

The name of the dimension. Each Dimensionsis available for different a Context. For more information, see Context.

Returns:

  • (String)


555
556
557
558
559
560
561
562
# File 'gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb', line 555

class GetDimensionValuesRequest < Struct.new(
  :search_string,
  :time_period,
  :dimension,
  :context,
  :next_page_token)
  include Aws::Structure
end

#next_page_tokenString

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

Returns:

  • (String)


555
556
557
558
559
560
561
562
# File 'gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb', line 555

class GetDimensionValuesRequest < Struct.new(
  :search_string,
  :time_period,
  :dimension,
  :context,
  :next_page_token)
  include Aws::Structure
end

#search_stringString

The value that you want to search the filter values for.

Returns:

  • (String)


555
556
557
558
559
560
561
562
# File 'gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb', line 555

class GetDimensionValuesRequest < Struct.new(
  :search_string,
  :time_period,
  :dimension,
  :context,
  :next_page_token)
  include Aws::Structure
end

#time_periodTypes::DateInterval

The start and end dates for retrieving the dimension values. 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.

Returns:



555
556
557
558
559
560
561
562
# File 'gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb', line 555

class GetDimensionValuesRequest < Struct.new(
  :search_string,
  :time_period,
  :dimension,
  :context,
  :next_page_token)
  include Aws::Structure
end