aws-sdk-ssm 1.0.0.rc6 → 1.0.0.rc7

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: 9638d00e13b73bd64b7c6a732c15e732cc5d362a
4
- data.tar.gz: 1169451c5a7846592c18edac48eae4712ba87c2e
3
+ metadata.gz: 4f68ed61ccea615abc983b3d25d49a58bec0f211
4
+ data.tar.gz: 807f0c4d64878dc4cbd075f680fc45b3c03f9b9e
5
5
  SHA512:
6
- metadata.gz: e193df0736eb111c0235236a8a958f58892f11ad3baa44d096ed94d423d2e4cfe510df777f6e6a8ed6200d39be401d2985343a808e4e47dfb49808b8c25a4f1d
7
- data.tar.gz: 22d7557ea30b95c8057a3ae03983720bf1b07105bf01dca04f8e6cc198327cdef6c2a5917543a32060ac659561fa098f982e182162c2c74c8e9a37aa275cc1c5
6
+ metadata.gz: c1a336e9b366da3af64168004b819c9ce7fe94a6890e3437b22aff7ea597f9bbb6b745da4bd91a62661c858f80b7f49963feb57d2c0dbe1083212c18bf90b5cc
7
+ data.tar.gz: 0ece64aaabfde91e83f14f08966c7aaacae8c72e18af6e96b2d371836b29c0e645a5b82b9f8f4bfd6f134b292dfd73bcce6c50f5187685ec2f2735c59ba0eec5
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-ssm/customizations'
42
42
  # @service
43
43
  module Aws::SSM
44
44
 
45
- GEM_VERSION = '1.0.0.rc6'
45
+ GEM_VERSION = '1.0.0.rc7'
46
46
 
47
47
  end
@@ -156,15 +156,17 @@ module Aws::SSM
156
156
  # @!group API Operations
157
157
 
158
158
  # Adds or overwrites one or more tags for the specified resource. Tags
159
- # are metadata that you assign to your managed instances. Tags enable
160
- # you to categorize your managed instances in different ways, for
161
- # example, by purpose, owner, or environment. Each tag consists of a key
162
- # and an optional value, both of which you define. For example, you
163
- # could define a set of tags for your account's managed instances that
164
- # helps you track each instance's owner and stack level. For example:
165
- # Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and
166
- # Value=Production, Pre-Production, or Test. Each resource can have a
167
- # maximum of 10 tags.
159
+ # are metadata that you assign to your managed instances, Maintenance
160
+ # Windows, or Parameter Store parameters. Tags enable you to categorize
161
+ # your resources in different ways, for example, by purpose, owner, or
162
+ # environment. Each tag consists of a key and an optional value, both of
163
+ # which you define. For example, you could define a set of tags for your
164
+ # account's managed instances that helps you track each instance's
165
+ # owner and stack level. For example: Key=Owner and Value=DbAdmin,
166
+ # SysAdmin, or Dev. Or Key=Stack and Value=Production, Pre-Production,
167
+ # or Test.
168
+ #
169
+ # Each resource can have a maximum of 10 tags.
168
170
  #
169
171
  # We recommend that you devise a set of tag keys that meets your needs
170
172
  # for each resource type. Using a consistent set of tag keys makes it
@@ -257,7 +259,7 @@ module Aws::SSM
257
259
  # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html
258
260
  #
259
261
  # @option params [String] :description
260
- # A user-defined description of the resource that you want to register
262
+ # A userdefined description of the resource that you want to register
261
263
  # with Amazon EC2.
262
264
  #
263
265
  # @option params [String] :default_instance_name
@@ -331,26 +333,15 @@ module Aws::SSM
331
333
  # The parameters for the documents runtime configuration.
332
334
  #
333
335
  # @option params [Array<Types::Target>] :targets
334
- # The targets (either instances or tags) for the association. Instances
335
- # are specified using
336
- # Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags
337
- # are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.
336
+ # The targets (either instances or tags) for the association.
338
337
  #
339
338
  # @option params [String] :schedule_expression
340
339
  # A cron expression when the association will be applied to the
341
- # target(s). Supported expressions are every half, 1, 2, 4, 8 or 12
342
- # hour(s); every specified day and time of the week. For example: cron(0
343
- # 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0 0/4 1/1 *
344
- # ? *) to run every four hours; and cron(0 0 10 ? * SUN *) to run
345
- # every Sunday at 10 a.m.
340
+ # target(s).
346
341
  #
347
342
  # @option params [Types::InstanceAssociationOutputLocation] :output_location
348
343
  # An Amazon S3 bucket where you want to store the output details of the
349
- # request. For example:
350
- #
351
- # `"\{ "S3Location": \{ "OutputS3Region": "<region>",
352
- # "OutputS3BucketName": "bucket name", "OutputS3KeyPrefix":
353
- # "folder name" \} \}"`
344
+ # request.
354
345
  #
355
346
  # @return [Types::CreateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
356
347
  #
@@ -659,7 +650,7 @@ module Aws::SSM
659
650
  # A description of the patch baseline.
660
651
  #
661
652
  # @option params [String] :client_token
662
- # Caller-provided idempotency token.
653
+ # User-provided idempotency token.
663
654
  #
664
655
  # **A suitable default value is auto-generated.** You should normally
665
656
  # not need to pass this option.**
@@ -884,7 +875,7 @@ module Aws::SSM
884
875
 
885
876
  # Removes the server or virtual machine from the list of registered
886
877
  # servers. You can reregister the instance again at any time. If you
887
- # dont plan to use Run Command on the server, we suggest uninstalling
878
+ # don't plan to use Run Command on the server, we suggest uninstalling
888
879
  # the SSM Agent first.
889
880
  #
890
881
  # @option params [required, String] :instance_id
@@ -1301,8 +1292,8 @@ module Aws::SSM
1301
1292
 
1302
1293
  # Describes the permissions for a Systems Manager document. If you
1303
1294
  # created the document, you are the owner. If a document is shared, it
1304
- # can either be shared privately (by specifying a users AWS account ID)
1305
- # or publicly (*All*).
1295
+ # can either be shared privately (by specifying a user's AWS account
1296
+ # ID) or publicly (*All*).
1306
1297
  #
1307
1298
  # @option params [required, String] :name
1308
1299
  # The name of the document for which you are the owner.
@@ -1633,11 +1624,11 @@ module Aws::SSM
1633
1624
  # @option params [Array<Types::InstancePatchStateFilter>] :filters
1634
1625
  # Each entry in the array is a structure containing:
1635
1626
  #
1636
- # Key (string 1 length ≤ 200)
1627
+ # Key (string between 1 and 200 characters)
1637
1628
  #
1638
1629
  # Values (array containing a single string)
1639
1630
  #
1640
- # Type (string Equal”, NotEqual”, LessThan”, GreaterThan)
1631
+ # Type (string "Equal", "NotEqual", "LessThan", "GreaterThan")
1641
1632
  #
1642
1633
  # @option params [String] :next_token
1643
1634
  # The token for the next set of items to return. (You received this
@@ -1704,9 +1695,9 @@ module Aws::SSM
1704
1695
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
1705
1696
  # Each entry in the array is a structure containing:
1706
1697
  #
1707
- # Key (string, 1 length ≤ 128)
1698
+ # Key (string, between 1 and 128 characters)
1708
1699
  #
1709
- # Values (array of strings 1 length 256)
1700
+ # Values (array of strings, each string between 1 and 256 characters)
1710
1701
  #
1711
1702
  # @option params [String] :next_token
1712
1703
  # The token for the next set of items to return. (You received this
@@ -1896,12 +1887,12 @@ module Aws::SSM
1896
1887
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
1897
1888
  # Each entry in the array is a structure containing:
1898
1889
  #
1899
- # Key (string, 1 length ≤ 128)
1890
+ # Key (string, between 1 and 128 characters)
1900
1891
  #
1901
- # Values (array of strings 1 length 256)
1892
+ # Values (array of strings, each string is between 1 and 256 characters)
1902
1893
  #
1903
- # The supported Keys are `ExecutedBefore` and `ExecutedAfter` with the
1904
- # value being a date/time string such as 2016-11-04T05:00:00Z.
1894
+ # The supported Keys are ExecutedBefore and ExecutedAfter with the value
1895
+ # being a date/time string such as 2016-11-04T05:00:00Z.
1905
1896
  #
1906
1897
  # @option params [Integer] :max_results
1907
1898
  # The maximum number of items to return for this call. The call also
@@ -1958,8 +1949,8 @@ module Aws::SSM
1958
1949
  #
1959
1950
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
1960
1951
  # Optional filters that can be used to narrow down the scope of the
1961
- # returned window targets. The supported filter keys are `Type`,
1962
- # `WindowTargetId` and `OwnerInformation`.
1952
+ # returned window targets. The supported filter keys are Type,
1953
+ # WindowTargetId and OwnerInformation.
1963
1954
  #
1964
1955
  # @option params [Integer] :max_results
1965
1956
  # The maximum number of items to return for this call. The call also
