aws-sdk-ssm 1.117.0 → 1.118.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c72aa47bae5d5e22c06e42ddd8420ceec5c4ba1f77f991c9094b4b04e796a4da
-  data.tar.gz: 75329a3545e7882953d5f066c9b8e27575dcb1cab01323cdcb2cd04269e83208
+  metadata.gz: 5f2c9ad0c2c8f2ccd8f0f2b0a662de7ed68180c15651bed937b8b46a53b64a1e
+  data.tar.gz: 9cca567ef67161d21a7c543f46d78beb567c0bb58cd37d5d5bd9310c9d8851e6
 SHA512:
-  metadata.gz: e02a3c77cc16c15ff9cb649b7af9a181bae3521b7eddc9693e44b58112f43636a23c27d7e9d1e260eb96a24a231cce84f8686060fb49c06026877ec7b28a3bb8
-  data.tar.gz: e3cb4aef0cd18af1e2449daa61c5f02f32978fe45ce5efe6abfdcb74318e56545544f9dad0a7101439e8920789a9619c1476f8a53fdc20dc242dd6390236c6af
+  metadata.gz: e373cdbe91a4ac4665d7c9385208754324da01acf1d1d52f55451db8d9c56d6862e0863e2ba2e54ecfd0ec79c9bbe98438a0d934779eec5abab416ddb3e90643
+  data.tar.gz: d4ad81e48b5e84ead1ecb9db6a160b5de4039aa301b38ff75f7978ae7fb2a2606046dfd703d68d626d8efa6e508cbfdc8fc98c8706454a3122ddb79e3e76efa2

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.118.0 (2021-09-23)
+------------------
+
+* Feature - Added cutoff behavior support for preventing new task invocations from starting when the maintenance window cutoff time is reached.
+
 1.117.0 (2021-09-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.117.0
+1.118.0

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

@@ -442,10 +442,10 @@ module Aws::SSM
       req.send_request(options)
     end
 
-    # Associates a related resource to a Systems Manager OpsCenter OpsItem.
-    # For example, you can associate an Incident Manager incident or
-    # analysis with an OpsItem. Incident Manager is a capability of Amazon
-    # Web Services Systems Manager.
+    # Associates a related item to a Systems Manager OpsCenter OpsItem. For
+    # example, you can associate an Incident Manager incident or analysis
+    # with an OpsItem. Incident Manager and OpsCenter are capabilities of
+    # Amazon Web Services Systems Manager.
     #
     # @option params [required, String] :ops_item_id
     #   The ID of the OpsItem to which you want to associate a resource as a
@@ -461,8 +461,6 @@ module Aws::SSM
     #   OpsCenter supports the following types:
     #
     #   `AWS::SSMIncidents::IncidentRecord`\: an Incident Manager incident.
-    #   Incident Manager is a capability of Amazon Web Services Systems
-    #   Manager.
     #
     #   `AWS::SSM::Document`\: a Systems Manager (SSM) document.
     #
@@ -4194,6 +4192,7 @@ module Aws::SSM
     #   resp.tasks[0].max_errors #=> String
     #   resp.tasks[0].name #=> String
     #   resp.tasks[0].description #=> String
+    #   resp.tasks[0].cutoff_behavior #=> String, one of "CONTINUE_TASK", "CANCEL_TASK"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeMaintenanceWindowTasks AWS API Documentation
@@ -4477,6 +4476,11 @@ module Aws::SSM
     # You can specify the `NextToken` in a subsequent call to get the next
     # set of results.
     #
+    # If you change the KMS key alias for the KMS key used to encrypt a
+    # parameter, then you must also update the key alias the parameter uses
+    # to reference KMS. Otherwise, `DescribeParameters` retrieves whatever
+    # the original key alias was referencing.
+    #
     # @option params [Array<Types::ParametersFilter>] :filters
     #   This data type is deprecated. Instead, use `ParameterFilters`.
     #
@@ -4894,18 +4898,18 @@ module Aws::SSM
       req.send_request(options)
     end
 
-    # Deletes the association between an OpsItem and a related resource. For
+    # Deletes the association between an OpsItem and a related item. For
     # example, this API operation can delete an Incident Manager incident
     # from an OpsItem. Incident Manager is a capability of Amazon Web
     # Services Systems Manager.
     #
     # @option params [required, String] :ops_item_id
     #   The ID of the OpsItem for which you want to delete an association
-    #   between the OpsItem and a related resource.
+    #   between the OpsItem and a related item.
     #
     # @option params [required, String] :association_id
     #   The ID of the association for which you want to delete an association
-    #   between the OpsItem and a related resource.
+    #   between the OpsItem and a related item.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5875,6 +5879,7 @@ module Aws::SSM
     #   * {Types::GetMaintenanceWindowTaskResult#logging_info #logging_info} => Types::LoggingInfo
     #   * {Types::GetMaintenanceWindowTaskResult#name #name} => String
     #   * {Types::GetMaintenanceWindowTaskResult#description #description} => String
+    #   * {Types::GetMaintenanceWindowTaskResult#cutoff_behavior #cutoff_behavior} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -5931,6 +5936,7 @@ module Aws::SSM
     #   resp.logging_info.s3_region #=> String
     #   resp.name #=> String
     #   resp.description #=> String
+    #   resp.cutoff_behavior #=> String, one of "CONTINUE_TASK", "CANCEL_TASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetMaintenanceWindowTask AWS API Documentation
     #
@@ -6201,6 +6207,11 @@ module Aws::SSM
 
     # Retrieves the history of all changes to a parameter.
     #
+    # If you change the KMS key alias for the KMS key used to encrypt a
+    # parameter, then you must also update the key alias the parameter uses
+    # to reference KMS. Otherwise, `GetParameterHistory` retrieves whatever
+    # the original key alias was referencing.
+    #
     # @option params [required, String] :name
     #   The name of the parameter for which you want to review history.
     #
@@ -6352,11 +6363,11 @@ module Aws::SSM
     # @option params [Array<Types::ParameterStringFilter>] :parameter_filters
     #   Filters to limit the request results.
     #
-    #   <note markdown="1"> For `GetParametersByPath`, the following filter `Key` names are
-    #   supported: `Type`, `KeyId`, `Label`, and `DataType`.
+    #   <note markdown="1"> The following `Key` values are supported for `GetParametersByPath`\:
+    #   `Type`, `KeyId`, and `Label`.
     #
-    #    The following `Key` values are not supported for
-    #   `GetParametersByPath`\: `tag`, `Name`, `Path`, and `Tier`.
+    #    The following `Key` values aren't supported for
+    #   `GetParametersByPath`\: `tag`, `DataType`, `Name`, `Path`, and `Tier`.
     #
     #    </note>
     #
@@ -7502,7 +7513,9 @@ module Aws::SSM
       req.send_request(options)
     end
 
-    # Lists all related-item resources associated with an OpsItem.
+    # Lists all related-item resources associated with a Systems Manager
+    # OpsCenter OpsItem. OpsCenter is a capability of Amazon Web Services
+    # Systems Manager.
     #
     # @option params [String] :ops_item_id
     #   The ID of the OpsItem for which you want to list all related-item
@@ -8637,6 +8650,27 @@ module Aws::SSM
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [String] :cutoff_behavior
+    #   Indicates whether tasks should continue to run after the cutoff time
+    #   specified in the maintenance windows is reached.
+    #
+    #   * `CONTINUE_TASK`\: When the cutoff time is reached, any tasks that
+    #     are running continue. The default value.
+    #
+    #   * `CANCEL_TASK`\:
+    #
+    #     * For Automation, Lambda, Step Functions tasks: When the cutoff time
+    #       is reached, any task invocations that are already running
+    #       continue, but no new task invocations are started.
+    #
+    #     * For Run Command tasks: When the cutoff time is reached, the system
+    #       sends a CancelCommand operation that attempts to cancel the
+    #       command associated with the task. However, there is no guarantee
+    #       that the command will be terminated and the underlying process
+    #       stopped.
+    #
+    #     The status for tasks that are not completed is `TIMED_OUT`.
+    #
     # @return [Types::RegisterTaskWithMaintenanceWindowResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::RegisterTaskWithMaintenanceWindowResult#window_task_id #window_task_id} => String
@@ -8709,6 +8743,7 @@ module Aws::SSM
     #     name: "MaintenanceWindowName",
     #     description: "MaintenanceWindowDescription",
     #     client_token: "ClientToken",
+    #     cutoff_behavior: "CONTINUE_TASK", # accepts CONTINUE_TASK, CANCEL_TASK
     #   })
     #
     # @example Response structure
@@ -8983,9 +9018,14 @@ module Aws::SSM
     #   The name of the Amazon Web Services Systems Manager document (SSM
     #   document) to run. This can be a public document or a custom document.
     #   To run a shared document belonging to another account, specify the
-    #   document ARN. For more information about how to use shared documents,
-    #   see [Using shared SSM documents][1] in the *Amazon Web Services
-    #   Systems Manager User Guide*.
+    #   document Amazon Resource Name (ARN). For more information about how to
+    #   use shared documents, see [Using shared SSM documents][1] in the
+    #   *Amazon Web Services Systems Manager User Guide*.
+    #
+    #   <note markdown="1"> If you specify a document name or ARN that hasn't been shared with
+    #   your account, you receive an `InvalidDocument` error.
+    #
+    #    </note>
     #
     #
     #
@@ -10590,6 +10630,27 @@ module Aws::SSM
     #   RegisterTaskWithMaintenanceWindow operation are also required for this
     #   API request. Optional fields that aren't specified are set to null.
     #
+    # @option params [String] :cutoff_behavior
+    #   Indicates whether tasks should continue to run after the cutoff time
+    #   specified in the maintenance windows is reached.
+    #
+    #   * `CONTINUE_TASK`\: When the cutoff time is reached, any tasks that
+    #     are running continue. The default value.
+    #
+    #   * `CANCEL_TASK`\:
+    #
+    #     * For Automation, Lambda, Step Functions tasks: When the cutoff time
+    #       is reached, any task invocations that are already running
+    #       continue, but no new task invocations are started.
+    #
+    #     * For Run Command tasks: When the cutoff time is reached, the system
+    #       sends a CancelCommand operation that attempts to cancel the
+    #       command associated with the task. However, there is no guarantee
+    #       that the command will be terminated and the underlying process
+    #       stopped.
+    #
+    #     The status for tasks that are not completed is `TIMED_OUT`.
+    #
     # @return [Types::UpdateMaintenanceWindowTaskResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateMaintenanceWindowTaskResult#window_id #window_id} => String
@@ -10605,6 +10666,7 @@ module Aws::SSM
     #   * {Types::UpdateMaintenanceWindowTaskResult#logging_info #logging_info} => Types::LoggingInfo
     #   * {Types::UpdateMaintenanceWindowTaskResult#name #name} => String
     #   * {Types::UpdateMaintenanceWindowTaskResult#description #description} => String
+    #   * {Types::UpdateMaintenanceWindowTaskResult#cutoff_behavior #cutoff_behavior} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -10674,6 +10736,7 @@ module Aws::SSM
     #     name: "MaintenanceWindowName",
     #     description: "MaintenanceWindowDescription",
     #     replace: false,
+    #     cutoff_behavior: "CONTINUE_TASK", # accepts CONTINUE_TASK, CANCEL_TASK
     #   })
     #
     # @example Response structure
@@ -10723,6 +10786,7 @@ module Aws::SSM
     #   resp.logging_info.s3_region #=> String
     #   resp.name #=> String
     #   resp.description #=> String
+    #   resp.cutoff_behavior #=> String, one of "CONTINUE_TASK", "CANCEL_TASK"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateMaintenanceWindowTask AWS API Documentation
     #
@@ -11239,29 +11303,25 @@ module Aws::SSM
     #   * `/ssm/managed-instance/activation-tier`
     #
     # @option params [required, String] :setting_value
-    #   The new value to specify for the service setting. For the
-    #   `/ssm/parameter-store/default-parameter-tier` setting ID, the setting
-    #   value can be one of the following.
+    #   The new value to specify for the service setting. The following list
+    #   specifies the available values for each setting.
     #
-    #   * Standard
+    #   * `/ssm/parameter-store/default-parameter-tier`\: `Standard`,
+    #     `Advanced`, `Intelligent-Tiering`
     #
-    #   * Advanced
+    #   * `/ssm/parameter-store/high-throughput-enabled`\: `true` or `false`
     #
-    #   * Intelligent-Tiering
+    #   * `/ssm/managed-instance/activation-tier`\: `true` or `false`
     #
-    #   For the `/ssm/parameter-store/high-throughput-enabled`, and
-    #   `/ssm/managed-instance/activation-tier` setting IDs, the setting value
-    #   can be true or false.
+    #   * `/ssm/automation/customer-script-log-destination`\: `CloudWatch`
     #
-    #   For the `/ssm/automation/customer-script-log-destination` setting ID,
-    #   the setting value can be `CloudWatch`.
+    #   * `/ssm/automation/customer-script-log-group-name`\: the name of an
+    #     Amazon CloudWatch Logs log group
     #
-    #   For the `/ssm/automation/customer-script-log-group-name` setting ID,
-    #   the setting value can be the name of an Amazon CloudWatch Logs log
-    #   group.
+    #   * `/ssm/documents/console/public-sharing-permission`\: `Enable` or
+    #     `Disable`
     #
-    #   For the `/ssm/documents/console/public-sharing-permission` setting ID,
-    #   the setting value can be `Enable` or `Disable`.
+    #   * `/ssm/managed-instance/activation-tier`\: `standard` or `advanced`
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -11294,7 +11354,7 @@ module Aws::SSM
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ssm'
-      context[:gem_version] = '1.117.0'
+      context[:gem_version] = '1.118.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -667,6 +667,7 @@ module Aws::SSM
     MaintenanceWindowTargetList = Shapes::ListShape.new(name: 'MaintenanceWindowTargetList')
     MaintenanceWindowTask = Shapes::StructureShape.new(name: 'MaintenanceWindowTask')
     MaintenanceWindowTaskArn = Shapes::StringShape.new(name: 'MaintenanceWindowTaskArn')
+    MaintenanceWindowTaskCutoffBehavior = Shapes::StringShape.new(name: 'MaintenanceWindowTaskCutoffBehavior')
     MaintenanceWindowTaskId = Shapes::StringShape.new(name: 'MaintenanceWindowTaskId')
     MaintenanceWindowTaskInvocationParameters = Shapes::StructureShape.new(name: 'MaintenanceWindowTaskInvocationParameters')
     MaintenanceWindowTaskList = Shapes::ListShape.new(name: 'MaintenanceWindowTaskList')
@@ -2546,6 +2547,7 @@ module Aws::SSM
     GetMaintenanceWindowTaskResult.add_member(:logging_info, Shapes::ShapeRef.new(shape: LoggingInfo, location_name: "LoggingInfo"))
     GetMaintenanceWindowTaskResult.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
     GetMaintenanceWindowTaskResult.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))
