aws-sdk-budgets 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 34a0d598171f0dc36b11bc6591328dd61d2af2ec
-  data.tar.gz: 892db5e6714d23aec1b538579543662d3bd58e77
+  metadata.gz: 0543f32f12a8ed8f6dba8a52bb1773bce8f8e34a
+  data.tar.gz: bf7de44f7bec97aac02a8a1a040d907e6158821c
 SHA512:
-  metadata.gz: 5c4142f609014932ff33f9cab3303ebd2daf5ca34f7b46e9aa518755ef5d2bb33468064e85297286e648924791f3a5730dc32f74d74bafdb1be0804912243905
-  data.tar.gz: ed67155bded3b1de540462d3eef6bbeecaa4155cb12c3e92518ddf162eaad4a0ec02a3263f04f6b0049958e69a7e0248ca6270199d949781393805cee327cdda
+  metadata.gz: 5eed0bc6bf4f7818c945fde6f8b4f373f49e38b4c3144c4066bea632079fdeaa17c89c2ef04b9f2bdf685c248ad0b357ea6b2fd2b7455b9c111ba90354dc3d05
+  data.tar.gz: f7e653ac0d6d5ef387027c1efcd3907e5886d3a33f4d8b1a069949942e4d65f445e03270334abeccdf0455a29a73e472c3996530e22c0697546b22df4d335369

data/lib/aws-sdk-budgets.rb

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

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

@@ -15,6 +15,7 @@ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
 require 'aws-sdk-core/plugins/retry_errors.rb'
 require 'aws-sdk-core/plugins/global_configuration.rb'
 require 'aws-sdk-core/plugins/regional_endpoint.rb'
+require 'aws-sdk-core/plugins/endpoint_discovery.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
@@ -45,6 +46,7 @@ module Aws::Budgets
     add_plugin(Aws::Plugins::RetryErrors)
     add_plugin(Aws::Plugins::GlobalConfiguration)
     add_plugin(Aws::Plugins::RegionalEndpoint)
+    add_plugin(Aws::Plugins::EndpointDiscovery)
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
@@ -98,6 +100,10 @@ module Aws::Budgets
     #
     #   @option options [String] :access_key_id
     #
+    #   @option options [Boolean] :active_endpoint_cache (false)
+    #     When set to `true`, a thread polling for endpoints will be running in
+    #     the background every 60 secs (default). Defaults to `false`.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -123,6 +129,21 @@ module Aws::Budgets
     #     option. You should only configure an `:endpoint` when connecting
     #     to test endpoints. This should be avalid HTTP(S) URI.
     #
+    #   @option options [Integer] :endpoint_cache_max_entries (1000)
+    #     Used for the maximum size limit of the LRU cache storing endpoints data
+    #     for endpoint discovery enabled operations. Defaults to 1000.
+    #
+    #   @option options [Integer] :endpoint_cache_max_threads (10)
+    #     Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
+    #
+    #   @option options [Integer] :endpoint_cache_poll_interval (60)
+    #     When :endpoint_discovery and :active_endpoint_cache is enabled,
+    #     Use this option to config the time interval in seconds for making
+    #     requests fetching endpoints information. Defaults to 60 sec.
+    #
+    #   @option options [Boolean] :endpoint_discovery (false)
+    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
     #
@@ -199,7 +220,7 @@ module Aws::Budgets
     # @option params [Array<Types::NotificationWithSubscribers>] :notifications_with_subscribers
     #   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 ten email subscribers. If you include
+    #   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.
     #
@@ -247,6 +268,7 @@ module Aws::Budgets
     #         },
     #       },
     #       budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE
+    #       last_updated_time: Time.now,
     #     },
     #     notifications_with_subscribers: [
     #       {
