aws-sdk-resiliencehub 1.43.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9621ddca7b5db13ce2c1bd8f441b81952a243ed5e723dbad8bf6b38659431d50
-  data.tar.gz: a0d99ba526bedebf0e801fdf88a5f30e254cea4e03af941c76d8d0f56212359e
+  metadata.gz: 7b34dd1335eca25fd3e9d586150557e4584c62192e63e92d7659fe56c0b190d9
+  data.tar.gz: 185bcba37bf1e2e6445f128d29e66e33e17e388182e3d2ba2c05a7f0af22ae58
 SHA512:
-  metadata.gz: a60790c408a9aa71ee0717238988d9a4dfddc774275417e7f1c22461d1302b3c1e5c6f4a5d219f5e8e612fbd449d45ec213fe7e6f7d64aa6b27d14218378c820
-  data.tar.gz: 2905f36cd94d87ebe0409b8803245abfb2083c86f3eff050e88f8a75d4ed2deab9594345a3f010a65919e3e13967ba19068d2c9e78d0e166336afcaaac9676c3
+  metadata.gz: ee2771ba100ad6058e5a6950dba57791729fec92fe28870e8e55b74274f03ac631c8bb927422f32825e539e2a6fd7640837ed525ae001aec004932728ad3deab
+  data.tar.gz: 3125bba8a859fe40ed6a89c799fdad62a91cdebcb873388e82dca75db7918ad4beb867fcb859aa21e56befcbb171a2df587111c619738a7c461add88a755ecbb

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.45.0 (2024-12-18)
+------------------
+
+* Feature - AWS Resilience Hub now automatically detects already configured CloudWatch alarms and FIS experiments as part of the assessment process and returns the discovered resources in the corresponding list API responses. It also allows you to include or exclude test recommendations for an AppComponent.
+
+1.44.0 (2024-11-21)
+------------------
+
+* Feature - AWS Resilience Hub's new summary view visually represents applications' resilience through charts, enabling efficient resilience management. It provides a consolidated view of the app portfolio's resilience state and allows data export for custom stakeholder reporting.
+
 1.43.0 (2024-11-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.45.0

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

@@ -462,8 +462,8 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [required, Array<Types::AcceptGroupingRecommendationEntry>] :entries
-    #   Indicates the list of resource grouping recommendations you want to
-    #   include in your application.
+    #   List of resource grouping recommendations you want to include in your
+    #   application.
     #
     # @return [Types::AcceptResourceGroupingRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -613,6 +613,7 @@ module Aws::ResilienceHub
     #     app_arn: "Arn", # required
     #     request_entries: [ # required
     #       {
+    #         app_component_id: "EntityName255",
     #         entry_id: "String255", # required
     #         exclude_reason: "AlreadyImplemented", # accepts AlreadyImplemented, NotRelevant, ComplexityOfImplementation
     #         excluded: false, # required
@@ -633,6 +634,7 @@ module Aws::ResilienceHub
     #   resp.failed_entries[0].entry_id #=> String
     #   resp.failed_entries[0].error_message #=> String
     #   resp.successful_entries #=> Array
+    #   resp.successful_entries[0].app_component_id #=> String
     #   resp.successful_entries[0].entry_id #=> String
     #   resp.successful_entries[0].exclude_reason #=> String, one of "AlreadyImplemented", "NotRelevant", "ComplexityOfImplementation"
     #   resp.successful_entries[0].excluded #=> Boolean
@@ -1147,10 +1149,10 @@ module Aws::ResilienceHub
     #   time objective (RTO) and recovery point objective (RPO) in seconds.
     #
     # @option params [String] :policy_description
-    #   The description for the policy.
+    #   Description of the resiliency policy.
     #
     # @option params [required, String] :policy_name
-    #   The name of the policy
+    #   Name of the resiliency policy.
     #
     # @option params [Hash<String,String>] :tags
     #   Tags assigned to the resource. A tag is a label that you assign to an
@@ -2163,6 +2165,41 @@ module Aws::ResilienceHub
       req.send_request(options)
     end
 
+    # Describes the metrics of the application configuration being exported.
+    #
+    # @option params [required, String] :metrics_export_id
+    #   Identifier of the metrics export task.
+    #
+    # @return [Types::DescribeMetricsExportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeMetricsExportResponse#error_message #error_message} => String
+    #   * {Types::DescribeMetricsExportResponse#export_location #export_location} => Types::S3Location
+    #   * {Types::DescribeMetricsExportResponse#metrics_export_id #metrics_export_id} => String
+    #   * {Types::DescribeMetricsExportResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_metrics_export({
+    #     metrics_export_id: "String255", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.error_message #=> String
+    #   resp.export_location.bucket #=> String
+    #   resp.export_location.prefix #=> String
+    #   resp.metrics_export_id #=> String
+    #   resp.status #=> String, one of "Pending", "InProgress", "Failed", "Success"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/DescribeMetricsExport AWS API Documentation
+    #
+    # @overload describe_metrics_export(params = {})
+    # @param [Hash] params ({})
+    def describe_metrics_export(params = {}, options = {})
+      req = build_request(:describe_metrics_export, params)
+      req.send_request(options)
+    end
+
     # Describes a specified resiliency policy for an Resilience Hub
     # application. The returned policy object includes creation time, data
     # location constraints, the Amazon Resource Name (ARN) for the policy,
@@ -2228,7 +2265,7 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [String] :grouping_id
-    #   Indicates the identifier of the grouping recommendation task.
+    #   Identifier of the grouping recommendation task.
     #
     # @return [Types::DescribeResourceGroupingRecommendationTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2389,8 +2426,12 @@ module Aws::ResilienceHub
     #   resp.alarm_recommendations[0].description #=> String
     #   resp.alarm_recommendations[0].items #=> Array
     #   resp.alarm_recommendations[0].items[0].already_implemented #=> Boolean
+    #   resp.alarm_recommendations[0].items[0].discovered_alarm.alarm_arn #=> String
+    #   resp.alarm_recommendations[0].items[0].discovered_alarm.source #=> String
     #   resp.alarm_recommendations[0].items[0].exclude_reason #=> String, one of "AlreadyImplemented", "NotRelevant", "ComplexityOfImplementation"
     #   resp.alarm_recommendations[0].items[0].excluded #=> Boolean
+    #   resp.alarm_recommendations[0].items[0].latest_discovered_experiment.experiment_arn #=> String
+    #   resp.alarm_recommendations[0].items[0].latest_discovered_experiment.experiment_template_id #=> String
     #   resp.alarm_recommendations[0].items[0].resource_id #=> String
     #   resp.alarm_recommendations[0].items[0].target_account_id #=> String
     #   resp.alarm_recommendations[0].items[0].target_region #=> String
@@ -2411,8 +2452,8 @@ module Aws::ResilienceHub
       req.send_request(options)
     end
 
-    # Indicates the list of compliance drifts that were detected while
-    # running an assessment.
+    # List of compliance drifts that were detected while running an
+    # assessment.
     #
     # @option params [required, String] :assessment_arn
     #   Amazon Resource Name (ARN) of the assessment. The format for this ARN
@@ -2426,7 +2467,7 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [Integer] :max_results
-    #   Indicates the maximum number of compliance drifts requested.
+    #   Maximum number of compliance drifts requested.
     #
     # @option params [String] :next_token
     #   Null, or the token from a previous call to get the next set of
@@ -2491,8 +2532,8 @@ module Aws::ResilienceHub
       req.send_request(options)
     end
 
-    # Indicates the list of resource drifts that were detected while running
-    # an assessment.
+    # List of resource drifts that were detected while running an
+    # assessment.
     #
     # @option params [required, String] :assessment_arn
     #   Amazon Resource Name (ARN) of the assessment. The format for this ARN
@@ -2506,10 +2547,10 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [Integer] :max_results
-    #   Indicates the maximum number of drift results to include in the
-    #   response. If more results exist than the specified `MaxResults` value,
-    #   a token is included in the response so that the remaining results can
-    #   be retrieved.
+    #   Maximum number of drift results to include in the response. If more
+    #   results exist than the specified `MaxResults` value, a token is
+    #   included in the response so that the remaining results can be
+    #   retrieved.
     #
     # @option params [String] :next_token
     #   Null, or the token from a previous call to get the next set of
@@ -3184,8 +3225,8 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [Time,DateTime,Date,Integer,String] :from_last_assessment_time
-    #   Indicates the lower limit of the range that is used to filter
-    #   applications based on their last assessment times.
+    #   Lower limit of the range that is used to filter applications based on
+    #   their last assessment times.
     #
     # @option params [Integer] :max_results
     #   Maximum number of results to include in the response. If more results
@@ -3206,8 +3247,8 @@ module Aws::ResilienceHub
     #   descending order, set this field to `True`.
     #
     # @option params [Time,DateTime,Date,Integer,String] :to_last_assessment_time
-    #   Indicates the upper limit of the range that is used to filter the
-    #   applications based on their last assessment times.
+    #   Upper limit of the range that is used to filter the applications based
+    #   on their last assessment times.
     #
     # @return [Types::ListAppsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3256,6 +3297,81 @@ module Aws::ResilienceHub
       req.send_request(options)
     end
 
+    # Lists the metrics that can be exported.
+    #
+    # @option params [Array<Types::Condition>] :conditions
+    #   Indicates the list of all the conditions that were applied on the
+    #   metrics.
+    #
+    # @option params [String] :data_source
+    #   Indicates the data source of the metrics.
+    #
+    # @option params [Array<Types::Field>] :fields
+    #   Indicates the list of fields in the data source.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to include in the response. If more results
+    #   exist than the specified `MaxResults` value, a token is included in
+    #   the response so that the remaining results can be retrieved.
+    #
+    # @option params [String] :next_token
+    #   Null, or the token from a previous call to get the next set of
+    #   results.
+    #
+    # @option params [Array<Types::Sort>] :sorts
+    #   (Optional) Indicates the order in which you want to sort the fields in
+    #   the metrics. By default, the fields are sorted in the ascending order.
+    #
+    # @return [Types::ListMetricsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListMetricsResponse#next_token #next_token} => String
+    #   * {Types::ListMetricsResponse#rows #rows} => Array&lt;Array&lt;String&gt;&gt;
+    #
+    # 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.list_metrics({
+    #     conditions: [
+    #       {
+    #         field: "String255", # required
+    #         operator: "Equals", # required, accepts Equals, NotEquals, GreaterThen, GreaterOrEquals, LessThen, LessOrEquals
+    #         value: "String255",
+    #       },
+    #     ],
+    #     data_source: "String255",
+    #     fields: [
+    #       {
+    #         aggregation: "Min", # accepts Min, Max, Sum, Avg, Count
+    #         name: "String255", # required
+    #       },
+    #     ],
+    #     max_results: 1,
+    #     next_token: "NextToken",
+    #     sorts: [
+    #       {
+    #         ascending: false,
+    #         field: "String255", # required
+    #       },
+    #     ],
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.rows #=> Array
+    #   resp.rows[0] #=> Array
+    #   resp.rows[0][0] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/ListMetrics AWS API Documentation
+    #
+    # @overload list_metrics(params = {})
+    # @param [Hash] params ({})
+    def list_metrics(params = {}, options = {})
+      req = build_request(:list_metrics, params)
+      req.send_request(options)
+    end
+
     # Lists the recommendation templates for the Resilience Hub
     # applications.
     #
@@ -3355,7 +3471,7 @@ module Aws::ResilienceHub
     #   results.
     #
     # @option params [String] :policy_name
-    #   The name of the policy
+    #   Name of the resiliency policy.
     #
     # @return [Types::ListResiliencyPoliciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3520,8 +3636,12 @@ module Aws::ResilienceHub
     #   resp.sop_recommendations[0].description #=> String
     #   resp.sop_recommendations[0].items #=> Array
     #   resp.sop_recommendations[0].items[0].already_implemented #=> Boolean
+    #   resp.sop_recommendations[0].items[0].discovered_alarm.alarm_arn #=> String
+    #   resp.sop_recommendations[0].items[0].discovered_alarm.source #=> String
     #   resp.sop_recommendations[0].items[0].exclude_reason #=> String, one of "AlreadyImplemented", "NotRelevant", "ComplexityOfImplementation"
     #   resp.sop_recommendations[0].items[0].excluded #=> Boolean
+    #   resp.sop_recommendations[0].items[0].latest_discovered_experiment.experiment_arn #=> String
+    #   resp.sop_recommendations[0].items[0].latest_discovered_experiment.experiment_template_id #=> String
     #   resp.sop_recommendations[0].items[0].resource_id #=> String
     #   resp.sop_recommendations[0].items[0].target_account_id #=> String
     #   resp.sop_recommendations[0].items[0].target_region #=> String
@@ -3664,6 +3784,7 @@ module Aws::ResilienceHub
     #
     #   resp.next_token #=> String
     #   resp.test_recommendations #=> Array
+    #   resp.test_recommendations[0].app_component_id #=> String
     #   resp.test_recommendations[0].app_component_name #=> String
     #   resp.test_recommendations[0].depends_on_alarms #=> Array
     #   resp.test_recommendations[0].depends_on_alarms[0] #=> String
@@ -3671,8 +3792,12 @@ module Aws::ResilienceHub
     #   resp.test_recommendations[0].intent #=> String
     #   resp.test_recommendations[0].items #=> Array
     #   resp.test_recommendations[0].items[0].already_implemented #=> Boolean
+    #   resp.test_recommendations[0].items[0].discovered_alarm.alarm_arn #=> String
+    #   resp.test_recommendations[0].items[0].discovered_alarm.source #=> String
     #   resp.test_recommendations[0].items[0].exclude_reason #=> String, one of "AlreadyImplemented", "NotRelevant", "ComplexityOfImplementation"
     #   resp.test_recommendations[0].items[0].excluded #=> Boolean
+    #   resp.test_recommendations[0].items[0].latest_discovered_experiment.experiment_arn #=> String
+    #   resp.test_recommendations[0].items[0].latest_discovered_experiment.experiment_template_id #=> String
     #   resp.test_recommendations[0].items[0].resource_id #=> String
     #   resp.test_recommendations[0].items[0].target_account_id #=> String
     #   resp.test_recommendations[0].items[0].target_region #=> String
@@ -4102,8 +4227,8 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [required, Array<Types::RejectGroupingRecommendationEntry>] :entries
-    #   Indicates the list of resource grouping recommendations you have
-    #   selected to exclude from your application.
+    #   List of resource grouping recommendations you have selected to exclude
+    #   from your application.
     #
     # @return [Types::RejectResourceGroupingRecommendationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4374,6 +4499,46 @@ module Aws::ResilienceHub
       req.send_request(options)
     end
 
+    # Initiates the export task of metrics.
+    #
+    # @option params [String] :bucket_name
+    #   (Optional) Specifies the name of the Amazon Simple Storage Service
+    #   bucket where the exported metrics will be stored.
+    #
+    # @option params [String] :client_token
+    #   Used for an idempotency token. A client token is a unique,
+    #   case-sensitive string of up to 64 ASCII characters. You should not
+    #   reuse the same client token for other API requests.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @return [Types::StartMetricsExportResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartMetricsExportResponse#metrics_export_id #metrics_export_id} => String
+    #   * {Types::StartMetricsExportResponse#status #status} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_metrics_export({
+    #     bucket_name: "EntityName",
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.metrics_export_id #=> String
+    #   resp.status #=> String, one of "Pending", "InProgress", "Failed", "Success"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/StartMetricsExport AWS API Documentation
+    #
+    # @overload start_metrics_export(params = {})
+    # @param [Hash] params ({})
+    def start_metrics_export(params = {}, options = {})
+      req = build_request(:start_metrics_export, params)
+      req.send_request(options)
+    end
+
     # Starts grouping recommendation task.
     #
     # @option params [required, String] :app_arn
@@ -4868,8 +5033,8 @@ module Aws::ResilienceHub
     #   resilience policy data can be stored.
     #
     # @option params [Hash<String,Types::FailurePolicy>] :policy
-    #   The type of resiliency policy to be created, including the recovery
-    #   time objective (RTO) and recovery point objective (RPO) in seconds.
+    #   Resiliency policy to be created, including the recovery time objective
+    #   (RTO) and recovery point objective (RPO) in seconds.
     #
     # @option params [required, String] :policy_arn
     #   Amazon Resource Name (ARN) of the resiliency policy. The format for
@@ -4883,10 +5048,10 @@ module Aws::ResilienceHub
     #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
     #
     # @option params [String] :policy_description
-    #   The description for the policy.
+    #   Description of the resiliency policy.
     #
     # @option params [String] :policy_name
-    #   The name of the policy
+    #   Name of the resiliency policy.
     #
     # @option params [String] :tier
     #   The tier for this resiliency policy, ranging from the highest severity
@@ -4954,7 +5119,7 @@ module Aws::ResilienceHub
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-resiliencehub'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end