aws-sdk-costexplorer 1.31.0 → 1.32.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: '0429c3b21284c78bb9e4e3e24cd251a7cebcfcd2'
4
- data.tar.gz: 60b6d320e584c57f380cbe13d363bc8ab689a2ed
3
+ metadata.gz: b61ef099c0c47a2cc5c6b60fdf19da7313c1edfc
4
+ data.tar.gz: 1f0cea46c3a46bb41edab2d108761a4ac1057f2e
5
5
  SHA512:
6
- metadata.gz: ac41f94ec99ffd9b4eab6613fb20bdbf49d666a9765921d58872dff64052f8588cb37c0181a489aad8fe3db8d6a52f52be08c72d2a7a69765887c597613a7d97
7
- data.tar.gz: '0861b0b300ce2b9b248d1eac95a9d418e1ab658ce7d44d45bd6b522b340273fdc9b4ddd3e72b56c3c32053584fbb89b89024ef051df40b231adaba774ca5ba5e'
6
+ metadata.gz: b7d91295c5273afeac464e010e9cb11cda78178d0e9f538eeca092f38eafa6e118804db1b532095013bfce0993126bd25d003deb0c5b99457643fefcc8ca0767
7
+ data.tar.gz: 7a35329234dfa391b9ba4ab4aacefbfbbb54892e42f0785201a6ad4db7be3d943a1ebac2f1c183232effa367a4491c0f92ad523b0c77ea6d4b46ca6fb36686f9
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
42
42
  # @service
43
43
  module Aws::CostExplorer
44
44
 
45
- GEM_VERSION = '1.31.0'
45
+ GEM_VERSION = '1.32.0'
46
46
 
47
47
  end
@@ -285,9 +285,9 @@ module Aws::CostExplorer
285
285
  # but not including `2017-05-01`.
286
286
  #
287
287
  # @option params [String] :granularity
288
- # Sets the AWS cost granularity to `MONTHLY` or `DAILY`. If
288
+ # Sets the AWS cost granularity to `MONTHLY` or `DAILY`, or `HOURLY`. If
289
289
  # `Granularity` isn't set, the response object doesn't include the
290
- # `Granularity`, either `MONTHLY` or `DAILY`.
290
+ # `Granularity`, either `MONTHLY` or `DAILY`, or `HOURLY`.
291
291
  #
292
292
  # The `GetCostAndUsageRequest` operation supports only `DAILY` and
293
293
  # `MONTHLY` granularities.
@@ -373,7 +373,7 @@ module Aws::CostExplorer
373
373
  # # recursive Expression
374
374
  # },
375
375
  # dimensions: {
376
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
376
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
377
377
  # values: ["Value"],
378
378
  # },
379
379
  # tags: {
@@ -420,6 +420,166 @@ module Aws::CostExplorer
420
420
  req.send_request(options)
421
421
  end
422
422
 
