aws-sdk-budgets 1.21.0 → 1.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ecd29d372b0f19bdf5560642d25b69eb037be6a8
-  data.tar.gz: fe3ad247ea9f9054bc07cc9d0f50bf57040e0e3f
+  metadata.gz: 53f101519382ebf93b26190490808b0e8be78da5
+  data.tar.gz: 950aaed2811ee94d952b134d39cd29406cfa1c62
 SHA512:
-  metadata.gz: 4c583e0b87c0bcf0287d27921d1c98173a7c71929cf4b8c7e5117507f5385e4bc0d6d1ed48a3b0c74aa38bd3eaf51b3359c8e690e02c436ff5c4d109882f41b5
-  data.tar.gz: 5ba8f0915d009e3b8399e7a575b9ca967fdadf45f383608d771f2dd7ba4a446832ad4c34bc25b47671d5983b005428bd073aac937ff6abec21d9d05435c7bd4d
+  metadata.gz: 5a3a7acdab7807fcd926ab63a261cb6f2bf7618d3707c2ac9b59a60c1a9a1132fb0d0f411e8b08a25db2203741e1d7b228fcf9d7bfe64a1e3bf4054f0c389e21
+  data.tar.gz: a531bf20c08dfc04650fe0922047f9fcf5187e5f3d7ed2db18286da2fe3077582841c06ca13f7beea269d6b542bb9635c34d9f3f09965c3278033d4bd31543a2

data/lib/aws-sdk-budgets.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-budgets/customizations'
 # @service
 module Aws::Budgets
 
-  GEM_VERSION = '1.21.0'
+  GEM_VERSION = '1.22.0'
 
 end

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

@@ -262,6 +262,15 @@ module Aws::Budgets
 
     # Creates a budget and, if included, notifications and subscribers.
     #
+    # Only one of `BudgetLimit` or `PlannedBudgetLimits` can be present in
+    # the syntax at one time. Use the syntax that matches your case. The
+    # Request Syntax section shows the `BudgetLimit` syntax. For
+    # `PlannedBudgetLimits`, see the [Examples][1] section.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_CreateBudget.html#API_CreateBudget_Examples
+    #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget.
     #
@@ -287,6 +296,12 @@ module Aws::Budgets
     #         amount: "NumericValue", # required
     #         unit: "UnitValue", # required
     #       },
+    #       planned_budget_limits: {
+    #         "GenericString" => {
+    #           amount: "NumericValue", # required
+    #           unit: "UnitValue", # required
+    #         },
+    #       },
     #       cost_filters: {
     #         "GenericString" => ["GenericString"],
     #       },
@@ -552,6 +567,13 @@ module Aws::Budgets
 
     # Describes a budget.
     #
+    # The Request Syntax section shows the `BudgetLimit` syntax. For
+    # `PlannedBudgetLimits`, see the [Examples][1] section.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_DescribeBudget.html#API_DescribeBudget_Examples
+    #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget that you want a
     #   description of.
@@ -575,6 +597,9 @@ module Aws::Budgets
     #   resp.budget.budget_name #=> String
     #   resp.budget.budget_limit.amount #=> String
     #   resp.budget.budget_limit.unit #=> String
+    #   resp.budget.planned_budget_limits #=> Hash
+    #   resp.budget.planned_budget_limits["GenericString"].amount #=> String
+    #   resp.budget.planned_budget_limits["GenericString"].unit #=> String
     #   resp.budget.cost_filters #=> Hash
     #   resp.budget.cost_filters["GenericString"] #=> Array
     #   resp.budget.cost_filters["GenericString"][0] #=> String
@@ -682,6 +707,13 @@ module Aws::Budgets
 
     # Lists the budgets that are associated with an account.
     #
+    # The Request Syntax section shows the `BudgetLimit` syntax. For
+    # `PlannedBudgetLimits`, see the [Examples][1] section.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_DescribeBudgets.html#API_DescribeBudgets_Examples
+    #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budgets that you want
     #   descriptions of.
