aws-sdk-ssm 1.100.0 → 1.101.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93e73b8a694febf8c6e952fc85b110882e60c2bc1fe071539af701ebe15facf2
-  data.tar.gz: ad7a20e4c9faabd84ed9f2784d4bef9429003c26898ed6420640e9f291b47baa
+  metadata.gz: e292c9122019973744a4fa0856a0600224a4da16d3dc8cfc22596ceab5a69e40
+  data.tar.gz: 7aa34e0fb5d9e7a0381d38eb14dd817c29c6b77fbfd9ee1e0305f519eaaf451d
 SHA512:
-  metadata.gz: 7ff60f4c22619b371c04c924f3ce45498eacb765f5d29b65de780eb09d6325d45aacf7f64a776e87f67a4a2f7f1d52ecf99e985e021f4fc47bdd844ab0a2c768
-  data.tar.gz: 7dd2d933e43aab62907b24bf8679ae96a26db4f860727f561976211687c7310d1e692c672138ccb3fb1e5db6698cedd5e2dfeb926b35cdfcaaf694e44f44da3f
+  metadata.gz: 12e4709796c0f57c99f5d5e04a71e9f0dc1af6c5a318b5501b241c9ce994c599e22d97f8760393f305c68fcf1bc46898c24e1c86a2437f3eff4aff6b2b0793cf
+  data.tar.gz: 4bb872ab8dd90306105e666df7a852a2e039c4f68ce0195c7a9186688a7c919c0655f2b5ef3f35ab32b23389f6be1022ffd1e196cdef1291ca511a55b36e7283

data/lib/aws-sdk-ssm.rb

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

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

@@ -3845,6 +3845,14 @@ module Aws::SSM
 
     # Lists the tasks in a maintenance window.
     #
+    # <note markdown="1"> For maintenance window tasks without a specified target, you cannot
+    # supply values for `--max-errors` and `--max-concurrency`. Instead, the
+    # system inserts a placeholder value of `1`, which may be reported in
+    # the response to this command. These values do not affect the running
+    # of your task and can be ignored.
+    #
+    #  </note>
+    #
     # @option params [required, String] :window_id
     #   The ID of the maintenance window whose tasks should be retrieved.
     #
@@ -5435,6 +5443,14 @@ module Aws::SSM
 
     # Lists the tasks in a maintenance window.
     #
+    # <note markdown="1"> For maintenance window tasks without a specified target, you cannot
+    # supply values for `--max-errors` and `--max-concurrency`. Instead, the
+    # system inserts a placeholder value of `1`, which may be reported in
+    # the response to this command. These values do not affect the running
+    # of your task and can be ignored.
+    #
+    #  </note>
+    #
     # @option params [required, String] :window_id
     #   The maintenance window ID that includes the task to retrieve.
     #
@@ -7958,9 +7974,18 @@ module Aws::SSM
     # @option params [required, String] :window_id
     #   The ID of the maintenance window the task should be added to.
     #
-    # @option params [required, Array<Types::Target>] :targets
+    # @option params [Array<Types::Target>] :targets
     #   The targets (either instances or maintenance window targets).
     #
+    #   <note markdown="1"> One or more targets must be specified for maintenance window Run
+    #   Command-type tasks. Depending on the task, targets are optional for
+    #   other maintenance window task types (Automation, AWS Lambda, and AWS
+    #   Step Functions). For more information about running tasks that do not
+    #   specify targets, see see [Registering maintenance window tasks without
+    #   targets][1] in the *AWS Systems Manager User Guide*.
+    #
+    #    </note>
+    #
     #   Specify instances using the following format:
     #
     #   `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
@@ -7969,6 +7994,10 @@ module Aws::SSM
     #
     #   `Key=WindowTargetIds,Values=<window-target-id-1>,<window-target-id-2>`
     #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
+    #
     # @option params [required, String] :task_arn
     #   The ARN of the task to run.
     #
@@ -8017,13 +8046,27 @@ module Aws::SSM
     #   scheduled in priority order with tasks that have the same priority
     #   scheduled in parallel.
     #
