aws-sdk-costexplorer 1.14.0 → 1.15.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 409315673e3f4439b0affce0d2908c0ed5881438
4
- data.tar.gz: dcb5d3fb122362b5c6ad12467ae399046d666e13
3
+ metadata.gz: bc63cbc556025b7b1c33a9118b0c287be028f0b0
4
+ data.tar.gz: d292dee516076e59ca70dba30112650866c75349
5
5
  SHA512:
6
- metadata.gz: ba01d399dba6202fe8e9288f731b72184524ae47c993a11a58fe855b2393ee31af47277ffc4f96ccfdc79750d5699bcedf79560b5399b8c404e3a0587b364ea4
7
- data.tar.gz: 1793bbfcc14f6931accd011d973a3da6e6c8ab2363b780e0bd10cf04c23efa2edf51fab9ffff48ce695cc5fa3dcd1be8ecad404dd07acfe9b4b06cfee02f5649
6
+ metadata.gz: baf979f00d62412578c7936ffe5d66e6a2bae5ecbda9fd3910f4dc0e4d5154e3df945f4265324738501e7b318f200763fa8891956c96f053b9a8ed6bf1560dd5
7
+ data.tar.gz: 31903476b566149ff61dfadb3738b848bd669d0486bf055fddfb59908bc75d98de2b254c0b63c0878bc4864e1cb91b7034fc8aab61d634356ffda6207fe11d5b
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
42
42
  # @service
43
43
  module Aws::CostExplorer
44
44
 
45
- GEM_VERSION = '1.14.0'
45
+ GEM_VERSION = '1.15.0'
46
46
 
47
47
  end
@@ -220,10 +220,14 @@ module Aws::CostExplorer
220
220
  # `UsageQuantity`, that you want the request to return. You can also
221
221
  # filter and group your data by various dimensions, such as `SERVICE` or
222
222
  # `AZ`, in a specific time range. For a complete list of valid
223
- # dimensions, see the ` GetDimensionValues ` operation. Master accounts
223
+ # dimensions, see the [GetDimensionValues][1] operation. Master accounts
224
224
  # in an organization in AWS Organizations have access to all member
225
225
  # accounts.
226
226
  #
227
+ #
228
+ #
229
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
230
+ #
227
231
  # @option params [Types::DateInterval] :time_period
228
232
  # Sets the start and end dates for retrieving AWS costs. The start date
229
233
  # is inclusive, but the end date is exclusive. For example, if `start`
@@ -236,6 +240,9 @@ module Aws::CostExplorer
236
240
  # `Granularity` isn't set, the response object doesn't include the
237
241
  # `Granularity`, either `MONTHLY` or `DAILY`.
238
242
  #
243
+ # The `GetCostAndUsageRequest` operation supports only `DAILY` and
244
+ # `MONTHLY` granularities.
245
+ #
239
246
  # @option params [Types::Expression] :filter
240
247
  # Filters AWS costs by different dimensions. For example, you can
241
248
  # specify `SERVICE` and `LINKED_ACCOUNT` and get the costs that are
@@ -258,10 +265,11 @@ module Aws::CostExplorer
258
265
  #
259
266
  # <note markdown="1"> If you return the `UsageQuantity` metric, the service aggregates all
260
267
  # usage numbers without taking into account the units. For example, if
261
- # you aggregate `usageQuantity` across all of EC2, the results aren't
262
- # meaningful because EC2 compute hours and data transfer are measured in
263
- # different units (for example, hours vs. GB). To get more meaningful
264
- # `UsageQuantity` metrics, filter by `UsageType` or `UsageTypeGroups`.
268
+ # you aggregate `usageQuantity` across all of Amazon EC2, the results
269
+ # aren't meaningful because Amazon EC2 compute hours and data transfer
270
+ # are measured in different units (for example, hours vs. GB). To get
271
+ # more meaningful `UsageQuantity` metrics, filter by `UsageType` or
272
+ # `UsageTypeGroups`.
265
273
  #
266
274
  # </note>
267
275
  #
@@ -395,6 +403,9 @@ module Aws::CostExplorer
395
403
  # How granular you want the forecast to be. You can get 3 months of
396
404
  # `DAILY` forecasts or 12 months of `MONTHLY` forecasts.
397
405
  #
406
+ # The `GetCostForecast` operation supports only `DAILY` and `MONTHLY`
407
+ # granularities.
408
+ #
398
409
  # @option params [Types::Expression] :filter
399
410
  # The filters that you want to use to filter your forecast. Cost
400
411
  # Explorer API supports all of the Cost Explorer filters.
@@ -482,8 +493,8 @@ module Aws::CostExplorer
482
493
  # `2017-04-30` but not including `2017-05-01`.
483
494
  #
484
495
  # @option params [required, String] :dimension
485
- # The name of the dimension. Each `Dimension` is available for different
486
- # a `Context`. For more information, see `Context`.
496
+ # The name of the dimension. Each `Dimension` is available for a
497
+ # different `Context`. For more information, see `Context`.
487
498
  #
488
499
  # @option params [String] :context
489
500
  # The context for the call to `GetDimensionValues`. This can be
@@ -491,7 +502,7 @@ module Aws::CostExplorer
491
502
  # `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
492
503
  # resulting dimension values can be used in the
493
504
  # `GetReservationUtilization` operation. If the context is set to
494
- # `COST_AND_USAGE` the resulting dimension values can be used in the
505
+ # `COST_AND_USAGE`, the resulting dimension values can be used in the
495
506
  # `GetCostAndUsage` operation.
496
507
  #
497
508
  # If you set the context to `COST_AND_USAGE`, you can use the following
@@ -502,7 +513,7 @@ module Aws::CostExplorer
502
513
  # * DATABASE\_ENGINE - The Amazon Relational Database Service database.
503
514
  # Examples are Aurora or MySQL.
504
515
  #
505
- # * INSTANCE\_TYPE - The type of EC2 instance. An example is
516
+ # * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
506
517
  # `m4.xlarge`.
507
518
  #
508
519
  # * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
@@ -518,7 +529,8 @@ module Aws::CostExplorer
518
529
  # * OPERATION - The action performed. Examples include `RunInstance` and
519
530
  # `CreateBucket`.
520
531
  #
521
- # * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
532
+ # * PLATFORM - The Amazon EC2 operating system. Examples are Windows or
533
+ # Linux.
522
534
  #
523
535
  # * PURCHASE\_TYPE - The reservation type of the purchase to which this
524
536
  # usage is related. Examples include On-Demand Instances and Standard
@@ -531,7 +543,7 @@ module Aws::CostExplorer
531
543
  # operation includes a unit attribute. Examples include GB and Hrs.
532
544
  #
533
545
  # * USAGE\_TYPE\_GROUP - The grouping of common usage types. An example
534
- # is EC2: CloudWatch – Alarms. The response for this operation
546
+ # is Amazon EC2: CloudWatch – Alarms. The response for this operation
535
547
  # includes a unit attribute.
536
548
  #
537
549
  # * RECORD\_TYPE - The different types of charges such as RI fees, usage
@@ -548,14 +560,15 @@ module Aws::CostExplorer
548
560
  # * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database Service
549
561
  # deployments. Valid values are `SingleAZ` and `MultiAZ`.
550
562
  #
551
- # * INSTANCE\_TYPE - The type of EC2 instance. An example is
563
+ # * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
552
564
  # `m4.xlarge`.
553
565
  #
554
566
  # * LINKED\_ACCOUNT - The description in the attribute map that includes
555
567
  # the full name of the member account. The value field contains the
556
568
  # AWS ID of the member account.
557
569
  #
558
- # * PLATFORM - The EC2 operating system. Examples are Windows or Linux.
570
+ # * PLATFORM - The Amazon EC2 operating system. Examples are Windows or
571
+ # Linux.
559
572
  #
560
573
  # * REGION - The AWS Region.
561
574
  #
@@ -612,7 +625,7 @@ module Aws::CostExplorer
612
625
  req.send_request(options)
613
626
  end
614
627
 
615
- # Retrieves the reservation coverage for your account. This allows you
628
+ # Retrieves the reservation coverage for your account. This enables you
616
629
  # to see how much of your Amazon Elastic Compute Cloud, Amazon
617
630
  # ElastiCache, Amazon Relational Database Service, or Amazon Redshift
618
631
  # usage is covered by a reservation. An organization's master account
@@ -648,13 +661,13 @@ module Aws::CostExplorer
648
661
  # `GetDimensionValues` operation.
649
662
  #
650
663
  # @option params [required, Types::DateInterval] :time_period
