aws-sdk-ssm 1.134.0 → 1.137.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2512bb3a936e42c877b4a77ac1b32a1ddc1e62b6e25bef86714874e9ffca2e2
-  data.tar.gz: 9106e7b85920d41e79ef293bfd48588941fba1dc1bf5fb1029ad1bc40f68eafa
+  metadata.gz: 886618fdef13902675fafbb1348fea3df807eee583dc048dcf5698846eb6f35b
+  data.tar.gz: 46abc9049a9fa553fb833a3c86596bfe115c45c165f8954434e53d43a7901d76
 SHA512:
-  metadata.gz: 99cc9d2c0fefce4a1cacee4cd367e637288c967e3d90639dc0cec04c012ed1b6a9468fda8aa474074982abeed6367eb7dd36ccec6dbd0cfd1430e1cedc01bb7d
-  data.tar.gz: 0aae2c54b63d3d3062050fd949e5ce5780a217bb726d161d09b8539d16b6cf8bce2526a23c69f7737f2faa60e7ac8fdc9fb1e5f13466e5fc7ad112d97af883af
+  metadata.gz: 939da93c044acdf02436e09f6ba69c0305a783cda1fccea51f8625e8402235f73d3171ac9ea094a6f03938450b6e4f5bcf7c9af31e706f3276ec8c411b614e5d
+  data.tar.gz: a2e554c522805d883f62aa77fcceb67d4c38fe84548368c1fd9117676155a9ff8d22252e0bad43931ac17a4686ffff5d3c6029c64d017d4563f5fbc804f7b1b7

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.137.0 (2022-05-04)
+------------------
+
+* Feature - This release adds the TargetMaps parameter in SSM State Manager API.
+
+1.136.0 (2022-04-29)
+------------------
+
+* Feature - Update the StartChangeRequestExecution, adding TargetMaps to the Runbook parameter
+
+1.135.0 (2022-04-19)
+------------------
+
+* Feature - Added offset support for specifying the number of days to wait after the date and time specified by a CRON expression when creating SSM association.
+
 1.134.0 (2022-03-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.134.0
+1.137.0

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

@@ -362,13 +362,14 @@ module Aws::SSM
     # @!group API Operations
 
     # Adds or overwrites one or more tags for the specified resource. Tags
-    # are metadata that you can assign to your documents, managed nodes,
-    # maintenance windows, Parameter Store parameters, and patch baselines.
-    # Tags enable you to categorize your resources in different ways, for
-    # example, by purpose, owner, or environment. Each tag consists of a key
-    # and an optional value, both of which you define. For example, you
-    # could define a set of tags for your account's managed nodes that
-    # helps you track each node's owner and stack level. For example:
+    # are metadata that you can assign to your automations, documents,
+    # managed nodes, maintenance windows, Parameter Store parameters, and
+    # patch baselines. Tags enable you to categorize your resources in
+    # different ways, for example, by purpose, owner, or environment. Each
+    # tag consists of a key and an optional value, both of which you define.
+    # For example, you could define a set of tags for your account's
+    # managed nodes that helps you track each node's owner and stack level.
+    # For example:
     #
     # * `Key=Owner,Value=DbAdmin`
     #
@@ -382,7 +383,8 @@ module Aws::SSM
     #
     # * `Key=Stack,Value=Test`
     #
-    # Each resource can have a maximum of 50 tags.
+    # Most resources can have a maximum of 50 tags. Automations can have a
+    # maximum of 5 tags.
     #
     # We recommend that you devise a set of tag keys that meets your needs
     # for each resource type. Using a consistent set of tag keys makes it
@@ -416,6 +418,8 @@ module Aws::SSM
     #
     #   `PatchBaseline`\: `pb-012345abcde`
     #
+    #   `Automation`\: `example-c160-4567-8519-012345abcde`
+    #
     #   `OpsMetadata` object: `ResourceID` for tagging is created from the
     #   Amazon Resource Name (ARN) for the object. Specifically, `ResourceID`
     #   is created from the strings that come after the word `opsmetadata` in
@@ -871,6 +875,29 @@ module Aws::SSM
     #   action to create an association in multiple Regions and multiple
     #   accounts.
     #
+    # @option params [Integer] :schedule_offset
+    #   Number of days to wait after the scheduled day to run an association.
+    #   For example, if you specified a cron schedule of `cron(0 0 ? * THU#2
+    #   *)`, you could specify an offset of 3 to run the association each
+    #   Sunday after the second Thursday of the month. For more information
+    #   about cron schedules for associations, see [Reference: Cron and rate
+    #   expressions for Systems Manager][1] in the *Amazon Web Services
+    #   Systems Manager User Guide*.
+    #
+    #   <note markdown="1"> To use offsets, you must specify the `ApplyOnlyAtCronInterval`
+    #   parameter. This option tells the system not to run an association
+    #   immediately after you create it.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html
+    #
+    # @option params [Array<Hash>] :target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #
     # @return [Types::CreateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAssociationResult#association_description #association_description} => Types::AssociationDescription
@@ -915,6 +942,12 @@ module Aws::SSM
     #         execution_role_name: "ExecutionRoleName",
     #       },
     #     ],
+    #     schedule_offset: 1,
+    #     target_maps: [
+    #       {
+    #         "TargetMapKey" => ["TargetMapValue"],
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -964,6 +997,11 @@ module Aws::SSM
     #   resp.association_description.target_locations[0].target_location_max_concurrency #=> String
     #   resp.association_description.target_locations[0].target_location_max_errors #=> String
     #   resp.association_description.target_locations[0].execution_role_name #=> String
+    #   resp.association_description.schedule_offset #=> Integer
+    #   resp.association_description.target_maps #=> Array
+    #   resp.association_description.target_maps[0] #=> Hash
+    #   resp.association_description.target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.association_description.target_maps[0]["TargetMapKey"][0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociation AWS API Documentation
     #
@@ -1036,6 +1074,12 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #       },
     #     ],
     #   })
@@ -1088,6 +1132,11 @@ module Aws::SSM
     #   resp.successful[0].target_locations[0].target_location_max_concurrency #=> String
     #   resp.successful[0].target_locations[0].target_location_max_errors #=> String
     #   resp.successful[0].target_locations[0].execution_role_name #=> String
+    #   resp.successful[0].schedule_offset #=> Integer
+    #   resp.successful[0].target_maps #=> Array
+    #   resp.successful[0].target_maps[0] #=> Hash
+    #   resp.successful[0].target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.successful[0].target_maps[0]["TargetMapKey"][0] #=> String
     #   resp.failed #=> Array
     #   resp.failed[0].entry.name #=> String
     #   resp.failed[0].entry.instance_id #=> String
@@ -1120,6 +1169,11 @@ module Aws::SSM
     #   resp.failed[0].entry.target_locations[0].target_location_max_concurrency #=> String
     #   resp.failed[0].entry.target_locations[0].target_location_max_errors #=> String
     #   resp.failed[0].entry.target_locations[0].execution_role_name #=> String
+    #   resp.failed[0].entry.schedule_offset #=> Integer
+    #   resp.failed[0].entry.target_maps #=> Array
+    #   resp.failed[0].entry.target_maps[0] #=> Hash
+    #   resp.failed[0].entry.target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.failed[0].entry.target_maps[0]["TargetMapKey"][0] #=> String
     #   resp.failed[0].message #=> String
     #   resp.failed[0].fault #=> String, one of "Client", "Server", "Unknown"
     #
@@ -2612,6 +2666,11 @@ module Aws::SSM
     #   resp.association_description.target_locations[0].target_location_max_concurrency #=> String
     #   resp.association_description.target_locations[0].target_location_max_errors #=> String
     #   resp.association_description.target_locations[0].execution_role_name #=> String
+    #   resp.association_description.schedule_offset #=> Integer
+    #   resp.association_description.target_maps #=> Array
+    #   resp.association_description.target_maps[0] #=> Hash
+    #   resp.association_description.target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.association_description.target_maps[0]["TargetMapKey"][0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeAssociation AWS API Documentation
     #
@@ -2849,6 +2908,10 @@ module Aws::SSM
     #   resp.automation_execution_metadata_list[0].runbooks[0].targets[0].key #=> String
     #   resp.automation_execution_metadata_list[0].runbooks[0].targets[0].values #=> Array
     #   resp.automation_execution_metadata_list[0].runbooks[0].targets[0].values[0] #=> String
+    #   resp.automation_execution_metadata_list[0].runbooks[0].target_maps #=> Array
+    #   resp.automation_execution_metadata_list[0].runbooks[0].target_maps[0] #=> Hash
+    #   resp.automation_execution_metadata_list[0].runbooks[0].target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.automation_execution_metadata_list[0].runbooks[0].target_maps[0]["TargetMapKey"][0] #=> String
     #   resp.automation_execution_metadata_list[0].runbooks[0].max_concurrency #=> String
     #   resp.automation_execution_metadata_list[0].runbooks[0].max_errors #=> String
     #   resp.automation_execution_metadata_list[0].runbooks[0].target_locations #=> Array
@@ -5107,6 +5170,10 @@ module Aws::SSM
     #   resp.automation_execution.runbooks[0].targets[0].key #=> String
     #   resp.automation_execution.runbooks[0].targets[0].values #=> Array
     #   resp.automation_execution.runbooks[0].targets[0].values[0] #=> String
+    #   resp.automation_execution.runbooks[0].target_maps #=> Array
+    #   resp.automation_execution.runbooks[0].target_maps[0] #=> Hash
+    #   resp.automation_execution.runbooks[0].target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.automation_execution.runbooks[0].target_maps[0]["TargetMapKey"][0] #=> String
     #   resp.automation_execution.runbooks[0].max_concurrency #=> String
     #   resp.automation_execution.runbooks[0].max_errors #=> String
     #   resp.automation_execution.runbooks[0].target_locations #=> Array
@@ -5213,20 +5280,18 @@ module Aws::SSM
     #   Manager.
     #
     # @option params [String] :plugin_name
-    #   The name of the plugin for which you want detailed results. If the
-    #   document contains only one plugin, you can omit the name and details
-    #   for that plugin. If the document contains more than one plugin, you
-    #   must specify the name of the plugin for which you want to view
-    #   details.
-    #
-    #   Plugin names are also referred to as *step names* in Systems Manager
-    #   documents (SSM documents). For example, `aws:RunShellScript` is a
-    #   plugin.
+    #   The name of the step for which you want detailed results. If the
+    #   document contains only one step, you can omit the name and details for
+    #   that step. If the document contains more than one step, you must
+    #   specify the name of the step for which you want to view details. Be
+    #   sure to specify the name of the step, not the name of a plugin like
+    #   `aws:RunShellScript`.
     #
     #   To find the `PluginName`, check the document content and find the name
-    #   of the plugin. Alternatively, use ListCommandInvocations with the
-    #   `CommandId` and `Details` parameters. The `PluginName` is the `Name`
-    #   attribute of the `CommandPlugin` object in the `CommandPlugins` list.
+    #   of the step you want details for. Alternatively, use
+    #   ListCommandInvocations with the `CommandId` and `Details` parameters.
+    #   The `PluginName` is the `Name` attribute of the `CommandPlugin` object
+    #   in the `CommandPlugins` list.
     #
     # @return [Types::GetCommandInvocationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -6813,6 +6878,11 @@ module Aws::SSM
     #   resp.association_versions[0].target_locations[0].target_location_max_concurrency #=> String
     #   resp.association_versions[0].target_locations[0].target_location_max_errors #=> String
     #   resp.association_versions[0].target_locations[0].execution_role_name #=> String
+    #   resp.association_versions[0].schedule_offset #=> Integer
+    #   resp.association_versions[0].target_maps #=> Array
+    #   resp.association_versions[0].target_maps[0] #=> Hash
+    #   resp.association_versions[0].target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.association_versions[0].target_maps[0]["TargetMapKey"][0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListAssociationVersions AWS API Documentation
@@ -6889,6 +6959,11 @@ module Aws::SSM
     #   resp.associations[0].overview.association_status_aggregated_count["StatusName"] #=> Integer
     #   resp.associations[0].schedule_expression #=> String
     #   resp.associations[0].association_name #=> String
+    #   resp.associations[0].schedule_offset #=> Integer
+    #   resp.associations[0].target_maps #=> Array
+    #   resp.associations[0].target_maps[0] #=> Hash
+    #   resp.associations[0].target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.associations[0].target_maps[0]["TargetMapKey"][0] #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListAssociations AWS API Documentation
@@ -8856,6 +8931,8 @@ module Aws::SSM
     #
     #   MaintenanceWindow: mw-012345abcde
     #
+    #   `Automation`\: `example-c160-4567-8519-012345abcde`
+    #
     #   PatchBaseline: pb-012345abcde
     #
     #   OpsMetadata object: `ResourceID` for tagging is created from the
@@ -9396,7 +9473,7 @@ module Aws::SSM
     #
     #   * `Key=OS,Value=Windows`
     #
-    #   <note markdown="1"> To add tags to an existing patch baseline, use the AddTagsToResource
+    #   <note markdown="1"> To add tags to an existing automation, use the AddTagsToResource
     #   operation.
     #
     #    </note>
@@ -9571,6 +9648,11 @@ module Aws::SSM
     #             values: ["TargetValue"],
     #           },
     #         ],
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #         max_concurrency: "MaxConcurrency",
     #         max_errors: "MaxErrors",
     #         target_locations: [
@@ -9957,6 +10039,29 @@ module Aws::SSM
     #   action to update an association in multiple Regions and multiple
     #   accounts.
     #
+    # @option params [Integer] :schedule_offset
+    #   Number of days to wait after the scheduled day to run an association.
+    #   For example, if you specified a cron schedule of `cron(0 0 ? * THU#2
+    #   *)`, you could specify an offset of 3 to run the association each
+    #   Sunday after the second Thursday of the month. For more information
+    #   about cron schedules for associations, see [Reference: Cron and rate
+    #   expressions for Systems Manager][1] in the *Amazon Web Services
+    #   Systems Manager User Guide*.
+    #
+    #   <note markdown="1"> To use offsets, you must specify the `ApplyOnlyAtCronInterval`
+    #   parameter. This option tells the system not to run an association
+    #   immediately after you create it.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html
+    #
+    # @option params [Array<Hash>] :target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #
     # @return [Types::UpdateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateAssociationResult#association_description #association_description} => Types::AssociationDescription
@@ -10002,6 +10107,12 @@ module Aws::SSM
     #         execution_role_name: "ExecutionRoleName",
     #       },
     #     ],
+    #     schedule_offset: 1,
+    #     target_maps: [
+    #       {
+    #         "TargetMapKey" => ["TargetMapValue"],
+    #       },
+    #     ],
     #   })
     #
     # @example Response structure
@@ -10051,6 +10162,11 @@ module Aws::SSM
     #   resp.association_description.target_locations[0].target_location_max_concurrency #=> String
     #   resp.association_description.target_locations[0].target_location_max_errors #=> String
     #   resp.association_description.target_locations[0].execution_role_name #=> String
+    #   resp.association_description.schedule_offset #=> Integer
+    #   resp.association_description.target_maps #=> Array
+    #   resp.association_description.target_maps[0] #=> Hash
+    #   resp.association_description.target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.association_description.target_maps[0]["TargetMapKey"][0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociation AWS API Documentation
     #
@@ -10142,6 +10258,11 @@ module Aws::SSM
     #   resp.association_description.target_locations[0].target_location_max_concurrency #=> String
     #   resp.association_description.target_locations[0].target_location_max_errors #=> String
     #   resp.association_description.target_locations[0].execution_role_name #=> String
+    #   resp.association_description.schedule_offset #=> Integer
+    #   resp.association_description.target_maps #=> Array
+    #   resp.association_description.target_maps[0] #=> Hash
+    #   resp.association_description.target_maps[0]["TargetMapKey"] #=> Array
+    #   resp.association_description.target_maps[0]["TargetMapKey"][0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationStatus AWS API Documentation
     #
@@ -11506,7 +11627,7 @@ module Aws::SSM
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ssm'
-      context[:gem_version] = '1.134.0'
+      context[:gem_version] = '1.137.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -527,6 +527,7 @@ module Aws::SSM
     InvalidRole = Shapes::StructureShape.new(name: 'InvalidRole')
     InvalidSchedule = Shapes::StructureShape.new(name: 'InvalidSchedule')
     InvalidTarget = Shapes::StructureShape.new(name: 'InvalidTarget')
+    InvalidTargetMaps = Shapes::StructureShape.new(name: 'InvalidTargetMaps')
     InvalidTypeNameException = Shapes::StructureShape.new(name: 'InvalidTypeNameException')
     InvalidUpdate = Shapes::StructureShape.new(name: 'InvalidUpdate')
     InventoryAggregator = Shapes::StructureShape.new(name: 'InventoryAggregator')
@@ -1029,6 +1030,7 @@ module Aws::SSM
     S3OutputUrl = Shapes::StructureShape.new(name: 'S3OutputUrl')
     S3Region = Shapes::StringShape.new(name: 'S3Region')
     ScheduleExpression = Shapes::StringShape.new(name: 'ScheduleExpression')
+    ScheduleOffset = Shapes::IntegerShape.new(name: 'ScheduleOffset')
     ScheduledWindowExecution = Shapes::StructureShape.new(name: 'ScheduledWindowExecution')
     ScheduledWindowExecutionList = Shapes::ListShape.new(name: 'ScheduledWindowExecutionList')
     SendAutomationSignalRequest = Shapes::StructureShape.new(name: 'SendAutomationSignalRequest')
@@ -1225,6 +1227,8 @@ module Aws::SSM
     Association.add_member(:overview, Shapes::ShapeRef.new(shape: AssociationOverview, location_name: "Overview"))
     Association.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, location_name: "ScheduleExpression"))
     Association.add_member(:association_name, Shapes::ShapeRef.new(shape: AssociationName, location_name: "AssociationName"))