423
+ # Retrieves cost and usage metrics with resources for your account. You
424
+ # can specify which cost and usage-related metric, such as
425
+ # `BlendedCosts` or `UsageQuantity`, that you want the request to
426
+ # return. You can also filter and group your data by various dimensions,
427
+ # such as `SERVICE` or `AZ`, in a specific time range. For a complete
428
+ # list of valid dimensions, see the [GetDimensionValues][1] operation.
429
+ # Master accounts in an organization in AWS Organizations have access to
430
+ # all member accounts. This API is currently available for the Amazon
431
+ # Elastic Compute Cloud – Compute service only.
432
+ #
433
+ # <note markdown="1"> This is an opt-in only feature. You can enable this feature from the
434
+ # Cost Explorer Settings page. For information on how to access the
435
+ # Settings page, see [Controlling Access for Cost Explorer][2] in the
436
+ # *AWS Billing and Cost Management User Guide*.
437
+ #
438
+ # </note>
439
+ #
440
+ #
441
+ #
442
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
443
+ # [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-access.html
444
+ #
445
+ # @option params [required, Types::DateInterval] :time_period
446
+ # Sets the start and end dates for retrieving Amazon Web Services costs.
447
+ # The range must be within the last 14 days (the start date cannot be
448
+ # earlier than 14 days ago). The start date is inclusive, but the end
449
+ # date is exclusive. For example, if `start` is `2017-01-01` and `end`
450
+ # is `2017-05-01`, then the cost and usage data is retrieved from
451
+ # `2017-01-01` up to and including `2017-04-30` but not including
452
+ # `2017-05-01`.
453
+ #
454
+ # @option params [String] :granularity
455
+ # Sets the AWS cost granularity to `MONTHLY`, `DAILY`, or `HOURLY`. If
456
+ # `Granularity` isn't set, the response object doesn't include the
457
+ # `Granularity`, `MONTHLY`, `DAILY`, or `HOURLY`.
458
+ #
459
+ # @option params [Types::Expression] :filter
460
+ # Filters Amazon Web Services costs by different dimensions. For
461
+ # example, you can specify `SERVICE` and `LINKED_ACCOUNT` and get the
462
+ # costs that are associated with that account's usage of that service.
463
+ # You can nest `Expression` objects to define any combination of
464
+ # dimension filters. For more information, see [Expression][1].
465
+ #
466
+ # The `GetCostAndUsageWithResources` operation requires that you either
467
+ # group by or filter by a `ResourceId`.
468
+ #
469
+ #
470
+ #
471
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
472
+ #
473
+ # @option params [Array<String>] :metrics
474
+ # Which metrics are returned in the query. For more information about
475
+ # blended and unblended rates, see [Why does the "blended" annotation
476
+ # appear on some line items in my bill?][1].
477
+ #
478
+ # Valid values are `AmortizedCost`, `BlendedCost`, `NetAmortizedCost`,
479
+ # `NetUnblendedCost`, `NormalizedUsageAmount`, `UnblendedCost`, and
480
+ # `UsageQuantity`.
481
+ #
482
+ # <note markdown="1"> If you return the `UsageQuantity` metric, the service aggregates all
483
+ # usage numbers without taking the units into account. For example, if
484
+ # you aggregate `usageQuantity` across all of Amazon EC2, the results
485
+ # aren't meaningful because Amazon EC2 compute hours and data transfer
486
+ # are measured in different units (for example, hours vs. GB). To get
487
+ # more meaningful `UsageQuantity` metrics, filter by `UsageType` or
488
+ # `UsageTypeGroups`.
489
+ #
490
+ # </note>
491
+ #
492
+ # `Metrics` is required for `GetCostAndUsageWithResources` requests.
493
+ #
494
+ #
495
+ #
496
+ # [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
497
+ #
498
+ # @option params [Array<Types::GroupDefinition>] :group_by
499
+ # You can group Amazon Web Services costs using up to two different
500
+ # groups: either dimensions, tag keys, or both.
501
+ #
502
+ # @option params [String] :next_page_token
503
+ # The token to retrieve the next set of results. AWS provides the token
504
+ # when the response from a previous call has more results than the
505
+ # maximum page size.
506
+ #
507
+ # @return [Types::GetCostAndUsageWithResourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
508
+ #
509
+ # * {Types::GetCostAndUsageWithResourcesResponse#next_page_token #next_page_token} => String
510
+ # * {Types::GetCostAndUsageWithResourcesResponse#group_definitions #group_definitions} => Array&lt;Types::GroupDefinition&gt;
511
+ # * {Types::GetCostAndUsageWithResourcesResponse#results_by_time #results_by_time} => Array&lt;Types::ResultByTime&gt;
512
+ #
513
+ # @example Request syntax with placeholder values
514
+ #
515
+ # resp = client.get_cost_and_usage_with_resources({
516
+ # time_period: { # required
517
+ # start: "YearMonthDay", # required
518
+ # end: "YearMonthDay", # required
519
+ # },
520
+ # granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
521
+ # filter: {
522
+ # or: [
523
+ # {
524
+ # # recursive Expression
525
+ # },
526
+ # ],
527
+ # and: [
528
+ # {
529
+ # # recursive Expression
530
+ # },
531
+ # ],
532
+ # not: {
533
+ # # recursive Expression
534
+ # },
535
+ # dimensions: {
536
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
537
+ # values: ["Value"],
538
+ # },
539
+ # tags: {
540
+ # key: "TagKey",
541
+ # values: ["Value"],
542
+ # },
543
+ # },
544
+ # metrics: ["MetricName"],
545
+ # group_by: [
546
+ # {
547
+ # type: "DIMENSION", # accepts DIMENSION, TAG
548
+ # key: "GroupDefinitionKey",
549
+ # },
550
+ # ],
551
+ # next_page_token: "NextPageToken",
552
+ # })
553
+ #
554
+ # @example Response structure
555
+ #
556
+ # resp.next_page_token #=> String
557
+ # resp.group_definitions #=> Array
558
+ # resp.group_definitions[0].type #=> String, one of "DIMENSION", "TAG"
559
+ # resp.group_definitions[0].key #=> String
560
+ # resp.results_by_time #=> Array
561
+ # resp.results_by_time[0].time_period.start #=> String
562
+ # resp.results_by_time[0].time_period.end #=> String
563
+ # resp.results_by_time[0].total #=> Hash
564
+ # resp.results_by_time[0].total["MetricName"].amount #=> String
565
+ # resp.results_by_time[0].total["MetricName"].unit #=> String
566
+ # resp.results_by_time[0].groups #=> Array
567
+ # resp.results_by_time[0].groups[0].keys #=> Array
568
+ # resp.results_by_time[0].groups[0].keys[0] #=> String
569
+ # resp.results_by_time[0].groups[0].metrics #=> Hash
570
+ # resp.results_by_time[0].groups[0].metrics["MetricName"].amount #=> String
571
+ # resp.results_by_time[0].groups[0].metrics["MetricName"].unit #=> String
572
+ # resp.results_by_time[0].estimated #=> Boolean
573
+ #
574
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostAndUsageWithResources AWS API Documentation
575
+ #
576
+ # @overload get_cost_and_usage_with_resources(params = {})
577
+ # @param [Hash] params ({})
578
+ def get_cost_and_usage_with_resources(params = {}, options = {})
579
+ req = build_request(:get_cost_and_usage_with_resources, params)
580
+ req.send_request(options)
581
+ end
582
+
423
583
  # Retrieves a forecast for how much Amazon Web Services predicts that