651
- # The start and end dates of the period for which you want to retrieve
652
- # data about reservation coverage. You can retrieve data for a maximum
653
- # of 13 months: the last 12 months and the current month. The start date
654
- # is inclusive, but the end date is exclusive. For example, if `start`
655
- # is `2017-01-01` and `end` is `2017-05-01`, then the cost and usage
656
- # data is retrieved from `2017-01-01` up to and including `2017-04-30`
657
- # but not including `2017-05-01`.
664
+ # The start and end dates of the period that you want to retrieve data
665
+ # about reservation coverage for. You can retrieve data for a maximum of
666
+ # 13 months: the last 12 months and the current month. The start date is
667
+ # inclusive, but the end date is exclusive. For example, if `start` is
668
+ # `2017-01-01` and `end` is `2017-05-01`, then the cost and usage data
669
+ # is retrieved from `2017-01-01` up to and including `2017-04-30` but
670
+ # not including `2017-05-01`.
658
671
  #
659
672
  # @option params [Array<Types::GroupDefinition>] :group_by
660
673
  # You can group the data by the following attributes:
@@ -689,6 +702,9 @@ module Aws::CostExplorer
689
702
  # isn't set, the response object doesn't include `Granularity`, either
690
703
  # `MONTHLY` or `DAILY`.
691
704
  #
705
+ # The `GetReservationCoverage` operation supports only `DAILY` and
706
+ # `MONTHLY` granularities.
707
+ #
692
708
  # @option params [Types::Expression] :filter
693
709
  # Filters utilization data by dimensions. You can filter by the
694
710
  # following dimensions:
@@ -717,7 +733,7 @@ module Aws::CostExplorer
717
733
  #
718
734
  # * TENANCY
719
735
  #
720
- # `GetReservationCoverage` uses the same ` Expression ` object as the
736
+ # `GetReservationCoverage` uses the same [Expression][1] object as the
721
737
  # other operations, but only `AND` is supported among each dimension.
722
738
  # You can nest only one level deep. If there are multiple values for a
723
739
  # dimension, they are OR'd together.
@@ -725,6 +741,12 @@ module Aws::CostExplorer
725
741
  # If you don't provide a `SERVICE` filter, Cost Explorer defaults to
726
742
  # EC2.
727
743
  #
744
+ #
745
+ #
746
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
747
+ #
748
+ # @option params [Array<String>] :metrics
749
+ #
728
750
  # @option params [String] :next_page_token
729
751
  # The token to retrieve the next set of results. AWS provides the token
730
752
  # when the response from a previous call has more results than the
@@ -773,6 +795,7 @@ module Aws::CostExplorer
773
795
  # values: ["Value"],
774
796
  # },
775
797
  # },
798
+ # metrics: ["MetricName"],
776
799
  # next_page_token: "NextPageToken",
777
800
  # })
778
801
  #
@@ -788,14 +811,29 @@ module Aws::CostExplorer
788
811
  # resp.coverages_by_time[0].groups[0].coverage.coverage_hours.reserved_hours #=> String
789
812
  # resp.coverages_by_time[0].groups[0].coverage.coverage_hours.total_running_hours #=> String
790
813
  # resp.coverages_by_time[0].groups[0].coverage.coverage_hours.coverage_hours_percentage #=> String
814
+ # resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.on_demand_normalized_units #=> String
815
+ # resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.reserved_normalized_units #=> String
816
+ # resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.total_running_normalized_units #=> String
817
+ # resp.coverages_by_time[0].groups[0].coverage.coverage_normalized_units.coverage_normalized_units_percentage #=> String
818
+ # resp.coverages_by_time[0].groups[0].coverage.coverage_cost.on_demand_cost #=> String
791
819
  # resp.coverages_by_time[0].total.coverage_hours.on_demand_hours #=> String
792
820
  # resp.coverages_by_time[0].total.coverage_hours.reserved_hours #=> String
793
821
  # resp.coverages_by_time[0].total.coverage_hours.total_running_hours #=> String
794
822
  # resp.coverages_by_time[0].total.coverage_hours.coverage_hours_percentage #=> String
823
+ # resp.coverages_by_time[0].total.coverage_normalized_units.on_demand_normalized_units #=> String
824
+ # resp.coverages_by_time[0].total.coverage_normalized_units.reserved_normalized_units #=> String
825
+ # resp.coverages_by_time[0].total.coverage_normalized_units.total_running_normalized_units #=> String
826
+ # resp.coverages_by_time[0].total.coverage_normalized_units.coverage_normalized_units_percentage #=> String
827
+ # resp.coverages_by_time[0].total.coverage_cost.on_demand_cost #=> String
795
828
  # resp.total.coverage_hours.on_demand_hours #=> String
796
829
  # resp.total.coverage_hours.reserved_hours #=> String
797
830
  # resp.total.coverage_hours.total_running_hours #=> String
798
831
  # resp.total.coverage_hours.coverage_hours_percentage #=> String
832
+ # resp.total.coverage_normalized_units.on_demand_normalized_units #=> String
833
+ # resp.total.coverage_normalized_units.reserved_normalized_units #=> String
834
+ # resp.total.coverage_normalized_units.total_running_normalized_units #=> String
835
+ # resp.total.coverage_normalized_units.coverage_normalized_units_percentage #=> String
836
+ # resp.total.coverage_cost.on_demand_cost #=> String
799
837
  # resp.next_page_token #=> String
800
838
  #
801
839
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetReservationCoverage AWS API Documentation
@@ -818,15 +856,15 @@ module Aws::CostExplorer
818
856
  # category of usage to identify the best number of each type of RI to
819
857
  # purchase to maximize your estimated savings.
820
858
  #
821
- # For example, AWS automatically aggregates your EC2 Linux, shared
822
- # tenancy, and c4 family usage in the US West (Oregon) Region and
859
+ # For example, AWS automatically aggregates your Amazon EC2 Linux,
860
+ # shared tenancy, and c4 family usage in the US West (Oregon) Region and
823
861
  # recommends that you buy size-flexible regional reservations to apply
824
862
  # to the c4 family usage. AWS recommends the smallest size instance in
825
863
  # an instance family. This makes it easier to purchase a size-flexible
826
864
  # RI. AWS also shows the equal number of normalized units so that you
827
865
  # can purchase any instance size that you want. For this example, your
828
- # RI recommendation would be for `c4.large`, because that is the
829
- # smallest size instance in the c4 instance family.
866
+ # RI recommendation would be for `c4.large` because that is the smallest
867
+ # size instance in the c4 instance family.
830
868
  #
831
869
  # @option params [String] :account_id
832
870
  # The account ID that is associated with the recommendation.
@@ -854,7 +892,8 @@ module Aws::CostExplorer
854
892
  #
855
893
  # @option params [Types::ServiceSpecification] :service_specification
856
894
  # The hardware specifications for the service instances that you want
857
- # recommendations for, such as standard or convertible EC2 instances.
895
+ # recommendations for, such as standard or convertible Amazon EC2
896
+ # instances.
858
897
  #
859
898
  # @option params [Integer] :page_size
860
899
  # The number of recommendations that you want returned in a single
@@ -971,12 +1010,11 @@ module Aws::CostExplorer
971
1010
  # Currently, you can group only by `SUBSCRIPTION_ID`.
972
1011
  #
973
1012
  # @option params [required, Types::DateInterval] :time_period
974
- # Sets the start and end dates for retrieving Reserved Instance (RI)
975
- # utilization. The start date is inclusive, but the end date is
976
- # exclusive. For example, if `start` is `2017-01-01` and `end` is
977
- # `2017-05-01`, then the cost and usage data is retrieved from
978
- # `2017-01-01` up to and including `2017-04-30` but not including
979
- # `2017-05-01`.
1013
+ # Sets the start and end dates for retrieving RI utilization. The start
1014
+ # date is inclusive, but the end date is exclusive. For example, if
1015
+ # `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost and
1016
+ # usage data is retrieved from `2017-01-01` up to and including
1017
+ # `2017-04-30` but not including `2017-05-01`.
980
1018
  #
981
1019
  # @option params [Array<Types::GroupDefinition>] :group_by
982
1020
  # Groups only by `SUBSCRIPTION_ID`. Metadata is included.
@@ -987,6 +1025,9 @@ module Aws::CostExplorer
987
1025
  # `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity` aren't set,
988
1026
  # `GetReservationUtilization` defaults to `DAILY`.
989
1027
  #
1028
+ # The `GetReservationUtilization` operation supports only `DAILY` and
1029
+ # `MONTHLY` granularities.
1030
+ #
990
1031
  # @option params [Types::Expression] :filter