+    Association.add_member(:schedule_offset, Shapes::ShapeRef.new(shape: ScheduleOffset, location_name: "ScheduleOffset", metadata: {"box"=>true}))
+    Association.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps", metadata: {"box"=>true}))
     Association.struct_class = Types::Association
 
     AssociationAlreadyExists.struct_class = Types::AssociationAlreadyExists
@@ -1253,6 +1257,8 @@ module Aws::SSM
     AssociationDescription.add_member(:apply_only_at_cron_interval, Shapes::ShapeRef.new(shape: ApplyOnlyAtCronInterval, location_name: "ApplyOnlyAtCronInterval"))
     AssociationDescription.add_member(:calendar_names, Shapes::ShapeRef.new(shape: CalendarNameOrARNList, location_name: "CalendarNames"))
     AssociationDescription.add_member(:target_locations, Shapes::ShapeRef.new(shape: TargetLocations, location_name: "TargetLocations"))
+    AssociationDescription.add_member(:schedule_offset, Shapes::ShapeRef.new(shape: ScheduleOffset, location_name: "ScheduleOffset", metadata: {"box"=>true}))
+    AssociationDescription.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps", metadata: {"box"=>true}))
     AssociationDescription.struct_class = Types::AssociationDescription
 
     AssociationDescriptionList.member = Shapes::ShapeRef.new(shape: AssociationDescription)
