aws-sdk-ssm 1.9.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 557d1e44ee79a62e7f85053f956adcce68883b9b
4
- data.tar.gz: 7a96b26c6abdc2d51f1fbf342ff91a9d2c51bcf5
3
+ metadata.gz: 340dacec45f334bafcee01937832015c8e8816b2
4
+ data.tar.gz: 343fd391b409085fa163a58df60423436f312218
5
5
  SHA512:
6
- metadata.gz: e3994f6d71478f02848ea07683cf6f637b24fd45c026a0c10c9227078090e028260af9fa4229356f525e0de18e93a34ad29c2a857cc481797129edd44144bf20
7
- data.tar.gz: c0142a8aed76fbe201efd16db00c02df10ca416326e7f83ee70ab048c2a00c353e96e3eac751c1d96168b134cc6d220e588fb84fedd07f5970f805ac03daccc9
6
+ metadata.gz: 5c0a3dffe96186856564ab00b0a727289505b1d1fbdd30ac2eca13463573177177fb1c67e38bf07103a4feaac985c5452f732eb3aa68ba45968e82325943a58e
7
+ data.tar.gz: 31337e8aa4881182db4d8b67a139e39ab313ada454d2238cfae557e19630d25ef6852927509213b31116c2df843c08cff810434f3747bfbd07119b9422122477
data/lib/aws-sdk-ssm.rb CHANGED
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-ssm/customizations'
42
42
  # @service
43
43
  module Aws::SSM
44
44
 
45
- GEM_VERSION = '1.9.0'
45
+ GEM_VERSION = '1.10.0'
46
46
 
47
47
  end
@@ -185,20 +185,40 @@ module Aws::SSM
185
185
  # @option params [required, String] :resource_type
186
186
  # Specifies the type of resource you are tagging.
187
187
  #
188
+ # <note markdown="1"> The ManagedInstance type for this API action is for on-premises
189
+ # managed instances. You must specify the the name of the managed
190
+ # instance in the following format: mi-ID\_number. For example,
191
+ # mi-1a2b3c4d5e6f.
192
+ #
193
+ # </note>
194
+ #
188
195
  # @option params [required, String] :resource_id
189
196
  # The resource ID you want to tag.
190
197
  #
191
- # For the ManagedInstance, MaintenanceWindow, and PatchBaseline values,
192
- # use the ID of the resource, such as mw-01234361858c9b57b for a
193
- # Maintenance Window.
198
+ # Use the ID of the resource. Here are some examples:
199
+ #
200
+ # ManagedInstance: mi-012345abcde
201
+ #
202
+ # MaintenanceWindow: mw-012345abcde
203
+ #
204
+ # PatchBaseline: pb-012345abcde
194
205
  #
195
206
  # For the Document and Parameter values, use the name of the resource.
196
207
  #
208
+ # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
209
+ # managed instances. You must specify the the name of the managed
210
+ # instance in the following format: mi-ID\_number. For example,
211
+ # mi-1a2b3c4d5e6f.
212
+ #
213
+ # </note>
214
+ #
197
215
  # @option params [required, Array<Types::Tag>] :tags
198
216
  # One or more tags. The value parameter is required, but if you don't
199
217
  # want the tag to have a value, specify the parameter with no value, and
200
218
  # we set the value to an empty string.
201
219
  #
220
+ # Do not enter personally identifiable information in this field.
221
+ #
202
222
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
203
223
  #
204
224
  # @example Request syntax with placeholder values
@@ -265,14 +285,18 @@ module Aws::SSM
265
285
  # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html
266
286
  #
267
287
  # @option params [String] :description
268
- # A userdefined description of the resource that you want to register
288
+ # A user-defined description of the resource that you want to register
269
289
  # with Amazon EC2.
270
290
  #
291
+ # Do not enter personally identifiable information in this field.
292
+ #
271
293
  # @option params [String] :default_instance_name
272
294
  # The name of the registered, managed instance as it will appear in the
273
295
  # Amazon EC2 console or when you use the AWS command line tools to list
274
296
  # EC2 resources.
275
297
  #
298
+ # Do not enter personally identifiable information in this field.
299
+ #
276
300
  # @option params [required, String] :iam_role
277
301
  # The Amazon Identity and Access Management (IAM) role that you want to
278
302
  # assign to the managed instance.
@@ -717,12 +741,18 @@ module Aws::SSM
717
741
  # @option params [Array<String>] :approved_patches
718
742
  # A list of explicitly approved patches for the baseline.
719
743
  #
744
+ # For information about accepted formats for lists of approved patches
745
+ # and rejected patches, see [Package Name Formats for Approved and
746
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
747
+ #
748
+ #
749
+ #
750
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
751
+ #
720
752
  # @option params [String] :approved_patches_compliance_level
721
753
  # Defines the compliance level for approved patches. This means that if
722
754
  # an approved patch is reported as missing, this is the severity of the
723
- # compliance violation. Valid compliance severity levels include the
724
- # following: CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED.
725
- # The default value is UNSPECIFIED.
755
+ # compliance violation. The default value is UNSPECIFIED.
726
756
  #
727
757
  # @option params [Boolean] :approved_patches_enable_non_security
728
758
  # Indicates whether the list of approved patches includes non-security
@@ -732,6 +762,14 @@ module Aws::SSM
732
762
  # @option params [Array<String>] :rejected_patches
