aws-sdk-ssm 1.173.0 → 1.196.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
2045
2149
  #
2046
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
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.
2155
+ #
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"
@@ -3615,7 +3786,7 @@ module Aws::SSM
3615
3786
  # resp.document.parameters[0].default_value #=> String
3616
3787
  # resp.document.platform_types #=> Array
3617
3788
  # 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"
3789
+ # 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
3790
  # resp.document.schema_version #=> String
3620
3791
  # resp.document.latest_version #=> String
3621
3792
  # resp.document.default_version #=> String
@@ -3893,9 +4064,10 @@ module Aws::SSM
3893
4064
  # information for all your managed nodes. If you specify a node ID that
3894
4065
  # isn't valid or a node that you don't own, you receive an error.
3895
4066
  #
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.
4067
+ # <note markdown="1"> The `IamRole` field returned for this API operation is the role
4068
+ # assigned to an Amazon EC2 instance configured with a Systems Manager
4069
+ # Quick Setup host management configuration or the role assigned to an
4070
+ # on-premises managed node.
3899
4071
  #
3900
4072
  # </note>
3901
4073
  #
@@ -4033,6 +4205,7 @@ module Aws::SSM
4033
4205
  # resp.instance_patch_states[0].failed_count #=> Integer
4034
4206
  # resp.instance_patch_states[0].unreported_not_applicable_count #=> Integer
4035
4207
  # resp.instance_patch_states[0].not_applicable_count #=> Integer
4208
+ # resp.instance_patch_states[0].available_security_update_count #=> Integer
4036
4209
  # resp.instance_patch_states[0].operation_start_time #=> Time
4037
4210
  # resp.instance_patch_states[0].operation_end_time #=> Time
4038
4211
  # resp.instance_patch_states[0].operation #=> String, one of "Scan", "Install"
@@ -4114,6 +4287,7 @@ module Aws::SSM
4114
4287
  # resp.instance_patch_states[0].failed_count #=> Integer
4115
4288
  # resp.instance_patch_states[0].unreported_not_applicable_count #=> Integer
4116
4289
  # resp.instance_patch_states[0].not_applicable_count #=> Integer
4290
+ # resp.instance_patch_states[0].available_security_update_count #=> Integer
4117
4291
  # resp.instance_patch_states[0].operation_start_time #=> Time
4118
4292
  # resp.instance_patch_states[0].operation_end_time #=> Time
4119
4293
  # resp.instance_patch_states[0].operation #=> String, one of "Scan", "Install"
@@ -4163,9 +4337,8 @@ module Aws::SSM
4163
4337
  # Sample values: `Installed` \| `InstalledOther` \|
4164
4338
  # `InstalledPendingReboot`
4165
4339
  #
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*.
4340
+ # For lists of all `State` values, see [Patch compliance state
4341
+ # values][1] in the *Amazon Web Services Systems Manager User Guide*.
4169
4342
  #
4170
4343
  #
4171
4344
  #
@@ -4206,7 +4379,7 @@ module Aws::SSM
4206
4379
  # resp.patches[0].kb_id #=> String
4207
4380
  # resp.patches[0].classification #=> String
4208
4381
  # 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"
4382
+ # resp.patches[0].state #=> String, one of "INSTALLED", "INSTALLED_OTHER", "INSTALLED_PENDING_REBOOT", "INSTALLED_REJECTED", "MISSING", "NOT_APPLICABLE", "FAILED", "AVAILABLE_SECURITY_UPDATE"
4210
4383
  # resp.patches[0].installed_time #=> Time
4211
4384
  # resp.patches[0].cve_ids #=> String
4212
4385
  # resp.next_token #=> String
@@ -4523,7 +4696,7 @@ module Aws::SSM
4523
4696
  #
4524
4697
  # * Values. An array of strings, each between 1 and 256 characters.
4525
4698
  # Supported values are date/time strings in a valid ISO 8601 date/time
4526
- # format, such as `2021-11-04T05:00:00Z`.
4699
+ # format, such as `2024-11-04T05:00:00Z`.
4527
4700
  #
4528
4701
  # @option params [Integer] :max_results
4529
4702
  # The maximum number of items to return for this call. The call also
@@ -4997,7 +5170,7 @@ module Aws::SSM
4997
5170
  #
4998
5171
  # **If you filter the response by using the OperationalData operator,
4999
5172
  # specify a key-value pair by using the following JSON format:
5000
- # \\\{"key":"key\_name","value":"a\_value"\\}
5173
+ # \{"key":"key\_name","value":"a\_value"}
5001
5174
  #
5002
5175
  # @option params [Integer] :max_results
5003
5176
  # The maximum number of items to return for this call. The call also
@@ -5020,7 +5193,7 @@ module Aws::SSM
5020
5193
  # resp = client.describe_ops_items({
5021
5194
  # ops_item_filters: [
5022
5195
  # {
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
5196
+ # 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
5197
  # values: ["OpsItemFilterValue"], # required
5025
5198
  # operator: "Equal", # required, accepts Equal, Contains, GreaterThan, LessThan
5026
5199
  # },
@@ -5039,7 +5212,7 @@ module Aws::SSM
5039
5212
  # resp.ops_item_summaries[0].last_modified_time #=> Time
5040
5213
  # resp.ops_item_summaries[0].priority #=> Integer
5041
5214
  # 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"
5215
+ # 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
5216
  # resp.ops_item_summaries[0].ops_item_id #=> String
5044
5217
  # resp.ops_item_summaries[0].title #=> String
5045
5218
  # resp.ops_item_summaries[0].operational_data #=> Hash
@@ -5262,6 +5435,7 @@ module Aws::SSM
5262
5435
  # * {Types::DescribePatchGroupStateResult#instances_with_critical_non_compliant_patches #instances_with_critical_non_compliant_patches} => Integer
5263
5436
  # * {Types::DescribePatchGroupStateResult#instances_with_security_non_compliant_patches #instances_with_security_non_compliant_patches} => Integer
5264
5437
  # * {Types::DescribePatchGroupStateResult#instances_with_other_non_compliant_patches #instances_with_other_non_compliant_patches} => Integer
5438
+ # * {Types::DescribePatchGroupStateResult#instances_with_available_security_updates #instances_with_available_security_updates} => Integer
5265
5439
  #
5266
5440
  # @example Request syntax with placeholder values
5267
5441
  #
@@ -5283,6 +5457,7 @@ module Aws::SSM
5283
5457
  # resp.instances_with_critical_non_compliant_patches #=> Integer
5284
5458
  # resp.instances_with_security_non_compliant_patches #=> Integer
5285
5459
  # resp.instances_with_other_non_compliant_patches #=> Integer
5460
+ # resp.instances_with_available_security_updates #=> Integer
5286
5461
  #
5287
5462
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupState AWS API Documentation
5288
5463
  #
@@ -5373,6 +5548,10 @@ module Aws::SSM
5373
5548
  #
5374
5549
  # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
5375
5550
  #
5551
+ # AMAZON\_LINUX\_2023
5552
+ #
5553
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
5554
+ #
5376
5555
  # CENTOS
5377
5556
  #
5378
5557
  # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
@@ -5528,8 +5707,8 @@ module Aws::SSM
5528
5707
 
5529
5708
  # Deletes the association between an OpsItem and a related item. For
5530
5709
  # 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.
5710
+ # from an OpsItem. Incident Manager is a tool in Amazon Web Services
5711
+ # Systems Manager.
5533
5712
  #
5534
5713
  # @option params [required, String] :ops_item_id
5535
5714
  # The ID of the OpsItem for which you want to delete an association
@@ -5557,6 +5736,39 @@ module Aws::SSM
5557
5736
  req.send_request(options)
5558
5737
  end
5559
5738
 
5739
+ # Returns a credentials set to be used with just-in-time node access.
5740
+ #
5741
+ # @option params [required, String] :access_request_id
5742
+ # The ID of a just-in-time node access request.
5743
+ #
5744
+ # @return [Types::GetAccessTokenResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5745
+ #
5746
+ # * {Types::GetAccessTokenResponse#credentials #credentials} => Types::Credentials
5747
+ # * {Types::GetAccessTokenResponse#access_request_status #access_request_status} => String
5748
+ #
5749
+ # @example Request syntax with placeholder values
5750
+ #
5751
+ # resp = client.get_access_token({
5752
+ # access_request_id: "AccessRequestId", # required
5753
+ # })
5754
+ #
5755
+ # @example Response structure
5756
+ #
5757
+ # resp.credentials.access_key_id #=> String
5758
+ # resp.credentials.secret_access_key #=> String
5759
+ # resp.credentials.session_token #=> String
5760
+ # resp.credentials.expiration_time #=> Time
5761
+ # resp.access_request_status #=> String, one of "Approved", "Rejected", "Revoked", "Expired", "Pending"
5762
+ #
5763
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAccessToken AWS API Documentation
5764
+ #
5765
+ # @overload get_access_token(params = {})
5766
+ # @param [Hash] params ({})
5767
+ def get_access_token(params = {}, options = {})
5768
+ req = build_request(:get_access_token, params)
5769
+ req.send_request(options)
5770
+ end
5771
+
5560
5772
  # Get detailed information about a particular Automation execution.
5561
5773
  #
5562
5774
  # @option params [required, String] :automation_execution_id