@@ -1344,6 +1350,8 @@ module Aws::SSM
     AssociationVersionInfo.add_member(:apply_only_at_cron_interval, Shapes::ShapeRef.new(shape: ApplyOnlyAtCronInterval, location_name: "ApplyOnlyAtCronInterval"))
     AssociationVersionInfo.add_member(:calendar_names, Shapes::ShapeRef.new(shape: CalendarNameOrARNList, location_name: "CalendarNames"))
     AssociationVersionInfo.add_member(:target_locations, Shapes::ShapeRef.new(shape: TargetLocations, location_name: "TargetLocations"))
+    AssociationVersionInfo.add_member(:schedule_offset, Shapes::ShapeRef.new(shape: ScheduleOffset, location_name: "ScheduleOffset", metadata: {"box"=>true}))
+    AssociationVersionInfo.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps", metadata: {"box"=>true}))
     AssociationVersionInfo.struct_class = Types::AssociationVersionInfo
 
     AssociationVersionLimitExceeded.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
@@ -1664,6 +1672,8 @@ module Aws::SSM
     CreateAssociationBatchRequestEntry.add_member(:apply_only_at_cron_interval, Shapes::ShapeRef.new(shape: ApplyOnlyAtCronInterval, location_name: "ApplyOnlyAtCronInterval"))
     CreateAssociationBatchRequestEntry.add_member(:calendar_names, Shapes::ShapeRef.new(shape: CalendarNameOrARNList, location_name: "CalendarNames"))
     CreateAssociationBatchRequestEntry.add_member(:target_locations, Shapes::ShapeRef.new(shape: TargetLocations, location_name: "TargetLocations"))