+    GetMaintenanceWindowTaskResult.add_member(:cutoff_behavior, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskCutoffBehavior, location_name: "CutoffBehavior", metadata: {"box"=>true}))
     GetMaintenanceWindowTaskResult.struct_class = Types::GetMaintenanceWindowTaskResult
 
     GetOpsItemRequest.add_member(:ops_item_id, Shapes::ShapeRef.new(shape: OpsItemId, required: true, location_name: "OpsItemId"))
@@ -3310,6 +3312,7 @@ module Aws::SSM
     MaintenanceWindowTask.add_member(:max_errors, Shapes::ShapeRef.new(shape: MaxErrors, location_name: "MaxErrors"))
     MaintenanceWindowTask.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
     MaintenanceWindowTask.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))
+    MaintenanceWindowTask.add_member(:cutoff_behavior, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskCutoffBehavior, location_name: "CutoffBehavior", metadata: {"box"=>true}))
     MaintenanceWindowTask.struct_class = Types::MaintenanceWindowTask
 
     MaintenanceWindowTaskInvocationParameters.add_member(:run_command, Shapes::ShapeRef.new(shape: MaintenanceWindowRunCommandParameters, location_name: "RunCommand"))
@@ -3890,6 +3893,7 @@ module Aws::SSM
     RegisterTaskWithMaintenanceWindowRequest.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "ClientToken", metadata: {"idempotencyToken"=>true}))
