aws-sdk-ssm 1.175.0 → 1.182.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -32,11 +32,10 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
32
  require 'aws-sdk-core/plugins/request_compression.rb'
33
33
  require 'aws-sdk-core/plugins/defaults_mode.rb'
34
34
  require 'aws-sdk-core/plugins/recursion_detection.rb'
35
+ require 'aws-sdk-core/plugins/telemetry.rb'
35
36
  require 'aws-sdk-core/plugins/sign.rb'
36
37
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
37
38
 
38
- Aws::Plugins::GlobalConfiguration.add_identifier(:ssm)
39
-
40
39
  module Aws::SSM
41
40
  # An API client for SSM. To construct a client, you need to configure a `:region` and `:credentials`.
42
41
  #
@@ -83,6 +82,7 @@ module Aws::SSM
83
82
  add_plugin(Aws::Plugins::RequestCompression)
84
83
  add_plugin(Aws::Plugins::DefaultsMode)
85
84
  add_plugin(Aws::Plugins::RecursionDetection)
85
+ add_plugin(Aws::Plugins::Telemetry)
86
86
  add_plugin(Aws::Plugins::Sign)
87
87
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
88
88
  add_plugin(Aws::SSM::Plugins::Endpoints)
@@ -128,13 +128,15 @@ module Aws::SSM
128
128
  # locations will be searched for credentials:
129
129
  #
130
130
  # * `Aws.config[:credentials]`
131
- # * The `:access_key_id`, `:secret_access_key`, and `:session_token` options.
132
- # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
131
+ # * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
132
+ # `:account_id` options.
133
+ # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
134
+ # ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
133
135
  # * `~/.aws/credentials`
134
136
  # * `~/.aws/config`
135
137
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
136
138
  # are very aggressive. Construct and pass an instance of
137
- # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
139
+ # `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
138
140
  # enable retries and extended timeouts. Instance profile credential
139
141
  # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
140
142
  # to true.
@@ -153,6 +155,8 @@ module Aws::SSM
153
155
  #
154
156
  # @option options [String] :access_key_id
155
157
  #
158
+ # @option options [String] :account_id
159
+ #
156
160
  # @option options [Boolean] :active_endpoint_cache (false)
157
161
  # When set to `true`, a thread polling for endpoints will be running in
158
162
  # the background every 60 secs (default). Defaults to `false`.
@@ -337,6 +341,16 @@ module Aws::SSM
337
341
  # ** Please note ** When response stubbing is enabled, no HTTP
338
342
  # requests are made, and retries are disabled.
339
343
  #
344
+ # @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
345
+ # Allows you to provide a telemetry provider, which is used to
346
+ # emit telemetry data. By default, uses `NoOpTelemetryProvider` which
347
+ # will not record or emit any telemetry data. The SDK supports the
348
+ # following telemetry providers:
349
+ #
350
+ # * OpenTelemetry (OTel) - To use the OTel provider, install and require the
351
+ # `opentelemetry-sdk` gem and then, pass in an instance of a
352
+ # `Aws::Telemetry::OTelProvider` for telemetry provider.
353
+ #
340
354
  # @option options [Aws::TokenProvider] :token_provider
341
355
  # A Bearer Token Provider. This can be an instance of any one of the
342
356
  # following classes:
@@ -364,7 +378,9 @@ module Aws::SSM
364
378
  # sending the request.
365
379
  #
366
380
  # @option options [Aws::SSM::EndpointProvider] :endpoint_provider
367
- # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::SSM::EndpointParameters`
381
+ # The endpoint provider used to resolve endpoints. Any object that responds to
382
+ # `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
383
+ # `Aws::SSM::EndpointParameters`.
368
384
  #
369
385
  # @option options [Float] :http_continue_timeout (1)
370
386
  # The number of seconds to wait for a 100-continue response before sending the
@@ -420,6 +436,12 @@ module Aws::SSM
420
436
  # @option options [String] :ssl_ca_store
421
437
  # Sets the X509::Store to verify peer certificate.
422
438
  #
439
+ # @option options [OpenSSL::X509::Certificate] :ssl_cert
440
+ # Sets a client certificate when creating http connections.
441
+ #
442
+ # @option options [OpenSSL::PKey] :ssl_key
443
+ # Sets a client key when creating http connections.
444
+ #
423
445
  # @option options [Float] :ssl_timeout
424
446
  # Sets the SSL timeout in seconds
425
447
  #