991
1032
  # Filters utilization data by dimensions. You can filter by the
992
1033
  # following dimensions:
@@ -1015,10 +1056,14 @@ module Aws::CostExplorer
1015
1056
  #
1016
1057
  # * TENANCY
1017
1058
  #
1018
- # `GetReservationUtilization` uses the same ` Expression ` object as the
1019
- # other operations, but only `AND` is supported among each dimension,
1020
- # and nesting is supported up to only one level deep. If there are
1021
- # multiple values for a dimension, they are OR'd together.
1059
+ # `GetReservationUtilization` uses the same [Expression][1] object as
1060
+ # the other operations, but only `AND` is supported among each
1061
+ # dimension, and nesting is supported up to only one level deep. If
1062
+ # there are multiple values for a dimension, they are OR'd together.
1063
+ #
1064
+ #
1065
+ #
1066
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1022
1067
  #
1023
1068
  # @option params [String] :next_page_token
1024
1069
  # The token to retrieve the next set of results. AWS provides the token
@@ -1082,9 +1127,13 @@ module Aws::CostExplorer
1082
1127
  # resp.utilizations_by_time[0].groups[0].attributes #=> Hash
1083
1128
  # resp.utilizations_by_time[0].groups[0].attributes["AttributeType"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
1084
1129
  # resp.utilizations_by_time[0].groups[0].utilization.utilization_percentage #=> String
1130
+ # resp.utilizations_by_time[0].groups[0].utilization.utilization_percentage_in_units #=> String
1085
1131
  # resp.utilizations_by_time[0].groups[0].utilization.purchased_hours #=> String
1132
+ # resp.utilizations_by_time[0].groups[0].utilization.purchased_units #=> String
1086
1133
  # resp.utilizations_by_time[0].groups[0].utilization.total_actual_hours #=> String
1134
+ # resp.utilizations_by_time[0].groups[0].utilization.total_actual_units #=> String
1087
1135
  # resp.utilizations_by_time[0].groups[0].utilization.unused_hours #=> String
1136
+ # resp.utilizations_by_time[0].groups[0].utilization.unused_units #=> String
1088
1137
  # resp.utilizations_by_time[0].groups[0].utilization.on_demand_cost_of_ri_hours_used #=> String
1089
1138
  # resp.utilizations_by_time[0].groups[0].utilization.net_ri_savings #=> String
1090
1139
  # resp.utilizations_by_time[0].groups[0].utilization.total_potential_ri_savings #=> String
@@ -1092,9 +1141,13 @@ module Aws::CostExplorer
1092
1141
  # resp.utilizations_by_time[0].groups[0].utilization.amortized_recurring_fee #=> String
1093
1142
  # resp.utilizations_by_time[0].groups[0].utilization.total_amortized_fee #=> String
1094
1143
  # resp.utilizations_by_time[0].total.utilization_percentage #=> String
1144
+ # resp.utilizations_by_time[0].total.utilization_percentage_in_units #=> String
1095
1145
  # resp.utilizations_by_time[0].total.purchased_hours #=> String
1146
+ # resp.utilizations_by_time[0].total.purchased_units #=> String
1096
1147
  # resp.utilizations_by_time[0].total.total_actual_hours #=> String
1148
+ # resp.utilizations_by_time[0].total.total_actual_units #=> String
1097
1149
  # resp.utilizations_by_time[0].total.unused_hours #=> String
1150
+ # resp.utilizations_by_time[0].total.unused_units #=> String
1098
1151
  # resp.utilizations_by_time[0].total.on_demand_cost_of_ri_hours_used #=> String
1099
1152
  # resp.utilizations_by_time[0].total.net_ri_savings #=> String
1100
1153
  # resp.utilizations_by_time[0].total.total_potential_ri_savings #=> String
@@ -1102,9 +1155,13 @@ module Aws::CostExplorer
1102
1155
  # resp.utilizations_by_time[0].total.amortized_recurring_fee #=> String
1103
1156
  # resp.utilizations_by_time[0].total.total_amortized_fee #=> String
1104
1157
  # resp.total.utilization_percentage #=> String
1158
+ # resp.total.utilization_percentage_in_units #=> String
1105
1159
  # resp.total.purchased_hours #=> String
1160
+ # resp.total.purchased_units #=> String
1106
1161
  # resp.total.total_actual_hours #=> String
1162
+ # resp.total.total_actual_units #=> String
1107
1163
  # resp.total.unused_hours #=> String
1164
+ # resp.total.unused_units #=> String
1108
1165
  # resp.total.on_demand_cost_of_ri_hours_used #=> String
1109
1166
  # resp.total.net_ri_savings #=> String
1110
1167
  # resp.total.total_potential_ri_savings #=> String
@@ -1192,7 +1249,7 @@ module Aws::CostExplorer
1192
1249
  params: params,
1193
1250
  config: config)
1194
1251
  context[:gem_name] = 'aws-sdk-costexplorer'
1195
- context[:gem_version] = '1.14.0'
1252
+ context[:gem_version] = '1.15.0'
1196
1253
  Seahorse::Client::Request.new(handlers, context)
1197
1254
  end
1198
1255
 
@@ -21,8 +21,11 @@ module Aws::CostExplorer
21
21
  Context = Shapes::StringShape.new(name: 'Context')
22
22
  Coverage = Shapes::StructureShape.new(name: 'Coverage')
23
23
  CoverageByTime = Shapes::StructureShape.new(name: 'CoverageByTime')
24
+ CoverageCost = Shapes::StructureShape.new(name: 'CoverageCost')
24
25
  CoverageHours = Shapes::StructureShape.new(name: 'CoverageHours')
25
26
  CoverageHoursPercentage = Shapes::StringShape.new(name: 'CoverageHoursPercentage')
27
+ CoverageNormalizedUnits = Shapes::StructureShape.new(name: 'CoverageNormalizedUnits')
28
+ CoverageNormalizedUnitsPercentage = Shapes::StringShape.new(name: 'CoverageNormalizedUnitsPercentage')
26
29
  CoveragesByTime = Shapes::ListShape.new(name: 'CoveragesByTime')
27
30
  DataUnavailableException = Shapes::StructureShape.new(name: 'DataUnavailableException')
28
31
  DateInterval = Shapes::StructureShape.new(name: 'DateInterval')
@@ -81,12 +84,15 @@ module Aws::CostExplorer
81
84
  NextPageToken = Shapes::StringShape.new(name: 'NextPageToken')
82
85
  NonNegativeInteger = Shapes::IntegerShape.new(name: 'NonNegativeInteger')
83
86
  OfferingClass = Shapes::StringShape.new(name: 'OfferingClass')
87
+ OnDemandCost = Shapes::StringShape.new(name: 'OnDemandCost')
84
88
  OnDemandCostOfRIHoursUsed = Shapes::StringShape.new(name: 'OnDemandCostOfRIHoursUsed')
85
89
  OnDemandHours = Shapes::StringShape.new(name: 'OnDemandHours')
90
+ OnDemandNormalizedUnits = Shapes::StringShape.new(name: 'OnDemandNormalizedUnits')
86
91
  PageSize = Shapes::IntegerShape.new(name: 'PageSize')
87
92
  PaymentOption = Shapes::StringShape.new(name: 'PaymentOption')
88
93
  PredictionIntervalLevel = Shapes::IntegerShape.new(name: 'PredictionIntervalLevel')
89
94
  PurchasedHours = Shapes::StringShape.new(name: 'PurchasedHours')
95
+ PurchasedUnits = Shapes::StringShape.new(name: 'PurchasedUnits')
90
96
  RDSInstanceDetails = Shapes::StructureShape.new(name: 'RDSInstanceDetails')
91
97
  RedshiftInstanceDetails = Shapes::StructureShape.new(name: 'RedshiftInstanceDetails')
92
98
  RequestChangedException = Shapes::StructureShape.new(name: 'RequestChangedException')
@@ -104,6 +110,7 @@ module Aws::CostExplorer
104
110
  ReservationUtilizationGroup = Shapes::StructureShape.new(name: 'ReservationUtilizationGroup')
105
111
  ReservationUtilizationGroups = Shapes::ListShape.new(name: 'ReservationUtilizationGroups')
106
112
  ReservedHours = Shapes::StringShape.new(name: 'ReservedHours')
113
+ ReservedNormalizedUnits = Shapes::StringShape.new(name: 'ReservedNormalizedUnits')
107
114
  ResultByTime = Shapes::StructureShape.new(name: 'ResultByTime')
108
115
  ResultsByTime = Shapes::ListShape.new(name: 'ResultsByTime')