+    CreateAssociationBatchRequestEntry.add_member(:schedule_offset, Shapes::ShapeRef.new(shape: ScheduleOffset, location_name: "ScheduleOffset", metadata: {"box"=>true}))
+    CreateAssociationBatchRequestEntry.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps", metadata: {"box"=>true}))
     CreateAssociationBatchRequestEntry.struct_class = Types::CreateAssociationBatchRequestEntry
 
     CreateAssociationBatchResult.add_member(:successful, Shapes::ShapeRef.new(shape: AssociationDescriptionList, location_name: "Successful"))
@@ -1686,6 +1696,8 @@ module Aws::SSM
     CreateAssociationRequest.add_member(:apply_only_at_cron_interval, Shapes::ShapeRef.new(shape: ApplyOnlyAtCronInterval, location_name: "ApplyOnlyAtCronInterval"))
     CreateAssociationRequest.add_member(:calendar_names, Shapes::ShapeRef.new(shape: CalendarNameOrARNList, location_name: "CalendarNames"))
     CreateAssociationRequest.add_member(:target_locations, Shapes::ShapeRef.new(shape: TargetLocations, location_name: "TargetLocations"))
+    CreateAssociationRequest.add_member(:schedule_offset, Shapes::ShapeRef.new(shape: ScheduleOffset, location_name: "ScheduleOffset", metadata: {"box"=>true}))
+    CreateAssociationRequest.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps", metadata: {"box"=>true}))
     CreateAssociationRequest.struct_class = Types::CreateAssociationRequest
 
     CreateAssociationResult.add_member(:association_description, Shapes::ShapeRef.new(shape: AssociationDescription, location_name: "AssociationDescription"))