424
584
  # you will spend over the forecast time period that you select, based on
425
585
  # your past costs.
@@ -496,7 +656,7 @@ module Aws::CostExplorer
496
656
  # # recursive Expression
497
657
  # },
498
658
  # dimensions: {
499
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
659
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
500
660
  # values: ["Value"],
501
661
  # },
502
662
  # tags: {
@@ -598,6 +758,10 @@ module Aws::CostExplorer
598
758
  # * RECORD\_TYPE - The different types of charges such as RI fees, usage
599
759
  # costs, tax refunds, and credits.
600
760
  #
761
+ # * RESOURCE\_ID - The unique identifier of the resource. ResourceId is
762
+ # an opt-in feature only available for last 14 days for EC2-Compute
763
+ # Service.
764
+ #
601
765
  # If you set the context to `RESERVATIONS`, you can use the following
602
766
  # dimensions for searching:
603
767
  #
@@ -669,7 +833,7 @@ module Aws::CostExplorer
669
833
  # start: "YearMonthDay", # required
670
834
  # end: "YearMonthDay", # required
671
835
  # },
672
- # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
836
+ # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
673
837
  # context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS, SAVINGS_PLANS
674
838
  # next_page_token: "NextPageToken",
675
839
  # })
@@ -857,7 +1021,7 @@ module Aws::CostExplorer
857
1021
  # # recursive Expression
858
1022
  # },
859
1023
  # dimensions: {
860
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1024
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
861
1025
  # values: ["Value"],
862
1026
  # },
863
1027
  # tags: {
@@ -1175,7 +1339,7 @@ module Aws::CostExplorer
1175
1339
  # # recursive Expression
1176
1340
  # },
1177
1341
  # dimensions: {
1178
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1342
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1179
1343
  # values: ["Value"],
1180
1344
  # },
1181
1345
  # tags: {
@@ -1344,7 +1508,7 @@ module Aws::CostExplorer
1344
1508
  # # recursive Expression
1345
1509
  # },
1346
1510
  # dimensions: {
1347
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1511
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1348
1512
  # values: ["Value"],
1349
1513
  # },
1350
1514
  # tags: {
@@ -1453,6 +1617,9 @@ module Aws::CostExplorer
1453
1617
  # The granularity of the Amazon Web Services cost data for your Savings
1454
1618
  # Plans. `Granularity` can't be set if `GroupBy` is set.
1455
1619
  #
1620
+ # The `GetSavingsPlansCoverage` operation supports only `DAILY` and
1621
+ # `MONTHLY` granularities.
1622
+ #
1456
1623
  # @option params [Types::Expression] :filter
1457
1624
  # Filters Savings Plans coverage data by dimensions. You can filter data
1458
1625
  # for Savings Plans usage with the following dimensions:
@@ -1475,7 +1642,7 @@ module Aws::CostExplorer
1475
1642
  #
1476
1643
  # @option params [Array<String>] :metrics
1477
1644
  # The measurement that you want your Savings Plans coverage reported in.
1478
- # The only valid value is `spendCoveredBySavingsPlans`.
1645
+ # The only valid value is `SpendCoveredBySavingsPlans`.
1479
1646
  #
1480
1647
  # @option params [String] :next_token
1481
1648
  # The token to retrieve the next set of results. Amazon Web Services
@@ -1520,7 +1687,7 @@ module Aws::CostExplorer
1520
1687
  # # recursive Expression
1521
1688
  # },
1522
1689
  # dimensions: {
1523
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1690
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1524
1691
  # values: ["Value"],
1525
1692
  # },
1526
1693
  # tags: {
@@ -1647,7 +1814,8 @@ module Aws::CostExplorer
1647
1814
  # Retrieves the Savings Plans utilization for your account across date
1648
1815
  # ranges with daily or monthly granularity. Master accounts in an
1649
1816
  # organization have access to member accounts. You can use
1650
- # `GetDimensionValues` to determine the possible dimension values.
1817
+ # `GetDimensionValues` in `SAVINGS_PLANS` to determine the possible
1818
+ # dimension values.
1651
1819
  #
1652
1820
  # <note markdown="1"> You cannot group by any dimension values for
1653
1821
  # `GetSavingsPlansUtilization`.
@@ -1664,6 +1832,9 @@ module Aws::CostExplorer
1664
1832
  # The granularity of the Amazon Web Services utillization data for your
1665
1833
  # Savings Plans.
1666
1834
  #
1835
+ # The `GetSavingsPlansUtilization` operation supports only `DAILY` and
1836
+ # `MONTHLY` granularities.
1837
+ #
1667
1838
  # @option params [Types::Expression] :filter
1668
1839
  # Filters Savings Plans utilization coverage data for active Savings
1669
1840
  # Plans dimensions. You can filter data with the following dimensions:
@@ -1676,14 +1847,13 @@ module Aws::CostExplorer
1676
1847
  #
1677
1848
  # * `REGION`
1678
1849
  #
1679
- # * `PAYMENT_OPTIONS`
1850
+ # * `PAYMENT_OPTION`
1680
1851
  #