@@ -660,9 +682,9 @@ module Aws::SSM
660
682
  # capabilities. You use the activation code and ID when installing SSM
661
683
  # Agent on machines in your hybrid environment. For more information
662
684
  # about requirements for managing on-premises machines using Systems
663
- # Manager, see [Setting up Amazon Web Services Systems Manager for
664
- # hybrid and multicloud environments][1] in the *Amazon Web Services
665
- # Systems Manager User Guide*.
685
+ # Manager, see [Using Amazon Web Services Systems Manager in hybrid and
686
+ # multicloud environments][1] in the *Amazon Web Services Systems
687
+ # Manager User Guide*.
666
688
  #
667
689
  # <note markdown="1"> Amazon Elastic Compute Cloud (Amazon EC2) instances, edge devices, and
668
690
  # on-premises servers and VMs that are configured for Systems Manager
@@ -672,7 +694,7 @@ module Aws::SSM
672
694
  #
673
695
  #
674
696
  #
675
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html
697
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-hybrid-multicloud.html
676
698
  #
677
699
  # @option params [String] :description
678
700
  # A user-defined description of the resource that you want to register
@@ -692,9 +714,9 @@ module Aws::SSM
692
714
  # want to assign to the managed node. This IAM role must provide
693
715
  # AssumeRole permissions for the Amazon Web Services Systems Manager
694
716
  # service principal `ssm.amazonaws.com`. For more information, see
695
- # [Create an IAM service role for a hybrid and multicloud
696
- # environment][1] in the *Amazon Web Services Systems Manager User
697
- # Guide*.
717
+ # [Create the IAM service role required for Systems Manager in a hybrid
718
+ # and multicloud environments][1] in the *Amazon Web Services Systems
719
+ # Manager User Guide*.
698
720
  #
699
721
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
700
722
  # must create a unique role.
@@ -703,7 +725,7 @@ module Aws::SSM
703
725
  #
704
726
  #
705
727
  #
706
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
728
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
707
729
  #
708
730
  # @option params [Integer] :registration_limit
709
731
  # Specify the maximum number of managed nodes you want to register. The
@@ -711,7 +733,7 @@ module Aws::SSM
711
733
  #
712
734
  # @option params [Time,DateTime,Date,Integer,String] :expiration_date
713
735
  # The date by which this activation request should expire, in timestamp
714
- # format, such as "2021-07-07T00:00:00". You can specify a date up to
736
+ # format, such as "2024-07-07T00:00:00". You can specify a date up to
715
737
  # 30 days in advance. If you don't provide an expiration date, the
716
738
  # activation code expires in 24 hours.
717
739
  #
@@ -858,9 +880,10 @@ module Aws::SSM
858
880
  # Amazon Web Services account, or individual managed node IDs. You can
859
881
  # target all managed nodes in an Amazon Web Services account by
860
882
  # specifying the `InstanceIds` key with a value of `*`. For more
861
- # information about choosing targets for an association, see [About
862
- # targets and rate controls in State Manager associations][1] in the
863
- # *Amazon Web Services Systems Manager User Guide*.
883
+ # information about choosing targets for an association, see
884
+ # [Understanding targets and rate controls in State Manager
885
+ # associations][1] in the *Amazon Web Services Systems Manager User
886
+ # Guide*.
864
887
  #
865
888
  #
866
889
  #
@@ -1054,6 +1077,16 @@ module Aws::SSM
1054
1077
  # },
1055
1078
  # ],
1056
1079
  # },
1080
+ # include_child_organization_units: false,
1081
+ # exclude_accounts: ["ExcludeAccount"],
1082
+ # targets: [
1083
+ # {
1084
+ # key: "TargetKey",
1085
+ # values: ["TargetValue"],
1086
+ # },
1087
+ # ],
1088
+ # targets_max_concurrency: "MaxConcurrency",
1089
+ # targets_max_errors: "MaxErrors",
1057
1090
  # },
1058
1091
  # ],
1059
1092
  # schedule_offset: 1,
@@ -1129,6 +1162,15 @@ module Aws::SSM
1129
1162
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
1130
1163
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
1131
1164
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
1165
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
1166
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
1167
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
1168
+ # resp.association_description.target_locations[0].targets #=> Array
1169
+ # resp.association_description.target_locations[0].targets[0].key #=> String
1170
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
1171
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
1172
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
1173
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
1132
1174
  # resp.association_description.schedule_offset #=> Integer