@@ -5627,6 +5839,15 @@ module Aws::SSM
5627
5839
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5628
5840
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.alarms #=> Array
5629
5841
  # resp.automation_execution.step_executions[0].target_location.target_location_alarm_configuration.alarms[0].name #=> String
5842
+ # resp.automation_execution.step_executions[0].target_location.include_child_organization_units #=> Boolean
5843
+ # resp.automation_execution.step_executions[0].target_location.exclude_accounts #=> Array
5844
+ # resp.automation_execution.step_executions[0].target_location.exclude_accounts[0] #=> String
5845
+ # resp.automation_execution.step_executions[0].target_location.targets #=> Array
5846
+ # resp.automation_execution.step_executions[0].target_location.targets[0].key #=> String
5847
+ # resp.automation_execution.step_executions[0].target_location.targets[0].values #=> Array
5848
+ # resp.automation_execution.step_executions[0].target_location.targets[0].values[0] #=> String
5849
+ # resp.automation_execution.step_executions[0].target_location.targets_max_concurrency #=> String
5850
+ # resp.automation_execution.step_executions[0].target_location.targets_max_errors #=> String
5630
5851
  # resp.automation_execution.step_executions[0].triggered_alarms #=> Array
5631
5852
  # resp.automation_execution.step_executions[0].triggered_alarms[0].name #=> String
5632
5853
  # resp.automation_execution.step_executions[0].triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
@@ -5674,6 +5895,15 @@ module Aws::SSM
5674
5895
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5675
5896
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.alarms #=> Array
5676
5897
  # resp.automation_execution.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
5898
+ # resp.automation_execution.target_locations[0].include_child_organization_units #=> Boolean
5899
+ # resp.automation_execution.target_locations[0].exclude_accounts #=> Array
5900
+ # resp.automation_execution.target_locations[0].exclude_accounts[0] #=> String
5901
+ # resp.automation_execution.target_locations[0].targets #=> Array
5902
+ # resp.automation_execution.target_locations[0].targets[0].key #=> String
5903
+ # resp.automation_execution.target_locations[0].targets[0].values #=> Array
5904
+ # resp.automation_execution.target_locations[0].targets[0].values[0] #=> String
5905
+ # resp.automation_execution.target_locations[0].targets_max_concurrency #=> String
5906
+ # resp.automation_execution.target_locations[0].targets_max_errors #=> String
5677
5907
  # resp.automation_execution.progress_counters.total_steps #=> Integer
5678
5908
  # resp.automation_execution.progress_counters.success_steps #=> Integer
5679
5909
  # resp.automation_execution.progress_counters.failed_steps #=> Integer
@@ -5685,7 +5915,8 @@ module Aws::SSM
5685
5915
  # resp.automation_execution.triggered_alarms #=> Array
5686
5916
  # resp.automation_execution.triggered_alarms[0].name #=> String
5687
5917
  # resp.automation_execution.triggered_alarms[0].state #=> String, one of "UNKNOWN", "ALARM"
5688
- # resp.automation_execution.automation_subtype #=> String, one of "ChangeRequest"
5918
+ # resp.automation_execution.target_locations_url #=> String
5919
+ # resp.automation_execution.automation_subtype #=> String, one of "ChangeRequest", "AccessRequest"
5689
5920
  # resp.automation_execution.scheduled_time #=> Time
5690
5921
  # resp.automation_execution.runbooks #=> Array
5691
5922
  # resp.automation_execution.runbooks[0].document_name #=> String
@@ -5715,6 +5946,15 @@ module Aws::SSM
5715
5946
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
5716
5947
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
5717
5948
  # resp.automation_execution.runbooks[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
5949
+ # resp.automation_execution.runbooks[0].target_locations[0].include_child_organization_units #=> Boolean
5950
+ # resp.automation_execution.runbooks[0].target_locations[0].exclude_accounts #=> Array
5951
+ # resp.automation_execution.runbooks[0].target_locations[0].exclude_accounts[0] #=> String
5952
+ # resp.automation_execution.runbooks[0].target_locations[0].targets #=> Array
5953
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].key #=> String
5954
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].values #=> Array
5955
+ # resp.automation_execution.runbooks[0].target_locations[0].targets[0].values[0] #=> String
5956
+ # resp.automation_execution.runbooks[0].target_locations[0].targets_max_concurrency #=> String
5957
+ # resp.automation_execution.runbooks[0].target_locations[0].targets_max_errors #=> String
5718
5958
  # resp.automation_execution.ops_item_id #=> String
5719
5959
  # resp.automation_execution.association_id #=> String
5720
5960
  # resp.automation_execution.change_request_name #=> String
@@ -5744,7 +5984,7 @@ module Aws::SSM
5744
5984
  # open. If one or more calendars in the request are closed, the status
5745
5985
  # returned is `CLOSED`.
5746
5986
  #
5747
- # For more information about Change Calendar, a capability of Amazon Web
5987
+ # For more information about Change Calendar, a tool in Amazon Web
5748
5988
  # Services Systems Manager, see [Amazon Web Services Systems Manager
5749
5989
  # Change Calendar][1] in the *Amazon Web Services Systems Manager User
5750
5990
  # Guide*.
@@ -5754,7 +5994,7 @@ module Aws::SSM
5754
5994
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html
5755
5995
  #
5756
5996
  # @option params [required, Array<String>] :calendar_names
5757
- # The names or Amazon Resource Names (ARNs) of the Systems Manager
5997
+ # The names of Amazon Resource Names (ARNs) of the Systems Manager
5758
5998
  # documents (SSM documents) that represent the calendar entries for
5759
5999
  # which you want to get the state.
5760
6000
  #
@@ -5796,7 +6036,12 @@ module Aws::SSM
5796
6036
  end
5797
6037
 
5798
6038
  # Returns detailed information about command execution for an invocation
5799
- # or plugin.
6039
+ # or plugin. The Run Command API follows an eventual consistency model,
6040
+ # due to the distributed nature of the system supporting the API. This
6041
+ # means that the result of an API command you run that affects your
6042
+ # resources might not be immediately visible to all subsequent commands
6043
+ # you run. You should keep this in mind when you carry out an API
6044
+ # command that immediately follows a previous API command.
5800
6045
  #
5801
6046
  # `GetCommandInvocation` only gives the execution status of a plugin in
5802
6047
  # a document. To get the command execution status on a specific managed
@@ -5966,8 +6211,8 @@ module Aws::SSM
5966
6211
  # Interface (CLI), the system attempts to use your local Amazon Web
5967
6212
  # Services credentials and the operation fails. To avoid this, you can
5968
6213
  # 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
6214
+ # Use Run Command, a tool in Amazon Web Services Systems Manager, with
6215
+ # an SSM document that enables you to target a managed node with a
5971
6216
  # script or command. For example, run the command using the
5972
6217
  # `AWS-RunShellScript` document or the `AWS-RunPowerShellScript`
5973
6218
  # document.
@@ -6037,6 +6282,7 @@ module Aws::SSM
6037
6282
  # configuration: "PatchSourceConfiguration", # required
6038
6283
  # },
6039
6284
  # ],
6285
+ # available_security_updates_compliance_status: "COMPLIANT", # accepts COMPLIANT, NON_COMPLIANT
6040
6286
  # },
6041
6287
  # })
6042
6288
  #
@@ -6109,7 +6355,7 @@ module Aws::SSM
6109
6355
  # resp.status #=> String, one of "Creating", "Active", "Updating", "Deleting", "Failed"
6110
6356
  # resp.status_information #=> String
6111
6357
  # 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"
6358
+ # 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
6359
  # resp.document_format #=> String, one of "YAML", "JSON", "TEXT"
6114
6360
  # resp.requires #=> Array
6115
6361
  # resp.requires[0].name #=> String
@@ -6133,6 +6379,78 @@ module Aws::SSM
6133
6379
  req.send_request(options)
6134
6380
  end
6135
6381
 
6382
+ # Initiates the process of retrieving an existing preview that shows the
6383
+ # effects that running a specified Automation runbook would have on the
6384
+ # targeted resources.
6385
+ #
6386
+ # @option params [required, String] :execution_preview_id
6387
+ # The ID of the existing execution preview.
6388
+ #
6389
+ # @return [Types::GetExecutionPreviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6390
+ #
6391
+ # * {Types::GetExecutionPreviewResponse#execution_preview_id #execution_preview_id} => String
6392
+ # * {Types::GetExecutionPreviewResponse#ended_at #ended_at} => Time
6393
+ # * {Types::GetExecutionPreviewResponse#status #status} => String
6394
+ # * {Types::GetExecutionPreviewResponse#status_message #status_message} => String
6395
+ # * {Types::GetExecutionPreviewResponse#execution_preview #execution_preview} => Types::ExecutionPreview
6396
+ #
6397
+ #
6398
+ # @example Example: GetExecutionPreview
6399
+ #
6400
+ # # This example illustrates one usage of GetExecutionPreview
6401
+ #
6402
+ # resp = client.get_execution_preview({
6403
+ # execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
6404
+ # })
6405
+ #
6406
+ # resp.to_h outputs the following:
6407
+ # {
6408
+ # ended_at: Time.parse("2024-11-13T01:50:39.424000+00:00"),
6409
+ # execution_preview: {
6410
+ # automation: {
6411
+ # regions: [
6412
+ # "us-east-2",
6413
+ # ],
6414
+ # step_previews: {
6415
+ # "Undetermined" => 1,
6416
+ # },
6417
+ # total_accounts: 1,
6418
+ # },
6419
+ # },
6420
+ # execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
6421
+ # status: "Success",
6422
+ # }
6423
+ #
6424
+ # @example Request syntax with placeholder values
6425
+ #
6426
+ # resp = client.get_execution_preview({
6427
+ # execution_preview_id: "ExecutionPreviewId", # required
6428
+ # })
6429
+ #
6430
+ # @example Response structure
6431
+ #
6432
+ # resp.execution_preview_id #=> String
6433
+ # resp.ended_at #=> Time
6434
+ # resp.status #=> String, one of "Pending", "InProgress", "Success", "Failed"
6435
+ # resp.status_message #=> String
6436
+ # resp.execution_preview.automation.step_previews #=> Hash
6437
+ # resp.execution_preview.automation.step_previews["ImpactType"] #=> Integer
6438
+ # resp.execution_preview.automation.regions #=> Array
6439
+ # resp.execution_preview.automation.regions[0] #=> String
6440
+ # resp.execution_preview.automation.target_previews #=> Array
6441
+ # resp.execution_preview.automation.target_previews[0].count #=> Integer
6442
+ # resp.execution_preview.automation.target_previews[0].target_type #=> String
6443
+ # resp.execution_preview.automation.total_accounts #=> Integer
6444
+ #
6445
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreview AWS API Documentation
6446
+ #
6447
+ # @overload get_execution_preview(params = {})
6448
+ # @param [Hash] params ({})
6449
+ def get_execution_preview(params = {}, options = {})
6450
+ req = build_request(:get_execution_preview, params)
6451
+ req.send_request(options)
6452
+ end
6453
+
6136
6454
  # Query inventory information. This includes managed node status, such
6137
6455
  # as `Stopped` or `Terminated`.
6138
6456
  #
@@ -6669,7 +6987,7 @@ module Aws::SSM
6669
6987
  # resp.ops_item.priority #=> Integer
6670
6988
  # resp.ops_item.related_ops_items #=> Array
6671
6989
  # 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"
6990
+ # 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
6991
  # resp.ops_item.ops_item_id #=> String
6674
6992
  # resp.ops_item.version #=> String
6675
6993
  # resp.ops_item.title #=> String
@@ -6857,7 +7175,7 @@ module Aws::SSM
6857
7175
  #
6858
7176
  #
6859
7177
  #
6860
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sharing.html
7178
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
6861
7179
  #
6862
7180
  # @option params [Boolean] :with_decryption
6863
7181
  # Return decrypted values for secure string parameters. This flag is
@@ -7037,8 +7355,8 @@ module Aws::SSM
7037
7355
  req.send_request(options)
7038
7356
  end
7039
7357
 
7040
- # Retrieve information about one or more parameters in a specific
7041
- # hierarchy.
7358
+ # Retrieve information about one or more parameters under a specified
7359
+ # level in a hierarchy.
7042
7360
  #
7043
7361
  # Request results are returned on a best-effort basis. If you specify
7044
7362
  # `MaxResults` in the request, the response includes information up to
@@ -7168,6 +7486,7 @@ module Aws::SSM
7168
7486
  # * {Types::GetPatchBaselineResult#modified_date #modified_date} => Time
7169
7487
  # * {Types::GetPatchBaselineResult#description #description} => String
7170
7488
  # * {Types::GetPatchBaselineResult#sources #sources} => Array&lt;Types::PatchSource&gt;
7489
+ # * {Types::GetPatchBaselineResult#available_security_updates_compliance_status #available_security_updates_compliance_status} => String
7171
7490
  #
7172
7491
  # @example Request syntax with placeholder values
7173
7492
  #
@@ -7210,6 +7529,7 @@ module Aws::SSM
7210
7529
  # resp.sources[0].products #=> Array
7211
7530
  # resp.sources[0].products[0] #=> String
7212
7531
  # resp.sources[0].configuration #=> String
7532
+ # resp.available_security_updates_compliance_status #=> String, one of "COMPLIANT", "NON_COMPLIANT"
7213
7533
  #
7214
7534
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaseline AWS API Documentation
7215
7535
  #
@@ -7329,16 +7649,20 @@ module Aws::SSM
7329
7649
  # The ID of the service setting to get. The setting ID can be one of the
7330
7650
  # following.
7331
7651
  #
7332
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
7652
+ # * `/ssm/appmanager/appmanager-enabled`
7333
7653
  #
7334
7654
  # * `/ssm/automation/customer-script-log-destination`
7335
7655
  #
7336
7656
  # * `/ssm/automation/customer-script-log-group-name`
7337
7657
  #
7658
+ # * /ssm/automation/enable-adaptive-concurrency
7659
+ #
7338
7660
  # * `/ssm/documents/console/public-sharing-permission`
7339
7661
  #
7340
7662
  # * `/ssm/managed-instance/activation-tier`
7341
7663
  #
7664
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
7665
+ #
7342
7666
  # * `/ssm/opsinsights/opscenter`
7343
7667
  #
7344
7668
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -7517,6 +7841,15 @@ module Aws::SSM
7517
7841
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
7518
7842
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.alarms #=> Array
7519
7843
  # resp.association_versions[0].target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
7844
+ # resp.association_versions[0].target_locations[0].include_child_organization_units #=> Boolean
7845
+ # resp.association_versions[0].target_locations[0].exclude_accounts #=> Array
7846
+ # resp.association_versions[0].target_locations[0].exclude_accounts[0] #=> String
7847
+ # resp.association_versions[0].target_locations[0].targets #=> Array
7848
+ # resp.association_versions[0].target_locations[0].targets[0].key #=> String
7849
+ # resp.association_versions[0].target_locations[0].targets[0].values #=> Array
7850
+ # resp.association_versions[0].target_locations[0].targets[0].values[0] #=> String
7851
+ # resp.association_versions[0].target_locations[0].targets_max_concurrency #=> String
7852
+ # resp.association_versions[0].target_locations[0].targets_max_errors #=> String
7520
7853
  # resp.association_versions[0].schedule_offset #=> Integer
7521
7854
  # resp.association_versions[0].duration #=> Integer
7522
7855
  # resp.association_versions[0].target_maps #=> Array
@@ -7537,8 +7870,8 @@ module Aws::SSM
7537
7870
  # Returns all State Manager associations in the current Amazon Web
7538
7871
  # Services account and Amazon Web Services Region. You can limit the
7539
7872
  # 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.
7873
+ # node by specifying a filter. State Manager is a tool in Amazon Web
7874
+ # Services Systems Manager.
7542
7875
  #
7543
7876
  # @option params [Array<Types::AssociationFilter>] :association_filter_list
7544
7877
  # One or more filters. Use a filter to return a more specific list of
@@ -8149,7 +8482,7 @@ module Aws::SSM
8149
8482
  # resp.document_identifiers[0].platform_types #=> Array
8150
8483
  # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
8151
8484
  # 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"
8485
+ # 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
8486
  # resp.document_identifiers[0].schema_version #=> String
8154
8487
  # resp.document_identifiers[0].document_format #=> String, one of "YAML", "JSON", "TEXT"
8155
8488
  # resp.document_identifiers[0].target_type #=> String
@@ -8240,6 +8573,258 @@ module Aws::SSM
8240
8573
  req.send_request(options)
8241
8574
  end
8242
8575
 
