aws-sdk-costexplorer 1.64.0 → 1.68.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.
@@ -285,6 +285,15 @@ module Aws::CostExplorer
285
285
  # ** Please note ** When response stubbing is enabled, no HTTP
286
286
  # requests are made, and retries are disabled.
287
287
  #
288
+ # @option options [Boolean] :use_dualstack_endpoint
289
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
290
+ # will be used if available.
291
+ #
292
+ # @option options [Boolean] :use_fips_endpoint
293
+ # When set to `true`, fips compatible endpoints will be used if available.
294
+ # When a `fips` region is used, the region is normalized and this config
295
+ # is set to `true`.
296
+ #
288
297
  # @option options [Boolean] :validate_params (true)
289
298
  # When `true`, request parameters are validated before
290
299
  # sending the request.
@@ -469,6 +478,10 @@ module Aws::CostExplorer
469
478
  # @option params [String] :default_value
470
479
  # The default value for the cost category.
471
480
  #
481
+ # @option params [Array<Types::CostCategorySplitChargeRule>] :split_charge_rules
482
+ # The split charge rules used to allocate your charges between your Cost
483
+ # Category values.
484
+ #
472
485
  # @return [Types::CreateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
473
486
  #
474
487
  # * {Types::CreateCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
@@ -520,6 +533,19 @@ module Aws::CostExplorer
520
533
  # },
521
534
  # ],
522
535
  # default_value: "CostCategoryValue",
536
+ # split_charge_rules: [
537
+ # {
538
+ # source: "GenericString", # required
539
+ # targets: ["GenericString"], # required
540
+ # method: "FIXED", # required, accepts FIXED, PROPORTIONAL, EVEN
541
+ # parameters: [
542
+ # {
543
+ # type: "ALLOCATION_PERCENTAGES", # required, accepts ALLOCATION_PERCENTAGES
544
+ # values: ["GenericString"], # required
545
+ # },
546
+ # ],
547
+ # },
548
+ # ],
523
549
  # })
524
550
  #
525
551
  # @example Response structure
@@ -671,6 +697,15 @@ module Aws::CostExplorer
671
697
  # resp.cost_category.rules[0].inherited_value.dimension_name #=> String, one of "LINKED_ACCOUNT_NAME", "TAG"
672
698
  # resp.cost_category.rules[0].inherited_value.dimension_key #=> String
673
699
  # resp.cost_category.rules[0].type #=> String, one of "REGULAR", "INHERITED_VALUE"
700
+ # resp.cost_category.split_charge_rules #=> Array
701
+ # resp.cost_category.split_charge_rules[0].source #=> String
702
+ # resp.cost_category.split_charge_rules[0].targets #=> Array
703
+ # resp.cost_category.split_charge_rules[0].targets[0] #=> String
704
+ # resp.cost_category.split_charge_rules[0].method #=> String, one of "FIXED", "PROPORTIONAL", "EVEN"
705
+ # resp.cost_category.split_charge_rules[0].parameters #=> Array
706
+ # resp.cost_category.split_charge_rules[0].parameters[0].type #=> String, one of "ALLOCATION_PERCENTAGES"
707
+ # resp.cost_category.split_charge_rules[0].parameters[0].values #=> Array
708
+ # resp.cost_category.split_charge_rules[0].parameters[0].values[0] #=> String
674
709
  # resp.cost_category.processing_status #=> Array
675
710
  # resp.cost_category.processing_status[0].component #=> String, one of "COST_EXPLORER"
676
711
  # resp.cost_category.processing_status[0].status #=> String, one of "PROCESSING", "APPLIED"
@@ -685,8 +720,8 @@ module Aws::CostExplorer
685
720
  req.send_request(options)
686
721
  end
687
722
 
688
- # Retrieves all of the cost anomalies detected on your account, during
689
- # the time period specified by the `DateInterval` object.
723
+ # Retrieves all of the cost anomalies detected on your account during
724
+ # the time period that's specified by the `DateInterval` object.
690
725
  #
691
726
  # @option params [String] :monitor_arn
692
727
  # Retrieves all of the cost anomalies detected for a specific cost
@@ -706,9 +741,9 @@ module Aws::CostExplorer
706
741
  # retrieve anomalies, with an estimated dollar impact greater than 200.
707
742
  #
708
743
  # @option params [String] :next_page_token
709
- # The token to retrieve the next set of results. AWS provides the token
710
- # when the response from a previous call has more results than the
711
- # maximum page size.
744
+ # The token to retrieve the next set of results. Amazon Web Services
745
+ # provides the token when the response from a previous call has more
746
+ # results than the maximum page size.
712
747
  #
713
748
  # @option params [Integer] :max_results
714
749
  # The number of entries a paginated response contains.
@@ -773,12 +808,12 @@ module Aws::CostExplorer
773
808
  # A list of cost anomaly monitor ARNs.
774
809
  #
775
810
  # @option params [String] :next_page_token
776
- # The token to retrieve the next set of results. AWS provides the token
777
- # when the response from a previous call has more results than the
778
- # maximum page size.
811
+ # The token to retrieve the next set of results. Amazon Web Services
812
+ # provides the token when the response from a previous call has more
813
+ # results than the maximum page size.
779
814
  #
780
815
  # @option params [Integer] :max_results