@@ -255,6 +277,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         subscribers: [ # required
     #           {
@@ -281,7 +304,7 @@ module Aws::Budgets
     #   create a notification for.
     #
     # @option params [required, String] :budget_name
-    #   The name of the budget that you want AWS to notified you about. Budget
+    #   The name of the budget that you want AWS to notify you about. Budget
     #   names must be unique within an account.
     #
     # @option params [required, Types::Notification] :notification
@@ -290,7 +313,7 @@ module Aws::Budgets
     # @option params [required, Array<Types::Subscriber>] :subscribers
     #   A list of subscribers that you want to associate with the
     #   notification. Each notification can have one SNS subscriber and up to
-    #   ten email subscribers.
+    #   10 email subscribers.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -304,6 +327,7 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #     subscribers: [ # required
     #       {
@@ -324,8 +348,8 @@ module Aws::Budgets
     # notification before you create the subscriber.
     #
     # @option params [required, String] :account_id
-    #   The `accountId` associated with the budget that you want to create a
-    #   subscriber for.
+    #   The `accountId` that is associated with the budget that you want to
+    #   create a subscriber for.
     #
     # @option params [required, String] :budget_name
     #   The name of the budget that you want to subscribe to. Budget names
@@ -349,6 +373,7 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #     subscriber: { # required
     #       subscription_type: "SNS", # required, accepts SNS, EMAIL
@@ -365,8 +390,8 @@ module Aws::Budgets
 
     # Deletes a budget. You can delete your budget at any time.
     #
-    # **Deleting a budget also deletes the notifications and subscribers
-    # associated with that budget.**
+    # Deleting a budget also deletes the notifications and subscribers that
+    # are associated with that budget.
     #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget that you want to
@@ -393,8 +418,8 @@ module Aws::Budgets
 
     # Deletes a notification.
     #
-    # **Deleting a notification also deletes the subscribers associated with
-    # the notification.**
+    # Deleting a notification also deletes the subscribers that are
+    # associated with the notification.
     #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget whose notification
@@ -418,6 +443,7 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #   })
     #
@@ -430,8 +456,8 @@ module Aws::Budgets
 
     # Deletes a subscriber.
     #
-    # **Deleting the last subscriber to a notification also deletes the
-    # notification.**
+    # Deleting the last subscriber to a notification also deletes the
+    # notification.
     #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget whose subscriber
@@ -458,6 +484,7 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #     subscriber: { # required
     #       subscription_type: "SNS", # required, accepts SNS, EMAIL
@@ -519,6 +546,7 @@ module Aws::Budgets
     #   resp.budget.calculated_spend.forecasted_spend.amount #=> String
     #   resp.budget.calculated_spend.forecasted_spend.unit #=> String
     #   resp.budget.budget_type #=> String, one of "USAGE", "COST", "RI_UTILIZATION", "RI_COVERAGE"
+    #   resp.budget.last_updated_time #=> Time
     #
     # @overload describe_budget(params = {})
     # @param [Hash] params ({})
@@ -527,19 +555,93 @@ module Aws::Budgets
       req.send_request(options)
     end
 
-    # Lists the budgets associated with an account.
+    # Describes the history for `DAILY`, `MONTHLY`, and `QUARTERLY` 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.
+    #
+    # @option params [required, String] :budget_name
+    #   A string that represents the budget name. The ":" and "\\"
+    #   characters aren't allowed.
+    #
+    # @option params [Types::TimePeriod] :time_period
+    #   Retrieves how often the budget went into an `ALARM` state for the
+    #   specified time period.
+    #
+    # @option params [Integer] :max_results
+    #   An integer that represents how many entries a paginated response
+    #   contains. The maximum is 100.
+    #
+    # @option params [String] :next_token
+    #   A generic string.
+    #
+    # @return [Types::DescribeBudgetPerformanceHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeBudgetPerformanceHistoryResponse#budget_performance_history #budget_performance_history} => Types::BudgetPerformanceHistory
+    #   * {Types::DescribeBudgetPerformanceHistoryResponse#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_budget_performance_history({
+    #     account_id: "AccountId", # required
+    #     budget_name: "BudgetName", # required
+    #     time_period: {
+    #       start: Time.now,
+    #       end: Time.now,
+    #     },
+    #     max_results: 1,
+    #     next_token: "GenericString",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.budget_performance_history.budget_name #=> String
+    #   resp.budget_performance_history.budget_type #=> String, one of "USAGE", "COST", "RI_UTILIZATION", "RI_COVERAGE"
+    #   resp.budget_performance_history.cost_filters #=> Hash
+    #   resp.budget_performance_history.cost_filters["GenericString"] #=> Array
+    #   resp.budget_performance_history.cost_filters["GenericString"][0] #=> String
+    #   resp.budget_performance_history.cost_types.include_tax #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_subscription #=> Boolean
+    #   resp.budget_performance_history.cost_types.use_blended #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_refund #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_credit #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_upfront #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_recurring #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_other_subscription #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_support #=> Boolean
+    #   resp.budget_performance_history.cost_types.include_discount #=> Boolean
+    #   resp.budget_performance_history.cost_types.use_amortized #=> Boolean
+    #   resp.budget_performance_history.time_unit #=> String, one of "DAILY", "MONTHLY", "QUARTERLY", "ANNUALLY"
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list #=> Array
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list[0].budgeted_amount.amount #=> String
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list[0].budgeted_amount.unit #=> String
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list[0].actual_amount.amount #=> String
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list[0].actual_amount.unit #=> String
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list[0].time_period.start #=> Time
+    #   resp.budget_performance_history.budgeted_and_actual_amounts_list[0].time_period.end #=> Time
+    #   resp.next_token #=> String
+    #
+    # @overload describe_budget_performance_history(params = {})
+    # @param [Hash] params ({})
+    def describe_budget_performance_history(params = {}, options = {})
+      req = build_request(:describe_budget_performance_history, params)
+      req.send_request(options)
+    end
+
+    # Lists the budgets that are associated with an account.
     #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budgets that you want
     #   descriptions of.
     #
     # @option params [Integer] :max_results
-    #   Optional integer. Specifies the maximum number of results to return in
-    #   response.
+    #   An optional integer that represents how many entries a paginated
+    #   response contains. The maximum is 100.
     #
     # @option params [String] :next_token
-    #   The pagination token that indicates the next set of results to
-    #   retrieve.
+    #   The pagination token that you include in your request to indicate the
+    #   next set of results that you want to retrieve.
     #
     # @return [Types::DescribeBudgetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -582,6 +684,7 @@ module Aws::Budgets
     #   resp.budgets[0].calculated_spend.forecasted_spend.amount #=> String
     #   resp.budgets[0].calculated_spend.forecasted_spend.unit #=> String
     #   resp.budgets[0].budget_type #=> String, one of "USAGE", "COST", "RI_UTILIZATION", "RI_COVERAGE"
+    #   resp.budgets[0].last_updated_time #=> Time
     #   resp.next_token #=> String
     #
     # @overload describe_budgets(params = {})
@@ -591,7 +694,7 @@ module Aws::Budgets
       req.send_request(options)
     end
 
-    # Lists the notifications associated with a budget.
+    # Lists the notifications that are associated with a budget.
     #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget whose notifications
@@ -601,12 +704,12 @@ module Aws::Budgets
     #   The name of the budget whose notifications you want descriptions of.
     #
     # @option params [Integer] :max_results
-    #   Optional integer. Specifies the maximum number of results to return in
-    #   response.
+    #   An optional integer that represents how many entries a paginated
+    #   response contains. The maximum is 100.
     #
     # @option params [String] :next_token
-    #   The pagination token that indicates the next set of results to
-    #   retrieve.
+    #   The pagination token that you include in your request to indicate the
+    #   next set of results that you want to retrieve.
     #
     # @return [Types::DescribeNotificationsForBudgetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -629,6 +732,7 @@ module Aws::Budgets
     #   resp.notifications[0].comparison_operator #=> String, one of "GREATER_THAN", "LESS_THAN", "EQUAL_TO"
     #   resp.notifications[0].threshold #=> Float
     #   resp.notifications[0].threshold_type #=> String, one of "PERCENTAGE", "ABSOLUTE_VALUE"
+    #   resp.notifications[0].notification_state #=> String, one of "OK", "ALARM"
     #   resp.next_token #=> String
     #
     # @overload describe_notifications_for_budget(params = {})
@@ -638,7 +742,7 @@ module Aws::Budgets
       req.send_request(options)
     end
 
-    # Lists the subscribers associated with a notification.
+    # Lists the subscribers that are associated with a notification.
     #
     # @option params [required, String] :account_id
     #   The `accountId` that is associated with the budget whose subscribers
@@ -651,12 +755,12 @@ module Aws::Budgets
     #   The notification whose subscribers you want to list.
     #
     # @option params [Integer] :max_results
-    #   Optional integer. Specifies the maximum number of results to return in
-    #   response.
+    #   An optional integer that represents how many entries a paginated
+    #   response contains. The maximum is 100.
     #
     # @option params [String] :next_token
-    #   The pagination token that indicates the next set of results to
-    #   retrieve.
+    #   The pagination token that you include in your request to indicate the
+    #   next set of results that you want to retrieve.
     #
     # @return [Types::DescribeSubscribersForNotificationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -673,6 +777,7 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #     max_results: 1,
     #     next_token: "GenericString",
@@ -693,7 +798,7 @@ module Aws::Budgets
     end
 
     # Updates a budget. You can change every part of a budget except for the
-    # `budgetName` and the `calculatedSpend`. When a budget is modified, 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.
     #
@@ -748,6 +853,7 @@ module Aws::Budgets
     #         },
     #       },
     #       budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE
+    #       last_updated_time: Time.now,
     #     },
     #   })
     #
@@ -768,7 +874,7 @@ module Aws::Budgets
     #   The name of the budget whose notification you want to update.
     #
     # @option params [required, Types::Notification] :old_notification
-    #   The previous notification associated with a budget.
+    #   The previous notification that is associated with a budget.
     #
     # @option params [required, Types::Notification] :new_notification
     #   The updated notification to be associated with a budget.
@@ -785,12 +891,14 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #     new_notification: { # required
     #       notification_type: "ACTUAL", # required, accepts ACTUAL, FORECASTED
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #   })
     #
@@ -814,10 +922,10 @@ module Aws::Budgets
     #   The notification whose subscriber you want to update.
     #
     # @option params [required, Types::Subscriber] :old_subscriber
-    #   The previous subscriber associated with a budget notification.
+    #   The previous subscriber that is associated with a budget notification.
     #
     # @option params [required, Types::Subscriber] :new_subscriber
-    #   The updated subscriber associated with a budget notification.
+    #   The updated subscriber that is associated with a budget notification.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -831,6 +939,7 @@ module Aws::Budgets
     #       comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #       threshold: 1.0, # required
     #       threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #       notification_state: "OK", # accepts OK, ALARM
     #     },
     #     old_subscriber: { # required
     #       subscription_type: "SNS", # required, accepts SNS, EMAIL
@@ -862,7 +971,7 @@ module Aws::Budgets
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-budgets'
-      context[:gem_version] = '1.12.0'
+      context[:gem_version] = '1.13.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -14,7 +14,10 @@ module Aws::Budgets
     AccountId = Shapes::StringShape.new(name: 'AccountId')
     Budget = Shapes::StructureShape.new(name: 'Budget')
     BudgetName = Shapes::StringShape.new(name: 'BudgetName')
+    BudgetPerformanceHistory = Shapes::StructureShape.new(name: 'BudgetPerformanceHistory')
     BudgetType = Shapes::StringShape.new(name: 'BudgetType')
+    BudgetedAndActualAmounts = Shapes::StructureShape.new(name: 'BudgetedAndActualAmounts')
+    BudgetedAndActualAmountsList = Shapes::ListShape.new(name: 'BudgetedAndActualAmountsList')
     Budgets = Shapes::ListShape.new(name: 'Budgets')
     CalculatedSpend = Shapes::StructureShape.new(name: 'CalculatedSpend')
     ComparisonOperator = Shapes::StringShape.new(name: 'ComparisonOperator')
@@ -33,6 +36,8 @@ module Aws::Budgets
     DeleteNotificationResponse = Shapes::StructureShape.new(name: 'DeleteNotificationResponse')
     DeleteSubscriberRequest = Shapes::StructureShape.new(name: 'DeleteSubscriberRequest')
     DeleteSubscriberResponse = Shapes::StructureShape.new(name: 'DeleteSubscriberResponse')
+    DescribeBudgetPerformanceHistoryRequest = Shapes::StructureShape.new(name: 'DescribeBudgetPerformanceHistoryRequest')
+    DescribeBudgetPerformanceHistoryResponse = Shapes::StructureShape.new(name: 'DescribeBudgetPerformanceHistoryResponse')
     DescribeBudgetRequest = Shapes::StructureShape.new(name: 'DescribeBudgetRequest')
     DescribeBudgetResponse = Shapes::StructureShape.new(name: 'DescribeBudgetResponse')
     DescribeBudgetsRequest = Shapes::StructureShape.new(name: 'DescribeBudgetsRequest')
@@ -52,6 +57,7 @@ module Aws::Budgets
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
     NotFoundException = Shapes::StructureShape.new(name: 'NotFoundException')
     Notification = Shapes::StructureShape.new(name: 'Notification')
+    NotificationState = Shapes::StringShape.new(name: 'NotificationState')
     NotificationThreshold = Shapes::FloatShape.new(name: 'NotificationThreshold')
     NotificationType = Shapes::StringShape.new(name: 'NotificationType')
     NotificationWithSubscribers = Shapes::StructureShape.new(name: 'NotificationWithSubscribers')
@@ -84,8 +90,24 @@ module Aws::Budgets
     Budget.add_member(:time_period, Shapes::ShapeRef.new(shape: TimePeriod, location_name: "TimePeriod"))
     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.struct_class = Types::Budget
 
+    BudgetPerformanceHistory.add_member(:budget_name, Shapes::ShapeRef.new(shape: BudgetName, location_name: "BudgetName"))
+    BudgetPerformanceHistory.add_member(:budget_type, Shapes::ShapeRef.new(shape: BudgetType, location_name: "BudgetType"))
+    BudgetPerformanceHistory.add_member(:cost_filters, Shapes::ShapeRef.new(shape: CostFilters, location_name: "CostFilters"))
+    BudgetPerformanceHistory.add_member(:cost_types, Shapes::ShapeRef.new(shape: CostTypes, location_name: "CostTypes"))
+    BudgetPerformanceHistory.add_member(:time_unit, Shapes::ShapeRef.new(shape: TimeUnit, location_name: "TimeUnit"))
+    BudgetPerformanceHistory.add_member(:budgeted_and_actual_amounts_list, Shapes::ShapeRef.new(shape: BudgetedAndActualAmountsList, location_name: "BudgetedAndActualAmountsList"))
+    BudgetPerformanceHistory.struct_class = Types::BudgetPerformanceHistory
+
+    BudgetedAndActualAmounts.add_member(:budgeted_amount, Shapes::ShapeRef.new(shape: Spend, location_name: "BudgetedAmount"))
+    BudgetedAndActualAmounts.add_member(:actual_amount, Shapes::ShapeRef.new(shape: Spend, location_name: "ActualAmount"))
+    BudgetedAndActualAmounts.add_member(:time_period, Shapes::ShapeRef.new(shape: TimePeriod, location_name: "TimePeriod"))
+    BudgetedAndActualAmounts.struct_class = Types::BudgetedAndActualAmounts
+
+    BudgetedAndActualAmountsList.member = Shapes::ShapeRef.new(shape: BudgetedAndActualAmounts)
+
     Budgets.member = Shapes::ShapeRef.new(shape: Budget)
 
     CalculatedSpend.add_member(:actual_spend, Shapes::ShapeRef.new(shape: Spend, required: true, location_name: "ActualSpend"))
@@ -152,6 +174,17 @@ module Aws::Budgets
 
     DeleteSubscriberResponse.struct_class = Types::DeleteSubscriberResponse
 
+    DescribeBudgetPerformanceHistoryRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "AccountId"))
+    DescribeBudgetPerformanceHistoryRequest.add_member(:budget_name, Shapes::ShapeRef.new(shape: BudgetName, required: true, location_name: "BudgetName"))
+    DescribeBudgetPerformanceHistoryRequest.add_member(:time_period, Shapes::ShapeRef.new(shape: TimePeriod, location_name: "TimePeriod"))
+    DescribeBudgetPerformanceHistoryRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResults, location_name: "MaxResults"))
+    DescribeBudgetPerformanceHistoryRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: GenericString, location_name: "NextToken"))
+    DescribeBudgetPerformanceHistoryRequest.struct_class = Types::DescribeBudgetPerformanceHistoryRequest
+
+    DescribeBudgetPerformanceHistoryResponse.add_member(:budget_performance_history, Shapes::ShapeRef.new(shape: BudgetPerformanceHistory, location_name: "BudgetPerformanceHistory"))
+    DescribeBudgetPerformanceHistoryResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: GenericString, location_name: "NextToken"))
+    DescribeBudgetPerformanceHistoryResponse.struct_class = Types::DescribeBudgetPerformanceHistoryResponse
+
     DescribeBudgetRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "AccountId"))
     DescribeBudgetRequest.add_member(:budget_name, Shapes::ShapeRef.new(shape: BudgetName, required: true, location_name: "BudgetName"))
     DescribeBudgetRequest.struct_class = Types::DescribeBudgetRequest
