aws-sdk-ssm 1.173.0 → 1.197.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.
@@ -7,35 +7,34 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
- require 'seahorse/client/plugins/content_length.rb'
11
- require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
- require 'aws-sdk-core/plugins/logging.rb'
13
- require 'aws-sdk-core/plugins/param_converter.rb'
14
- require 'aws-sdk-core/plugins/param_validator.rb'
15
- require 'aws-sdk-core/plugins/user_agent.rb'
16
- require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
- require 'aws-sdk-core/plugins/retry_errors.rb'
18
- require 'aws-sdk-core/plugins/global_configuration.rb'
19
- require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
- require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
- require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
- require 'aws-sdk-core/plugins/response_paging.rb'
23
- require 'aws-sdk-core/plugins/stub_responses.rb'
24
- require 'aws-sdk-core/plugins/idempotency_token.rb'
25
- require 'aws-sdk-core/plugins/invocation_id.rb'
26
- require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
27
- require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
28
- require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
29
- require 'aws-sdk-core/plugins/transfer_encoding.rb'
30
- require 'aws-sdk-core/plugins/http_checksum.rb'
31
- require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
- require 'aws-sdk-core/plugins/request_compression.rb'
33
- require 'aws-sdk-core/plugins/defaults_mode.rb'
34
- require 'aws-sdk-core/plugins/recursion_detection.rb'
35
- require 'aws-sdk-core/plugins/sign.rb'
36
- require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
37
-
38
- Aws::Plugins::GlobalConfiguration.add_identifier(:ssm)
10
+ require 'seahorse/client/plugins/content_length'
11
+ require 'aws-sdk-core/plugins/credentials_configuration'
12
+ require 'aws-sdk-core/plugins/logging'
13
+ require 'aws-sdk-core/plugins/param_converter'
14
+ require 'aws-sdk-core/plugins/param_validator'
15
+ require 'aws-sdk-core/plugins/user_agent'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors'
17
+ require 'aws-sdk-core/plugins/retry_errors'
18
+ require 'aws-sdk-core/plugins/global_configuration'
19
+ require 'aws-sdk-core/plugins/regional_endpoint'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern'
22
+ require 'aws-sdk-core/plugins/response_paging'
23
+ require 'aws-sdk-core/plugins/stub_responses'
24
+ require 'aws-sdk-core/plugins/idempotency_token'
25
+ require 'aws-sdk-core/plugins/invocation_id'
26
+ require 'aws-sdk-core/plugins/jsonvalue_converter'
27
+ require 'aws-sdk-core/plugins/client_metrics_plugin'
28
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin'
29
+ require 'aws-sdk-core/plugins/transfer_encoding'
30
+ require 'aws-sdk-core/plugins/http_checksum'
31
+ require 'aws-sdk-core/plugins/checksum_algorithm'
32
+ require 'aws-sdk-core/plugins/request_compression'
33
+ require 'aws-sdk-core/plugins/defaults_mode'
34
+ require 'aws-sdk-core/plugins/recursion_detection'
35
+ require 'aws-sdk-core/plugins/telemetry'
36
+ require 'aws-sdk-core/plugins/sign'
37
+ require 'aws-sdk-core/plugins/protocols/json_rpc'
39
38
 
40
39
  module Aws::SSM
41
40
  # An API client for SSM. To construct a client, you need to configure a `:region` and `:credentials`.
@@ -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`.
@@ -196,8 +200,7 @@ module Aws::SSM
196
200
  # accepted modes and the configuration defaults that are included.
197
201
  #
198
202
  # @option options [Boolean] :disable_host_prefix_injection (false)
199
- # Set to true to disable SDK automatically adding host prefix
200
- # to default service endpoint when available.
203
+ # When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
201
204
  #
202
205
  # @option options [Boolean] :disable_request_compression (false)
203
206
  # When set to 'true' the request body will not be compressed
@@ -253,11 +256,34 @@ module Aws::SSM
253
256
  # Used when loading credentials from the shared credentials file
254
257
  # at HOME/.aws/credentials. When not specified, 'default' is used.
255
258
  #
259
+ # @option options [String] :request_checksum_calculation ("when_supported")
260
+ # Determines when a checksum will be calculated for request payloads. Values are:
261
+ #
262
+ # * `when_supported` - (default) When set, a checksum will be
263
+ # calculated for all request payloads of operations modeled with the
264
+ # `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
265
+ # `requestAlgorithmMember` is modeled.
266
+ # * `when_required` - When set, a checksum will only be calculated for
267
+ # request payloads of operations modeled with the `httpChecksum` trait where
268
+ # `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
269
+ # is modeled and supplied.
270
+ #
256
271
  # @option options [Integer] :request_min_compression_size_bytes (10240)
257
272
  # The minimum size in bytes that triggers compression for request
258
273
  # bodies. The value must be non-negative integer value between 0
259
274
  # and 10485780 bytes inclusive.
260
275
  #
276
+ # @option options [String] :response_checksum_validation ("when_supported")
277
+ # Determines when checksum validation will be performed on response payloads. Values are:
278
+ #
279
+ # * `when_supported` - (default) When set, checksum validation is performed on all
280
+ # response payloads of operations modeled with the `httpChecksum` trait where
281
+ # `responseAlgorithms` is modeled, except when no modeled checksum algorithms
282
+ # are supported.
283
+ # * `when_required` - When set, checksum validation is not performed on
284
+ # response payloads of operations unless the checksum algorithm is supported and
285
+ # the `requestValidationModeMember` member is set to `ENABLED`.
286
+ #
261
287
  # @option options [Proc] :retry_backoff
262
288
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
263
289
  # This option is only used in the `legacy` retry mode.
@@ -337,6 +363,16 @@ module Aws::SSM
337
363
  # ** Please note ** When response stubbing is enabled, no HTTP
338
364
  # requests are made, and retries are disabled.
339
365
  #
366
+ # @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
367
+ # Allows you to provide a telemetry provider, which is used to
368
+ # emit telemetry data. By default, uses `NoOpTelemetryProvider` which
369
+ # will not record or emit any telemetry data. The SDK supports the
370
+ # following telemetry providers:
371
+ #
372
+ # * OpenTelemetry (OTel) - To use the OTel provider, install and require the
373
+ # `opentelemetry-sdk` gem and then, pass in an instance of a
374
+ # `Aws::Telemetry::OTelProvider` for telemetry provider.
375
+ #
340
376
  # @option options [Aws::TokenProvider] :token_provider
341
377
  # A Bearer Token Provider. This can be an instance of any one of the
342
378
  # following classes:
@@ -364,7 +400,9 @@ module Aws::SSM
364
400
  # sending the request.
365
401
  #
366
402
  # @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`
403
+ # The endpoint provider used to resolve endpoints. Any object that responds to
404
+ # `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
405
+ # `Aws::SSM::EndpointParameters`.
368
406
  #
369
407
  # @option options [Float] :http_continue_timeout (1)
370
408
  # The number of seconds to wait for a 100-continue response before sending the
@@ -420,6 +458,12 @@ module Aws::SSM
420
458
  # @option options [String] :ssl_ca_store
421
459
  # Sets the X509::Store to verify peer certificate.
422
460
  #
461
+ # @option options [OpenSSL::X509::Certificate] :ssl_cert
462
+ # Sets a client certificate when creating http connections.
463
+ #
464
+ # @option options [OpenSSL::PKey] :ssl_key
465
+ # Sets a client key when creating http connections.
466
+ #
423
467
  # @option options [Float] :ssl_timeout
424
468
  # Sets the SSL timeout in seconds
425
469
  #
@@ -543,8 +587,8 @@ module Aws::SSM
543
587
 
544
588
  # Associates a related item to a Systems Manager OpsCenter OpsItem. For
545
589
  # example, you can associate an Incident Manager incident or analysis
546
- # with an OpsItem. Incident Manager and OpsCenter are capabilities of
547
- # Amazon Web Services Systems Manager.
590
+ # with an OpsItem. Incident Manager and OpsCenter are tools in Amazon
591
+ # Web Services Systems Manager.
548
592
  #
549
593
  # @option params [required, String] :ops_item_id
550
594
  # The ID of the OpsItem to which you want to associate a resource as a
@@ -657,12 +701,12 @@ module Aws::SSM
657
701
  # your on-premises servers, edge devices, or virtual machine (VM) with
658
702
  # Amazon Web Services Systems Manager. Registering these machines with
659
703
  # Systems Manager makes it possible to manage them using Systems Manager
660
- # capabilities. You use the activation code and ID when installing SSM
661
- # Agent on machines in your hybrid environment. For more information
662
- # 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*.
704
+ # tools. You use the activation code and ID when installing SSM Agent on
705
+ # machines in your hybrid environment. For more information about
706
+ # requirements for managing on-premises machines using Systems Manager,
707
+ # see [Using Amazon Web Services Systems Manager in hybrid and
708
+ # multicloud environments][1] in the *Amazon Web Services Systems
709
+ # Manager User Guide*.
666
710
  #
667
711
  # <note markdown="1"> Amazon Elastic Compute Cloud (Amazon EC2) instances, edge devices, and
668
712
  # on-premises servers and VMs that are configured for Systems Manager
@@ -672,7 +716,7 @@ module Aws::SSM
672
716
  #
673
717
  #
674
718
  #
675
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-managedinstances.html
719
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-hybrid-multicloud.html
676
720
  #
677
721
  # @option params [String] :description
678
722
  # A user-defined description of the resource that you want to register
@@ -692,9 +736,9 @@ module Aws::SSM
692
736
  # want to assign to the managed node. This IAM role must provide
693
737
  # AssumeRole permissions for the Amazon Web Services Systems Manager
694
738
  # 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*.
739
+ # [Create the IAM service role required for Systems Manager in a hybrid
740
+ # and multicloud environments][1] in the *Amazon Web Services Systems
741
+ # Manager User Guide*.
698
742
  #
699
743
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
700
744
  # must create a unique role.
@@ -703,7 +747,7 @@ module Aws::SSM
703
747
  #
704
748
  #
705
749
  #
706
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
750
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
707
751
  #
708
752
  # @option params [Integer] :registration_limit
709
753
  # Specify the maximum number of managed nodes you want to register. The
@@ -711,7 +755,7 @@ module Aws::SSM
711
755
  #
712
756
  # @option params [Time,DateTime,Date,Integer,String] :expiration_date
713
757
  # 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
758
+ # format, such as "2024-07-07T00:00:00". You can specify a date up to
715
759
  # 30 days in advance. If you don't provide an expiration date, the
716
760
  # activation code expires in 24 hours.
717
761
  #
@@ -792,10 +836,10 @@ module Aws::SSM
792
836
  # targets, the association specifies a schedule for when the
793
837
  # configuration is reapplied. For dynamic targets, such as an Amazon Web
794
838
  # Services resource group or an Amazon Web Services autoscaling group,
795
- # State Manager, a capability of Amazon Web Services Systems Manager
796
- # applies the configuration when new managed nodes are added to the
797
- # group. The association also specifies actions to take when applying
798
- # the configuration. For example, an association for anti-virus software
839
+ # State Manager, a tool in Amazon Web Services Systems Manager applies
840
+ # the configuration when new managed nodes are added to the group. The
841
+ # association also specifies actions to take when applying the
842
+ # configuration. For example, an association for anti-virus software
799
843
  # might run once a day. If the software isn't installed, then State
800
844
  # Manager installs it. If the software is installed, but the service
801
845
  # isn't running, then the association might instruct State Manager to
@@ -858,9 +902,10 @@ module Aws::SSM
858
902
  # Amazon Web Services account, or individual managed node IDs. You can
859
903
  # target all managed nodes in an Amazon Web Services account by
860
904
  # 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*.
905
+ # information about choosing targets for an association, see
906
+ # [Understanding targets and rate controls in State Manager
907
+ # associations][1] in the *Amazon Web Services Systems Manager User
908
+ # Guide*.
864
909
  #
865
910
  #
866
911
  #
@@ -880,7 +925,7 @@ module Aws::SSM
880
925
  # Choose the parameter that will define how your automation will branch
881
926
  # out. This target is required for associations that use an Automation
882
927
  # runbook and target resources by using rate controls. Automation is a
883
- # capability of Amazon Web Services Systems Manager.
928
+ # tool in Amazon Web Services Systems Manager.
884
929
  #
885
930
  # @option params [String] :max_errors
886
931
  # The number of errors that are allowed before the system stops sending
@@ -932,15 +977,27 @@ module Aws::SSM
932
977
  # @option params [Boolean] :apply_only_at_cron_interval
933
978
  # By default, when you create a new association, the system runs it
934
979
  # immediately after it is created and then according to the schedule you
935
- # specified. Specify this option if you don't want an association to
936
- # run immediately after you create it. This parameter isn't supported
937
- # for rate expressions.
980
+ # specified and when target changes are detected. Specify `true` for
981
+ # `ApplyOnlyAtCronInterval`if you want the association to run only
982
+ # according to the schedule you specified.
983
+ #
984
+ # For more information, see [Understanding when associations are applied
985
+ # to resources][1] and [&gt;About target updates with Automation
986
+ # runbooks][2] in the *Amazon Web Services Systems Manager User Guide*.
987
+ #
988
+ # This parameter isn't supported for rate expressions.
989
+ #
990
+ #
991
+ #
992
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
993
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
938
994
  #
939
995
  # @option params [Array<String>] :calendar_names
940
- # The names or Amazon Resource Names (ARNs) of the Change Calendar type
996
+ # The names of Amazon Resource Names (ARNs) of the Change Calendar type
941
997
  # documents you want to gate your associations under. The associations
942
998
  # only run when that change calendar is open. For more information, see
943
- # [Amazon Web Services Systems Manager Change Calendar][1].
999
+ # [Amazon Web Services Systems Manager Change Calendar][1] in the
1000
+ # *Amazon Web Services Systems Manager User Guide*.
944
1001
  #
945
1002
  #
946
1003
  #
@@ -1054,6 +1111,16 @@ module Aws::SSM
1054
1111
  # },