781
- # The number of entries a paginated response contains.
816
+ # The number of entries that a paginated response contains.
782
817
  #
783
818
  # @return [Types::GetAnomalyMonitorsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
784
819
  #
@@ -846,9 +881,9 @@ module Aws::CostExplorer
846
881
  # Cost anomaly monitor ARNs.
847
882
  #
848
883
  # @option params [String] :next_page_token
849
- # The token to retrieve the next set of results. AWS provides the token
850
- # when the response from a previous call has more results than the
851
- # maximum page size.
884
+ # The token to retrieve the next set of results. Amazon Web Services
885
+ # provides the token when the response from a previous call has more
886
+ # results than the maximum page size.
852
887
  #
853
888
  # @option params [Integer] :max_results
854
889
  # The number of entries a paginated response contains.
@@ -893,13 +928,13 @@ module Aws::CostExplorer
893
928
  end
894
929
 
895
930
  # Retrieves cost and usage metrics for your account. You can specify
896
- # which cost and usage-related metric, such as `BlendedCosts` or
897
- # `UsageQuantity`, that you want the request to return. You can also
898
- # filter and group your data by various dimensions, such as `SERVICE` or
899
- # `AZ`, in a specific time range. For a complete list of valid
900
- # dimensions, see the [GetDimensionValues][1] operation. Management
901
- # account in an organization in AWS Organizations have access to all
902
- # member accounts.
931
+ # which cost and usage-related metric that you want the request to
932
+ # return. For example, you can specify `BlendedCosts` or
933
+ # `UsageQuantity`. You can also filter and group your data by various
934
+ # dimensions, such as `SERVICE` or `AZ`, in a specific time range. For a
935
+ # complete list of valid dimensions, see the [GetDimensionValues][1]
936
+ # operation. Management account in an organization in Organizations have
937
+ # access to all member accounts.
903
938
  #
904
939
  # For information about filter limitations, see [Quotas and
905
940
  # restrictions][2] in the *Billing and Cost Management User Guide*.
@@ -910,23 +945,23 @@ module Aws::CostExplorer
910
945
  # [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-limits.html
911
946
  #
912
947
  # @option params [required, Types::DateInterval] :time_period
913
- # Sets the start and end dates for retrieving AWS costs. The start date
914
- # is inclusive, but the end date is exclusive. For example, if `start`
915
- # is `2017-01-01` and `end` is `2017-05-01`, then the cost and usage
916
- # data is retrieved from `2017-01-01` up to and including `2017-04-30`
917
- # but not including `2017-05-01`.
948
+ # Sets the start date and end date for retrieving Amazon Web Services
949
+ # costs. The start date is inclusive, but the end date is exclusive. For
950
+ # example, if `start` is `2017-01-01` and `end` is `2017-05-01`, then
951
+ # the cost and usage data is retrieved from `2017-01-01` up to and
952
+ # including `2017-04-30` but not including `2017-05-01`.
918
953
  #
919
954
  # @option params [required, String] :granularity
920
- # Sets the AWS cost granularity to `MONTHLY` or `DAILY`, or `HOURLY`. If
921
- # `Granularity` isn't set, the response object doesn't include the
922
- # `Granularity`, either `MONTHLY` or `DAILY`, or `HOURLY`.
955
+ # Sets the Amazon Web Services cost granularity to `MONTHLY` or `DAILY`,
956
+ # or `HOURLY`. If `Granularity` isn't set, the response object doesn't
957
+ # include the `Granularity`, either `MONTHLY` or `DAILY`, or `HOURLY`.
923
958
  #
924
959
  # @option params [Types::Expression] :filter
925
- # Filters AWS costs by different dimensions. For example, you can
926
- # specify `SERVICE` and `LINKED_ACCOUNT` and get the costs that are
927
- # associated with that account's usage of that service. You can nest
928
- # `Expression` objects to define any combination of dimension filters.
929
- # For more information, see [Expression][1].
960
+ # Filters Amazon Web Services costs by different dimensions. For
961
+ # example, you can specify `SERVICE` and `LINKED_ACCOUNT` and get the
962
+ # costs that are associated with that account's usage of that service.
963
+ # You can nest `Expression` objects to define any combination of
964
+ # dimension filters. For more information, see [Expression][1].
930
965
  #
931
966
  #
932
967
  #
@@ -945,7 +980,7 @@ module Aws::CostExplorer
945
980
  # usage numbers without taking into account the units. For example, if
946
981
  # you aggregate `usageQuantity` across all of Amazon EC2, the results
947
982
  # aren't meaningful because Amazon EC2 compute hours and data transfer
948
- # are measured in different units (for example, hours vs. GB). To get
983
+ # are measured in different units (for example, hours and GB). To get
949
984
  # more meaningful `UsageQuantity` metrics, filter by `UsageType` or
950
985
  # `UsageTypeGroups`.
951
986
  #
@@ -958,20 +993,22 @@ module Aws::CostExplorer
958
993
  # [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
959
994
  #
960
995
  # @option params [Array<Types::GroupDefinition>] :group_by
961
- # You can group AWS costs using up to two different groups, either
962
- # dimensions, tag keys, cost categories, or any two group by types.
996
+ # You can group Amazon Web Services costs using up to two different
997
+ # groups, either dimensions, tag keys, cost categories, or any two group
998
+ # by types.
963
999
  #