8576
+ # Takes in filters and returns a list of managed nodes matching the
8577
+ # filter criteria.
8578
+ #
8579
+ # @option params [String] :sync_name
8580
+ # The name of the Amazon Web Services managed resource data sync to
8581
+ # retrieve information about.
8582
+ #
8583
+ # For cross-account/cross-Region configurations, this parameter is
8584
+ # required, and the name of the supported resource data sync is
8585
+ # `AWS-QuickSetup-ManagedNode`.
8586
+ #
8587
+ # For single account/single-Region configurations, the parameter is not
8588
+ # required.
8589
+ #
8590
+ # @option params [Array<Types::NodeFilter>] :filters
8591
+ # One or more filters. Use a filter to return a more specific list of
8592
+ # managed nodes.
8593
+ #
8594
+ # @option params [String] :next_token
8595
+ # The token for the next set of items to return. (You received this
8596
+ # token from a previous call.)
8597
+ #
8598
+ # @option params [Integer] :max_results
8599
+ # The maximum number of items to return for this call. The call also
8600
+ # returns a token that you can specify in a subsequent call to get the
8601
+ # next set of results.
8602
+ #
8603
+ # @return [Types::ListNodesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8604
+ #
8605
+ # * {Types::ListNodesResult#nodes #nodes} => Array&lt;Types::Node&gt;
8606
+ # * {Types::ListNodesResult#next_token #next_token} => String
8607
+ #
8608
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8609
+ #
8610
+ #
8611
+ # @example Example: ListNodes
8612
+ #
8613
+ # # This example illustrates one usage of ListNodes
8614
+ #
8615
+ # resp = client.list_nodes({
8616
+ # filters: [
8617
+ # {
8618
+ # key: "Region",
8619
+ # type: "Equal",
8620
+ # values: [
8621
+ # "us-east-2",
8622
+ # ],
8623
+ # },
8624
+ # ],
8625
+ # max_results: 1,
8626
+ # sync_name: "AWS-QuickSetup-ManagedNode",
8627
+ # })
8628
+ #
8629
+ # resp.to_h outputs the following:
8630
+ # {
8631
+ # next_token: "A9lT8CAxj9aDFRi+MNAoFq08IEXAMPLE",
8632
+ # nodes: [
8633
+ # {
8634
+ # capture_time: Time.parse("2024-11-19T22:01:18"),
8635
+ # id: "i-02573cafcfEXAMPLE",
8636
+ # node_type: {
8637
+ # instance: {
8638
+ # agent_type: "amazon-ssm-agent",
8639
+ # agent_version: "3.3.859.0",
8640
+ # computer_name: "ip-192.0.2.0.ec2.internal",
8641
+ # instance_status: "Active",
8642
+ # ip_address: "192.0.2.0",
8643
+ # managed_status: "Managed",
8644
+ # platform_name: "Amazon Linux",
8645
+ # platform_type: "Linux",
8646
+ # platform_version: "2023",
8647
+ # resource_type: "EC2Instance",
8648
+ # },
8649
+ # },
8650
+ # owner: {
8651
+ # account_id: "111122223333",
8652
+ # organizational_unit_id: "ou-b8dn-sasv9tfp",
8653
+ # organizational_unit_path: "r-b8dn/ou-b8dn-sasv9tfp",
8654
+ # },
8655
+ # region: "us-east-2",
8656
+ # },
8657
+ # ],
8658
+ # }
8659
+ #
8660
+ # @example Request syntax with placeholder values
8661
+ #
8662
+ # resp = client.list_nodes({
8663
+ # sync_name: "ResourceDataSyncName",
8664
+ # filters: [
8665
+ # {
8666
+ # key: "AgentType", # required, accepts AgentType, AgentVersion, ComputerName, InstanceId, InstanceStatus, IpAddress, ManagedStatus, PlatformName, PlatformType, PlatformVersion, ResourceType, OrganizationalUnitId, OrganizationalUnitPath, Region, AccountId
8667
+ # values: ["NodeFilterValue"], # required
8668
+ # type: "Equal", # accepts Equal, NotEqual, BeginWith
8669
+ # },
8670
+ # ],
8671
+ # next_token: "NextToken",
8672
+ # max_results: 1,
8673
+ # })
8674
+ #
8675
+ # @example Response structure
8676
+ #
8677
+ # resp.nodes #=> Array
8678
+ # resp.nodes[0].capture_time #=> Time
8679
+ # resp.nodes[0].id #=> String
8680
+ # resp.nodes[0].owner.account_id #=> String
8681
+ # resp.nodes[0].owner.organizational_unit_id #=> String
8682
+ # resp.nodes[0].owner.organizational_unit_path #=> String
8683
+ # resp.nodes[0].region #=> String
8684
+ # resp.nodes[0].node_type.instance.agent_type #=> String
8685
+ # resp.nodes[0].node_type.instance.agent_version #=> String
8686
+ # resp.nodes[0].node_type.instance.computer_name #=> String
8687
+ # resp.nodes[0].node_type.instance.instance_status #=> String
8688
+ # resp.nodes[0].node_type.instance.ip_address #=> String
8689
+ # resp.nodes[0].node_type.instance.managed_status #=> String, one of "All", "Managed", "Unmanaged"
8690
+ # resp.nodes[0].node_type.instance.platform_type #=> String, one of "Windows", "Linux", "MacOS"
8691
+ # resp.nodes[0].node_type.instance.platform_name #=> String
8692
+ # resp.nodes[0].node_type.instance.platform_version #=> String
8693
+ # resp.nodes[0].node_type.instance.resource_type #=> String, one of "ManagedInstance", "EC2Instance"
8694
+ # resp.next_token #=> String
8695
+ #
8696
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodes AWS API Documentation
8697
+ #
8698
+ # @overload list_nodes(params = {})
8699
+ # @param [Hash] params ({})
8700
+ def list_nodes(params = {}, options = {})
8701
+ req = build_request(:list_nodes, params)
8702
+ req.send_request(options)
8703
+ end
8704
+
8705
+ # Generates a summary of managed instance/node metadata based on the
8706
+ # filters and aggregators you specify. Results are grouped by the input
8707
+ # aggregator you specify.
8708
+ #
8709
+ # @option params [String] :sync_name
8710
+ # The name of the Amazon Web Services managed resource data sync to
8711
+ # retrieve information about.
8712
+ #
8713
+ # For cross-account/cross-Region configurations, this parameter is
8714
+ # required, and the name of the supported resource data sync is
8715
+ # `AWS-QuickSetup-ManagedNode`.
8716
+ #
8717
+ # For single account/single-Region configurations, the parameter is not
8718
+ # required.
8719
+ #
8720
+ # @option params [Array<Types::NodeFilter>] :filters
8721
+ # One or more filters. Use a filter to generate a summary that matches
8722
+ # your specified filter criteria.
8723
+ #
8724
+ # @option params [required, Array<Types::NodeAggregator>] :aggregators
8725
+ # Specify one or more aggregators to return a count of managed nodes
8726
+ # that match that expression. For example, a count of managed nodes by
8727
+ # operating system.
8728
+ #
8729
+ # @option params [String] :next_token
8730
+ # The token for the next set of items to return. (You received this
8731
+ # token from a previous call.) The call also returns a token that you
8732
+ # can specify in a subsequent call to get the next set of results.
8733
+ #
8734
+ # @option params [Integer] :max_results
8735
+ # The maximum number of items to return for this call. The call also
8736
+ # returns a token that you can specify in a subsequent call to get the
8737
+ # next set of results.
8738
+ #
8739
+ # @return [Types::ListNodesSummaryResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8740
+ #
8741
+ # * {Types::ListNodesSummaryResult#summary #summary} => Array&lt;Hash&lt;String,String&gt;&gt;
8742
+ # * {Types::ListNodesSummaryResult#next_token #next_token} => String
8743
+ #
8744
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8745
+ #
8746
+ #
8747
+ # @example Example: ListNodesSummary
8748
+ #
8749
+ # # This example illustrates one usage of ListNodesSummary
8750
+ #
8751
+ # resp = client.list_nodes_summary({
8752
+ # aggregators: [
8753
+ # {
8754
+ # aggregator_type: "Count",
8755
+ # attribute_name: "Region",
8756
+ # type_name: "Instance",
8757
+ # },
8758
+ # ],
8759
+ # filters: [
8760
+ # {
8761
+ # key: "InstanceStatus",
8762
+ # type: "Equal",
8763
+ # values: [
8764
+ # "Active",
8765
+ # ],
8766
+ # },
8767
+ # ],
8768
+ # max_results: 2,
8769
+ # next_token: "A9lT8CAxj9aDFRi+MNAoFq08I---EXAMPLE",
8770
+ # sync_name: "AWS-QuickSetup-ManagedNode",
8771
+ # })
8772
+ #
8773
+ # resp.to_h outputs the following:
8774
+ # {
8775
+ # summary: [
8776
+ # {
8777
+ # "Count" => "26",
8778
+ # "Region" => "us-east-1",
8779
+ # },
8780
+ # {
8781
+ # "Count" => "7",
8782
+ # "Region" => "us-east-2",
8783
+ # },
8784
+ # ],
8785
+ # }
8786
+ #
8787
+ # @example Request syntax with placeholder values
8788
+ #
8789
+ # resp = client.list_nodes_summary({
8790
+ # sync_name: "ResourceDataSyncName",
8791
+ # filters: [
8792
+ # {
8793
+ # key: "AgentType", # required, accepts AgentType, AgentVersion, ComputerName, InstanceId, InstanceStatus, IpAddress, ManagedStatus, PlatformName, PlatformType, PlatformVersion, ResourceType, OrganizationalUnitId, OrganizationalUnitPath, Region, AccountId
8794
+ # values: ["NodeFilterValue"], # required
8795
+ # type: "Equal", # accepts Equal, NotEqual, BeginWith
8796
+ # },
8797
+ # ],
8798
+ # aggregators: [ # required
8799
+ # {
8800
+ # aggregator_type: "Count", # required, accepts Count
8801
+ # type_name: "Instance", # required, accepts Instance
8802
+ # attribute_name: "AgentVersion", # required, accepts AgentVersion, PlatformName, PlatformType, PlatformVersion, Region, ResourceType
8803
+ # aggregators: {
8804
+ # # recursive NodeAggregatorList
8805
+ # },
8806
+ # },
8807
+ # ],
8808
+ # next_token: "NextToken",
8809
+ # max_results: 1,
8810
+ # })
8811
+ #
8812
+ # @example Response structure
8813
+ #
8814
+ # resp.summary #=> Array
8815
+ # resp.summary[0] #=> Hash
8816
+ # resp.summary[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
8817
+ # resp.next_token #=> String
8818
+ #
8819
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummary AWS API Documentation
8820
+ #
8821
+ # @overload list_nodes_summary(params = {})
8822
+ # @param [Hash] params ({})
8823
+ def list_nodes_summary(params = {}, options = {})
8824
+ req = build_request(:list_nodes_summary, params)
8825
+ req.send_request(options)
8826
+ end
8827
+
8243
8828
  # Returns a list of all OpsItem events in the current Amazon Web
8244
8829
  # Services Region and Amazon Web Services account. You can limit the
8245
8830
  # results to events associated with specific OpsItems by specifying a
@@ -8301,8 +8886,8 @@ module Aws::SSM
8301
8886
  end
8302
8887
 
8303
8888
  # Lists all related-item resources associated with a Systems Manager