@@ -195,6 +228,7 @@ module Aws::Budgets
     Notification.add_member(:comparison_operator, Shapes::ShapeRef.new(shape: ComparisonOperator, required: true, location_name: "ComparisonOperator"))
     Notification.add_member(:threshold, Shapes::ShapeRef.new(shape: NotificationThreshold, required: true, location_name: "Threshold"))
     Notification.add_member(:threshold_type, Shapes::ShapeRef.new(shape: ThresholdType, location_name: "ThresholdType"))
+    Notification.add_member(:notification_state, Shapes::ShapeRef.new(shape: NotificationState, location_name: "NotificationState"))
     Notification.struct_class = Types::Notification
 
     NotificationWithSubscribers.add_member(:notification, Shapes::ShapeRef.new(shape: Notification, required: true, location_name: "Notification"))
@@ -343,6 +377,19 @@ module Aws::Budgets
         o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
       end)
 
+      api.add_operation(:describe_budget_performance_history, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeBudgetPerformanceHistory"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeBudgetPerformanceHistoryRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeBudgetPerformanceHistoryResponse)
+        o.errors << Shapes::ShapeRef.new(shape: InternalErrorException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException)
+        o.errors << Shapes::ShapeRef.new(shape: ExpiredNextTokenException)
+      end)
+
       api.add_operation(:describe_budgets, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeBudgets"
         o.http_method = "POST"

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

@@ -10,9 +10,10 @@ module Aws::Budgets
 
     # 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`.
+    # current status of the `budget` object.
+    #
+    # This is the ARN pattern for a budget:
     #
-    # The ARN pattern for a budget is:
     # `arn:aws:budgetservice::AccountId:budget/budgetName`
     #
     # @note When making an API call, you may pass Budget
@@ -56,49 +57,56 @@ module Aws::Budgets
     #           },
     #         },
     #         budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE
+    #         last_updated_time: Time.now,
     #       }
     #
     # @!attribute [rw] budget_name
-    #   The name of a budget. Unique within accounts. `:` and `` characters
-    #   are not allowed in the `BudgetName`.
+    #   The name of a budget. The name must be unique within accounts. The
+    #   `:` and `` characters aren't allowed in `BudgetName`.
     #   @return [String]
     #
     # @!attribute [rw] budget_limit
-    #   The total amount of cost, usage, or RI utilization that you want to
-    #   track with your budget.
+    #   The total amount of cost, usage, RI utilization, or RI coverage that
+    #   you want to track with your budget.
     #
     #   `BudgetLimit` is required for cost or usage budgets, but optional
-    #   for RI utilization budgets. RI utilization budgets default to the
-    #   only valid value for RI utilization budgets, which is `100`.
+    #   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.
     #   @return [Types::Spend]
     #
     # @!attribute [rw] cost_filters
-    #   The cost filters applied to a budget, such as service or region.
+    #   The cost filters, such as service or region, that are applied to a
+    #   budget.
     #   @return [Hash<String,Array<String>>]
     #
     # @!attribute [rw] cost_types
-    #   The types of costs included in this budget.
+    #   The types of costs that are included in this `COST` budget.
+    #
+    #   `USAGE`, `RI_UTILIZATION`, and `RI_COVERAGE` budgets do not have
+    #   `CostTypes`.
     #   @return [Types::CostTypes]
     #
     # @!attribute [rw] time_unit
     #   The length of time until a budget resets the actual and forecasted
-    #   spend.
+    #   spend. `DAILY` is available only for `RI_UTILIZATION` and
+    #   `RI_COVERAGE` budgets.
     #   @return [String]
     #
     # @!attribute [rw] time_period
-    #   The period of time covered by a budget. 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.
-    #
-    #   If you created your budget and didn't specify a start date, AWS
-    #   defaults to the start of your chosen time period (i.e. DAILY,
-    #   MONTHLY, QUARTERLY, ANNUALLY). For example, if you created your
-    #   budget on January 24th 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 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.
     #
     #   You can change either date with the `UpdateBudget` operation.
     #
@@ -107,13 +115,18 @@ module Aws::Budgets
     #   @return [Types::TimePeriod]
     #
     # @!attribute [rw] calculated_spend
-    #   The actual and forecasted cost or usage being tracked by a budget.
+    #   The actual and forecasted cost or usage that the budget tracks.
     #   @return [Types::CalculatedSpend]
     #
     # @!attribute [rw] budget_type
-    #   Whether this budget tracks monetary costs, usage, or RI utilization.
+    #   Whether this budget tracks monetary costs, usage, RI utilization, or
+    #   RI coverage.
     #   @return [String]
     #
+    # @!attribute [rw] last_updated_time
+    #   The last time that you updated this budget.
+    #   @return [Time]
+    #
     class Budget < Struct.new(
       :budget_name,
       :budget_limit,
@@ -122,14 +135,80 @@ module Aws::Budgets
       :time_unit,
       :time_period,
       :calculated_spend,
-      :budget_type)
+      :budget_type,
+      :last_updated_time)
       include Aws::Structure
     end
 