-    # @option params [required, String] :max_concurrency
+    # @option params [String] :max_concurrency
     #   The maximum number of targets this task can be run for in parallel.
     #
-    # @option params [required, String] :max_errors
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`. This value does not affect the running of
+    #   your task.
+    #
+    #    </note>
+    #
+    # @option params [String] :max_errors
     #   The maximum number of errors allowed before this task stops being
     #   scheduled.
     #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`. This value does not affect the running of
+    #   your task.
+    #
+    #    </note>
+    #
     # @option params [Types::LoggingInfo] :logging_info
     #   A structure containing information about an S3 bucket to write
     #   instance-level logs to.
@@ -8057,7 +8100,7 @@ module Aws::SSM
     #
     #   resp = client.register_task_with_maintenance_window({
     #     window_id: "MaintenanceWindowId", # required
-    #     targets: [ # required
+    #     targets: [
     #       {
     #         key: "TargetKey",
     #         values: ["TargetValue"],
@@ -8111,8 +8154,8 @@ module Aws::SSM
     #       },
     #     },
     #     priority: 1,
-    #     max_concurrency: "MaxConcurrency", # required
-    #     max_errors: "MaxErrors", # required
+    #     max_concurrency: "MaxConcurrency",
+    #     max_errors: "MaxErrors",
     #     logging_info: {
     #       s3_bucket_name: "S3BucketName", # required
     #       s3_key_prefix: "S3KeyPrefix",
@@ -9702,6 +9745,15 @@ module Aws::SSM
     #
     # * MaxErrors
     #
+    # <note markdown="1"> One or more targets must be specified for maintenance window Run
+    # Command-type tasks. Depending on the task, targets are optional for
+    # other maintenance window task types (Automation, AWS Lambda, and AWS
+    # Step Functions). For more information about running tasks that do not
+    # specify targets, see see [Registering maintenance window tasks without
+    # targets][1] in the *AWS Systems Manager User Guide*.
+    #
+    #  </note>
+    #
     # If the value for a parameter in `UpdateMaintenanceWindowTask` is null,
     # then the corresponding field is not modified. If you set `Replace` to
     # true, then all fields required by the
@@ -9718,6 +9770,10 @@ module Aws::SSM
     # and specify only a different `OutputS3BucketName` value, the values
     # for `Comment` and `NotificationConfig` are removed.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
+    #
     # @option params [required, String] :window_id
     #   The maintenance window ID that contains the task to modify.
     #
@@ -9729,6 +9785,19 @@ module Aws::SSM
     #   specified using Key=instanceids,Values=instanceID\_1,instanceID\_2.
     #   Tags are specified using Key=tag\_name,Values=tag\_value.
     #
+    #   <note markdown="1"> One or more targets must be specified for maintenance window Run
+    #   Command-type tasks. Depending on the task, targets are optional for
+    #   other maintenance window task types (Automation, AWS Lambda, and AWS
+    #   Step Functions). For more information about running tasks that do not
+    #   specify targets, see see [Registering maintenance window tasks without
+    #   targets][1] in the *AWS Systems Manager User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
+    #
     # @option params [String] :task_arn
     #   The task ARN to modify.
     #
@@ -9794,11 +9863,27 @@ module Aws::SSM
     #   is the number of targets that are allowed to run this task in
     #   parallel.
     #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`, which may be reported in the response to
+    #   this command. This value does not affect the running of your task and
+    #   can be ignored.
+    #
+    #    </note>
+    #
     # @option params [String] :max_errors
     #   The new `MaxErrors` value to specify. `MaxErrors` is the maximum
     #   number of errors that are allowed before the task stops being
     #   scheduled.
     #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`, which may be reported in the response to
+    #   this command. This value does not affect the running of your task and
+    #   can be ignored.
+    #
+    #    </note>
+    #
     # @option params [Types::LoggingInfo] :logging_info
     #   The new logging location in Amazon S3 to specify.
     #