1133
1175
  # resp.association_description.duration #=> Integer
1134
1176
  # resp.association_description.target_maps #=> Array
@@ -1219,6 +1261,16 @@ module Aws::SSM
1219
1261
  # },
1220
1262
  # ],
1221
1263
  # },
1264
+ # include_child_organization_units: false,
1265
+ # exclude_accounts: ["ExcludeAccount"],
1266
+ # targets: [
1267
+ # {
1268
+ # key: "TargetKey",
1269
+ # values: ["TargetValue"],
1270
+ # },
1271
+ # ],
1272
+ # targets_max_concurrency: "MaxConcurrency",
1273
+ # targets_max_errors: "MaxErrors",
1222
1274
  # },
1223
1275
  # ],
1224
1276
  # schedule_offset: 1,
@@ -1291,6 +1343,15 @@ module Aws::SSM
1291
1343
  # resp.successful[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
1292
1344
  # resp.successful[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
1293
1345
  # resp.successful[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
1346
+ # resp.successful[0].target_locations[0].include_child_organization_units #=> Boolean
1347
+ # resp.successful[0].target_locations[0].exclude_accounts #=> Array
1348
+ # resp.successful[0].target_locations[0].exclude_accounts[0] #=> String
1349
+ # resp.successful[0].target_locations[0].targets #=> Array
1350
+ # resp.successful[0].target_locations[0].targets[0].key #=> String
1351
+ # resp.successful[0].target_locations[0].targets[0].values #=> Array
1352
+ # resp.successful[0].target_locations[0].targets[0].values[0] #=> String
1353
+ # resp.successful[0].target_locations[0].targets_max_concurrency #=> String
1354
+ # resp.successful[0].target_locations[0].targets_max_errors #=> String
1294
1355
  # resp.successful[0].schedule_offset #=> Integer
1295
1356
  # resp.successful[0].duration #=> Integer
1296
1357
  # resp.successful[0].target_maps #=> Array
@@ -1338,6 +1399,15 @@ module Aws::SSM
1338
1399
  # resp.failed[0].entry.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
1339
1400
  # resp.failed[0].entry.target_locations[0].target_location_alarm_configuration.alarms #=> Array
1340
1401
  # resp.failed[0].entry.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
1402
+ # resp.failed[0].entry.target_locations[0].include_child_organization_units #=> Boolean
1403
+ # resp.failed[0].entry.target_locations[0].exclude_accounts #=> Array
1404
+ # resp.failed[0].entry.target_locations[0].exclude_accounts[0] #=> String
1405
+ # resp.failed[0].entry.target_locations[0].targets #=> Array
1406
+ # resp.failed[0].entry.target_locations[0].targets[0].key #=> String
1407
+ # resp.failed[0].entry.target_locations[0].targets[0].values #=> Array
1408
+ # resp.failed[0].entry.target_locations[0].targets[0].values[0] #=> String
1409
+ # resp.failed[0].entry.target_locations[0].targets_max_concurrency #=> String
1410
+ # resp.failed[0].entry.target_locations[0].targets_max_errors #=> String
1341
1411
  # resp.failed[0].entry.schedule_offset #=> Integer
1342
1412
  # resp.failed[0].entry.duration #=> Integer
1343
1413
  # resp.failed[0].entry.target_maps #=> Array
@@ -1368,7 +1438,7 @@ module Aws::SSM
1368
1438
  #
1369
1439
  #
1370
1440
  #
1371
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-ssm-docs.html
1441
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html
1372
1442
  #
1373
1443
  # @option params [required, String] :content
1374
1444
  # The content for the new SSM document in JSON or YAML format. The
@@ -2003,7 +2073,7 @@ module Aws::SSM
2003
2073
  # A list of explicitly approved patches for the baseline.
2004
2074
  #
2005
2075
  # For information about accepted formats for lists of approved patches
2006
- # and rejected patches, see [About package name formats for approved and
2076
+ # and rejected patches, see [Package name formats for approved and
2007
2077
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
2008
2078
  # User Guide*.
2009
2079
  #
@@ -2025,7 +2095,7 @@ module Aws::SSM
2025
2095
  # A list of explicitly rejected patches for the baseline.
2026
2096
  #
2027
2097
  # For information about accepted formats for lists of approved patches
2028
- # and rejected patches, see [About package name formats for approved and
2098
+ # and rejected patches, see [Package name formats for approved and
2029
2099
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
2030
2100
  # User Guide*.