964
- # When you group by tag key, you get all tag values, including empty
965
- # strings.
1000
+ # Valid values for the `DIMENSION` type are `AZ`, `INSTANCE_TYPE`,
1001
+ # `LEGAL_ENTITY_NAME`, `LINKED_ACCOUNT`, `OPERATION`, `PLATFORM`,
1002
+ # `PURCHASE_TYPE`, `SERVICE`, `TENANCY`, `RECORD_TYPE`, and
1003
+ # `USAGE_TYPE`.
966
1004
  #
967
- # Valid values are `AZ`, `INSTANCE_TYPE`, `LEGAL_ENTITY_NAME`,
968
- # `LINKED_ACCOUNT`, `OPERATION`, `PLATFORM`, `PURCHASE_TYPE`, `SERVICE`,
969
- # `TAGS`, `TENANCY`, `RECORD_TYPE`, and `USAGE_TYPE`.
1005
+ # When you group by the `TAG` type and include a valid tag key, you get
1006
+ # all tag values, including empty strings.
970
1007
  #
971
1008
  # @option params [String] :next_page_token
972
- # The token to retrieve the next set of results. AWS provides the token
973
- # when the response from a previous call has more results than the
974
- # maximum page size.
1009
+ # The token to retrieve the next set of results. Amazon Web Services
1010
+ # provides the token when the response from a previous call has more
1011
+ # results than the maximum page size.
975
1012
  #
976
1013
  # @return [Types::GetCostAndUsageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
977
1014
  #
@@ -1067,14 +1104,14 @@ module Aws::CostExplorer
1067
1104
  # return. You can also filter and group your data by various dimensions,
1068
1105
  # such as `SERVICE` or `AZ`, in a specific time range. For a complete
1069
1106
  # list of valid dimensions, see the [GetDimensionValues][1] operation.
1070
- # Management account in an organization in AWS Organizations have access
1071
- # to all member accounts. This API is currently available for the Amazon
1107
+ # Management account in an organization in Organizations have access to
1108
+ # all member accounts. This API is currently available for the Amazon
1072
1109
  # Elastic Compute Cloud – Compute service only.
1073
1110
  #
1074
1111
  # <note markdown="1"> This is an opt-in only feature. You can enable this feature from the
1075
1112
  # Cost Explorer Settings page. For information on how to access the
1076
1113
  # Settings page, see [Controlling Access for Cost Explorer][2] in the
1077
- # *AWS Billing and Cost Management User Guide*.
1114
+ # *Billing and Cost Management User Guide*.
1078
1115
  #
1079
1116
  # </note>
1080
1117
  #
@@ -1093,9 +1130,9 @@ module Aws::CostExplorer
1093
1130
  # `2017-05-01`.
1094
1131
  #
1095
1132
  # @option params [required, String] :granularity
1096
- # Sets the AWS cost granularity to `MONTHLY`, `DAILY`, or `HOURLY`. If
1097
- # `Granularity` isn't set, the response object doesn't include the
1098
- # `Granularity`, `MONTHLY`, `DAILY`, or `HOURLY`.
1133
+ # Sets the Amazon Web Services cost granularity to `MONTHLY`, `DAILY`,
1134
+ # or `HOURLY`. If `Granularity` isn't set, the response object doesn't
1135
+ # include the `Granularity`, `MONTHLY`, `DAILY`, or `HOURLY`.
1099
1136
  #
1100
1137
  # @option params [required, Types::Expression] :filter
1101
1138
  # Filters Amazon Web Services costs by different dimensions. For
@@ -1142,9 +1179,9 @@ module Aws::CostExplorer
1142
1179
  # groups: `DIMENSION`, `TAG`, `COST_CATEGORY`.
1143
1180
  #
1144
1181
  # @option params [String] :next_page_token
1145
- # The token to retrieve the next set of results. AWS provides the token
1146
- # when the response from a previous call has more results than the
1147
- # maximum page size.
1182
+ # The token to retrieve the next set of results. Amazon Web Services
1183
+ # provides the token when the response from a previous call has more
1184
+ # results than the maximum page size.
1148
1185
  #
1149
1186
  # @return [Types::GetCostAndUsageWithResourcesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1150
1187
  #
@@ -1265,7 +1302,7 @@ module Aws::CostExplorer
1265
1302
  # for `REGION==us-east-1 OR REGION==us-west-1`. For
1266
1303
  # `GetRightsizingRecommendation`, the Region is a full name (for
1267
1304
  # example, `REGION==US East (N. Virginia)`. The `Expression` example
1268
- # looks like:
1305
+ # is as follows:
1269
1306
  #
1270
1307
  # `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
1271
1308
  # “us-west-1” ] \} \}`
@@ -1277,11 +1314,11 @@ module Aws::CostExplorer
1277
1314
  #
1278
1315
  # * Compound dimension values with logical operations - You can use
1279
1316
  # multiple `Expression` types and the logical operators `AND/OR/NOT`
1280
- # to create a list of one or more `Expression` objects. This allows
1281
- # you to filter on more advanced options. For example, you can filter
1317
+ # to create a list of one or more `Expression` objects. By doing this,
1318
+ # you can filter on more advanced options. For example, you can filter
1282
1319
  # on `((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type ==