+    RegisterTaskWithMaintenanceWindowRequest.add_member(:cutoff_behavior, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskCutoffBehavior, location_name: "CutoffBehavior", metadata: {"box"=>true}))
     RegisterTaskWithMaintenanceWindowRequest.struct_class = Types::RegisterTaskWithMaintenanceWindowRequest
 
     RegisterTaskWithMaintenanceWindowResult.add_member(:window_task_id, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskId, location_name: "WindowTaskId"))
@@ -4420,6 +4424,7 @@ module Aws::SSM
     UpdateMaintenanceWindowTaskRequest.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
     UpdateMaintenanceWindowTaskRequest.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))
     UpdateMaintenanceWindowTaskRequest.add_member(:replace, Shapes::ShapeRef.new(shape: Boolean, location_name: "Replace", metadata: {"box"=>true}))
+    UpdateMaintenanceWindowTaskRequest.add_member(:cutoff_behavior, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskCutoffBehavior, location_name: "CutoffBehavior", metadata: {"box"=>true}))
     UpdateMaintenanceWindowTaskRequest.struct_class = Types::UpdateMaintenanceWindowTaskRequest
 
     UpdateMaintenanceWindowTaskResult.add_member(:window_id, Shapes::ShapeRef.new(shape: MaintenanceWindowId, location_name: "WindowId"))
