aws-sdk-budgets 1.46.0 → 1.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c2c79ee602f224d41c02b7682615b21deb7e38ec2c06692e142c2fc982f44eb
-  data.tar.gz: d78c5c8b01da213c7c4bdf560d906ead27ab9b69ebe47202954d7abe12c5f8fe
+  metadata.gz: b480648ddd45e113aab14f453cffd5faf6b9e1e37d202e9f7b9c3624c2dec2ab
+  data.tar.gz: dbbbc23f4ed5c60e5fb5268fc62496185a545853a7d96630937fbf3fe5a3d031
 SHA512:
-  metadata.gz: 2e9f17a95a71b2e9ca376da68fe17d3ce6671f1295298a138616092aca0c7ed0816c10bd178d2c9854bd3c265824f2da40fe2191cbbbdaa8069caa8916c749f6
-  data.tar.gz: 937e5afacf9ca3d0444763812e975a68d7bbc96ed40ed2280ad0f637fe4396854ca368c6071056e42a664dc526ed3fbcedec2bcfbaea30ccd9d3e3e972f8720f
+  metadata.gz: 062f023054660e8aa8c2b275a9bed960213bf0d140163115e69ff319987f33004df71cf376e43846ef9bcbe5c5530dfd3924360fd6eb4d45af1bac766633f406
+  data.tar.gz: d7ef0ee9aa3317cf3eabd89457a5120c414e80a36da188e6119eba6e0d54dca29c32f8b656bbe46ab9287938c67e8c43ff6b118bb373f914461fa3be3d55c365

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.47.0 (2022-02-16)
+------------------
+
+* Feature - Adds support for auto-adjusting budgets, a new budget method alongside fixed and planned. Auto-adjusting budgets introduces new metadata to configure a budget limit baseline using a historical lookback average or current period forecast.
+
 1.46.0 (2022-02-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.46.0
+1.47.0

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

@@ -380,8 +380,8 @@ module Aws::Budgets
     #   A notification that you want to associate with a budget. A budget can
     #   have up to five notifications, and each notification can have one SNS
     #   subscriber and up to 10 email subscribers. If you include
-    #   notifications and subscribers in your `CreateBudget` call, AWS creates
-    #   the notifications and subscribers for you.
+    #   notifications and subscribers in your `CreateBudget` call, Amazon Web
+    #   Services creates the notifications and subscribers for you.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -434,6 +434,14 @@ module Aws::Budgets
     #       },
     #       budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE, SAVINGS_PLANS_UTILIZATION, SAVINGS_PLANS_COVERAGE
     #       last_updated_time: Time.now,
+    #       auto_adjust_data: {
+    #         auto_adjust_type: "HISTORICAL", # required, accepts HISTORICAL, FORECAST
+    #         historical_options: {
+    #           budget_adjustment_period: 1, # required
+    #           look_back_available_periods: 1,
+    #         },
+    #         last_auto_adjust_time: Time.now,
+    #       },
     #     },
     #     notifications_with_subscribers: [
     #       {
@@ -464,7 +472,7 @@ module Aws::Budgets
     # Creates a budget action.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -559,8 +567,8 @@ module Aws::Budgets
     #   create a notification for.
     #
     # @option params [required, String] :budget_name
-    #   The name of the budget that you want AWS to notify you about. Budget
-    #   names must be unique within an account.
+    #   The name of the budget that you want Amazon Web Services to notify you
+    #   about. Budget names must be unique within an account.
     #
     # @option params [required, Types::Notification] :notification
     #   The notification that you want to create.
@@ -674,7 +682,7 @@ module Aws::Budgets
     # Deletes a budget action.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -877,6 +885,10 @@ module Aws::Budgets
     #   resp.budget.calculated_spend.forecasted_spend.unit #=> String
     #   resp.budget.budget_type #=> String, one of "USAGE", "COST", "RI_UTILIZATION", "RI_COVERAGE", "SAVINGS_PLANS_UTILIZATION", "SAVINGS_PLANS_COVERAGE"
     #   resp.budget.last_updated_time #=> Time
+    #   resp.budget.auto_adjust_data.auto_adjust_type #=> String, one of "HISTORICAL", "FORECAST"
+    #   resp.budget.auto_adjust_data.historical_options.budget_adjustment_period #=> Integer
+    #   resp.budget.auto_adjust_data.historical_options.look_back_available_periods #=> Integer
+    #   resp.budget.auto_adjust_data.last_auto_adjust_time #=> Time
     #
     # @overload describe_budget(params = {})
     # @param [Hash] params ({})
@@ -888,7 +900,7 @@ module Aws::Budgets
     # Describes a budget action detail.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -953,7 +965,7 @@ module Aws::Budgets
     # Describes a budget action history detail.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -964,7 +976,7 @@ module Aws::Budgets
     #   action.
     #
     # @option params [Types::TimePeriod] :time_period
-    #   The period of time that is covered by a budget. The period has a start
+    #   The period of time that's covered by a budget. The period has a start
     #   date and an end date. The start date must come before the end date.
     #   There are no restrictions on the end date.
     #
@@ -1041,7 +1053,7 @@ module Aws::Budgets
     # Describes all of the budget actions for an account.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [Integer] :max_results
     #   An integer that represents how many entries a paginated response
@@ -1106,7 +1118,7 @@ module Aws::Budgets
     # Describes all of the budget actions for a budget.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -1177,7 +1189,7 @@ module Aws::Budgets
     # Budget history isn't available for `ANNUAL` budgets.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -1317,6 +1329,10 @@ module Aws::Budgets
     #   resp.budgets[0].calculated_spend.forecasted_spend.unit #=> String
     #   resp.budgets[0].budget_type #=> String, one of "USAGE", "COST", "RI_UTILIZATION", "RI_COVERAGE", "SAVINGS_PLANS_UTILIZATION", "SAVINGS_PLANS_COVERAGE"
     #   resp.budgets[0].last_updated_time #=> Time
+    #   resp.budgets[0].auto_adjust_data.auto_adjust_type #=> String, one of "HISTORICAL", "FORECAST"
+    #   resp.budgets[0].auto_adjust_data.historical_options.budget_adjustment_period #=> Integer
+    #   resp.budgets[0].auto_adjust_data.historical_options.look_back_available_periods #=> Integer
+    #   resp.budgets[0].auto_adjust_data.last_auto_adjust_time #=> Time
     #   resp.next_token #=> String
     #
     # @overload describe_budgets(params = {})
@@ -1436,7 +1452,7 @@ module Aws::Budgets
     # Executes a budget action.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -1481,8 +1497,8 @@ module Aws::Budgets
 
     # Updates a budget. You can change every part of a budget except for the
     # `budgetName` and the `calculatedSpend`. When you modify a budget, the
-    # `calculatedSpend` drops to zero until AWS has new usage data to use
-    # for forecasting.
+    # `calculatedSpend` drops to zero until Amazon Web Services has new
+    # usage data to use for forecasting.
     #
     # Only one of `BudgetLimit` or `PlannedBudgetLimits` can be present in
     # the syntax at one time. Use the syntax that matches your case. The
@@ -1551,6 +1567,14 @@ module Aws::Budgets
     #       },
     #       budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE, SAVINGS_PLANS_UTILIZATION, SAVINGS_PLANS_COVERAGE
     #       last_updated_time: Time.now,
+    #       auto_adjust_data: {
+    #         auto_adjust_type: "HISTORICAL", # required, accepts HISTORICAL, FORECAST
+    #         historical_options: {
+    #           budget_adjustment_period: 1, # required
+    #           look_back_available_periods: 1,
+    #         },
+    #         last_auto_adjust_time: Time.now,
+    #       },
     #     },
     #   })
     #
@@ -1564,7 +1588,7 @@ module Aws::Budgets
     # Updates a budget action.
     #
     # @option params [required, String] :account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #
     # @option params [required, String] :budget_name
     #   A string that represents the budget name. The ":" and "\\"
@@ -1809,7 +1833,7 @@ module Aws::Budgets
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-budgets'
-      context[:gem_version] = '1.46.0'
+      context[:gem_version] = '1.47.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -25,7 +25,10 @@ module Aws::Budgets
     ActionThreshold = Shapes::StructureShape.new(name: 'ActionThreshold')
     ActionType = Shapes::StringShape.new(name: 'ActionType')
     Actions = Shapes::ListShape.new(name: 'Actions')
+    AdjustmentPeriod = Shapes::IntegerShape.new(name: 'AdjustmentPeriod')
     ApprovalModel = Shapes::StringShape.new(name: 'ApprovalModel')
+    AutoAdjustData = Shapes::StructureShape.new(name: 'AutoAdjustData')
+    AutoAdjustType = Shapes::StringShape.new(name: 'AutoAdjustType')
     Budget = Shapes::StructureShape.new(name: 'Budget')
     BudgetName = Shapes::StringShape.new(name: 'BudgetName')
     BudgetPerformanceHistory = Shapes::StructureShape.new(name: 'BudgetPerformanceHistory')
@@ -84,6 +87,7 @@ module Aws::Budgets
     GenericTimestamp = Shapes::TimestampShape.new(name: 'GenericTimestamp')
     Group = Shapes::StringShape.new(name: 'Group')
     Groups = Shapes::ListShape.new(name: 'Groups')
+    HistoricalOptions = Shapes::StructureShape.new(name: 'HistoricalOptions')
     IamActionDefinition = Shapes::StructureShape.new(name: 'IamActionDefinition')
     InstanceId = Shapes::StringShape.new(name: 'InstanceId')
     InstanceIds = Shapes::ListShape.new(name: 'InstanceIds')
@@ -167,6 +171,11 @@ module Aws::Budgets
 
     Actions.member = Shapes::ShapeRef.new(shape: Action)
 
+    AutoAdjustData.add_member(:auto_adjust_type, Shapes::ShapeRef.new(shape: AutoAdjustType, required: true, location_name: "AutoAdjustType"))
+    AutoAdjustData.add_member(:historical_options, Shapes::ShapeRef.new(shape: HistoricalOptions, location_name: "HistoricalOptions"))
+    AutoAdjustData.add_member(:last_auto_adjust_time, Shapes::ShapeRef.new(shape: GenericTimestamp, location_name: "LastAutoAdjustTime"))
+    AutoAdjustData.struct_class = Types::AutoAdjustData
+
     Budget.add_member(:budget_name, Shapes::ShapeRef.new(shape: BudgetName, required: true, location_name: "BudgetName"))
     Budget.add_member(:budget_limit, Shapes::ShapeRef.new(shape: Spend, location_name: "BudgetLimit"))
     Budget.add_member(:planned_budget_limits, Shapes::ShapeRef.new(shape: PlannedBudgetLimits, location_name: "PlannedBudgetLimits"))
@@ -177,6 +186,7 @@ module Aws::Budgets
     Budget.add_member(:calculated_spend, Shapes::ShapeRef.new(shape: CalculatedSpend, location_name: "CalculatedSpend"))
     Budget.add_member(:budget_type, Shapes::ShapeRef.new(shape: BudgetType, required: true, location_name: "BudgetType"))
     Budget.add_member(:last_updated_time, Shapes::ShapeRef.new(shape: GenericTimestamp, location_name: "LastUpdatedTime"))
+    Budget.add_member(:auto_adjust_data, Shapes::ShapeRef.new(shape: AutoAdjustData, location_name: "AutoAdjustData"))
     Budget.struct_class = Types::Budget
 
     BudgetPerformanceHistory.add_member(:budget_name, Shapes::ShapeRef.new(shape: BudgetName, location_name: "BudgetName"))
@@ -405,6 +415,10 @@ module Aws::Budgets
 
     Groups.member = Shapes::ShapeRef.new(shape: Group)
 
+    HistoricalOptions.add_member(:budget_adjustment_period, Shapes::ShapeRef.new(shape: AdjustmentPeriod, required: true, location_name: "BudgetAdjustmentPeriod"))
+    HistoricalOptions.add_member(:look_back_available_periods, Shapes::ShapeRef.new(shape: AdjustmentPeriod, location_name: "LookBackAvailablePeriods"))
+    HistoricalOptions.struct_class = Types::HistoricalOptions
+
     IamActionDefinition.add_member(:policy_arn, Shapes::ShapeRef.new(shape: PolicyArn, required: true, location_name: "PolicyArn"))
     IamActionDefinition.add_member(:roles, Shapes::ShapeRef.new(shape: Roles, location_name: "Roles"))
     IamActionDefinition.add_member(:groups, Shapes::ShapeRef.new(shape: Groups, location_name: "Groups"))

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

@@ -63,7 +63,7 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] status
-    #   The status of action.
+    #   The status of the action.
     #   @return [String]
     #
     # @!attribute [rw] subscribers