733
763
  # A list of explicitly rejected patches for the baseline.
734
764
  #
765
+ # For information about accepted formats for lists of approved patches
766
+ # and rejected patches, see [Package Name Formats for Approved and
767
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
768
+ #
769
+ #
770
+ #
771
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
772
+ #
735
773
  # @option params [String] :description
736
774
  # A description of the patch baseline.
737
775
  #
@@ -2843,6 +2881,9 @@ module Aws::SSM
2843
2881
  # supports creating multiple default patch baselines. For example, you
2844
2882
  # can create a default patch baseline for each operating system.
2845
2883
  #
2884
+ # If you do not specify an operating system value, the default patch
2885
+ # baseline for Windows is returned.
2886
+ #
2846
2887
  # @option params [String] :operating_system
2847
2888
  # Returns the default patch baseline for the specified operating system.
2848
2889
  #
@@ -4726,6 +4767,8 @@ module Aws::SSM
4726
4767
  # @option params [String] :description
4727
4768
  # Information about the parameter that you want to add to the system.
4728
4769
  #
4770
+ # Do not enter personally identifiable information in this field.
4771
+ #
4729
4772
  # @option params [required, String] :value
4730
4773
  # The parameter value that you want to add to the system.
4731
4774
  #
@@ -4848,9 +4891,17 @@ module Aws::SSM
4848
4891
  # The type of target being registered with the Maintenance Window.
4849
4892
  #
4850
4893
  # @option params [required, Array<Types::Target>] :targets
4851
- # The targets (either instances or tags). Instances are specified using
4852
- # Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags
4853
- # are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.
4894
+ # The targets (either instances or tags).
4895
+ #
4896
+ # Specify instances using the following format:
4897
+ #
4898
+ # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
4899
+ #
4900
+ # Specify tags using either of the following formats:
4901
+ #
4902
+ # `Key=tag:<tag-key>,Values=<tag-value-1>,<tag-value-2>`
4903
+ #
4904
+ # `Key=tag-key,Values=<tag-key-1>,<tag-key-2>`
4854
4905
  #
4855
4906
  # @option params [String] :owner_information
4856
4907
  # User-provided value that will be included in any CloudWatch events
@@ -4906,12 +4957,18 @@ module Aws::SSM
4906
4957
  # Adds a new task to a Maintenance Window.
4907
4958
  #
4908
4959
  # @option params [required, String] :window_id
4909
- # The id of the Maintenance Window the task should be added to.
4960
+ # The ID of the Maintenance Window the task should be added to.
4910
4961
  #
4911
4962
  # @option params [required, Array<Types::Target>] :targets
4912
- # The targets (either instances or tags). Instances are specified using
4913
- # Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags
4914
- # are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.
4963
+ # The targets (either instances or Maintenance Window targets).
4964
+ #
4965
+ # Specify instances using the following format:
4966
+ #
4967
+ # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
4968
+ #
4969
+ # Specify Maintenance Window targets using the following format:
4970
+ #
4971
+ # `Key=<WindowTargetIds>,Values=<window-target-id-1>,<window-target-id-2>`
4915
4972
  #
4916
4973
  # @option params [required, String] :task_arn
4917
4974
  # The ARN of the task to execute
@@ -4925,6 +4982,14 @@ module Aws::SSM
4925
4982
  # @option params [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>] :task_parameters
4926
4983
  # The parameters that should be passed to the task when it is executed.
4927
4984
  #
4985
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass to
4986
+ # a task when it runs, instead use the `Parameters` option in the
4987
+ # `TaskInvocationParameters` structure. For information about how
4988
+ # Systems Manager handles these options for the supported Maintenance
4989
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
4990
+ #
4991
+ # </note>
4992
+ #
4928
4993
  # @option params [Types::MaintenanceWindowTaskInvocationParameters] :task_invocation_parameters
4929
4994
  # The parameters that the task should use during execution. Populate
4930
4995
  # only the fields that match the task type. All other fields should be
@@ -4947,6 +5012,15 @@ module Aws::SSM
4947
5012
  # A structure containing information about an Amazon S3 bucket to write
4948
5013
  # instance-level logs to.
4949
5014
  #
5015
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
5016
+ # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
5017
+ # options in the `TaskInvocationParameters` structure. For information
5018
+ # about how Systems Manager handles these options for the supported
5019
+ # Maintenance Window task types, see
5020
+ # MaintenanceWindowTaskInvocationParameters.
5021
+ #
5022
+ # </note>
5023
+ #
4950
5024
  # @option params [String] :name
4951
5025
  # An optional name for the task.
4952
5026
  #
@@ -5046,8 +5120,31 @@ module Aws::SSM
5046
5120
  # @option params [required, String] :resource_type
5047
5121
  # The type of resource of which you want to remove a tag.
5048
5122
  #
5123
+ # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
5124
+ # managed instances. You must specify the the name of the managed
5125
+ # instance in the following format: mi-ID\_number. For example,
5126
+ # mi-1a2b3c4d5e6f.
5127
+ #
5128
+ # </note>
5129
+ #
5049
5130
  # @option params [required, String] :resource_id
