aws-sdk-resiliencehub 1.44.0 → 1.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87010d42b020473dd45b8f96a6b7de9fd8e21698fb2d5a4c9702f6d0e36c92cd
-  data.tar.gz: 2e4baedf3dee170db1a470baad45adb1534b36ab236759452aadfb538be982ff
+  metadata.gz: 7b34dd1335eca25fd3e9d586150557e4584c62192e63e92d7659fe56c0b190d9
+  data.tar.gz: 185bcba37bf1e2e6445f128d29e66e33e17e388182e3d2ba2c05a7f0af22ae58
 SHA512:
-  metadata.gz: 1491bb4e8a68ff9c33daaa783bf310e51fe93093da2a1ffe8aca1bd6e392d506756bcf189fe1b363dcde7f7029717e5b3d512ab46f42c46aa105138112157f9d
-  data.tar.gz: 431bd1cafde6b2665fbc35698258f2ce58192af248dacf39f6704fd432e10b06d7f3a165bff2cc7ea992c45a6bb12d073dc67c0237f9062b9db1824d8dea9f74
+  metadata.gz: ee2771ba100ad6058e5a6950dba57791729fec92fe28870e8e55b74274f03ac631c8bb927422f32825e539e2a6fd7640837ed525ae001aec004932728ad3deab
+  data.tar.gz: 3125bba8a859fe40ed6a89c799fdad62a91cdebcb873388e82dca75db7918ad4beb867fcb859aa21e56befcbb171a2df587111c619738a7c461add88a755ecbb

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.44.0
+1.45.0

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

@@ -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
@@ -2424,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
@@ -3630,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
@@ -3774,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
@@ -3781,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
@@ -5104,7 +5119,7 @@ module Aws::ResilienceHub
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-resiliencehub'
-      context[:gem_version] = '1.44.0'
+      context[:gem_version] = '1.45.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -23,6 +23,7 @@ module Aws::ResilienceHub
     AddDraftAppVersionResourceMappingsResponse = Shapes::StructureShape.new(name: 'AddDraftAppVersionResourceMappingsResponse')
     AdditionalInfoMap = Shapes::MapShape.new(name: 'AdditionalInfoMap')
     AdditionalInfoValueList = Shapes::ListShape.new(name: 'AdditionalInfoValueList')
+    Alarm = Shapes::StructureShape.new(name: 'Alarm')
     AlarmRecommendation = Shapes::StructureShape.new(name: 'AlarmRecommendation')
     AlarmRecommendationList = Shapes::ListShape.new(name: 'AlarmRecommendationList')
     AlarmReferenceIdList = Shapes::ListShape.new(name: 'AlarmReferenceIdList')
@@ -156,6 +157,7 @@ module Aws::ResilienceHub
     EventSubscriptionList = Shapes::ListShape.new(name: 'EventSubscriptionList')
     EventType = Shapes::StringShape.new(name: 'EventType')
     ExcludeRecommendationReason = Shapes::StringShape.new(name: 'ExcludeRecommendationReason')
+    Experiment = Shapes::StructureShape.new(name: 'Experiment')
     FailedGroupingRecommendationEntries = Shapes::ListShape.new(name: 'FailedGroupingRecommendationEntries')
     FailedGroupingRecommendationEntry = Shapes::StructureShape.new(name: 'FailedGroupingRecommendationEntry')
     FailurePolicy = Shapes::StructureShape.new(name: 'FailurePolicy')
@@ -373,6 +375,10 @@ module Aws::ResilienceHub
 
     AdditionalInfoValueList.member = Shapes::ShapeRef.new(shape: String1024)
 
+    Alarm.add_member(:alarm_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "alarmArn"))
+    Alarm.add_member(:source, Shapes::ShapeRef.new(shape: String255, location_name: "source"))
+    Alarm.struct_class = Types::Alarm
+
     AlarmRecommendation.add_member(:app_component_name, Shapes::ShapeRef.new(shape: EntityId, deprecated: true, location_name: "appComponentName", metadata: {"deprecatedMessage"=>"An alarm recommendation can be attached to multiple Application Components, hence this property will be replaced by the new property 'appComponentNames'."}))
     AlarmRecommendation.add_member(:app_component_names, Shapes::ShapeRef.new(shape: AppComponentNameList, location_name: "appComponentNames"))
     AlarmRecommendation.add_member(:description, Shapes::ShapeRef.new(shape: EntityDescription, location_name: "description"))
@@ -537,6 +543,7 @@ module Aws::ResilienceHub
 
     BatchUpdateRecommendationStatusSuccessfulEntries.member = Shapes::ShapeRef.new(shape: BatchUpdateRecommendationStatusSuccessfulEntry)
 