@@ -88,7 +88,7 @@ module Aws::Budgets
     # The historical records for a budget action.
     #
     # @!attribute [rw] timestamp
-    #   A generic time stamp. In Java, it is transformed to a `Date` object.
+    #   A generic time stamp. In Java, it's transformed to a `Date` object.
     #   @return [Time]
     #
     # @!attribute [rw] status
@@ -97,11 +97,11 @@ module Aws::Budgets
     #
     # @!attribute [rw] event_type
     #   This distinguishes between whether the events are triggered by the
-    #   user or generated by the system.
+    #   user or are generated by the system.
     #   @return [String]
     #
     # @!attribute [rw] action_history_details
-    #   The description of details of the event.
+    #   The description of the details for the event.
     #   @return [Types::ActionHistoryDetails]
     #
     class ActionHistory < Struct.new(
@@ -113,7 +113,7 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The description of details of the event.
+    # The description of the details for the event.
     #
     # @!attribute [rw] message
     #   A generic string.
@@ -155,11 +155,48 @@ module Aws::Budgets
       include Aws::Structure
     end
 
+    # The parameters that determine the budget amount for an auto-adjusting
+    # budget.
+    #
+    # @note When making an API call, you may pass AutoAdjustData
+    #   data as a hash:
+    #
+    #       {
+    #         auto_adjust_type: "HISTORICAL", # required, accepts HISTORICAL, FORECAST
+    #         historical_options: {
+    #           budget_adjustment_period: 1, # required
+    #           look_back_available_periods: 1,
+    #         },
+    #         last_auto_adjust_time: Time.now,
+    #       }
+    #
+    # @!attribute [rw] auto_adjust_type
+    #   The string that defines whether your budget auto-adjusts based on
+    #   historical or forecasted data.
+    #   @return [String]
+    #
+    # @!attribute [rw] historical_options
+    #   The parameters that define or describe the historical data that your
+    #   auto-adjusting budget is based on.
+    #   @return [Types::HistoricalOptions]
+    #
+    # @!attribute [rw] last_auto_adjust_time
+    #   The last time that your budget was auto-adjusted.
+    #   @return [Time]
+    #
+    class AutoAdjustData < Struct.new(
+      :auto_adjust_type,
+      :historical_options,
+      :last_auto_adjust_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Represents the output of the `CreateBudget` operation. The content
     # consists of the detailed metadata and data file information, and the
     # current status of the `budget` object.
     #
-    # This is the ARN pattern for a budget:
+    # This is the Amazon Resource Name (ARN) pattern for a budget:
     #
     # `arn:aws:budgets::AccountId:budget/budgetName`
     #
@@ -211,6 +248,14 @@ module Aws::Budgets
     #         },
     #         budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE, SAVINGS_PLANS_UTILIZATION, SAVINGS_PLANS_COVERAGE
     #         last_updated_time: Time.now,
+    #         auto_adjust_data: {
+    #           auto_adjust_type: "HISTORICAL", # required, accepts HISTORICAL, FORECAST
+    #           historical_options: {
+    #             budget_adjustment_period: 1, # required
+    #             look_back_available_periods: 1,
+    #           },
+    #           last_auto_adjust_time: Time.now,
+    #         },
     #       }
     #
     # @!attribute [rw] budget_name
@@ -225,8 +270,8 @@ module Aws::Budgets
     #
     #   `BudgetLimit` is required for cost or usage budgets, but optional
     #   for RI or Savings Plans utilization or coverage budgets. RI and
-    #   Savings Plans utilization or coverage budgets default to `100`,
-    #   which is the only valid value for RI or Savings Plans utilization or
+    #   Savings Plans utilization or coverage budgets default to `100`. This
+    #   is the only valid value for RI or Savings Plans utilization or
     #   coverage budgets. You can't use `BudgetLimit` with
     #   `PlannedBudgetLimits` for `CreateBudget` and `UpdateBudget` actions.
     #   @return [Types::Spend]
@@ -236,19 +281,20 @@ module Aws::Budgets
     #   limits.
     #
     #   `PlannedBudgetLimits` is available for cost or usage budget and
-    #   supports monthly and quarterly `TimeUnit`.
+    #   supports both monthly and quarterly `TimeUnit`.
     #
     #   For monthly budgets, provide 12 months of `PlannedBudgetLimits`
     #   values. This must start from the current month and include the next
     #   11 months. The `key` is the start of the month, `UTC` in epoch
     #   seconds.
     #
-    #   For quarterly budgets, provide 4 quarters of `PlannedBudgetLimits`
-    #   value entries in standard calendar quarter increments. This must
-    #   start from the current quarter and include the next 3 quarters. The
-    #   `key` is the start of the quarter, `UTC` in epoch seconds.
+    #   For quarterly budgets, provide four quarters of
+    #   `PlannedBudgetLimits` value entries in standard calendar quarter
+    #   increments. This must start from the current quarter and include the
+    #   next three quarters. The `key` is the start of the quarter, `UTC` in
+    #   epoch seconds.
     #
-    #   If the planned budget expires before 12 months for monthly or 4
+    #   If the planned budget expires before 12 months for monthly or four
     #   quarters for quarterly, provide the `PlannedBudgetLimits` values
     #   only for the remaining periods.
     #
@@ -261,21 +307,22 @@ module Aws::Budgets
     #   experience as a fixed budget.
     #
     #   `DescribeBudget` and `DescribeBudgets` response along with
-    #   `PlannedBudgetLimits` will also contain `BudgetLimit` representing
-    #   the current month or quarter limit present in `PlannedBudgetLimits`.
-    #   This only applies to budgets created with `PlannedBudgetLimits`.
-    #   Budgets created without `PlannedBudgetLimits` will only contain
-    #   `BudgetLimit`, and no `PlannedBudgetLimits`.
+    #   `PlannedBudgetLimits` also contain `BudgetLimit` representing the
+    #   current month or quarter limit present in `PlannedBudgetLimits`.
+    #   This only applies to budgets that are created with
+    #   `PlannedBudgetLimits`. Budgets that are created without
+    #   `PlannedBudgetLimits` only contain `BudgetLimit`. They don't
+    #   contain `PlannedBudgetLimits`.
     #   @return [Hash<String,Types::Spend>]
     #
     # @!attribute [rw] cost_filters
-    #   The cost filters, such as service or tag, that are applied to a
-    #   budget.
+    #   The cost filters, such as `Region`, `Service`, `member account`,
+    #   `Tag`, or `Cost Category`, that are applied to a budget.
     #
-    #   AWS Budgets supports the following services as a filter for RI
-    #   budgets:
+    #   Amazon Web Services Budgets supports the following services as a
+    #   `Service` filter for RI budgets:
     #
-    #   * Amazon Elastic Compute Cloud - Compute
+    #   * Amazon EC2
     #
     #   * Amazon Redshift
     #
@@ -283,7 +330,7 @@ module Aws::Budgets
     #
     #   * Amazon ElastiCache
     #
-    #   * Amazon Elasticsearch Service
+    #   * Amazon OpenSearch Service
     #   @return [Hash<String,Array<String>>]
     #
     # @!attribute [rw] cost_types
@@ -300,24 +347,25 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] time_period
-    #   The period of time that is covered by a budget. The period has a
-    #   start date and an end date. The start date must come before the end
-    #   date. The end date must come before `06/15/87 00:00 UTC`.
-    #
-    #   If you create your budget and don't specify a start date, AWS
-    #   defaults to the start of your chosen time period (DAILY, MONTHLY,
-    #   QUARTERLY, or ANNUALLY). For example, if you created your budget on
-    #   January 24, 2018, chose `DAILY`, and didn't set a start date, AWS
-    #   set your start date to `01/24/18 00:00 UTC`. If you chose `MONTHLY`,
-    #   AWS set your start date to `01/01/18 00:00 UTC`. If you didn't
-    #   specify an end date, AWS set your end date to `06/15/87 00:00 UTC`.
-    #   The defaults are the same for the AWS Billing and Cost Management
-    #   console and the API.
+    #   The period of time that's covered by a budget. You setthe start
+    #   date and end date. The start date must come before the end date. The
+    #   end date must come before `06/15/87 00:00 UTC`.
+    #
+    #   If you create your budget and don't specify a start date, Amazon
+    #   Web Services defaults to the start of your chosen time period
+    #   (DAILY, MONTHLY, QUARTERLY, or ANNUALLY). For example, if you
+    #   created your budget on January 24, 2018, chose `DAILY`, and didn't
+    #   set a start date, Amazon Web Services set your start date to
+    #   `01/24/18 00:00 UTC`. If you chose `MONTHLY`, Amazon Web Services
+    #   set your start date to `01/01/18 00:00 UTC`. If you didn't specify
+    #   an end date, Amazon Web Services set your end date to `06/15/87
+    #   00:00 UTC`. The defaults are the same for the Billing and Cost
+    #   Management console and the API.
     #
     #   You can change either date with the `UpdateBudget` operation.
     #
-    #   After the end date, AWS deletes the budget and all associated
-    #   notifications and subscribers.
+    #   After the end date, Amazon Web Services deletes the budget and all
+    #   the associated notifications and subscribers.
     #   @return [Types::TimePeriod]
     #
     # @!attribute [rw] calculated_spend
@@ -325,14 +373,19 @@ module Aws::Budgets
     #   @return [Types::CalculatedSpend]
     #
     # @!attribute [rw] budget_type
-    #   Whether this budget tracks costs, usage, RI utilization, RI
-    #   coverage, Savings Plans utilization, or Savings Plans coverage.
+    #   Specifies whether this budget tracks costs, usage, RI utilization,
+    #   RI coverage, Savings Plans utilization, or Savings Plans coverage.
     #   @return [String]
     #
     # @!attribute [rw] last_updated_time
     #   The last time that you updated this budget.
     #   @return [Time]
     #
+    # @!attribute [rw] auto_adjust_data
+    #   The parameters that determine the budget amount for an
+    #   auto-adjusting budget.
+    #   @return [Types::AutoAdjustData]
+    #
     class Budget < Struct.new(
       :budget_name,
       :budget_limit,
@@ -343,7 +396,8 @@ module Aws::Budgets
       :time_period,
       :calculated_spend,
       :budget_type,
-      :last_updated_time)
+      :last_updated_time,
+      :auto_adjust_data)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -379,7 +433,7 @@ module Aws::Budgets
     #
     # @!attribute [rw] budgeted_and_actual_amounts_list
     #   A list of amounts of cost or usage that you created budgets for,