1055
1112
  # ],
1056
1113
  # },
1114
+ # include_child_organization_units: false,
1115
+ # exclude_accounts: ["ExcludeAccount"],
1116
+ # targets: [
1117
+ # {
1118
+ # key: "TargetKey",
1119
+ # values: ["TargetValue"],
1120
+ # },
1121
+ # ],
1122
+ # targets_max_concurrency: "MaxConcurrency",
1123
+ # targets_max_errors: "MaxErrors",
1057
1124
  # },
1058
1125
  # ],
1059
1126
  # schedule_offset: 1,
@@ -1129,6 +1196,15 @@ module Aws::SSM
1129
1196
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
1130
1197
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
1131
1198
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
1199
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
1200
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
1201
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
1202
+ # resp.association_description.target_locations[0].targets #=> Array
1203
+ # resp.association_description.target_locations[0].targets[0].key #=> String
1204
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
1205
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
1206
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
1207
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
1132
1208
  # resp.association_description.schedule_offset #=> Integer
1133
1209
  # resp.association_description.duration #=> Integer
1134
1210
  # resp.association_description.target_maps #=> Array
@@ -1219,6 +1295,16 @@ module Aws::SSM
1219
1295
  # },
1220
1296
  # ],
1221
1297
  # },
1298
+ # include_child_organization_units: false,
1299
+ # exclude_accounts: ["ExcludeAccount"],
1300
+ # targets: [
1301
+ # {
1302
+ # key: "TargetKey",
1303
+ # values: ["TargetValue"],
1304
+ # },
1305
+ # ],
1306
+ # targets_max_concurrency: "MaxConcurrency",
1307
+ # targets_max_errors: "MaxErrors",
1222
1308
  # },
1223
1309
  # ],
1224
1310
  # schedule_offset: 1,
@@ -1291,6 +1377,15 @@ module Aws::SSM
1291
1377
  # resp.successful[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
1292
1378
  # resp.successful[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
1293
1379
  # resp.successful[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
1380
+ # resp.successful[0].target_locations[0].include_child_organization_units #=> Boolean
1381
+ # resp.successful[0].target_locations[0].exclude_accounts #=> Array
1382
+ # resp.successful[0].target_locations[0].exclude_accounts[0] #=> String
1383
+ # resp.successful[0].target_locations[0].targets #=> Array
1384
+ # resp.successful[0].target_locations[0].targets[0].key #=> String
1385
+ # resp.successful[0].target_locations[0].targets[0].values #=> Array
1386
+ # resp.successful[0].target_locations[0].targets[0].values[0] #=> String
1387
+ # resp.successful[0].target_locations[0].targets_max_concurrency #=> String
1388
+ # resp.successful[0].target_locations[0].targets_max_errors #=> String
1294
1389
  # resp.successful[0].schedule_offset #=> Integer
1295
1390
  # resp.successful[0].duration #=> Integer
1296
1391
  # resp.successful[0].target_maps #=> Array
@@ -1338,6 +1433,15 @@ module Aws::SSM
1338
1433
  # resp.failed[0].entry.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
1339
1434
  # resp.failed[0].entry.target_locations[0].target_location_alarm_configuration.alarms #=> Array
1340
1435
  # resp.failed[0].entry.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
1436
+ # resp.failed[0].entry.target_locations[0].include_child_organization_units #=> Boolean
1437
+ # resp.failed[0].entry.target_locations[0].exclude_accounts #=> Array
1438
+ # resp.failed[0].entry.target_locations[0].exclude_accounts[0] #=> String
1439
+ # resp.failed[0].entry.target_locations[0].targets #=> Array
1440
+ # resp.failed[0].entry.target_locations[0].targets[0].key #=> String
1441
+ # resp.failed[0].entry.target_locations[0].targets[0].values #=> Array
1442
+ # resp.failed[0].entry.target_locations[0].targets[0].values[0] #=> String
1443
+ # resp.failed[0].entry.target_locations[0].targets_max_concurrency #=> String
1444
+ # resp.failed[0].entry.target_locations[0].targets_max_errors #=> String
1341
1445
  # resp.failed[0].entry.schedule_offset #=> Integer
1342
1446
  # resp.failed[0].entry.duration #=> Integer
1343
1447
  # resp.failed[0].entry.target_maps #=> Array
@@ -1368,7 +1472,7 @@ module Aws::SSM
1368
1472
  #
1369
1473
  #
1370
1474
  #
1371
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-ssm-docs.html
1475
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html
1372
1476
  #
1373
1477
  # @option params [required, String] :content
1374
1478
  # The content for the new SSM document in JSON or YAML format. The
@@ -1506,7 +1610,7 @@ module Aws::SSM
1506
1610
  # name: "DocumentName", # required
1507
1611
  # display_name: "DocumentDisplayName",
1508
1612
  # version_name: "DocumentVersionName",
1509
- # document_type: "Command", # accepts Command, Policy, Automation, Session, Package, ApplicationConfiguration, ApplicationConfigurationSchema, DeploymentStrategy, ChangeCalendar, Automation.ChangeTemplate, ProblemAnalysis, ProblemAnalysisTemplate, CloudFormation, ConformancePackTemplate, QuickSetup
1613
+ # document_type: "Command", # accepts Command, Policy, Automation, Session, Package, ApplicationConfiguration, ApplicationConfigurationSchema, DeploymentStrategy, ChangeCalendar, Automation.ChangeTemplate, ProblemAnalysis, ProblemAnalysisTemplate, CloudFormation, ConformancePackTemplate, QuickSetup, ManualApprovalPolicy, AutoApprovalPolicy
1510
1614
  # document_format: "YAML", # accepts YAML, JSON, TEXT
1511
1615
  # target_type: "TargetType",
1512
1616
  # tags: [
@@ -1538,7 +1642,7 @@ module Aws::SSM
1538
1642
  # resp.document_description.parameters[0].default_value #=> String
1539
1643
  # resp.document_description.platform_types #=> Array
1540
1644
  # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
1541
- # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup"
1645
+ # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup", "ManualApprovalPolicy", "AutoApprovalPolicy"
1542
1646
  # resp.document_description.schema_version #=> String
1543
1647
  # resp.document_description.latest_version #=> String
1544
1648
  # resp.document_description.default_version #=> String
@@ -1996,6 +2100,10 @@ module Aws::SSM
1996
2100
  # @option params [Types::PatchFilterGroup] :global_filters
1997
2101
  # A set of global filters used to include patches in the baseline.
1998
2102
  #
2103
+ # The `GlobalFilters` parameter can be configured only by using the CLI
2104
+ # or an Amazon Web Services SDK. It can't be configured from the Patch
2105
+ # Manager console, and its value isn't displayed in the console.
2106
+ #
1999
2107
  # @option params [Types::PatchRuleGroup] :approval_rules
2000
2108
  # A set of rules used to include patches in the baseline.
2001
2109
  #
@@ -2003,7 +2111,7 @@ module Aws::SSM
2003
2111
  # A list of explicitly approved patches for the baseline.
2004
2112
  #
2005
2113
  # For information about accepted formats for lists of approved patches
2006
- # and rejected patches, see [About package name formats for approved and
2114
+ # and rejected patches, see [Package name formats for approved and
2007
2115
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
2008
2116
  # User Guide*.
2009
2117
  #
@@ -2025,7 +2133,7 @@ module Aws::SSM
2025
2133
  # A list of explicitly rejected patches for the baseline.
2026
2134
  #
2027
2135
  # For information about accepted formats for lists of approved patches
2028
- # and rejected patches, see [About package name formats for approved and
2136
+ # and rejected patches, see [Package name formats for approved and
2029
2137
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
2030
2138
  # User Guide*.
2031
2139
  #
@@ -2037,19 +2145,28 @@ module Aws::SSM
2037
2145
  # The action for Patch Manager to take on patches included in the
2038
2146
  # `RejectedPackages` list.
2039
2147
  #
2040
- # * <b> <code>ALLOW_AS_DEPENDENCY</code> </b>: A package in the
2041
- # `Rejected` patches list is installed only if it is a dependency of
2042
- # another package. It is considered compliant with the patch baseline,
2043
- # and its status is reported as `InstalledOther`. This is the default
2044
- # action if no option is specified.
2148
+ # ALLOW\_AS\_DEPENDENCY
2149
+ #
2150
+ # : **Linux and macOS**: A package in the rejected patches list is
2151
+ # installed only if it is a dependency of another package. It is
2152
+ # considered compliant with the patch baseline, and its status is
2153
+ # reported as `INSTALLED_OTHER`. This is the default action if no
2154
+ # option is specified.
2045
2155
  #
2046
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
2156
+ # **Windows Server**: Windows Server doesn't support the concept of
2157
+ # package dependencies. If a package in the rejected patches list and
2158
+ # already installed on the node, its status is reported as
2159
+ # `INSTALLED_OTHER`. Any package not already installed on the node is
2160
+ # skipped. This is the default action if no option is specified.
2161
+ #
2162
+ # BLOCK
2163
+ #
2164
+ # : **All OSs**: Packages in the rejected patches list, and packages
2047
2165
  # that include them as dependencies, aren't installed by Patch
2048
2166
  # Manager under any circumstances. If a package was installed before
2049
- # it was added to the **Rejected patches** list, or is installed
2050
- # outside of Patch Manager afterward, it's considered noncompliant
2051
- # with the patch baseline and its status is reported as
2052
- # *InstalledRejected*.
2167
+ # it was added to the rejected patches list, or is installed outside
2168
+ # of Patch Manager afterward, it's considered noncompliant with the
2169
+ # patch baseline and its status is reported as `INSTALLED_REJECTED`.
2053
2170
  #
2054
2171
  # @option params [String] :description
2055
2172
  # A description of the patch baseline.
@@ -2059,6 +2176,20 @@ module Aws::SSM
2059
2176
  # including target operating systems and source repositories. Applies to
2060
2177
  # Linux managed nodes only.
2061
2178
  #
2179
+ # @option params [String] :available_security_updates_compliance_status
2180
+ # Indicates the status you want to assign to security patches that are
2181
+ # available but not approved because they don't meet the installation
2182
+ # criteria specified in the patch baseline.
2183
+ #
2184
+ # Example scenario: Security patches that you might want installed can
2185
+ # be skipped if you have specified a long period to wait after a patch
2186
+ # is released before installation. If an update to the patch is released
2187
+ # during your specified waiting period, the waiting period for
2188
+ # installing the patch starts over. If the waiting period is too long,
2189
+ # multiple versions of the patch could be released but never installed.
2190
+ #
2191
+ # Supported for Windows Server managed nodes only.
2192
+ #
2062
2193
  # @option params [String] :client_token
2063
2194
  # User-provided idempotency token.
2064
2195
  #
@@ -2130,6 +2261,7 @@ module Aws::SSM
2130
2261
  # configuration: "PatchSourceConfiguration", # required
2131
2262
  # },
2132
2263
  # ],
2264
+ # available_security_updates_compliance_status: "COMPLIANT", # accepts COMPLIANT, NON_COMPLIANT
2133
2265
  # client_token: "ClientToken",
2134
2266
  # tags: [
2135
2267
  # {
@@ -2159,7 +2291,7 @@ module Aws::SSM
2159
2291
  # You can configure Systems Manager Inventory to use the
2160
2292
  # `SyncToDestination` type to synchronize Inventory data from multiple
2161
2293
  # Amazon Web Services Regions to a single Amazon Simple Storage Service
2162
- # (Amazon S3) bucket. For more information, see [Configuring resource
2294
+ # (Amazon S3) bucket. For more information, see [Creating a resource
2163
2295
  # data sync for Inventory][1] in the *Amazon Web Services Systems
2164
2296
  # Manager User Guide*.
2165
2297
  #
@@ -2187,7 +2319,7 @@ module Aws::SSM
2187
2319
  #
2188
2320
  #
2189
2321
  #
2190
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-datasync.html
2322
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-create-resource-data-sync.html
2191
2323
  # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/Explorer-resource-data-sync.html
2192
2324
  #
2193
2325
  # @option params [required, String] :sync_name
@@ -2715,9 +2847,20 @@ module Aws::SSM
2715
2847
  end
2716
2848
 
2717
2849
  # Removes the server or virtual machine from the list of registered
2718
- # servers. You can reregister the node again at any time. If you don't
2719
- # plan to use Run Command on the server, we suggest uninstalling SSM
2720
- # Agent first.
2850
+ # servers.
2851
+ #
2852
+ # If you want to reregister an on-premises server, edge device, or VM,
2853
+ # you must use a different Activation Code and Activation ID than used
2854
+ # to register the machine previously. The Activation Code and Activation
2855
+ # ID must not have already been used on the maximum number of
2856
+ # activations specified when they were created. For more information,
2857
+ # see [Deregistering managed nodes in a hybrid and multicloud
2858
+ # environment][1] in the *Amazon Web Services Systems Manager User
2859
+ # Guide*.
2860
+ #
2861
+ #
2862
+ #
2863
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/fleet-manager-deregister-hybrid-nodes.html
2721
2864
  #
2722
2865
  # @option params [required, String] :instance_id
2723
2866
  # The ID assigned to the managed node when you registered it using the
@@ -2995,6 +3138,15 @@ module Aws::SSM
2995
3138
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
2996
3139
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
2997
3140
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
3141
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
3142
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
3143
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
3144
+ # resp.association_description.target_locations[0].targets #=> Array
3145
+ # resp.association_description.target_locations[0].targets[0].key #=> String
3146
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
3147
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
3148
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
3149
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
2998
3150
  # resp.association_description.schedule_offset #=> Integer
2999
3151
  # resp.association_description.duration #=> Integer
3000
3152
  # resp.association_description.target_maps #=> Array
@@ -3243,7 +3395,8 @@ module Aws::SSM
3243
3395
  # resp.automation_execution_metadata_list[0].triggered_alarms #=> Array
3244
3396
  # resp.automation_execution_metadata_list[0].triggered_alarms[0].name #=> String
3245
3397
  # resp.automation_execution_metadata_list[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
