aws-sdk-costexplorer 1.57.0 → 1.62.0

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
@@ -1228,6 +1309,36 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # The field that contains a list of disk (local storage) metrics
+    # associated with the current instance.
+    #
+    # @!attribute [rw] disk_read_ops_per_second
+    #   The maximum number of read operations per second.
+    #   @return [String]
+    #
+    # @!attribute [rw] disk_write_ops_per_second
+    #   The maximum number of write operations per second.
+    #   @return [String]
+    #
+    # @!attribute [rw] disk_read_bytes_per_second
+    #   The maximum read throughput operations per second.
+    #   @return [String]
+    #
+    # @!attribute [rw] disk_write_bytes_per_second
+    #   The maximum write throughput operations per second.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DiskResourceUtilization AWS API Documentation
+    #
+    class DiskResourceUtilization < Struct.new(
+      :disk_read_ops_per_second,
+      :disk_write_ops_per_second,
+      :disk_read_bytes_per_second,
+      :disk_write_bytes_per_second)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The EBS field that contains a list of EBS metrics associated with the
     # current instance.
     #
@@ -1386,13 +1497,25 @@ module Aws::CostExplorer
     #   the current instance.
     #   @return [Types::EBSResourceUtilization]
     #
+    # @!attribute [rw] disk_resource_utilization
+    #   The field that contains a list of disk (local storage) metrics
+    #   associated with the current instance.
+    #   @return [Types::DiskResourceUtilization]
+    #
+    # @!attribute [rw] network_resource_utilization
+    #   The network field that contains a list of network metrics associated
+    #   with the current instance.
+    #   @return [Types::NetworkResourceUtilization]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/EC2ResourceUtilization AWS API Documentation
     #
     class EC2ResourceUtilization < Struct.new(
       :max_cpu_utilization_percentage,
       :max_memory_utilization_percentage,
       :max_storage_utilization_percentage,
-      :ebs_resource_utilization)
+      :ebs_resource_utilization,
+      :disk_resource_utilization,
+      :network_resource_utilization)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1923,7 +2046,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 +2210,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 +2521,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 +2664,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 +3023,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 +4149,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 +4721,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 +4846,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
@@ -4927,6 +5150,38 @@ module Aws::CostExplorer
       include Aws::Structure
     end
 
+    # The network field that contains a list of network metrics associated
+    # with the current instance.
+    #
+    # @!attribute [rw] network_in_bytes_per_second
+    #   The network ingress throughput utilization measured in Bytes per
+    #   second.
+    #   @return [String]
+    #
+    # @!attribute [rw] network_out_bytes_per_second
+    #   The network outgress throughput utilization measured in Bytes per
+    #   second.
+    #   @return [String]
+    #
+    # @!attribute [rw] network_packets_in_per_second
+    #   The network ingress packets measured in packets per second.
+    #   @return [String]
+    #
+    # @!attribute [rw] network_packets_out_per_second
+    #   The network outgress packets measured in packets per second.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/NetworkResourceUtilization AWS API Documentation
+    #
+    class NetworkResourceUtilization < Struct.new(
+      :network_in_bytes_per_second,
+      :network_out_bytes_per_second,
+      :network_packets_in_per_second,
+      :network_packets_out_per_second)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ProvideAnomalyFeedbackRequest
     #   data as a hash:
     #
@@ -5540,6 +5795,12 @@ module Aws::CostExplorer
     #   Details for termination recommendations.
     #   @return [Types::TerminateRecommendationDetail]
     #
+    # @!attribute [rw] finding_reason_codes
+    #   The list of possible reasons why the recommendation is generated
+    #   such as under or over utilization of specific metrics (for example,
+    #   CPU, Memory, Network).
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/RightsizingRecommendation AWS API Documentation
     #
     class RightsizingRecommendation < Struct.new(
@@ -5547,7 +5808,8 @@ module Aws::CostExplorer
       :current_instance,
       :rightsizing_type,
       :modify_recommendation_detail,
-      :terminate_recommendation_detail)
+      :terminate_recommendation_detail,
+      :finding_reason_codes)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6379,6 +6641,12 @@ module Aws::CostExplorer
     #   Expected utilization metrics for target instance type.
     #   @return [Types::ResourceUtilization]
     #
+    # @!attribute [rw] platform_differences
+    #   Explains the actions you might need to take in order to successfully
+    #   migrate your workloads from the current instance type to the
+    #   recommended instance type.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/TargetInstance AWS API Documentation
     #
     class TargetInstance < Struct.new(
@@ -6387,7 +6655,8 @@ module Aws::CostExplorer
       :currency_code,
       :default_target_instance,
       :resource_details,
-      :expected_resource_utilization)
+      :expected_resource_utilization,
+      :platform_differences)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6599,8 +6868,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 +6899,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 +6926,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