@@ -4435,6 +4440,7 @@ module Aws::SSM
     UpdateMaintenanceWindowTaskResult.add_member(:logging_info, Shapes::ShapeRef.new(shape: LoggingInfo, location_name: "LoggingInfo"))
     UpdateMaintenanceWindowTaskResult.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
     UpdateMaintenanceWindowTaskResult.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))
+    UpdateMaintenanceWindowTaskResult.add_member(:cutoff_behavior, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskCutoffBehavior, location_name: "CutoffBehavior", metadata: {"box"=>true}))
     UpdateMaintenanceWindowTaskResult.struct_class = Types::UpdateMaintenanceWindowTaskResult
 
     UpdateManagedInstanceRoleRequest.add_member(:instance_id, Shapes::ShapeRef.new(shape: ManagedInstanceId, required: true, location_name: "InstanceId"))

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

@@ -215,8 +215,6 @@ module Aws::SSM
     #   OpsCenter supports the following types:
     #
     #   `AWS::SSMIncidents::IncidentRecord`\: an Incident Manager incident.
-    #   Incident Manager is a capability of Amazon Web Services Systems
-    #   Manager.
     #
     #   `AWS::SSM::Document`\: a Systems Manager (SSM) document.
     #   @return [String]
@@ -2014,8 +2012,10 @@ module Aws::SSM
     #     executions from before July 7, 2021.
     #
     #   * **Status**\: Specify a valid command status to see a list of all