+    BatchUpdateRecommendationStatusSuccessfulEntry.add_member(:app_component_id, Shapes::ShapeRef.new(shape: EntityName255, location_name: "appComponentId"))
     BatchUpdateRecommendationStatusSuccessfulEntry.add_member(:entry_id, Shapes::ShapeRef.new(shape: String255, required: true, location_name: "entryId"))
     BatchUpdateRecommendationStatusSuccessfulEntry.add_member(:exclude_reason, Shapes::ShapeRef.new(shape: ExcludeRecommendationReason, location_name: "excludeReason"))
     BatchUpdateRecommendationStatusSuccessfulEntry.add_member(:excluded, Shapes::ShapeRef.new(shape: BooleanOptional, required: true, location_name: "excluded"))
@@ -878,6 +885,10 @@ module Aws::ResilienceHub
 
     EventSubscriptionList.member = Shapes::ShapeRef.new(shape: EventSubscription)
 
+    Experiment.add_member(:experiment_arn, Shapes::ShapeRef.new(shape: String255, location_name: "experimentArn"))
+    Experiment.add_member(:experiment_template_id, Shapes::ShapeRef.new(shape: String255, location_name: "experimentTemplateId"))
+    Experiment.struct_class = Types::Experiment
+
     FailedGroupingRecommendationEntries.member = Shapes::ShapeRef.new(shape: FailedGroupingRecommendationEntry)
 
     FailedGroupingRecommendationEntry.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, required: true, location_name: "errorMessage"))
@@ -1218,8 +1229,10 @@ module Aws::ResilienceHub
     RecommendationIdList.member = Shapes::ShapeRef.new(shape: Uuid)
 
     RecommendationItem.add_member(:already_implemented, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "alreadyImplemented"))
+    RecommendationItem.add_member(:discovered_alarm, Shapes::ShapeRef.new(shape: Alarm, location_name: "discoveredAlarm"))
     RecommendationItem.add_member(:exclude_reason, Shapes::ShapeRef.new(shape: ExcludeRecommendationReason, location_name: "excludeReason"))
     RecommendationItem.add_member(:excluded, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "excluded"))
+    RecommendationItem.add_member(:latest_discovered_experiment, Shapes::ShapeRef.new(shape: Experiment, location_name: "latestDiscoveredExperiment"))
     RecommendationItem.add_member(:resource_id, Shapes::ShapeRef.new(shape: String500, location_name: "resourceId"))
     RecommendationItem.add_member(:target_account_id, Shapes::ShapeRef.new(shape: CustomerId, location_name: "targetAccountId"))
     RecommendationItem.add_member(:target_region, Shapes::ShapeRef.new(shape: AwsRegion, location_name: "targetRegion"))
@@ -1431,6 +1444,7 @@ module Aws::ResilienceHub
 
     TerraformSourceList.member = Shapes::ShapeRef.new(shape: TerraformSource)
 
+    TestRecommendation.add_member(:app_component_id, Shapes::ShapeRef.new(shape: EntityName255, location_name: "appComponentId"))
     TestRecommendation.add_member(:app_component_name, Shapes::ShapeRef.new(shape: EntityId, location_name: "appComponentName"))
     TestRecommendation.add_member(:depends_on_alarms, Shapes::ShapeRef.new(shape: AlarmReferenceIdList, location_name: "dependsOnAlarms"))
     TestRecommendation.add_member(:description, Shapes::ShapeRef.new(shape: String500, location_name: "description"))
@@ -1522,6 +1536,7 @@ module Aws::ResilienceHub
 
     UpdateRecommendationStatusRequestEntries.member = Shapes::ShapeRef.new(shape: UpdateRecommendationStatusRequestEntry)
 
+    UpdateRecommendationStatusRequestEntry.add_member(:app_component_id, Shapes::ShapeRef.new(shape: EntityName255, location_name: "appComponentId"))
     UpdateRecommendationStatusRequestEntry.add_member(:entry_id, Shapes::ShapeRef.new(shape: String255, required: true, location_name: "entryId"))
     UpdateRecommendationStatusRequestEntry.add_member(:exclude_reason, Shapes::ShapeRef.new(shape: ExcludeRecommendationReason, location_name: "excludeReason"))
     UpdateRecommendationStatusRequestEntry.add_member(:excluded, Shapes::ShapeRef.new(shape: BooleanOptional, required: true, location_name: "excluded"))

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

@@ -155,6 +155,29 @@ module Aws::ResilienceHub
       include Aws::Structure
     end
 