1681
1852
  # * `INSTANCE_TYPE_FAMILY`
1682
1853
  #
1683
1854
  # `GetSavingsPlansUtilization` uses the same [Expression][1] object as
1684
1855
  # the other operations, but only `AND` is supported among each
1685
- # dimension. If there are multiple values for a dimension, they are
1686
- # OR'd together.
1856
+ # dimension.
1687
1857
  #
1688
1858
  #
1689
1859
  #
@@ -1717,7 +1887,7 @@ module Aws::CostExplorer
1717
1887
  # # recursive Expression
1718
1888
  # },
1719
1889
  # dimensions: {
1720
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1890
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1721
1891
  # values: ["Value"],
1722
1892
  # },
1723
1893
  # tags: {
@@ -1760,13 +1930,17 @@ module Aws::CostExplorer
1760
1930
  req.send_request(options)
1761
1931
  end
1762
1932
 
1763
- # Retrieves a single daily or monthly Savings Plans utilization rate and
1764
- # details for your account. Master accounts in an organization have
1765
- # access to member accounts. You can use `GetDimensionValues` to
1766
- # determine the possible dimension values.
1767
- #
1768
- # <note markdown="1"> You can't group by any dimension values for
1769
- # `GetSavingsPlansUtilizationDetails`.
1933
+ # Retrieves attribute data along with aggregate utilization and savings
1934
+ # data for a given time period. This doesn't support granular or
1935
+ # grouped data (daily/monthly) in response. You can't retrieve data by
1936
+ # dates in a single response similar to `GetSavingsPlanUtilization`, but
1937
+ # you have the option to make multiple calls to
1938
+ # `GetSavingsPlanUtilizationDetails` by providing individual dates. You
1939
+ # can use `GetDimensionValues` in `SAVINGS_PLANS` to determine the
1940
+ # possible dimension values.
1941
+ #
1942
+ # <note markdown="1"> `GetSavingsPlanUtilizationDetails` internally groups data by
1943
+ # `SavingsPlansArn`.
1770
1944
  #
1771
1945
  # </note>
1772
1946
  #
@@ -1786,14 +1960,13 @@ module Aws::CostExplorer
1786
1960
  #
1787
1961
  # * `REGION`
1788
1962
  #
1789
- # * `PAYMENT_OPTIONS`
1963
+ # * `PAYMENT_OPTION`
1790
1964
  #
1791
1965
  # * `INSTANCE_TYPE_FAMILY`
1792
1966
  #
1793
1967
  # `GetSavingsPlansUtilizationDetails` uses the same [Expression][1]
1794
1968
  # object as the other operations, but only `AND` is supported among each
1795
- # dimension. If there are multiple values for a dimension, they are
1796
- # OR'd together.
1969
+ # dimension.
1797
1970
  #
1798
1971
  #
1799
1972
  #
@@ -1837,7 +2010,7 @@ module Aws::CostExplorer
1837
2010
  # # recursive Expression
1838
2011
  # },
1839
2012
  # dimensions: {
1840
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2013
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1841
2014
  # values: ["Value"],
1842
2015
  # },
1843
2016
  # tags: {
@@ -2012,7 +2185,7 @@ module Aws::CostExplorer
2012
2185
  # # recursive Expression
2013
2186
  # },
2014
2187
  # dimensions: {
2015
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2188
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2016
2189
  # values: ["Value"],
2017
2190
  # },
2018
2191
  # tags: {
@@ -2056,7 +2229,7 @@ module Aws::CostExplorer
2056
2229
  params: params,
2057
2230
  config: config)
2058
2231
  context[:gem_name] = 'aws-sdk-costexplorer'
2059
- context[:gem_version] = '1.31.0'
2232
+ context[:gem_version] = '1.32.0'
2060
2233
  Seahorse::Client::Request.new(handlers, context)
2061
2234
  end
2062
2235
 
@@ -51,6 +51,8 @@ module Aws::CostExplorer
51
51
  GenericString = Shapes::StringShape.new(name: 'GenericString')
52
52
  GetCostAndUsageRequest = Shapes::StructureShape.new(name: 'GetCostAndUsageRequest')
53
53
  GetCostAndUsageResponse = Shapes::StructureShape.new(name: 'GetCostAndUsageResponse')
54
+ GetCostAndUsageWithResourcesRequest = Shapes::StructureShape.new(name: 'GetCostAndUsageWithResourcesRequest')
55
+ GetCostAndUsageWithResourcesResponse = Shapes::StructureShape.new(name: 'GetCostAndUsageWithResourcesResponse')
54
56
  GetCostForecastRequest = Shapes::StructureShape.new(name: 'GetCostForecastRequest')
55
57
  GetCostForecastResponse = Shapes::StructureShape.new(name: 'GetCostForecastResponse')
56
58
  GetDimensionValuesRequest = Shapes::StructureShape.new(name: 'GetDimensionValuesRequest')
@@ -319,6 +321,19 @@ module Aws::CostExplorer
319
321
  GetCostAndUsageResponse.add_member(:results_by_time, Shapes::ShapeRef.new(shape: ResultsByTime, location_name: "ResultsByTime"))
320
322
  GetCostAndUsageResponse.struct_class = Types::GetCostAndUsageResponse