3246
- # resp.automation_execution_metadata_list[0].automation_subtype #=> String, one of "ChangeRequest"
3398
+ # resp.automation_execution_metadata_list[0].target_locations_url #=> String
3399
+ # resp.automation_execution_metadata_list[0].automation_subtype #=> String, one of "ChangeRequest", "AccessRequest"
3247
3400
  # resp.automation_execution_metadata_list[0].scheduled_time #=> Time
3248
3401
  # resp.automation_execution_metadata_list[0].runbooks #=> Array
3249
3402
  # resp.automation_execution_metadata_list[0].runbooks[0].document_name #=> String
@@ -3273,6 +3426,15 @@ module Aws::SSM
3273
3426
  # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
3274
3427
  # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
3275
3428
  # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
3429
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].include_child_organization_units #=> Boolean
3430
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].exclude_accounts #=> Array
3431
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].exclude_accounts[0] #=> String
3432
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets #=> Array
3433
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets[0].key #=> String
3434
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets[0].values #=> Array
3435
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets[0].values[0] #=> String
3436
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets_max_concurrency #=> String
3437
+ # resp.automation_execution_metadata_list[0].runbooks[0].target_locations[0].targets_max_errors #=> String
3276
3438
  # resp.automation_execution_metadata_list[0].ops_item_id #=> String
3277
3439
  # resp.automation_execution_metadata_list[0].association_id #=> String
3278
3440
  # resp.automation_execution_metadata_list[0].change_request_name #=> String
@@ -3380,6 +3542,15 @@ module Aws::SSM
3380
3542
  # resp.step_executions[0].target_location.target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
3381
3543
  # resp.step_executions[0].target_location.target_location_alarm_configuration.alarms #=> Array
3382
3544
  # resp.step_executions[0].target_location.target_location_alarm_configuration.alarms[0].name #=> String
3545
+ # resp.step_executions[0].target_location.include_child_organization_units #=> Boolean
3546
+ # resp.step_executions[0].target_location.exclude_accounts #=> Array
3547
+ # resp.step_executions[0].target_location.exclude_accounts[0] #=> String
3548
+ # resp.step_executions[0].target_location.targets #=> Array
3549
+ # resp.step_executions[0].target_location.targets[0].key #=> String
3550
+ # resp.step_executions[0].target_location.targets[0].values #=> Array
3551
+ # resp.step_executions[0].target_location.targets[0].values[0] #=> String
3552
+ # resp.step_executions[0].target_location.targets_max_concurrency #=> String
3553
+ # resp.step_executions[0].target_location.targets_max_errors #=> String
3383
3554
  # resp.step_executions[0].triggered_alarms #=> Array
3384
3555
  # resp.step_executions[0].triggered_alarms[0].name #=> String
3385
3556
  # resp.step_executions[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
@@ -3573,6 +3744,12 @@ module Aws::SSM
3573
3744
  # @option params [required, String] :name
3574
3745
  # The name of the SSM document.
3575
3746
  #
3747
+ # <note markdown="1"> If you're calling a shared SSM document from a different Amazon Web
3748
+ # Services account, `Name` is the full Amazon Resource Name (ARN) of the
3749
+ # document.
3750
+ #
3751
+ # </note>
3752
+ #
3576
3753
  # @option params [String] :document_version
3577
3754
  # The document version for which you want information. Can be a specific
3578
3755
  # version or the default version.
@@ -3615,7 +3792,7 @@ module Aws::SSM
3615
3792
  # resp.document.parameters[0].default_value #=> String
3616
3793
  # resp.document.platform_types #=> Array
3617
3794
  # resp.document.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
3618
- # resp.document.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup"
3795
+ # resp.document.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup", "ManualApprovalPolicy", "AutoApprovalPolicy"
3619
3796
  # resp.document.schema_version #=> String
3620
3797
  # resp.document.latest_version #=> String
3621
3798
  # resp.document.default_version #=> String
@@ -3893,9 +4070,10 @@ module Aws::SSM
3893
4070
  # information for all your managed nodes. If you specify a node ID that
3894
4071
  # isn't valid or a node that you don't own, you receive an error.
3895
4072
  #
3896
- # <note markdown="1"> The `IamRole` field returned for this API operation is the Identity
3897
- # and Access Management (IAM) role assigned to on-premises managed
3898
- # nodes. This operation does not return the IAM role for EC2 instances.
4073
+ # <note markdown="1"> The `IamRole` field returned for this API operation is the role
4074
+ # assigned to an Amazon EC2 instance configured with a Systems Manager
4075
+ # Quick Setup host management configuration or the role assigned to an
4076
+ # on-premises managed node.
3899
4077
  #
3900
4078
  # </note>
3901
4079
  #
@@ -4033,6 +4211,7 @@ module Aws::SSM
4033
4211
  # resp.instance_patch_states[0].failed_count #=> Integer
4034
4212
  # resp.instance_patch_states[0].unreported_not_applicable_count #=> Integer
4035
4213
  # resp.instance_patch_states[0].not_applicable_count #=> Integer
4214
+ # resp.instance_patch_states[0].available_security_update_count #=> Integer
4036
4215
  # resp.instance_patch_states[0].operation_start_time #=> Time
4037
4216
  # resp.instance_patch_states[0].operation_end_time #=> Time
4038
4217
  # resp.instance_patch_states[0].operation #=> String, one of "Scan", "Install"
@@ -4114,6 +4293,7 @@ module Aws::SSM
4114
4293
  # resp.instance_patch_states[0].failed_count #=> Integer
4115
4294
  # resp.instance_patch_states[0].unreported_not_applicable_count #=> Integer
4116
4295
  # resp.instance_patch_states[0].not_applicable_count #=> Integer
4296
+ # resp.instance_patch_states[0].available_security_update_count #=> Integer
4117
4297
  # resp.instance_patch_states[0].operation_start_time #=> Time
4118
4298
  # resp.instance_patch_states[0].operation_end_time #=> Time
4119
4299
  # resp.instance_patch_states[0].operation #=> String, one of "Scan", "Install"
@@ -4163,9 +4343,8 @@ module Aws::SSM
4163
4343
  # Sample values: `Installed` \| `InstalledOther` \|
4164
4344
  # `InstalledPendingReboot`
4165
4345
  #
4166
- # For lists of all `State` values, see [Understanding patch compliance
4167
- # state values][1] in the *Amazon Web Services Systems Manager User
4168
- # Guide*.
4346
+ # For lists of all `State` values, see [Patch compliance state
4347
+ # values][1] in the *Amazon Web Services Systems Manager User Guide*.
4169
4348
  #
4170
4349
  #
4171
4350
  #
@@ -4206,7 +4385,7 @@ module Aws::SSM
4206
4385
  # resp.patches[0].kb_id #=> String
4207
4386
  # resp.patches[0].classification #=> String
4208
4387
  # resp.patches[0].severity #=> String
4209
- # resp.patches[0].state #=> String, one of "INSTALLED", "INSTALLED_OTHER", "INSTALLED_PENDING_REBOOT", "INSTALLED_REJECTED", "MISSING", "NOT_APPLICABLE", "FAILED"
4388
+ # resp.patches[0].state #=> String, one of "INSTALLED", "INSTALLED_OTHER", "INSTALLED_PENDING_REBOOT", "INSTALLED_REJECTED", "MISSING", "NOT_APPLICABLE", "FAILED", "AVAILABLE_SECURITY_UPDATE"
4210
4389
  # resp.patches[0].installed_time #=> Time
4211
4390
  # resp.patches[0].cve_ids #=> String
4212
4391
  # resp.next_token #=> String
@@ -4523,7 +4702,7 @@ module Aws::SSM
4523
4702
  #
4524
4703
  # * Values. An array of strings, each between 1 and 256 characters.
4525
4704
  # Supported values are date/time strings in a valid ISO 8601 date/time
4526
- # format, such as `2021-11-04T05:00:00Z`.
4705
+ # format, such as `2024-11-04T05:00:00Z`.
4527
4706
  #
4528
4707
  # @option params [Integer] :max_results
4529
4708
  # The maximum number of items to return for this call. The call also
@@ -4997,7 +5176,7 @@ module Aws::SSM
4997
5176
  #
4998
5177
  # **If you filter the response by using the OperationalData operator,
4999
5178
  # specify a key-value pair by using the following JSON format:
5000
- # \\\{"key":"key\_name","value":"a\_value"\\}
5179
+ # \{"key":"key\_name","value":"a\_value"}
5001
5180
  #
5002
5181
  # @option params [Integer] :max_results
5003
5182
  # The maximum number of items to return for this call. The call also
@@ -5020,7 +5199,7 @@ module Aws::SSM
5020
5199
  # resp = client.describe_ops_items({
5021
5200
  # ops_item_filters: [
5022
5201
  # {
5023
- # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, ActualStartTime, ActualEndTime, PlannedStartTime, PlannedEndTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity, OpsItemType, ChangeRequestByRequesterArn, ChangeRequestByRequesterName, ChangeRequestByApproverArn, ChangeRequestByApproverName, ChangeRequestByTemplate, ChangeRequestByTargetsResourceGroup, InsightByType, AccountId
5202
+ # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, ActualStartTime, ActualEndTime, PlannedStartTime, PlannedEndTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity, OpsItemType, AccessRequestByRequesterArn, AccessRequestByRequesterId, AccessRequestByApproverArn, AccessRequestByApproverId, AccessRequestBySourceAccountId, AccessRequestBySourceOpsItemId, AccessRequestBySourceRegion, AccessRequestByIsReplica, AccessRequestByTargetResourceId, ChangeRequestByRequesterArn, ChangeRequestByRequesterName, ChangeRequestByApproverArn, ChangeRequestByApproverName, ChangeRequestByTemplate, ChangeRequestByTargetsResourceGroup, InsightByType, AccountId
5024
5203
  # values: ["OpsItemFilterValue"], # required
5025
5204
  # operator: "Equal", # required, accepts Equal, Contains, GreaterThan, LessThan
5026
5205
  # },
@@ -5039,7 +5218,7 @@ module Aws::SSM
5039
5218
  # resp.ops_item_summaries[0].last_modified_time #=> Time
5040
5219
  # resp.ops_item_summaries[0].priority #=> Integer
5041
5220
  # resp.ops_item_summaries[0].source #=> String
5042
- # resp.ops_item_summaries[0].status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Rejected", "Closed"
5221
+ # resp.ops_item_summaries[0].status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Revoked", "Rejected", "Closed"
5043
5222
  # resp.ops_item_summaries[0].ops_item_id #=> String
5044
5223
  # resp.ops_item_summaries[0].title #=> String
5045
5224
  # resp.ops_item_summaries[0].operational_data #=> Hash
@@ -5262,6 +5441,7 @@ module Aws::SSM
5262
5441
  # * {Types::DescribePatchGroupStateResult#instances_with_critical_non_compliant_patches #instances_with_critical_non_compliant_patches} => Integer
5263
5442
  # * {Types::DescribePatchGroupStateResult#instances_with_security_non_compliant_patches #instances_with_security_non_compliant_patches} => Integer
5264
5443
  # * {Types::DescribePatchGroupStateResult#instances_with_other_non_compliant_patches #instances_with_other_non_compliant_patches} => Integer
5444
+ # * {Types::DescribePatchGroupStateResult#instances_with_available_security_updates #instances_with_available_security_updates} => Integer
5265
5445
  #
5266
5446
  # @example Request syntax with placeholder values
5267
5447
  #
@@ -5283,6 +5463,7 @@ module Aws::SSM
5283
5463
  # resp.instances_with_critical_non_compliant_patches #=> Integer
5284
5464
  # resp.instances_with_security_non_compliant_patches #=> Integer
5285
5465
  # resp.instances_with_other_non_compliant_patches #=> Integer
5466
+ # resp.instances_with_available_security_updates #=> Integer
5286
5467
  #
5287
5468
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupState AWS API Documentation
5288
5469
  #
@@ -5373,6 +5554,10 @@ module Aws::SSM
5373
5554
  #
5374
5555
  # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
5375
5556
  #
5557
+ # AMAZON\_LINUX\_2023
5558
+ #
5559
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
5560
+ #
5376
5561
  # CENTOS
5377
5562
  #
5378
5563
  # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
@@ -5494,7 +5679,7 @@ module Aws::SSM
5494
5679
  # next_token: "NextToken",
5495
5680
  # filters: [
5496
5681
  # {
5497
- # key: "InvokedAfter", # required, accepts InvokedAfter, InvokedBefore, Target, Owner, Status, SessionId
5682
+ # key: "InvokedAfter", # required, accepts InvokedAfter, InvokedBefore, Target, Owner, Status, SessionId, AccessType
5498
5683
  # value: "SessionFilterValue", # required
5499
5684
  # },
5500
5685
  # ],
@@ -5515,6 +5700,7 @@ module Aws::SSM
5515
5700
  # resp.sessions[0].output_url.s3_output_url #=> String
5516
5701
  # resp.sessions[0].output_url.cloud_watch_output_url #=> String
5517
5702
  # resp.sessions[0].max_session_duration #=> String
5703
+ # resp.sessions[0].access_type #=> String, one of "Standard", "JustInTime"
5518
5704
  # resp.next_token #=> String
5519
5705
  #
5520
5706
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeSessions AWS API Documentation
@@ -5528,8 +5714,8 @@ module Aws::SSM
5528
5714
 
5529
5715
  # Deletes the association between an OpsItem and a related item. For
5530
5716
  # example, this API operation can delete an Incident Manager incident
5531
- # from an OpsItem. Incident Manager is a capability of Amazon Web
5532
- # Services Systems Manager.
5717
+ # from an OpsItem. Incident Manager is a tool in Amazon Web Services
5718
+ # Systems Manager.
5533
5719
  #
5534
5720
  # @option params [required, String] :ops_item_id
5535
5721
  # The ID of the OpsItem for which you want to delete an association
@@ -5557,6 +5743,39 @@ module Aws::SSM
5557
5743
  req.send_request(options)
5558
5744
  end