5050
- # The resource ID for which you want to remove tags.
5131
+ # The resource ID for which you want to remove tags. Use the ID of the
5132
+ # resource. Here are some examples:
5133
+ #
5134
+ # ManagedInstance: mi-012345abcde
5135
+ #
5136
+ # MaintenanceWindow: mw-012345abcde
5137
+ #
5138
+ # PatchBaseline: pb-012345abcde
5139
+ #
5140
+ # For the Document and Parameter values, use the name of the resource.
5141
+ #
5142
+ # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
5143
+ # managed instances. You must specify the the name of the managed
5144
+ # instance in the following format: mi-ID\_number. For example,
5145
+ # mi-1a2b3c4d5e6f.
5146
+ #
5147
+ # </note>
5051
5148
  #
5052
5149
  # @option params [required, Array<String>] :tag_keys
5053
5150
  # Tag keys that you want to remove from the specified resource.
@@ -5152,7 +5249,7 @@ module Aws::SSM
5152
5249
  #
5153
5250
  # @option params [Integer] :timeout_seconds
5154
5251
  # If this time is reached and the command has not already started
5155
- # executing, it will not execute.
5252
+ # executing, it will not run.
5156
5253
  #
5157
5254
  # @option params [String] :comment
5158
5255
  # User-specified information about the command, such as a brief
@@ -5852,18 +5949,18 @@ module Aws::SSM
5852
5949
  # Modifies a task assigned to a Maintenance Window. You can't change
5853
5950
  # the task type, but you can change the following values:
5854
5951
  #
5855
- # Task ARN. For example, you can change a RUN\_COMMAND task from
5856
- # AWS-RunPowerShellScript to AWS-RunShellScript.
5952
+ # * TaskARN. For example, you can change a RUN\_COMMAND task from
5953
+ # AWS-RunPowerShellScript to AWS-RunShellScript.
5857
5954
  #
5858
- # Service role ARN.
5955
+ # * ServiceRoleArn
5859
5956
  #
5860
- # Task parameters.
5957
+ # * TaskInvocationParameters
5861
5958
  #
5862
- # Task priority.
5959
+ # * Priority
5863
5960
  #
5864
- # Task MaxConcurrency and MaxErrors.
5961
+ # * MaxConcurrency
5865
5962
  #
5866
- # Log location.
5963
+ # * MaxErrors
5867
5964
  #
5868
5965
  # If a parameter is null, then the corresponding field is not modified.
5869
5966
  # Also, if you set Replace to true, then all fields required by the
@@ -5889,7 +5986,17 @@ module Aws::SSM
5889
5986
  # during task execution.
5890
5987
  #
5891
5988
  # @option params [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>] :task_parameters
5892
- # The parameters to modify. The map has the following format:
5989
+ # The parameters to modify.
5990
+ #
5991
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass to
5992
+ # a task when it runs, instead use the `Parameters` option in the
5993
+ # `TaskInvocationParameters` structure. For information about how
5994
+ # Systems Manager handles these options for the supported Maintenance
5995
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
5996
+ #
5997
+ # </note>
5998
+ #
5999
+ # The map has the following format:
5893
6000
  #
5894
6001
  # Key: string, between 1 and 255 characters
5895
6002
  #
@@ -5918,6 +6025,15 @@ module Aws::SSM
5918
6025
  # @option params [Types::LoggingInfo] :logging_info
5919
6026
  # The new logging location in Amazon S3 to specify.
5920
6027
  #
6028
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
6029
+ # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
6030
+ # options in the `TaskInvocationParameters` structure. For information
6031
+ # about how Systems Manager handles these options for the supported
6032
+ # Maintenance Window task types, see
6033
+ # MaintenanceWindowTaskInvocationParameters.
6034
+ #
6035
+ # </note>
6036
+ #
5921
6037
  # @option params [String] :name
5922
6038
  # The new task name to specify.
5923
6039
  #
@@ -6118,6 +6234,14 @@ module Aws::SSM
6118
6234
  # @option params [Array<String>] :approved_patches
6119
6235
  # A list of explicitly approved patches for the baseline.
6120
6236
  #
6237
+ # For information about accepted formats for lists of approved patches
6238
+ # and rejected patches, see [Package Name Formats for Approved and
6239
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
6240
+ #
6241
+ #
6242
+ #
6243
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
6244
+ #
6121
6245
  # @option params [String] :approved_patches_compliance_level
6122
6246
  # Assigns a new compliance severity level to an existing patch baseline.
6123
6247
  #
@@ -6129,6 +6253,14 @@ module Aws::SSM
6129
6253
  # @option params [Array<String>] :rejected_patches
6130
6254
  # A list of explicitly rejected patches for the baseline.
6131
6255
  #
6256
+ # For information about accepted formats for lists of approved patches
6257
+ # and rejected patches, see [Package Name Formats for Approved and
6258
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
6259
+ #
6260
+ #
6261
+ #
6262
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
6263
+ #
6132
6264
  # @option params [String] :description
6133
6265
  # A description of the patch baseline.
6134
6266
  #
@@ -6257,7 +6389,7 @@ module Aws::SSM
6257
6389
  params: params,
6258
6390
  config: config)
6259
6391
  context[:gem_name] = 'aws-sdk-ssm'
6260
- context[:gem_version] = '1.9.0'
6392
+ context[:gem_version] = '1.10.0'
6261
6393
  Seahorse::Client::Request.new(handlers, context)
6262
6394
  end
6263
6395
 
@@ -84,22 +84,42 @@ module Aws::SSM
84
84
  #
85
85
  # @!attribute [rw] resource_type
86
86
  # Specifies the type of resource you are tagging.
