aws-sdk-costoptimizationhub 1.9.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a23a364f4983b655d63c146528d8fc00c84907883f3bed5c903d356f5dd262a9
-  data.tar.gz: 62a61035a56ab2427990b0f81366d0c82f6aedc55b107847f53fe2107746d441
+  metadata.gz: 32e5ed167b979230b9c9aa6ac376982480f3987ab60d4c934d07a20e513c28f5
+  data.tar.gz: 130e1fef533831d292f5cbebc73bcbddb0e7f319ea2d3642bce1e1e5226709fe
 SHA512:
-  metadata.gz: 27665ace88558ffcae14bb386b0fdefa52fc443ec58b617f98289ca4b2009dc05448b60cc1f99c23dfe98b7f1eef963ea6d53fee7a923becdff41f7010b876aa
-  data.tar.gz: ddaccfd32e38c426cc04c381038f7b53e15a87660ea0df331dbcf050904a8379c7ab5d700616ee285a813680396c3ab8ecb43844095db1e8f3e02a646d68a8d0
+  metadata.gz: 418b88825ce2accab7807643fd9f7b55080025ccb84a014bb111746e9ddb93b68211d333256ed6cbe8fcc6c0d71ead87f7209d879e81d5cf90e7c7b4ed4c2ec6
+  data.tar.gz: 7a9c7dbfa837f43a9e02cfe3dd152c19cf7db03c5f671cb39b002f564325e90fac5e4e11be5d452407e16e71d09f66c5ec704623669d8b2297ad723859363096

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.11.0 (2024-08-06)
+------------------
+
+* Feature - This release adds savings percentage support to the ListRecommendationSummaries API.
+
+1.10.0 (2024-07-02)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.9.0 (2024-06-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.9.0
+1.11.0

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

@@ -312,6 +312,15 @@ module Aws::CostOptimizationHub
     #
     #   @option options [String] :session_token
     #
+    #   @option options [Array] :sigv4a_signing_region_set
+    #     A list of regions that should be signed with SigV4a signing. When
+    #     not passed, a default `:sigv4a_signing_region_set` is searched for
+    #     in the following locations:
+    #
+    #     * `Aws.config[:sigv4a_signing_region_set]`
+    #     * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
+    #     * `~/.aws/config`
+    #
     #   @option options [Boolean] :simple_json (false)
     #     Disables request parameter conversion, validation, and formatting.
     #     Also disables response data type conversions. The request parameters
@@ -1036,8 +1045,11 @@ module Aws::CostOptimizationHub
     #   The grouping of recommendations by a dimension.
     #
     # @option params [Integer] :max_results
-    #   The maximum number of recommendations that are returned for the
-    #   request.
+    #   The maximum number of recommendations to be returned for the request.
+    #
+    # @option params [Array<String>] :metrics
+    #   Additional metrics to be returned for the request. The only valid
+    #   value is `savingsPercentage`.
     #
     # @option params [String] :next_token
     #   The token to retrieve the next set of results.
@@ -1048,6 +1060,7 @@ module Aws::CostOptimizationHub
     #   * {Types::ListRecommendationSummariesResponse#items #items} => Array&lt;Types::RecommendationSummary&gt;
     #   * {Types::ListRecommendationSummariesResponse#group_by #data.group_by} => String (This method conflicts with a method on Response, call it through the data member)
     #   * {Types::ListRecommendationSummariesResponse#currency_code #currency_code} => String
+    #   * {Types::ListRecommendationSummariesResponse#metrics #metrics} => Types::SummaryMetricsResult
     #   * {Types::ListRecommendationSummariesResponse#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}.
@@ -1075,6 +1088,7 @@ module Aws::CostOptimizationHub
     #     },
     #     group_by: "String", # required
     #     max_results: 1,
+    #     metrics: ["SavingsPercentage"], # accepts SavingsPercentage
     #     next_token: "String",
     #   })
     #
@@ -1087,6 +1101,7 @@ module Aws::CostOptimizationHub
     #   resp.items[0].recommendation_count #=> Integer
     #   resp.data.group_by #=> String
     #   resp.currency_code #=> String
+    #   resp.metrics.savings_percentage #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/ListRecommendationSummaries AWS API Documentation
@@ -1194,8 +1209,9 @@ module Aws::CostOptimizationHub
     # Updates the enrollment (opt in and opt out) status of an account to
     # the Cost Optimization Hub service.
     #
-    # If the account is a management account of an organization, this action
-    # can also be used to enroll member accounts of the organization.
+    # If the account is a management account or delegated administrator of
+    # an organization, this action can also be used to enroll member
+    # accounts of the organization.
     #
     # You must have the appropriate permissions to opt in to Cost
     # Optimization Hub and to view its recommendations. When you opt in,
@@ -1207,7 +1223,7 @@ module Aws::CostOptimizationHub
     #
     # @option params [Boolean] :include_member_accounts
     #   Indicates whether to enroll member accounts of the organization if the
-    #   account is the management account.
+    #   account is the management account or delegated administrator.
     #
     # @return [Types::UpdateEnrollmentStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1282,7 +1298,7 @@ module Aws::CostOptimizationHub
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-costoptimizationhub'
-      context[:gem_version] = '1.9.0'
+      context[:gem_version] = '1.11.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -103,6 +103,9 @@ module Aws::CostOptimizationHub
     Source = Shapes::StringShape.new(name: 'Source')
     StorageConfiguration = Shapes::StructureShape.new(name: 'StorageConfiguration')
     String = Shapes::StringShape.new(name: 'String')
+    SummaryMetrics = Shapes::StringShape.new(name: 'SummaryMetrics')
+    SummaryMetricsList = Shapes::ListShape.new(name: 'SummaryMetricsList')
+    SummaryMetricsResult = Shapes::StructureShape.new(name: 'SummaryMetricsResult')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagList = Shapes::ListShape.new(name: 'TagList')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
@@ -320,6 +323,7 @@ module Aws::CostOptimizationHub
     ListRecommendationSummariesRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Filter, location_name: "filter"))
     ListRecommendationSummariesRequest.add_member(:group_by, Shapes::ShapeRef.new(shape: String, required: true, location_name: "groupBy"))
     ListRecommendationSummariesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListRecommendationSummariesRequestMaxResultsInteger, location_name: "maxResults"))