5559
5745
 
5746
+ # Returns a credentials set to be used with just-in-time node access.
5747
+ #
5748
+ # @option params [required, String] :access_request_id
5749
+ # The ID of a just-in-time node access request.
5750
+ #
5751
+ # @return [Types::GetAccessTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5752
+ #
5753
+ # * {Types::GetAccessTokenResponse#credentials #credentials} => Types::Credentials
5754
+ # * {Types::GetAccessTokenResponse#access_request_status #access_request_status} => String
5755
+ #
5756
+ # @example Request syntax with placeholder values
5757
+ #
5758
+ # resp = client.get_access_token({
5759
+ # access_request_id: "AccessRequestId", # required
5760
+ # })
5761
+ #
5762
+ # @example Response structure
5763
+ #
5764
+ # resp.credentials.access_key_id #=> String
5765
+ # resp.credentials.secret_access_key #=> String
5766
+ # resp.credentials.session_token #=> String
5767
+ # resp.credentials.expiration_time #=> Time
5768
+ # resp.access_request_status #=> String, one of "Approved", "Rejected", "Revoked", "Expired", "Pending"
5769
+ #
5770
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAccessToken AWS API Documentation
5771
+ #
5772
+ # @overload get_access_token(params = {})
5773
+ # @param [Hash] params ({})
5774
+ def get_access_token(params = {}, options = {})
5775
+ req = build_request(:get_access_token, params)
5776
+ req.send_request(options)
5777
+ end
5778
+
5560
5779
  # Get detailed information about a particular Automation execution.
5561
5780
  #
5562
5781
  # @option params [required, String] :automation_execution_id
@@ -5627,6 +5846,15 @@ module Aws::SSM
5627
5846
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5628
5847
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.alarms #=> Array
5629
5848
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.alarms[0].name #=> String
5849
+ # resp.automation_execution.step_executions[0].target_location.include_child_organization_units #=> Boolean
5850
+ # resp.automation_execution.step_executions[0].target_location.exclude_accounts #=> Array
5851
+ # resp.automation_execution.step_executions[0].target_location.exclude_accounts[0] #=> String
5852
+ # resp.automation_execution.step_executions[0].target_location.targets #=> Array
5853
+ # resp.automation_execution.step_executions[0].target_location.targets[0].key #=> String
5854
+ # resp.automation_execution.step_executions[0].target_location.targets[0].values #=> Array
5855
+ # resp.automation_execution.step_executions[0].target_location.targets[0].values[0] #=> String
5856
+ # resp.automation_execution.step_executions[0].target_location.targets_max_concurrency #=> String
5857
+ # resp.automation_execution.step_executions[0].target_location.targets_max_errors #=> String
5630
5858
  # resp.automation_execution.step_executions[0].triggered_alarms #=> Array
5631
5859
  # resp.automation_execution.step_executions[0].triggered_alarms[0].name #=> String
5632
5860
  # resp.automation_execution.step_executions[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
@@ -5674,6 +5902,15 @@ module Aws::SSM
5674
5902
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5675
5903
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.alarms #=> Array
5676
5904
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
5905
+ # resp.automation_execution.target_locations[0].include_child_organization_units #=> Boolean
5906
+ # resp.automation_execution.target_locations[0].exclude_accounts #=> Array
5907
+ # resp.automation_execution.target_locations[0].exclude_accounts[0] #=> String
5908
+ # resp.automation_execution.target_locations[0].targets #=> Array
5909
+ # resp.automation_execution.target_locations[0].targets[0].key #=> String
5910
+ # resp.automation_execution.target_locations[0].targets[0].values #=> Array
5911
+ # resp.automation_execution.target_locations[0].targets[0].values[0] #=> String
5912
+ # resp.automation_execution.target_locations[0].targets_max_concurrency #=> String
5913
+ # resp.automation_execution.target_locations[0].targets_max_errors #=> String
5677
5914
  # resp.automation_execution.progress_counters.total_steps #=> Integer
5678
5915
  # resp.automation_execution.progress_counters.success_steps #=> Integer
5679
5916
  # resp.automation_execution.progress_counters.failed_steps #=> Integer
@@ -5685,7 +5922,8 @@ module Aws::SSM
5685
5922
  # resp.automation_execution.triggered_alarms #=> Array
5686
5923
  # resp.automation_execution.triggered_alarms[0].name #=> String
5687
5924
  # resp.automation_execution.triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
5688
- # resp.automation_execution.automation_subtype #=> String, one of "ChangeRequest"
5925
+ # resp.automation_execution.target_locations_url #=> String
5926
+ # resp.automation_execution.automation_subtype #=> String, one of "ChangeRequest", "AccessRequest"
5689
5927
  # resp.automation_execution.scheduled_time #=> Time
5690
5928
  # resp.automation_execution.runbooks #=> Array
5691
5929
  # resp.automation_execution.runbooks[0].document_name #=> String
@@ -5715,6 +5953,15 @@ module Aws::SSM
5715
5953
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5716
5954
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
5717
5955
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
5956
+ # resp.automation_execution.runbooks[0].target_locations[0].include_child_organization_units #=> Boolean
5957
+ # resp.automation_execution.runbooks[0].target_locations[0].exclude_accounts #=> Array
5958
+ # resp.automation_execution.runbooks[0].target_locations[0].exclude_accounts[0] #=> String
5959
+ # resp.automation_execution.runbooks[0].target_locations[0].targets #=> Array
5960
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].key #=> String
5961
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].values #=> Array
5962
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].values[0] #=> String
5963
+ # resp.automation_execution.runbooks[0].target_locations[0].targets_max_concurrency #=> String
5964
+ # resp.automation_execution.runbooks[0].target_locations[0].targets_max_errors #=> String
5718
5965
  # resp.automation_execution.ops_item_id #=> String
5719
5966
  # resp.automation_execution.association_id #=> String
5720
5967
  # resp.automation_execution.change_request_name #=> String
@@ -5744,7 +5991,7 @@ module Aws::SSM
5744
5991
  # open. If one or more calendars in the request are closed, the status
5745
5992
  # returned is `CLOSED`.
5746
5993
  #
5747
- # For more information about Change Calendar, a capability of Amazon Web
5994
+ # For more information about Change Calendar, a tool in Amazon Web
5748
5995
  # Services Systems Manager, see [Amazon Web Services Systems Manager
5749
5996
  # Change Calendar][1] in the *Amazon Web Services Systems Manager User
5750
5997
  # Guide*.
@@ -5754,7 +6001,7 @@ module Aws::SSM
5754
6001
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html
5755
6002
  #
5756
6003
  # @option params [required, Array<String>] :calendar_names
5757
- # The names or Amazon Resource Names (ARNs) of the Systems Manager
6004
+ # The names of Amazon Resource Names (ARNs) of the Systems Manager
5758
6005
  # documents (SSM documents) that represent the calendar entries for
5759
6006
  # which you want to get the state.
5760
6007
  #
@@ -5796,7 +6043,12 @@ module Aws::SSM
5796
6043
  end
5797
6044
 
5798
6045
  # Returns detailed information about command execution for an invocation
5799
- # or plugin.
6046
+ # or plugin. The Run Command API follows an eventual consistency model,
6047
+ # due to the distributed nature of the system supporting the API. This
6048
+ # means that the result of an API command you run that affects your
6049
+ # resources might not be immediately visible to all subsequent commands
6050
+ # you run. You should keep this in mind when you carry out an API
6051
+ # command that immediately follows a previous API command.
5800
6052
  #
5801
6053
  # `GetCommandInvocation` only gives the execution status of a plugin in
5802
6054
  # a document. To get the command execution status on a specific managed
@@ -5966,8 +6218,8 @@ module Aws::SSM
5966
6218
  # Interface (CLI), the system attempts to use your local Amazon Web
5967
6219
  # Services credentials and the operation fails. To avoid this, you can
5968
6220
  # run the command in the Amazon Web Services Systems Manager console.
5969
- # Use Run Command, a capability of Amazon Web Services Systems Manager,
5970
- # with an SSM document that enables you to target a managed node with a
6221
+ # Use Run Command, a tool in Amazon Web Services Systems Manager, with
6222
+ # an SSM document that enables you to target a managed node with a
5971
6223
  # script or command. For example, run the command using the
5972
6224
  # `AWS-RunShellScript` document or the `AWS-RunPowerShellScript`
5973
6225
  # document.
@@ -6037,6 +6289,7 @@ module Aws::SSM
6037
6289
  # configuration: "PatchSourceConfiguration", # required
6038
6290
  # },
6039
6291
  # ],
6292
+ # available_security_updates_compliance_status: "COMPLIANT", # accepts COMPLIANT, NON_COMPLIANT
6040
6293
  # },
6041
6294
  # })
6042
6295
  #
@@ -6109,7 +6362,7 @@ module Aws::SSM
6109
6362
  # resp.status #=> String, one of "Creating", "Active", "Updating", "Deleting", "Failed"
6110
6363
  # resp.status_information #=> String
6111
6364
  # resp.content #=> String
6112
- # resp.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup"
6365
+ # resp.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup", "ManualApprovalPolicy", "AutoApprovalPolicy"
6113
6366
  # resp.document_format #=> String, one of "YAML", "JSON", "TEXT"
6114
6367
  # resp.requires #=> Array
6115
6368
  # resp.requires[0].name #=> String
@@ -6133,6 +6386,78 @@ module Aws::SSM
6133
6386
  req.send_request(options)
6134
6387
  end
6135
6388
 
6389
+ # Initiates the process of retrieving an existing preview that shows the
6390
+ # effects that running a specified Automation runbook would have on the
6391
+ # targeted resources.
6392
+ #
6393
+ # @option params [required, String] :execution_preview_id
6394
+ # The ID of the existing execution preview.
6395
+ #
6396
+ # @return [Types::GetExecutionPreviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6397
+ #
6398
+ # * {Types::GetExecutionPreviewResponse#execution_preview_id #execution_preview_id} => String
6399
+ # * {Types::GetExecutionPreviewResponse#ended_at #ended_at} => Time
6400
+ # * {Types::GetExecutionPreviewResponse#status #status} => String
6401
+ # * {Types::GetExecutionPreviewResponse#status_message #status_message} => String
6402
+ # * {Types::GetExecutionPreviewResponse#execution_preview #execution_preview} => Types::ExecutionPreview
6403
+ #
6404
+ #
6405
+ # @example Example: GetExecutionPreview
6406
+ #
6407
+ # # This example illustrates one usage of GetExecutionPreview
6408
+ #
6409
+ # resp = client.get_execution_preview({
6410
+ # execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
6411
+ # })
6412
+ #
6413
+ # resp.to_h outputs the following:
6414
+ # {
6415
+ # ended_at: Time.parse("2024-11-13T01:50:39.424000+00:00"),
6416
+ # execution_preview: {
6417
+ # automation: {
6418
+ # regions: [
6419
+ # "us-east-2",
6420
+ # ],
6421
+ # step_previews: {
6422
+ # "Undetermined" => 1,
6423
+ # },
6424
+ # total_accounts: 1,
6425
+ # },
6426
+ # },
6427
+ # execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
6428
+ # status: "Success",
6429
+ # }
6430
+ #
6431
+ # @example Request syntax with placeholder values
6432
+ #
6433
+ # resp = client.get_execution_preview({
6434
+ # execution_preview_id: "ExecutionPreviewId", # required
6435
+ # })
6436
+ #
6437
+ # @example Response structure
6438
+ #
6439
+ # resp.execution_preview_id #=> String
6440
+ # resp.ended_at #=> Time
6441
+ # resp.status #=> String, one of "Pending", "InProgress", "Success", "Failed"
6442
+ # resp.status_message #=> String
6443
+ # resp.execution_preview.automation.step_previews #=> Hash
6444
+ # resp.execution_preview.automation.step_previews["ImpactType"] #=> Integer
6445
+ # resp.execution_preview.automation.regions #=> Array
6446
+ # resp.execution_preview.automation.regions[0] #=> String
6447
+ # resp.execution_preview.automation.target_previews #=> Array
6448
+ # resp.execution_preview.automation.target_previews[0].count #=> Integer
6449
+ # resp.execution_preview.automation.target_previews[0].target_type #=> String
6450
+ # resp.execution_preview.automation.total_accounts #=> Integer
6451
+ #
6452
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreview AWS API Documentation
6453
+ #
6454
+ # @overload get_execution_preview(params = {})
6455
+ # @param [Hash] params ({})
6456
+ def get_execution_preview(params = {}, options = {})
6457
+ req = build_request(:get_execution_preview, params)
6458
+ req.send_request(options)
6459
+ end
6460
+
6136
6461
  # Query inventory information. This includes managed node status, such
6137
6462
  # as `Stopped` or `Terminated`.
6138
6463
  #
@@ -6669,7 +6994,7 @@ module Aws::SSM
6669
6994
  # resp.ops_item.priority #=> Integer
6670
6995
  # resp.ops_item.related_ops_items #=> Array
6671
6996
  # resp.ops_item.related_ops_items[0].ops_item_id #=> String
6672
- # resp.ops_item.status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Rejected", "Closed"
6997
+ # resp.ops_item.status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Revoked", "Rejected", "Closed"
6673
6998
  # resp.ops_item.ops_item_id #=> String
6674
6999
  # resp.ops_item.version #=> String
6675
7000
  # resp.ops_item.title #=> String
@@ -6857,7 +7182,7 @@ module Aws::SSM
6857
7182
  #
6858
7183
  #
6859
7184
  #
6860
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sharing.html
7185
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
6861
7186
  #
6862
7187
  # @option params [Boolean] :with_decryption
6863
7188
  # Return decrypted values for secure string parameters. This flag is
@@ -7037,8 +7362,8 @@ module Aws::SSM
7037
7362
  req.send_request(options)
7038
7363
  end
7039
7364
 
7040
- # Retrieve information about one or more parameters in a specific
7041
- # hierarchy.
7365
+ # Retrieve information about one or more parameters under a specified
7366
+ # level in a hierarchy.
7042
7367
  #