109
116
  SearchString = Shapes::StringShape.new(name: 'SearchString')
@@ -113,12 +120,16 @@ module Aws::CostExplorer
113
120
  TagValues = Shapes::StructureShape.new(name: 'TagValues')
114
121
  TermInYears = Shapes::StringShape.new(name: 'TermInYears')
115
122
  TotalActualHours = Shapes::StringShape.new(name: 'TotalActualHours')
123
+ TotalActualUnits = Shapes::StringShape.new(name: 'TotalActualUnits')
116
124
  TotalAmortizedFee = Shapes::StringShape.new(name: 'TotalAmortizedFee')
117
125
  TotalPotentialRISavings = Shapes::StringShape.new(name: 'TotalPotentialRISavings')
118
126
  TotalRunningHours = Shapes::StringShape.new(name: 'TotalRunningHours')
127
+ TotalRunningNormalizedUnits = Shapes::StringShape.new(name: 'TotalRunningNormalizedUnits')
119
128
  UnusedHours = Shapes::StringShape.new(name: 'UnusedHours')
129
+ UnusedUnits = Shapes::StringShape.new(name: 'UnusedUnits')
120
130
  UtilizationByTime = Shapes::StructureShape.new(name: 'UtilizationByTime')
121
131
  UtilizationPercentage = Shapes::StringShape.new(name: 'UtilizationPercentage')
132
+ UtilizationPercentageInUnits = Shapes::StringShape.new(name: 'UtilizationPercentageInUnits')
122
133
  UtilizationsByTime = Shapes::ListShape.new(name: 'UtilizationsByTime')
123
134
  Value = Shapes::StringShape.new(name: 'Value')
124
135
  Values = Shapes::ListShape.new(name: 'Values')
@@ -128,6 +139,8 @@ module Aws::CostExplorer
128
139
  Attributes.value = Shapes::ShapeRef.new(shape: AttributeValue)
129
140
 
130
141
  Coverage.add_member(:coverage_hours, Shapes::ShapeRef.new(shape: CoverageHours, location_name: "CoverageHours"))
142
+ Coverage.add_member(:coverage_normalized_units, Shapes::ShapeRef.new(shape: CoverageNormalizedUnits, location_name: "CoverageNormalizedUnits"))
143
+ Coverage.add_member(:coverage_cost, Shapes::ShapeRef.new(shape: CoverageCost, location_name: "CoverageCost"))
131
144
  Coverage.struct_class = Types::Coverage
132
145
 
133
146
  CoverageByTime.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, location_name: "TimePeriod"))
@@ -135,12 +148,21 @@ module Aws::CostExplorer
135
148
  CoverageByTime.add_member(:total, Shapes::ShapeRef.new(shape: Coverage, location_name: "Total"))
136
149
  CoverageByTime.struct_class = Types::CoverageByTime
137
150
 
151
+ CoverageCost.add_member(:on_demand_cost, Shapes::ShapeRef.new(shape: OnDemandCost, location_name: "OnDemandCost"))
152
+ CoverageCost.struct_class = Types::CoverageCost
153
+
138
154
  CoverageHours.add_member(:on_demand_hours, Shapes::ShapeRef.new(shape: OnDemandHours, location_name: "OnDemandHours"))
139
155
  CoverageHours.add_member(:reserved_hours, Shapes::ShapeRef.new(shape: ReservedHours, location_name: "ReservedHours"))
140
156
  CoverageHours.add_member(:total_running_hours, Shapes::ShapeRef.new(shape: TotalRunningHours, location_name: "TotalRunningHours"))
141
157
  CoverageHours.add_member(:coverage_hours_percentage, Shapes::ShapeRef.new(shape: CoverageHoursPercentage, location_name: "CoverageHoursPercentage"))
142
158
  CoverageHours.struct_class = Types::CoverageHours
143
159
 
160
+ CoverageNormalizedUnits.add_member(:on_demand_normalized_units, Shapes::ShapeRef.new(shape: OnDemandNormalizedUnits, location_name: "OnDemandNormalizedUnits"))
161
+ CoverageNormalizedUnits.add_member(:reserved_normalized_units, Shapes::ShapeRef.new(shape: ReservedNormalizedUnits, location_name: "ReservedNormalizedUnits"))
162
+ CoverageNormalizedUnits.add_member(:total_running_normalized_units, Shapes::ShapeRef.new(shape: TotalRunningNormalizedUnits, location_name: "TotalRunningNormalizedUnits"))
163
+ CoverageNormalizedUnits.add_member(:coverage_normalized_units_percentage, Shapes::ShapeRef.new(shape: CoverageNormalizedUnitsPercentage, location_name: "CoverageNormalizedUnitsPercentage"))
164
+ CoverageNormalizedUnits.struct_class = Types::CoverageNormalizedUnits
165
+
144
166
  CoveragesByTime.member = Shapes::ShapeRef.new(shape: CoverageByTime)
145
167
 
146
168
  DateInterval.add_member(:start, Shapes::ShapeRef.new(shape: YearMonthDay, required: true, location_name: "Start"))
@@ -243,6 +265,7 @@ module Aws::CostExplorer
243
265
  GetReservationCoverageRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
244
266
  GetReservationCoverageRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
245
267
  GetReservationCoverageRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, location_name: "Filter"))
268
+ GetReservationCoverageRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricNames, location_name: "Metrics"))
246
269
  GetReservationCoverageRequest.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
247
270
  GetReservationCoverageRequest.struct_class = Types::GetReservationCoverageRequest
248
271
 
@@ -340,9 +363,13 @@ module Aws::CostExplorer
340
363
  RedshiftInstanceDetails.struct_class = Types::RedshiftInstanceDetails
341
364
 
342
365
  ReservationAggregates.add_member(:utilization_percentage, Shapes::ShapeRef.new(shape: UtilizationPercentage, location_name: "UtilizationPercentage"))
366
+ ReservationAggregates.add_member(:utilization_percentage_in_units, Shapes::ShapeRef.new(shape: UtilizationPercentageInUnits, location_name: "UtilizationPercentageInUnits"))
343
367
  ReservationAggregates.add_member(:purchased_hours, Shapes::ShapeRef.new(shape: PurchasedHours, location_name: "PurchasedHours"))
368
+ ReservationAggregates.add_member(:purchased_units, Shapes::ShapeRef.new(shape: PurchasedUnits, location_name: "PurchasedUnits"))
344
369
  ReservationAggregates.add_member(:total_actual_hours, Shapes::ShapeRef.new(shape: TotalActualHours, location_name: "TotalActualHours"))
370
+ ReservationAggregates.add_member(:total_actual_units, Shapes::ShapeRef.new(shape: TotalActualUnits, location_name: "TotalActualUnits"))
345
371
  ReservationAggregates.add_member(:unused_hours, Shapes::ShapeRef.new(shape: UnusedHours, location_name: "UnusedHours"))
372
+ ReservationAggregates.add_member(:unused_units, Shapes::ShapeRef.new(shape: UnusedUnits, location_name: "UnusedUnits"))
346
373
  ReservationAggregates.add_member(:on_demand_cost_of_ri_hours_used, Shapes::ShapeRef.new(shape: OnDemandCostOfRIHoursUsed, location_name: "OnDemandCostOfRIHoursUsed"))
347
374
  ReservationAggregates.add_member(:net_ri_savings, Shapes::ShapeRef.new(shape: NetRISavings, location_name: "NetRISavings"))
348
375
  ReservationAggregates.add_member(:total_potential_ri_savings, Shapes::ShapeRef.new(shape: TotalPotentialRISavings, location_name: "TotalPotentialRISavings"))
@@ -11,24 +11,35 @@ module Aws::CostExplorer
11
11
  # The amount of instance usage that a reservation covered.
12
12
  #
13
13
  # @!attribute [rw] coverage_hours
14
- # The amount of instance usage that a reservation covered, in hours.
14
+ # The amount of instance usage that the reservation covered, in hours.
15
15
  # @return [Types::CoverageHours]
16
16
  #
17
+ # @!attribute [rw] coverage_normalized_units
18
+ # The amount of instance usage that the reservation covered, in
19
+ # normalized units.
20
+ # @return [Types::CoverageNormalizedUnits]
21
+ #
22
+ # @!attribute [rw] coverage_cost
23
+ # The amount of cost that the reservation covered.
24
+ # @return [Types::CoverageCost]
25
+ #
17
26
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/Coverage AWS API Documentation
18
27
  #
19
28
  class Coverage < Struct.new(
20
- :coverage_hours)
29
+ :coverage_hours,
30
+ :coverage_normalized_units,
31
+ :coverage_cost)
21
32
  include Aws::Structure