-    # The spend objects associated with this budget. The `actualSpend`
-    # tracks how much you've used, cost, usage, or RI units, and the
-    # `forecastedSpend` tracks how much you are predicted to spend if your
-    # current usage remains steady.
+    # A history of the state of a budget at the end of the budget's
+    # specified time period.
+    #
+    # @!attribute [rw] budget_name
+    #   A string that represents the budget name. The ":" and "\\"
+    #   characters aren't allowed.
+    #   @return [String]
+    #
+    # @!attribute [rw] budget_type
+    #   The type of a budget. It must be one of the following types:
+    #
+    #   `COST`, `USAGE`, `RI_UTILIZATION`, or `RI_COVERAGE`.
+    #   @return [String]
+    #
+    # @!attribute [rw] cost_filters
+    #   The history of the cost filters for a budget during the specified
+    #   time period.
+    #   @return [Hash<String,Array<String>>]
+    #
+    # @!attribute [rw] cost_types
+    #   The history of the cost types for a budget during the specified time
+    #   period.
+    #   @return [Types::CostTypes]
+    #
+    # @!attribute [rw] time_unit
+    #   The time unit of the budget, such as MONTHLY or QUARTERLY.
+    #   @return [String]
+    #
+    # @!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.
+    #   @return [Array<Types::BudgetedAndActualAmounts>]
+    #
+    class BudgetPerformanceHistory < Struct.new(
+      :budget_name,
+      :budget_type,
+      :cost_filters,
+      :cost_types,
+      :time_unit,
+      :budgeted_and_actual_amounts_list)
+      include Aws::Structure
+    end
+
+    # The amount of cost or usage that you created the budget for, compared
+    # to your actual costs or usage.
+    #
+    # @!attribute [rw] budgeted_amount
+    #   The amount of cost or usage that you created the budget for.
+    #   @return [Types::Spend]
+    #
+    # @!attribute [rw] actual_amount
+    #   Your actual costs or usage for a budget period.
+    #   @return [Types::Spend]
+    #
+    # @!attribute [rw] time_period
+    #   The time period covered by this budget comparison.
+    #   @return [Types::TimePeriod]
+    #
+    class BudgetedAndActualAmounts < Struct.new(
+      :budgeted_amount,
+      :actual_amount,
+      :time_period)
+      include Aws::Structure
+    end
+
+    # The spend objects that are associated with this budget. The
+    # `actualSpend` tracks how much you've used, cost, usage, or RI units,
+    # and the `forecastedSpend` tracks how much you are predicted to spend
+    # if your current usage remains steady.
     #
     # For example, if it is the 20th of the month and you have spent `50`
     # dollars on Amazon EC2, your `actualSpend` is `50 USD`, and your
