aws-sdk-costexplorer 1.56.0 → 1.61.0

data/VERSION

@@ -0,0 +1 @@
+1.61.0

data/lib/aws-sdk-costexplorer.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
 # @!group service
 module Aws::CostExplorer
 
-  GEM_VERSION = '1.56.0'
+  GEM_VERSION = '1.61.0'
 
 end

data/lib/aws-sdk-costexplorer/client.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -466,6 +466,9 @@ module Aws::CostExplorer
     #
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
     #
+    # @option params [String] :default_value
+    #   The default value for the cost category.
+    #
     # @return [Types::CreateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
@@ -478,8 +481,8 @@ module Aws::CostExplorer
     #     rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
     #     rules: [ # required
     #       {
-    #         value: "CostCategoryValue", # required
-    #         rule: { # required
+    #         value: "CostCategoryValue",
+    #         rule: {
     #           or: [
     #             {
     #               # recursive Expression
@@ -509,8 +512,14 @@ module Aws::CostExplorer
     #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #           },
     #         },
+    #         inherited_value: {
+    #           dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
+    #           dimension_key: "GenericString",
+    #         },
+    #         type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
     #       },
     #     ],
+    #     default_value: "CostCategoryValue",
     #   })
     #
     # @example Response structure
@@ -659,9 +668,13 @@ module Aws::CostExplorer
     #   resp.cost_category.rules[0].rule.cost_categories.values[0] #=> String
     #   resp.cost_category.rules[0].rule.cost_categories.match_options #=> Array
     #   resp.cost_category.rules[0].rule.cost_categories.match_options[0] #=> String, one of "EQUALS", "ABSENT", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
+    #   resp.cost_category.rules[0].inherited_value.dimension_name #=> String, one of "LINKED_ACCOUNT_NAME", "TAG"
+    #   resp.cost_category.rules[0].inherited_value.dimension_key #=> String
+    #   resp.cost_category.rules[0].type #=> String, one of "REGULAR", "INHERITED_VALUE"
     #   resp.cost_category.processing_status #=> Array
     #   resp.cost_category.processing_status[0].component #=> String, one of "COST_EXPLORER"
     #   resp.cost_category.processing_status[0].status #=> String, one of "PROCESSING", "APPLIED"
+    #   resp.cost_category.default_value #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DescribeCostCategoryDefinition AWS API Documentation
     #
@@ -903,7 +916,7 @@ module Aws::CostExplorer
     #   data is retrieved from `2017-01-01` up to and including `2017-04-30`
     #   but not including `2017-05-01`.
     #
-    # @option params [String] :granularity
+    # @option params [required, String] :granularity
     #   Sets the AWS cost granularity to `MONTHLY` or `DAILY`, or `HOURLY`. If
     #   `Granularity` isn't set, the response object doesn't include the
     #   `Granularity`, either `MONTHLY` or `DAILY`, or `HOURLY`.
@@ -974,7 +987,7 @@ module Aws::CostExplorer
     #       start: "YearMonthDay", # required
     #       end: "YearMonthDay", # required
     #     },
-    #     granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
+    #     granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
     #     filter: {
     #       or: [
     #         {
@@ -1079,7 +1092,7 @@ module Aws::CostExplorer
     #   `2017-01-01` up to and including `2017-04-30` but not including
     #   `2017-05-01`.
     #
-    # @option params [String] :granularity
+    # @option params [required, String] :granularity
     #   Sets the AWS cost granularity to `MONTHLY`, `DAILY`, or `HOURLY`. If
     #   `Granularity` isn't set, the response object doesn't include the
     #   `Granularity`, `MONTHLY`, `DAILY`, or `HOURLY`.
@@ -1147,7 +1160,7 @@ module Aws::CostExplorer
     #       start: "YearMonthDay", # required
     #       end: "YearMonthDay", # required
     #     },
-    #     granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
+    #     granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
     #     filter: { # required
     #       or: [
     #         {
@@ -1328,6 +1341,8 @@ module Aws::CostExplorer
     #   `MaxResults` is not specified with `SortBy`, the request will return
     #   1000 results as the default value for this parameter.
     #