@@ -2927,6 +2939,9 @@ module Aws::SSM
     InvalidTarget.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     InvalidTarget.struct_class = Types::InvalidTarget
 
+    InvalidTargetMaps.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
+    InvalidTargetMaps.struct_class = Types::InvalidTargetMaps
+
     InvalidTypeNameException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
     InvalidTypeNameException.struct_class = Types::InvalidTypeNameException
 
@@ -4058,6 +4073,7 @@ module Aws::SSM
     Runbook.add_member(:parameters, Shapes::ShapeRef.new(shape: AutomationParameterMap, location_name: "Parameters"))
     Runbook.add_member(:target_parameter_name, Shapes::ShapeRef.new(shape: AutomationParameterKey, location_name: "TargetParameterName"))
     Runbook.add_member(:targets, Shapes::ShapeRef.new(shape: Targets, location_name: "Targets"))
+    Runbook.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps"))
     Runbook.add_member(:max_concurrency, Shapes::ShapeRef.new(shape: MaxConcurrency, location_name: "MaxConcurrency"))
     Runbook.add_member(:max_errors, Shapes::ShapeRef.new(shape: MaxErrors, location_name: "MaxErrors"))
     Runbook.add_member(:target_locations, Shapes::ShapeRef.new(shape: TargetLocations, location_name: "TargetLocations", metadata: {"box"=>true}))