87
+ #
88
+ # <note markdown="1"> The ManagedInstance type for this API action is for on-premises
89
+ # managed instances. You must specify the the name of the managed
90
+ # instance in the following format: mi-ID\_number. For example,
91
+ # mi-1a2b3c4d5e6f.
92
+ #
93
+ # </note>
87
94
  # @return [String]
88
95
  #
89
96
  # @!attribute [rw] resource_id
90
97
  # The resource ID you want to tag.
91
98
  #
92
- # For the ManagedInstance, MaintenanceWindow, and PatchBaseline
93
- # values, use the ID of the resource, such as mw-01234361858c9b57b for
94
- # a Maintenance Window.
99
+ # Use the ID of the resource. Here are some examples:
100
+ #
101
+ # ManagedInstance: mi-012345abcde
102
+ #
103
+ # MaintenanceWindow: mw-012345abcde
104
+ #
105
+ # PatchBaseline: pb-012345abcde
95
106
  #
96
107
  # For the Document and Parameter values, use the name of the resource.
108
+ #
109
+ # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
110
+ # managed instances. You must specify the the name of the managed
111
+ # instance in the following format: mi-ID\_number. For example,
112
+ # mi-1a2b3c4d5e6f.
113
+ #
114
+ # </note>
97
115
  # @return [String]
98
116
  #
99
117
  # @!attribute [rw] tags
100
118
  # One or more tags. The value parameter is required, but if you don't
101
119
  # want the tag to have a value, specify the parameter with no value,
102
120
  # and we set the value to an empty string.
121
+ #
122
+ # Do not enter personally identifiable information in this field.
103
123
  # @return [Array<Types::Tag>]
104
124
  #
105
125
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AddTagsToResourceRequest AWS API Documentation
@@ -742,7 +762,7 @@ module Aws::SSM
742
762
  #
743
763
  # @!attribute [rw] expires_after
744
764
  # If this time is reached and the command has not already started
745
- # executing, it will not execute. Calculated based on the ExpiresAfter
765
+ # executing, it will not run. Calculated based on the ExpiresAfter
746
766
  # user input provided as part of the SendCommand API.
747
767
  # @return [Time]
748
768
  #
@@ -1291,15 +1311,15 @@ module Aws::SSM
1291
1311
  #
1292
1312
  # @!attribute [rw] id
1293
1313
  # An ID for the compliance item. For example, if the compliance item
1294
- # is a Windows patch, the ID could be the number of the KB article.
1295
- # Here's an example: KB4010320.
1314
+ # is a Windows patch, the ID could be the number of the KB article;
1315
+ # for example: KB4010320.
1296
1316
  # @return [String]
1297
1317
  #
1298
1318
  # @!attribute [rw] title
1299
1319
  # A title for the compliance item. For example, if the compliance item
1300
1320
  # is a Windows patch, the title could be the title of the KB article
1301
- # for the patch. Here's an example: Security Update for Active
1302
- # Directory Federation Services.
1321
+ # for the patch; for example: Security Update for Active Directory
1322
+ # Federation Services.
1303
1323
  # @return [String]
1304
1324
  #
1305
1325
  # @!attribute [rw] status
@@ -1360,8 +1380,8 @@ module Aws::SSM
1360
1380
  # @!attribute [rw] title
1361
1381
  # The title of the compliance item. For example, if the compliance
1362
1382
  # item is a Windows patch, the title could be the title of the KB
1363
- # article for the patch. Here's an example: Security Update for
1364
- # Active Directory Federation Services.
1383
+ # article for the patch; for example: Security Update for Active
1384
+ # Directory Federation Services.
1365
1385
  # @return [String]
1366
1386
  #
1367
1387
  # @!attribute [rw] severity
@@ -1478,14 +1498,18 @@ module Aws::SSM
1478
1498
  # }
1479
1499
  #
1480
1500
  # @!attribute [rw] description
1481
- # A userdefined description of the resource that you want to register
1501
+ # A user-defined description of the resource that you want to register
1482
1502
  # with Amazon EC2.
1503
+ #
1504
+ # Do not enter personally identifiable information in this field.
1483
1505
  # @return [String]
1484
1506
  #
1485
1507
  # @!attribute [rw] default_instance_name
1486
1508
  # The name of the registered, managed instance as it will appear in
1487
1509
  # the Amazon EC2 console or when you use the AWS command line tools to
1488
1510
  # list EC2 resources.
1511
+ #
1512
+ # Do not enter personally identifiable information in this field.
1489
1513
  # @return [String]
1490
1514
  #
1491
1515
  # @!attribute [rw] iam_role
@@ -1974,14 +1998,20 @@ module Aws::SSM
1974
1998
  #
1975
1999
  # @!attribute [rw] approved_patches
1976
2000
  # A list of explicitly approved patches for the baseline.
2001
+ #
2002
+ # For information about accepted formats for lists of approved patches
2003
+ # and rejected patches, see [Package Name Formats for Approved and
2004
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
2005
+ #
2006
+ #
2007
+ #
2008
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
1977
2009
  # @return [Array<String>]
1978
2010
  #
1979
2011
  # @!attribute [rw] approved_patches_compliance_level
1980
2012
  # Defines the compliance level for approved patches. This means that
1981
2013
  # if an approved patch is reported as missing, this is the severity of