+    #   For `GetCostCategories`, MaxResults has an upper limit of 1000.
+    #
     # @option params [String] :next_page_token
     #   If the number of objects that are still available for retrieval
     #   exceeds the limit, AWS returns a NextPageToken value in the response.
@@ -1448,8 +1463,54 @@ module Aws::CostExplorer
     #   granularities.
     #
     # @option params [Types::Expression] :filter
-    #   The filters that you want to use to filter your forecast. Cost
-    #   Explorer API supports all of the Cost Explorer filters.
+    #   The filters that you want to use to filter your forecast. The
+    #   `GetCostForecast` API supports filtering by the following dimensions:
+    #
+    #   * `AZ`
+    #
+    #   * `INSTANCE_TYPE`
+    #
+    #   * `LINKED_ACCOUNT`
+    #
+    #   * `LINKED_ACCOUNT_NAME`
+    #
+    #   * `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`
+    #
+    #   * `INSTANCE_TYPE_FAMILY`
+    #
+    #   * `BILLING_ENTITY`
+    #
+    #   * `RESERVATION_ID`
+    #
+    #   * `SAVINGS_PLAN_ARN`
     #
     # @option params [Integer] :prediction_interval_level
     #   Cost Explorer always returns the mean forecast as a single point. You
@@ -1739,6 +1800,8 @@ module Aws::CostExplorer
     #   MaxResults is not specified with SortBy, the request will return 1000
     #   results as the default value for this parameter.
     #
+    #   For `GetDimensionValues`, MaxResults has an upper limit of 1000.
+    #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
     #   when the response from a previous call has more results than the