-    #   compared to your actual costs or usage.
+    #   which are compared to your actual costs or usage.
     #   @return [Array<Types::BudgetedAndActualAmounts>]
     #
     class BudgetPerformanceHistory < Struct.new(
@@ -405,7 +459,7 @@ module Aws::Budgets
     #   @return [Types::Spend]
     #
     # @!attribute [rw] time_period
-    #   The time period covered by this budget comparison.
+    #   The time period that's covered by this budget comparison.
     #   @return [Types::TimePeriod]
     #
     class BudgetedAndActualAmounts < Struct.new(
@@ -418,10 +472,10 @@ module Aws::Budgets
 
     # The spend objects that are associated with this budget. The
     # `actualSpend` tracks how much you've used, cost, usage, RI units, or
-    # Savings Plans units and the `forecastedSpend` tracks how much you are
-    # predicted to spend based on your historical usage profile.
+    # Savings Plans units and the `forecastedSpend` tracks how much that
+    # you're predicted to spend based on your historical usage profile.
     #
-    # For example, if it is the 20th of the month and you have spent `50`
+    # For example, if it's the 20th of the month and you have spent `50`
     # dollars on Amazon EC2, your `actualSpend` is `50 USD`, and your
     # `forecastedSpend` is `75 USD`.
     #
@@ -441,12 +495,12 @@ module Aws::Budgets
     #
     # @!attribute [rw] actual_spend
     #   The amount of cost, usage, RI units, or Savings Plans units that you
-    #   have used.
+    #   used.
     #   @return [Types::Spend]
     #
     # @!attribute [rw] forecasted_spend
-    #   The amount of cost, usage, RI units, or Savings Plans units that you
-    #   are forecasted to use.
+    #   The amount of cost, usage, RI units, or Savings Plans units that
+    #   you're forecasted to use.
     #   @return [Types::Spend]
     #
     class CalculatedSpend < Struct.new(
@@ -460,7 +514,7 @@ module Aws::Budgets
     # and subscriptions.
     #
     # `USAGE`, `RI_UTILIZATION`, `RI_COVERAGE`, `SAVINGS_PLANS_UTILIZATION`,
-    # and `SAVINGS_PLANS_COVERAGE` budgets do not have `CostTypes`.
+    # and `SAVINGS_PLANS_COVERAGE` budgets don't have `CostTypes`.
     #
     # @note When making an API call, you may pass CostTypes
     #   data as a hash:
@@ -602,7 +656,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -656,7 +710,7 @@ module Aws::Budgets
     end
 
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -729,6 +783,14 @@ module Aws::Budgets
     #           },
     #           budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE, SAVINGS_PLANS_UTILIZATION, SAVINGS_PLANS_COVERAGE
     #           last_updated_time: Time.now,
+    #           auto_adjust_data: {
+    #             auto_adjust_type: "HISTORICAL", # required, accepts HISTORICAL, FORECAST
+    #             historical_options: {
+    #               budget_adjustment_period: 1, # required
+    #               look_back_available_periods: 1,
+    #             },
+    #             last_auto_adjust_time: Time.now,
+    #           },
     #         },
     #         notifications_with_subscribers: [
     #           {
@@ -761,8 +823,8 @@ module Aws::Budgets
     #   A notification that you want to associate with a budget. A budget
     #   can have up to five notifications, and each notification can have
     #   one SNS subscriber and up to 10 email subscribers. If you include
-    #   notifications and subscribers in your `CreateBudget` call, AWS
-    #   creates the notifications and subscribers for you.
+    #   notifications and subscribers in your `CreateBudget` call, Amazon
+    #   Web Services creates the notifications and subscribers for you.
     #   @return [Array<Types::NotificationWithSubscribers>]
     #
     class CreateBudgetRequest < Struct.new(
@@ -806,8 +868,8 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] budget_name
-    #   The name of the budget that you want AWS to notify you about. Budget
-    #   names must be unique within an account.
+    #   The name of the budget that you want Amazon Web Services to notify
+    #   you about. Budget names must be unique within an account.
     #   @return [String]
     #
     # @!attribute [rw] notification
@@ -922,8 +984,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] iam_action_definition
-    #   The AWS Identity and Access Management (IAM) action definition
-    #   details.
+    #   The Identity and Access Management (IAM) action definition details.
     #   @return [Types::IamActionDefinition]
     #
     # @!attribute [rw] scp_action_definition
@@ -931,7 +992,8 @@ module Aws::Budgets
     #   @return [Types::ScpActionDefinition]
     #
     # @!attribute [rw] ssm_action_definition
-    #   The AWS Systems Manager (SSM) action definition details.
+    #   The Amazon Web Services Systems Manager (SSM) action definition
+    #   details.
     #   @return [Types::SsmActionDefinition]
     #
     class Definition < Struct.new(
@@ -952,7 +1014,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -974,7 +1036,7 @@ module Aws::Budgets
     end
 
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1133,7 +1195,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1147,7 +1209,7 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] time_period
-    #   The period of time that is covered by a budget. The period has a
+    #   The period of time that's covered by a budget. The period has a
     #   start date and an end date. The start date must come before the end
     #   date. There are no restrictions on the end date.
     #   @return [Types::TimePeriod]
@@ -1197,7 +1259,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1219,7 +1281,7 @@ module Aws::Budgets
     end
 
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1249,7 +1311,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] max_results
@@ -1295,7 +1357,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1351,7 +1413,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1646,7 +1708,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1673,7 +1735,7 @@ module Aws::Budgets
     end
 
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -1711,8 +1773,56 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The AWS Identity and Access Management (IAM) action definition
-    # details.
+    # The parameters that define or describe the historical data that your
+    # auto-adjusting budget is based on.
+    #
+    # @note When making an API call, you may pass HistoricalOptions
+    #   data as a hash:
+    #
+    #       {
+    #         budget_adjustment_period: 1, # required
+    #         look_back_available_periods: 1,
+    #       }
+    #
+    # @!attribute [rw] budget_adjustment_period
+    #   The number of budget periods included in the moving-average
+    #   calculation that determines your auto-adjusted budget amount. The
+    #   maximum value depends on the `TimeUnit` granularity of the budget:
+    #
+    #   * For the `DAILY` granularity, the maximum value is `60`.
+    #
+    #   * For the `MONTHLY` granularity, the maximum value is `12`.
+    #
+    #   * For the `QUARTERLY` granularity, the maximum value is `4`.
+    #
+    #   * For the `ANNUALLY` granularity, the maximum value is `1`.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] look_back_available_periods
+    #   The integer that describes how many budget periods in your
+    #   `BudgetAdjustmentPeriod` are included in the calculation of your
+    #   current `BudgetLimit`. If the first budget period in your
+    #   `BudgetAdjustmentPeriod` has no cost data, then that budget period
+    #   isn’t included in the average that determines your budget limit.
+    #
+    #   For example, if you set `BudgetAdjustmentPeriod` as `4` quarters,
+    #   but your account had no cost data in the first quarter, then only
+    #   the last three quarters are included in the calculation. In this
+    #   scenario, `LookBackAvailablePeriods` returns `3`.
+    #
+    #   You can’t set your own `LookBackAvailablePeriods`. The value is
+    #   automatically calculated from the `BudgetAdjustmentPeriod` and your
+    #   historical cost data.
+    #   @return [Integer]
+    #
+    class HistoricalOptions < Struct.new(
+      :budget_adjustment_period,
+      :look_back_available_periods)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The Identity and Access Management (IAM) action definition details.
     #
     # @note When making an API call, you may pass IamActionDefinition
     #   data as a hash:
@@ -1799,7 +1909,7 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # A notification that is associated with a budget. A budget can have up
+    # A notification that's associated with a budget. A budget can have up
     # to ten notifications.
     #
     # Each notification must have at least one subscriber. A notification
@@ -1830,16 +1940,17 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] notification_type
-    #   Whether the notification is for how much you have spent (`ACTUAL`)
-    #   or for how much you're forecasted to spend (`FORECASTED`).
+    #   Specifies whether the notification is for how much you have spent
+    #   (`ACTUAL`) or for how much that you're forecasted to spend
+    #   (`FORECASTED`).
     #   @return [String]
     #
     # @!attribute [rw] comparison_operator