-    #     command executions with that status. Status values you can specify
-    #     include:
+    #     command executions with that status. The status choices depend on
+    #     the API you call.
+    #
+    #     The status values you can specify for `ListCommands` are:
     #
     #     * `Pending`
     #
@@ -2027,9 +2027,48 @@ module Aws::SSM
     #
     #     * `Failed`
     #
-    #     * `TimedOut`
+    #     * `TimedOut` (this includes both Delivery and Execution time outs)
+    #
+    #     * `AccessDenied`
+    #
+    #     * `DeliveryTimedOut`
+    #
+    #     * `ExecutionTimedOut`
+    #
+    #     * `Incomplete`
+    #
+    #     * `NoInstancesInTag`
+    #
+    #     * `LimitExceeded`
+    #
+    #     The status values you can specify for `ListCommandInvocations`
+    #     are:
     #
-    #     * `Cancelling`
+    #     * `Pending`
+    #
+    #     * `InProgress`
+    #
+    #     * `Delayed`
+    #
+    #     * `Success`
+    #
+    #     * `Cancelled`
+    #
+    #     * `Failed`
+    #
+    #     * `TimedOut` (this includes both Delivery and Execution time outs)
+    #
+    #     * `AccessDenied`
+    #
+    #     * `DeliveryTimedOut`
+    #
+    #     * `ExecutionTimedOut`
+    #
+    #     * `Undeliverable`
+    #
+    #     * `InvalidPlatform`
+    #
+    #     * `Terminated`
     #
     #   * **DocumentName**\: Specify name of the Amazon Web Services Systems
     #     Manager document (SSM document) for which you want to see command