+    ListRecommendationSummariesRequest.add_member(:metrics, Shapes::ShapeRef.new(shape: SummaryMetricsList, location_name: "metrics"))
     ListRecommendationSummariesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListRecommendationSummariesRequest.struct_class = Types::ListRecommendationSummariesRequest
 
@@ -327,6 +331,7 @@ module Aws::CostOptimizationHub
     ListRecommendationSummariesResponse.add_member(:items, Shapes::ShapeRef.new(shape: RecommendationSummariesList, location_name: "items"))
     ListRecommendationSummariesResponse.add_member(:group_by, Shapes::ShapeRef.new(shape: String, location_name: "groupBy"))
     ListRecommendationSummariesResponse.add_member(:currency_code, Shapes::ShapeRef.new(shape: String, location_name: "currencyCode"))
+    ListRecommendationSummariesResponse.add_member(:metrics, Shapes::ShapeRef.new(shape: SummaryMetricsResult, location_name: "metrics"))
     ListRecommendationSummariesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "nextToken"))
     ListRecommendationSummariesResponse.struct_class = Types::ListRecommendationSummariesResponse
 
@@ -544,6 +549,11 @@ module Aws::CostOptimizationHub
     StorageConfiguration.add_member(:size_in_gb, Shapes::ShapeRef.new(shape: Double, location_name: "sizeInGb"))
     StorageConfiguration.struct_class = Types::StorageConfiguration
 
+    SummaryMetricsList.member = Shapes::ShapeRef.new(shape: SummaryMetrics)
+
+    SummaryMetricsResult.add_member(:savings_percentage, Shapes::ShapeRef.new(shape: String, location_name: "savingsPercentage"))
+    SummaryMetricsResult.struct_class = Types::SummaryMetricsResult
+
     Tag.add_member(:key, Shapes::ShapeRef.new(shape: String, location_name: "key"))
     Tag.add_member(:value, Shapes::ShapeRef.new(shape: String, location_name: "value"))
     Tag.struct_class = Types::Tag

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

@@ -944,7 +944,7 @@ module Aws::CostOptimizationHub
     #
     # @!attribute [rw] include_member_accounts
     #   The enrollment status of all member accounts in the organization if
-    #   the account is the management account.
+    #   the account is the management account or delegated administrator.
     #   @return [Boolean]
     #
     # @!attribute [rw] next_token
@@ -971,10 +971,15 @@ module Aws::CostOptimizationHub
     #   @return [String]
     #
     # @!attribute [rw] max_results
-    #   The maximum number of recommendations that are returned for the
+    #   The maximum number of recommendations to be returned for the
     #   request.
     #   @return [Integer]
     #
+    # @!attribute [rw] metrics
+    #   Additional metrics to be returned for the request. The only valid
+    #   value is `savingsPercentage`.
+    #   @return [Array<String>]
+    #
     # @!attribute [rw] next_token
     #   The token to retrieve the next set of results.
     #   @return [String]
@@ -985,6 +990,7 @@ module Aws::CostOptimizationHub
       :filter,
       :group_by,
       :max_results,
+      :metrics,
       :next_token)
       SENSITIVE = []
       include Aws::Structure
@@ -995,7 +1001,7 @@ module Aws::CostOptimizationHub
     #   @return [Float]
     #
     # @!attribute [rw] items
-    #   List of all savings recommendations.
+    #   A list of all savings recommendations.
     #   @return [Array<Types::RecommendationSummary>]
     #
     # @!attribute [rw] group_by