@@ -4354,6 +4370,8 @@ module Aws::SSM
     UpdateAssociationRequest.add_member(:apply_only_at_cron_interval, Shapes::ShapeRef.new(shape: ApplyOnlyAtCronInterval, location_name: "ApplyOnlyAtCronInterval"))
     UpdateAssociationRequest.add_member(:calendar_names, Shapes::ShapeRef.new(shape: CalendarNameOrARNList, location_name: "CalendarNames"))
     UpdateAssociationRequest.add_member(:target_locations, Shapes::ShapeRef.new(shape: TargetLocations, location_name: "TargetLocations"))
+    UpdateAssociationRequest.add_member(:schedule_offset, Shapes::ShapeRef.new(shape: ScheduleOffset, location_name: "ScheduleOffset", metadata: {"box"=>true}))
+    UpdateAssociationRequest.add_member(:target_maps, Shapes::ShapeRef.new(shape: TargetMaps, location_name: "TargetMaps", metadata: {"box"=>true}))
     UpdateAssociationRequest.struct_class = Types::UpdateAssociationRequest
 
     UpdateAssociationResult.add_member(:association_description, Shapes::ShapeRef.new(shape: AssociationDescription, location_name: "AssociationDescription"))
@@ -4645,6 +4663,7 @@ module Aws::SSM
         o.errors << Shapes::ShapeRef.new(shape: InvalidParameters)
         o.errors << Shapes::ShapeRef.new(shape: InvalidTarget)
         o.errors << Shapes::ShapeRef.new(shape: InvalidSchedule)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidTargetMaps)
       end)
 
       api.add_operation(:create_association_batch, Seahorse::Model::Operation.new.tap do |o|
@@ -4664,6 +4683,7 @@ module Aws::SSM
         o.errors << Shapes::ShapeRef.new(shape: InvalidOutputLocation)
         o.errors << Shapes::ShapeRef.new(shape: InvalidTarget)
         o.errors << Shapes::ShapeRef.new(shape: InvalidSchedule)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidTargetMaps)
       end)
 
       api.add_operation(:create_document, Seahorse::Model::Operation.new.tap do |o|
@@ -6266,6 +6286,7 @@ module Aws::SSM
         o.errors << Shapes::ShapeRef.new(shape: InvalidTarget)
         o.errors << Shapes::ShapeRef.new(shape: InvalidAssociationVersion)
         o.errors << Shapes::ShapeRef.new(shape: AssociationVersionLimitExceeded)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidTargetMaps)
       end)
 
       api.add_operation(:update_association_status, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-ssm/errors.rb

@@ -101,6 +101,7 @@ module Aws::SSM
   # * {InvalidRole}
   # * {InvalidSchedule}
   # * {InvalidTarget}
+  # * {InvalidTargetMaps}
   # * {InvalidTypeNameException}
   # * {InvalidUpdate}
   # * {InvocationDoesNotExist}
@@ -1216,6 +1217,21 @@ module Aws::SSM
       end
     end
 
+    class InvalidTargetMaps < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::SSM::Types::InvalidTargetMaps] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class InvalidTypeNameException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -130,6 +130,8 @@ module Aws::SSM
     #
     #   `PatchBaseline`\: `pb-012345abcde`
     #