@@ -164,7 +243,11 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The types of cost included in a budget, such as tax and subscriptions.
+    # The types of cost that are included in a `COST` budget, such as tax
+    # and subscriptions.
+    #
+    # `USAGE`, `RI_UTILIZATION`, and `RI_COVERAGE` budgets do not have
+    # `CostTypes`.
     #
     # @note When making an API call, you may pass CostTypes
     #   data as a hash:
@@ -196,7 +279,7 @@ module Aws::Budgets
     #   @return [Boolean]
     #
     # @!attribute [rw] use_blended
-    #   Specifies whether a budget uses blended rate.
+    #   Specifies whether a budget uses a blended rate.
     #
     #   The default value is `false`.
     #   @return [Boolean]
@@ -310,6 +393,7 @@ module Aws::Budgets
     #             },
     #           },
     #           budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE
+    #           last_updated_time: Time.now,
     #         },
     #         notifications_with_subscribers: [
     #           {
@@ -318,6 +402,7 @@ module Aws::Budgets
     #               comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #               threshold: 1.0, # required
     #               threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #               notification_state: "OK", # accepts OK, ALARM
     #             },
     #             subscribers: [ # required
     #               {
@@ -340,7 +425,7 @@ module Aws::Budgets
     # @!attribute [rw] notifications_with_subscribers
     #   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 ten email subscribers. If you include