7043
7368
  # Request results are returned on a best-effort basis. If you specify
7044
7369
  # `MaxResults` in the request, the response includes information up to
@@ -7168,6 +7493,7 @@ module Aws::SSM
7168
7493
  # * {Types::GetPatchBaselineResult#modified_date #modified_date} => Time
7169
7494
  # * {Types::GetPatchBaselineResult#description #description} => String
7170
7495
  # * {Types::GetPatchBaselineResult#sources #sources} => Array&lt;Types::PatchSource&gt;
7496
+ # * {Types::GetPatchBaselineResult#available_security_updates_compliance_status #available_security_updates_compliance_status} => String
7171
7497
  #
7172
7498
  # @example Request syntax with placeholder values
7173
7499
  #
@@ -7210,6 +7536,7 @@ module Aws::SSM
7210
7536
  # resp.sources[0].products #=> Array
7211
7537
  # resp.sources[0].products[0] #=> String
7212
7538
  # resp.sources[0].configuration #=> String
7539
+ # resp.available_security_updates_compliance_status #=> String, one of "COMPLIANT", "NON_COMPLIANT"
7213
7540
  #
7214
7541
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaseline AWS API Documentation
7215
7542
  #
@@ -7329,16 +7656,20 @@ module Aws::SSM
7329
7656
  # The ID of the service setting to get. The setting ID can be one of the
7330
7657
  # following.
7331
7658
  #
7332
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
7659
+ # * `/ssm/appmanager/appmanager-enabled`
7333
7660
  #
7334
7661
  # * `/ssm/automation/customer-script-log-destination`
7335
7662
  #
7336
7663
  # * `/ssm/automation/customer-script-log-group-name`
7337
7664
  #
7665
+ # * /ssm/automation/enable-adaptive-concurrency
7666
+ #
7338
7667
  # * `/ssm/documents/console/public-sharing-permission`
7339
7668
  #
7340
7669
  # * `/ssm/managed-instance/activation-tier`
7341
7670
  #
7671
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
7672
+ #
7342
7673
  # * `/ssm/opsinsights/opscenter`
7343
7674
  #
7344
7675
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -7517,6 +7848,15 @@ module Aws::SSM
7517
7848
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
7518
7849
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
7519
7850
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
7851
+ # resp.association_versions[0].target_locations[0].include_child_organization_units #=> Boolean
7852
+ # resp.association_versions[0].target_locations[0].exclude_accounts #=> Array
7853
+ # resp.association_versions[0].target_locations[0].exclude_accounts[0] #=> String
7854
+ # resp.association_versions[0].target_locations[0].targets #=> Array
7855
+ # resp.association_versions[0].target_locations[0].targets[0].key #=> String
7856
+ # resp.association_versions[0].target_locations[0].targets[0].values #=> Array
7857
+ # resp.association_versions[0].target_locations[0].targets[0].values[0] #=> String
7858
+ # resp.association_versions[0].target_locations[0].targets_max_concurrency #=> String
7859
+ # resp.association_versions[0].target_locations[0].targets_max_errors #=> String
7520
7860
  # resp.association_versions[0].schedule_offset #=> Integer
7521
7861
  # resp.association_versions[0].duration #=> Integer
7522
7862
  # resp.association_versions[0].target_maps #=> Array
@@ -7537,8 +7877,8 @@ module Aws::SSM
7537
7877
  # Returns all State Manager associations in the current Amazon Web
7538
7878
  # Services account and Amazon Web Services Region. You can limit the
7539
7879
  # results to a specific State Manager association document or managed
7540
- # node by specifying a filter. State Manager is a capability of Amazon
7541
- # Web Services Systems Manager.
7880
+ # node by specifying a filter. State Manager is a tool in Amazon Web
7881
+ # Services Systems Manager.
7542
7882
  #
7543
7883
  # @option params [Array<Types::AssociationFilter>] :association_filter_list
7544
7884
  # One or more filters. Use a filter to return a more specific list of
@@ -8149,7 +8489,7 @@ module Aws::SSM
8149
8489
  # resp.document_identifiers[0].platform_types #=> Array
8150
8490
  # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
8151
8491
  # resp.document_identifiers[0].document_version #=> String
8152
- # resp.document_identifiers[0].document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup"
8492
+ # resp.document_identifiers[0].document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup", "ManualApprovalPolicy", "AutoApprovalPolicy"
8153
8493
  # resp.document_identifiers[0].schema_version #=> String
8154
8494
  # resp.document_identifiers[0].document_format #=> String, one of "YAML", "JSON", "TEXT"
8155
8495
  # resp.document_identifiers[0].target_type #=> String
@@ -8240,6 +8580,258 @@ module Aws::SSM
8240
8580
  req.send_request(options)
8241
8581
  end
8242
8582
 
8583
+ # Takes in filters and returns a list of managed nodes matching the
8584
+ # filter criteria.
8585
+ #
8586
+ # @option params [String] :sync_name
8587
+ # The name of the Amazon Web Services managed resource data sync to
8588
+ # retrieve information about.
8589
+ #
8590
+ # For cross-account/cross-Region configurations, this parameter is
8591
+ # required, and the name of the supported resource data sync is
8592
+ # `AWS-QuickSetup-ManagedNode`.
8593
+ #
8594
+ # For single account/single-Region configurations, the parameter is not
8595
+ # required.
8596
+ #
8597
+ # @option params [Array<Types::NodeFilter>] :filters
8598
+ # One or more filters. Use a filter to return a more specific list of
8599
+ # managed nodes.
8600
+ #
8601
+ # @option params [String] :next_token
8602
+ # The token for the next set of items to return. (You received this
8603
+ # token from a previous call.)
8604
+ #
8605
+ # @option params [Integer] :max_results
8606
+ # The maximum number of items to return for this call. The call also
8607
+ # returns a token that you can specify in a subsequent call to get the
8608
+ # next set of results.
8609
+ #
8610
+ # @return [Types::ListNodesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8611
+ #
8612
+ # * {Types::ListNodesResult#nodes #nodes} => Array&lt;Types::Node&gt;
8613
+ # * {Types::ListNodesResult#next_token #next_token} => String
8614
+ #
8615
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8616
+ #
8617
+ #
8618
+ # @example Example: ListNodes
8619
+ #
8620
+ # # This example illustrates one usage of ListNodes
8621
+ #
8622
+ # resp = client.list_nodes({
8623
+ # filters: [
8624
+ # {
8625
+ # key: "Region",
8626
+ # type: "Equal",
8627
+ # values: [
8628
+ # "us-east-2",
8629
+ # ],
8630
+ # },
8631
+ # ],
8632
+ # max_results: 1,
8633
+ # sync_name: "AWS-QuickSetup-ManagedNode",
8634
+ # })
8635
+ #
8636
+ # resp.to_h outputs the following:
8637
+ # {
8638
+ # next_token: "A9lT8CAxj9aDFRi+MNAoFq08IEXAMPLE",
8639
+ # nodes: [
8640
+ # {
8641
+ # capture_time: Time.parse("2024-11-19T22:01:18"),
8642
+ # id: "i-02573cafcfEXAMPLE",
8643
+ # node_type: {
8644
+ # instance: {
8645
+ # agent_type: "amazon-ssm-agent",
8646
+ # agent_version: "3.3.859.0",
8647
+ # computer_name: "ip-192.0.2.0.ec2.internal",
8648
+ # instance_status: "Active",
8649
+ # ip_address: "192.0.2.0",
8650
+ # managed_status: "Managed",
8651
+ # platform_name: "Amazon Linux",
8652
+ # platform_type: "Linux",
8653
+ # platform_version: "2023",
8654
+ # resource_type: "EC2Instance",
8655
+ # },
8656
+ # },
8657
+ # owner: {
8658
+ # account_id: "111122223333",
8659
+ # organizational_unit_id: "ou-b8dn-sasv9tfp",
8660
+ # organizational_unit_path: "r-b8dn/ou-b8dn-sasv9tfp",
8661
+ # },
8662
+ # region: "us-east-2",
8663
+ # },
8664
+ # ],
8665
+ # }
8666
+ #
8667
+ # @example Request syntax with placeholder values
8668
+ #
8669
+ # resp = client.list_nodes({
8670
+ # sync_name: "ResourceDataSyncName",
8671
+ # filters: [
8672
+ # {
8673
+ # key: "AgentType", # required, accepts AgentType, AgentVersion, ComputerName, InstanceId, InstanceStatus, IpAddress, ManagedStatus, PlatformName, PlatformType, PlatformVersion, ResourceType, OrganizationalUnitId, OrganizationalUnitPath, Region, AccountId
8674
+ # values: ["NodeFilterValue"], # required
8675
+ # type: "Equal", # accepts Equal, NotEqual, BeginWith
8676
+ # },
8677
+ # ],
8678
+ # next_token: "NextToken",
8679
+ # max_results: 1,
8680
+ # })
8681
+ #
8682
+ # @example Response structure
8683
+ #
8684
+ # resp.nodes #=> Array
8685
+ # resp.nodes[0].capture_time #=> Time
8686
+ # resp.nodes[0].id #=> String
8687
+ # resp.nodes[0].owner.account_id #=> String
8688
+ # resp.nodes[0].owner.organizational_unit_id #=> String
8689
+ # resp.nodes[0].owner.organizational_unit_path #=> String
8690
+ # resp.nodes[0].region #=> String
8691
+ # resp.nodes[0].node_type.instance.agent_type #=> String
8692
+ # resp.nodes[0].node_type.instance.agent_version #=> String
8693
+ # resp.nodes[0].node_type.instance.computer_name #=> String
8694
+ # resp.nodes[0].node_type.instance.instance_status #=> String
8695
+ # resp.nodes[0].node_type.instance.ip_address #=> String
8696
+ # resp.nodes[0].node_type.instance.managed_status #=> String, one of "All", "Managed", "Unmanaged"
8697
+ # resp.nodes[0].node_type.instance.platform_type #=> String, one of "Windows", "Linux", "MacOS"
8698
+ # resp.nodes[0].node_type.instance.platform_name #=> String
8699
+ # resp.nodes[0].node_type.instance.platform_version #=> String
8700
+ # resp.nodes[0].node_type.instance.resource_type #=> String, one of "ManagedInstance", "EC2Instance"
8701
+ # resp.next_token #=> String
8702
+ #
8703
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodes AWS API Documentation
8704
+ #
8705
+ # @overload list_nodes(params = {})
8706
+ # @param [Hash] params ({})
8707
+ def list_nodes(params = {}, options = {})
8708
+ req = build_request(:list_nodes, params)
8709
+ req.send_request(options)
8710
+ end
8711
+
8712
+ # Generates a summary of managed instance/node metadata based on the
8713
+ # filters and aggregators you specify. Results are grouped by the input
8714
+ # aggregator you specify.
8715
+ #
8716
+ # @option params [String] :sync_name
8717
+ # The name of the Amazon Web Services managed resource data sync to
8718
+ # retrieve information about.
8719
+ #
8720
+ # For cross-account/cross-Region configurations, this parameter is
8721
+ # required, and the name of the supported resource data sync is
8722
+ # `AWS-QuickSetup-ManagedNode`.
8723
+ #
8724
+ # For single account/single-Region configurations, the parameter is not
8725
+ # required.
8726
+ #
8727
+ # @option params [Array<Types::NodeFilter>] :filters
8728
+ # One or more filters. Use a filter to generate a summary that matches
8729
+ # your specified filter criteria.
8730
+ #
8731
+ # @option params [required, Array<Types::NodeAggregator>] :aggregators
8732
+ # Specify one or more aggregators to return a count of managed nodes
8733
+ # that match that expression. For example, a count of managed nodes by
8734
+ # operating system.
8735
+ #
8736
+ # @option params [String] :next_token
8737
+ # The token for the next set of items to return. (You received this
8738
+ # token from a previous call.) The call also returns a token that you
8739
+ # can specify in a subsequent call to get the next set of results.
8740
+ #
8741
+ # @option params [Integer] :max_results
8742
+ # The maximum number of items to return for this call. The call also
8743
+ # returns a token that you can specify in a subsequent call to get the
8744
+ # next set of results.
8745
+ #
8746
+ # @return [Types::ListNodesSummaryResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8747
+ #
8748
+ # * {Types::ListNodesSummaryResult#summary #summary} => Array&lt;Hash&lt;String,String&gt;&gt;
8749
+ # * {Types::ListNodesSummaryResult#next_token #next_token} => String
8750
+ #
8751
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8752
+ #
8753
+ #
8754
+ # @example Example: ListNodesSummary
8755
+ #
8756
+ # # This example illustrates one usage of ListNodesSummary
8757
+ #
8758
+ # resp = client.list_nodes_summary({
8759
+ # aggregators: [
8760
+ # {
8761
+ # aggregator_type: "Count",
8762
+ # attribute_name: "Region",
8763
+ # type_name: "Instance",
8764
+ # },
8765
+ # ],
8766
+ # filters: [
8767
+ # {
8768
+ # key: "InstanceStatus",
8769
+ # type: "Equal",
8770
+ # values: [
8771
+ # "Active",
8772
+ # ],
8773
+ # },
8774
+ # ],
8775
+ # max_results: 2,
8776
+ # next_token: "A9lT8CAxj9aDFRi+MNAoFq08I---EXAMPLE",
8777
+ # sync_name: "AWS-QuickSetup-ManagedNode",
8778
+ # })
8779
+ #
8780
+ # resp.to_h outputs the following:
8781
+ # {
8782
+ # summary: [
8783
+ # {
8784
+ # "Count" => "26",
8785
+ # "Region" => "us-east-1",
8786
+ # },
8787
+ # {
8788
+ # "Count" => "7",
8789
+ # "Region" => "us-east-2",
8790
+ # },
8791
+ # ],
8792
+ # }
8793
+ #
8794
+ # @example Request syntax with placeholder values
8795
+ #
8796
+ # resp = client.list_nodes_summary({
8797
+ # sync_name: "ResourceDataSyncName",
8798
+ # filters: [
8799
+ # {
8800
+ # key: "AgentType", # required, accepts AgentType, AgentVersion, ComputerName, InstanceId, InstanceStatus, IpAddress, ManagedStatus, PlatformName, PlatformType, PlatformVersion, ResourceType, OrganizationalUnitId, OrganizationalUnitPath, Region, AccountId
8801
+ # values: ["NodeFilterValue"], # required
8802
+ # type: "Equal", # accepts Equal, NotEqual, BeginWith
8803
+ # },
8804
+ # ],
8805
+ # aggregators: [ # required
8806
+ # {
8807
+ # aggregator_type: "Count", # required, accepts Count
8808
+ # type_name: "Instance", # required, accepts Instance
8809
+ # attribute_name: "AgentVersion", # required, accepts AgentVersion, PlatformName, PlatformType, PlatformVersion, Region, ResourceType
8810
+ # aggregators: {
8811
+ # # recursive NodeAggregatorList
8812
+ # },
8813
+ # },
8814
+ # ],
8815
+ # next_token: "NextToken",
8816
+ # max_results: 1,
8817
+ # })
8818
+ #
8819
+ # @example Response structure
8820
+ #
8821
+ # resp.summary #=> Array
8822
+ # resp.summary[0] #=> Hash
8823
+ # resp.summary[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
8824
+ # resp.next_token #=> String
8825
+ #
8826
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummary AWS API Documentation
8827
+ #
8828
+ # @overload list_nodes_summary(params = {})
8829
+ # @param [Hash] params ({})
8830
+ def list_nodes_summary(params = {}, options = {})
8831
+ req = build_request(:list_nodes_summary, params)
8832
+ req.send_request(options)
8833
+ end
8834
+
8243
8835
  # Returns a list of all OpsItem events in the current Amazon Web