@@ -1006,6 +1012,11 @@ module Aws::CostOptimizationHub
     #   The currency code used for the recommendation.
     #   @return [String]
     #
+    # @!attribute [rw] metrics
+    #   The results or descriptions for the additional metrics, based on
+    #   whether the metrics were or were not requested.
+    #   @return [Types::SummaryMetricsResult]
+    #
     # @!attribute [rw] next_token
     #   The token to retrieve the next set of results.
     #   @return [String]
@@ -1017,6 +1028,7 @@ module Aws::CostOptimizationHub
       :items,
       :group_by,
       :currency_code,
+      :metrics,
       :next_token)
       SENSITIVE = []
       include Aws::Structure
@@ -1961,6 +1973,27 @@ module Aws::CostOptimizationHub
       include Aws::Structure
     end
 
+    # The results or descriptions for the additional metrics, based on
+    # whether the metrics were or were not requested.
+    #
+    # @!attribute [rw] savings_percentage
+    #   The savings percentage based on your Amazon Web Services spend over
+    #   the past 30 days.
+    #
+    #   <note markdown="1"> Savings percentage is only supported when filtering by Region,
+    #   account ID, or tags.
+    #
+    #    </note>
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/SummaryMetricsResult AWS API Documentation
+    #
+    class SummaryMetricsResult < Struct.new(
+      :savings_percentage)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The tag structure that contains a tag key and value.
     #
     # @!attribute [rw] key
@@ -1999,7 +2032,7 @@ module Aws::CostOptimizationHub
     #
     # @!attribute [rw] include_member_accounts
     #   Indicates whether to enroll member accounts of the organization if
-    #   the account is the management account.
+    #   the account is the management account or delegated administrator.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/UpdateEnrollmentStatusRequest AWS API Documentation

data/lib/aws-sdk-costoptimizationhub.rb

@@ -53,6 +53,6 @@ require_relative 'aws-sdk-costoptimizationhub/customizations'
 # @!group service
 module Aws::CostOptimizationHub
 
-  GEM_VERSION = '1.9.0'
+  GEM_VERSION = '1.11.0'
 
 end

data/sig/client.rbs

@@ -48,6 +48,7 @@ module Aws
                       ?sdk_ua_app_id: String,
                       ?secret_access_key: String,
                       ?session_token: String,
+                      ?sigv4a_signing_region_set: Array[String],
                       ?simple_json: bool,
                       ?stub_responses: untyped,
                       ?token_provider: untyped,
@@ -136,6 +137,7 @@ module Aws
         def items: () -> ::Array[Types::RecommendationSummary]
         def group_by: () -> ::String
         def currency_code: () -> ::String
+        def metrics: () -> Types::SummaryMetricsResult
         def next_token: () -> ::String
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostOptimizationHub/Client.html#list_recommendation_summaries-instance_method
@@ -160,6 +162,7 @@ module Aws
                                            },
                                            group_by: ::String,
                                            ?max_results: ::Integer,
+                                           ?metrics: Array[("SavingsPercentage")],
                                            ?next_token: ::String
                                          ) -> _ListRecommendationSummariesResponseSuccess
                                        | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListRecommendationSummariesResponseSuccess

data/sig/resource.rbs

@@ -48,6 +48,7 @@ module Aws
                         ?sdk_ua_app_id: String,
                         ?secret_access_key: String,
                         ?session_token: String,
+                        ?sigv4a_signing_region_set: Array[String],
                         ?simple_json: bool,
                         ?stub_responses: untyped,
                         ?token_provider: untyped,

data/sig/types.rbs

@@ -268,6 +268,7 @@ module Aws::CostOptimizationHub
       attr_accessor filter: Types::Filter
       attr_accessor group_by: ::String
       attr_accessor max_results: ::Integer
+      attr_accessor metrics: ::Array[("SavingsPercentage")]
       attr_accessor next_token: ::String
       SENSITIVE: []
     end
@@ -277,6 +278,7 @@ module Aws::CostOptimizationHub
       attr_accessor items: ::Array[Types::RecommendationSummary]
       attr_accessor group_by: ::String
       attr_accessor currency_code: ::String
+      attr_accessor metrics: Types::SummaryMetricsResult
       attr_accessor next_token: ::String
       SENSITIVE: []
     end
@@ -550,6 +552,11 @@ module Aws::CostOptimizationHub
       SENSITIVE: []
     end
 
+    class SummaryMetricsResult
+      attr_accessor savings_percentage: ::String
+      SENSITIVE: []
+    end
+
     class Tag
       attr_accessor key: ::String
       attr_accessor value: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costoptimizationhub
 version: !ruby/object:Gem::Version
-  version: 1.9.0
+  version: 1.11.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-25 00:00:00.000000000 Z
+date: 2024-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,21 +29,21 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.5'
 description: Official AWS Ruby gem for Cost Optimization Hub. This gem is part of
   the AWS SDK for Ruby.
 email: