aws-sdk-ssm 1.133.0 → 1.136.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 356eaad6e39f4dd9946556bcef8479f79e7933622d813b878abe72dea6c0c8e9
-  data.tar.gz: e0e69549e961702594febcd4dbd709d9312456110e85742cb8bf1439e5b00664
+  metadata.gz: d80512efa1f3f803ec5144b0bd8e21bf32fb58c82eef2ba5dc3e0ca31d3e1f9f
+  data.tar.gz: bf353d941300f8a96fe21f650cffc47e54115f50f05edc451efcee0a9519d228
 SHA512:
-  metadata.gz: 3541e515652d185db61cdb84ecddee9f2a4752a3769370151e267368a7784c5a0b6cde148d6567843d23f613d3073e75c7071384b69262c472a23f64f0a16996
-  data.tar.gz: 03e2e6323460d22aa1df128d26bc4d2c5e8501a0f171a02a9e27f0d45477a4566108fb585cebc18d17d5bb130530ce8cf1f3eb80bed7de1d2588d85db1376c15
+  metadata.gz: c3faddfd6a97fe84e57577545419810c8d44ace5c10534f8c1f603306088e0f44ba99768c2865033c7dfe07146fe21d4c7d6edc8827ab084855ff0342f2ec2e7
+  data.tar.gz: c9c94913d9fb27707cfad282e322ea8c8951f3bf631f9b0523a8cdf870ab8fe83f854076e157958f6968d6e9a2b3bebe4095e548c98e9e3108008b647606bf73

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+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)
+------------------
+
+* Feature - This Patch Manager release supports creating, updating, and deleting Patch Baselines for Rocky Linux OS.
+
 1.133.0 (2022-03-23)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.133.0
+1.136.0

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

@@ -875,6 +875,25 @@ 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
+    #
     # @return [Types::CreateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAssociationResult#association_description #association_description} => Types::AssociationDescription
@@ -919,6 +938,7 @@ module Aws::SSM
     #         execution_role_name: "ExecutionRoleName",
     #       },
     #     ],
+    #     schedule_offset: 1,
     #   })
     #
     # @example Response structure
@@ -968,6 +988,7 @@ 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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociation AWS API Documentation
     #
@@ -1040,6 +1061,7 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
     #       },
     #     ],
     #   })
@@ -1092,6 +1114,7 @@ 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.failed #=> Array
     #   resp.failed[0].entry.name #=> String
     #   resp.failed[0].entry.instance_id #=> String
@@ -1124,6 +1147,7 @@ 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].message #=> String
     #   resp.failed[0].fault #=> String, one of "Client", "Server", "Unknown"
     #
@@ -1821,7 +1845,7 @@ module Aws::SSM
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_patch_baseline({
-    #     operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #     operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #     name: "BaselineName", # required
     #     global_filters: {
     #       patch_filters: [ # required
@@ -2616,6 +2640,7 @@ 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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeAssociation AWS API Documentation
     #
@@ -2853,6 +2878,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
@@ -4661,7 +4690,7 @@ module Aws::SSM
     #   resp.baseline_identities #=> Array
     #   resp.baseline_identities[0].baseline_id #=> String
     #   resp.baseline_identities[0].baseline_name #=> String
-    #   resp.baseline_identities[0].operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN"
+    #   resp.baseline_identities[0].operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN", "ROCKY_LINUX"
     #   resp.baseline_identities[0].baseline_description #=> String
     #   resp.baseline_identities[0].default_baseline #=> Boolean
     #   resp.next_token #=> String
@@ -4774,7 +4803,7 @@ module Aws::SSM
     #   resp.mappings[0].patch_group #=> String
     #   resp.mappings[0].baseline_identity.baseline_id #=> String
     #   resp.mappings[0].baseline_identity.baseline_name #=> String
-    #   resp.mappings[0].baseline_identity.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN"
+    #   resp.mappings[0].baseline_identity.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN", "ROCKY_LINUX"
     #   resp.mappings[0].baseline_identity.baseline_description #=> String
     #   resp.mappings[0].baseline_identity.default_baseline #=> Boolean
     #   resp.next_token #=> String
@@ -4869,7 +4898,7 @@ module Aws::SSM
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_patch_properties({
-    #     operating_system: "WINDOWS", # required, accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #     operating_system: "WINDOWS", # required, accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #     property: "PRODUCT", # required, accepts PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, MSRC_SEVERITY, PRIORITY, SEVERITY
     #     patch_set: "OS", # accepts OS, APPLICATION
     #     max_results: 1,
@@ -5111,6 +5140,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
@@ -5217,20 +5250,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:
     #
@@ -5346,13 +5377,13 @@ module Aws::SSM
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_default_patch_baseline({
-    #     operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #     operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #   })
     #
     # @example Response structure
     #
     #   resp.baseline_id #=> String
-    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN"
+    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN", "ROCKY_LINUX"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetDefaultPatchBaseline AWS API Documentation
     #
@@ -5403,7 +5434,7 @@ module Aws::SSM
     #     instance_id: "InstanceId", # required
     #     snapshot_id: "SnapshotId", # required
     #     baseline_override: {
-    #       operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #       operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #       global_filters: {
     #         patch_filters: [ # required
     #           {
@@ -5910,7 +5941,7 @@ module Aws::SSM
       req.send_request(options)
     end
 
-    # Lists the tasks in a maintenance window.
+    # Retrieves the details of a maintenance window task.
     #
     # <note markdown="1"> For maintenance window tasks without a specified target, you can't
     # supply values for `--max-errors` and `--max-concurrency`. Instead, the
@@ -5920,6 +5951,9 @@ module Aws::SSM
     #
     #  </note>
     #
+    # To retrieve a list of tasks in a maintenance window, instead use the
+    # DescribeMaintenanceWindowTasks command.
+    #
     # @option params [required, String] :window_id
     #   The maintenance window ID that includes the task to retrieve.
     #
@@ -6535,7 +6569,7 @@ module Aws::SSM
     #
     #   resp.baseline_id #=> String
     #   resp.name #=> String
-    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN"
+    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN", "ROCKY_LINUX"
     #   resp.global_filters.patch_filters #=> Array
     #   resp.global_filters.patch_filters[0].key #=> String, one of "ARCH", "ADVISORY_ID", "BUGZILLA_ID", "PATCH_SET", "PRODUCT", "PRODUCT_FAMILY", "CLASSIFICATION", "CVE_ID", "EPOCH", "MSRC_SEVERITY", "NAME", "PATCH_ID", "SECTION", "PRIORITY", "REPOSITORY", "RELEASE", "SEVERITY", "SECURITY", "VERSION"
     #   resp.global_filters.patch_filters[0].values #=> Array
@@ -6596,14 +6630,14 @@ module Aws::SSM
     #
     #   resp = client.get_patch_baseline_for_patch_group({
     #     patch_group: "PatchGroup", # required
-    #     operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #     operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #   })
     #
     # @example Response structure
     #
     #   resp.baseline_id #=> String
     #   resp.patch_group #=> String
-    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN"
+    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN", "ROCKY_LINUX"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaselineForPatchGroup AWS API Documentation
     #
@@ -6814,6 +6848,7 @@ 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.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListAssociationVersions AWS API Documentation
@@ -6890,6 +6925,7 @@ 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.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListAssociations AWS API Documentation
@@ -9574,6 +9610,11 @@ module Aws::SSM
     #             values: ["TargetValue"],
     #           },
     #         ],
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #         max_concurrency: "MaxConcurrency",
     #         max_errors: "MaxErrors",
     #         target_locations: [
@@ -9927,8 +9968,18 @@ module Aws::SSM
     #   run immediately after you update it. This parameter isn't supported
     #   for rate expressions.
     #
-    #   Also, if you specified this option when you created the association,
-    #   you can reset it. To do so, specify the
+    #   If you chose this option when you created an association and later you
+    #   edit that association or you make changes to the SSM document on which
+    #   that association is based (by using the Documents page in the
+    #   console), State Manager applies the association at the next specified
+    #   cron interval. For example, if you chose the `Latest` version of an
+    #   SSM document when you created an association and you edit the
+    #   association by choosing a different document version on the Documents
+    #   page, State Manager applies the association at the next specified cron
+    #   interval if you previously selected this option. If this option
+    #   wasn't selected, State Manager immediately runs the association.
+    #
+    #   You can reset this option. To do so, specify the
     #   `no-apply-only-at-cron-interval` parameter when you update the
     #   association from the command line. This parameter forces the
     #   association to run immediately after updating it and according to the
@@ -9950,6 +10001,25 @@ 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
+    #
     # @return [Types::UpdateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateAssociationResult#association_description #association_description} => Types::AssociationDescription
@@ -9995,6 +10065,7 @@ module Aws::SSM
     #         execution_role_name: "ExecutionRoleName",
     #       },
     #     ],
+    #     schedule_offset: 1,
     #   })
     #
     # @example Response structure
@@ -10044,6 +10115,7 @@ 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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociation AWS API Documentation
     #
@@ -10135,6 +10207,7 @@ 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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationStatus AWS API Documentation
     #
@@ -10175,6 +10248,12 @@ module Aws::SSM
     #   document. You can specify the version number of the latest version or
     #   use the `$LATEST` variable.
     #
+    #   <note markdown="1"> If you change a document version for a State Manager association,
+    #   Systems Manager immediately runs the association unless you previously
+    #   specifed the `apply-only-at-cron-interval` parameter.
+    #
+    #    </note>
+    #
     # @option params [String] :document_format
     #   Specify the document format for the new document version. Systems
     #   Manager supports JSON and YAML documents. JSON is the default format.
@@ -10264,6 +10343,12 @@ module Aws::SSM
 
     # Set the default version of a document.
     #
+    # <note markdown="1"> If you change a document version for a State Manager association,
+    # Systems Manager immediately runs the association unless you previously
+    # specifed the `apply-only-at-cron-interval` parameter.
+    #
+    #  </note>
+    #
     # @option params [required, String] :name
     #   The name of a custom document that you want to set as the default
     #   version.
@@ -11304,7 +11389,7 @@ module Aws::SSM
     #
     #   resp.baseline_id #=> String
     #   resp.name #=> String
-    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN"
+    #   resp.operating_system #=> String, one of "WINDOWS", "AMAZON_LINUX", "AMAZON_LINUX_2", "UBUNTU", "REDHAT_ENTERPRISE_LINUX", "SUSE", "CENTOS", "ORACLE_LINUX", "DEBIAN", "MACOS", "RASPBIAN", "ROCKY_LINUX"
     #   resp.global_filters.patch_filters #=> Array
     #   resp.global_filters.patch_filters[0].key #=> String, one of "ARCH", "ADVISORY_ID", "BUGZILLA_ID", "PATCH_SET", "PRODUCT", "PRODUCT_FAMILY", "CLASSIFICATION", "CVE_ID", "EPOCH", "MSRC_SEVERITY", "NAME", "PATCH_ID", "SECTION", "PRIORITY", "REPOSITORY", "RELEASE", "SEVERITY", "SECURITY", "VERSION"
     #   resp.global_filters.patch_filters[0].values #=> Array
@@ -11487,7 +11572,7 @@ module Aws::SSM
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ssm'
-      context[:gem_version] = '1.133.0'
+      context[:gem_version] = '1.136.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1029,6 +1029,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 +1226,7 @@ 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.struct_class = Types::Association
 
     AssociationAlreadyExists.struct_class = Types::AssociationAlreadyExists
@@ -1253,6 +1255,7 @@ 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.struct_class = Types::AssociationDescription
 
     AssociationDescriptionList.member = Shapes::ShapeRef.new(shape: AssociationDescription)
@@ -1344,6 +1347,7 @@ 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.struct_class = Types::AssociationVersionInfo
 
     AssociationVersionLimitExceeded.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
@@ -1664,6 +1668,7 @@ 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.struct_class = Types::CreateAssociationBatchRequestEntry
 
     CreateAssociationBatchResult.add_member(:successful, Shapes::ShapeRef.new(shape: AssociationDescriptionList, location_name: "Successful"))
@@ -1686,6 +1691,7 @@ 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.struct_class = Types::CreateAssociationRequest
 
     CreateAssociationResult.add_member(:association_description, Shapes::ShapeRef.new(shape: AssociationDescription, location_name: "AssociationDescription"))
@@ -4058,6 +4064,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 +4361,7 @@ 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.struct_class = Types::UpdateAssociationRequest
 
     UpdateAssociationResult.add_member(:association_description, Shapes::ShapeRef.new(shape: AssociationDescription, location_name: "AssociationDescription"))

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

@@ -276,7 +276,10 @@ module Aws::SSM
     #   @return [String]
     #
     # @!attribute [rw] document_version
-    #   The version of the document used in the association.
+    #   The version of the document used in the association. If you change a
+    #   document version for a State Manager association, Systems Manager
+    #   immediately runs the association unless you previously specifed the
+    #   `apply-only-at-cron-interval` parameter.
     #
     #   State Manager doesn't support running associations that use a new
     #   version of a document if that document is shared from another
@@ -310,6 +313,11 @@ 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]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Association AWS API Documentation
     #
     class Association < Struct.new(
@@ -322,7 +330,8 @@ module Aws::SSM
       :last_execution_date,
       :overview,
       :schedule_expression,
-      :association_name)
+      :association_name,
+      :schedule_offset)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -484,6 +493,11 @@ 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]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationDescription AWS API Documentation
     #
     class AssociationDescription < Struct.new(
@@ -510,7 +524,8 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -936,6 +951,11 @@ 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]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationVersionInfo AWS API Documentation
     #
     class AssociationVersionInfo < Struct.new(
@@ -955,7 +975,8 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -1564,7 +1585,7 @@ module Aws::SSM
     #   data as a hash:
     #
     #       {
-    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #         global_filters: {
     #           patch_filters: [ # required
     #             {
@@ -2850,6 +2871,7 @@ module Aws::SSM
     #                 execution_role_name: "ExecutionRoleName",
     #               },
     #             ],
+    #             schedule_offset: 1,
     #           },
     #         ],
     #       }
@@ -2910,6 +2932,7 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
     #       }
     #
     # @!attribute [rw] name
@@ -3059,6 +3082,11 @@ 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]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationBatchRequestEntry AWS API Documentation
     #
     class CreateAssociationBatchRequestEntry < Struct.new(
@@ -3077,7 +3105,8 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -3140,6 +3169,7 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
     #       }
     #
     # @!attribute [rw] name
@@ -3311,6 +3341,26 @@ 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]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationRequest AWS API Documentation
     #
     class CreateAssociationRequest < Struct.new(
@@ -3329,7 +3379,8 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -3938,7 +3989,7 @@ module Aws::SSM
     #   data as a hash:
     #
     #       {
-    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #         name: "BaselineName", # required
     #         global_filters: {
     #           patch_filters: [ # required
@@ -6927,7 +6978,7 @@ module Aws::SSM
     #   data as a hash:
     #
     #       {
-    #         operating_system: "WINDOWS", # required, accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #         operating_system: "WINDOWS", # required, accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #         property: "PRODUCT", # required, accepts PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, MSRC_SEVERITY, PRIORITY, SEVERITY
     #         patch_set: "OS", # accepts OS, APPLICATION
     #         max_results: 1,
@@ -8108,21 +8159,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
@@ -8357,7 +8405,7 @@ module Aws::SSM
     #   data as a hash:
     #
     #       {
-    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #       }
     #
     # @!attribute [rw] operating_system
@@ -8397,7 +8445,7 @@ module Aws::SSM
     #         instance_id: "InstanceId", # required
     #         snapshot_id: "SnapshotId", # required
     #         baseline_override: {
-    #           operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #           operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #           global_filters: {
     #             patch_filters: [ # required
     #               {
@@ -9785,7 +9833,7 @@ module Aws::SSM
     #
     #       {
     #         patch_group: "PatchGroup", # required
-    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
+    #         operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN, ROCKY_LINUX
     #       }
     #
     # @!attribute [rw] patch_group
@@ -17946,6 +17994,11 @@ module Aws::SSM
     #             values: ["TargetValue"],
     #           },
     #         ],
+    #         target_maps: [
+    #           {
+    #             "TargetMapKey" => ["TargetMapValue"],
+    #           },
+    #         ],
     #         max_concurrency: "MaxConcurrency",
     #         max_errors: "MaxErrors",
     #         target_locations: [
@@ -17982,6 +18035,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
@@ -18007,6 +18065,7 @@ module Aws::SSM
       :parameters,
       :target_parameter_name,
       :targets,
+      :target_maps,
       :max_concurrency,
       :max_errors,
       :target_locations)
@@ -18892,6 +18951,11 @@ module Aws::SSM
     #                 values: ["TargetValue"],
     #               },
     #             ],
+    #             target_maps: [
+    #               {
+    #                 "TargetMapKey" => ["TargetMapValue"],
+    #               },
+    #             ],
     #             max_concurrency: "MaxConcurrency",
     #             max_errors: "MaxErrors",
     #             target_locations: [
@@ -19824,6 +19888,7 @@ module Aws::SSM
     #             execution_role_name: "ExecutionRoleName",
     #           },
     #         ],
+    #         schedule_offset: 1,
     #       }
     #
     # @!attribute [rw] association_id
@@ -19962,8 +20027,19 @@ module Aws::SSM
     #   to run immediately after you update it. This parameter isn't
     #   supported for rate expressions.
     #
-    #   Also, if you specified this option when you created the association,
-    #   you can reset it. To do so, specify the
+    #   If you chose this option when you created an association and later
+    #   you edit that association or you make changes to the SSM document on
+    #   which that association is based (by using the Documents page in the
+    #   console), State Manager applies the association at the next
+    #   specified cron interval. For example, if you chose the `Latest`
+    #   version of an SSM document when you created an association and you
+    #   edit the association by choosing a different document version on the
+    #   Documents page, State Manager applies the association at the next
+    #   specified cron interval if you previously selected this option. If
+    #   this option wasn't selected, State Manager immediately runs the
+    #   association.
+    #
+    #   You can reset this option. To do so, specify the
     #   `no-apply-only-at-cron-interval` parameter when you update the
     #   association from the command line. This parameter forces the
     #   association to run immediately after updating it and according to
@@ -19989,6 +20065,26 @@ 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]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationRequest AWS API Documentation
     #
     class UpdateAssociationRequest < Struct.new(
@@ -20008,7 +20104,8 @@ module Aws::SSM
       :sync_compliance,
       :apply_only_at_cron_interval,
       :calendar_names,
-      :target_locations)
+      :target_locations,
+      :schedule_offset)
       SENSITIVE = [:parameters]
       include Aws::Structure
     end
@@ -20210,6 +20307,12 @@ module Aws::SSM
     #   Systems Manager supports updating only the latest version of the
     #   document. You can specify the version number of the latest version
     #   or use the `$LATEST` variable.
+    #
+    #   <note markdown="1"> If you change a document version for a State Manager association,
+    #   Systems Manager immediately runs the association unless you
+    #   previously specifed the `apply-only-at-cron-interval` parameter.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] document_format

data/lib/aws-sdk-ssm.rb

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

metadata

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