@@ -713,6 +745,9 @@ module Aws::Budgets
     #   resp.budgets[0].budget_name #=> String
     #   resp.budgets[0].budget_limit.amount #=> String
     #   resp.budgets[0].budget_limit.unit #=> String
+    #   resp.budgets[0].planned_budget_limits #=> Hash
+    #   resp.budgets[0].planned_budget_limits["GenericString"].amount #=> String
+    #   resp.budgets[0].planned_budget_limits["GenericString"].unit #=> String
     #   resp.budgets[0].cost_filters #=> Hash
     #   resp.budgets[0].cost_filters["GenericString"] #=> Array
     #   resp.budgets[0].cost_filters["GenericString"][0] #=> String
@@ -853,6 +888,15 @@ module Aws::Budgets
     # `calculatedSpend` drops to zero until AWS 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
+    # Request Syntax section shows the `BudgetLimit` syntax. For
+    # `PlannedBudgetLimits`, see the [Examples][1] section.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_budgets_UpdateBudget.html#API_UpdateBudget_Examples
+    #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget that you want to
     #   update.
@@ -872,6 +916,12 @@ module Aws::Budgets
     #         amount: "NumericValue", # required
     #         unit: "UnitValue", # required
     #       },
+    #       planned_budget_limits: {
+    #         "GenericString" => {
+    #           amount: "NumericValue", # required
+    #           unit: "UnitValue", # required
+    #         },
+    #       },
     #       cost_filters: {
     #         "GenericString" => ["GenericString"],
     #       },
@@ -1022,7 +1072,7 @@ module Aws::Budgets
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-budgets'
-      context[:gem_version] = '1.21.0'
+      context[:gem_version] = '1.22.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -65,6 +65,7 @@ module Aws::Budgets
     Notifications = Shapes::ListShape.new(name: 'Notifications')
     NullableBoolean = Shapes::BooleanShape.new(name: 'NullableBoolean')
     NumericValue = Shapes::StringShape.new(name: 'NumericValue')
+    PlannedBudgetLimits = Shapes::MapShape.new(name: 'PlannedBudgetLimits')
     Spend = Shapes::StructureShape.new(name: 'Spend')
     Subscriber = Shapes::StructureShape.new(name: 'Subscriber')
     SubscriberAddress = Shapes::StringShape.new(name: 'SubscriberAddress')
@@ -84,6 +85,7 @@ module Aws::Budgets
 
     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"))
     Budget.add_member(:cost_filters, Shapes::ShapeRef.new(shape: CostFilters, location_name: "CostFilters"))
     Budget.add_member(:cost_types, Shapes::ShapeRef.new(shape: CostTypes, location_name: "CostTypes"))
     Budget.add_member(:time_unit, Shapes::ShapeRef.new(shape: TimeUnit, required: true, location_name: "TimeUnit"))
@@ -260,6 +262,9 @@ module Aws::Budgets
 
     Notifications.member = Shapes::ShapeRef.new(shape: Notification)
 
+    PlannedBudgetLimits.key = Shapes::ShapeRef.new(shape: GenericString)
+    PlannedBudgetLimits.value = Shapes::ShapeRef.new(shape: Spend)
+
     Spend.add_member(:amount, Shapes::ShapeRef.new(shape: NumericValue, required: true, location_name: "Amount"))
     Spend.add_member(:unit, Shapes::ShapeRef.new(shape: UnitValue, required: true, location_name: "Unit"))
     Spend.struct_class = Types::Spend

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

@@ -25,6 +25,12 @@ module Aws::Budgets
     #           amount: "NumericValue", # required
     #           unit: "UnitValue", # required
     #         },
+    #         planned_budget_limits: {
+    #           "GenericString" => {
+    #             amount: "NumericValue", # required
+    #             unit: "UnitValue", # required
+    #           },
+    #         },
     #         cost_filters: {
     #           "GenericString" => ["GenericString"],
     #         },