@@ -10507,7 +10592,7 @@ module Aws::SSM
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ssm'
-      context[:gem_version] = '1.100.0'
+      context[:gem_version] = '1.101.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -3758,15 +3758,15 @@ module Aws::SSM
     RegisterTargetWithMaintenanceWindowResult.struct_class = Types::RegisterTargetWithMaintenanceWindowResult
 
     RegisterTaskWithMaintenanceWindowRequest.add_member(:window_id, Shapes::ShapeRef.new(shape: MaintenanceWindowId, required: true, location_name: "WindowId"))
-    RegisterTaskWithMaintenanceWindowRequest.add_member(:targets, Shapes::ShapeRef.new(shape: Targets, required: true, location_name: "Targets"))
+    RegisterTaskWithMaintenanceWindowRequest.add_member(:targets, Shapes::ShapeRef.new(shape: Targets, location_name: "Targets", metadata: {"box"=>true}))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:task_arn, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskArn, required: true, location_name: "TaskArn"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:service_role_arn, Shapes::ShapeRef.new(shape: ServiceRole, location_name: "ServiceRoleArn"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:task_type, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskType, required: true, location_name: "TaskType"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:task_parameters, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskParameters, location_name: "TaskParameters"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:task_invocation_parameters, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskInvocationParameters, location_name: "TaskInvocationParameters"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:priority, Shapes::ShapeRef.new(shape: MaintenanceWindowTaskPriority, location_name: "Priority", metadata: {"box"=>true}))
-    RegisterTaskWithMaintenanceWindowRequest.add_member(:max_concurrency, Shapes::ShapeRef.new(shape: MaxConcurrency, required: true, location_name: "MaxConcurrency"))
-    RegisterTaskWithMaintenanceWindowRequest.add_member(:max_errors, Shapes::ShapeRef.new(shape: MaxErrors, required: true, location_name: "MaxErrors"))
+    RegisterTaskWithMaintenanceWindowRequest.add_member(:max_concurrency, Shapes::ShapeRef.new(shape: MaxConcurrency, location_name: "MaxConcurrency", metadata: {"box"=>true}))
+    RegisterTaskWithMaintenanceWindowRequest.add_member(:max_errors, Shapes::ShapeRef.new(shape: MaxErrors, location_name: "MaxErrors", metadata: {"box"=>true}))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:logging_info, Shapes::ShapeRef.new(shape: LoggingInfo, location_name: "LoggingInfo"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:name, Shapes::ShapeRef.new(shape: MaintenanceWindowName, location_name: "Name"))
     RegisterTaskWithMaintenanceWindowRequest.add_member(:description, Shapes::ShapeRef.new(shape: MaintenanceWindowDescription, location_name: "Description"))

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

@@ -8547,11 +8547,27 @@ module Aws::SSM
     #
     # @!attribute [rw] max_concurrency
     #   The maximum number of targets allowed to run this task in parallel.
+    #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`, which may be reported in the response to
+    #   this command. This value does not affect the running of your task
+    #   and can be ignored.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] max_errors
     #   The maximum number of errors allowed before the task stops being
     #   scheduled.
+    #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`, which may be reported in the response to
+    #   this command. This value does not affect the running of your task
+    #   and can be ignored.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] logging_info
@@ -15629,7 +15645,7 @@ module Aws::SSM
     #
     #       {
     #         window_id: "MaintenanceWindowId", # required
-    #         targets: [ # required
+    #         targets: [
     #           {
     #             key: "TargetKey",
     #             values: ["TargetValue"],
@@ -15683,8 +15699,8 @@ module Aws::SSM
     #           },
     #         },
     #         priority: 1,
-    #         max_concurrency: "MaxConcurrency", # required
-    #         max_errors: "MaxErrors", # required
+    #         max_concurrency: "MaxConcurrency",
+    #         max_errors: "MaxErrors",
     #         logging_info: {
     #           s3_bucket_name: "S3BucketName", # required
     #           s3_key_prefix: "S3KeyPrefix",
@@ -15702,6 +15718,15 @@ module Aws::SSM
     # @!attribute [rw] targets
     #   The targets (either instances or maintenance window targets).
     #
