aws-sdk-budgets 1.47.0 → 1.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b480648ddd45e113aab14f453cffd5faf6b9e1e37d202e9f7b9c3624c2dec2ab
-  data.tar.gz: dbbbc23f4ed5c60e5fb5268fc62496185a545853a7d96630937fbf3fe5a3d031
+  metadata.gz: f36cfe3de3777c81f79195c250b4ae2530699a8674f2f5f913446b72a4615b84
+  data.tar.gz: 1224f8ea9b2fe9c7548e5078badc960524b1e69ac4b363571efedd185e19208e
 SHA512:
-  metadata.gz: 062f023054660e8aa8c2b275a9bed960213bf0d140163115e69ff319987f33004df71cf376e43846ef9bcbe5c5530dfd3924360fd6eb4d45af1bac766633f406
-  data.tar.gz: d7ef0ee9aa3317cf3eabd89457a5120c414e80a36da188e6119eba6e0d54dca29c32f8b656bbe46ab9287938c67e8c43ff6b118bb373f914461fa3be3d55c365
+  metadata.gz: 8bd29b188b7b6c39e0db0efea003303a19ee98e7c9405ede27cf3593778af17cc6f3cd54c9ec4bcfdc30c7fdb3bb995a9905a04c4845847cf80333332b27b7e0
+  data.tar.gz: 1b3ba4844cfaafca9e43b59681e2fa86aeeff582a3cf2931d98dd66898d10657926d48122c827c93df4ca1226861b6e512c5909b2122e8bb9880a1823505037b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.48.0 (2022-02-18)
+------------------
+
+* Feature - This change introduces DescribeBudgetNotificationsForAccount API which returns budget notifications for the specified account
+
 1.47.0 (2022-02-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.47.0
+1.48.0

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

@@ -1185,6 +1185,53 @@ module Aws::Budgets
       req.send_request(options)
     end
 
+    # Lists the budget names and notifications that are associated with an
+    # account.
+    #
+    # @option params [required, String] :account_id
+    #   The account ID of the user. It's a 12-digit number.
+    #
+    # @option params [Integer] :max_results
+    #   An integer that shows how many budget name entries a paginated
+    #   response contains.
+    #
+    # @option params [String] :next_token
+    #   A generic string.
+    #
+    # @return [Types::DescribeBudgetNotificationsForAccountResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeBudgetNotificationsForAccountResponse#budget_notifications_for_account #budget_notifications_for_account} => Array<Types::BudgetNotificationsForAccount>
+    #   * {Types::DescribeBudgetNotificationsForAccountResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_budget_notifications_for_account({
+    #     account_id: "AccountId", # required
+    #     max_results: 1,
+    #     next_token: "GenericString",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.budget_notifications_for_account #=> Array
+    #   resp.budget_notifications_for_account[0].notifications #=> Array
+    #   resp.budget_notifications_for_account[0].notifications[0].notification_type #=> String, one of "ACTUAL", "FORECASTED"
+    #   resp.budget_notifications_for_account[0].notifications[0].comparison_operator #=> String, one of "GREATER_THAN", "LESS_THAN", "EQUAL_TO"
+    #   resp.budget_notifications_for_account[0].notifications[0].threshold #=> Float
+    #   resp.budget_notifications_for_account[0].notifications[0].threshold_type #=> String, one of "PERCENTAGE", "ABSOLUTE_VALUE"
+    #   resp.budget_notifications_for_account[0].notifications[0].notification_state #=> String, one of "OK", "ALARM"
+    #   resp.budget_notifications_for_account[0].budget_name #=> String
+    #   resp.next_token #=> String
+    #
+    # @overload describe_budget_notifications_for_account(params = {})
+    # @param [Hash] params ({})
+    def describe_budget_notifications_for_account(params = {}, options = {})
+      req = build_request(:describe_budget_notifications_for_account, params)
+      req.send_request(options)
+    end
+
     # Describes the history for `DAILY`, `MONTHLY`, and `QUARTERLY` budgets.
     # Budget history isn't available for `ANNUAL` budgets.
     #
@@ -1833,7 +1880,7 @@ module Aws::Budgets
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-budgets'
-      context[:gem_version] = '1.47.0'
+      context[:gem_version] = '1.48.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -31,6 +31,8 @@ module Aws::Budgets
     AutoAdjustType = Shapes::StringShape.new(name: 'AutoAdjustType')
     Budget = Shapes::StructureShape.new(name: 'Budget')
     BudgetName = Shapes::StringShape.new(name: 'BudgetName')
+    BudgetNotificationsForAccount = Shapes::StructureShape.new(name: 'BudgetNotificationsForAccount')
+    BudgetNotificationsForAccountList = Shapes::ListShape.new(name: 'BudgetNotificationsForAccountList')
     BudgetPerformanceHistory = Shapes::StructureShape.new(name: 'BudgetPerformanceHistory')
     BudgetType = Shapes::StringShape.new(name: 'BudgetType')
     BudgetedAndActualAmounts = Shapes::StructureShape.new(name: 'BudgetedAndActualAmounts')
@@ -66,6 +68,8 @@ module Aws::Budgets
     DescribeBudgetActionsForAccountResponse = Shapes::StructureShape.new(name: 'DescribeBudgetActionsForAccountResponse')
     DescribeBudgetActionsForBudgetRequest = Shapes::StructureShape.new(name: 'DescribeBudgetActionsForBudgetRequest')
     DescribeBudgetActionsForBudgetResponse = Shapes::StructureShape.new(name: 'DescribeBudgetActionsForBudgetResponse')
+    DescribeBudgetNotificationsForAccountRequest = Shapes::StructureShape.new(name: 'DescribeBudgetNotificationsForAccountRequest')
+    DescribeBudgetNotificationsForAccountResponse = Shapes::StructureShape.new(name: 'DescribeBudgetNotificationsForAccountResponse')
     DescribeBudgetPerformanceHistoryRequest = Shapes::StructureShape.new(name: 'DescribeBudgetPerformanceHistoryRequest')
     DescribeBudgetPerformanceHistoryResponse = Shapes::StructureShape.new(name: 'DescribeBudgetPerformanceHistoryResponse')
     DescribeBudgetRequest = Shapes::StructureShape.new(name: 'DescribeBudgetRequest')
@@ -95,6 +99,7 @@ module Aws::Budgets
     InvalidNextTokenException = Shapes::StructureShape.new(name: 'InvalidNextTokenException')
     InvalidParameterException = Shapes::StructureShape.new(name: 'InvalidParameterException')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
+    MaxResultsBudgetNotifications = Shapes::IntegerShape.new(name: 'MaxResultsBudgetNotifications')
     NotFoundException = Shapes::StructureShape.new(name: 'NotFoundException')
     Notification = Shapes::StructureShape.new(name: 'Notification')
     NotificationState = Shapes::StringShape.new(name: 'NotificationState')
@@ -189,6 +194,12 @@ module Aws::Budgets
     Budget.add_member(:auto_adjust_data, Shapes::ShapeRef.new(shape: AutoAdjustData, location_name: "AutoAdjustData"))
     Budget.struct_class = Types::Budget
 
+    BudgetNotificationsForAccount.add_member(:notifications, Shapes::ShapeRef.new(shape: Notifications, location_name: "Notifications"))
+    BudgetNotificationsForAccount.add_member(:budget_name, Shapes::ShapeRef.new(shape: BudgetName, location_name: "BudgetName"))
+    BudgetNotificationsForAccount.struct_class = Types::BudgetNotificationsForAccount
+
+    BudgetNotificationsForAccountList.member = Shapes::ShapeRef.new(shape: BudgetNotificationsForAccount)
+
     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"))
@@ -345,6 +356,15 @@ module Aws::Budgets
     DescribeBudgetActionsForBudgetResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: GenericString, location_name: "NextToken"))
     DescribeBudgetActionsForBudgetResponse.struct_class = Types::DescribeBudgetActionsForBudgetResponse
 