321
323
 
324
+ GetCostAndUsageWithResourcesRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
325
+ GetCostAndUsageWithResourcesRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
326
+ GetCostAndUsageWithResourcesRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, location_name: "Filter"))
327
+ GetCostAndUsageWithResourcesRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricNames, location_name: "Metrics"))
328
+ GetCostAndUsageWithResourcesRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
329
+ GetCostAndUsageWithResourcesRequest.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
330
+ GetCostAndUsageWithResourcesRequest.struct_class = Types::GetCostAndUsageWithResourcesRequest
331
+
332
+ GetCostAndUsageWithResourcesResponse.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
333
+ GetCostAndUsageWithResourcesResponse.add_member(:group_definitions, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupDefinitions"))
334
+ GetCostAndUsageWithResourcesResponse.add_member(:results_by_time, Shapes::ShapeRef.new(shape: ResultsByTime, location_name: "ResultsByTime"))
335
+ GetCostAndUsageWithResourcesResponse.struct_class = Types::GetCostAndUsageWithResourcesResponse
336
+
322
337
  GetCostForecastRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
323
338
  GetCostForecastRequest.add_member(:metric, Shapes::ShapeRef.new(shape: Metric, required: true, location_name: "Metric"))
324
339
  GetCostForecastRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, required: true, location_name: "Granularity"))
@@ -801,6 +816,19 @@ module Aws::CostExplorer
801
816
  o.errors << Shapes::ShapeRef.new(shape: RequestChangedException)
802
817
  end)
803
818
 