8244
8836
  # Services Region and Amazon Web Services account. You can limit the
8245
8837
  # results to events associated with specific OpsItems by specifying a
@@ -8301,8 +8893,8 @@ module Aws::SSM
8301
8893
  end
8302
8894
 
8303
8895
  # Lists all related-item resources associated with a Systems Manager
8304
- # OpsCenter OpsItem. OpsCenter is a capability of Amazon Web Services
8305
- # Systems Manager.
8896
+ # OpsCenter OpsItem. OpsCenter is a tool in Amazon Web Services Systems
8897
+ # Manager.
8306
8898
  #
8307
8899
  # @option params [String] :ops_item_id
8308
8900
  # The ID of the OpsItem for which you want to list all related-item
@@ -8628,14 +9220,17 @@ module Aws::SSM
8628
9220
  #
8629
9221
  # @option params [Array<String>] :account_ids_to_add
8630
9222
  # The Amazon Web Services users that should have access to the document.
8631
- # The account IDs can either be a group of account IDs or *All*.
9223
+ # The account IDs can either be a group of account IDs or *All*. You
9224
+ # must specify a value for this parameter or the `AccountIdsToRemove`
9225
+ # parameter.
8632
9226
  #
8633
9227
  # @option params [Array<String>] :account_ids_to_remove
8634
9228
  # The Amazon Web Services users that should no longer have access to the
8635
9229
  # document. The Amazon Web Services user can either be a group of
8636
9230
  # account IDs or *All*. This action has a higher priority than
8637
9231
  # `AccountIdsToAdd`. If you specify an ID to add and the same ID to
8638
- # remove, the system removes access to the document.
9232
+ # remove, the system removes access to the document. You must specify a
9233
+ # value for this parameter or the `AccountIdsToAdd` parameter.
8639
9234
  #
8640
9235
  # @option params [String] :shared_document_version
8641
9236
  # (Optional) The version of the document to share. If it isn't
@@ -8837,11 +9432,11 @@ module Aws::SSM
8837
9432
  req.send_request(options)
8838
9433
  end
8839
9434
 
8840
- # Add a parameter to the system.
9435
+ # Create or update a parameter in Parameter Store.
8841
9436
  #
8842
9437
  # @option params [required, String] :name
8843
- # The fully qualified name of the parameter that you want to add to the
8844
- # system.
9438
+ # The fully qualified name of the parameter that you want to create or
9439
+ # update.
8845
9440
  #
8846
9441
  # <note markdown="1"> You can't enter the Amazon Resource Name (ARN) for a parameter, only
8847
9442
  # the parameter name itself.
@@ -8878,11 +9473,16 @@ module Aws::SSM
8878
9473
  # [Creating Systems Manager parameters][1] in the *Amazon Web Services
8879
9474
  # Systems Manager User Guide*.
8880
9475
  #
8881
- # <note markdown="1"> The maximum length constraint of 2048 characters listed below includes
8882
- # 1037 characters reserved for internal use by Systems Manager. The
8883
- # maximum length for a parameter name that you create is 1011
8884
- # characters. This includes the characters in the ARN that precede the
8885
- # name you specify, such as
9476
+ # <note markdown="1"> The reported maximum length of 2048 characters for a parameter name
9477
+ # includes 1037 characters that are reserved for internal use by Systems
9478
+ # Manager. The maximum length for a parameter name that you specify is
9479
+ # 1011 characters.
9480
+ #
9481
+ # This count of 1011 characters includes the characters in the ARN that
9482
+ # precede the name you specify. This ARN length will vary depending on
9483
+ # your partition and Region. For example, the following 45 characters
9484
+ # count toward the 1011 character maximum for a parameter created in the
9485
+ # US East (Ohio) Region:
8886
9486
  # `arn:aws:ssm:us-east-2:111122223333:parameter/`.
8887
9487
  #
8888
9488
  # </note>
@@ -8903,13 +9503,13 @@ module Aws::SSM
8903
9503
  # value limit of 8 KB.
8904
9504
  #
8905
9505
  # <note markdown="1"> Parameters can't be referenced or nested in the values of other
8906
- # parameters. You can't include `\{\{\}\}` or
8907
- # `\{\{ssm:parameter-name\}\}` in a parameter value.
9506
+ # parameters. You can't include values wrapped in double brackets
9507
+ # `{{}}` or `{{ssm:parameter-name}}` in a parameter value.
8908
9508
  #
8909
9509
  # </note>
8910
9510
  #
8911
9511
  # @option params [String] :type
8912
- # The type of parameter that you want to add to the system.
9512
+ # The type of parameter that you want to create.
8913
9513
  #
8914
9514
  # <note markdown="1"> `SecureString` isn't currently supported for CloudFormation
8915
9515
  # templates.
@@ -8930,7 +9530,7 @@ module Aws::SSM
8930
9530
  # parameters that use the `SecureString` data type.
8931
9531
  #
8932
9532
  # If you don't specify a key ID, the system uses the default key
8933
- # associated with your Amazon Web Services account which is not as
9533
+ # associated with your Amazon Web Services account, which is not as
8934
9534
  # secure as using a custom key.
8935
9535
  #
8936
9536
  # * To use a custom KMS key, choose the `SecureString` data type with
@@ -9044,8 +9644,8 @@ module Aws::SSM
9044
9644
  #
9045
9645
  # @option params [String] :policies
9046
9646
  # One or more policies to apply to a parameter. This operation takes a
9047
- # JSON array. Parameter Store, a capability of Amazon Web Services
9048
- # Systems Manager supports the following policy types:
9647
+ # JSON array. Parameter Store, a tool in Amazon Web Services Systems
9648
+ # Manager supports the following policy types:
9049
9649
  #
9050
9650
  # Expiration: This policy deletes the parameter after it expires. When
9051
9651
  # you create the policy, you specify the expiration date. You can update
@@ -9463,7 +10063,7 @@ module Aws::SSM
9463
10063
  # creating a custom policy and custom service role for running your
9464
10064
  # maintenance window tasks. The policy can be crafted to provide only
9465
10065
  # the permissions needed for your particular maintenance window tasks.
9466
- # For more information, see [Setting up maintenance windows][1] in the
10066
+ # For more information, see [Setting up Maintenance Windows][1] in the
9467
10067
  # in the *Amazon Web Services Systems Manager User Guide*.
9468
10068
  #
9469
10069
  #
@@ -9576,7 +10176,6 @@ module Aws::SSM
9576
10176
  # command associated with the task. However, there is no guarantee
9577
10177
  # that the command will be terminated and the underlying process
9578
10178
  # stopped.
9579
- #
9580
10179
  # The status for tasks that are not completed is `TIMED_OUT`.
9581
10180
  #
9582
10181
  # @option params [Types::AlarmConfiguration] :alarm_configuration
@@ -9764,16 +10363,20 @@ module Aws::SSM
9764
10363
  # The Amazon Resource Name (ARN) of the service setting to reset. The
9765
10364
  # setting ID can be one of the following.
9766
10365
  #
9767
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
10366
+ # * `/ssm/appmanager/appmanager-enabled`
9768
10367
  #
9769
10368
  # * `/ssm/automation/customer-script-log-destination`
9770
10369
  #
9771
10370
  # * `/ssm/automation/customer-script-log-group-name`
9772
10371
  #
10372
+ # * /ssm/automation/enable-adaptive-concurrency
10373
+ #
9773
10374
  # * `/ssm/documents/console/public-sharing-permission`
9774
10375
  #
9775
10376
  # * `/ssm/managed-instance/activation-tier`
9776
10377
  #
10378
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
10379
+ #
9777
10380
  # * `/ssm/opsinsights/opscenter`
9778
10381
  #
9779
10382
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -9883,7 +10486,7 @@ module Aws::SSM
9883
10486
  #
9884
10487
  # resp = client.send_automation_signal({
9885
10488
  # automation_execution_id: "AutomationExecutionId", # required
9886
- # signal_type: "Approve", # required, accepts Approve, Reject, StartStep, StopStep, Resume
10489
+ # signal_type: "Approve", # required, accepts Approve, Reject, StartStep, StopStep, Resume, Revoke
9887
10490
  # payload: {
9888
10491
  # "AutomationParameterKey" => ["AutomationParameterValue"],
9889
10492
  # },
@@ -10051,7 +10654,7 @@ module Aws::SSM
10051
10654
  #
10052
10655
  # @option params [Types::CloudWatchOutputConfig] :cloud_watch_output_config
10053
10656
  # Enables Amazon Web Services Systems Manager to send Run Command output
10054
- # to Amazon CloudWatch Logs. Run Command is a capability of Amazon Web
10657
+ # to Amazon CloudWatch Logs. Run Command is a tool in Amazon Web
10055
10658
  # Services Systems Manager.
10056
10659
  #
10057
10660
  # @option params [Types::AlarmConfiguration] :alarm_configuration
@@ -10157,6 +10760,53 @@ module Aws::SSM
10157
10760
  req.send_request(options)
10158
10761
  end
10159
10762
 
10763
+ # Starts the workflow for just-in-time node access sessions.
10764
+ #
10765
+ # @option params [required, String] :reason
10766
+ # A brief description explaining why you are requesting access to the
10767
+ # node.
10768
+ #
10769
+ # @option params [required, Array<Types::Target>] :targets
10770
+ # The node you are requesting access to.
10771
+ #
10772
+ # @option params [Array<Types::Tag>] :tags
10773
+ # Key-value pairs of metadata you want to assign to the access request.
10774
+ #
10775
+ # @return [Types::StartAccessRequestResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10776
+ #
10777
+ # * {Types::StartAccessRequestResponse#access_request_id #access_request_id} => String
10778
+ #
10779
+ # @example Request syntax with placeholder values
10780
+ #
10781
+ # resp = client.start_access_request({
10782
+ # reason: "String1to256", # required
10783
+ # targets: [ # required
10784
+ # {
10785
+ # key: "TargetKey",
10786
+ # values: ["TargetValue"],
10787
+ # },
10788
+ # ],
10789
+ # tags: [
10790
+ # {
10791
+ # key: "TagKey", # required
10792
+ # value: "TagValue", # required
10793
+ # },
10794
+ # ],
10795
+ # })
10796
+ #
10797
+ # @example Response structure
10798
+ #
10799
+ # resp.access_request_id #=> String
10800
+ #
10801
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAccessRequest AWS API Documentation
10802
+ #
10803
+ # @overload start_access_request(params = {})
10804
+ # @param [Hash] params ({})
10805
+ def start_access_request(params = {}, options = {})
10806
+ req = build_request(:start_access_request, params)
10807
+ req.send_request(options)
10808
+ end
10809
+
10160
10810
  # Runs an association immediately and only one time. This operation can
10161
10811
  # be helpful when troubleshooting associations.
10162
10812
  #
@@ -10217,6 +10867,9 @@ module Aws::SSM
10217
10867
  # A key-value mapping to target resources. Required if you specify
10218
10868
  # TargetParameterName.
10219
10869
  #
10870
+ # If both this parameter and the `TargetLocation:Targets` parameter are
10871
+ # supplied, `TargetLocation:Targets` takes precedence.
10872
+ #
10220
10873
  # @option params [Array<Hash>] :target_maps
10221
10874
  # A key-value mapping of document parameters to target resources. Both
10222
10875
  # Targets and TargetMaps can't be specified together.
@@ -10226,6 +10879,9 @@ module Aws::SSM
10226
10879
  # You can specify a number, such as 10, or a percentage, such as 10%.
10227
10880
  # The default value is `10`.
10228
10881
  #
10882
+ # If both this parameter and the `TargetLocation:TargetsMaxConcurrency`
10883
+ # are supplied, `TargetLocation:TargetsMaxConcurrency` takes precedence.
10884
+ #
10229
10885
  # @option params [String] :max_errors
10230
10886
  # The number of errors that are allowed before the system stops running
10231
10887
  # the automation on additional targets. You can specify either an
@@ -10244,14 +10900,17 @@ module Aws::SSM
10244
10900
  # max-errors failed executions, set max-concurrency to 1 so the
10245
10901
  # executions proceed one at a time.
10246
10902
  #
10903
+ # If this parameter and the `TargetLocation:TargetsMaxErrors` parameter
10904
+ # are both supplied, `TargetLocation:TargetsMaxErrors` takes precedence.
10905
+ #
10247
10906
  # @option params [Array<Types::TargetLocation>] :target_locations