1283
1320
  # Type1)) AND (USAGE_TYPE != DataTransfer)`. The `Expression` for that
1284
- # looks like this:
1321
+ # is as follows:
1285
1322
  #
1286
1323
  # `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values":
1287
1324
  # [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
@@ -1298,13 +1335,13 @@ module Aws::CostExplorer
1298
1335
  # "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
1299
1336
  #
1300
1337
  # <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR and
1301
- # NOT is not supported. OR is not supported between different
1338
+ # NOT isn't supported. OR isn't supported between different
1302
1339
  # dimensions, or dimensions and tags. NOT operators aren't supported.
1303
1340
  # Dimensions are also limited to `LINKED_ACCOUNT`, `REGION`, or
1304
1341
  # `RIGHTSIZING_TYPE`.
1305
1342
  #
1306
1343
  # For the `GetReservationPurchaseRecommendation` action, only NOT is
1307
- # supported. AND and OR are not supported. Dimensions are limited to
1344
+ # supported. AND and OR aren't supported. Dimensions are limited to
1308
1345
  # `LINKED_ACCOUNT`.
1309
1346
  #
1310
1347
  # </note>
@@ -1345,9 +1382,9 @@ module Aws::CostExplorer
1345
1382
  #
1346
1383
  # @option params [String] :next_page_token
1347
1384
  # If the number of objects that are still available for retrieval
1348
- # exceeds the limit, AWS returns a NextPageToken value in the response.
1349
- # To retrieve the next batch of objects, provide the NextPageToken from
1350
- # the prior call in your next request.
1385
+ # exceeds the limit, Amazon Web Services returns a NextPageToken value
1386
+ # in the response. To retrieve the next batch of objects, provide the
1387
+ # NextPageToken from the prior call in your next request.
1351
1388
  #
1352
1389
  # @return [Types::GetCostCategoriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1353
1390
  #
@@ -1595,10 +1632,10 @@ module Aws::CostExplorer
1595
1632
  # The value that you want to search the filter values for.
1596
1633
  #
1597
1634
  # @option params [required, Types::DateInterval] :time_period
1598
- # The start and end dates for retrieving the dimension values. The start
1599
- # date is inclusive, but the end date is exclusive. For example, if
1600
- # `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost and
1601
- # usage data is retrieved from `2017-01-01` up to and including
1635
+ # The start date and end date for retrieving the dimension values. The
1636
+ # start date is inclusive, but the end date is exclusive. For example,
1637
+ # if `start` is `2017-01-01` and `end` is `2017-05-01`, then the cost
1638
+ # and usage data is retrieved from `2017-01-01` up to and including
1602
1639
  # `2017-04-30` but not including `2017-05-01`.
1603
1640
  #
1604
1641
  # @option params [required, String] :dimension
@@ -1626,11 +1663,11 @@ module Aws::CostExplorer
1626
1663
  # `m4.xlarge`.
1627
1664
  #
1628
1665
  # * LEGAL\_ENTITY\_NAME - The name of the organization that sells you
1629
- # AWS services, such as Amazon Web Services.
1666
+ # Amazon Web Services services, such as Amazon Web Services.
1630
1667
  #
1631
1668
  # * LINKED\_ACCOUNT - The description in the attribute map that includes
1632
1669
  # the full name of the member account. The value field contains the
1633
- # AWS ID of the member account.
1670
+ # Amazon Web Services ID of the member account.
1634
1671
  #
1635
1672
  # * OPERATING\_SYSTEM - The operating system. Examples are Windows or
1636
1673
  # Linux.
@@ -1645,7 +1682,7 @@ module Aws::CostExplorer
1645
1682
  # usage is related. Examples include On-Demand Instances and Standard
1646
1683
  # Reserved Instances.
1647
1684
  #
1648
- # * SERVICE - The AWS service such as Amazon DynamoDB.
1685
+ # * SERVICE - The Amazon Web Services service such as Amazon DynamoDB.
1649
1686
  #
1650
1687
  # * USAGE\_TYPE - The type of usage. An example is
1651
1688
  # DataTransfer-In-Bytes. The response for the `GetDimensionValues`
@@ -1655,7 +1692,7 @@ module Aws::CostExplorer
1655
1692
  # is Amazon EC2: CloudWatch – Alarms. The response for this operation
1656
1693
  # includes a unit attribute.
1657
1694
  #
1658
- # * REGION - The AWS Region.
1695
+ # * REGION - The Amazon Web Services Region.
1659
1696
  #
1660
1697
  # * RECORD\_TYPE - The different types of charges such as RI fees, usage
1661
1698
  # costs, tax refunds, and credits.
@@ -1680,12 +1717,12 @@ module Aws::CostExplorer
1680
1717
  #
1681
1718
  # * LINKED\_ACCOUNT - The description in the attribute map that includes
1682
1719
  # the full name of the member account. The value field contains the
1683
- # AWS ID of the member account.
1720
+ # Amazon Web Services ID of the member account.
1684
1721
  #
1685
1722
  # * PLATFORM - The Amazon EC2 operating system. Examples are Windows or
1686
1723
  # Linux.
1687
1724
  #
1688
- # * REGION - The AWS Region.
1725
+ # * REGION - The Amazon Web Services Region.
1689
1726
  #