8304
- # OpsCenter OpsItem. OpsCenter is a capability of Amazon Web Services
8305
- # Systems Manager.
8889
+ # OpsCenter OpsItem. OpsCenter is a tool in Amazon Web Services Systems
8890
+ # Manager.
8306
8891
  #
8307
8892
  # @option params [String] :ops_item_id
8308
8893
  # The ID of the OpsItem for which you want to list all related-item
@@ -8628,14 +9213,17 @@ module Aws::SSM
8628
9213
  #
8629
9214
  # @option params [Array<String>] :account_ids_to_add
8630
9215
  # 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*.
9216
+ # The account IDs can either be a group of account IDs or *All*. You
9217
+ # must specify a value for this parameter or the `AccountIdsToRemove`
9218
+ # parameter.
8632
9219
  #
8633
9220
  # @option params [Array<String>] :account_ids_to_remove
8634
9221
  # The Amazon Web Services users that should no longer have access to the
8635
9222
  # document. The Amazon Web Services user can either be a group of
8636
9223
  # account IDs or *All*. This action has a higher priority than
8637
9224
  # `AccountIdsToAdd`. If you specify an ID to add and the same ID to
8638
- # remove, the system removes access to the document.
9225
+ # remove, the system removes access to the document. You must specify a
9226
+ # value for this parameter or the `AccountIdsToAdd` parameter.
8639
9227
  #
8640
9228
  # @option params [String] :shared_document_version
8641
9229
  # (Optional) The version of the document to share. If it isn't
@@ -8837,11 +9425,11 @@ module Aws::SSM
8837
9425
  req.send_request(options)
8838
9426
  end
8839
9427
 
8840
- # Add a parameter to the system.
9428
+ # Create or update a parameter in Parameter Store.
8841
9429
  #
8842
9430
  # @option params [required, String] :name
8843
- # The fully qualified name of the parameter that you want to add to the
8844
- # system.
9431
+ # The fully qualified name of the parameter that you want to create or
9432
+ # update.
8845
9433
  #
8846
9434
  # <note markdown="1"> You can't enter the Amazon Resource Name (ARN) for a parameter, only
8847
9435
  # the parameter name itself.
@@ -8878,11 +9466,16 @@ module Aws::SSM
8878
9466
  # [Creating Systems Manager parameters][1] in the *Amazon Web Services
8879
9467
  # Systems Manager User Guide*.
8880
9468
  #
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
9469
+ # <note markdown="1"> The reported maximum length of 2048 characters for a parameter name
9470
+ # includes 1037 characters that are reserved for internal use by Systems
9471
+ # Manager. The maximum length for a parameter name that you specify is
9472
+ # 1011 characters.
9473
+ #
9474
+ # This count of 1011 characters includes the characters in the ARN that
9475
+ # precede the name you specify. This ARN length will vary depending on
9476
+ # your partition and Region. For example, the following 45 characters
9477
+ # count toward the 1011 character maximum for a parameter created in the
9478
+ # US East (Ohio) Region:
8886
9479
  # `arn:aws:ssm:us-east-2:111122223333:parameter/`.
8887
9480
  #
8888
9481
  # </note>
@@ -8903,13 +9496,13 @@ module Aws::SSM
8903
9496
  # value limit of 8 KB.
8904
9497
  #
8905
9498
  # <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.
9499
+ # parameters. You can't include values wrapped in double brackets
9500
+ # `{{}}` or `{{ssm:parameter-name}}` in a parameter value.
8908
9501
  #
8909
9502
  # </note>
8910
9503
  #
8911
9504
  # @option params [String] :type
8912
- # The type of parameter that you want to add to the system.
9505
+ # The type of parameter that you want to create.
8913
9506
  #
8914
9507
  # <note markdown="1"> `SecureString` isn't currently supported for CloudFormation
8915
9508
  # templates.
@@ -8930,7 +9523,7 @@ module Aws::SSM
8930
9523
  # parameters that use the `SecureString` data type.
8931
9524
  #
8932
9525
  # 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
9526
+ # associated with your Amazon Web Services account, which is not as
8934
9527
  # secure as using a custom key.
8935
9528
  #
8936
9529
  # * To use a custom KMS key, choose the `SecureString` data type with
@@ -9044,8 +9637,8 @@ module Aws::SSM
9044
9637
  #
9045
9638
  # @option params [String] :policies
9046
9639
  # 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:
9640
+ # JSON array. Parameter Store, a tool in Amazon Web Services Systems
9641
+ # Manager supports the following policy types:
9049
9642
  #
9050
9643
  # Expiration: This policy deletes the parameter after it expires. When
9051
9644
  # you create the policy, you specify the expiration date. You can update
@@ -9463,7 +10056,7 @@ module Aws::SSM
9463
10056
  # creating a custom policy and custom service role for running your
9464
10057
  # maintenance window tasks. The policy can be crafted to provide only
9465
10058
  # the permissions needed for your particular maintenance window tasks.
9466
- # For more information, see [Setting up maintenance windows][1] in the
10059
+ # For more information, see [Setting up Maintenance Windows][1] in the
9467
10060
  # in the *Amazon Web Services Systems Manager User Guide*.
9468
10061
  #
9469
10062
  #
@@ -9576,7 +10169,6 @@ module Aws::SSM
9576
10169
  # command associated with the task. However, there is no guarantee
9577
10170
  # that the command will be terminated and the underlying process
9578
10171
  # stopped.
9579
- #
9580
10172
  # The status for tasks that are not completed is `TIMED_OUT`.
9581
10173
  #
9582
10174
  # @option params [Types::AlarmConfiguration] :alarm_configuration
@@ -9764,16 +10356,20 @@ module Aws::SSM
9764
10356
  # The Amazon Resource Name (ARN) of the service setting to reset. The
9765
10357
  # setting ID can be one of the following.
9766
10358
  #
9767
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
10359
+ # * `/ssm/appmanager/appmanager-enabled`
9768
10360
  #
9769
10361
  # * `/ssm/automation/customer-script-log-destination`
9770
10362
  #
9771
10363
  # * `/ssm/automation/customer-script-log-group-name`
9772
10364
  #
10365
+ # * /ssm/automation/enable-adaptive-concurrency
10366
+ #
9773
10367
  # * `/ssm/documents/console/public-sharing-permission`
9774
10368
  #
9775
10369
  # * `/ssm/managed-instance/activation-tier`
9776
10370
  #
10371
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
10372
+ #
9777
10373
  # * `/ssm/opsinsights/opscenter`
9778
10374
  #
9779
10375
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -9883,7 +10479,7 @@ module Aws::SSM
9883
10479
  #
9884
10480
  # resp = client.send_automation_signal({
9885
10481
  # automation_execution_id: "AutomationExecutionId", # required
9886
- # signal_type: "Approve", # required, accepts Approve, Reject, StartStep, StopStep, Resume
10482
+ # signal_type: "Approve", # required, accepts Approve, Reject, StartStep, StopStep, Resume, Revoke
9887
10483
  # payload: {
9888
10484
  # "AutomationParameterKey" => ["AutomationParameterValue"],
9889
10485
  # },
@@ -10051,7 +10647,7 @@ module Aws::SSM
10051
10647
  #
10052
10648
  # @option params [Types::CloudWatchOutputConfig] :cloud_watch_output_config
10053
10649
  # Enables Amazon Web Services Systems Manager to send Run Command output
10054
- # to Amazon CloudWatch Logs. Run Command is a capability of Amazon Web
10650
+ # to Amazon CloudWatch Logs. Run Command is a tool in Amazon Web
10055
10651
  # Services Systems Manager.
10056
10652
  #
10057
10653
  # @option params [Types::AlarmConfiguration] :alarm_configuration
@@ -10157,6 +10753,53 @@ module Aws::SSM
10157
10753
  req.send_request(options)
10158
10754
  end
10159
10755
 
10756
+ # Starts the workflow for just-in-time node access sessions.
10757
+ #
10758
+ # @option params [required, String] :reason
10759
+ # A brief description explaining why you are requesting access to the
10760
+ # node.
10761
+ #
10762
+ # @option params [required, Array<Types::Target>] :targets
10763
+ # The node you are requesting access to.
10764
+ #
10765
+ # @option params [Array<Types::Tag>] :tags
10766
+ # Key-value pairs of metadata you want to assign to the access request.
10767
+ #
10768
+ # @return [Types::StartAccessRequestResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10769
+ #
10770
+ # * {Types::StartAccessRequestResponse#access_request_id #access_request_id} => String
10771
+ #
10772
+ # @example Request syntax with placeholder values
10773
+ #
10774
+ # resp = client.start_access_request({
10775
+ # reason: "String1to256", # required
10776
+ # targets: [ # required
10777
+ # {
10778
+ # key: "TargetKey",
10779
+ # values: ["TargetValue"],
10780
+ # },
10781
+ # ],
10782
+ # tags: [
10783
+ # {
10784
+ # key: "TagKey", # required
10785
+ # value: "TagValue", # required
10786
+ # },
10787
+ # ],
10788
+ # })
10789
+ #
10790
+ # @example Response structure
10791
+ #
10792
+ # resp.access_request_id #=> String
10793
+ #
10794
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAccessRequest AWS API Documentation
10795
+ #
10796
+ # @overload start_access_request(params = {})
10797
+ # @param [Hash] params ({})
10798
+ def start_access_request(params = {}, options = {})
10799
+ req = build_request(:start_access_request, params)
10800
+ req.send_request(options)
10801
+ end
10802
+
10160
10803
  # Runs an association immediately and only one time. This operation can