@@ -3015,7 +3078,7 @@ module Aws::CostExplorer
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_savings_plans_purchase_recommendation({
-    #     savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP
+    #     savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP, SAGEMAKER_SP
     #     term_in_years: "ONE_YEAR", # required, accepts ONE_YEAR, THREE_YEARS
     #     payment_option: "NO_UPFRONT", # required, accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
     #     account_scope: "PAYER", # accepts PAYER, LINKED
@@ -3060,7 +3123,7 @@ module Aws::CostExplorer
     #   resp.metadata.generation_timestamp #=> String
     #   resp.metadata.additional_metadata #=> String
     #   resp.savings_plans_purchase_recommendation.account_scope #=> String, one of "PAYER", "LINKED"
-    #   resp.savings_plans_purchase_recommendation.savings_plans_type #=> String, one of "COMPUTE_SP", "EC2_INSTANCE_SP"
+    #   resp.savings_plans_purchase_recommendation.savings_plans_type #=> String, one of "COMPUTE_SP", "EC2_INSTANCE_SP", "SAGEMAKER_SP"
     #   resp.savings_plans_purchase_recommendation.term_in_years #=> String, one of "ONE_YEAR", "THREE_YEARS"
     #   resp.savings_plans_purchase_recommendation.payment_option #=> String, one of "NO_UPFRONT", "PARTIAL_UPFRONT", "ALL_UPFRONT", "LIGHT_UTILIZATION", "MEDIUM_UTILIZATION", "HEAVY_UTILIZATION"
     #   resp.savings_plans_purchase_recommendation.lookback_period_in_days #=> String, one of "SEVEN_DAYS", "THIRTY_DAYS", "SIXTY_DAYS"
@@ -3519,6 +3582,8 @@ module Aws::CostExplorer
     #   MaxResults is not specified with SortBy, the request will return 1000
     #   results as the default value for this parameter.
     #
+    #   For `GetTags`, MaxResults has an upper limit of 1000.
+    #
     # @option params [String] :next_page_token
     #   The token to retrieve the next set of results. AWS provides the token
     #   when the response from a previous call has more results than the
@@ -3627,8 +3692,54 @@ module Aws::CostExplorer
     #   granularities.
     #
     # @option params [Types::Expression] :filter
-    #   The filters that you want to use to filter your forecast. Cost
-    #   Explorer API supports all of the Cost Explorer filters.
+    #   The filters that you want to use to filter your forecast. The
+    #   `GetUsageForecast` API supports filtering by the following dimensions:
+    #
+    #   * `AZ`
+    #
+    #   * `INSTANCE_TYPE`
+    #
+    #   * `LINKED_ACCOUNT`
+    #
+    #   * `LINKED_ACCOUNT_NAME`
+    #
+    #   * `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`
+    #
+    #   * `INSTANCE_TYPE_FAMILY`
+    #
+    #   * `BILLING_ENTITY`
+    #
+    #   * `RESERVATION_ID`
+    #
+    #   * `SAVINGS_PLAN_ARN`
     #
     # @option params [Integer] :prediction_interval_level
     #   Cost Explorer always returns the mean forecast as a single point. You
@@ -3753,6 +3864,7 @@ module Aws::CostExplorer
     #   resp.cost_category_references[0].processing_status[0].status #=> String, one of "PROCESSING", "APPLIED"
     #   resp.cost_category_references[0].values #=> Array
     #   resp.cost_category_references[0].values[0] #=> String
+    #   resp.cost_category_references[0].default_value #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitions AWS API Documentation
@@ -3904,6 +4016,9 @@ module Aws::CostExplorer
     #
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
     #
+    # @option params [String] :default_value
+    #   The default value for the cost category.
+    #
     # @return [Types::UpdateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
@@ -3916,8 +4031,8 @@ module Aws::CostExplorer
     #     rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
     #     rules: [ # required
     #       {
-    #         value: "CostCategoryValue", # required
-    #         rule: { # required
+    #         value: "CostCategoryValue",
+    #         rule: {
     #           or: [
     #             {
     #               # recursive Expression
@@ -3947,8 +4062,14 @@ module Aws::CostExplorer
     #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #           },
     #         },
+    #         inherited_value: {
+    #           dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
+    #           dimension_key: "GenericString",
+    #         },
+    #         type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
     #       },
     #     ],
+    #     default_value: "CostCategoryValue",
     #   })
     #
     # @example Response structure
@@ -3978,7 +4099,7 @@ module Aws::CostExplorer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costexplorer'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.61.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-costexplorer/client_api.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -33,6 +33,8 @@ module Aws::CostExplorer
     BillExpirationException = Shapes::StructureShape.new(name: 'BillExpirationException')
     Context = Shapes::StringShape.new(name: 'Context')
     CostCategory = Shapes::StructureShape.new(name: 'CostCategory')
+    CostCategoryInheritedValueDimension = Shapes::StructureShape.new(name: 'CostCategoryInheritedValueDimension')
+    CostCategoryInheritedValueDimensionName = Shapes::StringShape.new(name: 'CostCategoryInheritedValueDimensionName')
     CostCategoryMaxResults = Shapes::IntegerShape.new(name: 'CostCategoryMaxResults')
     CostCategoryName = Shapes::StringShape.new(name: 'CostCategoryName')
     CostCategoryNamesList = Shapes::ListShape.new(name: 'CostCategoryNamesList')
@@ -41,6 +43,7 @@ module Aws::CostExplorer
     CostCategoryReference = Shapes::StructureShape.new(name: 'CostCategoryReference')
     CostCategoryReferencesList = Shapes::ListShape.new(name: 'CostCategoryReferencesList')
     CostCategoryRule = Shapes::StructureShape.new(name: 'CostCategoryRule')
+    CostCategoryRuleType = Shapes::StringShape.new(name: 'CostCategoryRuleType')
     CostCategoryRuleVersion = Shapes::StringShape.new(name: 'CostCategoryRuleVersion')
     CostCategoryRulesList = Shapes::ListShape.new(name: 'CostCategoryRulesList')
     CostCategoryStatus = Shapes::StringShape.new(name: 'CostCategoryStatus')
@@ -338,8 +341,13 @@ module Aws::CostExplorer
     CostCategory.add_member(:rule_version, Shapes::ShapeRef.new(shape: CostCategoryRuleVersion, required: true, location_name: "RuleVersion"))
     CostCategory.add_member(:rules, Shapes::ShapeRef.new(shape: CostCategoryRulesList, required: true, location_name: "Rules"))
     CostCategory.add_member(:processing_status, Shapes::ShapeRef.new(shape: CostCategoryProcessingStatusList, location_name: "ProcessingStatus"))
+    CostCategory.add_member(:default_value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "DefaultValue"))
     CostCategory.struct_class = Types::CostCategory
 
+    CostCategoryInheritedValueDimension.add_member(:dimension_name, Shapes::ShapeRef.new(shape: CostCategoryInheritedValueDimensionName, location_name: "DimensionName"))
+    CostCategoryInheritedValueDimension.add_member(:dimension_key, Shapes::ShapeRef.new(shape: GenericString, location_name: "DimensionKey"))
+    CostCategoryInheritedValueDimension.struct_class = Types::CostCategoryInheritedValueDimension
+
     CostCategoryNamesList.member = Shapes::ShapeRef.new(shape: CostCategoryName)
 
     CostCategoryProcessingStatus.add_member(:component, Shapes::ShapeRef.new(shape: CostCategoryStatusComponent, location_name: "Component"))
@@ -355,12 +363,15 @@ module Aws::CostExplorer
     CostCategoryReference.add_member(:number_of_rules, Shapes::ShapeRef.new(shape: NonNegativeInteger, location_name: "NumberOfRules"))
     CostCategoryReference.add_member(:processing_status, Shapes::ShapeRef.new(shape: CostCategoryProcessingStatusList, location_name: "ProcessingStatus"))
     CostCategoryReference.add_member(:values, Shapes::ShapeRef.new(shape: CostCategoryValuesList, location_name: "Values"))
+    CostCategoryReference.add_member(:default_value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "DefaultValue"))
     CostCategoryReference.struct_class = Types::CostCategoryReference
 
     CostCategoryReferencesList.member = Shapes::ShapeRef.new(shape: CostCategoryReference)
 