10248
10907
  # A location is a combination of Amazon Web Services Regions and/or
10249
10908
  # Amazon Web Services accounts where you want to run the automation. Use
10250
10909
  # this operation to start an automation in multiple Amazon Web Services
10251
10910
  # Regions and multiple Amazon Web Services accounts. For more
10252
- # information, see [Running Automation workflows in multiple Amazon Web
10253
- # Services Regions and Amazon Web Services accounts][1] in the *Amazon
10254
- # Web Services Systems Manager User Guide*.
10911
+ # information, see [Running automations in multiple Amazon Web Services
10912
+ # Regions and accounts][1] in the *Amazon Web Services Systems Manager
10913
+ # User Guide*.
10255
10914
  #
10256
10915
  #
10257
10916
  #
@@ -10269,14 +10928,22 @@ module Aws::SSM
10269
10928
  #
10270
10929
  # * `Key=OS,Value=Windows`
10271
10930
  #
10272
- # <note markdown="1"> To add tags to an existing automation, use the AddTagsToResource
10273
- # operation.
10931
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
10932
+ # includes capacity reserved for internal operations. When calling the
10933
+ # `StartAutomationExecution` action, you can specify a maximum of 5
10934
+ # tags. You can, however, use the AddTagsToResource action to add up to
10935
+ # a total of 50 tags to an existing automation configuration.
10274
10936
  #
10275
10937
  # </note>
10276
10938
  #
10277
10939
  # @option params [Types::AlarmConfiguration] :alarm_configuration
10278
10940
  # The CloudWatch alarm you want to apply to your automation.
10279
10941
  #
10942
+ # @option params [String] :target_locations_url
10943
+ # Specify a publicly accessible URL for a file that contains the
10944
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
10945
+ # buckets are supported.
10946
+ #
10280
10947
  # @return [Types::StartAutomationExecutionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10281
10948
  #
10282
10949
  # * {Types::StartAutomationExecutionResult#automation_execution_id #automation_execution_id} => String
@@ -10320,6 +10987,16 @@ module Aws::SSM
10320
10987
  # },
10321
10988
  # ],
10322
10989
  # },
10990
+ # include_child_organization_units: false,
10991
+ # exclude_accounts: ["ExcludeAccount"],
10992
+ # targets: [
10993
+ # {
10994
+ # key: "TargetKey",
10995
+ # values: ["TargetValue"],
10996
+ # },
10997
+ # ],
10998
+ # targets_max_concurrency: "MaxConcurrency",
10999
+ # targets_max_errors: "MaxErrors",
10323
11000
  # },
10324
11001
  # ],
10325
11002
  # tags: [
@@ -10336,6 +11013,7 @@ module Aws::SSM
10336
11013
  # },
10337
11014
  # ],
10338
11015
  # },
11016
+ # target_locations_url: "TargetLocationsURL",
10339
11017
  # })
10340
11018
  #
10341
11019
  # @example Response structure
@@ -10423,6 +11101,14 @@ module Aws::SSM
10423
11101
  #
10424
11102
  # * `Key=Region,Value=us-east-2`
10425
11103
  #
11104
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
11105
+ # includes capacity reserved for internal operations. When calling the
11106
+ # `StartChangeRequestExecution` action, you can specify a maximum of 5
11107
+ # tags. You can, however, use the AddTagsToResource action to add up to
11108
+ # a total of 50 tags to an existing change request configuration.
11109
+ #
11110
+ # </note>
11111
+ #
10426
11112
  # @option params [Time,DateTime,Date,Integer,String] :scheduled_end_time
10427
11113
  # The time that the requester expects the runbook workflow related to
10428
11114
  # the change request to complete. The time is an estimate only that the
@@ -10485,6 +11171,16 @@ module Aws::SSM
10485
11171
  # },
10486
11172
  # ],
10487
11173
  # },
11174
+ # include_child_organization_units: false,
11175
+ # exclude_accounts: ["ExcludeAccount"],
11176
+ # targets: [
11177
+ # {
11178
+ # key: "TargetKey",
11179
+ # values: ["TargetValue"],
11180
+ # },
11181
+ # ],
11182
+ # targets_max_concurrency: "MaxConcurrency",
11183
+ # targets_max_errors: "MaxErrors",
10488
11184
  # },
10489
11185
  # ],
10490
11186
  # },
@@ -10512,6 +11208,107 @@ module Aws::SSM
10512
11208
  req.send_request(options)
10513
11209
  end
10514
11210
 
11211
+ # Initiates the process of creating a preview showing the effects that
11212
+ # running a specified Automation runbook would have on the targeted
11213
+ # resources.
11214
+ #
11215
+ # @option params [required, String] :document_name
11216
+ # The name of the Automation runbook to run. The result of the execution
11217
+ # preview indicates what the impact would be of running this runbook.
11218
+ #
11219
+ # @option params [String] :document_version
11220
+ # The version of the Automation runbook to run. The default value is
11221
+ # `$DEFAULT`.
11222
+ #
11223
+ # @option params [Types::ExecutionInputs] :execution_inputs
11224
+ # Information about the inputs that can be specified for the preview
11225
+ # operation.
11226
+ #
11227
+ # @return [Types::StartExecutionPreviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
11228
+ #
11229
+ # * {Types::StartExecutionPreviewResponse#execution_preview_id #execution_preview_id} => String
11230
+ #
11231
+ #
11232
+ # @example Example: StartExecutionPreview
11233
+ #
11234
+ # # This example illustrates one usage of StartExecutionPreview
11235
+ #
11236
+ # resp = client.start_execution_preview({
11237
+ # document_name: "AWS-StartEC2Instance",
11238
+ # })
11239
+ #
11240
+ # resp.to_h outputs the following:
11241
+ # {
11242
+ # execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
11243
+ # }
11244
+ #
11245
+ # @example Request syntax with placeholder values
11246
+ #
11247
+ # resp = client.start_execution_preview({
11248
+ # document_name: "DocumentName", # required
11249
+ # document_version: "DocumentVersion",
11250
+ # execution_inputs: {
11251
+ # automation: {
11252
+ # parameters: {
11253
+ # "AutomationParameterKey" => ["AutomationParameterValue"],
11254
+ # },
11255
+ # target_parameter_name: "AutomationParameterKey",
11256
+ # targets: [
11257
+ # {
11258
+ # key: "TargetKey",
11259
+ # values: ["TargetValue"],
11260
+ # },
11261
+ # ],
11262
+ # target_maps: [
11263
+ # {
11264
+ # "TargetMapKey" => ["TargetMapValue"],
11265
+ # },
11266
+ # ],
11267
+ # target_locations: [
11268
+ # {
11269
+ # accounts: ["Account"],
11270
+ # regions: ["Region"],
11271
+ # target_location_max_concurrency: "MaxConcurrency",
11272
+ # target_location_max_errors: "MaxErrors",
11273
+ # execution_role_name: "ExecutionRoleName",
11274
+ # target_location_alarm_configuration: {
11275
+ # ignore_poll_alarm_failure: false,
11276
+ # alarms: [ # required
11277
+ # {
11278
+ # name: "AlarmName", # required
11279
+ # },
11280
+ # ],
11281
+ # },
11282
+ # include_child_organization_units: false,
11283
+ # exclude_accounts: ["ExcludeAccount"],
11284
+ # targets: [
11285
+ # {
11286
+ # key: "TargetKey",
11287
+ # values: ["TargetValue"],
11288
+ # },
11289
+ # ],
11290
+ # targets_max_concurrency: "MaxConcurrency",
11291
+ # targets_max_errors: "MaxErrors",
11292
+ # },
11293
+ # ],
11294
+ # target_locations_url: "TargetLocationsURL",
11295
+ # },
11296
+ # },
11297
+ # })
11298
+ #
11299
+ # @example Response structure
11300
+ #
11301
+ # resp.execution_preview_id #=> String
11302
+ #
11303
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreview AWS API Documentation
11304
+ #
11305
+ # @overload start_execution_preview(params = {})
11306
+ # @param [Hash] params ({})
11307
+ def start_execution_preview(params = {}, options = {})
11308
+ req = build_request(:start_execution_preview, params)
11309
+ req.send_request(options)
11310
+ end
11311
+
10515
11312
  # Initiates a connection to a target (for example, a managed node) for a
10516
11313
  # Session Manager session. Returns a URL and token that can be used to
10517
11314
  # open a WebSocket connection for sending input and receiving outputs.
@@ -10555,7 +11352,13 @@ module Aws::SSM
10555
11352
  #
10556
11353
  # @option params [Hash<String,Array>] :parameters
10557
11354
  # The values you want to specify for the parameters defined in the
10558
- # Session document.
11355
+ # Session document. For more information about these parameters, see
11356
+ # [Create a Session Manager preferences document][1] in the *Amazon Web
11357
+ # Services Systems Manager User Guide*.
11358
+ #
11359
+ #
11360
+ #
11361
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-create-preferences-cli.html
10559
11362
  #
10560
11363
  # @return [Types::StartSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10561
11364
  #
@@ -10722,9 +11525,9 @@ module Aws::SSM
10722
11525
  #
10723
11526
  # @option params [Hash<String,Array>] :parameters
10724
11527
  # The parameters you want to update for the association. If you create a
10725
- # parameter using Parameter Store, a capability of Amazon Web Services
10726
- # Systems Manager, you can reference the parameter using
10727
- # `\{\{ssm:parameter-name\}\}`.
11528
+ # parameter using Parameter Store, a tool in Amazon Web Services Systems
11529
+ # Manager, you can reference the parameter using
11530
+ # `{{ssm:parameter-name}}`.
10728
11531
  #
10729
11532
  # @option params [String] :document_version
10730
11533
  # The document version you want update for the association.
@@ -10782,7 +11585,7 @@ module Aws::SSM
10782
11585
  # Choose the parameter that will define how your automation will branch
10783
11586
  # out. This target is required for associations that use an Automation
10784
11587
  # runbook and target resources by using rate controls. Automation is a
10785
- # capability of Amazon Web Services Systems Manager.
11588
+ # tool in Amazon Web Services Systems Manager.
10786
11589
  #
10787
11590
  # @option params [String] :max_errors
10788
11591
  # The number of errors that are allowed before the system stops sending
@@ -10826,8 +11629,8 @@ module Aws::SSM
10826
11629
  #
10827
11630
  # In `MANUAL` mode, you must specify the `AssociationId` as a parameter
10828
11631
  # for the PutComplianceItems API operation. In this case, compliance
10829
- # data isn't managed by State Manager, a capability of Amazon Web
10830
- # Services Systems Manager. It is managed by your direct call to the
11632
+ # data isn't managed by State Manager, a tool in Amazon Web Services
11633
+ # Systems Manager. It is managed by your direct call to the
10831
11634
  # PutComplianceItems API operation.
10832
11635
  #
10833
11636
  # By default, all associations use `AUTO` mode.
@@ -10835,32 +11638,43 @@ module Aws::SSM
10835
11638
  # @option params [Boolean] :apply_only_at_cron_interval
10836
11639
  # By default, when you update an association, the system runs it
10837
11640
  # immediately after it is updated and then according to the schedule you
10838
- # specified. Specify this option if you don't want an association to
10839
- # run immediately after you update it. This parameter isn't supported
10840
- # for rate expressions.
11641
+ # specified. Specify `true` for `ApplyOnlyAtCronInterval` if you want
11642
+ # the association to run only according to the schedule you specified.
10841
11643
  #
10842
11644
  # If you chose this option when you created an association and later you
10843
- # edit that association or you make changes to the SSM document on which
10844
- # that association is based (by using the Documents page in the
10845
- # console), State Manager applies the association at the next specified
10846
- # cron interval. For example, if you chose the `Latest` version of an
10847
- # SSM document when you created an association and you edit the
10848
- # association by choosing a different document version on the Documents
10849
- # page, State Manager applies the association at the next specified cron
10850
- # interval if you previously selected this option. If this option
10851
- # wasn't selected, State Manager immediately runs the association.
10852
- #
10853
- # You can reset this option. To do so, specify the
11645
+ # edit that association or you make changes to the Automation runbook or
11646
+ # SSM document on which that association is based, State Manager applies
11647
+ # the association at the next specified cron interval. For example, if
11648
+ # you chose the `Latest` version of an SSM document when you created an
11649
+ # association and you edit the association by choosing a different
11650
+ # document version on the Documents page, State Manager applies the
11651
+ # association at the next specified cron interval if you previously set
11652
+ # `ApplyOnlyAtCronInterval` to `true`. If this option wasn't selected,
11653
+ # State Manager immediately runs the association.
11654
+ #
11655
+ # For more information, see [Understanding when associations are applied
11656
+ # to resources][1] and [About target updates with Automation
11657
+ # runbooks][2] in the *Amazon Web Services Systems Manager User Guide*.
11658
+ #
11659
+ # This parameter isn't supported for rate expressions.
11660
+ #
11661
+ # You can reset this parameter. To do so, specify the
10854
11662
  # `no-apply-only-at-cron-interval` parameter when you update the
10855
11663
  # association from the command line. This parameter forces the
10856
11664
  # association to run immediately after updating it and according to the
10857
11665
  # interval specified.
10858
11666
  #
11667
+ #
11668
+ #
11669
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
11670
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
11671
+ #
10859
11672
  # @option params [Array<String>] :calendar_names
10860
11673
  # The names or Amazon Resource Names (ARNs) of the Change Calendar type
10861
11674
  # documents you want to gate your associations under. The associations
10862
11675
  # only run when that change calendar is open. For more information, see
10863
- # [Amazon Web Services Systems Manager Change Calendar][1].
11676
+ # [Amazon Web Services Systems Manager Change Calendar][1] in the
11677
+ # *Amazon Web Services Systems Manager User Guide*.
10864
11678
  #
10865
11679
  #
10866
11680
  #
@@ -10968,6 +11782,16 @@ module Aws::SSM
10968
11782
  # },