@@ -2071,9 +2110,7 @@ module Aws::SSM
     #   @return [String]
     #
     # @!attribute [rw] instance_name
-    #   The name of the invocation target. For EC2 instances this is the
-    #   value for the `aws:Name` tag. For on-premises instances, this is the
-    #   name of the instance.
+    #   The fully qualified host name of the managed instance.
     #   @return [String]
     #
     # @!attribute [rw] comment
@@ -6985,12 +7022,12 @@ module Aws::SSM
     #
     # @!attribute [rw] ops_item_id
     #   The ID of the OpsItem for which you want to delete an association
-    #   between the OpsItem and a related resource.
+    #   between the OpsItem and a related item.
     #   @return [String]
     #
     # @!attribute [rw] association_id
     #   The ID of the association for which you want to delete an
-    #   association between the OpsItem and a related resource.
+    #   association between the OpsItem and a related item.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DisassociateOpsItemRelatedItemRequest AWS API Documentation
@@ -9222,6 +9259,16 @@ module Aws::SSM
     #   The retrieved task description.
     #   @return [String]
     #
+    # @!attribute [rw] cutoff_behavior
+    #   The action to take on tasks when the maintenance window cutoff time
+    #   is reached. `CONTINUE_TASK` means that tasks continue to run. For
+    #   Automation, Lambda, Step Functions tasks, `CANCEL_TASK` means that
+    #   currently running task invocations continue, but no new task
+    #   invocations are started. For Run Command tasks, `CANCEL_TASK` means
+    #   the system attempts to stop the task by sending a `CancelCommand`
+    #   operation.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetMaintenanceWindowTaskResult AWS API Documentation
     #
     class GetMaintenanceWindowTaskResult < Struct.new(
@@ -9238,7 +9285,8 @@ module Aws::SSM
       :max_errors,
       :logging_info,
       :name,
-      :description)
+      :description,
+      :cutoff_behavior)
       SENSITIVE = [:task_parameters, :description]
       include Aws::Structure
     end
@@ -9572,11 +9620,12 @@ module Aws::SSM
     # @!attribute [rw] parameter_filters
     #   Filters to limit the request results.
     #
-    #   <note markdown="1"> For `GetParametersByPath`, the following filter `Key` names are
-    #   supported: `Type`, `KeyId`, `Label`, and `DataType`.
+    #   <note markdown="1"> The following `Key` values are supported for `GetParametersByPath`\:
+    #   `Type`, `KeyId`, and `Label`.
     #
-    #    The following `Key` values are not supported for
-    #   `GetParametersByPath`\: `tag`, `Name`, `Path`, and `Tier`.
+    #    The following `Key` values aren't supported for
+    #   `GetParametersByPath`\: `tag`, `DataType`, `Name`, `Path`, and
+    #   `Tier`.
     #
     #    </note>
     #   @return [Array<Types::ParameterStringFilter>]
@@ -13609,6 +13658,11 @@ module Aws::SSM
     #   A description of the task.
     #   @return [String]
     #
+    # @!attribute [rw] cutoff_behavior
+    #   The specification for whether tasks should continue to run after the
+    #   cutoff time specified in the maintenance windows is reached.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/MaintenanceWindowTask AWS API Documentation
     #
     class MaintenanceWindowTask < Struct.new(
@@ -13624,7 +13678,8 @@ module Aws::SSM
       :max_concurrency,
       :max_errors,
       :name,
-      :description)
+      :description,
+      :cutoff_behavior)
       SENSITIVE = [:task_parameters, :description]
       include Aws::Structure
     end