1982
- # the compliance violation. Valid compliance severity levels include
1983
- # the following: CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL,
1984
- # UNSPECIFIED. The default value is UNSPECIFIED.
2014
+ # the compliance violation. The default value is UNSPECIFIED.
1985
2015
  # @return [String]
1986
2016
  #
1987
2017
  # @!attribute [rw] approved_patches_enable_non_security
@@ -1992,6 +2022,14 @@ module Aws::SSM
1992
2022
  #
1993
2023
  # @!attribute [rw] rejected_patches
1994
2024
  # A list of explicitly rejected patches for the baseline.
2025
+ #
2026
+ # For information about accepted formats for lists of approved patches
2027
+ # and rejected patches, see [Package Name Formats for Approved and
2028
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
2029
+ #
2030
+ #
2031
+ #
2032
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
1995
2033
  # @return [Array<String>]
1996
2034
  #
1997
2035
  # @!attribute [rw] description
@@ -4408,8 +4446,8 @@ module Aws::SSM
4408
4446
  # @return [String]
4409
4447
  #
4410
4448
  # @!attribute [rw] status
4411
- # The status of the parent command for this invocation. This status
4412
- # can be different than StatusDetails.
4449
+ # The status of this invocation plugin. This status can be different
4450
+ # than StatusDetails.
4413
4451
  # @return [String]
4414
4452
  #
4415
4453
  # @!attribute [rw] status_details
@@ -5017,8 +5055,17 @@ module Aws::SSM
5017
5055
  # @return [String]
5018
5056
  #
5019
5057
  # @!attribute [rw] task_parameters
5020
- # The parameters passed to the task when it was executed. The map has
5021
- # the following format:
5058
+ # The parameters passed to the task when it was executed.
5059
+ #
5060
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass
5061
+ # to a task when it runs, instead use the `Parameters` option in the
5062
+ # `TaskInvocationParameters` structure. For information about how
5063
+ # Systems Manager handles these options for the supported Maintenance
5064
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
5065
+ #
5066
+ # </note>
5067
+ #
5068
+ # The map has the following format:
5022
5069
  #
5023
5070
  # Key: string, between 1 and 255 characters
5024
5071
  #
@@ -5207,6 +5254,14 @@ module Aws::SSM
5207
5254
  #
5208
5255
  # @!attribute [rw] task_parameters
5209
5256
  # The parameters to pass to the task when it executes.
5257
+ #
5258
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass
5259
+ # to a task when it runs, instead use the `Parameters` option in the
5260
+ # `TaskInvocationParameters` structure. For information about how
5261
+ # Systems Manager handles these options for the supported Maintenance
5262
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
5263
+ #
5264
+ # </note>
5210
5265
  # @return [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>]
5211
5266
  #
5212
5267
  # @!attribute [rw] task_invocation_parameters
@@ -5230,6 +5285,15 @@ module Aws::SSM
5230
5285
  #
5231
5286
  # @!attribute [rw] logging_info
5232
5287
  # The location in Amazon S3 where the task results are logged.
5288
+ #
5289
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to
5290
+ # contain logs, instead use the `OutputS3BucketName` and
5291
+ # `OutputS3KeyPrefix` options in the `TaskInvocationParameters`
5292
+ # structure. For information about how Systems Manager handles these
5293
+ # options for the supported Maintenance Window task types, see
5294
+ # MaintenanceWindowTaskInvocationParameters.
5295
+ #
5296
+ # </note>
5233
5297
  # @return [Types::LoggingInfo]
5234
5298
  #
5235
5299
  # @!attribute [rw] name
@@ -5968,7 +6032,7 @@ module Aws::SSM
5968
6032
  # @return [String]
5969
6033
  #
5970
6034
  # @!attribute [rw] owner_information
5971
- # Placeholder information, this field will always be empty in the
6035
+ # Placeholder information. This field will always be empty in the
5972
6036
  # current release of the service.
5973
6037
  # @return [String]
5974
6038
  #
@@ -7052,6 +7116,15 @@ module Aws::SSM
7052
7116
 
7053
7117
  # Information about an Amazon S3 bucket to write instance-level logs to.
7054
7118
  #
7119
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
7120
+ # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
7121
+ # options in the `TaskInvocationParameters` structure. For information
7122
+ # about how Systems Manager handles these options for the supported
7123
+ # Maintenance Window task types, see
7124
+ # MaintenanceWindowTaskInvocationParameters.
7125
+ #
7126
+ # </note>
7127
+ #
7055
7128
  # @note When making an API call, you may pass LoggingInfo
7056
7129
  # data as a hash:
7057
7130
  #
@@ -7100,6 +7173,27 @@ module Aws::SSM
7100
7173
  #
7101
7174
  # @!attribute [rw] parameters
7102
7175
  # The parameters for the AUTOMATION task.
7176
+ #
7177
+ # For information about specifying and updating task parameters, see
7178
+ # RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.
7179
+ #
7180
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to
7181
+ # contain logs, instead use the `OutputS3BucketName` and
7182
+ # `OutputS3KeyPrefix` options in the `TaskInvocationParameters`
7183
+ # structure. For information about how Systems Manager handles these
7184
+ # options for the supported Maintenance Window task types, see
7185
+ # MaintenanceWindowTaskInvocationParameters.
7186
+ #
7187
+ # `TaskParameters` has been deprecated. To specify parameters to pass
7188
+ # to a task when it runs, instead use the `Parameters` option in the
7189
+ # `TaskInvocationParameters` structure. For information about how
7190
+ # Systems Manager handles these options for the supported Maintenance
7191
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
7192
+ #
7193
+ # For AUTOMATION task types, Systems Manager ignores any values
7194
+ # specified for these parameters.
7195
+ #
7196
+ # </note>
7103
7197
  # @return [Hash<String,Array<String>>]