2031
2101
  #
@@ -2168,7 +2238,7 @@ module Aws::SSM
2168
2238
  # You can configure Systems Manager Inventory to use the
2169
2239
  # `SyncToDestination` type to synchronize Inventory data from multiple
2170
2240
  # Amazon Web Services Regions to a single Amazon Simple Storage Service
2171
- # (Amazon S3) bucket. For more information, see [Configuring resource
2241
+ # (Amazon S3) bucket. For more information, see [Creatinga a resource
2172
2242
  # data sync for Inventory][1] in the *Amazon Web Services Systems
2173
2243
  # Manager User Guide*.
2174
2244
  #
@@ -2196,7 +2266,7 @@ module Aws::SSM
2196
2266
  #
2197
2267
  #
2198
2268
  #
2199
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-datasync.html
2269
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-create-resource-data-sync.html
2200
2270
  # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/Explorer-resource-data-sync.html
2201
2271
  #
2202
2272
  # @option params [required, String] :sync_name
@@ -3004,6 +3074,15 @@ module Aws::SSM
3004
3074
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
3005
3075
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
3006
3076
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
3077
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
3078
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
3079
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
3080
+ # resp.association_description.target_locations[0].targets #=> Array
3081
+ # resp.association_description.target_locations[0].targets[0].key #=> String
3082
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
3083
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
3084
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
3085
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
3007
3086
  # resp.association_description.schedule_offset #=> Integer
3008
3087
  # resp.association_description.duration #=> Integer
3009
3088
  # resp.association_description.target_maps #=> Array
@@ -3252,6 +3331,7 @@ module Aws::SSM
3252
3331
  # resp.automation_execution_metadata_list[0].triggered_alarms #=> Array
3253
3332
  # resp.automation_execution_metadata_list[0].triggered_alarms[0].name #=> String
3254
3333
  # resp.automation_execution_metadata_list[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
3334
+ # resp.automation_execution_metadata_list[0].target_locations_url #=> String
3255
3335
  # resp.automation_execution_metadata_list[0].automation_subtype #=> String, one of "ChangeRequest"
3256
3336
  # resp.automation_execution_metadata_list[0].scheduled_time #=> Time
3257
3337
  # resp.automation_execution_metadata_list[0].runbooks #=> Array
@@ -3282,6 +3362,15 @@ module Aws::SSM
3282
3362
  # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
3283
3363
  # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
3284
3364
  # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
3365
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].include_child_organization_units #=> Boolean
3366
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].exclude_accounts #=> Array
3367
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].exclude_accounts[0] #=> String
3368
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets #=> Array
3369
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets[0].key #=> String
3370
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets[0].values #=> Array
3371
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets[0].values[0] #=> String
3372
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets_max_concurrency #=> String
3373
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets_max_errors #=> String
3285
3374
  # resp.automation_execution_metadata_list[0].ops_item_id #=> String
3286
3375
  # resp.automation_execution_metadata_list[0].association_id #=> String
3287
3376
  # resp.automation_execution_metadata_list[0].change_request_name #=> String
@@ -3389,6 +3478,15 @@ module Aws::SSM
3389
3478
  # resp.step_executions[0].target_location.target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
3390
3479
  # resp.step_executions[0].target_location.target_location_alarm_configuration.alarms #=> Array
3391
3480
  # resp.step_executions[0].target_location.target_location_alarm_configuration.alarms[0].name #=> String
3481
+ # resp.step_executions[0].target_location.include_child_organization_units #=> Boolean
3482
+ # resp.step_executions[0].target_location.exclude_accounts #=> Array
3483
+ # resp.step_executions[0].target_location.exclude_accounts[0] #=> String
3484
+ # resp.step_executions[0].target_location.targets #=> Array
3485
+ # resp.step_executions[0].target_location.targets[0].key #=> String
3486
+ # resp.step_executions[0].target_location.targets[0].values #=> Array
3487
+ # resp.step_executions[0].target_location.targets[0].values[0] #=> String
3488
+ # resp.step_executions[0].target_location.targets_max_concurrency #=> String
3489
+ # resp.step_executions[0].target_location.targets_max_errors #=> String
3392
3490
  # resp.step_executions[0].triggered_alarms #=> Array
3393
3491
  # resp.step_executions[0].triggered_alarms[0].name #=> String
3394
3492
  # resp.step_executions[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