@@ -2018,8 +2009,8 @@ module Aws::SSM
2018
2009
  #
2019
2010
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
2020
2011
  # Optional filters used to narrow down the scope of the returned tasks.
2021
- # The supported filter keys are `WindowTaskId`, `TaskArn`, `Priority`,
2022
- # and `TaskType`.
2012
+ # The supported filter keys are WindowTaskId, TaskArn, Priority, and
2013
+ # TaskType.
2023
2014
  #
2024
2015
  # @option params [Integer] :max_results
2025
2016
  # The maximum number of items to return for this call. The call also
@@ -2085,7 +2076,7 @@ module Aws::SSM
2085
2076
  #
2086
2077
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
2087
2078
  # Optional filters used to narrow down the scope of the returned
2088
- # Maintenance Windows. Supported filter keys are `Name` and `Enabled`.
2079
+ # Maintenance Windows. Supported filter keys are Name and Enabled.
2089
2080
  #
2090
2081
  # @option params [Integer] :max_results
2091
2082
  # The maximum number of items to return for this call. The call also
@@ -2191,9 +2182,10 @@ module Aws::SSM
2191
2182
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
2192
2183
  # Each element in the array is a structure containing:
2193
2184
  #
2194
- # Key: (string, NAME\_PREFIX or OWNER)
2185
+ # Key: (string, "NAME\_PREFIX" or "OWNER")
2195
2186
  #
2196
- # Value: (array of strings, exactly 1 entry, 1 length ≤ 255)
2187
+ # Value: (array of strings, exactly 1 entry, between 1 and 255
2188
+ # characters)
2197
2189
  #
2198
2190
  # @option params [Integer] :max_results
2199
2191
  # The maximum number of patch baselines to return (per page).
@@ -2321,7 +2313,7 @@ module Aws::SSM
2321
2313
  #
2322
2314
  # @option params [required, String] :automation_execution_id
2323
2315
  # The unique identifier for an existing automation execution to examine.
2324
- # The execution ID is returned by `StartAutomationExecution` when the
2316
+ # The execution ID is returned by StartAutomationExecution when the
2325
2317
  # execution of an Automation document is initiated.
2326
2318
  #
2327
2319
  # @return [Types::GetAutomationExecutionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2356,6 +2348,11 @@ module Aws::SSM
2356
2348
  # resp.automation_execution.step_executions[0].outputs["AutomationParameterKey"][0] #=> String
2357
2349
  # resp.automation_execution.step_executions[0].response #=> String
2358
2350
  # resp.automation_execution.step_executions[0].failure_message #=> String
2351
+ # resp.automation_execution.step_executions[0].failure_details.failure_stage #=> String
2352
+ # resp.automation_execution.step_executions[0].failure_details.failure_type #=> String
2353
+ # resp.automation_execution.step_executions[0].failure_details.details #=> Hash
2354
+ # resp.automation_execution.step_executions[0].failure_details.details["AutomationParameterKey"] #=> Array
2355
+ # resp.automation_execution.step_executions[0].failure_details.details["AutomationParameterKey"][0] #=> String
2359
2356
  # resp.automation_execution.parameters #=> Hash
2360
2357
  # resp.automation_execution.parameters["AutomationParameterKey"] #=> Array
2361
2358
  # resp.automation_execution.parameters["AutomationParameterKey"][0] #=> String
@@ -3786,14 +3783,16 @@ module Aws::SSM
3786
3783
  # Executes commands on one or more remote instances.
3787
3784
  #
3788
3785
  # @option params [Array<String>] :instance_ids
3789
- # Required. The instance IDs where the command should execute. You can
3790
- # specify a maximum of 50 IDs.
3786
+ # The instance IDs where the command should execute. You can specify a
3787
+ # maximum of 50 IDs. If you prefer not to list individual instance IDs,
3788
+ # you can instead send commands to a fleet of instances using the
3789
+ # Targets parameter, which accepts EC2 tags.
3791
3790
  #
3792
3791
  # @option params [Array<Types::Target>] :targets
3793
3792
  # (Optional) An array of search criteria that targets instances using a
3794
- # `Key`,`Value` combination that you specify. `Targets` is required if
3795
- # you don't provide one or more instance IDs in the call. For more
3796
- # information about how to use `Targets`, see [Executing a Command Using
3793
+ # Key,Value combination that you specify. Targets is required if you
3794
+ # don't provide one or more instance IDs in the call. For more
3795
+ # information about how to use Targets, see [Executing a Command Using
3797
3796
  # Systems Manager Run Command][1].
3798
3797
  #
3799
3798
  #
@@ -3846,10 +3845,10 @@ module Aws::SSM
3846
3845
  #
3847
3846
  # @option params [String] :max_concurrency
3848
3847
  # (Optional) The maximum number of instances that are allowed to execute
3849
- # the command at the same time. You can specify a number such as 10 or
3850
- # a percentage such as 10%”. The default value is 50. For more
3851
- # information about how to use `MaxConcurrency`, see [Executing a
3852
- # Command Using Systems Manager Run Command][1].
3848
+ # the command at the same time. You can specify a number such as 10 or a
3849
+ # percentage such as 10%. The default value is 50. For more information
3850
+ # about how to use MaxConcurrency, see [Executing a Command Using
3851
+ # Systems Manager Run Command][1].
3853
3852
  #
3854
3853
  #
3855
3854
  #
@@ -3857,11 +3856,11 @@ module Aws::SSM
3857
3856
  #
3858
3857
  # @option params [String] :max_errors
3859
3858
  # The maximum number of errors allowed without the command failing. When
3860
- # the command fails one more time beyond the value of `MaxErrors`, the
3859
+ # the command fails one more time beyond the value of MaxErrors, the
3861
3860
  # systems stops sending the command to additional targets. You can
3862
- # specify a number like 10 or a percentage like 10%”. The default
3863
- # value is 50. For more information about how to use `MaxErrors`, see
3864
- # [Executing a Command Using Systems Manager Run Command][1].
3861
+ # specify a number like 10 or a percentage like 10%. The default value
3862
+ # is 50. For more information about how to use MaxErrors, see [Executing
3863
+ # a Command Using Systems Manager Run Command][1].
3865
3864
  #
3866
3865
  #
3867
3866
  #
@@ -4026,19 +4025,17 @@ module Aws::SSM
4026
4025
  #
4027
4026
  # @option params [String] :schedule_expression
4028
4027
  # The cron expression used to schedule the association that you want to
4029
- # update. Supported expressions are every half, 1, 2, 4, 8 or 12
4030
- # hour(s); every specified day and time of the week. For example: cron(0
4031
- # 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0 0/4 1/1 *
4032
- # ? *) to run every four hours; and cron(0 0 10 ? * SUN *) to run
4033
- # every Sunday at 10 a.m.
4028
+ # update.
4034
4029
  #
4035
4030
  # @option params [Types::InstanceAssociationOutputLocation] :output_location
4036
4031
  # An Amazon S3 bucket where you want to store the results of this
4037
4032
  # request.
4038
4033
  #
4039
- # `"\{ "S3Location": \{ "OutputS3Region": "<region>",
4040
- # "OutputS3BucketName": "bucket name", "OutputS3KeyPrefix":
4041
- # "folder name" \} \}"`
4034
+ # @option params [String] :name
4035
+ # The name of the association document.
4036
+ #
4037
+ # @option params [Array<Types::Target>] :targets
4038
+ # The targets of the association.
4042
4039
  #
4043
4040
  # @return [Types::UpdateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4044
4041
  #
@@ -4060,6 +4057,13 @@ module Aws::SSM
4060
4057
  # output_s3_key_prefix: "S3KeyPrefix",
4061
4058
  # },
4062
4059
  # },
4060
+ # name: "DocumentName",
4061
+ # targets: [
4062
+ # {
4063
+ # key: "TargetKey",
4064
+ # values: ["TargetValue"],
4065
+ # },
4066
+ # ],
4063
4067
  # })
4064
4068
  #
4065
4069
  # @example Response structure
@@ -4467,7 +4471,7 @@ module Aws::SSM
4467
4471
  params: params,
4468
4472
  config: config)
4469
4473
  context[:gem_name] = 'aws-sdk-ssm'
4470
- context[:gem_version] = '1.0.0.rc6'
4474
+ context[:gem_version] = '1.0.0.rc7'
4471
4475
  Seahorse::Client::Request.new(handlers, context)
4472
4476
  end
4473
4477
 
@@ -221,6 +221,7 @@ module Aws::SSM
221
221
  ExpirationDate = Shapes::TimestampShape.new(name: 'ExpirationDate')
222
222
  FailedCreateAssociation = Shapes::StructureShape.new(name: 'FailedCreateAssociation')
223
223
  FailedCreateAssociationList = Shapes::ListShape.new(name: 'FailedCreateAssociationList')
224
+ FailureDetails = Shapes::StructureShape.new(name: 'FailureDetails')
224
225
  Fault = Shapes::StringShape.new(name: 'Fault')
225
226
  GetAutomationExecutionRequest = Shapes::StructureShape.new(name: 'GetAutomationExecutionRequest')
226
227
  GetAutomationExecutionResult = Shapes::StructureShape.new(name: 'GetAutomationExecutionResult')
@@ -1191,6 +1192,11 @@ module Aws::SSM
1191
1192
 
1192
1193
  FailedCreateAssociationList.member = Shapes::ShapeRef.new(shape: FailedCreateAssociation, location_name: "FailedCreateAssociationEntry")
1193
1194
 
1195
+ FailureDetails.add_member(:failure_stage, Shapes::ShapeRef.new(shape: String, location_name: "FailureStage"))
1196
+ FailureDetails.add_member(:failure_type, Shapes::ShapeRef.new(shape: String, location_name: "FailureType"))
1197
+ FailureDetails.add_member(:details, Shapes::ShapeRef.new(shape: AutomationParameterMap, location_name: "Details"))
1198
+ FailureDetails.struct_class = Types::FailureDetails
1199
+
1194
1200
  GetAutomationExecutionRequest.add_member(:automation_execution_id, Shapes::ShapeRef.new(shape: AutomationExecutionId, required: true, location_name: "AutomationExecutionId"))
1195
1201
  GetAutomationExecutionRequest.struct_class = Types::GetAutomationExecutionRequest
1196
1202
 
@@ -1922,6 +1928,7 @@ module Aws::SSM
1922
1928
  StepExecution.add_member(:outputs, Shapes::ShapeRef.new(shape: AutomationParameterMap, location_name: "Outputs"))
1923
1929
  StepExecution.add_member(:response, Shapes::ShapeRef.new(shape: String, location_name: "Response"))
1924
1930
  StepExecution.add_member(:failure_message, Shapes::ShapeRef.new(shape: String, location_name: "FailureMessage"))
1931
+ StepExecution.add_member(:failure_details, Shapes::ShapeRef.new(shape: FailureDetails, location_name: "FailureDetails"))
1925
1932
  StepExecution.struct_class = Types::StepExecution
1926
1933
 
1927
1934
  StepExecutionList.member = Shapes::ShapeRef.new(shape: StepExecution)
@@ -1952,6 +1959,8 @@ module Aws::SSM
1952
1959
  UpdateAssociationRequest.add_member(:document_version, Shapes::ShapeRef.new(shape: DocumentVersion, location_name: "DocumentVersion"))
1953
1960
  UpdateAssociationRequest.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, location_name: "ScheduleExpression"))
1954
1961
  UpdateAssociationRequest.add_member(:output_location, Shapes::ShapeRef.new(shape: InstanceAssociationOutputLocation, location_name: "OutputLocation"))
1962
+ UpdateAssociationRequest.add_member(:name, Shapes::ShapeRef.new(shape: DocumentName, location_name: "Name"))
1963
+ UpdateAssociationRequest.add_member(:targets, Shapes::ShapeRef.new(shape: Targets, location_name: "Targets"))
1955
1964
  UpdateAssociationRequest.struct_class = Types::UpdateAssociationRequest
1956
1965
 
1957
1966
  UpdateAssociationResult.add_member(:association_description, Shapes::ShapeRef.new(shape: AssociationDescription, location_name: "AssociationDescription"))
@@ -2913,6 +2922,8 @@ module Aws::SSM
2913
2922
  o.errors << Shapes::ShapeRef.new(shape: AssociationDoesNotExist)
2914
2923
  o.errors << Shapes::ShapeRef.new(shape: InvalidUpdate)
2915
2924
  o.errors << Shapes::ShapeRef.new(shape: TooManyUpdates)
2925
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDocument)
2926
+ o.errors << Shapes::ShapeRef.new(shape: InvalidTarget)
2916
2927
  end)
2917
2928
 
