aws-sdk-ssm 1.9.0 → 1.10.0

Sign up to get free protection for your applications and to get access to all the features.
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