10969
11783
  # ],
10970
11784
  # },
11785
+ # include_child_organization_units: false,
11786
+ # exclude_accounts: ["ExcludeAccount"],
11787
+ # targets: [
11788
+ # {
11789
+ # key: "TargetKey",
11790
+ # values: ["TargetValue"],
11791
+ # },
11792
+ # ],
11793
+ # targets_max_concurrency: "MaxConcurrency",
11794
+ # targets_max_errors: "MaxErrors",
10971
11795
  # },
10972
11796
  # ],
10973
11797
  # schedule_offset: 1,
@@ -11037,6 +11861,15 @@ module Aws::SSM
11037
11861
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
11038
11862
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
11039
11863
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
11864
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
11865
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
11866
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
11867
+ # resp.association_description.target_locations[0].targets #=> Array
11868
+ # resp.association_description.target_locations[0].targets[0].key #=> String
11869
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
11870
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
11871
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
11872
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
11040
11873
  # resp.association_description.schedule_offset #=> Integer
11041
11874
  # resp.association_description.duration #=> Integer
11042
11875
  # resp.association_description.target_maps #=> Array
@@ -11143,6 +11976,15 @@ module Aws::SSM
11143
11976
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
11144
11977
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
11145
11978
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
11979
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
11980
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
11981
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
11982
+ # resp.association_description.target_locations[0].targets #=> Array
11983
+ # resp.association_description.target_locations[0].targets[0].key #=> String
11984
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
11985
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
11986
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
11987
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
11146
11988
  # resp.association_description.schedule_offset #=> Integer
11147
11989
  # resp.association_description.duration #=> Integer
11148
11990
  # resp.association_description.target_maps #=> Array
@@ -11251,7 +12093,7 @@ module Aws::SSM
11251
12093
  # resp.document_description.parameters[0].default_value #=> String
11252
12094
  # resp.document_description.platform_types #=> Array
11253
12095
  # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
11254
- # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup"
12096
+ # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate", "CloudFormation", "ConformancePackTemplate", "QuickSetup", "ManualApprovalPolicy", "AutoApprovalPolicy"
11255
12097
  # resp.document_description.schema_version #=> String
11256
12098
  # resp.document_description.latest_version #=> String
11257
12099
  # resp.document_description.default_version #=> String
@@ -11691,7 +12533,7 @@ module Aws::SSM
11691
12533
  # creating a custom policy and custom service role for running your
11692
12534
  # maintenance window tasks. The policy can be crafted to provide only
11693
12535
  # the permissions needed for your particular maintenance window tasks.
11694
- # For more information, see [Setting up maintenance windows][1] in the
12536
+ # For more information, see [Setting up Maintenance Windows][1] in the
11695
12537
  # in the *Amazon Web Services Systems Manager User Guide*.
11696
12538
  #
11697
12539
  #
@@ -11817,7 +12659,6 @@ module Aws::SSM
11817
12659
  # command associated with the task. However, there is no guarantee
11818
12660
  # that the command will be terminated and the underlying process
11819
12661
  # stopped.
11820
- #
11821
12662
  # The status for tasks that are not completed is `TIMED_OUT`.
11822
12663
  #
11823
12664
  # @option params [Types::AlarmConfiguration] :alarm_configuration
@@ -11995,9 +12836,9 @@ module Aws::SSM
11995
12836
  # want to assign to the managed node. This IAM role must provide
11996
12837
  # AssumeRole permissions for the Amazon Web Services Systems Manager
11997
12838
  # service principal `ssm.amazonaws.com`. For more information, see
11998
- # [Create an IAM service role for a hybrid and multicloud
11999
- # environment][1] in the *Amazon Web Services Systems Manager User
12000
- # Guide*.
12839
+ # [Create the IAM service role required for Systems Manager in hybrid
12840
+ # and multicloud environments][1] in the *Amazon Web Services Systems
12841
+ # Manager User Guide*.
12001
12842
  #
12002
12843
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
12003
12844
  # must create a unique role.
@@ -12006,7 +12847,7 @@ module Aws::SSM
12006
12847
  #
12007
12848
  #
12008
12849
  #
12009
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
12850
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
12010
12851
  #
12011
12852
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
12012
12853
  #
@@ -12097,9 +12938,8 @@ module Aws::SSM
12097
12938
  # impacted resource.
12098
12939
  #
12099
12940
  # @option params [String] :status
12100
- # The OpsItem status. Status can be `Open`, `In Progress`, or
12101
- # `Resolved`. For more information, see [Editing OpsItem details][1] in
12102
- # the *Amazon Web Services Systems Manager User Guide*.
12941
+ # The OpsItem status. For more information, see [Editing OpsItem
12942
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
12103
12943
  #
12104
12944
  #
12105
12945
  #
@@ -12162,7 +13002,7 @@ module Aws::SSM
12162
13002
  # ops_item_id: "String", # required
12163
13003
  # },
12164
13004
  # ],
12165
- # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Rejected, Closed
13005
+ # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Revoked, Rejected, Closed
12166
13006
  # ops_item_id: "OpsItemId", # required
12167
13007
  # title: "OpsItemTitle",
12168
13008
  # category: "OpsItemCategory",
@@ -12241,6 +13081,10 @@ module Aws::SSM
12241
13081
  # @option params [Types::PatchFilterGroup] :global_filters
12242
13082
  # A set of global filters used to include patches in the baseline.
12243
13083
  #
13084
+ # The `GlobalFilters` parameter can be configured only by using the CLI
13085
+ # or an Amazon Web Services SDK. It can't be configured from the Patch
13086
+ # Manager console, and its value isn't displayed in the console.
13087
+ #
12244
13088
  # @option params [Types::PatchRuleGroup] :approval_rules
12245
13089
  # A set of rules used to include patches in the baseline.
12246
13090
  #
@@ -12248,7 +13092,7 @@ module Aws::SSM
12248
13092
  # A list of explicitly approved patches for the baseline.
12249
13093
  #
12250
13094
  # For information about accepted formats for lists of approved patches
12251
- # and rejected patches, see [About package name formats for approved and
13095
+ # and rejected patches, see [Package name formats for approved and
12252
13096
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
12253
13097
  # User Guide*.
12254
13098
  #
@@ -12268,7 +13112,7 @@ module Aws::SSM
12268
13112
  # A list of explicitly rejected patches for the baseline.
12269
13113
  #
12270
13114
  # For information about accepted formats for lists of approved patches
12271
- # and rejected patches, see [About package name formats for approved and
13115
+ # and rejected patches, see [Package name formats for approved and
12272
13116
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
12273
13117
  # User Guide*.
12274
13118
  #
@@ -12280,19 +13124,28 @@ module Aws::SSM
12280
13124
  # The action for Patch Manager to take on patches included in the
12281
13125
  # `RejectedPackages` list.
12282
13126
  #
12283
- # * <b> <code>ALLOW_AS_DEPENDENCY</code> </b>: A package in the
12284
- # `Rejected` patches list is installed only if it is a dependency of
12285
- # another package. It is considered compliant with the patch baseline,
12286
- # and its status is reported as `InstalledOther`. This is the default
12287
- # action if no option is specified.
13127
+ # ALLOW\_AS\_DEPENDENCY
13128
+ #
13129
+ # : **Linux and macOS**: A package in the rejected patches list is
13130
+ # installed only if it is a dependency of another package. It is
13131
+ # considered compliant with the patch baseline, and its status is
13132
+ # reported as `INSTALLED_OTHER`. This is the default action if no
13133
+ # option is specified.
13134
+ #
13135
+ # **Windows Server**: Windows Server doesn't support the concept of
13136
+ # package dependencies. If a package in the rejected patches list and
13137
+ # already installed on the node, its status is reported as
13138
+ # `INSTALLED_OTHER`. Any package not already installed on the node is
13139
+ # skipped. This is the default action if no option is specified.
12288
13140
  #
12289
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
13141
+ # BLOCK
13142
+ #
13143
+ # : **All OSs**: Packages in the rejected patches list, and packages
12290
13144
  # that include them as dependencies, aren't installed by Patch
12291
13145
  # Manager under any circumstances. If a package was installed before
12292
- # it was added to the **Rejected patches** list, or is installed
12293
- # outside of Patch Manager afterward, it's considered noncompliant
12294
- # with the patch baseline and its status is reported as
12295
- # *InstalledRejected*.
13146
+ # it was added to the rejected patches list, or is installed outside
13147
+ # of Patch Manager afterward, it's considered noncompliant with the
13148
+ # patch baseline and its status is reported as `INSTALLED_REJECTED`.
12296
13149
  #
12297
13150
  # @option params [String] :description
12298
13151
  # A description of the patch baseline.
@@ -12302,6 +13155,20 @@ module Aws::SSM
12302
13155
  # including target operating systems and source repositories. Applies to
12303
13156
  # Linux managed nodes only.
12304
13157
  #
13158
+ # @option params [String] :available_security_updates_compliance_status
13159
+ # Indicates the status to be assigned to security patches that are
13160
+ # available but not approved because they don't meet the installation
13161
+ # criteria specified in the patch baseline.
13162
+ #
13163
+ # Example scenario: Security patches that you might want installed can
13164
+ # be skipped if you have specified a long period to wait after a patch
13165
+ # is released before installation. If an update to the patch is released
13166
+ # during your specified waiting period, the waiting period for
13167
+ # installing the patch starts over. If the waiting period is too long,
13168
+ # multiple versions of the patch could be released but never installed.
13169
+ #
13170
+ # Supported for Windows Server managed nodes only.
13171
+ #
12305
13172
  # @option params [Boolean] :replace
12306
13173
  # If True, then all fields that are required by the CreatePatchBaseline
12307
13174
  # operation are also required for this API request. Optional fields that
@@ -12323,6 +13190,7 @@ module Aws::SSM
12323
13190
  # * {Types::UpdatePatchBaselineResult#modified_date #modified_date} => Time
12324
13191
  # * {Types::UpdatePatchBaselineResult#description #description} => String
12325
13192
  # * {Types::UpdatePatchBaselineResult#sources #sources} => Array&lt;Types::PatchSource&gt;
13193
+ # * {Types::UpdatePatchBaselineResult#available_security_updates_compliance_status #available_security_updates_compliance_status} => String
12326
13194
  #
12327
13195
  # @example Request syntax with placeholder values
12328
13196
  #
@@ -12368,6 +13236,7 @@ module Aws::SSM
12368
13236
  # configuration: "PatchSourceConfiguration", # required
12369
13237
  # },
12370
13238
  # ],
13239
+ # available_security_updates_compliance_status: "COMPLIANT", # accepts COMPLIANT, NON_COMPLIANT
12371
13240
  # replace: false,
12372
13241
  # })
12373
13242
  #
@@ -12404,6 +13273,7 @@ module Aws::SSM
12404
13273
  # resp.sources[0].products #=> Array
12405
13274
  # resp.sources[0].products[0] #=> String
12406
13275
  # resp.sources[0].configuration #=> String
13276
+ # resp.available_security_updates_compliance_status #=> String, one of "COMPLIANT", "NON_COMPLIANT"
12407
13277
  #
12408
13278
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdatePatchBaseline AWS API Documentation
12409
13279
  #
@@ -12494,16 +13364,20 @@ module Aws::SSM
12494
13364
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
12495
13365
  # The setting ID can be one of the following.
12496
13366
  #
12497
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
13367
+ # * `/ssm/appmanager/appmanager-enabled`
12498
13368
  #
12499
13369
  # * `/ssm/automation/customer-script-log-destination`
12500
13370
  #
12501
13371
  # * `/ssm/automation/customer-script-log-group-name`
12502
13372
  #
13373
+ # * /ssm/automation/enable-adaptive-concurrency
13374
+ #
12503
13375
  # * `/ssm/documents/console/public-sharing-permission`
12504
13376
  #
12505
13377
  # * `/ssm/managed-instance/activation-tier`
12506
13378
  #
13379
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
13380
+ #
12507
13381
  # * `/ssm/opsinsights/opscenter`
12508
13382
  #
12509
13383
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -12522,8 +13396,7 @@ module Aws::SSM
12522
13396
  # The new value to specify for the service setting. The following list
12523
13397
  # specifies the available values for each setting.
12524
13398
  #
12525
- # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
12526
- # enter the name of an IAM role.
13399
+ # * For `/ssm/appmanager/appmanager-enabled`, enter `True` or `False`.
12527
13400
  #
12528
13401
  # * For `/ssm/automation/customer-script-log-destination`, enter
12529
13402
  # `CloudWatch`.
@@ -12537,6 +13410,9 @@ module Aws::SSM
12537
13410
  # * For `/ssm/managed-instance/activation-tier`, enter `standard` or
12538
13411
  # `advanced`.
12539
13412
  #
13413
+ # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
13414
+ # enter the name of an IAM role.
13415
+ #
12540
13416
  # * For `/ssm/opsinsights/opscenter`, enter `Enabled` or `Disabled`.
12541
13417
  #
12542
13418
  # * For `/ssm/parameter-store/default-parameter-tier`, enter `Standard`,
@@ -12569,14 +13445,19 @@ module Aws::SSM
12569
13445
  # @api private
12570
13446
  def build_request(operation_name, params = {})
12571
13447
  handlers = @handlers.for(operation_name)
13448
+ tracer = config.telemetry_provider.tracer_provider.tracer(
13449
+ Aws::Telemetry.module_to_tracer_name('Aws::SSM')
13450
+ )
12572
13451
  context = Seahorse::Client::RequestContext.new(
12573
13452
  operation_name: operation_name,
12574
13453
  operation: config.api.operation(operation_name),
12575
13454
  client: self,
12576
13455
  params: params,
12577
- config: config)
13456
+ config: config,
13457
+ tracer: tracer
13458
+ )
12578
13459
  context[:gem_name] = 'aws-sdk-ssm'
12579
- context[:gem_version] = '1.173.0'
13460
+ context[:gem_version] = '1.197.0'
12580
13461
  Seahorse::Client::Request.new(handlers, context)
12581
13462
  end
12582
13463