819
+ api.add_operation(:get_cost_and_usage_with_resources, Seahorse::Model::Operation.new.tap do |o|
820
+ o.name = "GetCostAndUsageWithResources"
821
+ o.http_method = "POST"
822
+ o.http_request_uri = "/"
823
+ o.input = Shapes::ShapeRef.new(shape: GetCostAndUsageWithResourcesRequest)
824
+ o.output = Shapes::ShapeRef.new(shape: GetCostAndUsageWithResourcesResponse)
825
+ o.errors << Shapes::ShapeRef.new(shape: DataUnavailableException)
826
+ o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
827
+ o.errors << Shapes::ShapeRef.new(shape: BillExpirationException)
828
+ o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
829
+ o.errors << Shapes::ShapeRef.new(shape: RequestChangedException)
830
+ end)
831
+
804
832
  api.add_operation(:get_cost_forecast, Seahorse::Model::Operation.new.tap do |o|
805
833
  o.name = "GetCostForecast"
806
834
  o.http_method = "POST"
@@ -269,7 +269,7 @@ module Aws::CostExplorer
269
269
  # data as a hash:
270
270
  #
271
271
  # {
272
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
272
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
273
273
  # values: ["Value"],
274
274
  # }
275
275
  #
@@ -604,7 +604,7 @@ module Aws::CostExplorer
604
604
  # # recursive Expression
605
605
  # },
606
606
  # dimensions: {
607
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
607
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
608
608
  # values: ["Value"],
609
609
  # },
610
610
  # tags: {
@@ -625,7 +625,7 @@ module Aws::CostExplorer
625
625
  # # recursive Expression
626
626
  # },
627
627
  # dimensions: {
628
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
628
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
629
629
  # values: ["Value"],
630
630
  # },
631
631
  # tags: {
@@ -649,7 +649,7 @@ module Aws::CostExplorer
649
649
  # # recursive Expression
650
650
  # },
651
651
  # dimensions: {
652
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
652
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
653
653
  # values: ["Value"],
654
654
  # },
655
655
  # tags: {
@@ -658,7 +658,7 @@ module Aws::CostExplorer
658
658
  # },
659
659
  # },
660
660
  # dimensions: {
661
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
661
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
662
662
  # values: ["Value"],
663
663
  # },
664
664
  # tags: {
@@ -750,7 +750,7 @@ module Aws::CostExplorer
750
750
  # # recursive Expression
751
751
  # },
752
752
  # dimensions: {
753
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
753
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
754
754
  # values: ["Value"],
755
755
  # },
756
756
  # tags: {
@@ -777,9 +777,9 @@ module Aws::CostExplorer
777
777
  # @return [Types::DateInterval]
778
778
  #
779
779
  # @!attribute [rw] granularity
780
- # Sets the AWS cost granularity to `MONTHLY` or `DAILY`. If
781
- # `Granularity` isn't set, the response object doesn't include the
782
- # `Granularity`, either `MONTHLY` or `DAILY`.
780
+ # Sets the AWS cost granularity to `MONTHLY` or `DAILY`, or `HOURLY`.
781
+ # If `Granularity` isn't set, the response object doesn't include
782
+ # the `Granularity`, either `MONTHLY` or `DAILY`, or `HOURLY`.
783
783
  #
784
784
  # The `GetCostAndUsageRequest` operation supports only `DAILY` and
785
785
  # `MONTHLY` granularities.
@@ -877,6 +877,152 @@ module Aws::CostExplorer
877
877
  include Aws::Structure
878
878
  end
879
879
 
880
+ # @note When making an API call, you may pass GetCostAndUsageWithResourcesRequest
881
+ # data as a hash:
882
+ #
883
+ # {
884
+ # time_period: { # required
885
+ # start: "YearMonthDay", # required
886
+ # end: "YearMonthDay", # required
887
+ # },
888
+ # granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
889
+ # filter: {
890
+ # or: [
891
+ # {
892
+ # # recursive Expression
893
+ # },
894
+ # ],
895
+ # and: [
896
+ # {
897
+ # # recursive Expression
898
+ # },
899
+ # ],
900
+ # not: {
901
+ # # recursive Expression
902
+ # },
903
+ # dimensions: {
904
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
905
+ # values: ["Value"],
906
+ # },
907
+ # tags: {
908
+ # key: "TagKey",
909
+ # values: ["Value"],
910
+ # },
911
+ # },
912
+ # metrics: ["MetricName"],
913
+ # group_by: [
914
+ # {
915
+ # type: "DIMENSION", # accepts DIMENSION, TAG
916
+ # key: "GroupDefinitionKey",
917
+ # },
918
+ # ],
919
+ # next_page_token: "NextPageToken",
920
+ # }
921
+ #
922
+ # @!attribute [rw] time_period
923
+ # Sets the start and end dates for retrieving Amazon Web Services
924
+ # costs. The range must be within the last 14 days (the start date
925
+ # cannot be earlier than 14 days ago). The start date is inclusive,
926
+ # but the end date is exclusive. For example, if `start` is
927
+ # `2017-01-01` and `end` is `2017-05-01`, then the cost and usage data
928
+ # is retrieved from `2017-01-01` up to and including `2017-04-30` but
929
+ # not including `2017-05-01`.
930
+ # @return [Types::DateInterval]
931
+ #
932
+ # @!attribute [rw] granularity
933
+ # Sets the AWS cost granularity to `MONTHLY`, `DAILY`, or `HOURLY`. If
934
+ # `Granularity` isn't set, the response object doesn't include the
935
+ # `Granularity`, `MONTHLY`, `DAILY`, or `HOURLY`.
936
+ # @return [String]
937
+ #
938
+ # @!attribute [rw] filter
939
+ # Filters Amazon Web Services costs by different dimensions. For
940
+ # example, you can specify `SERVICE` and `LINKED_ACCOUNT` and get the
941
+ # costs that are associated with that account's usage of that
942
+ # service. You can nest `Expression` objects to define any combination
943
+ # of dimension filters. For more information, see [Expression][1].
944
+ #
945
+ # The `GetCostAndUsageWithResources` operation requires that you
946
+ # either group by or filter by a `ResourceId`.
947
+ #
948
+ #
949
+ #
950
+ # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
951
+ # @return [Types::Expression]
952
+ #
953
+ # @!attribute [rw] metrics
954
+ # Which metrics are returned in the query. For more information about
955
+ # blended and unblended rates, see [Why does the "blended"
956
+ # annotation appear on some line items in my bill?][1].
957
+ #
958
+ # Valid values are `AmortizedCost`, `BlendedCost`, `NetAmortizedCost`,
959
+ # `NetUnblendedCost`, `NormalizedUsageAmount`, `UnblendedCost`, and
960
+ # `UsageQuantity`.
961
+ #
962
+ # <note markdown="1"> If you return the `UsageQuantity` metric, the service aggregates all
963
+ # usage numbers without taking the units into account. For example, if
964
+ # you aggregate `usageQuantity` across all of Amazon EC2, the results
965
+ # aren't meaningful because Amazon EC2 compute hours and data
966
+ # transfer are measured in different units (for example, hours vs.
967
+ # GB). To get more meaningful `UsageQuantity` metrics, filter by
968
+ # `UsageType` or `UsageTypeGroups`.
969
+ #
970
+ # </note>
971
+ #
972
+ # `Metrics` is required for `GetCostAndUsageWithResources` requests.
973
+ #
974
+ #
975
+ #
976
+ # [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
977
+ # @return [Array<String>]
978
+ #
979
+ # @!attribute [rw] group_by
980
+ # You can group Amazon Web Services costs using up to two different
981
+ # groups: either dimensions, tag keys, or both.
982
+ # @return [Array<Types::GroupDefinition>]
983
+ #
984
+ # @!attribute [rw] next_page_token
985
+ # The token to retrieve the next set of results. AWS provides the
986
+ # token when the response from a previous call has more results than
987
+ # the maximum page size.
988
+ # @return [String]
989
+ #
990
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostAndUsageWithResourcesRequest AWS API Documentation
991
+ #
992
+ class GetCostAndUsageWithResourcesRequest < Struct.new(
993
+ :time_period,
994
+ :granularity,
995
+ :filter,
996
+ :metrics,
997
+ :group_by,
998
+ :next_page_token)
999
+ include Aws::Structure
1000
+ end
1001
+
1002
+ # @!attribute [rw] next_page_token
1003
+ # The token for the next set of retrievable results. AWS provides the
1004
+ # token when the response from a previous call has more results than
1005
+ # the maximum page size.
1006
+ # @return [String]
1007
+ #
1008
+ # @!attribute [rw] group_definitions
1009
+ # The groups that are specified by the `Filter` or `GroupBy`
1010
+ # parameters in the request.
1011
+ # @return [Array<Types::GroupDefinition>]
1012
+ #
1013
+ # @!attribute [rw] results_by_time
1014
+ # The time period that is covered by the results in the response.
1015
+ # @return [Array<Types::ResultByTime>]
1016
+ #
1017
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostAndUsageWithResourcesResponse AWS API Documentation
1018
+ #
1019
+ class GetCostAndUsageWithResourcesResponse < Struct.new(
1020
+ :next_page_token,
1021
+ :group_definitions,
1022
+ :results_by_time)
1023
+ include Aws::Structure
1024
+ end
1025
+
880
1026
  # @note When making an API call, you may pass GetCostForecastRequest
881
1027
  # data as a hash:
882
1028
  #
@@ -902,7 +1048,7 @@ module Aws::CostExplorer
902
1048
  # # recursive Expression
903
1049
  # },
904
1050
  # dimensions: {
905
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1051
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
906
1052
  # values: ["Value"],
907
1053
  # },
908
1054
  # tags: {
@@ -1000,7 +1146,7 @@ module Aws::CostExplorer
1000
1146
  # start: "YearMonthDay", # required
1001
1147
  # end: "YearMonthDay", # required
1002
1148
  # },
1003
- # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1149
+ # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1004
1150
  # context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS, SAVINGS_PLANS
1005
1151
  # next_page_token: "NextPageToken",
1006
1152
  # }
@@ -1075,6 +1221,10 @@ module Aws::CostExplorer
1075
1221
  # * RECORD\_TYPE - The different types of charges such as RI fees,
1076
1222
  # usage costs, tax refunds, and credits.
1077
1223
  #
1224
+ # * RESOURCE\_ID - The unique identifier of the resource. ResourceId
1225
+ # is an opt-in feature only available for last 14 days for
1226
+ # EC2-Compute Service.
1227
+ #
1078
1228
  # If you set the context to `RESERVATIONS`, you can use the following
1079
1229
  # dimensions for searching:
1080
1230
  #
@@ -1193,6 +1343,10 @@ module Aws::CostExplorer
1193
1343
  # * RECORD\_TYPE - The different types of charges such as RI fees,
1194
1344
  # usage costs, tax refunds, and credits.
1195
1345
  #
1346
+ # * RESOURCE\_ID - The unique identifier of the resource. ResourceId
1347
+ # is an opt-in feature only available for last 14 days for
1348
+ # EC2-Compute Service.
1349
+ #
1196
1350
  # If you set the context to `RESERVATIONS`, you can use the following
1197
1351
  # dimensions for searching:
1198
1352
  #
@@ -1303,7 +1457,7 @@ module Aws::CostExplorer
1303
1457
  # # recursive Expression
1304
1458
  # },
1305
1459
  # dimensions: {
1306
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1460
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1307
1461
  # values: ["Value"],
1308
1462
  # },
1309
1463
  # tags: {
@@ -1582,7 +1736,7 @@ module Aws::CostExplorer
1582
1736
  # # recursive Expression
1583
1737
  # },
1584
1738
  # dimensions: {
1585
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1739
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1586
1740
  # values: ["Value"],
1587
1741
  # },
1588
1742
  # tags: {
@@ -1712,7 +1866,7 @@ module Aws::CostExplorer
1712
1866
  # # recursive Expression
1713
1867
  # },
1714
1868
  # dimensions: {
1715
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1869
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1716
1870
  # values: ["Value"],
1717
1871
  # },
1718
1872
  # tags: {
@@ -1855,7 +2009,7 @@ module Aws::CostExplorer
1855
2009
  # # recursive Expression
1856
2010
  # },
1857
2011
  # dimensions: {
1858
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2012
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
1859
2013
  # values: ["Value"],
1860
2014
  # },
1861
2015
  # tags: {
@@ -1883,6 +2037,9 @@ module Aws::CostExplorer
1883
2037
  # @!attribute [rw] granularity
1884
2038
  # The granularity of the Amazon Web Services cost data for your
1885
2039
  # Savings Plans. `Granularity` can't be set if `GroupBy` is set.
2040
+ #
2041
+ # The `GetSavingsPlansCoverage` operation supports only `DAILY` and
2042
+ # `MONTHLY` granularities.
1886
2043
  # @return [String]
1887
2044
  #
1888
2045
  # @!attribute [rw] filter
@@ -1909,7 +2066,7 @@ module Aws::CostExplorer
1909
2066
  #
1910
2067
  # @!attribute [rw] metrics
1911
2068
  # The measurement that you want your Savings Plans coverage reported
1912
- # in. The only valid value is `spendCoveredBySavingsPlans`.
2069
+ # in. The only valid value is `SpendCoveredBySavingsPlans`.
1913
2070
  # @return [Array<String>]
1914
2071
  #
1915
2072
  # @!attribute [rw] next_token
@@ -2007,7 +2164,7 @@ module Aws::CostExplorer
2007
2164
  end
2008
2165
 
2009
2166
  # @!attribute [rw] metadata
2010
- # The accountIDs these recommendations are generated for.
2167
+ # Information regarding this specific recommendation set.
2011
2168
  # @return [Types::SavingsPlansPurchaseRecommendationMetadata]
2012
2169
  #
2013
2170
  # @!attribute [rw] savings_plans_purchase_recommendation
@@ -2053,7 +2210,7 @@ module Aws::CostExplorer
2053
2210
  # # recursive Expression
2054
2211
  # },
2055
2212
  # dimensions: {
2056
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2213
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2057
2214
  # values: ["Value"],
2058
2215
  # },
2059
2216
  # tags: {
@@ -2082,14 +2239,13 @@ module Aws::CostExplorer
2082
2239
  #
2083
2240
  # * `REGION`
2084
2241
  #
2085
- # * `PAYMENT_OPTIONS`
2242
+ # * `PAYMENT_OPTION`
2086
2243
  #
2087
2244
  # * `INSTANCE_TYPE_FAMILY`
2088
2245
  #
2089
2246
  # `GetSavingsPlansUtilizationDetails` uses the same [Expression][1]
2090
2247
  # object as the other operations, but only `AND` is supported among
2091
- # each dimension. If there are multiple values for a dimension, they
2092
- # are OR'd together.
2248
+ # each dimension.
2093
2249
  #
2094
2250
  #
2095
2251
  #
@@ -2170,7 +2326,7 @@ module Aws::CostExplorer
2170
2326
  # # recursive Expression
2171
2327
  # },
2172
2328
  # dimensions: {
2173
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2329
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2174
2330
  # values: ["Value"],
2175
2331
  # },
2176
2332
  # tags: {
@@ -2190,6 +2346,9 @@ module Aws::CostExplorer
2190
2346
  # @!attribute [rw] granularity
2191
2347
  # The granularity of the Amazon Web Services utillization data for
2192
2348
  # your Savings Plans.
2349
+ #
2350
+ # The `GetSavingsPlansUtilization` operation supports only `DAILY` and
2351
+ # `MONTHLY` granularities.
2193
2352
  # @return [String]
2194
2353
  #
2195
2354
  # @!attribute [rw] filter
@@ -2204,14 +2363,13 @@ module Aws::CostExplorer
2204
2363
  #
2205
2364
  # * `REGION`
2206
2365
  #
2207
- # * `PAYMENT_OPTIONS`
2366
+ # * `PAYMENT_OPTION`
2208
2367
  #
2209
2368
  # * `INSTANCE_TYPE_FAMILY`
2210
2369
  #
2211
2370
  # `GetSavingsPlansUtilization` uses the same [Expression][1] object as
2212
2371
  # the other operations, but only `AND` is supported among each
2213
- # dimension. If there are multiple values for a dimension, they are
2214
- # OR'd together.
2372
+ # dimension.
2215
2373
  #
2216
2374
  #
2217
2375
  #
@@ -2228,13 +2386,13 @@ module Aws::CostExplorer
2228
2386
  end
2229
2387
 
2230
2388
  # @!attribute [rw] savings_plans_utilizations_by_time
2231
- # The amount of time (in hours) ou used your Savings Plans. This
2389
+ # The amount of cost/commitment you used your Savings Plans. This
2232
2390
  # allows you to specify date ranges.
2233
2391
  # @return [Array<Types::SavingsPlansUtilizationByTime>]
2234
2392
  #
2235
2393
  # @!attribute [rw] total
2236
- # The total amount of time that you used your Savings Plans,
2237
- # regardless of date ranges.
2394
+ # The total amount of cost/commitment that you used your Savings
2395
+ # Plans, regardless of date ranges.
2238
2396
  # @return [Types::SavingsPlansUtilizationAggregates]
2239
2397
  #
2240
2398
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationResponse AWS API Documentation
@@ -2343,7 +2501,7 @@ module Aws::CostExplorer
2343
2501
  # # recursive Expression
2344
2502
  # },
2345
2503
  # dimensions: {
2346
- # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2504
+ # key: "AZ", # 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, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
2347
2505
  # values: ["Value"],
2348
2506
  # },
2349
2507
  # tags: {
@@ -3249,7 +3407,8 @@ module Aws::CostExplorer
3249
3407
  # Attribute details on a specific Savings Plan.
3250
3408
  #
3251
3409
  # @!attribute [rw] region
3252
- # A geographic location where the Savings Plans is hosted.
3410
+ # A collection of AWS resources in a geographic area. Each AWS Region
3411
+ # is isolated and independent of the other Regions.
3253
3412
  # @return [String]
3254
3413
  #
3255
3414
  # @!attribute [rw] instance_family
@@ -3523,8 +3682,8 @@ module Aws::CostExplorer
3523
3682
  # @return [String]
3524
3683
  #
3525
3684
  # @!attribute [rw] used_commitment
3526
- # The amount of your Savings Plans commitment that was not consumed
3527
- # from Savings Plans eligible usage in a specific period.
3685
+ # The amount of your Savings Plans commitment that was consumed from
3686
+ # Savings Plans eligible usage in a specific period.
3528
3687
  # @return [String]
3529
3688
  #
3530
3689
  # @!attribute [rw] unused_commitment
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.31.0
4
+ version: 1.32.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: 2019-11-06 00:00:00.000000000 Z
11
+ date: 2019-11-11 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core