+    #   `Automation`\: `example-c160-4567-8519-012345abcde`
+    #
     #   `OpsMetadata` object: `ResourceID` for tagging is created from the
     #   Amazon Resource Name (ARN) for the object. Specifically,
     #   `ResourceID` is created from the strings that come after the word
@@ -311,6 +313,16 @@ module Aws::SSM
     #   The association name.
     #   @return [String]
     #
+    # @!attribute [rw] schedule_offset
+    #   Number of days to wait after the scheduled day to run an
+    #   association.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Association AWS API Documentation
     #
     class Association < Struct.new(
@@ -323,7 +335,9 @@ module Aws::SSM
       :last_execution_date,
       :overview,
       :schedule_expression,
-      :association_name)
+      :association_name,
+      :schedule_offset,
+      :target_maps)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -485,6 +499,16 @@ module Aws::SSM
     #   Services accounts where you want to run the association.
     #   @return [Array<Types::TargetLocation>]
     #
+    # @!attribute [rw] schedule_offset
+    #   Number of days to wait after the scheduled day to run an
+    #   association.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationDescription AWS API Documentation
     #
     class AssociationDescription < Struct.new(
@@ -511,7 +535,9 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset,
+      :target_maps)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -937,6 +963,16 @@ module Aws::SSM
     #   association version was created.
     #   @return [Array<Types::TargetLocation>]
     #
+    # @!attribute [rw] schedule_offset
+    #   Number of days to wait after the scheduled day to run an
+    #   association.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationVersionInfo AWS API Documentation
     #
     class AssociationVersionInfo < Struct.new(
@@ -956,7 +992,9 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset,
+      :target_maps)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -2851,6 +2889,12 @@ module Aws::SSM
     #                 execution_role_name: "ExecutionRoleName",
     #               },
     #             ],
+    #             schedule_offset: 1,
+    #             target_maps: [
+    #               {
+    #                 "TargetMapKey" => ["TargetMapValue"],
+    #               },
+    #             ],
     #           },
     #         ],
     #       }
@@ -2911,6 +2955,12 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] name
@@ -3060,6 +3110,16 @@ module Aws::SSM
     #   multiple accounts.
     #   @return [Array<Types::TargetLocation>]
     #
+    # @!attribute [rw] schedule_offset
+    #   Number of days to wait after the scheduled day to run an
+    #   association.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationBatchRequestEntry AWS API Documentation
     #
     class CreateAssociationBatchRequestEntry < Struct.new(
@@ -3078,7 +3138,9 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset,
+      :target_maps)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -3141,6 +3203,12 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] name
@@ -3312,6 +3380,31 @@ module Aws::SSM
     #   multiple accounts.
     #   @return [Array<Types::TargetLocation>]
     #
+    # @!attribute [rw] schedule_offset
+    #   Number of days to wait after the scheduled day to run an
+    #   association. For example, if you specified a cron schedule of
+    #   `cron(0 0 ? * THU#2 *)`, you could specify an offset of 3 to run the
+    #   association each Sunday after the second Thursday of the month. For
+    #   more information about cron schedules for associations, see
+    #   [Reference: Cron and rate expressions for Systems Manager][1] in the
+    #   *Amazon Web Services Systems Manager User Guide*.
+    #
+    #   <note markdown="1"> To use offsets, you must specify the `ApplyOnlyAtCronInterval`
+    #   parameter. This option tells the system not to run an association
+    #   immediately after you create it.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationRequest AWS API Documentation
     #
     class CreateAssociationRequest < Struct.new(
@@ -3330,7 +3423,9 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset,
+      :target_maps)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -8109,21 +8204,18 @@ module Aws::SSM
     #   @return [String]
     #
     # @!attribute [rw] plugin_name
-    #   The name of the plugin for which you want detailed results. If the
-    #   document contains only one plugin, you can omit the name and details
-    #   for that plugin. If the document contains more than one plugin, you
-    #   must specify the name of the plugin for which you want to view
-    #   details.
-    #
-    #   Plugin names are also referred to as *step names* in Systems Manager
-    #   documents (SSM documents). For example, `aws:RunShellScript` is a
-    #   plugin.
+    #   The name of the step for which you want detailed results. If the
+    #   document contains only one step, you can omit the name and details
+    #   for that step. If the document contains more than one step, you must
+    #   specify the name of the step for which you want to view details. Be
+    #   sure to specify the name of the step, not the name of a plugin like
+    #   `aws:RunShellScript`.
     #
     #   To find the `PluginName`, check the document content and find the