+    #   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.
     #   @return [Array<Types::NotificationWithSubscribers>]
@@ -369,6 +454,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         subscribers: [ # required
     #           {
@@ -384,8 +470,8 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] budget_name
-    #   The name of the budget that you want AWS to notified you about.
-    #   Budget names must be unique within an account.
+    #   The name of the budget that you want AWS to notify you about. Budget
+    #   names must be unique within an account.
     #   @return [String]
     #
     # @!attribute [rw] notification
@@ -395,7 +481,7 @@ module Aws::Budgets
     # @!attribute [rw] subscribers
     #   A list of subscribers that you want to associate with the
     #   notification. Each notification can have one SNS subscriber and up
-    #   to ten email subscribers.
+    #   to 10 email subscribers.
     #   @return [Array<Types::Subscriber>]
     #
     class CreateNotificationRequest < Struct.new(
@@ -423,6 +509,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         subscriber: { # required
     #           subscription_type: "SNS", # required, accepts SNS, EMAIL
@@ -431,8 +518,8 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] account_id
-    #   The `accountId` associated with the budget that you want to create a
-    #   subscriber for.
+    #   The `accountId` that is associated with the budget that you want to
+    #   create a subscriber for.
     #   @return [String]
     #
     # @!attribute [rw] budget_name
@@ -503,6 +590,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #       }
     #
@@ -543,6 +631,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         subscriber: { # required
     #           subscription_type: "SNS", # required, accepts SNS, EMAIL
@@ -579,6 +668,71 @@ module Aws::Budgets
     #
     class DeleteSubscriberResponse < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass DescribeBudgetPerformanceHistoryRequest
+    #   data as a hash:
+    #
+    #       {
+    #         account_id: "AccountId", # required
+    #         budget_name: "BudgetName", # required
+    #         time_period: {
+    #           start: Time.now,
+    #           end: Time.now,
+    #         },
+    #         max_results: 1,
+    #         next_token: "GenericString",
+    #       }
+    #
+    # @!attribute [rw] account_id
+    #   The account ID of the user. It should be a 12-digit number.
+    #   @return [String]
+    #
+    # @!attribute [rw] budget_name
+    #   A string that represents the budget name. The ":" and "\\"
+    #   characters aren't allowed.
+    #   @return [String]
+    #
+    # @!attribute [rw] time_period
+    #   Retrieves how often the budget went into an `ALARM` state for the
+    #   specified time period.
+    #   @return [Types::TimePeriod]
+    #
+    # @!attribute [rw] max_results
+    #   An integer that represents how many entries a paginated response
+    #   contains. The maximum is 100.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   A generic string.
+    #   @return [String]
+    #
+    class DescribeBudgetPerformanceHistoryRequest < Struct.new(
+      :account_id,
+      :budget_name,
+      :time_period,
+      :max_results,
+      :next_token)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] budget_performance_history
+    #   The history of how often the budget has gone into an `ALARM` state.
+    #
+    #   For `DAILY` budgets, the history saves the state of the budget for
+    #   the last 60 days. For `MONTHLY` budgets, the history saves the state
+    #   of the budget for the last 12 months. For `QUARTERLY` budgets, the
+    #   history saves the state of the budget for the last four quarters.
+    #   @return [Types::BudgetPerformanceHistory]
+    #
+    # @!attribute [rw] next_token
+    #   A generic string.
+    #   @return [String]
+    #
+    class DescribeBudgetPerformanceHistoryResponse < Struct.new(
+      :budget_performance_history,
+      :next_token)
+      include Aws::Structure
+    end
+
     # Request of DescribeBudget
     #
     # @note When making an API call, you may pass DescribeBudgetRequest
@@ -632,13 +786,13 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   Optional integer. Specifies the maximum number of results to return
-    #   in response.
+    #   An optional integer that represents how many entries a paginated
+    #   response contains. The maximum is 100.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   The pagination token that indicates the next set of results to
-    #   retrieve.
+    #   The pagination token that you include in your request to indicate
+    #   the next set of results that you want to retrieve.
     #   @return [String]
     #
     class DescribeBudgetsRequest < Struct.new(
@@ -655,8 +809,8 @@ module Aws::Budgets
     #   @return [Array<Types::Budget>]
     #
     # @!attribute [rw] next_token
-    #   The pagination token that indicates the next set of results that you
-    #   can retrieve.
+    #   The pagination token in the service response that indicates the next
+    #   set of results that you can retrieve.
     #   @return [String]
     #
     class DescribeBudgetsResponse < Struct.new(
@@ -687,13 +841,13 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   Optional integer. Specifies the maximum number of results to return
-    #   in response.
+    #   An optional integer that represents how many entries a paginated
+    #   response contains. The maximum is 100.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   The pagination token that indicates the next set of results to
-    #   retrieve.
+    #   The pagination token that you include in your request to indicate
+    #   the next set of results that you want to retrieve.
     #   @return [String]
     #
     class DescribeNotificationsForBudgetRequest < Struct.new(
@@ -707,12 +861,12 @@ module Aws::Budgets
     # Response of GetNotificationsForBudget
     #
     # @!attribute [rw] notifications
-    #   A list of notifications associated with a budget.
+    #   A list of notifications that are associated with a budget.
     #   @return [Array<Types::Notification>]
     #
     # @!attribute [rw] next_token
-    #   The pagination token that indicates the next set of results that you
-    #   can retrieve.
+    #   The pagination token in the service response that indicates the next
+    #   set of results that you can retrieve.
     #   @return [String]
     #
     class DescribeNotificationsForBudgetResponse < Struct.new(
@@ -734,6 +888,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         max_results: 1,
     #         next_token: "GenericString",
@@ -753,13 +908,13 @@ module Aws::Budgets
     #   @return [Types::Notification]
     #
     # @!attribute [rw] max_results
-    #   Optional integer. Specifies the maximum number of results to return
-    #   in response.
+    #   An optional integer that represents how many entries a paginated
+    #   response contains. The maximum is 100.
     #   @return [Integer]
     #
     # @!attribute [rw] next_token
-    #   The pagination token that indicates the next set of results to
-    #   retrieve.
+    #   The pagination token that you include in your request to indicate
+    #   the next set of results that you want to retrieve.
     #   @return [String]
     #
     class DescribeSubscribersForNotificationRequest < Struct.new(
@@ -774,12 +929,12 @@ module Aws::Budgets
     # Response of DescribeSubscribersForNotification
     #
     # @!attribute [rw] subscribers
-    #   A list of subscribers associated with a notification.
+    #   A list of subscribers that are associated with a notification.
     #   @return [Array<Types::Subscriber>]
     #
     # @!attribute [rw] next_token
-    #   The pagination token that indicates the next set of results that you
-    #   can retrieve.
+    #   The pagination token in the service response that indicates the next
+    #   set of results that you can retrieve.
     #   @return [String]
     #
     class DescribeSubscribersForNotificationResponse < Struct.new(
@@ -788,11 +943,11 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # A notification associated with a budget. A budget can have up to five
-    # notifications.
+    # A notification that is associated with a budget. A budget can have up
+    # to five notifications.
     #
     # Each notification must have at least one subscriber. A notification
-    # can have one SNS subscriber and up to ten email subscribers, for a
+    # can have one SNS subscriber and up to 10 email subscribers, for a
     # total of 11 subscribers.
     #
     # For example, if you have a budget for 200 dollars and you want to be
@@ -801,9 +956,11 @@ module Aws::Budgets
     #
     # * A notificationType of `ACTUAL`
     #
-    # * A comparisonOperator of `GREATER_THAN`
+    # * A `thresholdType` of `PERCENTAGE`
     #
-    # * A notification threshold of `80`
+    # * A `comparisonOperator` of `GREATER_THAN`
+    #
+    # * A notification `threshold` of `80`
     #
     # @note When making an API call, you may pass Notification
     #   data as a hash:
@@ -813,39 +970,50 @@ module Aws::Budgets
     #         comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #         threshold: 1.0, # required
     #         threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #         notification_state: "OK", # accepts OK, ALARM
     #       }
     #
     # @!attribute [rw] notification_type
     #   Whether the notification is for how much you have spent (`ACTUAL`)
-    #   or for how much you are forecasted to spend (`FORECASTED`).
+    #   or for how much you're forecasted to spend (`FORECASTED`).
     #   @return [String]
     #
     # @!attribute [rw] comparison_operator
-    #   The comparison used for this notification.
+    #   The comparison that is used for this notification.
     #   @return [String]
     #
     # @!attribute [rw] threshold
-    #   The threshold associated with a notification. Thresholds are always
-    #   a percentage.
+    #   The threshold that is associated with a notification. Thresholds are
+    #   always a percentage.
     #   @return [Float]
     #
     # @!attribute [rw] threshold_type
-    #   The type of threshold for a notification. For `ACTUAL` thresholds,
-    #   AWS notifies you when you go over the threshold, and for
-    #   `FORECASTED` thresholds AWS notifies you when you are forecasted to
-    #   go over the threshold.
+    #   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.
+    #   @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.
     #   @return [String]
     #
     class Notification < Struct.new(
       :notification_type,
       :comparison_operator,
       :threshold,
-      :threshold_type)
+      :threshold_type,
+      :notification_state)
       include Aws::Structure
     end
 
     # A notification with subscribers. A notification can have one SNS
-    # subscriber and up to ten email subscribers, for a total of 11
+    # subscriber and up to 10 email subscribers, for a total of 11
     # subscribers.
     #
     # @note When making an API call, you may pass NotificationWithSubscribers
@@ -857,6 +1025,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         subscribers: [ # required
     #           {
@@ -867,7 +1036,7 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] notification
-    #   The notification associated with a budget.
+    #   The notification that is associated with a budget.
     #   @return [Types::Notification]
     #
     # @!attribute [rw] subscribers
@@ -880,7 +1049,7 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The amount of cost or usage being measured for a budget.
+    # The amount of cost or usage that is measured for a budget.
     #
     # For example, a `Spend` for `3 GB` of S3 usage would have the following
     # parameters:
@@ -898,13 +1067,13 @@ module Aws::Budgets
     #       }
     #
     # @!attribute [rw] amount
-    #   The cost or usage amount associated with a budget forecast, actual
-    #   spend, or budget threshold.
+    #   The cost or usage amount that is associated with a budget forecast,
+    #   actual spend, or budget threshold.
     #   @return [String]
     #
     # @!attribute [rw] unit
-    #   The unit of measurement used for the budget forecast, actual spend,
-    #   or budget threshold, such as dollars or GB.
+    #   The unit of measurement that is used for the budget forecast, actual
+    #   spend, or budget threshold, such as dollars or GB.
     #   @return [String]
     #
     class Spend < Struct.new(
@@ -914,8 +1083,7 @@ module Aws::Budgets
     end
 
     # The subscriber to a budget notification. The subscriber consists of a
-    # subscription type and either an Amazon Simple Notification Service
-    # topic or an email address.
+    # subscription type and either an Amazon SNS topic or an email address.
     #
     # For example, an email subscriber would have the following parameters:
     #
@@ -946,9 +1114,9 @@ module Aws::Budgets
       include Aws::Structure
     end
 
-    # The period of time covered by a budget. 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.
+    # 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.
+    # There are no restrictions on the end date.
     #
     # @note When making an API call, you may pass TimePeriod
     #   data as a hash:
@@ -961,11 +1129,11 @@ 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 (i.e. DAILY, MONTHLY, QUARTERLY, ANNUALLY). For example, if
-    #   you created your budget on January 24th 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
+    #   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.
     #
     #   You can change your start date with the `UpdateBudget` operation.
@@ -1032,6 +1200,7 @@ module Aws::Budgets
     #             },
     #           },
     #           budget_type: "USAGE", # required, accepts USAGE, COST, RI_UTILIZATION, RI_COVERAGE
+    #           last_updated_time: Time.now,
     #         },
     #       }
     #
@@ -1067,12 +1236,14 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         new_notification: { # required
     #           notification_type: "ACTUAL", # required, accepts ACTUAL, FORECASTED
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #       }
     #
@@ -1086,7 +1257,7 @@ module Aws::Budgets
     #   @return [String]
     #
     # @!attribute [rw] old_notification
-    #   The previous notification associated with a budget.
+    #   The previous notification that is associated with a budget.
     #   @return [Types::Notification]
     #
     # @!attribute [rw] new_notification
@@ -1118,6 +1289,7 @@ module Aws::Budgets
     #           comparison_operator: "GREATER_THAN", # required, accepts GREATER_THAN, LESS_THAN, EQUAL_TO
     #           threshold: 1.0, # required
     #           threshold_type: "PERCENTAGE", # accepts PERCENTAGE, ABSOLUTE_VALUE
+    #           notification_state: "OK", # accepts OK, ALARM
     #         },
     #         old_subscriber: { # required
     #           subscription_type: "SNS", # required, accepts SNS, EMAIL
@@ -1143,11 +1315,13 @@ module Aws::Budgets
     #   @return [Types::Notification]
     #
     # @!attribute [rw] old_subscriber
-    #   The previous subscriber associated with a budget notification.
+    #   The previous subscriber that is associated with a budget
+    #   notification.
     #   @return [Types::Subscriber]
     #
     # @!attribute [rw] new_subscriber
-    #   The updated subscriber associated with a budget notification.
+    #   The updated subscriber that is associated with a budget
+    #   notification.
     #   @return [Types::Subscriber]
     #
     class UpdateSubscriberRequest < Struct.new(

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-budgets
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-24 00:00:00.000000000 Z
+date: 2018-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core