22
33
  end
23
34
 
24
35
  # Reservation coverage for a specified period, in hours.
25
36
  #
26
37
  # @!attribute [rw] time_period
27
- # The period over which this coverage was used.
38
+ # The period that this coverage was used over.
28
39
  # @return [Types::DateInterval]
29
40
  #
30
41
  # @!attribute [rw] groups
31
- # The groups of instances that are covered by a reservation.
42
+ # The groups of instances that the reservation covered.
32
43
  # @return [Array<Types::ReservationCoverageGroup>]
33
44
  #
34
45
  # @!attribute [rw] total
@@ -44,17 +55,29 @@ module Aws::CostExplorer
44
55
  include Aws::Structure
45
56
  end
46
57
 
58
+ # How much it cost to run an instance.
59
+ #
60
+ # @!attribute [rw] on_demand_cost
61
+ # How much an On-Demand instance cost.
62
+ # @return [String]
63
+ #
64
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageCost AWS API Documentation
65
+ #
66
+ class CoverageCost < Struct.new(
67
+ :on_demand_cost)
68
+ include Aws::Structure
69
+ end
70
+
47
71
  # How long a running instance either used a reservation or was
48
72
  # On-Demand.
49
73
  #
50
74
  # @!attribute [rw] on_demand_hours
51
- # The number of instance running hours that are covered by On-Demand
52
- # Instances.
75
+ # The number of instance running hours that On-Demand Instances
76
+ # covered.
53
77
  # @return [String]
54
78
  #
55
79
  # @!attribute [rw] reserved_hours
56
- # The number of instance running hours that are covered by
57
- # reservations.
80
+ # The number of instance running hours that reservations covered.
58
81
  # @return [String]
59
82
  #
60
83
  # @!attribute [rw] total_running_hours
@@ -62,7 +85,7 @@ module Aws::CostExplorer
62
85
  # @return [String]
63
86
  #
64
87
  # @!attribute [rw] coverage_hours_percentage
65
- # The percentage of instance hours that are covered by a reservation.
88
+ # The percentage of instance hours that a reservation covered.
66
89
  # @return [String]
67
90
  #
68
91
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageHours AWS API Documentation
@@ -75,6 +98,51 @@ module Aws::CostExplorer
75
98
  include Aws::Structure
76
99
  end
77
100
 
101
+ # The amount of instance usage, in normalized units. Normalized units
102
+ # enable you to see your EC2 usage for multiple sizes of instances in a
103
+ # uniform way. For example, suppose you run an xlarge instance and a
104
+ # 2xlarge instance. If you run both instances for the same amount of
105
+ # time, the 2xlarge instance uses twice as much of your reservation as
106
+ # the xlarge instance, even though both instances show only one
107
+ # instance-hour. Using normalized units instead of instance-hours, the
108
+ # xlarge instance used 8 normalized units, and the 2xlarge instance used
109
+ # 16 normalized units.
110
+ #
111
+ # For more information, see [Modifying Reserved Instances][1] in the
112
+ # *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
113
+ #
114
+ #
115
+ #
116
+ # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-modifying.html
117
+ #
118
+ # @!attribute [rw] on_demand_normalized_units
119
+ # The number of normalized units that are covered by On-Demand
120
+ # Instances instead of a reservation.
121
+ # @return [String]
122
+ #
123
+ # @!attribute [rw] reserved_normalized_units
124
+ # The number of normalized units that a reservation covers.
125
+ # @return [String]
126
+ #
127
+ # @!attribute [rw] total_running_normalized_units
128
+ # The total number of normalized units that you used.
129
+ # @return [String]
130
+ #
131
+ # @!attribute [rw] coverage_normalized_units_percentage
132
+ # The percentage of your used instance normalized units that a
133
+ # reservation covers.
134
+ # @return [String]
135
+ #
136
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CoverageNormalizedUnits AWS API Documentation
137
+ #
138
+ class CoverageNormalizedUnits < Struct.new(
139
+ :on_demand_normalized_units,
140
+ :reserved_normalized_units,
141
+ :total_running_normalized_units,
142
+ :coverage_normalized_units_percentage)
143
+ include Aws::Structure
144
+ end
145
+
78
146
  # The time period that you want the usage and costs for.
79
147
  #
80
148
  # @note When making an API call, you may pass DateInterval
@@ -162,7 +230,8 @@ module Aws::CostExplorer
162
230
  include Aws::Structure
163
231
  end
164
232
 
165
- # Details about the EC2 instances that AWS recommends that you purchase.
233
+ # Details about the Amazon EC2 instances that AWS recommends that you
234
+ # purchase.
166
235
  #
167
236
  # @!attribute [rw] family
168
237
  # The instance family of the recommended reservation.
@@ -191,7 +260,7 @@ module Aws::CostExplorer
191
260
  # @return [String]
192
261
  #
193
262
  # @!attribute [rw] current_generation
194
- # Whether the recommendation is for a current generation instance.
263
+ # Whether the recommendation is for a current-generation instance.
195
264
  # @return [Boolean]
196
265
  #
197
266
  # @!attribute [rw] size_flex_eligible
@@ -212,7 +281,7 @@ module Aws::CostExplorer
212
281
  include Aws::Structure
213
282
  end
214
283
 
215
- # The EC2 hardware specifications that you want AWS to provide
284
+ # The Amazon EC2 hardware specifications that you want AWS to provide
216
285
  # recommendations for.
217
286
  #
218
287
  # @note When making an API call, you may pass EC2Specification
@@ -234,7 +303,8 @@ module Aws::CostExplorer
234
303
  include Aws::Structure
235
304
  end
236
305
 
237
- # Details about the ES instances that AWS recommends that you purchase.
306
+ # Details about the Amazon ES instances that AWS recommends that you
307
+ # purchase.
238
308
  #
239
309
  # @!attribute [rw] instance_class
240
310
  # The class of instance that AWS recommends.
@@ -249,7 +319,7 @@ module Aws::CostExplorer
249
319
  # @return [String]
250
320
  #
251
321
  # @!attribute [rw] current_generation
252
- # Whether the recommendation is for a current generation instance.
322
+ # Whether the recommendation is for a current-generation instance.
253
323
  # @return [Boolean]
254
324
  #
255
325
  # @!attribute [rw] size_flex_eligible
@@ -267,8 +337,8 @@ module Aws::CostExplorer
267
337
  include Aws::Structure
268
338
  end
269
339
 
270
- # Details about the ElastiCache instances that AWS recommends that you
271
- # purchase.
340
+ # Details about the Amazon ElastiCache instances that AWS recommends
341
+ # that you purchase.
272
342
  #
273
343
  # @!attribute [rw] family
274
344
  # The instance family of the recommended reservation.
@@ -536,6 +606,9 @@ module Aws::CostExplorer
536
606
  # Sets the AWS cost granularity to `MONTHLY` or `DAILY`. If
537
607
  # `Granularity` isn't set, the response object doesn't include the
538
608
  # `Granularity`, either `MONTHLY` or `DAILY`.
609
+ #
610
+ # The `GetCostAndUsageRequest` operation supports only `DAILY` and
611
+ # `MONTHLY` granularities.
539
612
  # @return [String]
540
613
  #
541
614
  # @!attribute [rw] filter
@@ -561,11 +634,11 @@ module Aws::CostExplorer
561
634
  #
562
635
  # <note markdown="1"> If you return the `UsageQuantity` metric, the service aggregates all
563
636
  # usage numbers without taking into account the units. For example, if
564
- # you aggregate `usageQuantity` across all of EC2, the results aren't
565
- # meaningful because EC2 compute hours and data transfer are measured
566
- # in different units (for example, hours vs. GB). To get more
567
- # meaningful `UsageQuantity` metrics, filter by `UsageType` or
568
- # `UsageTypeGroups`.
637
+ # you aggregate `usageQuantity` across all of Amazon EC2, the results
638
+ # aren't meaningful because Amazon EC2 compute hours and data
639
+ # transfer are measured in different units (for example, hours vs.
640
+ # GB). To get more meaningful `UsageQuantity` metrics, filter by
641
+ # `UsageType` or `UsageTypeGroups`.
569
642
  #
570
643
  # </note>
571
644
  #
@@ -695,6 +768,9 @@ module Aws::CostExplorer
695
768
  # @!attribute [rw] granularity
696
769
  # How granular you want the forecast to be. You can get 3 months of
697
770
  # `DAILY` forecasts or 12 months of `MONTHLY` forecasts.
771
+ #
772
+ # The `GetCostForecast` operation supports only `DAILY` and `MONTHLY`
773
+ # granularities.
698
774
  # @return [String]
