Class: Aws::EC2::Types::DescribeSpotPriceHistoryRequest

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-ec2/types.rb

Overview

Note:

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

{
  filters: [
    {
      name: "String",
      values: ["String"],
    },
  ],
  availability_zone: "String",
  dry_run: false,
  end_time: Time.now,
  instance_types: ["t1.micro"], # accepts t1.micro, t2.nano, t2.micro, t2.small, t2.medium, t2.large, t2.xlarge, t2.2xlarge, m1.small, m1.medium, m1.large, m1.xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m4.16xlarge, m2.xlarge, m2.2xlarge, m2.4xlarge, cr1.8xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, x1.16xlarge, x1.32xlarge, x1e.xlarge, x1e.2xlarge, x1e.4xlarge, x1e.8xlarge, x1e.16xlarge, x1e.32xlarge, i2.xlarge, i2.2xlarge, i2.4xlarge, i2.8xlarge, i3.large, i3.xlarge, i3.2xlarge, i3.4xlarge, i3.8xlarge, i3.16xlarge, i3.metal, hi1.4xlarge, hs1.8xlarge, c1.medium, c1.xlarge, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.18xlarge, c5d.large, c5d.xlarge, c5d.2xlarge, c5d.4xlarge, c5d.9xlarge, c5d.18xlarge, cc1.4xlarge, cc2.8xlarge, g2.2xlarge, g2.8xlarge, g3.4xlarge, g3.8xlarge, g3.16xlarge, cg1.4xlarge, p2.xlarge, p2.8xlarge, p2.16xlarge, p3.2xlarge, p3.8xlarge, p3.16xlarge, d2.xlarge, d2.2xlarge, d2.4xlarge, d2.8xlarge, f1.2xlarge, f1.16xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.12xlarge, m5.24xlarge, m5d.large, m5d.xlarge, m5d.2xlarge, m5d.4xlarge, m5d.12xlarge, m5d.24xlarge, h1.2xlarge, h1.4xlarge, h1.8xlarge, h1.16xlarge
  max_results: 1,
  next_token: "String",
  product_descriptions: ["String"],
  start_time: Time.now,
}

Contains the parameters for DescribeSpotPriceHistory.

Instance Attribute Summary collapse

Instance Attribute Details

#availability_zoneString

Filters the results by the specified Availability Zone.

Returns:

  • (String)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#dry_runBoolean

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is ‘DryRunOperation`. Otherwise, it is `UnauthorizedOperation`.

Returns:

  • (Boolean)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#end_timeTime

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-*DD*T*HH*:MM:*SS*Z).

Returns:

  • (Time)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#filtersArray<Types::Filter>

One or more filters.

  • ‘availability-zone` - The Availability Zone for which prices should be returned.

  • ‘instance-type` - The type of instance (for example, `m3.medium`).

  • ‘product-description` - The product description for the Spot price (`Linux/UNIX` | `SUSE Linux` | `Windows` | `Linux/UNIX (Amazon VPC)` | `SUSE Linux (Amazon VPC)` | `Windows (Amazon VPC)`).

  • ‘spot-price` - The Spot price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • ‘timestamp` - The time stamp of the Spot price history, in UTC format (for example, YYYY-MM-*DD*T*HH*:MM:*SS*Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

Returns:



12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#instance_typesArray<String>

Filters the results by the specified instance types.

Returns:

  • (Array<String>)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#max_resultsInteger

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned ‘NextToken` value.

Returns:

  • (Integer)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#next_tokenString

The token for the next set of results.

Returns:

  • (String)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#product_descriptionsArray<String>

Filters the results by the specified basic product descriptions.

Returns:

  • (Array<String>)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end

#start_timeTime

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-*DD*T*HH*:MM:*SS*Z).

Returns:

  • (Time)


12402
12403
12404
12405
12406
12407
12408
12409
12410
12411
12412
12413
# File 'lib/aws-sdk-ec2/types.rb', line 12402

class DescribeSpotPriceHistoryRequest < Struct.new(
  :filters,
  :availability_zone,
  :dry_run,
  :end_time,
  :instance_types,
  :max_results,
  :next_token,
  :product_descriptions,
  :start_time)
  include Aws::Structure
end