-    #   The comparison that is used for this notification.
+    #   The comparison that's used for this notification.
     #   @return [String]
     #
     # @!attribute [rw] threshold
-    #   The threshold that is associated with a notification. Thresholds are
+    #   The threshold that's associated with a notification. Thresholds are
     #   always a percentage, and many customers find value being alerted
     #   between 50% - 200% of the budgeted amount. The maximum limit for
     #   your threshold is 1,000,000% above the budgeted amount.
@@ -1847,18 +1958,19 @@ module Aws::Budgets
     #
     # @!attribute [rw] threshold_type
     #   The type of threshold for a notification. For `ABSOLUTE_VALUE`
-    #   thresholds, AWS notifies you when you go over or are forecasted to
-    #   go over your total cost threshold. For `PERCENTAGE` thresholds, AWS
-    #   notifies you when you go over or are forecasted to go over a certain
-    #   percentage of your forecasted spend. For example, if you have a
-    #   budget for 200 dollars and you have a `PERCENTAGE` threshold of 80%,
-    #   AWS notifies you when you go over 160 dollars.
+    #   thresholds, Amazon Web Services notifies you when you go over or are
+    #   forecasted to go over your total cost threshold. For `PERCENTAGE`
+    #   thresholds, Amazon Web Services notifies you when you go over or are
+    #   forecasted to go over a certain percentage of your forecasted spend.
+    #   For example, if you have a budget for 200 dollars and you have a
+    #   `PERCENTAGE` threshold of 80%, Amazon Web Services notifies you when
+    #   you go over 160 dollars.
     #   @return [String]
     #
     # @!attribute [rw] notification_state