@@ -4173,9 +4271,8 @@ module Aws::SSM
4173
4271
  # Sample values: `Installed` \| `InstalledOther` \|
4174
4272
  # `InstalledPendingReboot`
4175
4273
  #
4176
- # For lists of all `State` values, see [Understanding patch compliance
4177
- # state values][1] in the *Amazon Web Services Systems Manager User
4178
- # Guide*.
4274
+ # For lists of all `State` values, see [Patch compliance state
4275
+ # values][1] in the *Amazon Web Services Systems Manager User Guide*.
4179
4276
  #
4180
4277
  #
4181
4278
  #
@@ -4533,7 +4630,7 @@ module Aws::SSM
4533
4630
  #
4534
4631
  # * Values. An array of strings, each between 1 and 256 characters.
4535
4632
  # Supported values are date/time strings in a valid ISO 8601 date/time
4536
- # format, such as `2021-11-04T05:00:00Z`.
4633
+ # format, such as `2024-11-04T05:00:00Z`.
4537
4634
  #
4538
4635
  # @option params [Integer] :max_results
4539
4636
  # The maximum number of items to return for this call. The call also
@@ -5641,6 +5738,15 @@ module Aws::SSM
5641
5738
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5642
5739
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.alarms #=> Array
5643
5740
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.alarms[0].name #=> String
5741
+ # resp.automation_execution.step_executions[0].target_location.include_child_organization_units #=> Boolean
5742
+ # resp.automation_execution.step_executions[0].target_location.exclude_accounts #=> Array
5743
+ # resp.automation_execution.step_executions[0].target_location.exclude_accounts[0] #=> String
5744
+ # resp.automation_execution.step_executions[0].target_location.targets #=> Array
5745
+ # resp.automation_execution.step_executions[0].target_location.targets[0].key #=> String
5746
+ # resp.automation_execution.step_executions[0].target_location.targets[0].values #=> Array
5747
+ # resp.automation_execution.step_executions[0].target_location.targets[0].values[0] #=> String
5748
+ # resp.automation_execution.step_executions[0].target_location.targets_max_concurrency #=> String
5749
+ # resp.automation_execution.step_executions[0].target_location.targets_max_errors #=> String
5644
5750
  # resp.automation_execution.step_executions[0].triggered_alarms #=> Array
5645
5751
  # resp.automation_execution.step_executions[0].triggered_alarms[0].name #=> String
5646
5752
  # resp.automation_execution.step_executions[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
@@ -5688,6 +5794,15 @@ module Aws::SSM
5688
5794
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5689
5795
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.alarms #=> Array
5690
5796
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
5797
+ # resp.automation_execution.target_locations[0].include_child_organization_units #=> Boolean
5798
+ # resp.automation_execution.target_locations[0].exclude_accounts #=> Array
5799
+ # resp.automation_execution.target_locations[0].exclude_accounts[0] #=> String
5800
+ # resp.automation_execution.target_locations[0].targets #=> Array
5801
+ # resp.automation_execution.target_locations[0].targets[0].key #=> String
5802
+ # resp.automation_execution.target_locations[0].targets[0].values #=> Array
5803
+ # resp.automation_execution.target_locations[0].targets[0].values[0] #=> String
5804
+ # resp.automation_execution.target_locations[0].targets_max_concurrency #=> String
5805
+ # resp.automation_execution.target_locations[0].targets_max_errors #=> String
5691
5806
  # resp.automation_execution.progress_counters.total_steps #=> Integer
5692
5807
  # resp.automation_execution.progress_counters.success_steps #=> Integer
5693
5808
  # resp.automation_execution.progress_counters.failed_steps #=> Integer
@@ -5699,6 +5814,7 @@ module Aws::SSM
5699
5814
  # resp.automation_execution.triggered_alarms #=> Array
5700
5815
  # resp.automation_execution.triggered_alarms[0].name #=> String
5701
5816
  # resp.automation_execution.triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
5817
+ # resp.automation_execution.target_locations_url #=> String
5702
5818
  # resp.automation_execution.automation_subtype #=> String, one of "ChangeRequest"
5703
5819
  # resp.automation_execution.scheduled_time #=> Time
5704
5820
  # resp.automation_execution.runbooks #=> Array