7104
7198
  #
7105
7199
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/MaintenanceWindowAutomationParameters AWS API Documentation
@@ -7345,6 +7439,27 @@ module Aws::SSM
7345
7439
 
7346
7440
  # The parameters for a LAMBDA task type.
7347
7441
  #
7442
+ # For information about specifying and updating task parameters, see
7443
+ # RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.
7444
+ #
7445
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
7446
+ # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
7447
+ # options in the `TaskInvocationParameters` structure. For information
7448
+ # about how Systems Manager handles these options for the supported
7449
+ # Maintenance Window task types, see
7450
+ # MaintenanceWindowTaskInvocationParameters.
7451
+ #
7452
+ # `TaskParameters` has been deprecated. To specify parameters to pass to
7453
+ # a task when it runs, instead use the `Parameters` option in the
7454
+ # `TaskInvocationParameters` structure. For information about how
7455
+ # Systems Manager handles these options for the supported Maintenance
7456
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
7457
+ #
7458
+ # For Lambda tasks, Systems Manager ignores any values specified for
7459
+ # TaskParameters and LoggingInfo.
7460
+ #
7461
+ # </note>
7462
+ #
7348
7463
  # @note When making an API call, you may pass MaintenanceWindowLambdaParameters
7349
7464
  # data as a hash:
7350
7465
  #
@@ -7383,6 +7498,28 @@ module Aws::SSM
7383
7498
 
7384
7499
  # The parameters for a RUN\_COMMAND task type.
7385
7500
  #
7501
+ # For information about specifying and updating task parameters, see
7502
+ # RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.
7503
+ #
7504
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
7505
+ # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
7506
+ # options in the `TaskInvocationParameters` structure. For information
7507
+ # about how Systems Manager handles these options for the supported
7508
+ # Maintenance Window task types, see
7509
+ # MaintenanceWindowTaskInvocationParameters.
7510
+ #
7511
+ # `TaskParameters` has been deprecated. To specify parameters to pass to
7512
+ # a task when it runs, instead use the `Parameters` option in the
7513
+ # `TaskInvocationParameters` structure. For information about how
7514
+ # Systems Manager handles these options for the supported Maintenance
7515
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
7516
+ #
7517
+ # For Run Command tasks, Systems Manager uses specified values for
7518
+ # `TaskParameters` and `LoggingInfo` only if no values are specified for
7519
+ # `TaskInvocationParameters`.
7520
+ #
7521
+ # </note>
7522
+ #
7386
7523
  # @note When making an API call, you may pass MaintenanceWindowRunCommandParameters
7387
7524
  # data as a hash:
7388
7525
  #
@@ -7458,7 +7595,28 @@ module Aws::SSM
7458
7595
  include Aws::Structure
7459
7596
  end
7460
7597
 
7461
- # The parameters for the STEP\_FUNCTION execution.
7598
+ # The parameters for a STEP\_FUNCTION task.
7599
+ #
7600
+ # For information about specifying and updating task parameters, see
7601
+ # RegisterTaskWithMaintenanceWindow and UpdateMaintenanceWindowTask.
7602
+ #
7603
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
7604
+ # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
7605
+ # options in the `TaskInvocationParameters` structure. For information
7606
+ # about how Systems Manager handles these options for the supported
7607
+ # Maintenance Window task types, see
7608
+ # MaintenanceWindowTaskInvocationParameters.
7609
+ #
7610
+ # `TaskParameters` has been deprecated. To specify parameters to pass to
7611
+ # a task when it runs, instead use the `Parameters` option in the
7612
+ # `TaskInvocationParameters` structure. For information about how
7613
+ # Systems Manager handles these options for the supported Maintenance
7614
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
7615
+ #
7616
+ # For Step Functions tasks, Systems Manager ignores any values specified
7617
+ # for `TaskParameters` and `LoggingInfo`.
7618
+ #
7619
+ # </note>
7462
7620
  #
7463
7621
  # @note When making an API call, you may pass MaintenanceWindowStepFunctionsParameters
7464
7622
  # data as a hash:
@@ -7564,6 +7722,14 @@ module Aws::SSM
7564
7722
  # @!attribute [rw] task_parameters
7565
7723
  # The parameters that should be passed to the task when it is
7566
7724
  # executed.
7725
+ #
7726
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass
7727
+ # to a task when it runs, instead use the `Parameters` option in the
7728
+ # `TaskInvocationParameters` structure. For information about how
7729
+ # Systems Manager handles these options for the supported Maintenance
7730
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
7731
+ #
7732
+ # </note>
7567
7733
  # @return [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>]
7568
7734
  #
7569
7735
  # @!attribute [rw] priority
@@ -7574,6 +7740,15 @@ module Aws::SSM
7574
7740
  #
7575
7741
  # @!attribute [rw] logging_info
7576
7742
  # Information about an Amazon S3 bucket to write task-level logs to.