+    #   <note markdown="1"> One or more targets must be specified for maintenance window Run
+    #   Command-type tasks. Depending on the task, targets are optional for
+    #   other maintenance window task types (Automation, AWS Lambda, and AWS
+    #   Step Functions). For more information about running tasks that do
+    #   not specify targets, see see [Registering maintenance window tasks
+    #   without targets][1] in the *AWS Systems Manager User Guide*.
+    #
+    #    </note>
+    #
     #   Specify instances using the following format:
     #
     #   `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
@@ -15709,6 +15734,10 @@ module Aws::SSM
     #   Specify maintenance window targets using the following format:
     #
     #   `Key=WindowTargetIds,Values=<window-target-id-1>,<window-target-id-2>`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
     #   @return [Array<Types::Target>]
     #
     # @!attribute [rw] task_arn
@@ -15768,11 +15797,25 @@ module Aws::SSM
     #
     # @!attribute [rw] max_concurrency
     #   The maximum number of targets this task can be run for in parallel.
+    #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`. This value does not affect the running of
+    #   your task.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] max_errors
     #   The maximum number of errors allowed before this task stops being
     #   scheduled.
+    #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`. This value does not affect the running of
+    #   your task.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] logging_info
@@ -17924,6 +17967,15 @@ module Aws::SSM
     # An array of search criteria that targets instances using a Key,Value
     # combination that you specify.
     #
+    # <note markdown="1"> One or more targets must be specified for maintenance window Run
+    # Command-type tasks. Depending on the task, targets are optional for
+    # other maintenance window task types (Automation, AWS Lambda, and AWS
+    # Step Functions). For more information about running tasks that do not
+    # specify targets, see see [Registering maintenance window tasks without
+    # targets][1] in the *AWS Systems Manager User Guide*.
+    #
+    #  </note>
+    #
     # Supported formats include the following.
     #
     # * `Key=InstanceIds,Values=instance-id-1,instance-id-2,instance-id-3 `
@@ -17974,12 +18026,13 @@ module Aws::SSM
     #   AWS Region where the association was created.
     #
     # For more information about how to send commands that target instances
-    # using `Key,Value` parameters, see [Targeting multiple instances][1] in
+    # using `Key,Value` parameters, see [Targeting multiple instances][2] in
     # the *AWS Systems Manager User Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-targeting
+    # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
+    # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-targeting
     #
     # @note When making an API call, you may pass Target
     #   data as a hash:
@@ -19096,6 +19149,19 @@ module Aws::SSM
     #   The targets (either instances or tags) to modify. Instances are
     #   specified using Key=instanceids,Values=instanceID\_1,instanceID\_2.
     #   Tags are specified using Key=tag\_name,Values=tag\_value.
+    #
+    #   <note markdown="1"> One or more targets must be specified for maintenance window Run
+    #   Command-type tasks. Depending on the task, targets are optional for
+    #   other maintenance window task types (Automation, AWS Lambda, and AWS
+    #   Step Functions). For more information about running tasks that do
+    #   not specify targets, see see [Registering maintenance window tasks
+    #   without targets][1] in the *AWS Systems Manager User Guide*.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/maintenance-windows-targetless-tasks.html
     #   @return [Array<Types::Target>]
     #
     # @!attribute [rw] task_arn
@@ -19170,12 +19236,28 @@ module Aws::SSM
     #   The new `MaxConcurrency` value you want to specify. `MaxConcurrency`
     #   is the number of targets that are allowed to run this task in
     #   parallel.
+    #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`, which may be reported in the response to
+    #   this command. This value does not affect the running of your task
+    #   and can be ignored.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] max_errors
     #   The new `MaxErrors` value to specify. `MaxErrors` is the maximum
     #   number of errors that are allowed before the task stops being
     #   scheduled.
+    #
+    #   <note markdown="1"> For maintenance window tasks without a target specified, you cannot
+    #   supply a value for this option. Instead, the system inserts a
+    #   placeholder value of `1`, which may be reported in the response to
+    #   this command. This value does not affect the running of your task
+    #   and can be ignored.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] logging_info

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ssm
 version: !ruby/object:Gem::Version
-  version: 1.100.0
+  version: 1.101.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-15 00:00:00.000000000 Z
+date: 2020-12-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core