1690
1727
  # * SCOPE (Utilization only) - The scope of a Reserved Instance (RI).
1691
1728
  # Values are regional or a single Availability Zone.
@@ -1705,13 +1742,13 @@ module Aws::CostExplorer
1705
1742
  # * PAYMENT\_OPTION - Payment option for the given Savings Plans (for
1706
1743
  # example, All Upfront)
1707
1744
  #
1708
- # * REGION - The AWS Region.
1745
+ # * REGION - The Amazon Web Services Region.
1709
1746
  #
1710
1747
  # * INSTANCE\_TYPE\_FAMILY - The family of instances (For example, `m5`)
1711
1748
  #
1712
1749
  # * LINKED\_ACCOUNT - The description in the attribute map that includes
1713
1750
  # the full name of the member account. The value field contains the
1714
- # AWS ID of the member account.
1751
+ # Amazon Web Services ID of the member account.
1715
1752
  #
1716
1753
  # * SAVINGS\_PLAN\_ARN - The unique identifier for your Savings Plan
1717
1754
  #
@@ -1724,7 +1761,7 @@ module Aws::CostExplorer
1724
1761
  # for `REGION==us-east-1 OR REGION==us-west-1`. For
1725
1762
  # `GetRightsizingRecommendation`, the Region is a full name (for
1726
1763
  # example, `REGION==US East (N. Virginia)`. The `Expression` example
1727
- # looks like:
1764
+ # is as follows:
1728
1765
  #
1729
1766
  # `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
1730
1767
  # “us-west-1” ] \} \}`
@@ -1736,11 +1773,11 @@ module Aws::CostExplorer
1736
1773
  #
1737
1774
  # * Compound dimension values with logical operations - You can use
1738
1775
  # multiple `Expression` types and the logical operators `AND/OR/NOT`
1739
- # to create a list of one or more `Expression` objects. This allows
1740
- # you to filter on more advanced options. For example, you can filter
1776
+ # to create a list of one or more `Expression` objects. By doing this,
1777
+ # you can filter on more advanced options. For example, you can filter
1741
1778
  # on `((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type ==
1742
1779
  # Type1)) AND (USAGE_TYPE != DataTransfer)`. The `Expression` for that
1743
- # looks like this:
1780
+ # is as follows:
1744
1781
  #
1745
1782
  # `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values":
1746
1783
  # [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
@@ -1757,13 +1794,13 @@ module Aws::CostExplorer
1757
1794
  # "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
1758
1795
  #
1759
1796
  # <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR and
1760
- # NOT is not supported. OR is not supported between different
1797
+ # NOT isn't supported. OR isn't supported between different
1761
1798
  # dimensions, or dimensions and tags. NOT operators aren't supported.
1762
1799
  # Dimensions are also limited to `LINKED_ACCOUNT`, `REGION`, or
1763
1800
  # `RIGHTSIZING_TYPE`.
1764
1801
  #
1765
1802
  # For the `GetReservationPurchaseRecommendation` action, only NOT is
1766
- # supported. AND and OR are not supported. Dimensions are limited to
1803
+ # supported. AND and OR aren't supported. Dimensions are limited to
1767
1804
  # `LINKED_ACCOUNT`.
1768
1805
  #
1769
1806
  # </note>
@@ -1803,9 +1840,9 @@ module Aws::CostExplorer
1803
1840
  # For `GetDimensionValues`, MaxResults has an upper limit of 1000.
1804
1841
  #
1805
1842
  # @option params [String] :next_page_token
1806
- # The token to retrieve the next set of results. AWS provides the token
1807
- # when the response from a previous call has more results than the
1808
- # maximum page size.
1843
+ # The token to retrieve the next set of results. Amazon Web Services
1844
+ # provides the token when the response from a previous call has more
1845
+ # results than the maximum page size.
1809
1846
  #
1810
1847
  # @return [Types::GetDimensionValuesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1811
1848
  #
@@ -1952,8 +1989,8 @@ module Aws::CostExplorer
1952
1989
  # * TENANCY
1953
1990
  #
1954
1991
  # @option params [String] :granularity
1955
- # The granularity of the AWS cost data for the reservation. Valid values
1956
- # are `MONTHLY` and `DAILY`.
1992
+ # The granularity of the Amazon Web Services cost data for the
1993
+ # reservation. Valid values are `MONTHLY` and `DAILY`.
1957
1994
  #
1958
1995
  # If `GroupBy` is set, `Granularity` can't be set. If `Granularity`
1959
1996
  # isn't set, the response object doesn't include `Granularity`, either
@@ -2011,9 +2048,9 @@ module Aws::CostExplorer
2011
2048
  # values in a request.
2012
2049
  #
2013
2050
  # @option params [String] :next_page_token
2014
- # The token to retrieve the next set of results. AWS provides the token
2015
- # when the response from a previous call has more results than the
2016
- # maximum page size.
2051
+ # The token to retrieve the next set of results. Amazon Web Services
2052
+ # provides the token when the response from a previous call has more
2053
+ # results than the maximum page size.
2017
2054
  #
2018
2055
  # @option params [Types::SortDefinition] :sort_by
2019
2056
  # The value by which you want to sort the data.
@@ -2044,9 +2081,9 @@ module Aws::CostExplorer
2044
2081
  #
2045
2082
  # @option params [Integer] :max_results