@@ -61,7 +67,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] budget_name
-    #   The name of a budget. The name must be unique within accounts. The
+    #   The name of a budget. The name must be unique within an account. The
     #   `:` and `` characters aren't allowed in `BudgetName`.
     #   @return [String]
     #
@@ -72,11 +78,49 @@ module Aws::Budgets
     #   `BudgetLimit` is required for cost or usage budgets, but optional
     #   for RI utilization or coverage budgets. RI utilization or coverage
     #   budgets default to `100`, which is the only valid value for RI
-    #   utilization or coverage budgets.
+    #   utilization or coverage budgets. You can't use `BudgetLimit` with
+    #   `PlannedBudgetLimits` for `CreateBudget` and `UpdateBudget` actions.
     #   @return [Types::Spend]
     #
+    # @!attribute [rw] planned_budget_limits
+    #   A map containing multiple `BudgetLimit`, including current or future
+    #   limits.
+    #
+    #   `PlannedBudgetLimits` is available for cost or usage budget and
+    #   supports 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.
+    #
+    #   If the planned budget expires before 12 months for monthly or 4
+    #   quarters for quarterly, provide the `PlannedBudgetLimits` values
+    #   only for the remaining periods.
+    #
+    #   If the budget begins at a date in the future, provide
+    #   `PlannedBudgetLimits` values from the start date of the budget.
+    #
+    #   After all of the `BudgetLimit` values in `PlannedBudgetLimits` are
+    #   used, the budget continues to use the last limit as the
+    #   `BudgetLimit`. At that point, the planned budget provides the same
+    #   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`.
+    #   @return [Hash<String,Types::Spend>]
+    #
     # @!attribute [rw] cost_filters
-    #   The cost filters, such as service or region, that are applied to a
+    #   The cost filters, such as service or tag, that are applied to a
     #   budget.
     #
     #   AWS Budgets supports the following services as a filter for RI
@@ -132,8 +176,8 @@ module Aws::Budgets
     #   @return [Types::CalculatedSpend]
     #
     # @!attribute [rw] budget_type
-    #   Whether this budget tracks monetary costs, usage, RI utilization, or
-    #   RI coverage.
+    #   Whether this budget tracks costs, usage, RI utilization, or RI
+    #   coverage.
     #   @return [String]
     #
     # @!attribute [rw] last_updated_time
@@ -143,6 +187,7 @@ module Aws::Budgets
     class Budget < Struct.new(
       :budget_name,
       :budget_limit,
+      :planned_budget_limits,
       :cost_filters,
       :cost_types,
       :time_unit,
@@ -374,6 +419,12 @@ module Aws::Budgets
     #             amount: "NumericValue", # required
     #             unit: "UnitValue", # required
     #           },
+    #           planned_budget_limits: {
+    #             "GenericString" => {
+    #               amount: "NumericValue", # required
+    #               unit: "UnitValue", # required
+    #             },
+    #           },
     #           cost_filters: {
     #             "GenericString" => ["GenericString"],
     #           },
@@ -1200,6 +1251,9 @@ module Aws::Budgets
     # @!attribute [rw] address
     #   The address that AWS sends budget notifications to, either an SNS
     #   topic or an email.
+    #
+    #   AWS validates the address for a `CreateSubscriber` request with the
+    #   `.*` regex.
     #   @return [String]
     #
     class Subscriber < Struct.new(
@@ -1262,6 +1316,12 @@ module Aws::Budgets
     #             amount: "NumericValue", # required
     #             unit: "UnitValue", # required
     #           },
+    #           planned_budget_limits: {
+    #             "GenericString" => {
+    #               amount: "NumericValue", # required
+    #               unit: "UnitValue", # required
+    #             },
+    #           },
     #           cost_filters: {
     #             "GenericString" => ["GenericString"],
     #           },

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-budgets
 version: !ruby/object:Gem::Version
-  version: 1.21.0
+  version: 1.22.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-21 00:00:00.000000000 Z
+date: 2019-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core