@@ -5729,6 +5845,15 @@ module Aws::SSM
5729
5845
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5730
5846
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
5731
5847
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
5848
+ # resp.automation_execution.runbooks[0].target_locations[0].include_child_organization_units #=> Boolean
5849
+ # resp.automation_execution.runbooks[0].target_locations[0].exclude_accounts #=> Array
5850
+ # resp.automation_execution.runbooks[0].target_locations[0].exclude_accounts[0] #=> String
5851
+ # resp.automation_execution.runbooks[0].target_locations[0].targets #=> Array
5852
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].key #=> String
5853
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].values #=> Array
5854
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].values[0] #=> String
5855
+ # resp.automation_execution.runbooks[0].target_locations[0].targets_max_concurrency #=> String
5856
+ # resp.automation_execution.runbooks[0].target_locations[0].targets_max_errors #=> String
5732
5857
  # resp.automation_execution.ops_item_id #=> String
5733
5858
  # resp.automation_execution.association_id #=> String
5734
5859
  # resp.automation_execution.change_request_name #=> String
@@ -6876,7 +7001,7 @@ module Aws::SSM
6876
7001
  #
6877
7002
  #
6878
7003
  #
6879
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sharing.html
7004
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
6880
7005
  #
6881
7006
  # @option params [Boolean] :with_decryption
6882
7007
  # Return decrypted values for secure string parameters. This flag is
@@ -7536,6 +7661,15 @@ module Aws::SSM
7536
7661
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
7537
7662
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
7538
7663
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
7664
+ # resp.association_versions[0].target_locations[0].include_child_organization_units #=> Boolean
7665
+ # resp.association_versions[0].target_locations[0].exclude_accounts #=> Array
7666
+ # resp.association_versions[0].target_locations[0].exclude_accounts[0] #=> String
7667
+ # resp.association_versions[0].target_locations[0].targets #=> Array
7668
+ # resp.association_versions[0].target_locations[0].targets[0].key #=> String
7669
+ # resp.association_versions[0].target_locations[0].targets[0].values #=> Array
7670
+ # resp.association_versions[0].target_locations[0].targets[0].values[0] #=> String
7671
+ # resp.association_versions[0].target_locations[0].targets_max_concurrency #=> String
7672
+ # resp.association_versions[0].target_locations[0].targets_max_errors #=> String
7539
7673
  # resp.association_versions[0].schedule_offset #=> Integer
7540
7674
  # resp.association_versions[0].duration #=> Integer
7541
7675
  # resp.association_versions[0].target_maps #=> Array
@@ -9482,7 +9616,7 @@ module Aws::SSM
9482
9616
  # creating a custom policy and custom service role for running your
9483
9617
  # maintenance window tasks. The policy can be crafted to provide only
9484
9618
  # the permissions needed for your particular maintenance window tasks.
9485
- # For more information, see [Setting up maintenance windows][1] in the
9619
+ # For more information, see [Setting up Maintenance Windows][1] in the
9486
9620
  # in the *Amazon Web Services Systems Manager User Guide*.
9487
9621
  #
9488
9622
  #
@@ -10236,6 +10370,9 @@ module Aws::SSM
10236
10370
  # A key-value mapping to target resources. Required if you specify
10237
10371
  # TargetParameterName.
10238
10372
  #
10373
+ # If both this parameter and the `TargetLocation:Targets` parameter are
10374
+ # supplied, `TargetLocation:Targets` takes precedence.
10375
+ #
10239
10376
  # @option params [Array<Hash>] :target_maps
10240
10377
  # A key-value mapping of document parameters to target resources. Both
10241
10378
  # Targets and TargetMaps can't be specified together.
@@ -10245,6 +10382,9 @@ module Aws::SSM
10245
10382
  # You can specify a number, such as 10, or a percentage, such as 10%.
10246
10383
  # The default value is `10`.
10247
10384
  #
10385
+ # If both this parameter and the `TargetLocation:TargetsMaxConcurrency`
10386
+ # are supplied, `TargetLocation:TargetsMaxConcurrency` takes precedence.
10387
+ #
10248
10388
  # @option params [String] :max_errors
10249
10389
  # The number of errors that are allowed before the system stops running
10250
10390
  # the automation on additional targets. You can specify either an
@@ -10263,14 +10403,17 @@ module Aws::SSM
10263
10403
  # max-errors failed executions, set max-concurrency to 1 so the
10264
10404
  # executions proceed one at a time.
10265
10405
  #