@@ -15266,11 +15321,11 @@ module Aws::SSM
     #   and GetParametersByPath API operations. However, not all of the
     #   pattern values listed for `Key` can be used with both operations.
     #
-    #   For `DescribeActions`, all of the listed patterns are valid, with
-    #   the exception of `Label`.
+    #   For `DescribeActions`, all of the listed patterns are valid except
+    #   `Label`.
     #
     #   For `GetParametersByPath`, the following patterns listed for `Key`
-    #   aren't valid: `tag`, `Name`, `Path`, and `Tier`.
+    #   aren't valid: `tag`, `DataType`, `Name`, `Path`, and `Tier`.
     #
     #   For examples of Amazon Web Services CLI commands demonstrating valid
     #   parameter filter constructions, see [Searching for Systems Manager
@@ -16731,6 +16786,7 @@ module Aws::SSM
     #         name: "MaintenanceWindowName",
     #         description: "MaintenanceWindowDescription",
     #         client_token: "ClientToken",
+    #         cutoff_behavior: "CONTINUE_TASK", # accepts CONTINUE_TASK, CANCEL_TASK
     #       }
     #
     # @!attribute [rw] window_id
@@ -16870,6 +16926,28 @@ module Aws::SSM
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] cutoff_behavior
+    #   Indicates whether tasks should continue to run after the cutoff time
+    #   specified in the maintenance windows is reached.
+    #
+    #   * `CONTINUE_TASK`\: When the cutoff time is reached, any tasks that
+    #     are running continue. The default value.
+    #
+    #   * `CANCEL_TASK`\:
+    #
+    #     * For Automation, Lambda, Step Functions tasks: When the cutoff
+    #       time is reached, any task invocations that are already running
+    #       continue, but no new task invocations are started.
+    #
+    #     * For Run Command tasks: When the cutoff time is reached, the
+    #       system sends a CancelCommand operation that attempts to cancel
+    #       the command associated with the task. However, there is no
+    #       guarantee that the command will be terminated and the underlying
+    #       process stopped.
+    #
+    #     The status for tasks that are not completed is `TIMED_OUT`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/RegisterTaskWithMaintenanceWindowRequest AWS API Documentation
     #
     class RegisterTaskWithMaintenanceWindowRequest < Struct.new(
@@ -16886,7 +16964,8 @@ module Aws::SSM
       :logging_info,
       :name,
       :description,
-      :client_token)
+      :client_token,
+      :cutoff_behavior)
       SENSITIVE = [:task_parameters, :description]
       include Aws::Structure
     end
@@ -17989,9 +18068,15 @@ module Aws::SSM
     #   The name of the Amazon Web Services Systems Manager document (SSM
     #   document) to run. This can be a public document or a custom
     #   document. To run a shared document belonging to another account,
-    #   specify the document ARN. For more information about how to use
-    #   shared documents, see [Using shared SSM documents][1] in the *Amazon
-    #   Web Services Systems Manager User Guide*.
+    #   specify the document Amazon Resource Name (ARN). For more
+    #   information about how to use shared documents, see [Using shared SSM
+    #   documents][1] in the *Amazon Web Services Systems Manager User
+    #   Guide*.
+    #
+    #   <note markdown="1"> If you specify a document name or ARN that hasn't been shared with
+    #   your account, you receive an `InvalidDocument` error.
+    #
+    #    </note>
     #
     #
     #
@@ -20344,6 +20429,7 @@ module Aws::SSM
     #         name: "MaintenanceWindowName",
     #         description: "MaintenanceWindowDescription",
     #         replace: false,
+    #         cutoff_behavior: "CONTINUE_TASK", # accepts CONTINUE_TASK, CANCEL_TASK
     #       }
     #
     # @!attribute [rw] window_id
@@ -20499,6 +20585,28 @@ module Aws::SSM
     #   null.
     #   @return [Boolean]
     #