7743
+ #
7744
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to
7745
+ # contain logs, instead use the `OutputS3BucketName` and
7746
+ # `OutputS3KeyPrefix` options in the `TaskInvocationParameters`
7747
+ # structure. For information about how Systems Manager handles these
7748
+ # options for the supported Maintenance Window task types, see
7749
+ # MaintenanceWindowTaskInvocationParameters.
7750
+ #
7751
+ # </note>
7577
7752
  # @return [Types::LoggingInfo]
7578
7753
  #
7579
7754
  # @!attribute [rw] service_role_arn
@@ -7661,7 +7836,7 @@ module Aws::SSM
7661
7836
  # @return [Types::MaintenanceWindowRunCommandParameters]
7662
7837
  #
7663
7838
  # @!attribute [rw] automation
7664
- # The parameters for a AUTOMATION task type.
7839
+ # The parameters for an AUTOMATION task type.
7665
7840
  # @return [Types::MaintenanceWindowAutomationParameters]
7666
7841
  #
7667
7842
  # @!attribute [rw] step_functions
@@ -8870,6 +9045,8 @@ module Aws::SSM
8870
9045
  #
8871
9046
  # @!attribute [rw] description
8872
9047
  # Information about the parameter that you want to add to the system.
9048
+ #
9049
+ # Do not enter personally identifiable information in this field.
8873
9050
  # @return [String]
8874
9051
  #
8875
9052
  # @!attribute [rw] value
@@ -9026,10 +9203,17 @@ module Aws::SSM
9026
9203
  # @return [String]
9027
9204
  #
9028
9205
  # @!attribute [rw] targets
9029
- # The targets (either instances or tags). Instances are specified
9030
- # using
9031
- # Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags
9032
- # are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.
9206
+ # The targets (either instances or tags).
9207
+ #
9208
+ # Specify instances using the following format:
9209
+ #
9210
+ # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
9211
+ #
9212
+ # Specify tags using either of the following formats:
9213
+ #
9214
+ # `Key=tag:<tag-key>,Values=<tag-value-1>,<tag-value-2>`
9215
+ #
9216
+ # `Key=tag-key,Values=<tag-key-1>,<tag-key-2>`
9033
9217
  # @return [Array<Types::Target>]
9034
9218
  #
9035
9219
  # @!attribute [rw] owner_information
@@ -9144,14 +9328,19 @@ module Aws::SSM
9144
9328
  # }
9145
9329
  #
9146
9330
  # @!attribute [rw] window_id
9147
- # The id of the Maintenance Window the task should be added to.
9331
+ # The ID of the Maintenance Window the task should be added to.
9148
9332
  # @return [String]
9149
9333
  #
9150
9334
  # @!attribute [rw] targets
9151
- # The targets (either instances or tags). Instances are specified
9152
- # using
9153
- # Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags
9154
- # are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.
9335
+ # The targets (either instances or Maintenance Window targets).
9336
+ #
9337
+ # Specify instances using the following format:
9338
+ #
9339
+ # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
9340
+ #
9341
+ # Specify Maintenance Window targets using the following format:
9342
+ #
9343
+ # `Key=<WindowTargetIds>,Values=<window-target-id-1>,<window-target-id-2>`
9155
9344
  # @return [Array<Types::Target>]
9156
9345
  #
9157
9346
  # @!attribute [rw] task_arn
@@ -9169,6 +9358,14 @@ module Aws::SSM
9169
9358
  # @!attribute [rw] task_parameters
9170
9359
  # The parameters that should be passed to the task when it is
9171
9360
  # executed.
9361
+ #
9362
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass
9363
+ # to a task when it runs, instead use the `Parameters` option in the
9364
+ # `TaskInvocationParameters` structure. For information about how
9365
+ # Systems Manager handles these options for the supported Maintenance
9366
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
9367
+ #
9368
+ # </note>
9172
9369
  # @return [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>]
9173
9370
  #
9174
9371
  # @!attribute [rw] task_invocation_parameters
@@ -9196,6 +9393,15 @@ module Aws::SSM
9196
9393
  # @!attribute [rw] logging_info
9197
9394
  # A structure containing information about an Amazon S3 bucket to
9198
9395
  # write instance-level logs to.
9396
+ #
9397
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to
9398
+ # contain logs, instead use the `OutputS3BucketName` and
9399
+ # `OutputS3KeyPrefix` options in the `TaskInvocationParameters`
9400
+ # structure. For information about how Systems Manager handles these
9401
+ # options for the supported Maintenance Window task types, see
9402
+ # MaintenanceWindowTaskInvocationParameters.
9403
+ #
9404
+ # </note>
9199
9405
  # @return [Types::LoggingInfo]
9200
9406
  #
9201
9407
  # @!attribute [rw] name
@@ -9255,10 +9461,33 @@ module Aws::SSM
9255
9461
  #
9256
9462
  # @!attribute [rw] resource_type
9257
9463
  # The type of resource of which you want to remove a tag.
9464
+ #
9465
+ # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
9466
+ # managed instances. You must specify the the name of the managed
9467
+ # instance in the following format: mi-ID\_number. For example,
9468
+ # mi-1a2b3c4d5e6f.
9469
+ #
9470
+ # </note>
9258
9471
  # @return [String]
9259
9472
  #
9260
9473
  # @!attribute [rw] resource_id