2918
2929
  api.add_operation(:update_association_status, Seahorse::Model::Operation.new.tap do |o|
@@ -270,8 +270,8 @@ module Aws::SSM
270
270
  # Information about the association.
271
271
  #
272
272
  # @!attribute [rw] status
273
- # The status of the association. Status can be: `Pending`, `Success`,
274
- # or `Failed`.
273
+ # The status of the association. Status can be: Pending, Success, or
274
+ # Failed.
275
275
  # @return [String]
276
276
  #
277
277
  # @!attribute [rw] detailed_status
@@ -367,7 +367,7 @@ module Aws::SSM
367
367
  #
368
368
  # @!attribute [rw] parameters
369
369
  # The key-value map of execution parameters, which were supplied when
370
- # calling `StartAutomationExecution`.
370
+ # calling StartAutomationExecution.
371
371
  # @return [Hash<String,Array<String>>]
372
372
  #
373
373
  # @!attribute [rw] outputs
@@ -543,9 +543,9 @@ module Aws::SSM
543
543
  # @return [Array<String>]
544
544
  #
545
545
  # @!attribute [rw] targets
546
- # An array of search criteria that targets instances using a
547
- # `Key`,`Value` combination that you specify. `Targets` is required if
548
- # you don't provide one or more instance IDs in the call.
546
+ # An array of search criteria that targets instances using a Key,Value
547
+ # combination that you specify. Targets is required if you don't
548
+ # provide one or more instance IDs in the call.
549
549
  # @return [Array<Types::Target>]
550
550
  #
551
551
  # @!attribute [rw] requested_date_time
@@ -557,41 +557,41 @@ module Aws::SSM
557
557
  # @return [String]
558
558
  #
559
559
  # @!attribute [rw] status_details
560
- # A detailed status of the command execution. `StatusDetails` includes
561
- # more information than `Status` because it includes states resulting
562
- # from error and concurrency control parameters. `StatusDetails` can
563
- # show different results than `Status`. For more information about
564
- # these statuses, see [Run Command Status][1]. `StatusDetails` can be
565
- # one of the following values:
560
+ # A detailed status of the command execution. StatusDetails includes
561
+ # more information than Status because it includes states resulting
562
+ # from error and concurrency control parameters. StatusDetails can
563
+ # show different results than Status. For more information about these
564
+ # statuses, see [Run Command Status][1]. StatusDetails can be one of
565
+ # the following values:
566
566
  #
567
- # * Pending The command has not been sent to any instances.
567
+ # * Pending: The command has not been sent to any instances.
568
568
  #
569
- # * In Progress The command has been sent to at least one instance
569
+ # * In Progress: The command has been sent to at least one instance
570
570
  # but has not reached a final state on all instances.
571
571
  #
572
- # * Success The command successfully executed on all invocations.
572
+ # * Success: The command successfully executed on all invocations.
573
573
  # This is a terminal state.
574
574
  #
575
- # * Delivery Timed Out The value of `MaxErrors` or more command
576
- # invocations shows a status of `Delivery Timed Out`. This is a
575
+ # * Delivery Timed Out: The value of MaxErrors or more command
576
+ # invocations shows a status of Delivery Timed Out. This is a
577
577
  # terminal state.
578
578
  #
579
- # * Execution Timed Out The value of `MaxErrors` or more command
580
- # invocations shows a status of `Execution Timed Out`. This is a
579
+ # * Execution Timed Out: The value of MaxErrors or more command
580
+ # invocations shows a status of Execution Timed Out. This is a
581
581
  # terminal state.
582
582
  #
583
- # * Failed The value of `MaxErrors` or more command invocations
584
- # shows a status of `Failed`. This is a terminal state.
583
+ # * Failed: The value of MaxErrors or more command invocations shows a
584
+ # status of Failed. This is a terminal state.
585
585
  #
586
- # * Incomplete The command was attempted on all instances and one or
587
- # more invocations does not have a value of `Success` but not enough
588
- # invocations failed for the status to be `Failed`. This is a
589
- # terminal state.
586
+ # * Incomplete: The command was attempted on all instances and one or
587
+ # more invocations does not have a value of Success but not enough
588
+ # invocations failed for the status to be Failed. This is a terminal
589
+ # state.
590
590
  #
591
- # * Canceled The command was terminated before it was completed.
592
- # This is a terminal state.
591
+ # * Canceled: The command was terminated before it was completed. This
592
+ # is a terminal state.
593
593
  #
594
- # * Rate Exceeded The number of instances targeted by the command
594
+ # * Rate Exceeded: The number of instances targeted by the command
595
595
  # exceeded the account limit for pending invocations. The system has
596
596
  # canceled the command before executing it on any instance. This is
597
597
  # a terminal state.
@@ -622,7 +622,7 @@ module Aws::SSM
622
622
  # The maximum number of instances that are allowed to execute the
623
623
  # command at the same time. You can specify a number of instances,
624
624
  # such as 10, or a percentage of instances, such as 10%. The default
625
- # value is 50. For more information about how to use `MaxConcurrency`,
625
+ # value is 50. For more information about how to use MaxConcurrency,
626
626
  # see [Executing a Command Using Systems Manager Run Command][1].
627
627
  #
628
628
  #
@@ -635,7 +635,7 @@ module Aws::SSM
635
635
  # the command to additional targets. You can specify a number of
636
636
  # errors, such as 10, or a percentage or errors, such as 10%. The
637
637
  # default value is 50. For more information about how to use
638
- # `MaxErrors`, see [Executing a Command Using Systems Manager Run
638
+ # MaxErrors, see [Executing a Command Using Systems Manager Run
639
639
  # Command][1].
640
640
  #
641
641
  #
@@ -649,14 +649,14 @@ module Aws::SSM
649
649
  #
650
650
  # @!attribute [rw] completed_count
651
651
  # The number of targets for which the command invocation reached a
652
- # terminal state. Terminal states include the following: `Success`,
653
- # `Failed`, `Execution Timed Out`, `Delivery Timed Out`, `Canceled`,
654
- # `Terminated`, or `Undeliverable`.
652
+ # terminal state. Terminal states include the following: Success,
653
+ # Failed, Execution Timed Out, Delivery Timed Out, Canceled,
654
+ # Terminated, or Undeliverable.
655
655
  # @return [Integer]
656
656
  #
657
657
  # @!attribute [rw] error_count
658
- # The number of targets for which the status is `Failed` or `Execution
659
- # Timed Out`.
658
+ # The number of targets for which the status is Failed or Execution
659
+ # Timed Out.
660
660
  # @return [Integer]
661
661
  #
662
662
  # @!attribute [rw] service_role
@@ -738,7 +738,7 @@ module Aws::SSM
738
738
  #
739
739
  # @!attribute [rw] instance_name
740
740
  # The name of the invocation target. For Amazon EC2 instances this is
741
- # the value for the `aws:Name` tag. For on-premises instances, this is
741
+ # the value for the aws:Name tag. For on-premises instances, this is
742
742
  # the name of the instance.
743
743
  # @return [String]
744
744
  #
@@ -761,49 +761,49 @@ module Aws::SSM
761
761
  #
762
762
  # @!attribute [rw] status_details
763
763
  # A detailed status of the command execution for each invocation (each
764
- # instance targeted by the command). `StatusDetails` includes more
765
- # information than `Status` because it includes states resulting from
766
- # error and concurrency control parameters. `StatusDetails` can show
767
- # different results than `Status`. For more information about these
768
- # statuses, see [Run Command Status][1]. `StatusDetails` can be one of
764
+ # instance targeted by the command). StatusDetails includes more
765
+ # information than Status because it includes states resulting from
766
+ # error and concurrency control parameters. StatusDetails can show
767
+ # different results than Status. For more information about these
768
+ # statuses, see [Run Command Status][1]. StatusDetails can be one of
769
769
  # the following values:
770
770
  #
771
- # * Pending The command has not been sent to the instance.
771
+ # * Pending: The command has not been sent to the instance.
772
772
  #
773
- # * In Progress The command has been sent to the instance but has
774
- # not reached a terminal state.
773
+ # * In Progress: The command has been sent to the instance but has not
774
+ # reached a terminal state.
775
775
  #
776
- # * Success The execution of the command or plugin was successfully
776
+ # * Success: The execution of the command or plugin was successfully
777
777
  # completed. This is a terminal state.
778
778
  #
779
- # * Delivery Timed Out The command was not delivered to the instance
779
+ # * Delivery Timed Out: The command was not delivered to the instance
780
780
  # before the delivery timeout expired. Delivery timeouts do not
781
- # count against the parent commands `MaxErrors` limit, but they do
782
- # contribute to whether the parent command status is `Success` or
783
- # `Incomplete`. This is a terminal state.
781
+ # count against the parent command's MaxErrors limit, but they do
782
+ # contribute to whether the parent command status is Success or
783
+ # Incomplete. This is a terminal state.
784
784
  #
785
- # * Execution Timed Out Command execution started on the instance,
785
+ # * Execution Timed Out: Command execution started on the instance,
786
786
  # but the execution was not complete before the execution timeout
787
- # expired. Execution timeouts count against the `MaxErrors` limit of
787
+ # expired. Execution timeouts count against the MaxErrors limit of
788
788
  # the parent command. This is a terminal state.
789
789
  #
790
- # * Failed The command was not successful on the instance. For a
790
+ # * Failed: The command was not successful on the instance. For a
791
791
  # plugin, this indicates that the result code was not zero. For a
792
792
  # command invocation, this indicates that the result code for one or
793
793
  # more plugins was not zero. Invocation failures count against the
794
- # `MaxErrors` limit of the parent command. This is a terminal state.
794
+ # MaxErrors limit of the parent command. This is a terminal state.
795
795
  #
796
- # * Canceled The command was terminated before it was completed.
797
- # This is a terminal state.
796
+ # * Canceled: The command was terminated before it was completed. This
797
+ # is a terminal state.
798
798
  #
799
- # * Undeliverable The command can't be delivered to the instance.
799
+ # * Undeliverable: The command can't be delivered to the instance.
800
800
  # The instance might not exist or might not be responding.
801
801
  # Undeliverable invocations don't count against the parent
802
- # commands `MaxErrors` limit and don't contribute to whether the
803
- # parent command status is `Success` or `Incomplete`. This is a
804
- # terminal state.
802
+ # command's MaxErrors limit and don't contribute to whether the
803
+ # parent command status is Success or Incomplete. This is a terminal
804
+ # state.
805
805
  #
806
- # * Terminated The parent command exceeded its `MaxErrors` limit and
806
+ # * Terminated: The parent command exceeded its MaxErrors limit and
807
807
  # subsequent command invocations were canceled by the system. This
808
808
  # is a terminal state.
809
809
  #
@@ -817,17 +817,17 @@ module Aws::SSM
817
817
  # @return [String]
818
818
  #
819
819
  # @!attribute [rw] standard_output_url
820
- # The URL to the plugins StdOut file in Amazon S3, if the Amazon S3
820
+ # The URL to the plugin's StdOut file in Amazon S3, if the Amazon S3
821
821
  # bucket was defined for the parent command. For an invocation,
822
- # `StandardOutputUrl` is populated if there is just one plugin defined
822
+ # StandardOutputUrl is populated if there is just one plugin defined
823
823
  # for the command, and the Amazon S3 bucket was defined for the
824
824
  # command.
825
825
  # @return [String]
826
826
  #
827
827
  # @!attribute [rw] standard_error_url
828
- # The URL to the plugins StdErr file in Amazon S3, if the Amazon S3
828
+ # The URL to the plugin's StdErr file in Amazon S3, if the Amazon S3
829
829
  # bucket was defined for the parent command. For an invocation,
830
- # `StandardErrorUrl` is populated if there is just one plugin defined
830
+ # StandardErrorUrl is populated if there is just one plugin defined
831
831
  # for the command, and the Amazon S3 bucket was defined for the
832
832
  # command.
833
833
  # @return [String]
@@ -881,49 +881,49 @@ module Aws::SSM
881
881
  # @return [String]
882
882
  #
883
883
  # @!attribute [rw] status_details
884
- # A detailed status of the plugin execution. `StatusDetails` includes
885
- # more information than `Status` because it includes states resulting
886
- # from error and concurrency control parameters. `StatusDetails` can
887
- # show different results than `Status`. For more information about
888
- # these statuses, see [Run Command Status][1]. `StatusDetails` can be
889
- # one of the following values:
884
+ # A detailed status of the plugin execution. StatusDetails includes
885
+ # more information than Status because it includes states resulting
886
+ # from error and concurrency control parameters. StatusDetails can
887
+ # show different results than Status. For more information about these
888
+ # statuses, see [Run Command Status][1]. StatusDetails can be one of
889
+ # the following values:
890
890
  #
891
- # * Pending The command has not been sent to the instance.
891
+ # * Pending: The command has not been sent to the instance.
892
892
  #
893
- # * In Progress The command has been sent to the instance but has
894
- # not reached a terminal state.
893
+ # * In Progress: The command has been sent to the instance but has not
894
+ # reached a terminal state.
895
895
  #
896
- # * Success The execution of the command or plugin was successfully
896
+ # * Success: The execution of the command or plugin was successfully
897
897
  # completed. This is a terminal state.
898
898
  #
899
- # * Delivery Timed Out The command was not delivered to the instance
899
+ # * Delivery Timed Out: The command was not delivered to the instance
900
900
  # before the delivery timeout expired. Delivery timeouts do not
901
- # count against the parent commands `MaxErrors` limit, but they do
902
- # contribute to whether the parent command status is `Success` or
903
- # `Incomplete`. This is a terminal state.
901
+ # count against the parent command's MaxErrors limit, but they do
902
+ # contribute to whether the parent command status is Success or
903
+ # Incomplete. This is a terminal state.
904
904
  #
905
- # * Execution Timed Out Command execution started on the instance,
905
+ # * Execution Timed Out: Command execution started on the instance,
906
906
  # but the execution was not complete before the execution timeout
907
- # expired. Execution timeouts count against the `MaxErrors` limit of
907
+ # expired. Execution timeouts count against the MaxErrors limit of
908
908
  # the parent command. This is a terminal state.
909
909
  #
910
- # * Failed The command was not successful on the instance. For a
910
+ # * Failed: The command was not successful on the instance. For a
911
911
  # plugin, this indicates that the result code was not zero. For a
912
912
  # command invocation, this indicates that the result code for one or
913
913
  # more plugins was not zero. Invocation failures count against the
914
- # `MaxErrors` limit of the parent command. This is a terminal state.
914
+ # MaxErrors limit of the parent command. This is a terminal state.
915
915
  #
916
- # * Canceled The command was terminated before it was completed.
917
- # This is a terminal state.
916
+ # * Canceled: The command was terminated before it was completed. This
917
+ # is a terminal state.
918
918
  #
919
- # * Undeliverable The command can't be delivered to the instance.
919
+ # * Undeliverable: The command can't be delivered to the instance.
920
920
  # The instance might not exist, or it might not be responding.
921
921
  # Undeliverable invocations don't count against the parent
922
- # commands `MaxErrors` limit, and they don't contribute to whether
923
- # the parent command status is `Success` or `Incomplete`. This is a
922
+ # command's MaxErrors limit, and they don't contribute to whether
923
+ # the parent command status is Success or Incomplete. This is a
924
924
  # terminal state.
925
925
  #
926
- # * Terminated The parent command exceeded its `MaxErrors` limit and
926
+ # * Terminated: The parent command exceeded its MaxErrors limit and
927
927
  # subsequent command invocations were canceled by the system. This
928
928
  # is a terminal state.
929
929
  #
@@ -969,16 +969,16 @@ module Aws::SSM
969
969
  # be stored. This was requested when issuing the command. For example,
970
970
  # in the following response:
971
971
  #
972
- # `test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript`
972
+ # test\_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript
973
973
  #
974
- # `test_folder` is the name of the Amazon S3 bucket;
974
+ # test\_folder is the name of the Amazon S3 bucket;
975
975
  #
976
- # `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
976
+ # ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3
977
977
  # prefix;
978
978
  #
979
- # `i-1234567876543` is the instance ID;
979
+ # i-1234567876543 is the instance ID;
980
980
  #
981
- # `awsrunShellScript` is the name of the plugin.
981
+ # awsrunShellScript is the name of the plugin.
982
982
  # @return [String]
983
983
  #
984
984
  # @!attribute [rw] output_s3_key_prefix
@@ -986,16 +986,16 @@ module Aws::SSM
986
986
  # command executions should be stored. This was requested when issuing
987
987
  # the command. For example, in the following response:
988
988
  #
989
- # `test_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript`
989
+ # test\_folder/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-1234567876543/awsrunShellScript
990
990
  #
991
- # `test_folder` is the name of the Amazon S3 bucket;
991
+ # test\_folder is the name of the Amazon S3 bucket;
992
992
  #
993
- # `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
993
+ # ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix is the name of the S3
994
994
  # prefix;
995
995
  #
996
- # `i-1234567876543` is the instance ID;
996
+ # i-1234567876543 is the instance ID;
997
997
  #
998
- # `awsrunShellScript` is the name of the plugin.
998
+ # awsrunShellScript is the name of the plugin.
999
999
  # @return [String]
1000
1000
  #
1001
1001
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CommandPlugin AWS API Documentation
@@ -1028,7 +1028,7 @@ module Aws::SSM
1028
1028
  # }
1029
1029
  #
1030
1030
  # @!attribute [rw] description
1031
- # A user-defined description of the resource that you want to register
1031
+ # A userdefined description of the resource that you want to register
1032
1032
  # with Amazon EC2.
1033
1033
  # @return [String]
1034
1034
  #
@@ -1257,27 +1257,16 @@ module Aws::SSM
1257
1257
  #
1258
1258
  # @!attribute [rw] targets
1259
1259
  # The targets (either instances or tags) for the association.
1260
- # Instances are specified using
1261
- # Key=instanceids,Values=&lt;instanceid1&gt;,&lt;instanceid2&gt;. Tags
1262
- # are specified using Key=&lt;tag name&gt;,Values=&lt;tag value&gt;.
1263
1260
  # @return [Array<Types::Target>]
1264
1261
  #
1265
1262
  # @!attribute [rw] schedule_expression
1266
1263
  # A cron expression when the association will be applied to the
1267
- # target(s). Supported expressions are every half, 1, 2, 4, 8 or 12
1268
- # hour(s); every specified day and time of the week. For example:
1269
- # cron(0 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0
1270
- # 0/4 1/1 * ? *) to run every four hours; and cron(0 0 10 ? * SUN
1271
- # *) to run every Sunday at 10 a.m.
1264
+ # target(s).
1272
1265
  # @return [String]
1273
1266
  #
1274
1267
  # @!attribute [rw] output_location
1275
1268
  # An Amazon S3 bucket where you want to store the output details of
1276
- # the request. For example:
1277
- #
1278
- # `"\{ "S3Location": \{ "OutputS3Region": "<region>",
1279
- # "OutputS3BucketName": "bucket name", "OutputS3KeyPrefix":
1280
- # "folder name" \} \}"`
1269
+ # the request.
1281
1270
  # @return [Types::InstanceAssociationOutputLocation]
1282
1271
  #
1283
1272
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateAssociationRequest AWS API Documentation
@@ -1470,7 +1459,7 @@ module Aws::SSM
1470
1459
  # @return [String]
1471
1460
  #
1472
1461
  # @!attribute [rw] client_token
1473
- # Caller-provided idempotency token.
1462
+ # User-provided idempotency token.
1474
1463
  #
1475
1464
  # **A suitable default value is auto-generated.** You should normally
1476
1465
  # not need to pass this option.
@@ -2346,11 +2335,11 @@ module Aws::SSM
2346
2335
  # @!attribute [rw] filters
2347
2336
  # Each entry in the array is a structure containing:
2348
2337
  #
2349
- # Key (string 1 length ≤ 200)
2338
+ # Key (string between 1 and 200 characters)
2350
2339
  #
2351
2340
  # Values (array containing a single string)
2352
2341
  #
2353
- # Type (string Equal”, NotEqual”, LessThan”, GreaterThan)
2342
+ # Type (string "Equal", "NotEqual", "LessThan", "GreaterThan")
2354
2343
  # @return [Array<Types::InstancePatchStateFilter>]
2355
2344
  #
2356
2345
  # @!attribute [rw] next_token
@@ -2461,9 +2450,9 @@ module Aws::SSM
2461
2450
  # @!attribute [rw] filters
2462
2451
  # Each entry in the array is a structure containing:
2463
2452
  #
2464
- # Key (string, 1 length ≤ 128)
2453
+ # Key (string, between 1 and 128 characters)
2465
2454
  #
2466
- # Values (array of strings 1 length 256)
2455
+ # Values (array of strings, each string between 1 and 256 characters)
2467
2456
  # @return [Array<Types::PatchOrchestratorFilter>]
2468
2457
  #
2469
2458
  # @!attribute [rw] next_token
@@ -2496,8 +2485,8 @@ module Aws::SSM
2496
2485
  #
2497
2486
  # Severity (string)
2498
2487
  #
2499
- # State (string – “INSTALLED”, INSTALLED\_OTHER”, MISSING”,
2500
- # NOT\_APPLICABLE”, FAILED)
2488
+ # State (string: "INSTALLED", "INSTALLED OTHER", "MISSING",
2489
+ # "NOT APPLICABLE", "FAILED")
2501
2490
  #
2502
2491
  # InstalledTime (DateTime)
2503
2492
  #
@@ -2676,11 +2665,12 @@ module Aws::SSM
2676
2665
  # @!attribute [rw] filters
2677
2666
  # Each entry in the array is a structure containing:
2678
2667
  #
2679
- # Key (string, 1 length ≤ 128)
2668
+ # Key (string, between 1 and 128 characters)
2680
2669
  #
2681
- # Values (array of strings 1 length 256)
2670
+ # Values (array of strings, each string is between 1 and 256
2671
+ # characters)
2682
2672
  #
2683
- # The supported Keys are `ExecutedBefore` and `ExecutedAfter` with the
2673
+ # The supported Keys are ExecutedBefore and ExecutedAfter with the
2684
2674
  # value being a date/time string such as 2016-11-04T05:00:00Z.
2685
2675
  # @return [Array<Types::MaintenanceWindowFilter>]
2686
2676
  #
@@ -2743,8 +2733,8 @@ module Aws::SSM
2743
2733
  #
2744
2734
  # @!attribute [rw] filters
2745
2735
  # Optional filters that can be used to narrow down the scope of the
2746
- # returned window targets. The supported filter keys are `Type`,
2747
- # `WindowTargetId` and `OwnerInformation`.
2736
+ # returned window targets. The supported filter keys are Type,
2737
+ # WindowTargetId and OwnerInformation.
2748
2738
  # @return [Array<Types::MaintenanceWindowFilter>]
2749
2739
  #
2750
2740
  # @!attribute [rw] max_results
@@ -2806,8 +2796,8 @@ module Aws::SSM
2806
2796
  #
2807
2797
  # @!attribute [rw] filters
2808
2798
  # Optional filters used to narrow down the scope of the returned
2809
- # tasks. The supported filter keys are `WindowTaskId`, `TaskArn`,
2810
- # `Priority`, and `TaskType`.
2799
+ # tasks. The supported filter keys are WindowTaskId, TaskArn,
2800
+ # Priority, and TaskType.
2811
2801
  # @return [Array<Types::MaintenanceWindowFilter>]
2812
2802
  #
2813
2803
  # @!attribute [rw] max_results
@@ -2864,7 +2854,7 @@ module Aws::SSM
2864
2854
  #
2865
2855
  # @!attribute [rw] filters
2866
2856
  # Optional filters used to narrow down the scope of the returned
2867
- # Maintenance Windows. Supported filter keys are `Name` and `Enabled`.
2857
+ # Maintenance Windows. Supported filter keys are Name and Enabled.
2868
2858
  # @return [Array<Types::MaintenanceWindowFilter>]
2869
2859
  #
2870
2860
  # @!attribute [rw] max_results
@@ -2977,9 +2967,10 @@ module Aws::SSM
2977
2967
  # @!attribute [rw] filters
2978
2968
  # Each element in the array is a structure containing:
2979
2969
  #
2980
- # Key: (string, NAME\_PREFIX or OWNER)
2970
+ # Key: (string, "NAME\_PREFIX" or "OWNER")
2981
2971
  #
2982
- # Value: (array of strings, exactly 1 entry, 1 length ≤ 255)
2972
+ # Value: (array of strings, exactly 1 entry, between 1 and 255
2973
+ # characters)
2983
2974
  # @return [Array<Types::PatchOrchestratorFilter>]
2984
2975
  #
2985
2976
  # @!attribute [rw] max_results
@@ -3045,7 +3036,7 @@ module Aws::SSM
3045
3036
  # @return [Integer]
3046
3037
  #
3047
3038
  # @!attribute [rw] instances_with_installed_other_patches
3048
- # The number of instances with patches installed that arent defined
3039
+ # The number of instances with patches installed that aren't defined
3049
3040
  # in the patch baseline.
3050
3041
  # @return [Integer]
3051
3042
  #
@@ -3060,7 +3051,7 @@ module Aws::SSM
3060
3051
  # @return [Integer]
3061
3052
  #
3062
3053
  # @!attribute [rw] instances_with_not_applicable_patches
3063
- # The number of instances with patches that arent applicable.
3054
+ # The number of instances with patches that aren't applicable.
3064
3055
  # @return [Integer]
3065
3056
  #
3066
3057
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupStateResult AWS API Documentation
@@ -3103,7 +3094,7 @@ module Aws::SSM
3103
3094
  # @!attribute [rw] mappings
3104
3095
  # Each entry in the array contains:
3105
3096
  #
3106
- # PatchGroup: string (1 length ≤ 256, Regex:
3097
+ # PatchGroup: string (between 1 and 256 characters, Regex:
3107
3098
  # ^(\[\\p\\\{L\\}\\p\\\{Z\\}\\p\\\{N\\}\_.:/=+\\-@\]*)$)
3108
3099
  #
3109
3100
  # PatchBaselineIdentity: A PatchBaselineIdentity element.
@@ -3305,8 +3296,7 @@ module Aws::SSM
3305
3296
  # @return [String]
3306
3297
  #
3307
3298
  # @!attribute [rw] type
3308
- # The type of parameter. The type can be either String or
3309
- # “StringList”.
3299
+ # The type of parameter. The type can be either String or StringList.
3310
3300
  # @return [String]
3311
3301
  #
3312
3302
  # @!attribute [rw] description
@@ -3408,6 +3398,32 @@ module Aws::SSM
3408
3398
  include Aws::Structure
3409
3399
  end
3410
3400
 
3401
+ # Information about an Automation failure.
3402
+ #
3403
+ # @!attribute [rw] failure_stage
3404
+ # The stage of the Automation execution when the failure occurred. The
3405
+ # stages include the following: InputValidation, PreVerification,
3406
+ # Invocation, PostVerification.
3407
+ # @return [String]
3408
+ #
3409
+ # @!attribute [rw] failure_type
3410
+ # The type of Automation failure. Failure types include the following:
3411
+ # Action, Permission, Throttling, Verification, Internal.
3412
+ # @return [String]
3413
+ #
3414
+ # @!attribute [rw] details
3415
+ # Detailed information about the Automation step failure.
3416
+ # @return [Hash<String,Array<String>>]
3417
+ #
3418
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/FailureDetails AWS API Documentation
3419
+ #
3420
+ class FailureDetails < Struct.new(
3421
+ :failure_stage,
3422
+ :failure_type,
3423
+ :details)
3424
+ include Aws::Structure
3425
+ end
3426
+
3411
3427
  # @note When making an API call, you may pass GetAutomationExecutionRequest
3412
3428
  # data as a hash:
3413
3429
  #
@@ -3417,7 +3433,7 @@ module Aws::SSM
3417
3433
  #
3418
3434
  # @!attribute [rw] automation_execution_id
3419
3435
  # The unique identifier for an existing automation execution to
3420
- # examine. The execution ID is returned by `StartAutomationExecution`
3436
+ # examine. The execution ID is returned by StartAutomationExecution
3421
3437
  # when the execution of an Automation document is initiated.
3422
3438
  # @return [String]
3423
3439
  #
@@ -3500,7 +3516,7 @@ module Aws::SSM
3500
3516
  #
3501
3517
  # @!attribute [rw] response_code
3502
3518
  # The error level response code for the plugin script. If the response
3503
- # code is `-1`, then the command has not started executing on the
3519
+ # code is -1, then the command has not started executing on the
3504
3520
  # instance, or it was not received by the instance.
3505
3521
  # @return [Integer]
3506
3522
  #
@@ -3512,7 +3528,7 @@ module Aws::SSM
3512
3528
  # @return [String]
3513
3529
  #
3514
3530
  # @!attribute [rw] execution_elapsed_time
3515
- # Duration since `ExecutionStartDateTime`.
3531
+ # Duration since ExecutionStartDateTime.
3516
3532
  # @return [String]
3517
3533
  #
3518
3534
  # @!attribute [rw] execution_end_date_time
@@ -3524,60 +3540,59 @@ module Aws::SSM
3524
3540
  #
3525
3541
  # @!attribute [rw] status
3526
3542
  # The status of the parent command for this invocation. This status
3527
- # can be different than `StatusDetails`.
3543
+ # can be different than StatusDetails.
3528
3544
  # @return [String]
3529
3545
  #
3530
3546
  # @!attribute [rw] status_details
3531
3547
  # A detailed status of the command execution for an invocation.
3532
- # `StatusDetails` includes more information than `Status` because it
3548
+ # StatusDetails includes more information than Status because it
3533
3549
  # includes states resulting from error and concurrency control
3534
- # parameters. `StatusDetails` can show different results than
3535
- # `Status`. For more information about these statuses, see [Run
3536
- # Command Status][1]. `StatusDetails` can be one of the following
3537
- # values:
3550
+ # parameters. StatusDetails can show different results than Status.
3551
+ # For more information about these statuses, see [Run Command
3552
+ # Status][1]. StatusDetails can be one of the following values:
3538
3553
  #
3539
- # * Pending The command has not been sent to the instance.
3554
+ # * Pending: The command has not been sent to the instance.
3540
3555
  #
3541
- # * In Progress The command has been sent to the instance but has
3542
- # not reached a terminal state.
3556
+ # * In Progress: The command has been sent to the instance but has not
3557
+ # reached a terminal state.
3543
3558
  #
3544
- # * Delayed The system attempted to send the command to the target,
3559
+ # * Delayed: The system attempted to send the command to the target,
3545
3560
  # but the target was not available. The instance might not be
3546
3561
  # available because of network issues, the instance was stopped,
3547
3562
  # etc. The system will try to deliver the command again.
3548
3563
  #
3549
- # * Success The command or plugin was executed successfully. This is
3564
+ # * Success: The command or plugin was executed successfully. This is
3550
3565
  # a terminal state.
3551
3566
  #
3552
- # * Delivery Timed Out The command was not delivered to the instance
3567
+ # * Delivery Timed Out: The command was not delivered to the instance
3553
3568
  # before the delivery timeout expired. Delivery timeouts do not
3554
- # count against the parent commands `MaxErrors` limit, but they do
3555
- # contribute to whether the parent command status is `Success` or
3556
- # `Incomplete`. This is a terminal state.
3569
+ # count against the parent command's MaxErrors limit, but they do
3570
+ # contribute to whether the parent command status is Success or
3571
+ # Incomplete. This is a terminal state.
3557
3572
  #
3558
- # * Execution Timed Out The command started to execute on the
3573
+ # * Execution Timed Out: The command started to execute on the
3559
3574
  # instance, but the execution was not complete before the timeout
3560
- # expired. Execution timeouts count against the `MaxErrors` limit of
3575
+ # expired. Execution timeouts count against the MaxErrors limit of
3561
3576
  # the parent command. This is a terminal state.
3562
3577
  #
3563
- # * Failed The command wasn't executed successfully on the
3564
- # instance. For a plugin, this indicates that the result code was
3565
- # not zero. For a command invocation, this indicates that the result
3566
- # code for one or more plugins was not zero. Invocation failures
3567
- # count against the `MaxErrors` limit of the parent command. This is
3568
- # a terminal state.
3578
+ # * Failed: The command wasn't executed successfully on the instance.
3579
+ # For a plugin, this indicates that the result code was not zero.
3580
+ # For a command invocation, this indicates that the result code for
3581
+ # one or more plugins was not zero. Invocation failures count
3582
+ # against the MaxErrors limit of the parent command. This is a
3583
+ # terminal state.
3569
3584
  #
3570
- # * Canceled The command was terminated before it was completed.
3571
- # This is a terminal state.
3585
+ # * Canceled: The command was terminated before it was completed. This
3586
+ # is a terminal state.
3572
3587
  #
3573
- # * Undeliverable The command can't be delivered to the instance.
3588
+ # * Undeliverable: The command can't be delivered to the instance.
3574
3589
  # The instance might not exist or might not be responding.
3575
3590
  # Undeliverable invocations don't count against the parent
3576
- # commands `MaxErrors` limit and don't contribute to whether the
3577
- # parent command status is `Success` or `Incomplete`. This is a
3578
- # terminal state.
3591
+ # command's MaxErrors limit and don't contribute to whether the
3592
+ # parent command status is Success or Incomplete. This is a terminal
3593
+ # state.
3579
3594
  #
3580
- # * Terminated The parent command exceeded its `MaxErrors` limit and
3595
+ # * Terminated: The parent command exceeded its MaxErrors limit and
3581
3596
  # subsequent command invocations were canceled by the system. This
3582
3597
  # is a terminal state.
3583
3598
  #
@@ -3588,8 +3603,8 @@ module Aws::SSM
3588
3603
  #
3589
3604
  # @!attribute [rw] standard_output_content
3590
3605
  # The first 24,000 characters written by the plugin to stdout. If the
3591
- # command has not finished executing, if `ExecutionStatus` is neither
3592
- # `Succeeded` nor `Failed`, then this string is empty.
3606
+ # command has not finished executing, if ExecutionStatus is neither
3607
+ # Succeeded nor Failed, then this string is empty.
3593
3608
  # @return [String]
3594
3609
  #
3595
3610
  # @!attribute [rw] standard_output_url
@@ -3966,9 +3981,10 @@ module Aws::SSM
3966
3981
  # The parameters passed to the task when it was executed. The map has
3967
3982
  # the following format:
3968
3983
  #
3969
- # Key: string, 1 length ≤ 255
3984
+ # Key: string, between 1 and 255 characters
3970
3985
  #
3971
- # Value: an array of strings where each string 1 length 255
3986
+ # Value: an array of strings, each string is between 1 and 255
3987
+ # characters
3972
3988
  # @return [Array<Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>>]
3973
3989
  #
3974
3990
  # @!attribute [rw] priority
@@ -4592,8 +4608,8 @@ module Aws::SSM
4592
4608
  # @!attribute [rw] key
4593
4609
  # The filter key name to describe your instances. For example:
4594
4610
  #
4595
- # "InstanceIds"\|"AgentVersion"\|"PingStatus"\|"PlatformTypes"\|"ActivationIds"\|"IamRole"\|"ResourceType"\|”AssociationStatus”\|”Tag
4596
- # Key
4611
+ # "InstanceIds"\|"AgentVersion"\|"PingStatus"\|"PlatformTypes"\|"ActivationIds"\|"IamRole"\|"ResourceType"\|"AssociationStatus"\|"Tag
4612
+ # Key"
4597
4613
  # @return [String]
4598
4614
  #
4599
4615
  # @!attribute [rw] values
@@ -4648,7 +4664,7 @@ module Aws::SSM
4648
4664
  #
4649
4665
  # @!attribute [rw] missing_count
4650
4666
  # The number of patches from the patch baseline that are applicable
4651
- # for the instance but arent currently installed.
4667
+ # for the instance but aren't currently installed.
4652
4668
  # @return [Integer]
4653
4669
  #
4654
4670
  # @!attribute [rw] failed_count
@@ -4658,8 +4674,9 @@ module Aws::SSM
4658
4674
  # @return [Integer]
4659
4675
  #
4660
4676
  # @!attribute [rw] not_applicable_count
4661
- # The number of patches from the patch baseline that arent applicable
4662
- # for the instance and hence arent installed on the instance.
4677
+ # The number of patches from the patch baseline that aren't
4678
+ # applicable for the instance and hence aren't installed on the
4679
+ # instance.
4663
4680
  # @return [Integer]
4664
4681
  #
4665
4682
  # @!attribute [rw] operation_start_time
@@ -4790,10 +4807,10 @@ module Aws::SSM
4790
4807
  #
4791
4808
  # @!attribute [rw] type_name
4792
4809
  # The name of the inventory type. Default inventory item type names
4793
- # start with `AWS`. Custom inventory type names will start with
4794
- # `Custom`. Default inventory item types include the following:
4795
- # `AWS:AWSComponent`, `AWS:Application`, `AWS:InstanceInformation`,
4796
- # `AWS:Network`, and `AWS:WindowsUpdate`.
4810
+ # start with AWS. Custom inventory type names will start with Custom.
4811
+ # Default inventory item types include the following:
4812
+ # AWS:AWSComponent, AWS:Application, AWS:InstanceInformation,
4813
+ # AWS:Network, and AWS:WindowsUpdate.
4797
4814
  # @return [String]
4798
4815
  #
4799
4816
  # @!attribute [rw] schema_version
@@ -4807,8 +4824,8 @@ module Aws::SSM
4807
4824
  # @!attribute [rw] content_hash
4808
4825
  # MD5 hash of the inventory item type contents. The content hash is
4809
4826
  # used to determine whether to update inventory information. The
4810
- # `PutInventory` API does not update the inventory item type contents
4811
- # if the MD5 hash has not changed since last update.
4827
+ # PutInventory API does not update the inventory item type contents if
4828
+ # the MD5 hash has not changed since last update.
4812
4829
  # @return [String]
4813
4830
  #
4814
4831
  # @!attribute [rw] content
@@ -4850,10 +4867,10 @@ module Aws::SSM
4850
4867
  #
4851
4868
  # @!attribute [rw] type_name
4852
4869
  # The name of the inventory type. Default inventory item type names
4853
- # start with `AWS`. Custom inventory type names will start with
4854
- # `Custom`. Default inventory item types include the following:
4855
- # `AWS:AWSComponent`, `AWS:Application`, `AWS:InstanceInformation`,
4856
- # `AWS:Network`, and `AWS:WindowsUpdate`.
4870
+ # start with AWS. Custom inventory type names will start with Custom.
4871
+ # Default inventory item types include the following:
4872
+ # AWS:AWSComponent, AWS:Application, AWS:InstanceInformation,
4873
+ # AWS:Network, and AWS:WindowsUpdate.
4857
4874
  # @return [String]
4858
4875
  #
4859
4876
  # @!attribute [rw] version
@@ -4911,8 +4928,8 @@ module Aws::SSM
4911
4928
  # @!attribute [rw] content_hash
4912
4929
  # MD5 hash of the inventory item type contents. The content hash is
4913
4930
  # used to determine whether to update inventory information. The
4914
- # `PutInventory` API does not update the inventory item type contents
4915
- # if the MD5 hash has not changed since last update.
4931
+ # PutInventory API does not update the inventory item type contents if
4932
+ # the MD5 hash has not changed since last update.
4916
4933
  # @return [String]
4917
4934
  #
4918
4935
  # @!attribute [rw] content
@@ -6030,7 +6047,7 @@ module Aws::SSM
6030
6047
  # @return [String]
6031
6048
  #
6032
6049
  # @!attribute [rw] language
6033
- # The language of the patch if its language-specific.
6050
+ # The language of the patch if it's language-specific.
6034
6051
  # @return [String]
6035
6052
  #
6036
6053
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Patch AWS API Documentation
@@ -6696,7 +6713,7 @@ module Aws::SSM
6696
6713
  #
6697
6714
  # @!attribute [rw] type_name
6698
6715
  # Name of the inventory item type. Valid value:
6699
- # AWS:InstanceInformation”. Default Value: AWS:InstanceInformation”.
6716
+ # AWS:InstanceInformation. Default Value: AWS:InstanceInformation.
6700
6717
  # @return [String]
6701
6718
  #
6702
6719
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ResultAttribute AWS API Documentation
@@ -6787,16 +6804,18 @@ module Aws::SSM
6787
6804
  # }
6788
6805
  #
6789
6806
  # @!attribute [rw] instance_ids
6790
- # Required. The instance IDs where the command should execute. You can
6791
- # specify a maximum of 50 IDs.
6807
+ # The instance IDs where the command should execute. You can specify a
6808
+ # maximum of 50 IDs. If you prefer not to list individual instance
6809
+ # IDs, you can instead send commands to a fleet of instances using the
6810
+ # Targets parameter, which accepts EC2 tags.
6792
6811
  # @return [Array<String>]
6793
6812
  #
6794
6813
  # @!attribute [rw] targets
6795
6814
  # (Optional) An array of search criteria that targets instances using
6796
- # a `Key`,`Value` combination that you specify. `Targets` is required
6797
- # if you don't provide one or more instance IDs in the call. For more
6798
- # information about how to use `Targets`, see [Executing a Command
6799
- # Using Systems Manager Run Command][1].
6815
+ # a Key,Value combination that you specify. Targets is required if you
6816
+ # don't provide one or more instance IDs in the call. For more
6817
+ # information about how to use Targets, see [Executing a Command Using
6818
+ # Systems Manager Run Command][1].
6800
6819
  #
6801
6820
  #
6802
6821
  #
@@ -6859,8 +6878,8 @@ module Aws::SSM
6859
6878
  # @!attribute [rw] max_concurrency
6860
6879
  # (Optional) The maximum number of instances that are allowed to
6861
6880
  # execute the command at the same time. You can specify a number such
6862
- # as 10 or a percentage such as 10%”. The default value is 50. For
6863
- # more information about how to use `MaxConcurrency`, see [Executing a
6881
+ # as 10 or a percentage such as 10%. The default value is 50. For more
6882
+ # information about how to use MaxConcurrency, see [Executing a
6864
6883
  # Command Using Systems Manager Run Command][1].
6865
6884
  #
6866
6885
  #
@@ -6870,12 +6889,11 @@ module Aws::SSM
6870
6889
  #
6871
6890
  # @!attribute [rw] max_errors
6872
6891
  # The maximum number of errors allowed without the command failing.
6873
- # When the command fails one more time beyond the value of
6874
- # `MaxErrors`, the systems stops sending the command to additional
6875
- # targets. You can specify a number like 10 or a percentage like
6876
- # “10%”. The default value is 50. For more information about how to
6877
- # use `MaxErrors`, see [Executing a Command Using Systems Manager Run
6878
- # Command][1].
6892
+ # When the command fails one more time beyond the value of MaxErrors,
6893
+ # the systems stops sending the command to additional targets. You can
6894
+ # specify a number like 10 or a percentage like 10%. The default value
6895
+ # is 50. For more information about how to use MaxErrors, see
6896
+ # [Executing a Command Using Systems Manager Run Command][1].
6879
6897
  #
6880
6898
  #
6881
6899
  #
@@ -6981,7 +6999,7 @@ module Aws::SSM
6981
6999
  #
6982
7000
  # @!attribute [rw] execution_start_time
6983
7001
  # If a step has begun execution, this contains the time the step
6984
- # started. If the step is in `Pending` status, this field is not
7002
+ # started. If the step is in Pending status, this field is not
6985
7003
  # populated.
6986
7004
  # @return [Time]
6987
7005
  #
@@ -6992,8 +7010,8 @@ module Aws::SSM
6992
7010
  # @return [Time]
6993
7011
  #
6994
7012
  # @!attribute [rw] step_status
6995
- # The execution status for this step. Valid values include: `Pending`,
6996
- # `InProgress`, `Success`, `Cancelled`, `Failed`, and `TimedOut`.
7013
+ # The execution status for this step. Valid values include: Pending,
7014
+ # InProgress, Success, Cancelled, Failed, and TimedOut.
6997
7015
  # @return [String]
6998
7016
  #
6999
7017
  # @!attribute [rw] response_code
@@ -7016,6 +7034,10 @@ module Aws::SSM
7016
7034
  # If a step failed, this message explains why the execution failed.
7017
7035
  # @return [String]
7018
7036
  #
7037
+ # @!attribute [rw] failure_details
7038
+ # Information about the Automation failure.
7039
+ # @return [Types::FailureDetails]
7040
+ #
7019
7041
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StepExecution AWS API Documentation
7020
7042
  #
7021
7043
  class StepExecution < Struct.new(
@@ -7028,7 +7050,8 @@ module Aws::SSM
7028
7050
  :inputs,
7029
7051
  :outputs,
7030
7052
  :response,
7031
- :failure_message)
7053
+ :failure_message,
7054
+ :failure_details)
7032
7055
  include Aws::Structure