699
775
  #
700
776
  # @!attribute [rw] filter
@@ -768,8 +844,8 @@ module Aws::CostExplorer
768
844
  # @return [Types::DateInterval]
769
845
  #
770
846
  # @!attribute [rw] dimension
771
- # The name of the dimension. Each `Dimension` is available for
772
- # different a `Context`. For more information, see `Context`.
847
+ # The name of the dimension. Each `Dimension` is available for a
848
+ # different `Context`. For more information, see `Context`.
773
849
  # @return [String]
774
850
  #
775
851
  # @!attribute [rw] context
@@ -778,7 +854,7 @@ module Aws::CostExplorer
778
854
  # `COST_AND_USAGE`. If the context is set to `RESERVATIONS`, the
779
855
  # resulting dimension values can be used in the
780
856
  # `GetReservationUtilization` operation. If the context is set to
781
- # `COST_AND_USAGE` the resulting dimension values can be used in the
857
+ # `COST_AND_USAGE`, the resulting dimension values can be used in the
782
858
  # `GetCostAndUsage` operation.
783
859
  #
784
860
  # If you set the context to `COST_AND_USAGE`, you can use the
@@ -789,7 +865,7 @@ module Aws::CostExplorer
789
865
  # * DATABASE\_ENGINE - The Amazon Relational Database Service
790
866
  # database. Examples are Aurora or MySQL.
791
867
  #
792
- # * INSTANCE\_TYPE - The type of EC2 instance. An example is
868
+ # * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
793
869
  # `m4.xlarge`.
794
870
  #
795
871
  # * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
@@ -805,8 +881,8 @@ module Aws::CostExplorer
805
881
  # * OPERATION - The action performed. Examples include `RunInstance`
806
882
  # and `CreateBucket`.
807
883
  #
808
- # * PLATFORM - The EC2 operating system. Examples are Windows or
809
- # Linux.
884
+ # * PLATFORM - The Amazon EC2 operating system. Examples are Windows
885
+ # or Linux.
810
886
  #
811
887
  # * PURCHASE\_TYPE - The reservation type of the purchase to which
812
888
  # this usage is related. Examples include On-Demand Instances and
@@ -819,7 +895,7 @@ module Aws::CostExplorer
819
895
  # operation includes a unit attribute. Examples include GB and Hrs.
820
896
  #
821
897
  # * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
822
- # example is EC2: CloudWatch – Alarms. The response for this
898
+ # example is Amazon EC2: CloudWatch – Alarms. The response for this
823
899
  # operation includes a unit attribute.
824
900
  #
825
901
  # * RECORD\_TYPE - The different types of charges such as RI fees,
@@ -836,15 +912,15 @@ module Aws::CostExplorer
836
912
  # * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
837
913
  # Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
838
914
  #
839
- # * INSTANCE\_TYPE - The type of EC2 instance. An example is
915
+ # * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
840
916
  # `m4.xlarge`.
841
917
  #
842
918
  # * LINKED\_ACCOUNT - The description in the attribute map that
843
919
  # includes the full name of the member account. The value field
844
920
  # contains the AWS ID of the member account.
845
921
  #
846
- # * PLATFORM - The EC2 operating system. Examples are Windows or
847
- # Linux.
922
+ # * PLATFORM - The Amazon EC2 operating system. Examples are Windows
923
+ # or Linux.
848
924
  #
849
925
  # * REGION - The AWS Region.
850
926
  #
@@ -877,7 +953,7 @@ module Aws::CostExplorer
877
953
 
878
954
  # @!attribute [rw] dimension_values
879
955
  # The filters that you used to filter your request. Some dimensions
880
- # are available only for a specific context:
956
+ # are available only for a specific context.
881
957
  #
882
958
  # If you set the context to `COST_AND_USAGE`, you can use the
883
959
  # following dimensions for searching:
@@ -887,7 +963,7 @@ module Aws::CostExplorer
887
963
  # * DATABASE\_ENGINE - The Amazon Relational Database Service
888
964
  # database. Examples are Aurora or MySQL.
889
965
  #
890
- # * INSTANCE\_TYPE - The type of EC2 instance. An example is
966
+ # * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
891
967
  # `m4.xlarge`.
892
968
  #
893
969
  # * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
@@ -903,8 +979,8 @@ module Aws::CostExplorer
903
979
  # * OPERATION - The action performed. Examples include `RunInstance`
904
980
  # and `CreateBucket`.
905
981
  #
906
- # * PLATFORM - The EC2 operating system. Examples are Windows or
907
- # Linux.
982
+ # * PLATFORM - The Amazon EC2 operating system. Examples are Windows
983
+ # or Linux.
908
984
  #
909
985
  # * PURCHASE\_TYPE - The reservation type of the purchase to which
910
986
  # this usage is related. Examples include On-Demand Instances and
@@ -917,7 +993,7 @@ module Aws::CostExplorer
917
993
  # operation includes a unit attribute. Examples include GB and Hrs.
918
994
  #
919
995
  # * USAGE\_TYPE\_GROUP - The grouping of common usage types. An
920
- # example is EC2: CloudWatch – Alarms. The response for this
996
+ # example is Amazon EC2: CloudWatch – Alarms. The response for this
921
997
  # operation includes a unit attribute.
922
998
  #
923
999
  # * RECORD\_TYPE - The different types of charges such as RI fees,
@@ -934,15 +1010,15 @@ module Aws::CostExplorer
934
1010
  # * DEPLOYMENT\_OPTION - The scope of Amazon Relational Database
935
1011
  # Service deployments. Valid values are `SingleAZ` and `MultiAZ`.
936
1012
  #
937
- # * INSTANCE\_TYPE - The type of EC2 instance. An example is
1013
+ # * INSTANCE\_TYPE - The type of Amazon EC2 instance. An example is
938
1014
  # `m4.xlarge`.
939
1015
  #
940
1016
  # * LINKED\_ACCOUNT - The description in the attribute map that
941
1017
  # includes the full name of the member account. The value field
942
1018
  # contains the AWS ID of the member account.
943
1019
  #
944
- # * PLATFORM - The EC2 operating system. Examples are Windows or
945
- # Linux.
1020
+ # * PLATFORM - The Amazon EC2 operating system. Examples are Windows
1021
+ # or Linux.
946
1022
  #
947
1023
  # * REGION - The AWS Region.
948
1024
  #
@@ -981,7 +1057,7 @@ module Aws::CostExplorer
981
1057
  end
982
1058
 
983
1059
  # You can use the following request parameters to query for how much of
984
- # your instance usage is covered by a reservation.
1060
+ # your instance usage a reservation covered.
985
1061
  #
986
1062
  # @note When making an API call, you may pass GetReservationCoverageRequest
987
1063
  # data as a hash:
@@ -1021,12 +1097,13 @@ module Aws::CostExplorer
1021
1097
  # values: ["Value"],
1022
1098
  # },
1023
1099
  # },
1100
+ # metrics: ["MetricName"],
1024
1101
  # next_page_token: "NextPageToken",
1025
1102
  # }
1026
1103
  #
1027
1104
  # @!attribute [rw] time_period
1028
- # The start and end dates of the period for which you want to retrieve
1029
- # data about reservation coverage. You can retrieve data for a maximum
1105
+ # The start and end dates of the period that you want to retrieve data
1106
+ # about reservation coverage for. You can retrieve data for a maximum
1030
1107
  # of 13 months: the last 12 months and the current month. The start
1031
1108
  # date is inclusive, but the end date is exclusive. For example, if
1032
1109
  # `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost and
@@ -1067,6 +1144,9 @@ module Aws::CostExplorer
1067
1144
  # If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
1068
1145
  # isn't set, the response object doesn't include `Granularity`,
1069
1146
  # either `MONTHLY` or `DAILY`.
1147
+ #
1148
+ # The `GetReservationCoverage` operation supports only `DAILY` and
1149
+ # `MONTHLY` granularities.
1070
1150
  # @return [String]
1071
1151
  #
1072
1152
  # @!attribute [rw] filter
@@ -1097,15 +1177,22 @@ module Aws::CostExplorer
1097
1177
  #
1098
1178
  # * TENANCY
1099
1179
  #
1100
- # `GetReservationCoverage` uses the same ` Expression ` object as the
1180
+ # `GetReservationCoverage` uses the same [Expression][1] object as the
1101
1181
  # other operations, but only `AND` is supported among each dimension.
1102
1182
  # You can nest only one level deep. If there are multiple values for a
1103
1183
  # dimension, they are OR'd together.
1104
1184
  #