10406
+ # If this parameter and the `TargetLocation:TargetsMaxErrors` parameter
10407
+ # are both supplied, `TargetLocation:TargetsMaxErrors` takes precedence.
10408
+ #
10266
10409
  # @option params [Array<Types::TargetLocation>] :target_locations
10267
10410
  # A location is a combination of Amazon Web Services Regions and/or
10268
10411
  # Amazon Web Services accounts where you want to run the automation. Use
10269
10412
  # this operation to start an automation in multiple Amazon Web Services
10270
10413
  # Regions and multiple Amazon Web Services accounts. For more
10271
- # information, see [Running Automation workflows in multiple Amazon Web
10272
- # Services Regions and Amazon Web Services accounts][1] in the *Amazon
10273
- # Web Services Systems Manager User Guide*.
10414
+ # information, see [Running automations in multiple Amazon Web Services
10415
+ # Regions and accounts][1] in the *Amazon Web Services Systems Manager
10416
+ # User Guide*.
10274
10417
  #
10275
10418
  #
10276
10419
  #
@@ -10296,6 +10439,11 @@ module Aws::SSM
10296
10439
  # @option params [Types::AlarmConfiguration] :alarm_configuration
10297
10440
  # The CloudWatch alarm you want to apply to your automation.
10298
10441
  #
10442
+ # @option params [String] :target_locations_url
10443
+ # Specify a publicly accessible URL for a file that contains the
10444
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
10445
+ # buckets are supported.
10446
+ #
10299
10447
  # @return [Types::StartAutomationExecutionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10300
10448
  #
10301
10449
  # * {Types::StartAutomationExecutionResult#automation_execution_id #automation_execution_id} => String
@@ -10339,6 +10487,16 @@ module Aws::SSM
10339
10487
  # },
10340
10488
  # ],
10341
10489
  # },
10490
+ # include_child_organization_units: false,
10491
+ # exclude_accounts: ["ExcludeAccount"],
10492
+ # targets: [
10493
+ # {
10494
+ # key: "TargetKey",
10495
+ # values: ["TargetValue"],
10496
+ # },
10497
+ # ],
10498
+ # targets_max_concurrency: "MaxConcurrency",
10499
+ # targets_max_errors: "MaxErrors",
10342
10500
  # },
10343
10501
  # ],
10344
10502
  # tags: [
@@ -10355,6 +10513,7 @@ module Aws::SSM
10355
10513
  # },
10356
10514
  # ],
10357
10515
  # },
10516
+ # target_locations_url: "TargetLocationsURL",
10358
10517
  # })
10359
10518
  #
10360
10519
  # @example Response structure
@@ -10504,6 +10663,16 @@ module Aws::SSM
10504
10663
  # },
10505
10664
  # ],
10506
10665
  # },
10666
+ # include_child_organization_units: false,
10667
+ # exclude_accounts: ["ExcludeAccount"],
10668
+ # targets: [
10669
+ # {
10670
+ # key: "TargetKey",
10671
+ # values: ["TargetValue"],
10672
+ # },
10673
+ # ],
10674
+ # targets_max_concurrency: "MaxConcurrency",
10675
+ # targets_max_errors: "MaxErrors",
10507
10676
  # },
10508
10677
  # ],
10509
10678
  # },
@@ -10987,6 +11156,16 @@ module Aws::SSM
10987
11156
  # },
10988
11157
  # ],
10989
11158
  # },
11159
+ # include_child_organization_units: false,
11160
+ # exclude_accounts: ["ExcludeAccount"],
11161
+ # targets: [
11162
+ # {
11163
+ # key: "TargetKey",
11164
+ # values: ["TargetValue"],
11165
+ # },
11166
+ # ],
11167
+ # targets_max_concurrency: "MaxConcurrency",
11168
+ # targets_max_errors: "MaxErrors",
10990
11169
  # },
10991
11170
  # ],
10992
11171
  # schedule_offset: 1,
@@ -11056,6 +11235,15 @@ module Aws::SSM
11056
11235
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
11057
11236
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
11058
11237
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
11238
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
11239
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
11240
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
11241
+ # resp.association_description.target_locations[0].targets #=> Array
11242
+ # resp.association_description.target_locations[0].targets[0].key #=> String
11243
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
11244
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
11245
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
11246
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
11059
11247
  # resp.association_description.schedule_offset #=> Integer
11060
11248
  # resp.association_description.duration #=> Integer
11061
11249
  # resp.association_description.target_maps #=> Array