-    #   Whether this notification is in alarm. If a budget notification is
-    #   in the `ALARM` state, you have passed the set threshold for the
-    #   budget.
+    #   Specifies whether this notification is in alarm. If a budget
+    #   notification is in the `ALARM` state, you passed the set threshold
+    #   for the budget.
     #   @return [String]
     #
     class Notification < Struct.new(
@@ -1895,7 +2007,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] notification
-    #   The notification that is associated with a budget.
+    #   The notification that's associated with a budget.
     #   @return [Types::Notification]
     #
     # @!attribute [rw] subscribers
@@ -1947,9 +2059,9 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The amount of cost or usage that is measured for a budget.
+    # The amount of cost or usage that's measured for a budget.
     #
-    # For example, a `Spend` for `3 GB` of S3 usage would have the following
+    # For example, a `Spend` for `3 GB` of S3 usage has the following
     # parameters:
     #
     # * An `Amount` of `3`
@@ -1965,13 +2077,13 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] amount
-    #   The cost or usage amount that is associated with a budget forecast,
+    #   The cost or usage amount that's associated with a budget forecast,
     #   actual spend, or budget threshold.
     #   @return [String]
     #
     # @!attribute [rw] unit
-    #   The unit of measurement that is used for the budget forecast, actual
-    #   spend, or budget threshold, such as dollars or GB.
+    #   The unit of measurement that's used for the budget forecast, actual
+    #   spend, or budget threshold, such as USD or GBP.
     #   @return [String]
     #
     class Spend < Struct.new(
@@ -1981,7 +2093,8 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The AWS Systems Manager (SSM) action definition details.
+    # The Amazon Web Services Systems Manager (SSM) action definition
+    # details.
     #
     # @note When making an API call, you may pass SsmActionDefinition
     #   data as a hash:
@@ -2015,7 +2128,7 @@ module Aws::Budgets
     # The subscriber to a budget notification. The subscriber consists of a
     # subscription type and either an Amazon SNS topic or an email address.
     #
-    # For example, an email subscriber would have the following parameters:
+    # For example, an email subscriber has the following parameters:
     #
     # * A `subscriptionType` of `EMAIL`
     #
@@ -2030,12 +2143,13 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] subscription_type
-    #   The type of notification that AWS sends to a subscriber.
+    #   The type of notification that Amazon Web Services sends to a
+    #   subscriber.
     #   @return [String]
     #
     # @!attribute [rw] address