-    CostCategoryRule.add_member(:value, Shapes::ShapeRef.new(shape: CostCategoryValue, required: true, location_name: "Value"))
-    CostCategoryRule.add_member(:rule, Shapes::ShapeRef.new(shape: Expression, required: true, location_name: "Rule"))
+    CostCategoryRule.add_member(:value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "Value"))
+    CostCategoryRule.add_member(:rule, Shapes::ShapeRef.new(shape: Expression, location_name: "Rule"))
+    CostCategoryRule.add_member(:inherited_value, Shapes::ShapeRef.new(shape: CostCategoryInheritedValueDimension, location_name: "InheritedValue"))
+    CostCategoryRule.add_member(:type, Shapes::ShapeRef.new(shape: CostCategoryRuleType, location_name: "Type"))
     CostCategoryRule.struct_class = Types::CostCategoryRule
 
     CostCategoryRulesList.member = Shapes::ShapeRef.new(shape: CostCategoryRule)
@@ -414,6 +425,7 @@ module Aws::CostExplorer
     CreateCostCategoryDefinitionRequest.add_member(:name, Shapes::ShapeRef.new(shape: CostCategoryName, required: true, location_name: "Name"))
     CreateCostCategoryDefinitionRequest.add_member(:rule_version, Shapes::ShapeRef.new(shape: CostCategoryRuleVersion, required: true, location_name: "RuleVersion"))
     CreateCostCategoryDefinitionRequest.add_member(:rules, Shapes::ShapeRef.new(shape: CostCategoryRulesList, required: true, location_name: "Rules"))
+    CreateCostCategoryDefinitionRequest.add_member(:default_value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "DefaultValue"))
     CreateCostCategoryDefinitionRequest.struct_class = Types::CreateCostCategoryDefinitionRequest
 
     CreateCostCategoryDefinitionResponse.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "CostCategoryArn"))
@@ -576,7 +588,7 @@ module Aws::CostExplorer
     GetAnomalySubscriptionsResponse.struct_class = Types::GetAnomalySubscriptionsResponse
 
     GetCostAndUsageRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
-    GetCostAndUsageRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
+    GetCostAndUsageRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, required: true, location_name: "Granularity"))
     GetCostAndUsageRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, location_name: "Filter"))
     GetCostAndUsageRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricNames, required: true, location_name: "Metrics"))
     GetCostAndUsageRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
@@ -590,7 +602,7 @@ module Aws::CostExplorer
     GetCostAndUsageResponse.struct_class = Types::GetCostAndUsageResponse
 
     GetCostAndUsageWithResourcesRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: DateInterval, required: true, location_name: "TimePeriod"))
-    GetCostAndUsageWithResourcesRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, location_name: "Granularity"))
+    GetCostAndUsageWithResourcesRequest.add_member(:granularity, Shapes::ShapeRef.new(shape: Granularity, required: true, location_name: "Granularity"))
     GetCostAndUsageWithResourcesRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, required: true, location_name: "Filter"))
     GetCostAndUsageWithResourcesRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: MetricNames, location_name: "Metrics"))
     GetCostAndUsageWithResourcesRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: GroupDefinitions, location_name: "GroupBy"))
@@ -1176,6 +1188,7 @@ module Aws::CostExplorer
     UpdateCostCategoryDefinitionRequest.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "CostCategoryArn"))
     UpdateCostCategoryDefinitionRequest.add_member(:rule_version, Shapes::ShapeRef.new(shape: CostCategoryRuleVersion, required: true, location_name: "RuleVersion"))
     UpdateCostCategoryDefinitionRequest.add_member(:rules, Shapes::ShapeRef.new(shape: CostCategoryRulesList, required: true, location_name: "Rules"))
+    UpdateCostCategoryDefinitionRequest.add_member(:default_value, Shapes::ShapeRef.new(shape: CostCategoryValue, location_name: "DefaultValue"))
     UpdateCostCategoryDefinitionRequest.struct_class = Types::UpdateCostCategoryDefinitionRequest
 
     UpdateCostCategoryDefinitionResponse.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "CostCategoryArn"))

data/lib/aws-sdk-costexplorer/errors.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

data/lib/aws-sdk-costexplorer/resource.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

data/lib/aws-sdk-costexplorer/types.rb

@@ -3,7 +3,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 
@@ -380,6 +380,10 @@ module Aws::CostExplorer
     #   specific cost category.
     #   @return [Array<Types::CostCategoryProcessingStatus>]
     #
+    # @!attribute [rw] default_value
+    #   The default value for the cost category.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategory AWS API Documentation
     #
     class CostCategory < Struct.new(
@@ -389,7 +393,46 @@ module Aws::CostExplorer
       :name,
       :rule_version,
       :rules,
-      :processing_status)
+      :processing_status,
+      :default_value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # When creating or updating a cost category, you can define the
+    # `CostCategoryRule` rule type as `INHERITED_VALUE`. This rule type adds
+    # the flexibility of defining a rule that dynamically inherits the cost
+    # category value from the dimension value defined by
+    # `CostCategoryInheritedValueDimension`. For example, if you wanted to
+    # dynamically group costs based on the value of a specific tag key, you
+    # would first choose an inherited value rule type, then choose the tag
+    # dimension and specify the tag key to use.
+    #
+    # @note When making an API call, you may pass CostCategoryInheritedValueDimension
+    #   data as a hash:
+    #
+    #       {
+    #         dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
+    #         dimension_key: "GenericString",
+    #       }
+    #
+    # @!attribute [rw] dimension_name
+    #   The name of dimension for which to group costs.
+    #
+    #   If you specify `LINKED_ACCOUNT_NAME`, the cost category value will
+    #   be based on account name. If you specify `TAG`, the cost category
+    #   value will be based on the value of the specified tag key.
+    #   @return [String]
+    #
+    # @!attribute [rw] dimension_key
+    #   The key to extract cost category values.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryInheritedValueDimension AWS API Documentation
+    #
+    class CostCategoryInheritedValueDimension < Struct.new(
+      :dimension_name,
+      :dimension_key)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -449,6 +492,10 @@ module Aws::CostExplorer
     #   A list of unique cost category values in a specific cost category.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] default_value
+    #   The default value for the cost category.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryReference AWS API Documentation
     #
     class CostCategoryReference < Struct.new(
@@ -458,7 +505,8 @@ module Aws::CostExplorer
       :effective_end,
       :number_of_rules,
       :processing_status,
-      :values)
+      :values,
+      :default_value)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -471,8 +519,8 @@ module Aws::CostExplorer
     #   data as a hash:
     #
     #       {
-    #         value: "CostCategoryValue", # required
-    #         rule: { # required
+    #         value: "CostCategoryValue",
+    #         rule: {
     #           or: [
     #             {
     #               # recursive Expression