-    #   name of the plugin. Alternatively, use ListCommandInvocations with
-    #   the `CommandId` and `Details` parameters. The `PluginName` is the
-    #   `Name` attribute of the `CommandPlugin` object in the
-    #   `CommandPlugins` list.
+    #   name of the step you want details for. Alternatively, use
+    #   ListCommandInvocations with the `CommandId` and `Details`
+    #   parameters. The `PluginName` is the `Name` attribute of the
+    #   `CommandPlugin` object in the `CommandPlugins` list.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetCommandInvocationRequest AWS API Documentation
@@ -11330,6 +11422,19 @@ module Aws::SSM
       include Aws::Structure
     end
 
+    # TargetMap parameter isn't valid.
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InvalidTargetMaps AWS API Documentation
+    #
+    class InvalidTargetMaps < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The parameter type name isn't valid.
     #
     # @!attribute [rw] message
@@ -17190,6 +17295,8 @@ module Aws::SSM
     #
     #   MaintenanceWindow: mw-012345abcde
     #
+    #   `Automation`\: `example-c160-4567-8519-012345abcde`
+    #
     #   PatchBaseline: pb-012345abcde
     #
     #   OpsMetadata object: `ResourceID` for tagging is created from the
@@ -17945,6 +18052,11 @@ module Aws::SSM
     #             values: ["TargetValue"],
     #           },
     #         ],
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #         max_concurrency: "MaxConcurrency",
     #         max_errors: "MaxErrors",
     #         target_locations: [
@@ -17981,6 +18093,11 @@ module Aws::SSM
     #   performs tasks on. Required if you specify `TargetParameterName`.
     #   @return [Array<Types::Target>]
     #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of runbook parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @!attribute [rw] max_concurrency
     #   The `MaxConcurrency` value specified by the user when the operation
     #   started, indicating the maximum number of resources that the runbook
@@ -18006,6 +18123,7 @@ module Aws::SSM
       :parameters,
       :target_parameter_name,
       :targets,
+      :target_maps,
       :max_concurrency,
       :max_errors,
       :target_locations)
@@ -18827,7 +18945,7 @@ module Aws::SSM
     #
     #   * `Key=OS,Value=Windows`
     #
-    #   <note markdown="1"> To add tags to an existing patch baseline, use the AddTagsToResource
+    #   <note markdown="1"> To add tags to an existing automation, use the AddTagsToResource
     #   operation.
     #
     #    </note>
@@ -18891,6 +19009,11 @@ module Aws::SSM
     #                 values: ["TargetValue"],
     #               },
     #             ],
+    #             target_maps: [
+    #               {
+    #                 "TargetMapKey" => ["TargetMapValue"],
+    #               },
+    #             ],
     #             max_concurrency: "MaxConcurrency",
     #             max_errors: "MaxErrors",
     #             target_locations: [
@@ -19823,6 +19946,12 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #       }
     #
     # @!attribute [rw] association_id
@@ -19999,6 +20128,31 @@ module Aws::SSM
     #   multiple accounts.
     #   @return [Array<Types::TargetLocation>]
     #
+    # @!attribute [rw] schedule_offset
+    #   Number of days to wait after the scheduled day to run an
+    #   association. For example, if you specified a cron schedule of
+    #   `cron(0 0 ? * THU#2 *)`, you could specify an offset of 3 to run the
+    #   association each Sunday after the second Thursday of the month. For
+    #   more information about cron schedules for associations, see
+    #   [Reference: Cron and rate expressions for Systems Manager][1] in the
+    #   *Amazon Web Services Systems Manager User Guide*.
+    #
+    #   <note markdown="1"> To use offsets, you must specify the `ApplyOnlyAtCronInterval`
+    #   parameter. This option tells the system not to run an association
+    #   immediately after you create it.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html
+    #   @return [Integer]
+    #
+    # @!attribute [rw] target_maps
+    #   A key-value mapping of document parameters to target resources. Both
+    #   Targets and TargetMaps can't be specified together.
+    #   @return [Array<Hash<String,Array<String>>>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationRequest AWS API Documentation
     #
     class UpdateAssociationRequest < Struct.new(
@@ -20018,7 +20172,9 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset,
+      :target_maps)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end

data/lib/aws-sdk-ssm.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ssm/customizations'
 # @!group service
 module Aws::SSM
 
-  GEM_VERSION = '1.134.0'
+  GEM_VERSION = '1.137.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ssm
 version: !ruby/object:Gem::Version
-  version: 1.134.0
+  version: 1.137.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-25 00:00:00.000000000 Z
+date: 2022-05-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core