1105
1185
  # If you don't provide a `SERVICE` filter, Cost Explorer defaults to
1106
1186
  # EC2.
1187
+ #
1188
+ #
1189
+ #
1190
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1107
1191
  # @return [Types::Expression]
1108
1192
  #
1193
+ # @!attribute [rw] metrics
1194
+ # @return [Array<String>]
1195
+ #
1109
1196
  # @!attribute [rw] next_page_token
1110
1197
  # The token to retrieve the next set of results. AWS provides the
1111
1198
  # token when the response from a previous call has more results than
@@ -1119,6 +1206,7 @@ module Aws::CostExplorer
1119
1206
  :group_by,
1120
1207
  :granularity,
1121
1208
  :filter,
1209
+ :metrics,
1122
1210
  :next_page_token)
1123
1211
  include Aws::Structure
1124
1212
  end
@@ -1128,7 +1216,7 @@ module Aws::CostExplorer
1128
1216
  # @return [Array<Types::CoverageByTime>]
1129
1217
  #
1130
1218
  # @!attribute [rw] total
1131
- # The total amount of instance usage that is covered by a reservation.
1219
+ # The total amount of instance usage that a reservation covered.
1132
1220
  # @return [Types::Coverage]
1133
1221
  #
1134
1222
  # @!attribute [rw] next_page_token
@@ -1197,7 +1285,8 @@ module Aws::CostExplorer
1197
1285
  #
1198
1286
  # @!attribute [rw] service_specification
1199
1287
  # The hardware specifications for the service instances that you want
1200
- # recommendations for, such as standard or convertible EC2 instances.
1288
+ # recommendations for, such as standard or convertible Amazon EC2
1289
+ # instances.
1201
1290
  # @return [Types::ServiceSpecification]
1202
1291
  #
1203
1292
  # @!attribute [rw] page_size
@@ -1289,12 +1378,11 @@ module Aws::CostExplorer
1289
1378
  # }
1290
1379
  #
1291
1380
  # @!attribute [rw] time_period
1292
- # Sets the start and end dates for retrieving Reserved Instance (RI)
1293
- # utilization. The start date is inclusive, but the end date is
1294
- # exclusive. For example, if `start` is `2017-01-01` and `end` is
1295
- # `2017-05-01`, then the cost and usage data is retrieved from
1296
- # `2017-01-01` up to and including `2017-04-30` but not including
1297
- # `2017-05-01`.
1381
+ # Sets the start and end dates for retrieving RI utilization. The
1382
+ # start date is inclusive, but the end date is exclusive. For example,
1383
+ # if `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost
1384
+ # and usage data is retrieved from `2017-01-01` up to and including
1385
+ # `2017-04-30` but not including `2017-05-01`.
1298
1386
  # @return [Types::DateInterval]
1299
1387
  #
1300
1388
  # @!attribute [rw] group_by
@@ -1306,6 +1394,9 @@ module Aws::CostExplorer
1306
1394
  # isn't set, the response object doesn't include `Granularity`,
1307
1395
  # either `MONTHLY` or `DAILY`. If both `GroupBy` and `Granularity`
1308
1396
  # aren't set, `GetReservationUtilization` defaults to `DAILY`.
1397
+ #
1398
+ # The `GetReservationUtilization` operation supports only `DAILY` and
1399
+ # `MONTHLY` granularities.
1309
1400
  # @return [String]
1310
1401
  #
1311
1402
  # @!attribute [rw] filter
@@ -1336,10 +1427,14 @@ module Aws::CostExplorer
1336
1427
  #
1337
1428
  # * TENANCY
1338
1429
  #
1339
- # `GetReservationUtilization` uses the same ` Expression ` object as
1430
+ # `GetReservationUtilization` uses the same [Expression][1] object as
1340
1431
  # the other operations, but only `AND` is supported among each
1341
1432
  # dimension, and nesting is supported up to only one level deep. If
1342
1433
  # there are multiple values for a dimension, they are OR'd together.
1434
+ #
1435
+ #
1436
+ #
1437
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1343
1438
  # @return [Types::Expression]
1344
1439
  #
1345
1440
  # @!attribute [rw] next_page_token
@@ -1360,11 +1455,11 @@ module Aws::CostExplorer
1360
1455
  end
1361
1456
 
1362
1457
  # @!attribute [rw] utilizations_by_time
1363
- # The amount of time that you utilized your RIs.
1458
+ # The amount of time that you used your RIs.
1364
1459
  # @return [Array<Types::UtilizationByTime>]
1365
1460
  #
1366
1461
  # @!attribute [rw] total
1367
- # The total amount of time that you utilized your RIs.
1462
+ # The total amount of time that you used your RIs.
1368
1463
  # @return [Types::ReservationAggregates]
1369
1464
  #
1370
1465
  # @!attribute [rw] next_page_token
@@ -1455,7 +1550,7 @@ module Aws::CostExplorer
1455
1550
  include Aws::Structure
1456
1551
  end
1457
1552
 
1458
- # One level of grouped data within the results.
1553
+ # One level of grouped data in the results.
1459
1554
  #
1460
1555
  # @!attribute [rw] keys
1461
1556
  # The keys that are included in this group.
@@ -1473,7 +1568,7 @@ module Aws::CostExplorer
1473
1568
  include Aws::Structure
1474
1569
  end
1475
1570
 
1476
- # Represents a group when you specify a group by criteria, or in the
1571
+ # Represents a group when you specify a group by criteria or in the
1477
1572
  # response to a query with a specific grouping.
1478
1573
  #
1479
1574
  # @note When making an API call, you may pass GroupDefinition
@@ -1503,11 +1598,11 @@ module Aws::CostExplorer
1503
1598
  # Details about the instances that AWS recommends that you purchase.
1504
1599
  #
1505
1600
  # @!attribute [rw] ec2_instance_details
1506
- # The EC2 instances that AWS recommends that you purchase.
1601
+ # The Amazon EC2 instances that AWS recommends that you purchase.
1507
1602
  # @return [Types::EC2InstanceDetails]
1508
1603
  #
1509
1604
  # @!attribute [rw] rds_instance_details
1510
- # The RDS instances that AWS recommends that you purchase.
1605
+ # The Amazon RDS instances that AWS recommends that you purchase.
1511
1606
  # @return [Types::RDSInstanceDetails]
1512
1607
  #
1513
1608
  # @!attribute [rw] redshift_instance_details
@@ -1551,7 +1646,8 @@ module Aws::CostExplorer
1551
1646
  include Aws::Structure
1552
1647
  end
1553
1648
 
1554
- # Details about the RDS instances that AWS recommends that you purchase.
1649
+ # Details about the Amazon RDS instances that AWS recommends that you
1650
+ # purchase.
1555
1651
  #
1556
1652
  # @!attribute [rw] family
1557
1653
  # The instance family of the recommended reservation.
@@ -1584,7 +1680,7 @@ module Aws::CostExplorer
1584
1680
  # @return [String]
1585
1681
  #
1586
1682
  # @!attribute [rw] current_generation
1587
- # Whether the recommendation is for a current generation instance.
1683
+ # Whether the recommendation is for a current-generation instance.
1588
1684
  # @return [Boolean]
1589
1685
  #
1590
1686
  # @!attribute [rw] size_flex_eligible
@@ -1622,7 +1718,7 @@ module Aws::CostExplorer
1622
1718
  # @return [String]
1623
1719
  #
1624
1720
  # @!attribute [rw] current_generation
1625
- # Whether the recommendation is for a current generation instance.
1721
+ # Whether the recommendation is for a current-generation instance.
1626
1722
  # @return [Boolean]
1627
1723
  #
1628
1724
  # @!attribute [rw] size_flex_eligible
@@ -1640,30 +1736,54 @@ module Aws::CostExplorer
1640
1736
  include Aws::Structure
1641
1737
  end
1642
1738
 
1643
- # The aggregated numbers for your Reserved Instance (RI) usage.
1739
+ # The aggregated numbers for your reservation usage.
1644
1740
  #
1645
1741
  # @!attribute [rw] utilization_percentage
1646
- # The percentage of RI time that you used.
1742
+ # The percentage of reservation time that you used.
1743
+ # @return [String]
1744
+ #
1745
+ # @!attribute [rw] utilization_percentage_in_units
1746
+ # The percentage of Amazon EC2 reservation time that you used,
1747
+ # converted to normalized units. Normalized units are available only
1748
+ # for Amazon EC2 usage after November 11, 2017.
1647
1749
  # @return [String]
1648
1750
  #
1649
1751
  # @!attribute [rw] purchased_hours
