aws-sdk-costexplorer 1.31.0 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. checksums.yaml +4 -4
  2. data/lib/aws-sdk-costexplorer.rb +1 -1
  3. data/lib/aws-sdk-costexplorer/client.rb +201 -28
  4. data/lib/aws-sdk-costexplorer/client_api.rb +28 -0
  5. data/lib/aws-sdk-costexplorer/types.rb +191 -32
  6. metadata +2 -2
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
data/lib/aws-sdk-costexplorer.rb CHANGED
@@ -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
data/lib/aws-sdk-costexplorer/client.rb CHANGED
@@ -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
 
data/lib/aws-sdk-costexplorer/client_api.rb CHANGED
@@ -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"
data/lib/aws-sdk-costexplorer/types.rb CHANGED
@@ -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