2046
2083
  # The maximum number of objects that you returned for this request. If
2047
- # more objects are available, in the response, AWS provides a
2048
- # NextPageToken value that you can use in a subsequent call to get the
2049
- # next batch of objects.
2084
+ # more objects are available, in the response, Amazon Web Services
2085
+ # provides a NextPageToken value that you can use in a subsequent call
2086
+ # to get the next batch of objects.
2050
2087
  #
2051
2088
  # @return [Types::GetReservationCoverageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2052
2089
  #
@@ -2157,22 +2194,24 @@ module Aws::CostExplorer
2157
2194
  # recommendations could help you reduce your costs. Reservations provide
2158
2195
  # a discounted hourly rate (up to 75%) compared to On-Demand pricing.
2159
2196
  #
2160
- # AWS generates your recommendations by identifying your On-Demand usage
2161
- # during a specific time period and collecting your usage into
2162
- # categories that are eligible for a reservation. After AWS has these
2163
- # categories, it simulates every combination of reservations in each
2164
- # category of usage to identify the best number of each type of RI to
2165
- # purchase to maximize your estimated savings.
2166
- #
2167
- # For example, AWS automatically aggregates your Amazon EC2 Linux,
2168
- # shared tenancy, and c4 family usage in the US West (Oregon) Region and
2169
- # recommends that you buy size-flexible regional reservations to apply
2170
- # to the c4 family usage. AWS recommends the smallest size instance in
2171
- # an instance family. This makes it easier to purchase a size-flexible
2172
- # RI. AWS also shows the equal number of normalized units so that you
2173
- # can purchase any instance size that you want. For this example, your
2174
- # RI recommendation would be for `c4.large` because that is the smallest
2175
- # size instance in the c4 instance family.
2197
+ # Amazon Web Services generates your recommendations by identifying your
2198
+ # On-Demand usage during a specific time period and collecting your
2199
+ # usage into categories that are eligible for a reservation. After
2200
+ # Amazon Web Services has these categories, it simulates every
2201
+ # combination of reservations in each category of usage to identify the
2202
+ # best number of each type of RI to purchase to maximize your estimated
2203
+ # savings.
2204
+ #
2205
+ # For example, Amazon Web Services automatically aggregates your Amazon
2206
+ # EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon)
2207
+ # Region and recommends that you buy size-flexible regional reservations
2208
+ # to apply to the c4 family usage. Amazon Web Services recommends the
2209
+ # smallest size instance in an instance family. This makes it easier to
2210
+ # purchase a size-flexible RI. Amazon Web Services also shows the equal
2211
+ # number of normalized units so that you can purchase any instance size
2212
+ # that you want. For this example, your RI recommendation would be for
2213
+ # `c4.large` because that is the smallest size instance in the c4
2214
+ # instance family.
2176
2215
  #
2177
2216
  # @option params [String] :account_id
2178
2217
  # The account ID that is associated with the recommendation.
@@ -2189,7 +2228,7 @@ module Aws::CostExplorer
2189
2228
  # for `REGION==us-east-1 OR REGION==us-west-1`. For
2190
2229
  # `GetRightsizingRecommendation`, the Region is a full name (for
2191
2230
  # example, `REGION==US East (N. Virginia)`. The `Expression` example
2192
- # looks like:
2231
+ # is as follows:
2193
2232
  #
2194
2233
  # `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
2195
2234
  # “us-west-1” ] \} \}`
@@ -2201,11 +2240,11 @@ module Aws::CostExplorer
2201
2240
  #
2202
2241
  # * Compound dimension values with logical operations - You can use
2203
2242
  # multiple `Expression` types and the logical operators `AND/OR/NOT`
2204
- # to create a list of one or more `Expression` objects. This allows
2205
- # you to filter on more advanced options. For example, you can filter
2243
+ # to create a list of one or more `Expression` objects. By doing this,
2244
+ # you can filter on more advanced options. For example, you can filter
2206
2245
  # on `((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type ==
2207
2246
  # Type1)) AND (USAGE_TYPE != DataTransfer)`. The `Expression` for that
2208
- # looks like this:
2247
+ # is as follows:
2209
2248
  #
2210
2249
  # `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values":
2211
2250
  # [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
@@ -2222,13 +2261,13 @@ module Aws::CostExplorer
2222
2261
  # "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
2223
2262
  #
2224
2263
  # <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR and
2225
- # NOT is not supported. OR is not supported between different
2264
+ # NOT isn't supported. OR isn't supported between different
2226
2265
  # dimensions, or dimensions and tags. NOT operators aren't supported.
2227
2266
  # Dimensions are also limited to `LINKED_ACCOUNT`, `REGION`, or
2228
2267
  # `RIGHTSIZING_TYPE`.
2229
2268
  #
2230
2269
  # For the `GetReservationPurchaseRecommendation` action, only NOT is
2231
- # supported. AND and OR are not supported. Dimensions are limited to
2270
+ # supported. AND and OR aren't supported. Dimensions are limited to
2232
2271
  # `LINKED_ACCOUNT`.
2233
2272
  #
2234
2273
  # </note>
@@ -2241,8 +2280,8 @@ module Aws::CostExplorer
2241
2280
  # accounts only.
2242
2281
  #
2243
2282
  # @option params [String] :lookback_period_in_days