7033
7056
  end
7034
7057
 
@@ -7082,9 +7105,9 @@ module Aws::SSM
7082
7105
  include Aws::Structure
7083
7106
  end
7084
7107
 
7085
- # An array of search criteria that targets instances using a
7086
- # `Key`,`Value` combination that you specify. `Targets` is required if
7087
- # you don't provide one or more instance IDs in the call.
7108
+ # An array of search criteria that targets instances using a Key,Value
7109
+ # combination that you specify. Targets is required if you don't
7110
+ # provide one or more instance IDs in the call.
7088
7111
  #
7089
7112
  # @note When making an API call, you may pass Target
7090
7113
  # data as a hash:
@@ -7096,9 +7119,9 @@ module Aws::SSM
7096
7119
  #
7097
7120
  # @!attribute [rw] key
7098
7121
  # User-defined criteria for sending commands that target instances
7099
- # that meet the criteria. `Key` can be `tag:<Amazon EC2 tag>` or
7100
- # `InstanceIds`. For more information about how to send commands that
7101
- # target instances using `Key`,`Value` parameters, see [Executing a
7122
+ # that meet the criteria. Key can be tag:&lt;Amazon EC2 tag&gt; or
7123
+ # InstanceIds. For more information about how to send commands that
7124
+ # target instances using Key,Value parameters, see [Executing a
7102
7125
  # Command Using Systems Manager Run Command][1].