+    # Indicates the Amazon CloudWatch alarm detected while running an
+    # assessment.
+    #
+    # @!attribute [rw] alarm_arn
+    #   Amazon Resource Name (ARN) of the Amazon CloudWatch alarm.
+    #   @return [String]
+    #
+    # @!attribute [rw] source
+    #   Indicates the source of the Amazon CloudWatch alarm. That is, it
+    #   indicates if the alarm was created using Resilience Hub
+    #   recommendation (`AwsResilienceHub`), or if you had created the alarm
+    #   in Amazon CloudWatch (`Customer`).
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/Alarm AWS API Documentation
+    #
+    class Alarm < Struct.new(
+      :alarm_arn,
+      :source)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Defines a recommendation for a CloudWatch alarm.
     #
     # @!attribute [rw] app_component_name
@@ -846,7 +869,7 @@ module Aws::ResilienceHub
     #
     # @!attribute [rw] app_components
     #   Indicates the Application Components (AppComponents) that were
-    #   assessed as part of the assessnent and are associated with the
+    #   assessed as part of the assessment and are associated with the
     #   identified risk and recommendation.
     #
     #   <note markdown="1"> This property is available only in the US East (N. Virginia) Region.
@@ -1005,6 +1028,10 @@ module Aws::ResilienceHub
     # List of operational recommendations that were successfully included or
     # excluded.
     #
+    # @!attribute [rw] app_component_id
+    #   Indicates the identifier of an AppComponent.
+    #   @return [String]
+    #
     # @!attribute [rw] entry_id
     #   An identifier for an entry in this batch that is used to communicate
     #   the result.