2244
- # The number of previous days that you want AWS to consider when it
2245
- # calculates your recommendations.
2283
+ # The number of previous days that you want Amazon Web Services to
2284
+ # consider when it calculates your recommendations.
2246
2285
  #
2247
2286
  # @option params [String] :term_in_years
2248
2287
  # The reservation term that you want recommendations for.
@@ -2495,15 +2534,15 @@ module Aws::CostExplorer
2495
2534
  # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`.
2496
2535
  #
2497
2536
  # @option params [String] :next_page_token
2498
- # The token to retrieve the next set of results. AWS provides the token
2499
- # when the response from a previous call has more results than the
2500
- # maximum page size.
2537
+ # The token to retrieve the next set of results. Amazon Web Services
2538
+ # provides the token when the response from a previous call has more
2539
+ # results than the maximum page size.
2501
2540
  #
2502
2541
  # @option params [Integer] :max_results
2503
2542
  # The maximum number of objects that you returned for this request. If
2504
- # more objects are available, in the response, AWS provides a
2505
- # NextPageToken value that you can use in a subsequent call to get the
2506
- # next batch of objects.
2543
+ # more objects are available, in the response, Amazon Web Services
2544
+ # provides a NextPageToken value that you can use in a subsequent call
2545
+ # to get the next batch of objects.
2507
2546
  #
2508
2547
  # @return [Types::GetReservationUtilizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2509
2548
  #
@@ -2641,8 +2680,8 @@ module Aws::CostExplorer
2641
2680
  # Recommendations are generated to either downsize or terminate
2642
2681
  # instances, along with providing savings detail and metrics. For
2643
2682
  # details on calculation and function, see [Optimizing Your Cost with
2644
- # Rightsizing Recommendations][1] in the *AWS Billing and Cost
2645
- # Management User Guide*.
2683
+ # Rightsizing Recommendations][1] in the *Billing and Cost Management
2684
+ # User Guide*.
2646
2685
  #
2647
2686
  #
2648
2687
  #
@@ -2657,7 +2696,7 @@ module Aws::CostExplorer
2657
2696
  # for `REGION==us-east-1 OR REGION==us-west-1`. For
2658
2697
  # `GetRightsizingRecommendation`, the Region is a full name (for
2659
2698
  # example, `REGION==US East (N. Virginia)`. The `Expression` example
2660
- # looks like:
2699
+ # is as follows:
2661
2700
  #
2662
2701
  # `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
2663
2702
  # “us-west-1” ] \} \}`
@@ -2669,11 +2708,11 @@ module Aws::CostExplorer
2669
2708
  #
2670
2709
  # * Compound dimension values with logical operations - You can use
2671
2710
  # multiple `Expression` types and the logical operators `AND/OR/NOT`
2672
- # to create a list of one or more `Expression` objects. This allows
2673
- # you to filter on more advanced options. For example, you can filter
2711
+ # to create a list of one or more `Expression` objects. By doing this,
2712
+ # you can filter on more advanced options. For example, you can filter
2674
2713
  # on `((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type ==
2675
2714
  # Type1)) AND (USAGE_TYPE != DataTransfer)`. The `Expression` for that
2676
- # looks like this:
2715
+ # is as follows:
2677
2716
  #
2678
2717
  # `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values":
2679
2718
  # [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
@@ -2690,13 +2729,13 @@ module Aws::CostExplorer
2690
2729
  # "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
2691
2730
  #
2692
2731
  # <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR and
2693
- # NOT is not supported. OR is not supported between different
2732
+ # NOT isn't supported. OR isn't supported between different
2694
2733
  # dimensions, or dimensions and tags. NOT operators aren't supported.
2695
2734
  # Dimensions are also limited to `LINKED_ACCOUNT`, `REGION`, or
2696
2735
  # `RIGHTSIZING_TYPE`.
2697
2736
  #
2698
2737
  # For the `GetReservationPurchaseRecommendation` action, only NOT is
2699
- # supported. AND and OR are not supported. Dimensions are limited to
2738
+ # supported. AND and OR aren't supported. Dimensions are limited to
2700
2739
  # `LINKED_ACCOUNT`.
2701
2740
  #
2702
2741
  # </note>
@@ -3527,7 +3566,7 @@ module Aws::CostExplorer
3527
3566
  # for `REGION==us-east-1 OR REGION==us-west-1`. For
3528
3567
  # `GetRightsizingRecommendation`, the Region is a full name (for
3529
3568
  # example, `REGION==US East (N. Virginia)`. The `Expression` example
3530
- # looks like:
3569
+ # is as follows:
3531
3570
  #
3532
3571
  # `\{ "Dimensions": \{ "Key": "REGION", "Values": [ "us-east-1",
3533
3572
  # “us-west-1” ] \} \}`
@@ -3539,11 +3578,11 @@ module Aws::CostExplorer
3539
3578
  #
3540
3579
  # * Compound dimension values with logical operations - You can use
3541
3580
  # multiple `Expression` types and the logical operators `AND/OR/NOT`
3542
- # to create a list of one or more `Expression` objects. This allows
3543
- # you to filter on more advanced options. For example, you can filter
3581
+ # to create a list of one or more `Expression` objects. By doing this,
3582
+ # you can filter on more advanced options. For example, you can filter
3544
3583
  # on `((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type ==