7103
7126
  #
7104
7127
  #
@@ -7107,11 +7130,11 @@ module Aws::SSM
7107
7130
  # @return [String]
7108
7131
  #
7109
7132
  # @!attribute [rw] values
7110
- # User-defined criteria that maps to `Key`. For example, if you
7111
- # specified `tag:ServerRole`, you could specify `value:WebServer` to
7133
+ # User-defined criteria that maps to Key. For example, if you
7134
+ # specified tag:ServerRole, you could specify value:WebServer to
7112
7135
  # execute a command on instances that include Amazon EC2 tags of
7113
7136
  # ServerRole,WebServer. For more information about how to send
7114
- # commands that target instances using `Key`,`Value` parameters, see
7137
+ # commands that target instances using Key,Value parameters, see
7115
7138
  # [Executing a Command Using Systems Manager Run Command][1].
7116
7139
  #
7117
7140
  #
@@ -7144,6 +7167,13 @@ module Aws::SSM
7144
7167
  # output_s3_key_prefix: "S3KeyPrefix",
7145
7168
  # },
7146
7169
  # },
7170
+ # name: "DocumentName",
7171
+ # targets: [
7172
+ # {
7173
+ # key: "TargetKey",
7174
+ # values: ["TargetValue"],
7175
+ # },
7176
+ # ],
7147
7177
  # }