@@ -1035,6 +1062,7 @@ module Aws::ResilienceHub
     # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/BatchUpdateRecommendationStatusSuccessfulEntry AWS API Documentation
     #
     class BatchUpdateRecommendationStatusSuccessfulEntry < Struct.new(
+      :app_component_id,
       :entry_id,
       :exclude_reason,
       :excluded,
@@ -3149,6 +3177,25 @@ module Aws::ResilienceHub
       include Aws::Structure
     end
 
+    # Indicates the FIS experiment detected while running an assessment.
+    #
+    # @!attribute [rw] experiment_arn
+    #   Amazon Resource Name (ARN) of the FIS experiment.
+    #   @return [String]
+    #
+    # @!attribute [rw] experiment_template_id
+    #   Identifier of the FIS experiment template.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/Experiment AWS API Documentation
+    #
+    class Experiment < Struct.new(
+      :experiment_arn,
+      :experiment_template_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Indicates the accepted grouping recommendation whose implementation
     # failed.
     #
@@ -4724,6 +4771,11 @@ module Aws::ResilienceHub
     #   Principle to obtain a read-only access to your application resources
     #   while running an assessment.
     #
+    #   If your IAM role includes a path, you must include the path in the
+    #   `invokerRoleName` parameter. For example, if your IAM role's ARN is
+    #   `arn:aws:iam:123456789012:role/my-path/role-name`, you should pass
+    #   `my-path/role-name`.
+    #
     #   <note markdown="1"> * You must have `iam:passRole` permission for this role while
     #     creating or updating the application.
     #
@@ -5298,6 +5350,11 @@ module Aws::ResilienceHub
     #   Specifies if the recommendation has already been implemented.
     #   @return [Boolean]
     #
+    # @!attribute [rw] discovered_alarm
+    #   Indicates the previously implemented Amazon CloudWatch alarm
+    #   discovered by Resilience Hub.
+    #   @return [Types::Alarm]
+    #
     # @!attribute [rw] exclude_reason
     #   Indicates the reason for excluding an operational recommendation.
     #   @return [String]
@@ -5306,6 +5363,11 @@ module Aws::ResilienceHub
     #   Indicates if an operational recommendation item is excluded.
     #   @return [Boolean]
     #
+    # @!attribute [rw] latest_discovered_experiment
+    #   Indicates the experiment created in FIS that was discovered by
+    #   Resilience Hub, which matches the recommendation.
+    #   @return [Types::Experiment]
+    #
     # @!attribute [rw] resource_id
     #   Identifier of the resource.
     #   @return [String]
@@ -5322,8 +5384,10 @@ module Aws::ResilienceHub
     #
     class RecommendationItem < Struct.new(
       :already_implemented,
+      :discovered_alarm,
       :exclude_reason,
       :excluded,
+      :latest_discovered_experiment,
       :resource_id,
       :target_account_id,
       :target_region)
@@ -6317,6 +6381,10 @@ module Aws::ResilienceHub
 
     # Defines a test recommendation.
     #
+    # @!attribute [rw] app_component_id
+    #   Indicates the identifier of the AppComponent.
+    #   @return [String]
+    #
     # @!attribute [rw] app_component_name
     #   Name of the Application Component.
     #   @return [String]
@@ -6369,6 +6437,7 @@ module Aws::ResilienceHub
     # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/TestRecommendation AWS API Documentation
     #
     class TestRecommendation < Struct.new(
+      :app_component_id,
       :app_component_name,
       :depends_on_alarms,
       :description,
@@ -6824,6 +6893,10 @@ module Aws::ResilienceHub
     # Defines the operational recommendation item that is to be included or
     # excluded.
     #
+    # @!attribute [rw] app_component_id
+    #   Indicates the identifier of the AppComponent.
+    #   @return [String]
+    #
     # @!attribute [rw] entry_id
     #   An identifier for an entry in this batch that is used to communicate
     #   the result.
@@ -6854,6 +6927,7 @@ module Aws::ResilienceHub
     # @see http://docs.aws.amazon.com/goto/WebAPI/resiliencehub-2020-04-30/UpdateRecommendationStatusRequestEntry AWS API Documentation
     #
     class UpdateRecommendationStatusRequestEntry < Struct.new(
+      :app_component_id,
       :entry_id,
       :exclude_reason,
       :excluded,

data/lib/aws-sdk-resiliencehub.rb

@@ -54,7 +54,7 @@ module Aws::ResilienceHub
   autoload :EndpointProvider, 'aws-sdk-resiliencehub/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-resiliencehub/endpoints'
 
-  GEM_VERSION = '1.44.0'
+  GEM_VERSION = '1.45.0'
 
 end
 

data/sig/client.rbs

@@ -131,6 +131,7 @@ module Aws
                                                 app_arn: ::String,
                                                 request_entries: Array[
                                                   {
+                                                    app_component_id: ::String?,
                                                     entry_id: ::String,
                                                     exclude_reason: ("AlreadyImplemented" | "NotRelevant" | "ComplexityOfImplementation")?,
                                                     excluded: bool,

data/sig/types.rbs

@@ -43,6 +43,12 @@ module Aws::ResilienceHub
       SENSITIVE: []
     end
 
+    class Alarm
+      attr_accessor alarm_arn: ::String
+      attr_accessor source: ::String
+      SENSITIVE: []
+    end
+
     class AlarmRecommendation
       attr_accessor app_component_name: ::String
       attr_accessor app_component_names: ::Array[::String]
@@ -207,6 +213,7 @@ module Aws::ResilienceHub
     end
 
     class BatchUpdateRecommendationStatusSuccessfulEntry
+      attr_accessor app_component_id: ::String
       attr_accessor entry_id: ::String
       attr_accessor exclude_reason: ("AlreadyImplemented" | "NotRelevant" | "ComplexityOfImplementation")
       attr_accessor excluded: bool
@@ -637,6 +644,12 @@ module Aws::ResilienceHub
       SENSITIVE: []
     end
 
+    class Experiment
+      attr_accessor experiment_arn: ::String
+      attr_accessor experiment_template_id: ::String
+      SENSITIVE: []
+    end
+
     class FailedGroupingRecommendationEntry
       attr_accessor error_message: ::String
       attr_accessor grouping_recommendation_id: ::String
@@ -1081,8 +1094,10 @@ module Aws::ResilienceHub
 
     class RecommendationItem
       attr_accessor already_implemented: bool
+      attr_accessor discovered_alarm: Types::Alarm
       attr_accessor exclude_reason: ("AlreadyImplemented" | "NotRelevant" | "ComplexityOfImplementation")
       attr_accessor excluded: bool
+      attr_accessor latest_discovered_experiment: Types::Experiment
       attr_accessor resource_id: ::String
       attr_accessor target_account_id: ::String
       attr_accessor target_region: ::String
@@ -1315,6 +1330,7 @@ module Aws::ResilienceHub
     end
 
     class TestRecommendation
+      attr_accessor app_component_id: ::String
       attr_accessor app_component_name: ::String
       attr_accessor depends_on_alarms: ::Array[::String]
       attr_accessor description: ::String
@@ -1427,6 +1443,7 @@ module Aws::ResilienceHub
     end
 
     class UpdateRecommendationStatusRequestEntry
+      attr_accessor app_component_id: ::String
       attr_accessor entry_id: ::String
       attr_accessor exclude_reason: ("AlreadyImplemented" | "NotRelevant" | "ComplexityOfImplementation")
       attr_accessor excluded: bool

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-resiliencehub
 version: !ruby/object:Gem::Version
-  version: 1.44.0
+  version: 1.45.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-21 00:00:00.000000000 Z
+date: 2024-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core