3545
3584
  # Type1)) AND (USAGE_TYPE != DataTransfer)`. The `Expression` for that
3546
- # looks like this:
3585
+ # is as follows:
3547
3586
  #
3548
3587
  # `\{ "And": [ \{"Or": [ \{"Dimensions": \{ "Key": "REGION", "Values":
3549
3588
  # [ "us-east-1", "us-west-1" ] \}\}, \{"Tags": \{ "Key": "TagName",
@@ -3560,13 +3599,13 @@ module Aws::CostExplorer
3560
3599
  # "USAGE_TYPE", "Values": [ "DataTransfer" ] \} \} `
3561
3600
  #
3562
3601
  # <note markdown="1"> For the `GetRightsizingRecommendation` action, a combination of OR and
3563
- # NOT is not supported. OR is not supported between different
3602
+ # NOT isn't supported. OR isn't supported between different
3564
3603
  # dimensions, or dimensions and tags. NOT operators aren't supported.
3565
3604
  # Dimensions are also limited to `LINKED_ACCOUNT`, `REGION`, or
3566
3605
  # `RIGHTSIZING_TYPE`.
3567
3606
  #
3568
3607
  # For the `GetReservationPurchaseRecommendation` action, only NOT is
3569
- # supported. AND and OR are not supported. Dimensions are limited to
3608
+ # supported. AND and OR aren't supported. Dimensions are limited to
3570
3609
  # `LINKED_ACCOUNT`.
3571
3610
  #
3572
3611
  # </note>
@@ -3605,9 +3644,9 @@ module Aws::CostExplorer
3605
3644
  # For `GetTags`, MaxResults has an upper limit of 1000.
3606
3645
  #
3607
3646
  # @option params [String] :next_page_token
3608
- # The token to retrieve the next set of results. AWS provides the token
3609
- # when the response from a previous call has more results than the
3610
- # maximum page size.
3647
+ # The token to retrieve the next set of results. Amazon Web Services
3648
+ # provides the token when the response from a previous call has more
3649
+ # results than the maximum page size.
3611
3650
  #
3612
3651
  # @return [Types::GetTagsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3613
3652
  #
@@ -3930,7 +3969,7 @@ module Aws::CostExplorer
3930
3969
  end
3931
3970
 
3932
3971
  # Updates an existing cost anomaly monitor. The changes made are applied
3933
- # going forward, and does not change anomalies detected in the past.
3972
+ # going forward, and doesn'tt change anomalies detected in the past.
3934
3973
  #
3935
3974
  # @option params [required, String] :monitor_arn
3936
3975
  # Cost anomaly monitor Amazon Resource Names (ARNs).
@@ -3971,7 +4010,7 @@ module Aws::CostExplorer
3971
4010
  # The update to the threshold value for receiving notifications.
3972
4011
  #
3973
4012
  # @option params [String] :frequency
3974
- # The update to the frequency value at which subscribers will receive
4013
+ # The update to the frequency value that subscribers receive
3975
4014
  # notifications.
3976
4015
  #
3977
4016
  # @option params [Array<String>] :monitor_arn_list
@@ -3981,7 +4020,7 @@ module Aws::CostExplorer
3981
4020
  # The update to the subscriber list.
3982
4021
  #
3983
4022
  # @option params [String] :subscription_name
3984
- # The subscription's new name.
4023
+ # The new name of the subscription.
3985
4024
  #
3986
4025
  # @return [Types::UpdateAnomalySubscriptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3987
4026
  #
@@ -4039,6 +4078,10 @@ module Aws::CostExplorer
4039
4078
  # @option params [String] :default_value
4040
4079
  # The default value for the cost category.
4041
4080
  #
4081
+ # @option params [Array<Types::CostCategorySplitChargeRule>] :split_charge_rules
4082
+ # The split charge rules used to allocate your charges between your Cost
4083
+ # Category values.
4084
+ #
4042
4085
  # @return [Types::UpdateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4043
4086
  #
4044
4087
  # * {Types::UpdateCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
@@ -4090,6 +4133,19 @@ module Aws::CostExplorer
4090
4133
  # },
4091
4134
  # ],
4092
4135
  # default_value: "CostCategoryValue",
4136
+ # split_charge_rules: [
4137
+ # {
4138
+ # source: "GenericString", # required
4139
+ # targets: ["GenericString"], # required
4140
+ # method: "FIXED", # required, accepts FIXED, PROPORTIONAL, EVEN
4141
+ # parameters: [
4142
+ # {
4143
+ # type: "ALLOCATION_PERCENTAGES", # required, accepts ALLOCATION_PERCENTAGES
4144
+ # values: ["GenericString"], # required
4145
+ # },
4146
+ # ],
4147
+ # },
4148
+ # ],
4093
4149
  # })
4094
4150
  #
4095
4151
  # @example Response structure
@@ -4119,7 +4175,7 @@ module Aws::CostExplorer
4119
4175
  params: params,
4120
4176
  config: config)
4121
4177
  context[:gem_name] = 'aws-sdk-costexplorer'
4122
- context[:gem_version] = '1.64.0'
4178
+ context[:gem_version] = '1.68.0'
4123
4179
  Seahorse::Client::Request.new(handlers, context)
4124
4180
  end
4125
4181