@@ -11162,6 +11350,15 @@ module Aws::SSM
11162
11350
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
11163
11351
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
11164
11352
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
11353
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
11354
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
11355
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
11356
+ # resp.association_description.target_locations[0].targets #=> Array
11357
+ # resp.association_description.target_locations[0].targets[0].key #=> String
11358
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
11359
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
11360
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
11361
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
11165
11362
  # resp.association_description.schedule_offset #=> Integer
11166
11363
  # resp.association_description.duration #=> Integer
11167
11364
  # resp.association_description.target_maps #=> Array
@@ -11710,7 +11907,7 @@ module Aws::SSM
11710
11907
  # creating a custom policy and custom service role for running your
11711
11908
  # maintenance window tasks. The policy can be crafted to provide only
11712
11909
  # the permissions needed for your particular maintenance window tasks.
11713
- # For more information, see [Setting up maintenance windows][1] in the
11910
+ # For more information, see [Setting up Maintenance Windows][1] in the
11714
11911
  # in the *Amazon Web Services Systems Manager User Guide*.
11715
11912
  #
11716
11913
  #
@@ -12014,9 +12211,9 @@ module Aws::SSM
12014
12211
  # want to assign to the managed node. This IAM role must provide
12015
12212
  # AssumeRole permissions for the Amazon Web Services Systems Manager
12016
12213
  # service principal `ssm.amazonaws.com`. For more information, see
12017
- # [Create an IAM service role for a hybrid and multicloud
12018
- # environment][1] in the *Amazon Web Services Systems Manager User
12019
- # Guide*.
12214
+ # [Create the IAM service role required for Systems Manager in hybrid
12215
+ # and multicloud environments][1] in the *Amazon Web Services Systems
12216
+ # Manager User Guide*.
12020
12217
  #
12021
12218
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
12022
12219
  # must create a unique role.
@@ -12025,7 +12222,7 @@ module Aws::SSM
12025
12222
  #
12026
12223
  #
12027
12224
  #
12028
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
12225
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
12029
12226
  #
12030
12227
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
12031
12228
  #
@@ -12116,9 +12313,8 @@ module Aws::SSM
12116
12313
  # impacted resource.
12117
12314
  #
12118
12315
  # @option params [String] :status
12119
- # The OpsItem status. Status can be `Open`, `In Progress`, or
12120
- # `Resolved`. For more information, see [Editing OpsItem details][1] in
12121
- # the *Amazon Web Services Systems Manager User Guide*.
12316
+ # The OpsItem status. For more information, see [Editing OpsItem
12317
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
12122
12318
  #
12123
12319
  #
12124
12320
  #
@@ -12267,7 +12463,7 @@ module Aws::SSM
12267
12463
  # A list of explicitly approved patches for the baseline.
12268
12464
  #
12269
12465
  # For information about accepted formats for lists of approved patches
12270
- # and rejected patches, see [About package name formats for approved and
12466
+ # and rejected patches, see [Package name formats for approved and
12271
12467
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
12272
12468
  # User Guide*.
12273
12469
  #
@@ -12287,7 +12483,7 @@ module Aws::SSM
12287
12483
  # A list of explicitly rejected patches for the baseline.
12288
12484
  #
12289
12485
  # For information about accepted formats for lists of approved patches
12290
- # and rejected patches, see [About package name formats for approved and
12486
+ # and rejected patches, see [Package name formats for approved and
12291
12487
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
12292
12488
  # User Guide*.
12293
12489
  #
@@ -12597,14 +12793,19 @@ module Aws::SSM
12597
12793
  # @api private
12598
12794
  def build_request(operation_name, params = {})
12599
12795
  handlers = @handlers.for(operation_name)
12796
+ tracer = config.telemetry_provider.tracer_provider.tracer(
12797
+ Aws::Telemetry.module_to_tracer_name('Aws::SSM')
12798
+ )
12600
12799
  context = Seahorse::Client::RequestContext.new(
12601
12800
  operation_name: operation_name,
12602
12801
  operation: config.api.operation(operation_name),
12603
12802
  client: self,
12604
12803
  params: params,
12605
- config: config)
12804
+ config: config,
12805
+ tracer: tracer
12806
+ )
12606
12807
  context[:gem_name] = 'aws-sdk-ssm'
12607
- context[:gem_version] = '1.175.0'
12808
+ context[:gem_version] = '1.182.0'
12608
12809
  Seahorse::Client::Request.new(handlers, context)
12609
12810
  end
12610
12811