10161
10804
  # be helpful when troubleshooting associations.
10162
10805
  #
@@ -10217,6 +10860,9 @@ module Aws::SSM
10217
10860
  # A key-value mapping to target resources. Required if you specify
10218
10861
  # TargetParameterName.
10219
10862
  #
10863
+ # If both this parameter and the `TargetLocation:Targets` parameter are
10864
+ # supplied, `TargetLocation:Targets` takes precedence.
10865
+ #
10220
10866
  # @option params [Array<Hash>] :target_maps
10221
10867
  # A key-value mapping of document parameters to target resources. Both
10222
10868
  # Targets and TargetMaps can't be specified together.
@@ -10226,6 +10872,9 @@ module Aws::SSM
10226
10872
  # You can specify a number, such as 10, or a percentage, such as 10%.
10227
10873
  # The default value is `10`.
10228
10874
  #
10875
+ # If both this parameter and the `TargetLocation:TargetsMaxConcurrency`
10876
+ # are supplied, `TargetLocation:TargetsMaxConcurrency` takes precedence.
10877
+ #
10229
10878
  # @option params [String] :max_errors
10230
10879
  # The number of errors that are allowed before the system stops running
10231
10880
  # the automation on additional targets. You can specify either an
@@ -10244,14 +10893,17 @@ module Aws::SSM
10244
10893
  # max-errors failed executions, set max-concurrency to 1 so the
10245
10894
  # executions proceed one at a time.
10246
10895
  #
10896
+ # If this parameter and the `TargetLocation:TargetsMaxErrors` parameter
10897
+ # are both supplied, `TargetLocation:TargetsMaxErrors` takes precedence.
10898
+ #
10247
10899
  # @option params [Array<Types::TargetLocation>] :target_locations
10248
10900
  # A location is a combination of Amazon Web Services Regions and/or
10249
10901
  # Amazon Web Services accounts where you want to run the automation. Use
10250
10902
  # this operation to start an automation in multiple Amazon Web Services
10251
10903
  # 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*.
10904
+ # information, see [Running automations in multiple Amazon Web Services
10905
+ # Regions and accounts][1] in the *Amazon Web Services Systems Manager
10906
+ # User Guide*.
10255
10907
  #
10256
10908
  #
10257
10909
  #
@@ -10269,14 +10921,22 @@ module Aws::SSM
10269
10921
  #
10270
10922
  # * `Key=OS,Value=Windows`
10271
10923
  #
10272
- # <note markdown="1"> To add tags to an existing automation, use the AddTagsToResource
10273
- # operation.
10924
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
10925
+ # includes capacity reserved for internal operations. When calling the
10926
+ # `StartAutomationExecution` action, you can specify a maximum of 5
10927
+ # tags. You can, however, use the AddTagsToResource action to add up to
10928
+ # a total of 50 tags to an existing automation configuration.
10274
10929
  #
10275
10930
  # </note>
10276
10931
  #
10277
10932
  # @option params [Types::AlarmConfiguration] :alarm_configuration
10278
10933
  # The CloudWatch alarm you want to apply to your automation.
10279
10934
  #
10935
+ # @option params [String] :target_locations_url
10936
+ # Specify a publicly accessible URL for a file that contains the
10937
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
10938
+ # buckets are supported.
10939
+ #
10280
10940
  # @return [Types::StartAutomationExecutionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10281
10941
  #
10282
10942
  # * {Types::StartAutomationExecutionResult#automation_execution_id #automation_execution_id} => String
@@ -10320,6 +10980,16 @@ module Aws::SSM
10320
10980
  # },
10321
10981
  # ],
10322
10982
  # },
10983
+ # include_child_organization_units: false,
10984
+ # exclude_accounts: ["ExcludeAccount"],
10985
+ # targets: [
10986
+ # {
10987
+ # key: "TargetKey",
10988
+ # values: ["TargetValue"],
10989
+ # },
10990
+ # ],
10991
+ # targets_max_concurrency: "MaxConcurrency",
10992
+ # targets_max_errors: "MaxErrors",
10323
10993
  # },
10324
10994
  # ],
10325
10995
  # tags: [
@@ -10336,6 +11006,7 @@ module Aws::SSM
10336
11006
  # },
10337
11007
  # ],
10338
11008
  # },
11009
+ # target_locations_url: "TargetLocationsURL",
10339
11010
  # })
10340
11011
  #
10341
11012
  # @example Response structure
@@ -10423,6 +11094,14 @@ module Aws::SSM
10423
11094
  #
10424
11095
  # * `Key=Region,Value=us-east-2`
10425
11096
  #
11097
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
11098
+ # includes capacity reserved for internal operations. When calling the
11099
+ # `StartChangeRequestExecution` action, you can specify a maximum of 5
11100
+ # tags. You can, however, use the AddTagsToResource action to add up to
11101
+ # a total of 50 tags to an existing change request configuration.
11102
+ #
11103
+ # </note>
11104
+ #
10426
11105
  # @option params [Time,DateTime,Date,Integer,String] :scheduled_end_time
10427
11106
  # The time that the requester expects the runbook workflow related to
10428
11107
  # the change request to complete. The time is an estimate only that the
@@ -10485,6 +11164,16 @@ module Aws::SSM
10485
11164
  # },
10486
11165
  # ],
10487
11166
  # },
11167
+ # include_child_organization_units: false,
11168
+ # exclude_accounts: ["ExcludeAccount"],
11169
+ # targets: [
11170
+ # {
11171
+ # key: "TargetKey",
11172
+ # values: ["TargetValue"],
11173
+ # },
11174
+ # ],
11175
+ # targets_max_concurrency: "MaxConcurrency",
11176
+ # targets_max_errors: "MaxErrors",
10488
11177
  # },
10489
11178
  # ],
10490
11179
  # },
@@ -10512,6 +11201,107 @@ module Aws::SSM
10512
11201
  req.send_request(options)
10513
11202
  end
10514
11203
 
11204
+ # Initiates the process of creating a preview showing the effects that
11205
+ # running a specified Automation runbook would have on the targeted
11206
+ # resources.
11207
+ #
11208
+ # @option params [required, String] :document_name
11209
+ # The name of the Automation runbook to run. The result of the execution
11210
+ # preview indicates what the impact would be of running this runbook.
11211
+ #
11212
+ # @option params [String] :document_version
11213
+ # The version of the Automation runbook to run. The default value is
11214
+ # `$DEFAULT`.
11215
+ #
11216
+ # @option params [Types::ExecutionInputs] :execution_inputs
11217
+ # Information about the inputs that can be specified for the preview
11218
+ # operation.
11219
+ #
11220
+ # @return [Types::StartExecutionPreviewResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
11221
+ #
11222
+ # * {Types::StartExecutionPreviewResponse#execution_preview_id #execution_preview_id} => String
11223
+ #
11224
+ #
11225
+ # @example Example: StartExecutionPreview
11226
+ #
11227
+ # # This example illustrates one usage of StartExecutionPreview
11228
+ #
11229
+ # resp = client.start_execution_preview({
11230
+ # document_name: "AWS-StartEC2Instance",
11231
+ # })
11232
+ #
11233
+ # resp.to_h outputs the following:
11234
+ # {
11235
+ # execution_preview_id: "2f27d6e5-9676-4708-b8bd-aef0ab47bb26",
11236
+ # }
11237
+ #
11238
+ # @example Request syntax with placeholder values
11239
+ #
11240
+ # resp = client.start_execution_preview({
11241
+ # document_name: "DocumentName", # required
11242
+ # document_version: "DocumentVersion",
11243
+ # execution_inputs: {
11244
+ # automation: {
11245
+ # parameters: {
11246
+ # "AutomationParameterKey" => ["AutomationParameterValue"],
11247
+ # },
11248
+ # target_parameter_name: "AutomationParameterKey",
11249
+ # targets: [
11250
+ # {
11251
+ # key: "TargetKey",
11252
+ # values: ["TargetValue"],
11253
+ # },
11254
+ # ],
11255
+ # target_maps: [
11256
+ # {
11257
+ # "TargetMapKey" => ["TargetMapValue"],
11258
+ # },
11259
+ # ],
11260
+ # target_locations: [
11261
+ # {
11262
+ # accounts: ["Account"],
11263
+ # regions: ["Region"],
11264
+ # target_location_max_concurrency: "MaxConcurrency",
11265
+ # target_location_max_errors: "MaxErrors",
11266
+ # execution_role_name: "ExecutionRoleName",
11267
+ # target_location_alarm_configuration: {
11268
+ # ignore_poll_alarm_failure: false,
11269
+ # alarms: [ # required
11270
+ # {
11271
+ # name: "AlarmName", # required
11272
+ # },
11273
+ # ],
11274
+ # },
11275
+ # include_child_organization_units: false,
11276
+ # exclude_accounts: ["ExcludeAccount"],
11277
+ # targets: [
11278
+ # {
11279
+ # key: "TargetKey",
11280
+ # values: ["TargetValue"],
11281
+ # },
11282
+ # ],
11283
+ # targets_max_concurrency: "MaxConcurrency",
11284
+ # targets_max_errors: "MaxErrors",
11285
+ # },
11286
+ # ],
11287
+ # target_locations_url: "TargetLocationsURL",
11288
+ # },
11289
+ # },
11290
+ # })
11291
+ #
11292
+ # @example Response structure
11293
+ #
11294
+ # resp.execution_preview_id #=> String
11295
+ #
11296
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreview AWS API Documentation
11297
+ #
11298
+ # @overload start_execution_preview(params = {})
11299
+ # @param [Hash] params ({})
11300
+ def start_execution_preview(params = {}, options = {})
11301
+ req = build_request(:start_execution_preview, params)
11302
+ req.send_request(options)
11303
+ end
11304
+
10515
11305
  # Initiates a connection to a target (for example, a managed node) for a