-    #   The address that AWS sends budget notifications to, either an SNS
-    #   topic or an email.
+    #   The address that Amazon Web Services sends budget notifications to,
+    #   either an SNS topic or an email.
     #
     #   When you create a subscriber, the value of `Address` can't contain
     #   line breaks.
@@ -2048,7 +2162,7 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The period of time that is covered by a budget. The period has a start
+    # The period of time that's covered by a budget. The period has a start
     # date and an end date. The start date must come before the end date.
     # There are no restrictions on the end date.
     #
@@ -2062,25 +2176,27 @@ module Aws::Budgets
     #
     # @!attribute [rw] start
     #   The start date for a budget. If you created your budget and didn't
-    #   specify a start date, AWS defaults to the start of your chosen time
-    #   period (DAILY, MONTHLY, QUARTERLY, or ANNUALLY). For example, if you
-    #   created your budget on January 24, 2018, chose `DAILY`, and didn't
-    #   set a start date, AWS set your start date to `01/24/18 00:00 UTC`.
-    #   If you chose `MONTHLY`, AWS set your start date to `01/01/18 00:00
-    #   UTC`. The defaults are the same for the AWS Billing and Cost
-    #   Management console and the API.
+    #   specify a start date, Amazon Web Services defaults to the start of
+    #   your chosen time period (DAILY, MONTHLY, QUARTERLY, or ANNUALLY).
+    #   For example, if you created your budget on January 24, 2018, chose
+    #   `DAILY`, and didn't set a start date, Amazon Web Services set your
+    #   start date to `01/24/18 00:00 UTC`. If you chose `MONTHLY`, Amazon
+    #   Web Services set your start date to `01/01/18 00:00 UTC`. The
+    #   defaults are the same for the Billing and Cost Management console
+    #   and the API.
     #
     #   You can change your start date with the `UpdateBudget` operation.
     #   @return [Time]
     #
     # @!attribute [rw] end