+    # @!attribute [rw] cutoff_behavior
+    #   Indicates whether tasks should continue to run after the cutoff time
+    #   specified in the maintenance windows is reached.
+    #
+    #   * `CONTINUE_TASK`\: When the cutoff time is reached, any tasks that
+    #     are running continue. The default value.
+    #
+    #   * `CANCEL_TASK`\:
+    #
+    #     * For Automation, Lambda, Step Functions tasks: When the cutoff
+    #       time is reached, any task invocations that are already running
+    #       continue, but no new task invocations are started.
+    #
+    #     * For Run Command tasks: When the cutoff time is reached, the
+    #       system sends a CancelCommand operation that attempts to cancel
+    #       the command associated with the task. However, there is no
+    #       guarantee that the command will be terminated and the underlying
+    #       process stopped.
+    #
+    #     The status for tasks that are not completed is `TIMED_OUT`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateMaintenanceWindowTaskRequest AWS API Documentation
     #
     class UpdateMaintenanceWindowTaskRequest < Struct.new(
@@ -20515,7 +20623,8 @@ module Aws::SSM
       :logging_info,
       :name,
       :description,
-      :replace)
+      :replace,
+      :cutoff_behavior)
       SENSITIVE = [:task_parameters, :description]
       include Aws::Structure
     end
@@ -20593,6 +20702,11 @@ module Aws::SSM
     #   The updated task description.
     #   @return [String]
     #
+    # @!attribute [rw] cutoff_behavior
+    #   The specification for whether tasks should continue to run after the
+    #   cutoff time specified in the maintenance windows is reached.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateMaintenanceWindowTaskResult AWS API Documentation
     #
     class UpdateMaintenanceWindowTaskResult < Struct.new(
@@ -20608,7 +20722,8 @@ module Aws::SSM
       :max_errors,
       :logging_info,
       :name,
-      :description)
+      :description,
+      :cutoff_behavior)
       SENSITIVE = [:task_parameters, :description]
       include Aws::Structure
     end
@@ -21178,29 +21293,25 @@ module Aws::SSM
     #   @return [String]
     #
     # @!attribute [rw] setting_value
-    #   The new value to specify for the service setting. For the
-    #   `/ssm/parameter-store/default-parameter-tier` setting ID, the
-    #   setting value can be one of the following.
+    #   The new value to specify for the service setting. The following list
+    #   specifies the available values for each setting.
     #
-    #   * Standard
+    #   * `/ssm/parameter-store/default-parameter-tier`\: `Standard`,
+    #     `Advanced`, `Intelligent-Tiering`
     #
-    #   * Advanced
+    #   * `/ssm/parameter-store/high-throughput-enabled`\: `true` or `false`
     #
-    #   * Intelligent-Tiering
+    #   * `/ssm/managed-instance/activation-tier`\: `true` or `false`
     #
-    #   For the `/ssm/parameter-store/high-throughput-enabled`, and
-    #   `/ssm/managed-instance/activation-tier` setting IDs, the setting
-    #   value can be true or false.
+    #   * `/ssm/automation/customer-script-log-destination`\: `CloudWatch`
     #
-    #   For the `/ssm/automation/customer-script-log-destination` setting
-    #   ID, the setting value can be `CloudWatch`.
+    #   * `/ssm/automation/customer-script-log-group-name`\: the name of an
+    #     Amazon CloudWatch Logs log group
     #
-    #   For the `/ssm/automation/customer-script-log-group-name` setting ID,
-    #   the setting value can be the name of an Amazon CloudWatch Logs log
-    #   group.
+    #   * `/ssm/documents/console/public-sharing-permission`\: `Enable` or
+    #     `Disable`
     #
-    #   For the `/ssm/documents/console/public-sharing-permission` setting
-    #   ID, the setting value can be `Enable` or `Disable`.
+    #   * `/ssm/managed-instance/activation-tier`\: `standard` or `advanced`
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateServiceSettingRequest AWS API Documentation

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

@@ -136,6 +136,11 @@ module Aws::SSM
                 "matcher" => "path",
                 "state" => "failure",
                 "argument" => "status"
+              },
+              {
+                "state" => "retry",
+                "matcher" => "error",
+                "expected" => "InvocationDoesNotExist"
               }
             ]
           )

data/lib/aws-sdk-ssm.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ssm
 version: !ruby/object:Gem::Version
-  version: 1.117.0
+  version: 1.118.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-01 00:00:00.000000000 Z
+date: 2021-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core