9261
- # The resource ID for which you want to remove tags.
9474
+ # The resource ID for which you want to remove tags. Use the ID of the
9475
+ # resource. Here are some examples:
9476
+ #
9477
+ # ManagedInstance: mi-012345abcde
9478
+ #
9479
+ # MaintenanceWindow: mw-012345abcde
9480
+ #
9481
+ # PatchBaseline: pb-012345abcde
9482
+ #
9483
+ # For the Document and Parameter values, use the name of the resource.
9484
+ #
9485
+ # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
9486
+ # managed instances. You must specify the the name of the managed
9487
+ # instance in the following format: mi-ID\_number. For example,
9488
+ # mi-1a2b3c4d5e6f.
9489
+ #
9490
+ # </note>
9262
9491
  # @return [String]
9263
9492
  #
9264
9493
  # @!attribute [rw] tag_keys
@@ -9632,7 +9861,7 @@ module Aws::SSM
9632
9861
  #
9633
9862
  # @!attribute [rw] timeout_seconds
9634
9863
  # If this time is reached and the command has not already started
9635
- # executing, it will not execute.
9864
+ # executing, it will not run.
9636
9865
  # @return [Integer]
9637
9866
  #
9638
9867
  # @!attribute [rw] comment
@@ -10660,7 +10889,17 @@ module Aws::SSM
10660
10889
  # @return [String]
10661
10890
  #
10662
10891
  # @!attribute [rw] task_parameters
10663
- # The parameters to modify. The map has the following format:
10892
+ # The parameters to modify.
10893
+ #
10894
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass
10895
+ # to a task when it runs, instead use the `Parameters` option in the
10896
+ # `TaskInvocationParameters` structure. For information about how
10897
+ # Systems Manager handles these options for the supported Maintenance
10898
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
10899
+ #
10900
+ # </note>
10901
+ #
10902
+ # The map has the following format:
10664
10903
  #
10665
10904
  # Key: string, between 1 and 255 characters
10666
10905
  #
@@ -10694,6 +10933,15 @@ module Aws::SSM
10694
10933
  #
10695
10934
  # @!attribute [rw] logging_info
10696
10935
  # The new logging location in Amazon S3 to specify.
10936
+ #
10937
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to
10938
+ # contain logs, instead use the `OutputS3BucketName` and
10939
+ # `OutputS3KeyPrefix` options in the `TaskInvocationParameters`
10940
+ # structure. For information about how Systems Manager handles these
10941
+ # options for the supported Maintenance Window task types, see
10942
+ # MaintenanceWindowTaskInvocationParameters.
10943
+ #
10944
+ # </note>
10697
10945
  # @return [Types::LoggingInfo]
10698
10946
  #
10699
10947
  # @!attribute [rw] name
@@ -10752,6 +11000,14 @@ module Aws::SSM
10752
11000
  #
10753
11001
  # @!attribute [rw] task_parameters
10754
11002
  # The updated parameter values.
11003
+ #
11004
+ # <note markdown="1"> `TaskParameters` has been deprecated. To specify parameters to pass
11005
+ # to a task when it runs, instead use the `Parameters` option in the
11006
+ # `TaskInvocationParameters` structure. For information about how
11007
+ # Systems Manager handles these options for the supported Maintenance
11008
+ # Window task types, see MaintenanceWindowTaskInvocationParameters.
11009
+ #
11010
+ # </note>
10755
11011
  # @return [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>]
10756
11012
  #
10757
11013
  # @!attribute [rw] task_invocation_parameters
@@ -10772,6 +11028,15 @@ module Aws::SSM
10772
11028
  #
10773
11029
  # @!attribute [rw] logging_info
10774
11030
  # The updated logging information in Amazon S3.
11031
+ #
11032
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to
11033
+ # contain logs, instead use the `OutputS3BucketName` and
11034
+ # `OutputS3KeyPrefix` options in the `TaskInvocationParameters`
11035
+ # structure. For information about how Systems Manager handles these
11036
+ # options for the supported Maintenance Window task types, see
11037
+ # MaintenanceWindowTaskInvocationParameters.
11038
+ #
11039
+ # </note>
10775
11040
  # @return [Types::LoggingInfo]
10776
11041
  #
10777
11042
  # @!attribute [rw] name
@@ -10893,6 +11158,14 @@ module Aws::SSM
10893
11158
  #
10894
11159
  # @!attribute [rw] approved_patches
10895
11160
  # A list of explicitly approved patches for the baseline.
11161
+ #
11162
+ # For information about accepted formats for lists of approved patches
11163
+ # and rejected patches, see [Package Name Formats for Approved and
11164
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
11165
+ #
11166
+ #
11167
+ #
11168
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
10896
11169
  # @return [Array<String>]
10897
11170
  #
10898
11171
  # @!attribute [rw] approved_patches_compliance_level
@@ -10908,6 +11181,14 @@ module Aws::SSM
10908
11181
  #
10909
11182
  # @!attribute [rw] rejected_patches
10910
11183
  # A list of explicitly rejected patches for the baseline.
11184
+ #
11185
+ # For information about accepted formats for lists of approved patches
11186
+ # and rejected patches, see [Package Name Formats for Approved and
11187
+ # Rejected Patch Lists][1] in the *AWS Systems Manager User Guide*.
11188
+ #
11189
+ #
11190
+ #
11191
+ # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
10911
11192
  # @return [Array<String>]
10912
11193
  #
10913
11194
  # @!attribute [rw] description
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-ssm
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.9.0
4
+ version: 1.10.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2018-03-29 00:00:00.000000000 Z
11
+ date: 2018-04-05 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core