10516
11306
  # Session Manager session. Returns a URL and token that can be used to
10517
11307
  # open a WebSocket connection for sending input and receiving outputs.
@@ -10555,7 +11345,13 @@ module Aws::SSM
10555
11345
  #
10556
11346
  # @option params [Hash<String,Array>] :parameters
10557
11347
  # The values you want to specify for the parameters defined in the
10558
- # Session document.
11348
+ # Session document. For more information about these parameters, see
11349
+ # [Create a Session Manager preferences document][1] in the *Amazon Web
11350
+ # Services Systems Manager User Guide*.
11351
+ #
11352
+ #
11353
+ #
11354
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-create-preferences-cli.html
10559
11355
  #
10560
11356
  # @return [Types::StartSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10561
11357
  #
@@ -10722,9 +11518,9 @@ module Aws::SSM
10722
11518
  #
10723
11519
  # @option params [Hash<String,Array>] :parameters
10724
11520
  # 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\}\}`.
11521
+ # parameter using Parameter Store, a tool in Amazon Web Services Systems
11522
+ # Manager, you can reference the parameter using
11523
+ # `{{ssm:parameter-name}}`.
10728
11524
  #
10729
11525
  # @option params [String] :document_version
10730
11526
  # The document version you want update for the association.
@@ -10782,7 +11578,7 @@ module Aws::SSM
10782
11578
  # Choose the parameter that will define how your automation will branch
10783
11579
  # out. This target is required for associations that use an Automation
10784
11580
  # runbook and target resources by using rate controls. Automation is a
10785
- # capability of Amazon Web Services Systems Manager.
11581
+ # tool in Amazon Web Services Systems Manager.
10786
11582
  #
10787
11583
  # @option params [String] :max_errors
10788
11584
  # The number of errors that are allowed before the system stops sending
@@ -10826,8 +11622,8 @@ module Aws::SSM
10826
11622
  #
10827
11623
  # In `MANUAL` mode, you must specify the `AssociationId` as a parameter
10828
11624
  # 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
11625
+ # data isn't managed by State Manager, a tool in Amazon Web Services
11626
+ # Systems Manager. It is managed by your direct call to the
10831
11627
  # PutComplianceItems API operation.
10832
11628
  #
10833
11629
  # By default, all associations use `AUTO` mode.
@@ -10835,32 +11631,43 @@ module Aws::SSM
10835
11631
  # @option params [Boolean] :apply_only_at_cron_interval
10836
11632
  # By default, when you update an association, the system runs it
10837
11633
  # 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.
11634
+ # specified. Specify `true` for `ApplyOnlyAtCronInterval` if you want
11635
+ # the association to run only according to the schedule you specified.
10841
11636
  #
10842
11637
  # 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
11638
+ # edit that association or you make changes to the Automation runbook or
11639
+ # SSM document on which that association is based, State Manager applies
11640
+ # the association at the next specified cron interval. For example, if
11641
+ # you chose the `Latest` version of an SSM document when you created an
11642
+ # association and you edit the association by choosing a different
11643
+ # document version on the Documents page, State Manager applies the
11644
+ # association at the next specified cron interval if you previously set
11645
+ # `ApplyOnlyAtCronInterval` to `true`. If this option wasn't selected,
11646
+ # State Manager immediately runs the association.
11647
+ #
11648
+ # For more information, see [Understanding when associations are applied
11649
+ # to resources][1] and [About target updates with Automation
11650
+ # runbooks][2] in the *Amazon Web Services Systems Manager User Guide*.
11651
+ #
11652
+ # This parameter isn't supported for rate expressions.
11653
+ #
11654
+ # You can reset this parameter. To do so, specify the
10854
11655
  # `no-apply-only-at-cron-interval` parameter when you update the
10855
11656
  # association from the command line. This parameter forces the
10856
11657
  # association to run immediately after updating it and according to the
10857
11658
  # interval specified.
10858
11659
  #
11660
+ #
11661
+ #
11662
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
11663
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
11664
+ #
10859
11665
  # @option params [Array<String>] :calendar_names
10860
11666
  # The names or Amazon Resource Names (ARNs) of the Change Calendar type
10861
11667
  # documents you want to gate your associations under. The associations
10862
11668
  # only run when that change calendar is open. For more information, see
10863
- # [Amazon Web Services Systems Manager Change Calendar][1].
11669
+ # [Amazon Web Services Systems Manager Change Calendar][1] in the
11670
+ # *Amazon Web Services Systems Manager User Guide*.
10864
11671
  #
10865
11672
  #
10866
11673
  #
@@ -10968,6 +11775,16 @@ module Aws::SSM
10968
11775
  # },
10969
11776
  # ],
10970
11777
  # },
11778
+ # include_child_organization_units: false,
11779
+ # exclude_accounts: ["ExcludeAccount"],
11780
+ # targets: [
11781
+ # {
11782
+ # key: "TargetKey",
11783
+ # values: ["TargetValue"],
11784
+ # },
11785
+ # ],
11786
+ # targets_max_concurrency: "MaxConcurrency",
11787
+ # targets_max_errors: "MaxErrors",
10971
11788
  # },
10972
11789
  # ],
10973
11790
  # schedule_offset: 1,
@@ -11037,6 +11854,15 @@ module Aws::SSM
11037
11854
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
11038
11855
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
11039
11856
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
11857
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
11858
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
11859
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
11860
+ # resp.association_description.target_locations[0].targets #=> Array
11861
+ # resp.association_description.target_locations[0].targets[0].key #=> String
11862
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
11863
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
11864
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
11865
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
11040
11866
  # resp.association_description.schedule_offset #=> Integer
11041
11867
  # resp.association_description.duration #=> Integer
11042
11868
  # resp.association_description.target_maps #=> Array
@@ -11143,6 +11969,15 @@ module Aws::SSM
11143
11969
  # resp.association_description.target_locations[0].target_location_alarm_configuration.ignore_poll_alarm_failure #=> Boolean
11144
11970
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms #=> Array
11145
11971
  # resp.association_description.target_locations[0].target_location_alarm_configuration.alarms[0].name #=> String
11972
+ # resp.association_description.target_locations[0].include_child_organization_units #=> Boolean
11973
+ # resp.association_description.target_locations[0].exclude_accounts #=> Array
11974
+ # resp.association_description.target_locations[0].exclude_accounts[0] #=> String
11975
+ # resp.association_description.target_locations[0].targets #=> Array
11976
+ # resp.association_description.target_locations[0].targets[0].key #=> String
11977
+ # resp.association_description.target_locations[0].targets[0].values #=> Array
11978
+ # resp.association_description.target_locations[0].targets[0].values[0] #=> String
11979
+ # resp.association_description.target_locations[0].targets_max_concurrency #=> String
11980
+ # resp.association_description.target_locations[0].targets_max_errors #=> String
11146
11981
  # resp.association_description.schedule_offset #=> Integer
11147
11982
  # resp.association_description.duration #=> Integer
11148
11983
  # resp.association_description.target_maps #=> Array
@@ -11251,7 +12086,7 @@ module Aws::SSM
11251
12086
  # resp.document_description.parameters[0].default_value #=> String
11252
12087
  # resp.document_description.platform_types #=> Array
11253
12088
  # 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"
12089
+ # 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
12090
  # resp.document_description.schema_version #=> String
11256
12091
  # resp.document_description.latest_version #=> String
11257
12092
  # resp.document_description.default_version #=> String
@@ -11691,7 +12526,7 @@ module Aws::SSM
11691
12526
  # creating a custom policy and custom service role for running your
11692
12527
  # maintenance window tasks. The policy can be crafted to provide only
11693
12528
  # the permissions needed for your particular maintenance window tasks.
11694
- # For more information, see [Setting up maintenance windows][1] in the
12529
+ # For more information, see [Setting up Maintenance Windows][1] in the
11695
12530
  # in the *Amazon Web Services Systems Manager User Guide*.
11696
12531
  #
11697
12532
  #
@@ -11817,7 +12652,6 @@ module Aws::SSM
11817
12652
  # command associated with the task. However, there is no guarantee
11818
12653
  # that the command will be terminated and the underlying process
11819
12654
  # stopped.
11820
- #
11821
12655
  # The status for tasks that are not completed is `TIMED_OUT`.
11822
12656
  #
11823
12657
  # @option params [Types::AlarmConfiguration] :alarm_configuration
@@ -11995,9 +12829,9 @@ module Aws::SSM
11995
12829
  # want to assign to the managed node. This IAM role must provide
11996
12830
  # AssumeRole permissions for the Amazon Web Services Systems Manager
11997
12831
  # 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*.
12832
+ # [Create the IAM service role required for Systems Manager in hybrid
12833
+ # and multicloud environments][1] in the *Amazon Web Services Systems
12834
+ # Manager User Guide*.
12001
12835
  #
12002
12836
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
12003
12837
  # must create a unique role.
@@ -12006,7 +12840,7 @@ module Aws::SSM
12006
12840
  #