7148
7178
  #
7149
7179
  # @!attribute [rw] association_id
@@ -7162,22 +7192,22 @@ module Aws::SSM
7162
7192
  #
7163
7193
  # @!attribute [rw] schedule_expression
7164
7194
  # The cron expression used to schedule the association that you want
7165
- # to update. Supported expressions are every half, 1, 2, 4, 8 or 12
7166
- # hour(s); every specified day and time of the week. For example:
7167
- # cron(0 0/30 * 1/1 * ? *) to run every thirty minutes; cron(0 0
7168
- # 0/4 1/1 * ? *) to run every four hours; and cron(0 0 10 ? * SUN
7169
- # *) to run every Sunday at 10 a.m.
7195
+ # to update.
7170
7196
  # @return [String]
7171
7197
  #
7172
7198
  # @!attribute [rw] output_location
7173
7199
  # An Amazon S3 bucket where you want to store the results of this
7174
7200
  # request.
7175
- #
7176
- # `"\{ "S3Location": \{ "OutputS3Region": "<region>",
7177
- # "OutputS3BucketName": "bucket name", "OutputS3KeyPrefix":
7178
- # "folder name" \} \}"`
7179
7201
  # @return [Types::InstanceAssociationOutputLocation]
7180
7202
  #
7203
+ # @!attribute [rw] name
7204
+ # The name of the association document.
7205
+ # @return [String]
7206
+ #
7207
+ # @!attribute [rw] targets
7208
+ # The targets of the association.
7209
+ # @return [Array<Types::Target>]
7210
+ #
7181
7211
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateAssociationRequest AWS API Documentation
7182
7212
  #
7183
7213
  class UpdateAssociationRequest < Struct.new(
@@ -7185,7 +7215,9 @@ module Aws::SSM
7185
7215
  :parameters,
7186
7216
  :document_version,
7187
7217
  :schedule_expression,
7188
- :output_location)
7218
+ :output_location,
7219
+ :name,
7220
+ :targets)
7189
7221
  include Aws::Structure
7190
7222
  end
7191
7223