1650
- # How many RI hours that you purchased.
1752
+ # How many reservation hours that you purchased.
1753
+ # @return [String]
1754
+ #
1755
+ # @!attribute [rw] purchased_units
1756
+ # How many Amazon EC2 reservation hours that you purchased, converted
1757
+ # to normalized units. Normalized units are available only for Amazon
1758
+ # EC2 usage after November 11, 2017.
1651
1759
  # @return [String]
1652
1760
  #
1653
1761
  # @!attribute [rw] total_actual_hours
1654
- # The total number of RI hours that you used.
1762
+ # The total number of reservation hours that you used.
1763
+ # @return [String]
1764
+ #
1765
+ # @!attribute [rw] total_actual_units
1766
+ # The total number of Amazon EC2 reservation hours that you used,
1767
+ # converted to normalized units. Normalized units are available only
1768
+ # for Amazon EC2 usage after November 11, 2017.
1655
1769
  # @return [String]
1656
1770
  #
1657
1771
  # @!attribute [rw] unused_hours
1658
- # The number of RI hours that you didn't use.
1772
+ # The number of reservation hours that you didn't use.
1773
+ # @return [String]
1774
+ #
1775
+ # @!attribute [rw] unused_units
1776
+ # The number of Amazon EC2 reservation hours that you didn't use,
1777
+ # converted to normalized units. Normalized units are available only
1778
+ # for Amazon EC2 usage after November 11, 2017.
1659
1779
  # @return [String]
1660
1780
  #
1661
1781
  # @!attribute [rw] on_demand_cost_of_ri_hours_used
1662
- # How much your RIs would cost if charged On-Demand rates.
1782
+ # How much your reservation would cost if charged On-Demand rates.
1663
1783
  # @return [String]
1664
1784
  #
1665
1785
  # @!attribute [rw] net_ri_savings
1666
- # How much you saved due to purchasing and utilizing RIs. AWS
1786
+ # How much you saved due to purchasing and utilizing reservation. AWS
1667
1787
  # calculates this by subtracting `TotalAmortizedFee` from
1668
1788
  # `OnDemandCostOfRIHoursUsed`.
1669
1789
  # @return [String]
@@ -1673,24 +1793,31 @@ module Aws::CostExplorer
1673
1793
  # @return [String]
1674
1794
  #
1675
1795
  # @!attribute [rw] amortized_upfront_fee
1676
- # The upfront cost of your RI, amortized over the RI period.
1796
+ # The upfront cost of your reservation, amortized over the reservation
1797
+ # period.
1677
1798
  # @return [String]
1678
1799
  #
1679
1800
  # @!attribute [rw] amortized_recurring_fee
1680
- # The monthly cost of your RI, amortized over the RI period.
1801
+ # The monthly cost of your reservation, amortized over the reservation
1802
+ # period.
1681
1803
  # @return [String]
1682
1804
  #
1683
1805
  # @!attribute [rw] total_amortized_fee
1684
- # The total cost of your RI, amortized over the RI period.
1806
+ # The total cost of your reservation, amortized over the reservation
1807
+ # period.
1685
1808
  # @return [String]
1686
1809
  #
1687
1810
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ReservationAggregates AWS API Documentation
1688
1811
  #
1689
1812
  class ReservationAggregates < Struct.new(
1690
1813
  :utilization_percentage,
1814
+ :utilization_percentage_in_units,
1691
1815
  :purchased_hours,
1816
+ :purchased_units,
1692
1817
  :total_actual_hours,
1818
+ :total_actual_units,
1693
1819
  :unused_hours,
1820
+ :unused_units,
1694
1821
  :on_demand_cost_of_ri_hours_used,
1695
1822
  :net_ri_savings,
1696
1823
  :total_potential_ri_savings,
@@ -1792,9 +1919,9 @@ module Aws::CostExplorer
1792
1919
  # @return [String]
1793
1920
  #
1794
1921
  # @!attribute [rw] minimum_normalized_units_used_per_hour
1795
- # The minimum number of hours that you used in an hour during the
1796
- # historical period. AWS uses this to calculate your recommended
1797
- # reservation purchases.
1922
+ # The minimum number of normalized units that you used in an hour
1923
+ # during the historical period. AWS uses this to calculate your
1924
+ # recommended reservation purchases.
1798
1925
  # @return [String]
1799
1926
  #
1800
1927
  # @!attribute [rw] maximum_number_of_instances_used_per_hour
@@ -1935,22 +2062,22 @@ module Aws::CostExplorer
1935
2062
  include Aws::Structure
1936
2063
  end
1937
2064
 
1938
- # A group of Reserved Instances (RIs) that share a set of attributes.
2065
+ # A group of reservations that share a set of attributes.
1939
2066
  #
1940
2067
  # @!attribute [rw] key
1941
- # The key for a specific RI attribute.
2068
+ # The key for a specific reservation attribute.
1942
2069
  # @return [String]
1943
2070
  #
1944
2071
  # @!attribute [rw] value
1945
- # The value of a specific RI attribute.
2072
+ # The value of a specific reservation attribute.
1946
2073
  # @return [String]
1947
2074
  #
1948
2075
  # @!attribute [rw] attributes
1949
- # The attributes for this group of RIs.
2076
+ # The attributes for this group of reservations.
1950
2077
  # @return [Hash<String,String>]
1951
2078
  #
1952
2079
  # @!attribute [rw] utilization
1953
- # How much you used this group of RIs.
2080
+ # How much you used this group of reservations.
1954
2081
  # @return [Types::ReservationAggregates]
1955
2082
  #
1956
2083
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ReservationUtilizationGroup AWS API Documentation
@@ -1966,7 +2093,7 @@ module Aws::CostExplorer
1966
2093
  # The result that is associated with a time period.
1967
2094
  #
1968
2095
  # @!attribute [rw] time_period
1969
- # The time period covered by a result.
2096
+ # The time period that the result covers.
1970
2097
  # @return [Types::DateInterval]
1971
2098
  #
1972
2099
  # @!attribute [rw] total
@@ -1974,11 +2101,11 @@ module Aws::CostExplorer
1974
2101
  # @return [Hash<String,Types::MetricValue>]
1975
2102
  #
1976
2103
  # @!attribute [rw] groups
1977
- # The groups that are included in this time period.
2104
+ # The groups that this time period includes.
1978
2105
  # @return [Array<Types::Group>]
1979
2106
  #
1980
2107
  # @!attribute [rw] estimated
1981
- # Whether this result is estimated.
2108
+ # Whether the result is estimated.
1982
2109
  # @return [Boolean]
1983
2110
  #
1984
2111
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResultByTime AWS API Documentation
@@ -2004,7 +2131,7 @@ module Aws::CostExplorer
2004
2131
  # }
2005
2132
  #
2006
2133
  # @!attribute [rw] ec2_specification
2007
- # The EC2 hardware specifications that you want AWS to provide
2134
+ # The Amazon EC2 hardware specifications that you want AWS to provide
2008
2135
  # recommendations for.
2009
2136
  # @return [Types::EC2Specification]
2010
2137
  #
@@ -2026,11 +2153,11 @@ module Aws::CostExplorer
2026
2153
  # }
2027
2154
  #
2028
2155
  # @!attribute [rw] key
2029
- # The key for a tag.
2156
+ # The key for the tag.
2030
2157
  # @return [String]
2031
2158
  #
2032
2159
  # @!attribute [rw] values
2033
- # The specific value of a tag.
2160
+ # The specific value of the tag.
2034
2161
  # @return [Array<String>]
2035
2162
  #
2036
2163
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/TagValues AWS API Documentation
@@ -2044,15 +2171,15 @@ module Aws::CostExplorer
2044
2171
  # The amount of utilization, in hours.
2045
2172
  #
2046
2173
  # @!attribute [rw] time_period
2047
- # The period of time over which this utilization was used.
2174
+ # The period of time that this utilization was used for.
2048
2175
  # @return [Types::DateInterval]
2049
2176
  #
2050
2177
  # @!attribute [rw] groups
2051
- # The groups that are included in this utilization result.
2178
+ # The groups that this utilization result uses.
2052
2179
  # @return [Array<Types::ReservationUtilizationGroup>]
2053
2180
  #
2054
2181
  # @!attribute [rw] total
2055
- # The total number of RI hours that were used.
2182
+ # The total number of reservation hours that were used.
2056
2183
  # @return [Types::ReservationAggregates]
2057
2184
  #
2058
2185
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UtilizationByTime AWS API Documentation
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-costexplorer
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.14.0
4
+ version: 1.15.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2018-11-20 00:00:00.000000000 Z
11
+ date: 2018-12-05 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core