+    DescribeBudgetNotificationsForAccountRequest.add_member(:account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "AccountId"))
+    DescribeBudgetNotificationsForAccountRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxResultsBudgetNotifications, location_name: "MaxResults"))
+    DescribeBudgetNotificationsForAccountRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: GenericString, location_name: "NextToken"))
+    DescribeBudgetNotificationsForAccountRequest.struct_class = Types::DescribeBudgetNotificationsForAccountRequest
+
+    DescribeBudgetNotificationsForAccountResponse.add_member(:budget_notifications_for_account, Shapes::ShapeRef.new(shape: BudgetNotificationsForAccountList, location_name: "BudgetNotificationsForAccount"))
+    DescribeBudgetNotificationsForAccountResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: GenericString, location_name: "NextToken"))
+    DescribeBudgetNotificationsForAccountResponse.struct_class = Types::DescribeBudgetNotificationsForAccountResponse
+
     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"))
@@ -732,6 +752,26 @@ module Aws::Budgets
         )
       end)
 
+      api.add_operation(:describe_budget_notifications_for_account, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DescribeBudgetNotificationsForAccount"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DescribeBudgetNotificationsForAccountRequest)
+        o.output = Shapes::ShapeRef.new(shape: DescribeBudgetNotificationsForAccountResponse)
+        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)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:describe_budget_performance_history, Seahorse::Model::Operation.new.tap do |o|
         o.name = "DescribeBudgetPerformanceHistory"
         o.http_method = "POST"

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

@@ -402,6 +402,24 @@ module Aws::Budgets
       include Aws::Structure
     end
 
+    # The budget name and associated notifications for an account.
+    #
+    # @!attribute [rw] notifications
+    #   A list of notifications.
+    #   @return [Array<Types::Notification>]
+    #
+    # @!attribute [rw] budget_name
+    #   A string that represents the budget name. The ":" and "\\"
+    #   characters aren't allowed.
+    #   @return [String]
+    #
+    class BudgetNotificationsForAccount < Struct.new(
+      :notifications,
+      :budget_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A history of the state of a budget at the end of the budget's
     # specified time period.
     #
@@ -1398,6 +1416,51 @@ module Aws::Budgets
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeBudgetNotificationsForAccountRequest
+    #   data as a hash:
+    #
+    #       {
+    #         account_id: "AccountId", # required
+    #         max_results: 1,
+    #         next_token: "GenericString",
+    #       }
+    #
+    # @!attribute [rw] account_id
+    #   The account ID of the user. It's a 12-digit number.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   An integer that shows how many budget name entries a paginated
+    #   response contains.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   A generic string.
+    #   @return [String]
+    #
+    class DescribeBudgetNotificationsForAccountRequest < Struct.new(
+      :account_id,
+      :max_results,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] budget_notifications_for_account
+    #   A list of budget names and associated notifications for an account.
+    #   @return [Array<Types::BudgetNotificationsForAccount>]
+    #
+    # @!attribute [rw] next_token
+    #   A generic string.
+    #   @return [String]
+    #
+    class DescribeBudgetNotificationsForAccountResponse < Struct.new(
+      :budget_notifications_for_account,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeBudgetPerformanceHistoryRequest
     #   data as a hash:
     #

data/lib/aws-sdk-budgets.rb

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

metadata

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