@@ -502,11 +550,15 @@ module Aws::CostExplorer
     #             match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #           },
     #         },
+    #         inherited_value: {
+    #           dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
+    #           dimension_key: "GenericString",
+    #         },
+    #         type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
     #       }
     #
     # @!attribute [rw] value
-    #   The value a line item will be categorized as, if it matches the
-    #   rule.
+    #   The default value for the cost category.
     #   @return [String]
     #
     # @!attribute [rw] rule
@@ -530,11 +582,29 @@ module Aws::CostExplorer
     #   [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-cost-categories.html#cost-categories-terms
     #   @return [Types::Expression]
     #
+    # @!attribute [rw] inherited_value
+    #   The value the line item will be categorized as, if the line item
+    #   contains the matched dimension.
+    #   @return [Types::CostCategoryInheritedValueDimension]
+    #
+    # @!attribute [rw] type
+    #   You can define the `CostCategoryRule` rule type as either `REGULAR`
+    #   or `INHERITED_VALUE`. The `INHERITED_VALUE` rule type adds the
+    #   flexibility of defining a rule that dynamically inherits the cost
+    #   category value from the dimension value defined by
+    #   `CostCategoryInheritedValueDimension`. For example, if you wanted to
+    #   dynamically group costs based on the value of a specific tag key,
+    #   you would first choose an inherited value rule type, then choose the
+    #   tag dimension and specify the tag key to use.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryRule AWS API Documentation
     #
     class CostCategoryRule < Struct.new(
       :value,
-      :rule)
+      :rule,
+      :inherited_value,
+      :type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -848,8 +918,8 @@ module Aws::CostExplorer
     #         rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
     #         rules: [ # required
     #           {
-    #             value: "CostCategoryValue", # required
-    #             rule: { # required
+    #             value: "CostCategoryValue",
+    #             rule: {
     #               or: [
     #                 {
     #                   # recursive Expression
@@ -879,8 +949,14 @@ module Aws::CostExplorer
     #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #               },
     #             },
+    #             inherited_value: {
+    #               dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
+    #               dimension_key: "GenericString",
+    #             },
+    #             type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
     #           },
     #         ],
+    #         default_value: "CostCategoryValue",
     #       }
     #
     # @!attribute [rw] name
@@ -900,12 +976,17 @@ module Aws::CostExplorer
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
     #   @return [Array<Types::CostCategoryRule>]
     #
+    # @!attribute [rw] default_value
+    #   The default value for the cost category.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateCostCategoryDefinitionRequest AWS API Documentation
     #
     class CreateCostCategoryDefinitionRequest < Struct.new(
       :name,
       :rule_version,
-      :rules)
+      :rules,
+      :default_value)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1923,7 +2004,7 @@ module Aws::CostExplorer
     #           start: "YearMonthDay", # required
     #           end: "YearMonthDay", # required
     #         },
-    #         granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
+    #         granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
     #         filter: {
     #           or: [
     #             {
@@ -2087,7 +2168,7 @@ module Aws::CostExplorer
     #           start: "YearMonthDay", # required
     #           end: "YearMonthDay", # required
     #         },
-    #         granularity: "DAILY", # accepts DAILY, MONTHLY, HOURLY
+    #         granularity: "DAILY", # required, accepts DAILY, MONTHLY, HOURLY
     #         filter: { # required
     #           or: [
     #             {
@@ -2398,6 +2479,8 @@ module Aws::CostExplorer
     #   The maximum number of objects that to be returned for this request.
     #   If `MaxResults` is not specified with `SortBy`, the request will
     #   return 1000 results as the default value for this parameter.
+    #
+    #   For `GetCostCategories`, MaxResults has an upper limit of 1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_page_token
@@ -2539,8 +2622,55 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] filter
-    #   The filters that you want to use to filter your forecast. Cost
-    #   Explorer API supports all of the Cost Explorer filters.
+    #   The filters that you want to use to filter your forecast. The
+    #   `GetCostForecast` API supports filtering by the following
+    #   dimensions:
+    #
+    #   * `AZ`
+    #
+    #   * `INSTANCE_TYPE`
+    #
+    #   * `LINKED_ACCOUNT`
+    #
+    #   * `LINKED_ACCOUNT_NAME`
+    #
+    #   * `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`
+    #
+    #   * `INSTANCE_TYPE_FAMILY`
+    #
+    #   * `BILLING_ENTITY`
+    #
+    #   * `RESERVATION_ID`
+    #
+    #   * `SAVINGS_PLAN_ARN`
     #   @return [Types::Expression]
     #
     # @!attribute [rw] prediction_interval_level