12007
12841
  #
12008
12842
  #
12009
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
12843
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
12010
12844
  #
12011
12845
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
12012
12846
  #
@@ -12097,9 +12931,8 @@ module Aws::SSM
12097
12931
  # impacted resource.
12098
12932
  #
12099
12933
  # @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*.
12934
+ # The OpsItem status. For more information, see [Editing OpsItem
12935
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
12103
12936
  #
12104
12937
  #
12105
12938
  #
@@ -12162,7 +12995,7 @@ module Aws::SSM
12162
12995
  # ops_item_id: "String", # required
12163
12996
  # },
12164
12997
  # ],
12165
- # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Rejected, Closed
12998
+ # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Revoked, Rejected, Closed
12166
12999
  # ops_item_id: "OpsItemId", # required
12167
13000
  # title: "OpsItemTitle",
12168
13001
  # category: "OpsItemCategory",
@@ -12241,6 +13074,10 @@ module Aws::SSM
12241
13074
  # @option params [Types::PatchFilterGroup] :global_filters
12242
13075
  # A set of global filters used to include patches in the baseline.
12243
13076
  #
13077
+ # The `GlobalFilters` parameter can be configured only by using the CLI
13078
+ # or an Amazon Web Services SDK. It can't be configured from the Patch
13079
+ # Manager console, and its value isn't displayed in the console.
13080
+ #
12244
13081
  # @option params [Types::PatchRuleGroup] :approval_rules
12245
13082
  # A set of rules used to include patches in the baseline.
12246
13083
  #
@@ -12248,7 +13085,7 @@ module Aws::SSM
12248
13085
  # A list of explicitly approved patches for the baseline.
12249
13086
  #
12250
13087
  # For information about accepted formats for lists of approved patches
12251
- # and rejected patches, see [About package name formats for approved and
13088
+ # and rejected patches, see [Package name formats for approved and
12252
13089
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
12253
13090
  # User Guide*.
12254
13091
  #
@@ -12268,7 +13105,7 @@ module Aws::SSM
12268
13105
  # A list of explicitly rejected patches for the baseline.
12269
13106
  #
12270
13107
  # For information about accepted formats for lists of approved patches
12271
- # and rejected patches, see [About package name formats for approved and
13108
+ # and rejected patches, see [Package name formats for approved and
12272
13109
  # rejected patch lists][1] in the *Amazon Web Services Systems Manager
12273
13110
  # User Guide*.
12274
13111
  #
@@ -12280,19 +13117,28 @@ module Aws::SSM
12280
13117
  # The action for Patch Manager to take on patches included in the
12281
13118
  # `RejectedPackages` list.
12282
13119
  #
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.
13120
+ # ALLOW\_AS\_DEPENDENCY
12288
13121
  #
12289
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
13122
+ # : **Linux and macOS**: A package in the rejected patches list is
13123
+ # installed only if it is a dependency of another package. It is
13124
+ # considered compliant with the patch baseline, and its status is
13125
+ # reported as `INSTALLED_OTHER`. This is the default action if no
13126
+ # option is specified.
13127
+ #
13128
+ # **Windows Server**: Windows Server doesn't support the concept of
13129
+ # package dependencies. If a package in the rejected patches list and
13130
+ # already installed on the node, its status is reported as
13131
+ # `INSTALLED_OTHER`. Any package not already installed on the node is
13132
+ # skipped. This is the default action if no option is specified.
13133
+ #
13134
+ # BLOCK
13135
+ #
13136
+ # : **All OSs**: Packages in the rejected patches list, and packages
12290
13137
  # that include them as dependencies, aren't installed by Patch
12291
13138
  # 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*.
13139
+ # it was added to the rejected patches list, or is installed outside
13140
+ # of Patch Manager afterward, it's considered noncompliant with the
13141
+ # patch baseline and its status is reported as `INSTALLED_REJECTED`.
12296
13142
  #
12297
13143
  # @option params [String] :description
12298
13144
  # A description of the patch baseline.
@@ -12302,6 +13148,20 @@ module Aws::SSM
12302
13148
  # including target operating systems and source repositories. Applies to
12303
13149
  # Linux managed nodes only.
12304
13150
  #
13151
+ # @option params [String] :available_security_updates_compliance_status
13152
+ # Indicates the status to be assigned to security patches that are
13153
+ # available but not approved because they don't meet the installation
13154
+ # criteria specified in the patch baseline.
13155
+ #
13156
+ # Example scenario: Security patches that you might want installed can
13157
+ # be skipped if you have specified a long period to wait after a patch
13158
+ # is released before installation. If an update to the patch is released
13159
+ # during your specified waiting period, the waiting period for
13160
+ # installing the patch starts over. If the waiting period is too long,
13161
+ # multiple versions of the patch could be released but never installed.
13162
+ #
13163
+ # Supported for Windows Server managed nodes only.
13164
+ #
12305
13165
  # @option params [Boolean] :replace
12306
13166
  # If True, then all fields that are required by the CreatePatchBaseline
12307
13167
  # operation are also required for this API request. Optional fields that
@@ -12323,6 +13183,7 @@ module Aws::SSM
12323
13183
  # * {Types::UpdatePatchBaselineResult#modified_date #modified_date} => Time
12324
13184
  # * {Types::UpdatePatchBaselineResult#description #description} => String
12325
13185
  # * {Types::UpdatePatchBaselineResult#sources #sources} => Array&lt;Types::PatchSource&gt;
13186
+ # * {Types::UpdatePatchBaselineResult#available_security_updates_compliance_status #available_security_updates_compliance_status} => String
12326
13187
  #
12327
13188
  # @example Request syntax with placeholder values
12328
13189
  #
@@ -12368,6 +13229,7 @@ module Aws::SSM
12368
13229
  # configuration: "PatchSourceConfiguration", # required
12369
13230
  # },
12370
13231
  # ],
13232
+ # available_security_updates_compliance_status: "COMPLIANT", # accepts COMPLIANT, NON_COMPLIANT
12371
13233
  # replace: false,
12372
13234
  # })
12373
13235
  #
@@ -12404,6 +13266,7 @@ module Aws::SSM
12404
13266
  # resp.sources[0].products #=> Array
12405
13267
  # resp.sources[0].products[0] #=> String
12406
13268
  # resp.sources[0].configuration #=> String
13269
+ # resp.available_security_updates_compliance_status #=> String, one of "COMPLIANT", "NON_COMPLIANT"
12407
13270
  #
12408
13271
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdatePatchBaseline AWS API Documentation
12409
13272
  #
@@ -12494,16 +13357,20 @@ module Aws::SSM
12494
13357
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
12495
13358
  # The setting ID can be one of the following.
12496
13359
  #
12497
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
13360
+ # * `/ssm/appmanager/appmanager-enabled`
12498
13361
  #
12499
13362
  # * `/ssm/automation/customer-script-log-destination`
12500
13363
  #
12501
13364
  # * `/ssm/automation/customer-script-log-group-name`
12502
13365
  #
13366
+ # * /ssm/automation/enable-adaptive-concurrency
13367
+ #
12503
13368
  # * `/ssm/documents/console/public-sharing-permission`
12504
13369
  #
12505
13370
  # * `/ssm/managed-instance/activation-tier`
12506
13371
  #
13372
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
13373
+ #
12507
13374
  # * `/ssm/opsinsights/opscenter`
12508
13375
  #
12509
13376
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -12522,8 +13389,7 @@ module Aws::SSM
12522
13389
  # The new value to specify for the service setting. The following list
12523
13390
  # specifies the available values for each setting.
12524
13391
  #
12525
- # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
12526
- # enter the name of an IAM role.
13392
+ # * For `/ssm/appmanager/appmanager-enabled`, enter `True` or `False`.
12527
13393
  #
12528
13394
  # * For `/ssm/automation/customer-script-log-destination`, enter
12529
13395
  # `CloudWatch`.
@@ -12537,6 +13403,9 @@ module Aws::SSM
12537
13403
  # * For `/ssm/managed-instance/activation-tier`, enter `standard` or
12538
13404
  # `advanced`.
12539
13405
  #
13406
+ # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
13407
+ # enter the name of an IAM role.
13408
+ #
12540
13409
  # * For `/ssm/opsinsights/opscenter`, enter `Enabled` or `Disabled`.
12541
13410
  #
12542
13411
  # * For `/ssm/parameter-store/default-parameter-tier`, enter `Standard`,
@@ -12569,14 +13438,19 @@ module Aws::SSM
12569
13438
  # @api private
12570
13439
  def build_request(operation_name, params = {})
12571
13440
  handlers = @handlers.for(operation_name)
13441
+ tracer = config.telemetry_provider.tracer_provider.tracer(
13442
+ Aws::Telemetry.module_to_tracer_name('Aws::SSM')
13443
+ )
12572
13444
  context = Seahorse::Client::RequestContext.new(
12573
13445
  operation_name: operation_name,
12574
13446
  operation: config.api.operation(operation_name),
12575
13447
  client: self,
12576
13448
  params: params,
12577
- config: config)
13449
+ config: config,
13450
+ tracer: tracer
13451
+ )
12578
13452
  context[:gem_name] = 'aws-sdk-ssm'
12579
- context[:gem_version] = '1.173.0'
13453
+ context[:gem_version] = '1.196.0'
12580
13454
  Seahorse::Client::Request.new(handlers, context)
12581
13455
  end
12582
13456