-    #   The end date for a budget. If you didn't specify an end date, AWS
-    #   set your end date to `06/15/87 00:00 UTC`. The defaults are the same
-    #   for the AWS Billing and Cost Management console and the API.
-    #
-    #   After the end date, AWS deletes the budget and all associated
-    #   notifications and subscribers. You can change your end date with the
-    #   `UpdateBudget` operation.
+    #   The end date for a budget. If you didn't specify an end date,
+    #   Amazon Web Services set your end date to `06/15/87 00:00 UTC`. The
+    #   defaults are the same for the Billing and Cost Management console
+    #   and the API.
+    #
+    #   After the end date, Amazon Web Services deletes the budget and all
+    #   the associated notifications and subscribers. You can change your
+    #   end date with the `UpdateBudget` operation.
     #   @return [Time]
     #
     class TimePeriod < Struct.new(
@@ -2130,7 +2246,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -2183,7 +2299,7 @@ module Aws::Budgets
     end
 
     # @!attribute [rw] account_id
-    #   The account ID of the user. It should be a 12-digit number.
+    #   The account ID of the user. It's a 12-digit number.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -2260,6 +2376,14 @@ module Aws::Budgets
     #           },
     #           budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE, SAVINGS_PLANS_UTILIZATION, SAVINGS_PLANS_COVERAGE
     #           last_updated_time: Time.now,
+    #           auto_adjust_data: {
+    #             auto_adjust_type: "HISTORICAL", # required, accepts HISTORICAL, FORECAST
+    #             historical_options: {
+    #               budget_adjustment_period: 1, # required
+    #               look_back_available_periods: 1,
+    #             },
+    #             last_auto_adjust_time: Time.now,
+    #           },
     #         },
     #       }
     #

data/lib/aws-sdk-budgets.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-budgets/customizations'
 # @!group service
 module Aws::Budgets
 
-  GEM_VERSION = '1.46.0'
+  GEM_VERSION = '1.47.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-budgets
 version: !ruby/object:Gem::Version
-  version: 1.46.0
+  version: 1.47.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-03 00:00:00.000000000 Z
+date: 2022-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core