@@ -2851,6 +2981,8 @@ module Aws::CostExplorer
     #   maximum number of objects that to be returned for this request. If
     #   MaxResults is not specified with SortBy, the request will return
     #   1000 results as the default value for this parameter.
+    #
+    #   For `GetDimensionValues`, MaxResults has an upper limit of 1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_page_token
@@ -3975,7 +4107,7 @@ module Aws::CostExplorer
     #   data as a hash:
     #
     #       {
-    #         savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP
+    #         savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP, SAGEMAKER_SP
     #         term_in_years: "ONE_YEAR", # required, accepts ONE_YEAR, THREE_YEARS
     #         payment_option: "NO_UPFRONT", # required, accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
     #         account_scope: "PAYER", # accepts PAYER, LINKED
@@ -4547,6 +4679,8 @@ module Aws::CostExplorer
     #   maximum number of objects that to be returned for this request. If
     #   MaxResults is not specified with SortBy, the request will return
     #   1000 results as the default value for this parameter.
+    #
+    #   For `GetTags`, MaxResults has an upper limit of 1000.
     #   @return [Integer]
     #
     # @!attribute [rw] next_page_token
@@ -4670,8 +4804,55 @@ module Aws::CostExplorer
     #   @return [String]
     #
     # @!attribute [rw] filter
-    #   The filters that you want to use to filter your forecast. Cost
-    #   Explorer API supports all of the Cost Explorer filters.
+    #   The filters that you want to use to filter your forecast. The
+    #   `GetUsageForecast` API supports filtering by the following
+    #   dimensions:
+    #
+    #   * `AZ`
+    #
+    #   * `INSTANCE_TYPE`
+    #
+    #   * `LINKED_ACCOUNT`
+    #
+    #   * `LINKED_ACCOUNT_NAME`
+    #
+    #   * `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`
+    #
+    #   * `INSTANCE_TYPE_FAMILY`
+    #
+    #   * `BILLING_ENTITY`
+    #
+    #   * `RESERVATION_ID`
+    #
+    #   * `SAVINGS_PLAN_ARN`
     #   @return [Types::Expression]
     #
     # @!attribute [rw] prediction_interval_level
@@ -6599,8 +6780,8 @@ module Aws::CostExplorer
     #         rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
     #         rules: [ # required
     #           {
-    #             value: "CostCategoryValue", # required
-    #             rule: { # required
+    #             value: "CostCategoryValue",
+    #             rule: {
     #               or: [
     #                 {
     #                   # recursive Expression
@@ -6630,8 +6811,14 @@ module Aws::CostExplorer
     #                 match_options: ["EQUALS"], # accepts EQUALS, ABSENT, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
     #               },
     #             },
+    #             inherited_value: {
+    #               dimension_name: "LINKED_ACCOUNT_NAME", # accepts LINKED_ACCOUNT_NAME, TAG
+    #               dimension_key: "GenericString",
+    #             },
+    #             type: "REGULAR", # accepts REGULAR, INHERITED_VALUE
     #           },
     #         ],
+    #         default_value: "CostCategoryValue",
     #       }
     #
     # @!attribute [rw] cost_category_arn
@@ -6651,12 +6838,17 @@ module Aws::CostExplorer
     #   [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
     #   @return [Array<Types::CostCategoryRule>]
     #
+    # @!attribute [rw] default_value
+    #   The default value for the cost category.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostCategoryDefinitionRequest AWS API Documentation
     #
     class UpdateCostCategoryDefinitionRequest < Struct.new(
       :cost_category_arn,
       :rule_version,
-      :rules)
+      :rules,
+      :default_value)
       SENSITIVE = []
       include Aws::Structure
     end