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.
@@ -10,6 +10,20 @@
10
10
  module Aws::SSM
11
11
  module Types
12
12
 
13
+ # The requester doesn't have permissions to perform the requested
14
+ # operation.
15
+ #
16
+ # @!attribute [rw] message
17
+ # @return [String]
18
+ #
19
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AccessDeniedException AWS API Documentation
20
+ #
21
+ class AccessDeniedException < Struct.new(
22
+ :message)
23
+ SENSITIVE = []
24
+ include Aws::Structure
25
+ end
26
+
13
27
  # Information includes the Amazon Web Services account ID where the
14
28
  # current document is shared and the version shared with that account.
15
29
  #
@@ -428,7 +442,7 @@ module Aws::SSM
428
442
  # Choose the parameter that will define how your automation will
429
443
  # branch out. This target is required for associations that use an
430
444
  # Automation runbook and target resources by using rate controls.
431
- # Automation is a capability of Amazon Web Services Systems Manager.
445
+ # Automation is a tool in Amazon Web Services Systems Manager.
432
446
  # @return [String]
433
447
  #
434
448
  # @!attribute [rw] parameters
@@ -510,9 +524,9 @@ module Aws::SSM
510
524
  #
511
525
  # In `MANUAL` mode, you must specify the `AssociationId` as a
512
526
  # parameter for the PutComplianceItems API operation. In this case,
513
- # compliance data isn't managed by State Manager, a capability of
514
- # Amazon Web Services Systems Manager. It is managed by your direct
515
- # call to the PutComplianceItems API operation.
527
+ # compliance data isn't managed by State Manager, a tool in Amazon
528
+ # Web Services Systems Manager. It is managed by your direct call to
529
+ # the PutComplianceItems API operation.
516
530
  #
517
531
  # By default, all associations use `AUTO` mode.
518
532
  # @return [String]
@@ -529,7 +543,8 @@ module Aws::SSM
529
543
  # The names or Amazon Resource Names (ARNs) of the Change Calendar
530
544
  # type documents your associations are gated under. The associations
531
545
  # only run when that change calendar is open. For more information,
532
- # see [Amazon Web Services Systems Manager Change Calendar][1].
546
+ # see [Amazon Web Services Systems Manager Change Calendar][1] in the
547
+ # *Amazon Web Services Systems Manager User Guide*.
533
548
  #
534
549
  #
535
550
  #
@@ -967,15 +982,15 @@ module Aws::SSM
967
982
  #
968
983
  # In `MANUAL` mode, you must specify the `AssociationId` as a
969
984
  # parameter for the PutComplianceItems API operation. In this case,
970
- # compliance data isn't managed by State Manager, a capability of
971
- # Amazon Web Services Systems Manager. It is managed by your direct
972
- # call to the PutComplianceItems API operation.
985
+ # compliance data isn't managed by State Manager, a tool in Amazon
986
+ # Web Services Systems Manager. It is managed by your direct call to
987
+ # the PutComplianceItems API operation.
973
988
  #
974
989
  # By default, all associations use `AUTO` mode.
975
990
  # @return [String]
976
991
  #
977
992
  # @!attribute [rw] apply_only_at_cron_interval
978
- # By default, when you create a new associations, the system runs it
993
+ # By default, when you create new associations, the system runs it
979
994
  # immediately after it is created and then according to the schedule
980
995
  # you specified. Specify this option if you don't want an association
981
996
  # to run immediately after you create it. This parameter isn't
@@ -987,7 +1002,8 @@ module Aws::SSM
987
1002
  # type documents your associations are gated under. The associations
988
1003
  # for this version only run when that Change Calendar is open. For
989
1004
  # more information, see [Amazon Web Services Systems Manager Change
990
- # Calendar][1].
1005
+ # Calendar][1] in the *Amazon Web Services Systems Manager User
1006
+ # Guide*.
991
1007
  #
992
1008
  #
993
1009
  #
@@ -1124,12 +1140,12 @@ module Aws::SSM
1124
1140
  # * For the key *SourceUrl*, the value is an S3 bucket location. For
1125
1141
  # example:
1126
1142
  #
1127
- # `"Values": [ "s3://doc-example-bucket/my-folder" ]`
1143
+ # `"Values": [ "s3://amzn-s3-demo-bucket/my-prefix" ]`
1128
1144
  #
1129
1145
  # * For the key *S3FileUrl*, the value is a file in an S3 bucket. For
1130
1146
  # example:
1131
1147
  #
1132
- # `"Values": [ "s3://doc-example-bucket/my-folder/my-file.py" ]`
1148
+ # `"Values": [ "s3://amzn-s3-demo-bucket/my-prefix/my-file.py" ]`
1133
1149
  #
1134
1150
  # * For the key *AttachmentReference*, the value is constructed from
1135
1151
  # the name of another SSM document in your account, a version number
@@ -1326,6 +1342,12 @@ module Aws::SSM
1326
1342
  # The CloudWatch alarm that was invoked by the automation.
1327
1343
  # @return [Array<Types::AlarmStateInformation>]
1328
1344
  #
1345
+ # @!attribute [rw] target_locations_url
1346
+ # A publicly accessible URL for a file that contains the
1347
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
1348
+ # buckets are supported
1349
+ # @return [String]
1350
+ #
1329
1351
  # @!attribute [rw] automation_subtype
1330
1352
  # The subtype of the Automation operation. Currently, the only
1331
1353
  # supported value is `ChangeRequest`.
@@ -1394,6 +1416,7 @@ module Aws::SSM
1394
1416
  :progress_counters,
1395
1417
  :alarm_configuration,
1396
1418
  :triggered_alarms,
1419
+ :target_locations_url,
1397
1420
  :automation_subtype,
1398
1421
  :scheduled_time,
1399
1422
  :runbooks,
@@ -1426,6 +1449,55 @@ module Aws::SSM
1426
1449
  include Aws::Structure
1427
1450
  end
1428
1451
 
1452
+ # Information about the optional inputs that can be specified for an
1453
+ # automation execution preview.
1454
+ #
1455
+ # @!attribute [rw] parameters
1456
+ # Information about parameters that can be specified for the preview
1457
+ # operation.
1458
+ # @return [Hash<String,Array<String>>]
1459
+ #
1460
+ # @!attribute [rw] target_parameter_name
1461
+ # The name of the parameter used as the target resource for the
1462
+ # rate-controlled execution. Required if you specify targets.
1463
+ # @return [String]
1464
+ #
1465
+ # @!attribute [rw] targets
1466
+ # Information about the resources that would be included in the actual
1467
+ # runbook execution, if it were to be run. Both Targets and TargetMaps
1468
+ # can't be specified together.
1469
+ # @return [Array<Types::Target>]
1470
+ #
1471
+ # @!attribute [rw] target_maps
1472
+ # A key-value mapping of document parameters to target resources. Both
1473
+ # Targets and TargetMaps can't be specified together.
1474
+ # @return [Array<Hash<String,Array<String>>>]
1475
+ #
1476
+ # @!attribute [rw] target_locations
1477
+ # Information about the Amazon Web Services Regions and Amazon Web
1478
+ # Services accounts targeted by the Automation execution preview
1479
+ # operation.
1480
+ # @return [Array<Types::TargetLocation>]
1481
+ #
1482
+ # @!attribute [rw] target_locations_url
1483
+ # A publicly accessible URL for a file that contains the
1484
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
1485
+ # buckets are supported.
1486
+ # @return [String]
1487
+ #
1488
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AutomationExecutionInputs AWS API Documentation
1489
+ #
1490
+ class AutomationExecutionInputs < Struct.new(
1491
+ :parameters,
1492
+ :target_parameter_name,
1493
+ :targets,
1494
+ :target_maps,
1495
+ :target_locations,
1496
+ :target_locations_url)
1497
+ SENSITIVE = []
1498
+ include Aws::Structure
1499
+ end
1500
+
1429
1501
  # The number of simultaneously running Automation executions exceeded
1430
1502
  # the allowable limit.
1431
1503
  #
@@ -1534,9 +1606,9 @@ module Aws::SSM
1534
1606
  # Use this filter with DescribeAutomationExecutions. Specify either
1535
1607
  # Local or CrossAccount. CrossAccount is an Automation that runs in
1536
1608
  # multiple Amazon Web Services Regions and Amazon Web Services
1537
- # accounts. For more information, see [Running Automation workflows in
1538
- # multiple Amazon Web Services Regions and accounts][1] in the *Amazon
1539
- # Web Services Systems Manager User Guide*.
1609
+ # accounts. For more information, see [Running automations in multiple
1610
+ # Amazon Web Services Regions and accounts][1] in the *Amazon Web
1611
+ # Services Systems Manager User Guide*.
1540
1612
  #
1541
1613
  #
1542
1614
  #
@@ -1551,6 +1623,12 @@ module Aws::SSM
1551
1623
  # The CloudWatch alarm that was invoked by the automation.
1552
1624
  # @return [Array<Types::AlarmStateInformation>]
1553
1625
  #
1626
+ # @!attribute [rw] target_locations_url
1627
+ # A publicly accessible URL for a file that contains the
1628
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
1629
+ # buckets are supported
1630
+ # @return [String]
1631
+ #
1554
1632
  # @!attribute [rw] automation_subtype
1555
1633
  # The subtype of the Automation operation. Currently, the only
1556
1634
  # supported value is `ChangeRequest`.
@@ -1612,6 +1690,7 @@ module Aws::SSM
1612
1690
  :automation_type,
1613
1691
  :alarm_configuration,
1614
1692
  :triggered_alarms,
1693
+ :target_locations_url,
1615
1694
  :automation_subtype,
1616
1695
  :scheduled_time,
1617
1696
  :runbooks,
@@ -1636,6 +1715,55 @@ module Aws::SSM
1636
1715
  include Aws::Structure
1637
1716
  end
1638
1717
 
1718
+ # Information about the results of the execution preview.
1719
+ #
1720
+ # @!attribute [rw] step_previews
1721
+ # Information about the type of impact a runbook step would have on a
1722
+ # resource.
1723
+ #
1724
+ # * `Mutating`: The runbook step would make changes to the targets
1725
+ # through actions that create, modify, or delete resources.
1726
+ #
1727
+ # * `Non_Mutating`: The runbook step would retrieve data about
1728
+ # resources but not make changes to them. This category generally
1729
+ # includes `Describe*`, `List*`, `Get*`, and similar read-only API
1730
+ # actions.
1731
+ #
1732
+ # * `Undetermined`: An undetermined step invokes executions performed
1733
+ # by another orchestration service like Lambda, Step Functions, or
1734
+ # Amazon Web Services Systems Manager Run Command. An undetermined
1735
+ # step might also call a third-party API. Systems Manager Automation
1736
+ # doesn't know the outcome of the orchestration processes or
1737
+ # third-party API executions, so the results of the steps are
1738
+ # undetermined.
1739
+ # @return [Hash<String,Integer>]
1740
+ #
1741
+ # @!attribute [rw] regions
1742
+ # Information about the Amazon Web Services Regions targeted by the
1743
+ # execution preview.
1744
+ # @return [Array<String>]
1745
+ #
1746
+ # @!attribute [rw] target_previews
1747
+ # Information that provides a preview of what the impact of running
1748
+ # the specified Automation runbook would be.
1749
+ # @return [Array<Types::TargetPreview>]
1750
+ #
1751
+ # @!attribute [rw] total_accounts
1752
+ # Information about the Amazon Web Services accounts that were
1753
+ # included in the execution preview.
1754
+ # @return [Integer]
1755
+ #
1756
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AutomationExecutionPreview AWS API Documentation
1757
+ #
1758
+ class AutomationExecutionPreview < Struct.new(
1759
+ :step_previews,
1760
+ :regions,
1761
+ :target_previews,
1762
+ :total_accounts)
1763
+ SENSITIVE = []
1764
+ include Aws::Structure
1765
+ end
1766
+
1639
1767
  # The specified step name and execution ID don't exist. Verify the
1640
1768
  # information and try again.
1641
1769
  #
@@ -1668,9 +1796,9 @@ module Aws::SSM
1668
1796
  # A list of explicitly approved patches for the baseline.
1669
1797
  #
1670
1798
  # For information about accepted formats for lists of approved patches
1671
- # and rejected patches, see [About package name formats for approved
1672
- # and rejected patch lists][1] in the *Amazon Web Services Systems
1673
- # Manager User Guide*.
1799
+ # and rejected patches, see [Package name formats for approved and
1800
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
1801
+ # User Guide*.
1674
1802
  #
1675
1803
  #
1676
1804
  #
@@ -1687,9 +1815,9 @@ module Aws::SSM
1687
1815
  # A list of explicitly rejected patches for the baseline.
1688
1816
  #
1689
1817
  # For information about accepted formats for lists of approved patches
1690
- # and rejected patches, see [About package name formats for approved
1691
- # and rejected patch lists][1] in the *Amazon Web Services Systems
1692
- # Manager User Guide*.
1818
+ # and rejected patches, see [Package name formats for approved and
1819
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
1820
+ # User Guide*.
1693
1821
  #
1694
1822
  #
1695
1823
  #
@@ -1715,6 +1843,16 @@ module Aws::SSM
1715
1843
  # to Linux managed nodes only.
1716
1844
  # @return [Array<Types::PatchSource>]
1717
1845
  #
1846
+ # @!attribute [rw] available_security_updates_compliance_status
1847
+ # Indicates whether managed nodes for which there are available
1848
+ # security-related patches that have not been approved by the baseline
1849
+ # are being defined as `COMPLIANT` or `NON_COMPLIANT`. This option is
1850
+ # specified when the `CreatePatchBaseline` or `UpdatePatchBaseline`
1851
+ # commands are run.
1852
+ #
1853
+ # Applies to Windows Server managed nodes only.
1854
+ # @return [String]
1855
+ #
1718
1856
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/BaselineOverride AWS API Documentation
1719
1857
  #
1720
1858
  class BaselineOverride < Struct.new(
@@ -1726,7 +1864,8 @@ module Aws::SSM
1726
1864
  :rejected_patches,
1727
1865
  :rejected_patches_action,
1728
1866
  :approved_patches_enable_non_security,
1729
- :sources)
1867
+ :sources,
1868
+ :available_security_updates_compliance_status)
1730
1869
  SENSITIVE = []
1731
1870
  include Aws::Structure
1732
1871
  end
@@ -1975,9 +2114,9 @@ module Aws::SSM
1975
2114
  #
1976
2115
  # @!attribute [rw] service_role
1977
2116
  # The Identity and Access Management (IAM) service role that Run
1978
- # Command, a capability of Amazon Web Services Systems Manager, uses
1979
- # to act on your behalf when sending notifications about command
1980
- # status changes.
2117
+ # Command, a tool in Amazon Web Services Systems Manager, uses to act
2118
+ # on your behalf when sending notifications about command status
2119
+ # changes.
1981
2120
  # @return [String]
1982
2121
  #
1983
2122
  # @!attribute [rw] notification_config
@@ -2055,11 +2194,11 @@ module Aws::SSM
2055
2194
  # The filter value. Valid values for each filter key are as follows:
2056
2195
  #
2057
2196
  # * **InvokedAfter**: Specify a timestamp to limit your results. For
2058
- # example, specify `2021-07-07T00:00:00Z` to see a list of command
2197
+ # example, specify `2024-07-07T00:00:00Z` to see a list of command
2059
2198
  # executions occurring July 7, 2021, and later.
2060
2199
  #
2061
2200
  # * **InvokedBefore**: Specify a timestamp to limit your results. For
2062
- # example, specify `2021-07-07T00:00:00Z` to see a list of command
2201
+ # example, specify `2024-07-07T00:00:00Z` to see a list of command
2063
2202
  # executions from before July 7, 2021.
2064
2203
  #
2065
2204
  # * **Status**: Specify a valid command status to see a list of all
@@ -2091,7 +2230,6 @@ module Aws::SSM
2091
2230
  # * `NoInstancesInTag`
2092
2231
  #
2093
2232
  # * `LimitExceeded`
2094
- #
2095
2233
  # The status values you can specify for `ListCommandInvocations`
2096
2234
  # are:
2097
2235
  #
@@ -2120,7 +2258,6 @@ module Aws::SSM
2120
2258
  # * `InvalidPlatform`
2121
2259
  #
2122
2260
  # * `Terminated`
2123
- #
2124
2261
  # * **DocumentName**: Specify name of the Amazon Web Services Systems
2125
2262
  # Manager document (SSM document) for which you want to see command
2126
2263
  # execution results. For example, specify `AWS-RunPatchBaseline` to
@@ -2269,9 +2406,9 @@ module Aws::SSM
2269
2406
  #
2270
2407
  # @!attribute [rw] service_role
2271
2408
  # The Identity and Access Management (IAM) service role that Run
2272
- # Command, a capability of Amazon Web Services Systems Manager, uses
2273
- # to act on your behalf when sending notifications about command
2274
- # status changes on a per managed node basis.
2409
+ # Command, a tool in Amazon Web Services Systems Manager, uses to act
2410
+ # on your behalf when sending notifications about command status
2411
+ # changes on a per managed node basis.
2275
2412
  # @return [String]
2276
2413
  #
2277
2414
  # @!attribute [rw] notification_config
@@ -2413,12 +2550,11 @@ module Aws::SSM
2413
2550
  # be stored. This was requested when issuing the command. For example,
2414
2551
  # in the following response:
2415
2552
  #
2416
- # `doc-example-bucket/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-02573cafcfEXAMPLE/awsrunShellScript`
2553
+ # `amzn-s3-demo-bucket/my-prefix/i-02573cafcfEXAMPLE/awsrunShellScript`
2417
2554
  #
2418
- # `doc-example-bucket` is the name of the S3 bucket;
2555
+ # `amzn-s3-demo-bucket` is the name of the S3 bucket;
2419
2556
  #
2420
- # `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
2421
- # prefix;
2557
+ # `my-prefix` is the name of the S3 prefix;
2422
2558
  #
2423
2559
  # `i-02573cafcfEXAMPLE` is the managed node ID;
2424
2560
  #
@@ -2430,12 +2566,11 @@ module Aws::SSM
2430
2566
  # command executions should be stored. This was requested when issuing
2431
2567
  # the command. For example, in the following response:
2432
2568
  #
2433
- # `doc-example-bucket/ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix/i-02573cafcfEXAMPLE/awsrunShellScript`
2569
+ # `amzn-s3-demo-bucket/my-prefix/i-02573cafcfEXAMPLE/awsrunShellScript`
2434
2570
  #
2435
- # `doc-example-bucket` is the name of the S3 bucket;
2571
+ # `amzn-s3-demo-bucket` is the name of the S3 bucket;
2436
2572
  #
2437
- # `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
2438
- # prefix;
2573
+ # `my-prefix` is the name of the S3 prefix;
2439
2574
  #
2440
2575
  # `i-02573cafcfEXAMPLE` is the managed node ID;
2441
2576
  #
@@ -2707,9 +2842,9 @@ module Aws::SSM
2707
2842
  # want to assign to the managed node. This IAM role must provide
2708
2843
  # AssumeRole permissions for the Amazon Web Services Systems Manager
2709
2844
  # service principal `ssm.amazonaws.com`. For more information, see
2710
- # [Create an IAM service role for a hybrid and multicloud
2711
- # environment][1] in the *Amazon Web Services Systems Manager User
2712
- # Guide*.
2845
+ # [Create the IAM service role required for Systems Manager in a
2846
+ # hybrid and multicloud environments][1] in the *Amazon Web Services
2847
+ # Systems Manager User Guide*.
2713
2848
  #
2714
2849
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter.
2715
2850
  # You must create a unique role.
@@ -2718,7 +2853,7 @@ module Aws::SSM
2718
2853
  #
2719
2854
  #
2720
2855
  #
2721
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
2856
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
2722
2857
  # @return [String]
2723
2858
  #
2724
2859
  # @!attribute [rw] registration_limit
@@ -2728,7 +2863,7 @@ module Aws::SSM
2728
2863
  #
2729
2864
  # @!attribute [rw] expiration_date
2730
2865
  # The date by which this activation request should expire, in
2731
- # timestamp format, such as "2021-07-07T00:00:00". You can specify a
2866
+ # timestamp format, such as "2024-07-07T00:00:00". You can specify a
2732
2867
  # date up to 30 days in advance. If you don't provide an expiration
2733
2868
  # date, the activation code expires in 24 hours.
2734
2869
  # @return [Time]
@@ -2859,8 +2994,8 @@ module Aws::SSM
2859
2994
  # @!attribute [rw] automation_target_parameter_name
2860
2995
  # Specify the target for the association. This target is required for
2861
2996
  # associations that use an Automation runbook and target resources by
2862
- # using rate controls. Automation is a capability of Amazon Web
2863
- # Services Systems Manager.
2997
+ # using rate controls. Automation is a tool in Amazon Web Services
2998
+ # Systems Manager.
2864
2999
  # @return [String]
2865
3000
  #
2866
3001
  # @!attribute [rw] document_version
@@ -2929,26 +3064,39 @@ module Aws::SSM
2929
3064
  #
2930
3065
  # In `MANUAL` mode, you must specify the `AssociationId` as a
2931
3066
  # parameter for the PutComplianceItems API operation. In this case,
2932
- # compliance data isn't managed by State Manager, a capability of
2933
- # Amazon Web Services Systems Manager. It is managed by your direct
2934
- # call to the PutComplianceItems API operation.
3067
+ # compliance data isn't managed by State Manager, a tool in Amazon
3068
+ # Web Services Systems Manager. It is managed by your direct call to
3069
+ # the PutComplianceItems API operation.
2935
3070
  #
2936
3071
  # By default, all associations use `AUTO` mode.
2937
3072
  # @return [String]
2938
3073
  #
2939
3074
  # @!attribute [rw] apply_only_at_cron_interval
2940
- # By default, when you create a new associations, the system runs it
3075
+ # By default, when you create a new association, the system runs it
2941
3076
  # immediately after it is created and then according to the schedule
2942
- # you specified. Specify this option if you don't want an association
2943
- # to run immediately after you create it. This parameter isn't
2944
- # supported for rate expressions.
3077
+ # you specified and when target changes are detected. Specify `true`
3078
+ # for `ApplyOnlyAtCronInterval` if you want the association to run
3079
+ # only according to the schedule you specified.
3080
+ #
3081
+ # For more information, see [Understanding when associations are
3082
+ # applied to resources][1] and [&gt;About target updates with
3083
+ # Automation runbooks][2] in the *Amazon Web Services Systems Manager
3084
+ # User Guide*.
3085
+ #
3086
+ # This parameter isn't supported for rate expressions.
3087
+ #
3088
+ #
3089
+ #
3090
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
3091
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
2945
3092
  # @return [Boolean]
2946
3093
  #
2947
3094
  # @!attribute [rw] calendar_names
2948
3095
  # The names or Amazon Resource Names (ARNs) of the Change Calendar
2949
3096
  # type documents your associations are gated under. The associations
2950
3097
  # only run when that Change Calendar is open. For more information,
2951
- # see [Amazon Web Services Systems Manager Change Calendar][1].
3098
+ # see [Amazon Web Services Systems Manager Change Calendar][1] in the
3099
+ # *Amazon Web Services Systems Manager User Guide*.
2952
3100
  #
2953
3101
  #
2954
3102
  #
@@ -3099,9 +3247,10 @@ module Aws::SSM
3099
3247
  # in an Amazon Web Services account, or individual managed node IDs.
3100
3248
  # You can target all managed nodes in an Amazon Web Services account
3101
3249
  # by specifying the `InstanceIds` key with a value of `*`. For more
3102
- # information about choosing targets for an association, see [About
3103
- # targets and rate controls in State Manager associations][1] in the
3104
- # *Amazon Web Services Systems Manager User Guide*.
3250
+ # information about choosing targets for an association, see
3251
+ # [Understanding targets and rate controls in State Manager
3252
+ # associations][1] in the *Amazon Web Services Systems Manager User
3253
+ # Guide*.
3105
3254
  #
3106
3255
  #
3107
3256
  #
@@ -3126,7 +3275,7 @@ module Aws::SSM
3126
3275
  # Choose the parameter that will define how your automation will
3127
3276
  # branch out. This target is required for associations that use an
3128
3277
  # Automation runbook and target resources by using rate controls.
3129
- # Automation is a capability of Amazon Web Services Systems Manager.
3278
+ # Automation is a tool in Amazon Web Services Systems Manager.
3130
3279
  # @return [String]
3131
3280
  #
3132
3281
  # @!attribute [rw] max_errors
@@ -3183,17 +3332,30 @@ module Aws::SSM
3183
3332
  # @!attribute [rw] apply_only_at_cron_interval
3184
3333
  # By default, when you create a new association, the system runs it
3185
3334
  # immediately after it is created and then according to the schedule
3186
- # you specified. Specify this option if you don't want an association
3187
- # to run immediately after you create it. This parameter isn't
3188
- # supported for rate expressions.
3335
+ # you specified and when target changes are detected. Specify `true`
3336
+ # for `ApplyOnlyAtCronInterval`if you want the association to run only
3337
+ # according to the schedule you specified.
3338
+ #
3339
+ # For more information, see [Understanding when associations are
3340
+ # applied to resources][1] and [&gt;About target updates with
3341
+ # Automation runbooks][2] in the *Amazon Web Services Systems Manager
3342
+ # User Guide*.
3343
+ #
3344
+ # This parameter isn't supported for rate expressions.
3345
+ #
3346
+ #
3347
+ #
3348
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
3349
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
3189
3350
  # @return [Boolean]
3190
3351
  #
3191
3352
  # @!attribute [rw] calendar_names
3192
- # The names or Amazon Resource Names (ARNs) of the Change Calendar
3353
+ # The names of Amazon Resource Names (ARNs) of the Change Calendar
3193
3354
  # type documents you want to gate your associations under. The
3194
3355
  # associations only run when that change calendar is open. For more
3195
3356
  # information, see [Amazon Web Services Systems Manager Change
3196
- # Calendar][1].
3357
+ # Calendar][1] in the *Amazon Web Services Systems Manager User
3358
+ # Guide*.
3197
3359
  #
3198
3360
  #
3199
3361
  #
@@ -3836,6 +3998,11 @@ module Aws::SSM
3836
3998
  #
3837
3999
  # @!attribute [rw] global_filters
3838
4000
  # A set of global filters used to include patches in the baseline.
4001
+ #
4002
+ # The `GlobalFilters` parameter can be configured only by using the
4003
+ # CLI or an Amazon Web Services SDK. It can't be configured from the
4004
+ # Patch Manager console, and its value isn't displayed in the
4005
+ # console.
3839
4006
  # @return [Types::PatchFilterGroup]
3840
4007
  #
3841
4008
  # @!attribute [rw] approval_rules
@@ -3846,9 +4013,9 @@ module Aws::SSM
3846
4013
  # A list of explicitly approved patches for the baseline.
3847
4014
  #
3848
4015
  # For information about accepted formats for lists of approved patches
3849
- # and rejected patches, see [About package name formats for approved
3850
- # and rejected patch lists][1] in the *Amazon Web Services Systems
3851
- # Manager User Guide*.
4016
+ # and rejected patches, see [Package name formats for approved and
4017
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
4018
+ # User Guide*.
3852
4019
  #
3853
4020
  #
3854
4021
  #
@@ -3871,9 +4038,9 @@ module Aws::SSM
3871
4038
  # A list of explicitly rejected patches for the baseline.
3872
4039
  #
3873
4040
  # For information about accepted formats for lists of approved patches
3874
- # and rejected patches, see [About package name formats for approved
3875
- # and rejected patch lists][1] in the *Amazon Web Services Systems
3876
- # Manager User Guide*.
4041
+ # and rejected patches, see [Package name formats for approved and
4042
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
4043
+ # User Guide*.
3877
4044
  #
3878
4045
  #
3879
4046
  #
@@ -3884,19 +4051,28 @@ module Aws::SSM
3884
4051
  # The action for Patch Manager to take on patches included in the
3885
4052
  # `RejectedPackages` list.
3886
4053
  #
3887
- # * <b> <code>ALLOW_AS_DEPENDENCY</code> </b>: A package in the
3888
- # `Rejected` patches list is installed only if it is a dependency of
3889
- # another package. It is considered compliant with the patch
3890
- # baseline, and its status is reported as `InstalledOther`. This is
3891
- # the default action if no option is specified.
4054
+ # ALLOW\_AS\_DEPENDENCY
4055
+ #
4056
+ # : **Linux and macOS**: A package in the rejected patches list is
4057
+ # installed only if it is a dependency of another package. It is
4058
+ # considered compliant with the patch baseline, and its status is
4059
+ # reported as `INSTALLED_OTHER`. This is the default action if no
4060
+ # option is specified.
4061
+ #
4062
+ # **Windows Server**: Windows Server doesn't support the concept of
4063
+ # package dependencies. If a package in the rejected patches list
4064
+ # and already installed on the node, its status is reported as
4065
+ # `INSTALLED_OTHER`. Any package not already installed on the node
4066
+ # is skipped. This is the default action if no option is specified.
3892
4067
  #
3893
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
4068
+ # BLOCK
4069
+ #
4070
+ # : **All OSs**: Packages in the rejected patches list, and packages
3894
4071
  # that include them as dependencies, aren't installed by Patch
3895
4072
  # Manager under any circumstances. If a package was installed before
3896
- # it was added to the **Rejected patches** list, or is installed
3897
- # outside of Patch Manager afterward, it's considered noncompliant
3898
- # with the patch baseline and its status is reported as
3899
- # *InstalledRejected*.
4073
+ # it was added to the rejected patches list, or is installed outside
4074
+ # of Patch Manager afterward, it's considered noncompliant with the
4075
+ # patch baseline and its status is reported as `INSTALLED_REJECTED`.
3900
4076
  # @return [String]
3901
4077
  #
3902
4078
  # @!attribute [rw] description
@@ -3909,6 +4085,22 @@ module Aws::SSM
3909
4085
  # to Linux managed nodes only.
3910
4086
  # @return [Array<Types::PatchSource>]
3911
4087
  #
4088
+ # @!attribute [rw] available_security_updates_compliance_status
4089
+ # Indicates the status you want to assign to security patches that are
4090
+ # available but not approved because they don't meet the installation
4091
+ # criteria specified in the patch baseline.
4092
+ #
4093
+ # Example scenario: Security patches that you might want installed can
4094
+ # be skipped if you have specified a long period to wait after a patch
4095
+ # is released before installation. If an update to the patch is
4096
+ # released during your specified waiting period, the waiting period
4097
+ # for installing the patch starts over. If the waiting period is too
4098
+ # long, multiple versions of the patch could be released but never
4099
+ # installed.
4100
+ #
4101
+ # Supported for Windows Server managed nodes only.
4102
+ # @return [String]
4103
+ #
3912
4104
  # @!attribute [rw] client_token
3913
4105
  # User-provided idempotency token.
3914
4106
  #
@@ -3948,6 +4140,7 @@ module Aws::SSM
3948
4140
  :rejected_patches_action,
3949
4141
  :description,
3950
4142
  :sources,
4143
+ :available_security_updates_compliance_status,
3951
4144
  :client_token,
3952
4145
  :tags)
3953
4146
  SENSITIVE = []
@@ -4006,6 +4199,38 @@ module Aws::SSM
4006
4199
  #
4007
4200
  class CreateResourceDataSyncResult < Aws::EmptyStructure; end
4008
4201
 
4202
+ # The temporary security credentials, which include an access key ID, a
4203
+ # secret access key, and a security (or session) token.
4204
+ #
4205
+ # @!attribute [rw] access_key_id
4206
+ # The access key ID that identifies the temporary security
4207
+ # credentials.
4208
+ # @return [String]
4209
+ #
4210
+ # @!attribute [rw] secret_access_key
4211
+ # The secret access key that can be used to sign requests.
4212
+ # @return [String]
4213
+ #
4214
+ # @!attribute [rw] session_token
4215
+ # The token that users must pass to the service API to use the
4216
+ # temporary credentials.
4217
+ # @return [String]
4218
+ #
4219
+ # @!attribute [rw] expiration_time
4220
+ # The datetime on which the current credentials expire.
4221
+ # @return [Time]
4222
+ #
4223
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Credentials AWS API Documentation
4224
+ #
4225
+ class Credentials < Struct.new(
4226
+ :access_key_id,
4227
+ :secret_access_key,
4228
+ :session_token,
4229
+ :expiration_time)
4230
+ SENSITIVE = [:secret_access_key, :session_token]
4231
+ include Aws::Structure
4232
+ end
4233
+
4009
4234
  # You have exceeded the limit for custom schemas. Delete one or more
4010
4235
  # custom schemas and try again.
4011
4236
  #
@@ -4169,12 +4394,12 @@ module Aws::SSM
4169
4394
  #
4170
4395
  # @!attribute [rw] deletion_summary
4171
4396
  # A summary of the delete operation. For more information about this
4172
- # summary, see [Understanding the delete inventory summary][1] in the
4173
- # *Amazon Web Services Systems Manager User Guide*.
4397
+ # summary, see [Deleting custom inventory][1] in the *Amazon Web
4398
+ # Services Systems Manager User Guide*.
4174
4399
  #
4175
4400
  #
4176
4401
  #
4177
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-custom.html#sysman-inventory-delete-summary
4402
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-custom.html#delete-custom-inventory-summary
4178
4403
  # @return [Types::InventoryDeletionSummary]
4179
4404
  #
4180
4405
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DeleteInventoryResult AWS API Documentation
@@ -5363,9 +5588,9 @@ module Aws::SSM
5363
5588
  # Sample values: `Installed` \| `InstalledOther` \|
5364
5589
  # `InstalledPendingReboot`
5365
5590
  #
5366
- # For lists of all `State` values, see [Understanding patch
5367
- # compliance state values][1] in the *Amazon Web Services Systems
5368
- # Manager User Guide*.
5591
+ # For lists of all `State` values, see [Patch compliance state
5592
+ # values][1] in the *Amazon Web Services Systems Manager User
5593
+ # Guide*.
5369
5594
  #
5370
5595
  #
5371
5596
  #
@@ -5638,7 +5863,7 @@ module Aws::SSM
5638
5863
  #
5639
5864
  # * Values. An array of strings, each between 1 and 256 characters.
5640
5865
  # Supported values are date/time strings in a valid ISO 8601
5641
- # date/time format, such as `2021-11-04T05:00:00Z`.
5866
+ # date/time format, such as `2024-11-04T05:00:00Z`.
5642
5867
  # @return [Array<Types::MaintenanceWindowFilter>]
5643
5868
  #
5644
5869
  # @!attribute [rw] max_results
@@ -6003,7 +6228,7 @@ module Aws::SSM
6003
6228
  #
6004
6229
  # **If you filter the response by using the OperationalData
6005
6230
  # operator, specify a key-value pair by using the following JSON
6006
- # format: \\\{"key":"key\_name","value":"a\_value"\\}
6231
+ # format: \{"key":"key\_name","value":"a\_value"}
6007
6232
  # @return [Array<Types::OpsItemFilter>]
6008
6233
  #
6009
6234
  # @!attribute [rw] max_results
@@ -6234,7 +6459,7 @@ module Aws::SSM
6234
6459
  # @!attribute [rw] instances_with_unreported_not_applicable_patches
6235
6460
  # The number of managed nodes with `NotApplicable` patches beyond the
6236
6461
  # supported limit, which aren't reported by name to Inventory.
6237
- # Inventory is a capability of Amazon Web Services Systems Manager.
6462
+ # Inventory is a tool in Amazon Web Services Systems Manager.
6238
6463
  # @return [Integer]
6239
6464
  #
6240
6465
  # @!attribute [rw] instances_with_critical_non_compliant_patches
@@ -6260,6 +6485,16 @@ module Aws::SSM
6260
6485
  # is `NON_COMPLIANT`.
6261
6486
  # @return [Integer]
6262
6487
  #
6488
+ # @!attribute [rw] instances_with_available_security_updates
6489
+ # The number of managed nodes for which security-related patches are
6490
+ # available but not approved because because they didn't meet the
6491
+ # patch baseline requirements. For example, an updated version of a
6492
+ # patch might have been released before the specified auto-approval
6493
+ # period was over.
6494
+ #
6495
+ # Applies to Windows Server managed nodes only.
6496
+ # @return [Integer]
6497
+ #
6263
6498
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupStateResult AWS API Documentation
6264
6499
  #
6265
6500
  class DescribePatchGroupStateResult < Struct.new(
@@ -6274,7 +6509,8 @@ module Aws::SSM
6274
6509
  :instances_with_unreported_not_applicable_patches,
6275
6510
  :instances_with_critical_non_compliant_patches,
6276
6511
  :instances_with_security_non_compliant_patches,
6277
- :instances_with_other_non_compliant_patches)
6512
+ :instances_with_other_non_compliant_patches,
6513
+ :instances_with_available_security_updates)
6278
6514
  SENSITIVE = []
6279
6515
  include Aws::Structure
6280
6516
  end
@@ -6317,7 +6553,7 @@ module Aws::SSM
6317
6553
  # Each entry in the array contains:
6318
6554
  #
6319
6555
  # * `PatchGroup`: string (between 1 and 256 characters. Regex:
6320
- # `^([\p\{L\}\p\{Z\}\p\{N\}_.:/=+\-@]*)$)`
6556
+ # `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$)`
6321
6557
  #
6322
6558
  # * `PatchBaselineIdentity`: A `PatchBaselineIdentity` element.
6323
6559
  # @return [Array<Types::PatchGroupPatchBaselineMapping>]
@@ -7268,6 +7504,51 @@ module Aws::SSM
7268
7504
  include Aws::Structure
7269
7505
  end
7270
7506
 
7507
+ # Information about the inputs for an execution preview.
7508
+ #
7509
+ # @note ExecutionInputs is a union - when making an API calls you must set exactly one of the members.
7510
+ #
7511
+ # @!attribute [rw] automation
7512
+ # Information about the optional inputs that can be specified for an
7513
+ # automation execution preview.
7514
+ # @return [Types::AutomationExecutionInputs]
7515
+ #
7516
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ExecutionInputs AWS API Documentation
7517
+ #
7518
+ class ExecutionInputs < Struct.new(
7519
+ :automation,
7520
+ :unknown)
7521
+ SENSITIVE = []
7522
+ include Aws::Structure
7523
+ include Aws::Structure::Union
7524
+
7525
+ class Automation < ExecutionInputs; end
7526
+ class Unknown < ExecutionInputs; end
7527
+ end
7528
+
7529
+ # Information about the changes that would be made if an execution were
7530
+ # run.
7531
+ #
7532
+ # @note ExecutionPreview is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of ExecutionPreview corresponding to the set member.
7533
+ #
7534
+ # @!attribute [rw] automation
7535
+ # Information about the changes that would be made if an Automation
7536
+ # workflow were run.
7537
+ # @return [Types::AutomationExecutionPreview]
7538
+ #
7539
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ExecutionPreview AWS API Documentation
7540
+ #
7541
+ class ExecutionPreview < Struct.new(
7542
+ :automation,
7543
+ :unknown)
7544
+ SENSITIVE = []
7545
+ include Aws::Structure
7546
+ include Aws::Structure::Union
7547
+
7548
+ class Automation < ExecutionPreview; end
7549
+ class Unknown < ExecutionPreview; end
7550
+ end
7551
+
7271
7552
  # Describes a failed association.
7272
7553
  #
7273
7554
  # @!attribute [rw] entry
@@ -7333,6 +7614,36 @@ module Aws::SSM
7333
7614
  include Aws::Structure
7334
7615
  end
7335
7616
 
7617
+ # @!attribute [rw] access_request_id
7618
+ # The ID of a just-in-time node access request.
7619
+ # @return [String]
7620
+ #
7621
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAccessTokenRequest AWS API Documentation
7622
+ #
7623
+ class GetAccessTokenRequest < Struct.new(
7624
+ :access_request_id)
7625
+ SENSITIVE = []
7626
+ include Aws::Structure
7627
+ end
7628
+
7629
+ # @!attribute [rw] credentials
7630
+ # The temporary security credentials which can be used to start
7631
+ # just-in-time node access sessions.
7632
+ # @return [Types::Credentials]
7633
+ #
7634
+ # @!attribute [rw] access_request_status
7635
+ # The status of the access request.
7636
+ # @return [String]
7637
+ #
7638
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAccessTokenResponse AWS API Documentation
7639
+ #
7640
+ class GetAccessTokenResponse < Struct.new(
7641
+ :credentials,
7642
+ :access_request_status)
7643
+ SENSITIVE = []
7644
+ include Aws::Structure
7645
+ end
7646
+
7336
7647
  # @!attribute [rw] automation_execution_id
7337
7648
  # The unique identifier for an existing automation execution to
7338
7649
  # examine. The execution ID is returned by StartAutomationExecution
@@ -7361,7 +7672,7 @@ module Aws::SSM
7361
7672
  end
7362
7673
 
7363
7674
  # @!attribute [rw] calendar_names
7364
- # The names or Amazon Resource Names (ARNs) of the Systems Manager
7675
+ # The names of Amazon Resource Names (ARNs) of the Systems Manager
7365
7676
  # documents (SSM documents) that represent the calendar entries for
7366
7677
  # which you want to get the state.
7367
7678
  # @return [Array<String>]
@@ -7876,6 +8187,53 @@ module Aws::SSM
7876
8187
  include Aws::Structure
7877
8188
  end
7878
8189
 
8190
+ # @!attribute [rw] execution_preview_id
8191
+ # The ID of the existing execution preview.
8192
+ # @return [String]
8193
+ #
8194
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreviewRequest AWS API Documentation
8195
+ #
8196
+ class GetExecutionPreviewRequest < Struct.new(
8197
+ :execution_preview_id)
8198
+ SENSITIVE = []
8199
+ include Aws::Structure
8200
+ end
8201
+
8202
+ # @!attribute [rw] execution_preview_id
8203
+ # The generated ID for the existing execution preview.
8204
+ # @return [String]
8205
+ #
8206
+ # @!attribute [rw] ended_at
8207
+ # A UTC timestamp indicating when the execution preview operation
8208
+ # ended.
8209
+ # @return [Time]
8210
+ #
8211
+ # @!attribute [rw] status
8212
+ # The current status of the execution preview operation.
8213
+ # @return [String]
8214
+ #
8215
+ # @!attribute [rw] status_message
8216
+ # Supplemental information about the current status of the execution
8217
+ # preview.
8218
+ # @return [String]
8219
+ #
8220
+ # @!attribute [rw] execution_preview
8221
+ # Information about the changes that would be made if an execution
8222
+ # were run.
8223
+ # @return [Types::ExecutionPreview]
8224
+ #
8225
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreviewResponse AWS API Documentation
8226
+ #
8227
+ class GetExecutionPreviewResponse < Struct.new(
8228
+ :execution_preview_id,
8229
+ :ended_at,
8230
+ :status,
8231
+ :status_message,
8232
+ :execution_preview)
8233
+ SENSITIVE = []
8234
+ include Aws::Structure
8235
+ end
8236
+
7879
8237
  # @!attribute [rw] filters
7880
8238
  # One or more filters. Use a filter to return a more specific list of
7881
8239
  # results.
@@ -8407,10 +8765,24 @@ module Aws::SSM
8407
8765
  # @return [String]
8408
8766
  #
8409
8767
  # @!attribute [rw] service_role_arn
8410
- # The Amazon Resource Name (ARN) of the Identity and Access Management
8411
- # (IAM) service role to use to publish Amazon Simple Notification
8412
- # Service (Amazon SNS) notifications for maintenance window Run
8413
- # Command tasks.
8768
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
8769
+ # Web Services Systems Manager to assume when running a maintenance
8770
+ # window task. If you do not specify a service role ARN, Systems
8771
+ # Manager uses a service-linked role in your account. If no
8772
+ # appropriate service-linked role for Systems Manager exists in your
8773
+ # account, it is created when you run
8774
+ # `RegisterTaskWithMaintenanceWindow`.
8775
+ #
8776
+ # However, for an improved security posture, we strongly recommend
8777
+ # creating a custom policy and custom service role for running your
8778
+ # maintenance window tasks. The policy can be crafted to provide only
8779
+ # the permissions needed for your particular maintenance window tasks.
8780
+ # For more information, see [Setting up Maintenance Windows][1] in the
8781
+ # in the *Amazon Web Services Systems Manager User Guide*.
8782
+ #
8783
+ #
8784
+ #
8785
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
8414
8786
  # @return [String]
8415
8787
  #
8416
8788
  # @!attribute [rw] task_type
@@ -8726,7 +9098,7 @@ module Aws::SSM
8726
9098
  #
8727
9099
  #
8728
9100
  #
8729
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sharing.html
9101
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
8730
9102
  # @return [String]
8731
9103
  #
8732
9104
  # @!attribute [rw] with_decryption
@@ -9021,6 +9393,15 @@ module Aws::SSM
9021
9393
  # to Linux managed nodes only.
9022
9394
  # @return [Array<Types::PatchSource>]
9023
9395
  #
9396
+ # @!attribute [rw] available_security_updates_compliance_status
9397
+ # Indicates the compliance status of managed nodes for which
9398
+ # security-related patches are available but were not approved. This
9399
+ # preference is specified when the `CreatePatchBaseline` or
9400
+ # `UpdatePatchBaseline` commands are run.
9401
+ #
9402
+ # Applies to Windows Server managed nodes only.
9403
+ # @return [String]
9404
+ #
9024
9405
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaselineResult AWS API Documentation
9025
9406
  #
9026
9407
  class GetPatchBaselineResult < Struct.new(
@@ -9038,7 +9419,8 @@ module Aws::SSM
9038
9419
  :created_date,
9039
9420
  :modified_date,
9040
9421
  :description,
9041
- :sources)
9422
+ :sources,
9423
+ :available_security_updates_compliance_status)
9042
9424
  SENSITIVE = []
9043
9425
  include Aws::Structure
9044
9426
  end
@@ -9129,16 +9511,20 @@ module Aws::SSM
9129
9511
  # The ID of the service setting to get. The setting ID can be one of
9130
9512
  # the following.
9131
9513
  #
9132
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
9514
+ # * `/ssm/appmanager/appmanager-enabled`
9133
9515
  #
9134
9516
  # * `/ssm/automation/customer-script-log-destination`
9135
9517
  #
9136
9518
  # * `/ssm/automation/customer-script-log-group-name`
9137
9519
  #
9520
+ # * /ssm/automation/enable-adaptive-concurrency
9521
+ #
9138
9522
  # * `/ssm/documents/console/public-sharing-permission`
9139
9523
  #
9140
9524
  # * `/ssm/managed-instance/activation-tier`
9141
9525
  #
9526
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
9527
+ #
9142
9528
  # * `/ssm/opsinsights/opscenter`
9143
9529
  #
9144
9530
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -9400,35 +9786,96 @@ module Aws::SSM
9400
9786
  include Aws::Structure
9401
9787
  end
9402
9788
 
9403
- # Describes a filter for a specific list of managed nodes.
9789
+ # Details about a specific managed node.
9404
9790
  #
9405
- # @!attribute [rw] instance_id
9406
- # The managed node ID.
9791
+ # @!attribute [rw] agent_type
9792
+ # The type of agent installed on the node.
9407
9793
  # @return [String]
9408
9794
  #
9409
- # @!attribute [rw] ping_status
9410
- # Connection status of SSM Agent.
9795
+ # @!attribute [rw] agent_version
9796
+ # The version number of the agent installed on the node.
9797
+ # @return [String]
9411
9798
  #
9412
- # <note markdown="1"> The status `Inactive` has been deprecated and is no longer in use.
9799
+ # @!attribute [rw] computer_name
9800
+ # The fully qualified host name of the managed node.
9801
+ # @return [String]
9413
9802
  #
9414
- # </note>
9803
+ # @!attribute [rw] instance_status
9804
+ # The current status of the managed node.
9415
9805
  # @return [String]
9416
9806
  #
9417
- # @!attribute [rw] last_ping_date_time
9418
- # The date and time when the agent last pinged the Systems Manager
9419
- # service.
9420
- # @return [Time]
9807
+ # @!attribute [rw] ip_address
9808
+ # The IP address of the managed node.
9809
+ # @return [String]
9421
9810
  #
9422
- # @!attribute [rw] agent_version
9423
- # The version of SSM Agent running on your Linux managed node.
9811
+ # @!attribute [rw] managed_status
9812
+ # Indicates whether the node is managed by Systems Manager.
9424
9813
  # @return [String]
9425
9814
  #
9426
- # @!attribute [rw] is_latest_version
9427
- # Indicates whether the latest version of SSM Agent is running on your
9428
- # Linux managed node. This field doesn't indicate whether or not the
9429
- # latest version is installed on Windows managed nodes, because some
9430
- # older versions of Windows Server use the EC2Config service to
9431
- # process Systems Manager requests.
9815
+ # @!attribute [rw] platform_type
9816
+ # The operating system platform type of the managed node.
9817
+ # @return [String]
9818
+ #
9819
+ # @!attribute [rw] platform_name
9820
+ # The name of the operating system platform running on your managed
9821
+ # node.
9822
+ # @return [String]
9823
+ #
9824
+ # @!attribute [rw] platform_version
9825
+ # The version of the OS platform running on your managed node.
9826
+ # @return [String]
9827
+ #
9828
+ # @!attribute [rw] resource_type
9829
+ # The type of instance, either an EC2 instance or another supported
9830
+ # machine type in a hybrid fleet.
9831
+ # @return [String]
9832
+ #
9833
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceInfo AWS API Documentation
9834
+ #
9835
+ class InstanceInfo < Struct.new(
9836
+ :agent_type,
9837
+ :agent_version,
9838
+ :computer_name,
9839
+ :instance_status,
9840
+ :ip_address,
9841
+ :managed_status,
9842
+ :platform_type,
9843
+ :platform_name,
9844
+ :platform_version,
9845
+ :resource_type)
9846
+ SENSITIVE = [:ip_address]
9847
+ include Aws::Structure
9848
+ end
9849
+
9850
+ # Describes a filter for a specific list of managed nodes.
9851
+ #
9852
+ # @!attribute [rw] instance_id
9853
+ # The managed node ID.
9854
+ # @return [String]
9855
+ #
9856
+ # @!attribute [rw] ping_status
9857
+ # Connection status of SSM Agent.
9858
+ #
9859
+ # <note markdown="1"> The status `Inactive` has been deprecated and is no longer in use.
9860
+ #
9861
+ # </note>
9862
+ # @return [String]
9863
+ #
9864
+ # @!attribute [rw] last_ping_date_time
9865
+ # The date and time when the agent last pinged the Systems Manager
9866
+ # service.
9867
+ # @return [Time]
9868
+ #
9869
+ # @!attribute [rw] agent_version
9870
+ # The version of SSM Agent running on your Linux managed node.
9871
+ # @return [String]
9872
+ #
9873
+ # @!attribute [rw] is_latest_version
9874
+ # Indicates whether the latest version of SSM Agent is running on your
9875
+ # Linux managed node. This field doesn't indicate whether or not the
9876
+ # latest version is installed on Windows managed nodes, because some
9877
+ # older versions of Windows Server use the EC2Config service to
9878
+ # process Systems Manager requests.
9432
9879
  # @return [Boolean]
9433
9880
  #
9434
9881
  # @!attribute [rw] platform_type
@@ -9450,11 +9897,14 @@ module Aws::SSM
9450
9897
  # @return [String]
9451
9898
  #
9452
9899
  # @!attribute [rw] iam_role
9453
- # The Identity and Access Management (IAM) role assigned to the
9454
- # on-premises Systems Manager managed node. This call doesn't return
9455
- # the IAM role for Amazon Elastic Compute Cloud (Amazon EC2)
9456
- # instances. To retrieve the IAM role for an EC2 instance, use the
9457
- # Amazon EC2 `DescribeInstances` operation. For information, see
9900
+ # The role assigned to an Amazon EC2 instance configured with a
9901
+ # Systems Manager Quick Setup host management configuration or the
9902
+ # role assigned to an on-premises managed node.
9903
+ #
9904
+ # This call doesn't return the IAM role for *unmanaged* Amazon EC2
9905
+ # instances (instances not configured for Systems Manager). To
9906
+ # retrieve the role for an unmanaged instance, use the Amazon EC2
9907
+ # `DescribeInstances` operation. For information, see
9458
9908
  # [DescribeInstances][1] in the *Amazon EC2 API Reference* or
9459
9909
  # [describe-instances][2] in the *Amazon Web Services CLI Command
9460
9910
  # Reference*.
@@ -9481,19 +9931,18 @@ module Aws::SSM
9481
9931
  # The name is specified as the `DefaultInstanceName` property using
9482
9932
  # the CreateActivation command. It is applied to the managed node by
9483
9933
  # specifying the Activation Code and Activation ID when you install
9484
- # SSM Agent on the node, as explained in [Install SSM Agent for a
9485
- # hybrid and multicloud environment (Linux)][1] and [Install SSM Agent
9486
- # for a hybrid and multicloud environment (Windows)][2]. To retrieve
9487
- # the `Name` tag of an EC2 instance, use the Amazon EC2
9488
- # `DescribeInstances` operation. For information, see
9489
- # [DescribeInstances][3] in the *Amazon EC2 API Reference* or
9490
- # [describe-instances][4] in the *Amazon Web Services CLI Command
9491
- # Reference*.
9934
+ # SSM Agent on the node, as explained in [How to install SSM Agent on
9935
+ # hybrid Linux nodes][1] and [How to install SSM Agent on hybrid
9936
+ # Windows Server nodes][2]. To retrieve the `Name` tag of an EC2
9937
+ # instance, use the Amazon EC2 `DescribeInstances` operation. For
9938
+ # information, see [DescribeInstances][3] in the *Amazon EC2 API
9939
+ # Reference* or [describe-instances][4] in the *Amazon Web Services
9940
+ # CLI Command Reference*.
9492
9941
  #
9493
9942
  #
9494
9943
  #
9495
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-managed-linux.html
9496
- # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-managed-win.html
9944
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-ssm-agent-install-linux.html
9945
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-ssm-agent-install-windows.html
9497
9946
  # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
9498
9947
  # [4]: https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html
9499
9948
  # @return [String]
@@ -9594,7 +10043,7 @@ module Aws::SSM
9594
10043
  # Valid filter key values: ActivationIds \| AgentVersion \|
9595
10044
  # AssociationStatus \| IamRole \| InstanceIds \| PingStatus \|
9596
10045
  # PlatformTypes \| ResourceType \| SourceIds \| SourceTypes \|
9597
- # "tag-key" \| "tag:`\{keyname\}`
10046
+ # "tag-key" \| "tag:`{keyname}`
9598
10047
  #
9599
10048
  # * Valid values for the `AssociationStatus` filter key: Success \|
9600
10049
  # Pending \| Failed
@@ -9659,8 +10108,8 @@ module Aws::SSM
9659
10108
  # the patches specified by the default patch baseline.
9660
10109
  #
9661
10110
  # For more information about the `InstallOverrideList` parameter, see
9662
- # [About the `AWS-RunPatchBaseline SSM document` ][1] in the *Amazon
9663
- # Web Services Systems Manager User Guide*.
10111
+ # [SSM Command document for patching: `AWS-RunPatchBaseline` ][1] in
10112
+ # the *Amazon Web Services Systems Manager User Guide*.
9664
10113
  #
9665
10114
  #
9666
10115
  #
@@ -9714,7 +10163,7 @@ module Aws::SSM
9714
10163
  # @!attribute [rw] unreported_not_applicable_count
9715
10164
  # The number of patches beyond the supported limit of
9716
10165
  # `NotApplicableCount` that aren't reported by name to Inventory.
9717
- # Inventory is a capability of Amazon Web Services Systems Manager.
10166
+ # Inventory is a tool in Amazon Web Services Systems Manager.
9718
10167
  # @return [Integer]
9719
10168
  #
9720
10169
  # @!attribute [rw] not_applicable_count
@@ -9725,6 +10174,15 @@ module Aws::SSM
9725
10174
  # `UnreportedNotApplicableCount`.
9726
10175
  # @return [Integer]
9727
10176
  #
10177
+ # @!attribute [rw] available_security_update_count
10178
+ # The number of security-related patches that are available but not
10179
+ # approved because they didn't meet the patch baseline requirements.
10180
+ # For example, an updated version of a patch might have been released
10181
+ # before the specified auto-approval period was over.
10182
+ #
10183
+ # Applies to Windows Server managed nodes only.
10184
+ # @return [Integer]
10185
+ #
9728
10186
  # @!attribute [rw] operation_start_time
9729
10187
  # The time the most recent patching operation was started on the
9730
10188
  # managed node.
@@ -9805,6 +10263,7 @@ module Aws::SSM
9805
10263
  :failed_count,
9806
10264
  :unreported_not_applicable_count,
9807
10265
  :not_applicable_count,
10266
+ :available_security_update_count,
9808
10267
  :operation_start_time,
9809
10268
  :operation_end_time,
9810
10269
  :operation,
@@ -9899,7 +10358,7 @@ module Aws::SSM
9899
10358
  # @return [String]
9900
10359
  #
9901
10360
  # @!attribute [rw] architecture
9902
- # The CPU architecture of the node. For example, x86\_64.
10361
+ # The CPU architecture of the node. For example, `x86_64`.
9903
10362
  # @return [String]
9904
10363
  #
9905
10364
  # @!attribute [rw] ip_address
@@ -9926,7 +10385,7 @@ module Aws::SSM
9926
10385
  #
9927
10386
  # @!attribute [rw] platform_type
9928
10387
  # The operating system platform type of the managed node. For example,
9929
- # Windows.
10388
+ # Windows Server or Amazon Linux 2.
9930
10389
  # @return [String]
9931
10390
  #
9932
10391
  # @!attribute [rw] platform_name
@@ -10090,7 +10549,7 @@ module Aws::SSM
10090
10549
  include Aws::Structure
10091
10550
  end
10092
10551
 
10093
- # The activation ID isn't valid. Verify the you entered the correct
10552
+ # The activation ID isn't valid. Verify that you entered the correct
10094
10553
  # ActivationId or ActivationCode and try again.
10095
10554
  #
10096
10555
  # @!attribute [rw] message
@@ -10104,9 +10563,8 @@ module Aws::SSM
10104
10563
  include Aws::Structure
10105
10564
  end
10106
10565
 
10107
- # The specified aggregator isn't valid for inventory groups. Verify
10108
- # that the aggregator uses a valid inventory type such as
10109
- # `AWS:Application` or `AWS:InstanceInformation`.
10566
+ # The specified aggregator isn't valid for the group type. Verify that
10567
+ # the aggregator you provided is supported.
10110
10568
  #
10111
10569
  # @!attribute [rw] message
10112
10570
  # @return [String]
@@ -10320,7 +10778,7 @@ module Aws::SSM
10320
10778
  include Aws::Structure
10321
10779
  end
10322
10780
 
10323
- # The filter name isn't valid. Verify the you entered the correct name
10781
+ # The filter name isn't valid. Verify that you entered the correct name
10324
10782
  # and try again.
10325
10783
  #
10326
10784
  # @!attribute [rw] message
@@ -10796,7 +11254,7 @@ module Aws::SSM
10796
11254
  #
10797
11255
  #
10798
11256
  #
10799
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-custom.html#sysman-inventory-delete
11257
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-custom.html#delete-custom-inventory
10800
11258
  # @return [Types::InventoryDeletionSummary]
10801
11259
  #
10802
11260
  # @!attribute [rw] last_status_update_time
@@ -10892,7 +11350,7 @@ module Aws::SSM
10892
11350
  #
10893
11351
  #
10894
11352
  #
10895
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-aggregate.html
11353
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-aggregate.html
10896
11354
  # @return [String]
10897
11355
  #
10898
11356
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InventoryFilter AWS API Documentation
@@ -11759,6 +12217,129 @@ module Aws::SSM
11759
12217
  include Aws::Structure
11760
12218
  end
11761
12219
 
12220
+ # @!attribute [rw] sync_name
12221
+ # The name of the Amazon Web Services managed resource data sync to
12222
+ # retrieve information about.
12223
+ #
12224
+ # For cross-account/cross-Region configurations, this parameter is
12225
+ # required, and the name of the supported resource data sync is
12226
+ # `AWS-QuickSetup-ManagedNode`.
12227
+ #
12228
+ # For single account/single-Region configurations, the parameter is
12229
+ # not required.
12230
+ # @return [String]
12231
+ #
12232
+ # @!attribute [rw] filters
12233
+ # One or more filters. Use a filter to return a more specific list of
12234
+ # managed nodes.
12235
+ # @return [Array<Types::NodeFilter>]
12236
+ #
12237
+ # @!attribute [rw] next_token
12238
+ # The token for the next set of items to return. (You received this
12239
+ # token from a previous call.)
12240
+ # @return [String]
12241
+ #
12242
+ # @!attribute [rw] max_results
12243
+ # The maximum number of items to return for this call. The call also
12244
+ # returns a token that you can specify in a subsequent call to get the
12245
+ # next set of results.
12246
+ # @return [Integer]
12247
+ #
12248
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesRequest AWS API Documentation
12249
+ #
12250
+ class ListNodesRequest < Struct.new(
12251
+ :sync_name,
12252
+ :filters,
12253
+ :next_token,
12254
+ :max_results)
12255
+ SENSITIVE = []
12256
+ include Aws::Structure
12257
+ end
12258
+
12259
+ # @!attribute [rw] nodes
12260
+ # A list of managed nodes that match the specified filter criteria.
12261
+ # @return [Array<Types::Node>]
12262
+ #
12263
+ # @!attribute [rw] next_token
12264
+ # The token to use when requesting the next set of items. If there are
12265
+ # no additional items to return, the string is empty.
12266
+ # @return [String]
12267
+ #
12268
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesResult AWS API Documentation
12269
+ #
12270
+ class ListNodesResult < Struct.new(
12271
+ :nodes,
12272
+ :next_token)
12273
+ SENSITIVE = []
12274
+ include Aws::Structure
12275
+ end
12276
+
12277
+ # @!attribute [rw] sync_name
12278
+ # The name of the Amazon Web Services managed resource data sync to
12279
+ # retrieve information about.
12280
+ #
12281
+ # For cross-account/cross-Region configurations, this parameter is
12282
+ # required, and the name of the supported resource data sync is
12283
+ # `AWS-QuickSetup-ManagedNode`.
12284
+ #
12285
+ # For single account/single-Region configurations, the parameter is
12286
+ # not required.
12287
+ # @return [String]
12288
+ #
12289
+ # @!attribute [rw] filters
12290
+ # One or more filters. Use a filter to generate a summary that matches
12291
+ # your specified filter criteria.
12292
+ # @return [Array<Types::NodeFilter>]
12293
+ #
12294
+ # @!attribute [rw] aggregators
12295
+ # Specify one or more aggregators to return a count of managed nodes
12296
+ # that match that expression. For example, a count of managed nodes by
12297
+ # operating system.
12298
+ # @return [Array<Types::NodeAggregator>]
12299
+ #
12300
+ # @!attribute [rw] next_token
12301
+ # The token for the next set of items to return. (You received this
12302
+ # token from a previous call.) The call also returns a token that you
12303
+ # can specify in a subsequent call to get the next set of results.
12304
+ # @return [String]
12305
+ #
12306
+ # @!attribute [rw] max_results
12307
+ # The maximum number of items to return for this call. The call also
12308
+ # returns a token that you can specify in a subsequent call to get the
12309
+ # next set of results.
12310
+ # @return [Integer]
12311
+ #
12312
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummaryRequest AWS API Documentation
12313
+ #
12314
+ class ListNodesSummaryRequest < Struct.new(
12315
+ :sync_name,
12316
+ :filters,
12317
+ :aggregators,
12318
+ :next_token,
12319
+ :max_results)
12320
+ SENSITIVE = []
12321
+ include Aws::Structure
12322
+ end
12323
+
12324
+ # @!attribute [rw] summary
12325
+ # A collection of objects reporting information about your managed
12326
+ # nodes, such as the count of nodes by operating system.
12327
+ # @return [Array<Hash<String,String>>]
12328
+ #
12329
+ # @!attribute [rw] next_token
12330
+ # The token to use when requesting the next set of items. If there are
12331
+ # no additional items to return, the string is empty.
12332
+ # @return [String]
12333
+ #
12334
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummaryResult AWS API Documentation
12335
+ #
12336
+ class ListNodesSummaryResult < Struct.new(
12337
+ :summary,
12338
+ :next_token)
12339
+ SENSITIVE = []
12340
+ include Aws::Structure
12341
+ end
12342
+
11762
12343
  # @!attribute [rw] filters
11763
12344
  # One or more OpsItem filters. Use a filter to return a more specific
11764
12345
  # list of results.
@@ -12539,10 +13120,24 @@ module Aws::SSM
12539
13120
  # @return [Hash<String,Array<String>>]
12540
13121
  #
12541
13122
  # @!attribute [rw] service_role_arn
12542
- # The Amazon Resource Name (ARN) of the Identity and Access Management
12543
- # (IAM) service role to use to publish Amazon Simple Notification
12544
- # Service (Amazon SNS) notifications for maintenance window Run
12545
- # Command tasks.
13123
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
13124
+ # Web Services Systems Manager to assume when running a maintenance
13125
+ # window task. If you do not specify a service role ARN, Systems
13126
+ # Manager uses a service-linked role in your account. If no
13127
+ # appropriate service-linked role for Systems Manager exists in your
13128
+ # account, it is created when you run
13129
+ # `RegisterTaskWithMaintenanceWindow`.
13130
+ #
13131
+ # However, for an improved security posture, we strongly recommend
13132
+ # creating a custom policy and custom service role for running your
13133
+ # maintenance window tasks. The policy can be crafted to provide only
13134
+ # the permissions needed for your particular maintenance window tasks.
13135
+ # For more information, see [Setting up Maintenance Windows][1] in the
13136
+ # in the *Amazon Web Services Systems Manager User Guide*.
13137
+ #
13138
+ #
13139
+ #
13140
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
12546
13141
  # @return [String]
12547
13142
  #
12548
13143
  # @!attribute [rw] timeout_seconds
@@ -12726,10 +13321,24 @@ module Aws::SSM
12726
13321
  # @return [Types::LoggingInfo]
12727
13322
  #
12728
13323
  # @!attribute [rw] service_role_arn
12729
- # The Amazon Resource Name (ARN) of the Identity and Access Management
12730
- # (IAM) service role to use to publish Amazon Simple Notification
12731
- # Service (Amazon SNS) notifications for maintenance window Run
12732
- # Command tasks.
13324
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
13325
+ # Web Services Systems Manager to assume when running a maintenance
13326
+ # window task. If you do not specify a service role ARN, Systems
13327
+ # Manager uses a service-linked role in your account. If no
13328
+ # appropriate service-linked role for Systems Manager exists in your
13329
+ # account, it is created when you run
13330
+ # `RegisterTaskWithMaintenanceWindow`.
13331
+ #
13332
+ # However, for an improved security posture, we strongly recommend
13333
+ # creating a custom policy and custom service role for running your
13334
+ # maintenance window tasks. The policy can be crafted to provide only
13335
+ # the permissions needed for your particular maintenance window tasks.
13336
+ # For more information, see [Setting up Maintenance Windows][1] in the
13337
+ # in the *Amazon Web Services Systems Manager User Guide*.
13338
+ #
13339
+ #
13340
+ #
13341
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
12733
13342
  # @return [String]
12734
13343
  #
12735
13344
  # @!attribute [rw] max_concurrency
@@ -12908,7 +13517,8 @@ module Aws::SSM
12908
13517
  # @!attribute [rw] account_ids_to_add
12909
13518
  # The Amazon Web Services users that should have access to the
12910
13519
  # document. The account IDs can either be a group of account IDs or
12911
- # *All*.
13520
+ # *All*. You must specify a value for this parameter or the
13521
+ # `AccountIdsToRemove` parameter.
12912
13522
  # @return [Array<String>]
12913
13523
  #
12914
13524
  # @!attribute [rw] account_ids_to_remove
@@ -12916,7 +13526,8 @@ module Aws::SSM
12916
13526
  # the document. The Amazon Web Services user can either be a group of
12917
13527
  # account IDs or *All*. This action has a higher priority than
12918
13528
  # `AccountIdsToAdd`. If you specify an ID to add and the same ID to
12919
- # remove, the system removes access to the document.
13529
+ # remove, the system removes access to the document. You must specify
13530
+ # a value for this parameter or the `AccountIdsToAdd` parameter.
12920
13531
  # @return [Array<String>]
12921
13532
  #
12922
13533
  # @!attribute [rw] shared_document_version
@@ -12940,6 +13551,149 @@ module Aws::SSM
12940
13551
  #
12941
13552
  class ModifyDocumentPermissionResponse < Aws::EmptyStructure; end
12942
13553
 
13554
+ # Details about an individual managed node.
13555
+ #
13556
+ # @!attribute [rw] capture_time
13557
+ # The UTC timestamp for when the managed node data was last captured.
13558
+ # @return [Time]
13559
+ #
13560
+ # @!attribute [rw] id
13561
+ # The ID of the managed node.
13562
+ # @return [String]
13563
+ #
13564
+ # @!attribute [rw] owner
13565
+ # Information about the ownership of the managed node.
13566
+ # @return [Types::NodeOwnerInfo]
13567
+ #
13568
+ # @!attribute [rw] region
13569
+ # The Amazon Web Services Region that a managed node was created in or
13570
+ # assigned to.
13571
+ # @return [String]
13572
+ #
13573
+ # @!attribute [rw] node_type
13574
+ # Information about the type of node.
13575
+ # @return [Types::NodeType]
13576
+ #
13577
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Node AWS API Documentation
13578
+ #
13579
+ class Node < Struct.new(
13580
+ :capture_time,
13581
+ :id,
13582
+ :owner,
13583
+ :region,
13584
+ :node_type)
13585
+ SENSITIVE = []
13586
+ include Aws::Structure
13587
+ end
13588
+
13589
+ # One or more aggregators for viewing counts of nodes using different
13590
+ # dimensions.
13591
+ #
13592
+ # @!attribute [rw] aggregator_type
13593
+ # The aggregator type for limiting a node summary. Currently, only
13594
+ # `Count` is supported.
13595
+ # @return [String]
13596
+ #
13597
+ # @!attribute [rw] type_name
13598
+ # The data type name to use for viewing counts of nodes. Currently,
13599
+ # only `Instance` is supported.
13600
+ # @return [String]
13601
+ #
13602
+ # @!attribute [rw] attribute_name
13603
+ # The name of a node attribute on which to limit the count of nodes.
13604
+ # @return [String]
13605
+ #
13606
+ # @!attribute [rw] aggregators
13607
+ # Information about aggregators used to refine a node summary.
13608
+ # @return [Array<Types::NodeAggregator>]
13609
+ #
13610
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeAggregator AWS API Documentation
13611
+ #
13612
+ class NodeAggregator < Struct.new(
13613
+ :aggregator_type,
13614
+ :type_name,
13615
+ :attribute_name,
13616
+ :aggregators)
13617
+ SENSITIVE = []
13618
+ include Aws::Structure
13619
+ end
13620
+
13621
+ # The filters for the operation.
13622
+ #
13623
+ # @!attribute [rw] key
13624
+ # The name of the filter.
13625
+ # @return [String]
13626
+ #
13627
+ # @!attribute [rw] values
13628
+ # A filter value supported by the specified key. For example, for the
13629
+ # key `PlatformType`, supported values include `Linux` and `Windows`.
13630
+ # @return [Array<String>]
13631
+ #
13632
+ # @!attribute [rw] type
13633
+ # The type of filter operator.
13634
+ # @return [String]
13635
+ #
13636
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeFilter AWS API Documentation
13637
+ #
13638
+ class NodeFilter < Struct.new(
13639
+ :key,
13640
+ :values,
13641
+ :type)
13642
+ SENSITIVE = []
13643
+ include Aws::Structure
13644
+ end
13645
+
13646
+ # Information about ownership of a managed node.
13647
+ #
13648
+ # @!attribute [rw] account_id
13649
+ # The ID of the Amazon Web Services account that owns the managed
13650
+ # node.
13651
+ # @return [String]
13652
+ #
13653
+ # @!attribute [rw] organizational_unit_id
13654
+ # The ID of the organization unit (OU) that the account is part of.
13655
+ # @return [String]
13656
+ #
13657
+ # @!attribute [rw] organizational_unit_path
13658
+ # The path for the organizational unit (OU) that owns the managed
13659
+ # node. The path for the OU is built using the IDs of the
13660
+ # organization, root, and all OUs in the path down to and including
13661
+ # the OU. For example:
13662
+ #
13663
+ # `o-a1b2c3d4e5/r-f6g7h8i9j0example/ou-ghi0-awsccccc/ou-jkl0-awsddddd/`
13664
+ # @return [String]
13665
+ #
13666
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeOwnerInfo AWS API Documentation
13667
+ #
13668
+ class NodeOwnerInfo < Struct.new(
13669
+ :account_id,
13670
+ :organizational_unit_id,
13671
+ :organizational_unit_path)
13672
+ SENSITIVE = []
13673
+ include Aws::Structure
13674
+ end
13675
+
13676
+ # Information about a managed node's type.
13677
+ #
13678
+ # @note NodeType is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of NodeType corresponding to the set member.
13679
+ #
13680
+ # @!attribute [rw] instance
13681
+ # Information about a specific managed node.
13682
+ # @return [Types::InstanceInfo]
13683
+ #
13684
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeType AWS API Documentation
13685
+ #
13686
+ class NodeType < Struct.new(
13687
+ :instance,
13688
+ :unknown)
13689
+ SENSITIVE = []
13690
+ include Aws::Structure
13691
+ include Aws::Structure::Union
13692
+
13693
+ class Instance < NodeType; end
13694
+ class Unknown < NodeType; end
13695
+ end
13696
+
12943
13697
  # A summary of resources that aren't compliant. The summary is
12944
13698
  # organized according to resource type.
12945
13699
  #
@@ -13192,9 +13946,8 @@ module Aws::SSM
13192
13946
  # @return [Array<Types::RelatedOpsItem>]
13193
13947
  #
13194
13948
  # @!attribute [rw] status
13195
- # The OpsItem status. Status can be `Open`, `In Progress`, or
13196
- # `Resolved`. For more information, see [Editing OpsItem details][1]
13197
- # in the *Amazon Web Services Systems Manager User Guide*.
13949
+ # The OpsItem status. For more information, see [Editing OpsItem
13950
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
13198
13951
  #
13199
13952
  #
13200
13953
  #
@@ -13714,8 +14467,7 @@ module Aws::SSM
13714
14467
  # @return [String]
13715
14468
  #
13716
14469
  # @!attribute [rw] status
13717
- # The OpsItem status. Status can be `Open`, `In Progress`, or
13718
- # `Resolved`.
14470
+ # The OpsItem status.
13719
14471
  # @return [String]
13720
14472
  #
13721
14473
  # @!attribute [rw] ops_item_id
@@ -14159,9 +14911,9 @@ module Aws::SSM
14159
14911
  # @return [String]
14160
14912
  #
14161
14913
  # @!attribute [rw] policy_type
14162
- # The type of policy. Parameter Store, a capability of Amazon Web
14163
- # Services Systems Manager, supports the following policy types:
14164
- # Expiration, ExpirationNotification, and NoChangeNotification.
14914
+ # The type of policy. Parameter Store, a tool in Amazon Web Services
14915
+ # Systems Manager, supports the following policy types: Expiration,
14916
+ # ExpirationNotification, and NoChangeNotification.
14165
14917
  # @return [String]
14166
14918
  #
14167
14919
  # @!attribute [rw] policy_status
@@ -14241,7 +14993,7 @@ module Aws::SSM
14241
14993
  # @return [String]
14242
14994
  #
14243
14995
  # @!attribute [rw] arn
14244
- # The (ARN) of the last user to update the parameter.
14996
+ # The Amazon Resource Name (ARN) of the parameter.
14245
14997
  # @return [String]
14246
14998
  #
14247
14999
  # @!attribute [rw] type
@@ -14311,6 +15063,12 @@ module Aws::SSM
14311
15063
 
14312
15064
  # The parameter couldn't be found. Verify the name and try again.
14313
15065
  #
15066
+ # <note markdown="1"> For the `DeleteParameter` and `GetParameter` actions, if the specified
15067
+ # parameter doesn't exist, the `ParameterNotFound` exception is *not*
15068
+ # recorded in CloudTrail event logs.
15069
+ #
15070
+ # </note>
15071
+ #
14314
15072
  # @!attribute [rw] message
14315
15073
  # @return [String]
14316
15074
  #
@@ -14637,10 +15395,10 @@ module Aws::SSM
14637
15395
  # @return [String]
14638
15396
  #
14639
15397
  # @!attribute [rw] default_baseline
14640
- # Whether this is the default baseline. Amazon Web Services Systems
14641
- # Manager supports creating multiple default patch baselines. For
14642
- # example, you can create a default patch baseline for each operating
14643
- # system.
15398
+ # Indicates whether this is the default baseline. Amazon Web Services
15399
+ # Systems Manager supports creating multiple default patch baselines.
15400
+ # For example, you can create a default patch baseline for each
15401
+ # operating system.
14644
15402
  # @return [Boolean]
14645
15403
  #
14646
15404
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PatchBaselineIdentity AWS API Documentation
@@ -14686,7 +15444,7 @@ module Aws::SSM
14686
15444
  #
14687
15445
  #
14688
15446
  #
14689
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-compliance-about.html#sysman-compliance-monitor-patch
15447
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html#compliance-monitor-patch
14690
15448
  # @return [String]
14691
15449
  #
14692
15450
  # @!attribute [rw] installed_time
@@ -14840,16 +15598,48 @@ module Aws::SSM
14840
15598
  # The number of days after the release date of each patch matched by
14841
15599
  # the rule that the patch is marked as approved in the patch baseline.
14842
15600
  # For example, a value of `7` means that patches are approved seven
14843
- # days after they are released. Not supported on Debian Server or
14844
- # Ubuntu Server.
15601
+ # days after they are released.
15602
+ #
15603
+ # This parameter is marked as `Required: No`, but your request must
15604
+ # include a value for either `ApproveAfterDays` or `ApproveUntilDate`.
15605
+ #
15606
+ # Not supported for Debian Server or Ubuntu Server.
15607
+ #
15608
+ # Use caution when setting this value for Windows Server patch
15609
+ # baselines. Because patch updates that are replaced by later updates
15610
+ # are removed, setting too broad a value for this parameter can result
15611
+ # in crucial patches not being installed. For more information, see
15612
+ # the **Windows Server** tab in the topic [How security patches are
15613
+ # selected][1] in the *Amazon Web Services Systems Manager User
15614
+ # Guide*.
15615
+ #
15616
+ #
15617
+ #
15618
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-selecting-patches.html
14845
15619
  # @return [Integer]
14846
15620
  #
14847
15621
  # @!attribute [rw] approve_until_date
14848
15622
  # The cutoff date for auto approval of released patches. Any patches
14849
- # released on or before this date are installed automatically. Not
14850
- # supported on Debian Server or Ubuntu Server.
15623
+ # released on or before this date are installed automatically.
15624
+ #
15625
+ # Enter dates in the format `YYYY-MM-DD`. For example, `2024-12-31`.
15626
+ #
15627
+ # This parameter is marked as `Required: No`, but your request must
15628
+ # include a value for either `ApproveUntilDate` or `ApproveAfterDays`.
14851
15629
  #
14852
- # Enter dates in the format `YYYY-MM-DD`. For example, `2021-12-31`.
15630
+ # Not supported for Debian Server or Ubuntu Server.
15631
+ #
15632
+ # Use caution when setting this value for Windows Server patch
15633
+ # baselines. Because patch updates that are replaced by later updates
15634
+ # are removed, setting too broad a value for this parameter can result
15635
+ # in crucial patches not being installed. For more information, see
15636
+ # the **Windows Server** tab in the topic [How security patches are
15637
+ # selected][1] in the *Amazon Web Services Systems Manager User
15638
+ # Guide*.
15639
+ #
15640
+ #
15641
+ #
15642
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-selecting-patches.html
14853
15643
  # @return [String]
14854
15644
  #
14855
15645
  # @!attribute [rw] enable_non_security
@@ -15115,8 +15905,8 @@ module Aws::SSM
15115
15905
  end
15116
15906
 
15117
15907
  # @!attribute [rw] name
15118
- # The fully qualified name of the parameter that you want to add to
15119
- # the system.
15908
+ # The fully qualified name of the parameter that you want to create or
15909
+ # update.
15120
15910
  #
15121
15911
  # <note markdown="1"> You can't enter the Amazon Resource Name (ARN) for a parameter,
15122
15912
  # only the parameter name itself.
@@ -15155,11 +15945,16 @@ module Aws::SSM
15155
15945
  # see [Creating Systems Manager parameters][1] in the *Amazon Web
15156
15946
  # Services Systems Manager User Guide*.
15157
15947
  #
15158
- # <note markdown="1"> The maximum length constraint of 2048 characters listed below
15159
- # includes 1037 characters reserved for internal use by Systems
15160
- # Manager. The maximum length for a parameter name that you create is
15161
- # 1011 characters. This includes the characters in the ARN that
15162
- # precede the name you specify, such as
15948
+ # <note markdown="1"> The reported maximum length of 2048 characters for a parameter name
15949
+ # includes 1037 characters that are reserved for internal use by
15950
+ # Systems Manager. The maximum length for a parameter name that you
15951
+ # specify is 1011 characters.
15952
+ #
15953
+ # This count of 1011 characters includes the characters in the ARN
15954
+ # that precede the name you specify. This ARN length will vary
15955
+ # depending on your partition and Region. For example, the following
15956
+ # 45 characters count toward the 1011 character maximum for a
15957
+ # parameter created in the US East (Ohio) Region:
15163
15958
  # `arn:aws:ssm:us-east-2:111122223333:parameter/`.
15164
15959
  #
15165
15960
  # </note>
@@ -15182,14 +15977,14 @@ module Aws::SSM
15182
15977
  # value limit of 8 KB.
15183
15978
  #
15184
15979
  # <note markdown="1"> Parameters can't be referenced or nested in the values of other
15185
- # parameters. You can't include `\{\{\}\}` or
15186
- # `\{\{ssm:parameter-name\}\}` in a parameter value.
15980
+ # parameters. You can't include values wrapped in double brackets
15981
+ # `{{}}` or `{{ssm:parameter-name}}` in a parameter value.
15187
15982
  #
15188
15983
  # </note>
15189
15984
  # @return [String]
15190
15985
  #
15191
15986
  # @!attribute [rw] type
15192
- # The type of parameter that you want to add to the system.
15987
+ # The type of parameter that you want to create.
15193
15988
  #
15194
15989
  # <note markdown="1"> `SecureString` isn't currently supported for CloudFormation
15195
15990
  # templates.
@@ -15212,7 +16007,7 @@ module Aws::SSM
15212
16007
  # parameters that use the `SecureString` data type.
15213
16008
  #
15214
16009
  # If you don't specify a key ID, the system uses the default key
15215
- # associated with your Amazon Web Services account which is not as
16010
+ # associated with your Amazon Web Services account, which is not as
15216
16011
  # secure as using a custom key.
15217
16012
  #
15218
16013
  # * To use a custom KMS key, choose the `SecureString` data type with
@@ -15332,8 +16127,8 @@ module Aws::SSM
15332
16127
  #
15333
16128
  # @!attribute [rw] policies
15334
16129
  # One or more policies to apply to a parameter. This operation takes a
15335
- # JSON array. Parameter Store, a capability of Amazon Web Services
15336
- # Systems Manager supports the following policy types:
16130
+ # JSON array. Parameter Store, a tool in Amazon Web Services Systems
16131
+ # Manager supports the following policy types:
15337
16132
  #
15338
16133
  # Expiration: This policy deletes the parameter after it expires. When
15339
16134
  # you create the policy, you specify the expiration date. You can
@@ -15706,7 +16501,7 @@ module Aws::SSM
15706
16501
  # creating a custom policy and custom service role for running your
15707
16502
  # maintenance window tasks. The policy can be crafted to provide only
15708
16503
  # the permissions needed for your particular maintenance window tasks.
15709
- # For more information, see [Setting up maintenance windows][1] in the
16504
+ # For more information, see [Setting up Maintenance Windows][1] in the
15710
16505
  # in the *Amazon Web Services Systems Manager User Guide*.
15711
16506
  #
15712
16507
  #
@@ -15830,7 +16625,6 @@ module Aws::SSM
15830
16625
  # the command associated with the task. However, there is no
15831
16626
  # guarantee that the command will be terminated and the underlying
15832
16627
  # process stopped.
15833
- #
15834
16628
  # The status for tasks that are not completed is `TIMED_OUT`.
15835
16629
  # @return [String]
15836
16630
  #
@@ -15974,16 +16768,20 @@ module Aws::SSM
15974
16768
  # The Amazon Resource Name (ARN) of the service setting to reset. The
15975
16769
  # setting ID can be one of the following.
15976
16770
  #
15977
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
16771
+ # * `/ssm/appmanager/appmanager-enabled`
15978
16772
  #
15979
16773
  # * `/ssm/automation/customer-script-log-destination`
15980
16774
  #
15981
16775
  # * `/ssm/automation/customer-script-log-group-name`
15982
16776
  #
16777
+ # * /ssm/automation/enable-adaptive-concurrency
16778
+ #
15983
16779
  # * `/ssm/documents/console/public-sharing-permission`
15984
16780
  #
15985
16781
  # * `/ssm/managed-instance/activation-tier`
15986
16782
  #
16783
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
16784
+ #
15987
16785
  # * `/ssm/opsinsights/opscenter`
15988
16786
  #
15989
16787
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -17015,8 +17813,8 @@ module Aws::SSM
17015
17813
  #
17016
17814
  # @!attribute [rw] cloud_watch_output_config
17017
17815
  # Enables Amazon Web Services Systems Manager to send Run Command
17018
- # output to Amazon CloudWatch Logs. Run Command is a capability of
17019
- # Amazon Web Services Systems Manager.
17816
+ # output to Amazon CloudWatch Logs. Run Command is a tool in Amazon
17817
+ # Web Services Systems Manager.
17020
17818
  # @return [Types::CloudWatchOutputConfig]
17021
17819
  #
17022
17820
  # @!attribute [rw] alarm_configuration
@@ -17061,6 +17859,42 @@ module Aws::SSM
17061
17859
  include Aws::Structure
17062
17860
  end
17063
17861
 
17862
+ # The request exceeds the service quota. Service quotas, also referred
17863
+ # to as limits, are the maximum number of service resources or
17864
+ # operations for your Amazon Web Services account.
17865
+ #
17866
+ # @!attribute [rw] message
17867
+ # @return [String]
17868
+ #
17869
+ # @!attribute [rw] resource_id
17870
+ # The unique ID of the resource referenced in the failed request.
17871
+ # @return [String]
17872
+ #
17873
+ # @!attribute [rw] resource_type
17874
+ # The resource type of the resource referenced in the failed request.
17875
+ # @return [String]
17876
+ #
17877
+ # @!attribute [rw] quota_code
17878
+ # The quota code recognized by the Amazon Web Services Service Quotas
17879
+ # service.
17880
+ # @return [String]
17881
+ #
17882
+ # @!attribute [rw] service_code
17883
+ # The code for the Amazon Web Services service that owns the quota.
17884
+ # @return [String]
17885
+ #
17886
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ServiceQuotaExceededException AWS API Documentation
17887
+ #
17888
+ class ServiceQuotaExceededException < Struct.new(
17889
+ :message,
17890
+ :resource_id,
17891
+ :resource_type,
17892
+ :quota_code,
17893
+ :service_code)
17894
+ SENSITIVE = []
17895
+ include Aws::Structure
17896
+ end
17897
+
17064
17898
  # The service setting data structure.
17065
17899
  #
17066
17900
  # `ServiceSetting` is an account-level setting for an Amazon Web
@@ -17223,12 +18057,12 @@ module Aws::SSM
17223
18057
  # The filter value. Valid values for each filter key are as follows:
17224
18058
  #
17225
18059
  # * InvokedAfter: Specify a timestamp to limit your results. For
17226
- # example, specify 2018-08-29T00:00:00Z to see sessions that started
17227
- # August 29, 2018, and later.
18060
+ # example, specify 2024-08-29T00:00:00Z to see sessions that started
18061
+ # August 29, 2024, and later.
17228
18062
  #
17229
18063
  # * InvokedBefore: Specify a timestamp to limit your results. For
17230
- # example, specify 2018-08-29T00:00:00Z to see sessions that started
17231
- # before August 29, 2018.
18064
+ # example, specify 2024-08-29T00:00:00Z to see sessions that started
18065
+ # before August 29, 2024.
17232
18066
  #
17233
18067
  # * Target: Specify a managed node to which session connections have
17234
18068
  # been made.
@@ -17250,7 +18084,6 @@ module Aws::SSM
17250
18084
  # * Terminating
17251
18085
  #
17252
18086
  # * Failed
17253
- #
17254
18087
  # * SessionId: Specify a session ID to return details about the
17255
18088
  # session.
17256
18089
  # @return [String]
@@ -17335,6 +18168,42 @@ module Aws::SSM
17335
18168
  include Aws::Structure
17336
18169
  end
17337
18170
 
18171
+ # @!attribute [rw] reason
18172
+ # A brief description explaining why you are requesting access to the
18173
+ # node.
18174
+ # @return [String]
18175
+ #
18176
+ # @!attribute [rw] targets
18177
+ # The node you are requesting access to.
18178
+ # @return [Array<Types::Target>]
18179
+ #
18180
+ # @!attribute [rw] tags
18181
+ # Key-value pairs of metadata you want to assign to the access
18182
+ # request.
18183
+ # @return [Array<Types::Tag>]
18184
+ #
18185
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAccessRequestRequest AWS API Documentation
18186
+ #
18187
+ class StartAccessRequestRequest < Struct.new(
18188
+ :reason,
18189
+ :targets,
18190
+ :tags)
18191
+ SENSITIVE = []
18192
+ include Aws::Structure
18193
+ end
18194
+
18195
+ # @!attribute [rw] access_request_id
18196
+ # The ID of the access request.
18197
+ # @return [String]
18198
+ #
18199
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAccessRequestResponse AWS API Documentation
18200
+ #
18201
+ class StartAccessRequestResponse < Struct.new(
18202
+ :access_request_id)
18203
+ SENSITIVE = []
18204
+ include Aws::Structure
18205
+ end
18206
+
17338
18207
  # @!attribute [rw] association_ids
17339
18208
  # The association IDs that you want to run immediately and only one
17340
18209
  # time.
@@ -17391,6 +18260,9 @@ module Aws::SSM
17391
18260
  # @!attribute [rw] targets
17392
18261
  # A key-value mapping to target resources. Required if you specify
17393
18262
  # TargetParameterName.
18263
+ #
18264
+ # If both this parameter and the `TargetLocation:Targets` parameter
18265
+ # are supplied, `TargetLocation:Targets` takes precedence.
17394
18266
  # @return [Array<Types::Target>]
17395
18267
  #
17396
18268
  # @!attribute [rw] target_maps
@@ -17402,6 +18274,10 @@ module Aws::SSM
17402
18274
  # The maximum number of targets allowed to run this task in parallel.
17403
18275
  # You can specify a number, such as 10, or a percentage, such as 10%.
17404
18276
  # The default value is `10`.
18277
+ #
18278
+ # If both this parameter and the
18279
+ # `TargetLocation:TargetsMaxConcurrency` are supplied,
18280
+ # `TargetLocation:TargetsMaxConcurrency` takes precedence.
17405
18281
  # @return [String]
17406
18282
  #
17407
18283
  # @!attribute [rw] max_errors
@@ -17421,6 +18297,10 @@ module Aws::SSM
17421
18297
  # fail as well. If you need to ensure that there won't be more than
17422
18298
  # max-errors failed executions, set max-concurrency to 1 so the
17423
18299
  # executions proceed one at a time.
18300
+ #
18301
+ # If this parameter and the `TargetLocation:TargetsMaxErrors`
18302
+ # parameter are both supplied, `TargetLocation:TargetsMaxErrors` takes
18303
+ # precedence.
17424
18304
  # @return [String]
17425
18305
  #
17426
18306
  # @!attribute [rw] target_locations
@@ -17428,9 +18308,9 @@ module Aws::SSM
17428
18308
  # Amazon Web Services accounts where you want to run the automation.
17429
18309
  # Use this operation to start an automation in multiple Amazon Web
17430
18310
  # Services Regions and multiple Amazon Web Services accounts. For more
17431
- # information, see [Running Automation workflows in multiple Amazon
17432
- # Web Services Regions and Amazon Web Services accounts][1] in the
17433
- # *Amazon Web Services Systems Manager User Guide*.
18311
+ # information, see [Running automations in multiple Amazon Web
18312
+ # Services Regions and accounts][1] in the *Amazon Web Services
18313
+ # Systems Manager User Guide*.
17434
18314
  #
17435
18315
  #
17436
18316
  #
@@ -17449,8 +18329,11 @@ module Aws::SSM
17449
18329
  #
17450
18330
  # * `Key=OS,Value=Windows`
17451
18331
  #
17452
- # <note markdown="1"> To add tags to an existing automation, use the AddTagsToResource
17453
- # operation.
18332
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
18333
+ # includes capacity reserved for internal operations. When calling the
18334
+ # `StartAutomationExecution` action, you can specify a maximum of 5
18335
+ # tags. You can, however, use the AddTagsToResource action to add up
18336
+ # to a total of 50 tags to an existing automation configuration.
17454
18337
  #
17455
18338
  # </note>
17456
18339
  # @return [Array<Types::Tag>]
@@ -17459,6 +18342,12 @@ module Aws::SSM
17459
18342
  # The CloudWatch alarm you want to apply to your automation.
17460
18343
  # @return [Types::AlarmConfiguration]
17461
18344
  #
18345
+ # @!attribute [rw] target_locations_url
18346
+ # Specify a publicly accessible URL for a file that contains the
18347
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
18348
+ # buckets are supported.
18349
+ # @return [String]
18350
+ #
17462
18351
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAutomationExecutionRequest AWS API Documentation
17463
18352
  #
17464
18353
  class StartAutomationExecutionRequest < Struct.new(
@@ -17474,7 +18363,8 @@ module Aws::SSM
17474
18363
  :max_errors,
17475
18364
  :target_locations,
17476
18365
  :tags,
17477
- :alarm_configuration)
18366
+ :alarm_configuration,
18367
+ :target_locations_url)
17478
18368
  SENSITIVE = []
17479
18369
  include Aws::Structure
17480
18370
  end
@@ -17566,6 +18456,14 @@ module Aws::SSM
17566
18456
  # * `Key=Environment,Value=Production`
17567
18457
  #
17568
18458
  # * `Key=Region,Value=us-east-2`
18459
+ #
18460
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
18461
+ # includes capacity reserved for internal operations. When calling the
18462
+ # `StartChangeRequestExecution` action, you can specify a maximum of 5
18463
+ # tags. You can, however, use the AddTagsToResource action to add up
18464
+ # to a total of 50 tags to an existing change request configuration.
18465
+ #
18466
+ # </note>
17569
18467
  # @return [Array<Types::Tag>]
17570
18468
  #
17571
18469
  # @!attribute [rw] scheduled_end_time
@@ -17611,6 +18509,44 @@ module Aws::SSM
17611
18509
  include Aws::Structure
17612
18510
  end
17613
18511
 
18512
+ # @!attribute [rw] document_name
18513
+ # The name of the Automation runbook to run. The result of the
18514
+ # execution preview indicates what the impact would be of running this
18515
+ # runbook.
18516
+ # @return [String]
18517
+ #
18518
+ # @!attribute [rw] document_version
18519
+ # The version of the Automation runbook to run. The default value is
18520
+ # `$DEFAULT`.
18521
+ # @return [String]
18522
+ #
18523
+ # @!attribute [rw] execution_inputs
18524
+ # Information about the inputs that can be specified for the preview
18525
+ # operation.
18526
+ # @return [Types::ExecutionInputs]
18527
+ #
18528
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreviewRequest AWS API Documentation
18529
+ #
18530
+ class StartExecutionPreviewRequest < Struct.new(
18531
+ :document_name,
18532
+ :document_version,
18533
+ :execution_inputs)
18534
+ SENSITIVE = []
18535
+ include Aws::Structure
18536
+ end
18537
+
18538
+ # @!attribute [rw] execution_preview_id
18539
+ # The ID of the execution preview generated by the system.
18540
+ # @return [String]
18541
+ #
18542
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreviewResponse AWS API Documentation
18543
+ #
18544
+ class StartExecutionPreviewResponse < Struct.new(
18545
+ :execution_preview_id)
18546
+ SENSITIVE = []
18547
+ include Aws::Structure
18548
+ end
18549
+
17614
18550
  # @!attribute [rw] target
17615
18551
  # The managed node to connect to for the session.
17616
18552
  # @return [String]
@@ -17637,7 +18573,13 @@ module Aws::SSM
17637
18573
  #
17638
18574
  # @!attribute [rw] parameters
17639
18575
  # The values you want to specify for the parameters defined in the
17640
- # Session document.
18576
+ # Session document. For more information about these parameters, see
18577
+ # [Create a Session Manager preferences document][1] in the *Amazon
18578
+ # Web Services Systems Manager User Guide*.
18579
+ #
18580
+ #
18581
+ #
18582
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-create-preferences-cli.html
17641
18583
  # @return [Hash<String,Array<String>>]
17642
18584
  #
17643
18585
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartSessionRequest AWS API Documentation
@@ -17935,7 +18877,7 @@ module Aws::SSM
17935
18877
  #
17936
18878
  # Supported formats include the following.
17937
18879
  #
17938
- # **For all Systems Manager capabilities:**
18880
+ # **For all Systems Manager tools:**
17939
18881
  #
17940
18882
  # * `Key=tag-key,Values=tag-value-1,tag-value-2`
17941
18883
  #
@@ -18064,6 +19006,39 @@ module Aws::SSM
18064
19006
  # automation or command.
18065
19007
  # @return [Types::AlarmConfiguration]
18066
19008
  #
19009
+ # @!attribute [rw] include_child_organization_units
19010
+ # Indicates whether to include child organizational units (OUs) that
19011
+ # are children of the targeted OUs. The default is `false`.
19012
+ # @return [Boolean]
19013
+ #
19014
+ # @!attribute [rw] exclude_accounts
19015
+ # Amazon Web Services accounts or organizational units to exclude as
19016
+ # expanded targets.
19017
+ # @return [Array<String>]
19018
+ #
19019
+ # @!attribute [rw] targets
19020
+ # A list of key-value mappings to target resources. If you specify
19021
+ # values for this data type, you must also specify a value for
19022
+ # `TargetParameterName`.
19023
+ #
19024
+ # This `Targets` parameter takes precedence over the
19025
+ # `StartAutomationExecution:Targets` parameter if both are supplied.
19026
+ # @return [Array<Types::Target>]
19027
+ #
19028
+ # @!attribute [rw] targets_max_concurrency
19029
+ # The maximum number of targets allowed to run this task in parallel.
19030
+ # This `TargetsMaxConcurrency` takes precedence over the
19031
+ # `StartAutomationExecution:MaxConcurrency` parameter if both are
19032
+ # supplied.
19033
+ # @return [String]
19034
+ #
19035
+ # @!attribute [rw] targets_max_errors
19036
+ # The maximum number of errors that are allowed before the system
19037
+ # stops running the automation on additional targets. This
19038
+ # `TargetsMaxErrors` parameter takes precedence over the
19039
+ # `StartAutomationExecution:MaxErrors` parameter if both are supplied.
19040
+ # @return [String]
19041
+ #
18067
19042
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/TargetLocation AWS API Documentation
18068
19043
  #
18069
19044
  class TargetLocation < Struct.new(
@@ -18072,17 +19047,22 @@ module Aws::SSM
18072
19047
  :target_location_max_concurrency,
18073
19048
  :target_location_max_errors,
18074
19049
  :execution_role_name,
18075
- :target_location_alarm_configuration)
19050
+ :target_location_alarm_configuration,
19051
+ :include_child_organization_units,
19052
+ :exclude_accounts,
19053
+ :targets,
19054
+ :targets_max_concurrency,
19055
+ :targets_max_errors)
18076
19056
  SENSITIVE = []
18077
19057
  include Aws::Structure
18078
19058
  end
18079
19059
 
18080
19060
  # The specified target managed node for the session isn't fully
18081
19061
  # configured for use with Session Manager. For more information, see
18082
- # [Getting started with Session Manager][1] in the *Amazon Web Services
18083
- # Systems Manager User Guide*. This error is also returned if you
18084
- # attempt to start a session on a managed node that is located in a
18085
- # different account or Region
19062
+ # [Setting up Session Manager][1] in the *Amazon Web Services Systems
19063
+ # Manager User Guide*. This error is also returned if you attempt to
19064
+ # start a session on a managed node that is located in a different
19065
+ # account or Region
18086
19066
  #
18087
19067
  #
18088
19068
  #
@@ -18099,6 +19079,27 @@ module Aws::SSM
18099
19079
  include Aws::Structure
18100
19080
  end
18101
19081
 
19082
+ # Information about the resources that would be included in the actual
19083
+ # runbook execution, if it were to be run.
19084
+ #
19085
+ # @!attribute [rw] count
19086
+ # The number of resources of a certain type included in an execution
19087
+ # preview.
19088
+ # @return [Integer]
19089
+ #
19090
+ # @!attribute [rw] target_type
19091
+ # A type of resource that was included in the execution preview.
19092
+ # @return [String]
19093
+ #
19094
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/TargetPreview AWS API Documentation
19095
+ #
19096
+ class TargetPreview < Struct.new(
19097
+ :count,
19098
+ :target_type)
19099
+ SENSITIVE = []
19100
+ include Aws::Structure
19101
+ end
19102
+
18102
19103
  # @!attribute [rw] session_id
18103
19104
  # The ID of the session to terminate.
18104
19105
  # @return [String]
@@ -18123,6 +19124,31 @@ module Aws::SSM
18123
19124
  include Aws::Structure
18124
19125
  end
18125
19126
 
19127
+ # The request or operation couldn't be performed because the service is
19128
+ # throttling requests.
19129
+ #
19130
+ # @!attribute [rw] message
19131
+ # @return [String]
19132
+ #
19133
+ # @!attribute [rw] quota_code
19134
+ # The quota code recognized by the Amazon Web Services Service Quotas
19135
+ # service.
19136
+ # @return [String]
19137
+ #
19138
+ # @!attribute [rw] service_code
19139
+ # The code for the Amazon Web Services service that owns the quota.
19140
+ # @return [String]
19141
+ #
19142
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ThrottlingException AWS API Documentation
19143
+ #
19144
+ class ThrottlingException < Struct.new(
19145
+ :message,
19146
+ :quota_code,
19147
+ :service_code)
19148
+ SENSITIVE = []
19149
+ include Aws::Structure
19150
+ end
19151
+
18126
19152
  # The `Targets` parameter includes too many tags. Remove one or more
18127
19153
  # tags and try the command again.
18128
19154
  #
@@ -18288,6 +19314,21 @@ module Aws::SSM
18288
19314
  include Aws::Structure
18289
19315
  end
18290
19316
 
19317
+ # This operation is not supported for the current account. You must
19318
+ # first enable the Systems Manager integrated experience in your
19319
+ # account.
19320
+ #
19321
+ # @!attribute [rw] message
19322
+ # @return [String]
19323
+ #
19324
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UnsupportedOperationException AWS API Documentation
19325
+ #
19326
+ class UnsupportedOperationException < Struct.new(
19327
+ :message)
19328
+ SENSITIVE = []
19329
+ include Aws::Structure
19330
+ end
19331
+
18291
19332
  # The parameter type isn't supported.
18292
19333
  #
18293
19334
  # @!attribute [rw] message
@@ -18322,9 +19363,9 @@ module Aws::SSM
18322
19363
  #
18323
19364
  # @!attribute [rw] parameters
18324
19365
  # The parameters you want to update for the association. If you create
18325
- # a parameter using Parameter Store, a capability of Amazon Web
18326
- # Services Systems Manager, you can reference the parameter using
18327
- # `\{\{ssm:parameter-name\}\}`.
19366
+ # a parameter using Parameter Store, a tool in Amazon Web Services
19367
+ # Systems Manager, you can reference the parameter using
19368
+ # `{{ssm:parameter-name}}`.
18328
19369
  # @return [Hash<String,Array<String>>]
18329
19370
  #
18330
19371
  # @!attribute [rw] document_version
@@ -18390,7 +19431,7 @@ module Aws::SSM
18390
19431
  # Choose the parameter that will define how your automation will
18391
19432
  # branch out. This target is required for associations that use an
18392
19433
  # Automation runbook and target resources by using rate controls.
18393
- # Automation is a capability of Amazon Web Services Systems Manager.
19434
+ # Automation is a tool in Amazon Web Services Systems Manager.
18394
19435
  # @return [String]
18395
19436
  #
18396
19437
  # @!attribute [rw] max_errors
@@ -18438,9 +19479,9 @@ module Aws::SSM
18438
19479
  #
18439
19480
  # In `MANUAL` mode, you must specify the `AssociationId` as a
18440
19481
  # parameter for the PutComplianceItems API operation. In this case,
18441
- # compliance data isn't managed by State Manager, a capability of
18442
- # Amazon Web Services Systems Manager. It is managed by your direct
18443
- # call to the PutComplianceItems API operation.
19482
+ # compliance data isn't managed by State Manager, a tool in Amazon
19483
+ # Web Services Systems Manager. It is managed by your direct call to
19484
+ # the PutComplianceItems API operation.
18444
19485
  #
18445
19486
  # By default, all associations use `AUTO` mode.
18446
19487
  # @return [String]
@@ -18448,27 +19489,39 @@ module Aws::SSM
18448
19489
  # @!attribute [rw] apply_only_at_cron_interval
18449
19490
  # By default, when you update an association, the system runs it
18450
19491
  # immediately after it is updated and then according to the schedule
18451
- # you specified. Specify this option if you don't want an association
18452
- # to run immediately after you update it. This parameter isn't
18453
- # supported for rate expressions.
19492
+ # you specified. Specify `true` for `ApplyOnlyAtCronInterval` if you
19493
+ # want the association to run only according to the schedule you
19494
+ # specified.
18454
19495
  #
18455
19496
  # If you chose this option when you created an association and later
18456
- # you edit that association or you make changes to the SSM document on
18457
- # which that association is based (by using the Documents page in the
18458
- # console), State Manager applies the association at the next
18459
- # specified cron interval. For example, if you chose the `Latest`
18460
- # version of an SSM document when you created an association and you
18461
- # edit the association by choosing a different document version on the
18462
- # Documents page, State Manager applies the association at the next
18463
- # specified cron interval if you previously selected this option. If
18464
- # this option wasn't selected, State Manager immediately runs the
19497
+ # you edit that association or you make changes to the Automation
19498
+ # runbook or SSM document on which that association is based, State
19499
+ # Manager applies the association at the next specified cron interval.
19500
+ # For example, if you chose the `Latest` version of an SSM document
19501
+ # when you created an association and you edit the association by
19502
+ # choosing a different document version on the Documents page, State
19503
+ # Manager applies the association at the next specified cron interval
19504
+ # if you previously set `ApplyOnlyAtCronInterval` to `true`. If this
19505
+ # option wasn't selected, State Manager immediately runs the
18465
19506
  # association.
18466
19507
  #
18467
- # You can reset this option. To do so, specify the
19508
+ # For more information, see [Understanding when associations are
19509
+ # applied to resources][1] and [About target updates with Automation
19510
+ # runbooks][2] in the *Amazon Web Services Systems Manager User
19511
+ # Guide*.
19512
+ #
19513
+ # This parameter isn't supported for rate expressions.
19514
+ #
19515
+ # You can reset this parameter. To do so, specify the
18468
19516
  # `no-apply-only-at-cron-interval` parameter when you update the
18469
19517
  # association from the command line. This parameter forces the
18470
19518
  # association to run immediately after updating it and according to
18471
19519
  # the interval specified.
19520
+ #
19521
+ #
19522
+ #
19523
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
19524
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
18472
19525
  # @return [Boolean]
18473
19526
  #
18474
19527
  # @!attribute [rw] calendar_names
@@ -18476,7 +19529,8 @@ module Aws::SSM
18476
19529
  # type documents you want to gate your associations under. The
18477
19530
  # associations only run when that change calendar is open. For more
18478
19531
  # information, see [Amazon Web Services Systems Manager Change
18479
- # Calendar][1].
19532
+ # Calendar][1] in the *Amazon Web Services Systems Manager User
19533
+ # Guide*.
18480
19534
  #
18481
19535
  #
18482
19536
  #
@@ -19068,7 +20122,7 @@ module Aws::SSM
19068
20122
  # creating a custom policy and custom service role for running your
19069
20123
  # maintenance window tasks. The policy can be crafted to provide only
19070
20124
  # the permissions needed for your particular maintenance window tasks.
19071
- # For more information, see [Setting up maintenance windows][1] in the
20125
+ # For more information, see [Setting up Maintenance Windows][1] in the
19072
20126
  # in the *Amazon Web Services Systems Manager User Guide*.
19073
20127
  #
19074
20128
  #
@@ -19207,7 +20261,6 @@ module Aws::SSM
19207
20261
  # the command associated with the task. However, there is no
19208
20262
  # guarantee that the command will be terminated and the underlying
19209
20263
  # process stopped.
19210
- #
19211
20264
  # The status for tasks that are not completed is `TIMED_OUT`.
19212
20265
  # @return [String]
19213
20266
  #
@@ -19256,10 +20309,24 @@ module Aws::SSM
19256
20309
  # @return [String]
19257
20310
  #
19258
20311
  # @!attribute [rw] service_role_arn
19259
- # The Amazon Resource Name (ARN) of the Identity and Access Management
19260
- # (IAM) service role to use to publish Amazon Simple Notification
19261
- # Service (Amazon SNS) notifications for maintenance window Run
19262
- # Command tasks.
20312
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
20313
+ # Web Services Systems Manager to assume when running a maintenance
20314
+ # window task. If you do not specify a service role ARN, Systems
20315
+ # Manager uses a service-linked role in your account. If no
20316
+ # appropriate service-linked role for Systems Manager exists in your
20317
+ # account, it is created when you run
20318
+ # `RegisterTaskWithMaintenanceWindow`.
20319
+ #
20320
+ # However, for an improved security posture, we strongly recommend
20321
+ # creating a custom policy and custom service role for running your
20322
+ # maintenance window tasks. The policy can be crafted to provide only
20323
+ # the permissions needed for your particular maintenance window tasks.
20324
+ # For more information, see [Setting up Maintenance Windows][1] in the
20325
+ # in the *Amazon Web Services Systems Manager User Guide*.
20326
+ #
20327
+ #
20328
+ #
20329
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
19263
20330
  # @return [String]
19264
20331
  #
19265
20332
  # @!attribute [rw] task_parameters
@@ -19353,9 +20420,9 @@ module Aws::SSM
19353
20420
  # want to assign to the managed node. This IAM role must provide
19354
20421
  # AssumeRole permissions for the Amazon Web Services Systems Manager
19355
20422
  # service principal `ssm.amazonaws.com`. For more information, see
19356
- # [Create an IAM service role for a hybrid and multicloud
19357
- # environment][1] in the *Amazon Web Services Systems Manager User
19358
- # Guide*.
20423
+ # [Create the IAM service role required for Systems Manager in hybrid
20424
+ # and multicloud environments][1] in the *Amazon Web Services Systems
20425
+ # Manager User Guide*.
19359
20426
  #
19360
20427
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter.
19361
20428
  # You must create a unique role.
@@ -19364,7 +20431,7 @@ module Aws::SSM
19364
20431
  #
19365
20432
  #
19366
20433
  #
19367
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
20434
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
19368
20435
  # @return [String]
19369
20436
  #
19370
20437
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateManagedInstanceRoleRequest AWS API Documentation
@@ -19441,9 +20508,8 @@ module Aws::SSM
19441
20508
  # @return [Array<Types::RelatedOpsItem>]
19442
20509
  #
19443
20510
  # @!attribute [rw] status
19444
- # The OpsItem status. Status can be `Open`, `In Progress`, or
19445
- # `Resolved`. For more information, see [Editing OpsItem details][1]
19446
- # in the *Amazon Web Services Systems Manager User Guide*.
20511
+ # The OpsItem status. For more information, see [Editing OpsItem
20512
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
19447
20513
  #
19448
20514
  #
19449
20515
  #
@@ -19565,6 +20631,11 @@ module Aws::SSM
19565
20631
  #
19566
20632
  # @!attribute [rw] global_filters
19567
20633
  # A set of global filters used to include patches in the baseline.
20634
+ #
20635
+ # The `GlobalFilters` parameter can be configured only by using the
20636
+ # CLI or an Amazon Web Services SDK. It can't be configured from the
20637
+ # Patch Manager console, and its value isn't displayed in the
20638
+ # console.
19568
20639
  # @return [Types::PatchFilterGroup]
19569
20640
  #
19570
20641
  # @!attribute [rw] approval_rules
@@ -19575,9 +20646,9 @@ module Aws::SSM
19575
20646
  # A list of explicitly approved patches for the baseline.
19576
20647
  #
19577
20648
  # For information about accepted formats for lists of approved patches
19578
- # and rejected patches, see [About package name formats for approved
19579
- # and rejected patch lists][1] in the *Amazon Web Services Systems
19580
- # Manager User Guide*.
20649
+ # and rejected patches, see [Package name formats for approved and
20650
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
20651
+ # User Guide*.
19581
20652
  #
19582
20653
  #
19583
20654
  #
@@ -19599,9 +20670,9 @@ module Aws::SSM
19599
20670
  # A list of explicitly rejected patches for the baseline.
19600
20671
  #
19601
20672
  # For information about accepted formats for lists of approved patches
19602
- # and rejected patches, see [About package name formats for approved
19603
- # and rejected patch lists][1] in the *Amazon Web Services Systems
19604
- # Manager User Guide*.
20673
+ # and rejected patches, see [Package name formats for approved and
20674
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
20675
+ # User Guide*.
19605
20676
  #
19606
20677
  #
19607
20678
  #
@@ -19612,19 +20683,28 @@ module Aws::SSM
19612
20683
  # The action for Patch Manager to take on patches included in the
19613
20684
  # `RejectedPackages` list.
19614
20685
  #
19615
- # * <b> <code>ALLOW_AS_DEPENDENCY</code> </b>: A package in the
19616
- # `Rejected` patches list is installed only if it is a dependency of
19617
- # another package. It is considered compliant with the patch
19618
- # baseline, and its status is reported as `InstalledOther`. This is
19619
- # the default action if no option is specified.
20686
+ # ALLOW\_AS\_DEPENDENCY
20687
+ #
20688
+ # : **Linux and macOS**: A package in the rejected patches list is
20689
+ # installed only if it is a dependency of another package. It is
20690
+ # considered compliant with the patch baseline, and its status is
20691
+ # reported as `INSTALLED_OTHER`. This is the default action if no
20692
+ # option is specified.
20693
+ #
20694
+ # **Windows Server**: Windows Server doesn't support the concept of
20695
+ # package dependencies. If a package in the rejected patches list
20696
+ # and already installed on the node, its status is reported as
20697
+ # `INSTALLED_OTHER`. Any package not already installed on the node
20698
+ # is skipped. This is the default action if no option is specified.
19620
20699
  #
19621
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
20700
+ # BLOCK
20701
+ #
20702
+ # : **All OSs**: Packages in the rejected patches list, and packages
19622
20703
  # that include them as dependencies, aren't installed by Patch
19623
20704
  # Manager under any circumstances. If a package was installed before
19624
- # it was added to the **Rejected patches** list, or is installed
19625
- # outside of Patch Manager afterward, it's considered noncompliant
19626
- # with the patch baseline and its status is reported as
19627
- # *InstalledRejected*.
20705
+ # it was added to the rejected patches list, or is installed outside
20706
+ # of Patch Manager afterward, it's considered noncompliant with the
20707
+ # patch baseline and its status is reported as `INSTALLED_REJECTED`.
19628
20708
  # @return [String]
19629
20709
  #
19630
20710
  # @!attribute [rw] description
@@ -19637,6 +20717,22 @@ module Aws::SSM
19637
20717
  # to Linux managed nodes only.
19638
20718
  # @return [Array<Types::PatchSource>]
19639
20719
  #
20720
+ # @!attribute [rw] available_security_updates_compliance_status
20721
+ # Indicates the status to be assigned to security patches that are
20722
+ # available but not approved because they don't meet the installation
20723
+ # criteria specified in the patch baseline.
20724
+ #
20725
+ # Example scenario: Security patches that you might want installed can
20726
+ # be skipped if you have specified a long period to wait after a patch
20727
+ # is released before installation. If an update to the patch is
20728
+ # released during your specified waiting period, the waiting period
20729
+ # for installing the patch starts over. If the waiting period is too
20730
+ # long, multiple versions of the patch could be released but never
20731
+ # installed.
20732
+ #
20733
+ # Supported for Windows Server managed nodes only.
20734
+ # @return [String]
20735
+ #
19640
20736
  # @!attribute [rw] replace
19641
20737
  # If True, then all fields that are required by the
19642
20738
  # CreatePatchBaseline operation are also required for this API
@@ -19657,6 +20753,7 @@ module Aws::SSM
19657
20753
  :rejected_patches_action,
19658
20754
  :description,
19659
20755
  :sources,
20756
+ :available_security_updates_compliance_status,
19660
20757
  :replace)
19661
20758
  SENSITIVE = []
19662
20759
  include Aws::Structure
@@ -19726,6 +20823,15 @@ module Aws::SSM
19726
20823
  # to Linux managed nodes only.
19727
20824
  # @return [Array<Types::PatchSource>]
19728
20825
  #
20826
+ # @!attribute [rw] available_security_updates_compliance_status
20827
+ # Indicates the compliance status of managed nodes for which
20828
+ # security-related patches are available but were not approved. This
20829
+ # preference is specified when the `CreatePatchBaseline` or
20830
+ # `UpdatePatchBaseline` commands are run.
20831
+ #
20832
+ # Applies to Windows Server managed nodes only.
20833
+ # @return [String]
20834
+ #
19729
20835
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdatePatchBaselineResult AWS API Documentation
19730
20836
  #
19731
20837
  class UpdatePatchBaselineResult < Struct.new(
@@ -19742,7 +20848,8 @@ module Aws::SSM
19742
20848
  :created_date,
19743
20849
  :modified_date,
19744
20850
  :description,
19745
- :sources)
20851
+ :sources,
20852
+ :available_security_updates_compliance_status)
19746
20853
  SENSITIVE = []
19747
20854
  include Aws::Structure
19748
20855
  end
@@ -19782,16 +20889,20 @@ module Aws::SSM
19782
20889
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
19783
20890
  # The setting ID can be one of the following.
19784
20891
  #
19785
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
20892
+ # * `/ssm/appmanager/appmanager-enabled`
19786
20893
  #
19787
20894
  # * `/ssm/automation/customer-script-log-destination`
19788
20895
  #
19789
20896
  # * `/ssm/automation/customer-script-log-group-name`
19790
20897
  #
20898
+ # * /ssm/automation/enable-adaptive-concurrency
20899
+ #
19791
20900
  # * `/ssm/documents/console/public-sharing-permission`
19792
20901
  #
19793
20902
  # * `/ssm/managed-instance/activation-tier`
19794
20903
  #
20904
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
20905
+ #
19795
20906
  # * `/ssm/opsinsights/opscenter`
19796
20907
  #
19797
20908
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -19811,8 +20922,7 @@ module Aws::SSM
19811
20922
  # The new value to specify for the service setting. The following list
19812
20923
  # specifies the available values for each setting.
19813
20924
  #
19814
- # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
19815
- # enter the name of an IAM role.
20925
+ # * For `/ssm/appmanager/appmanager-enabled`, enter `True` or `False`.
19816
20926
  #
19817
20927
  # * For `/ssm/automation/customer-script-log-destination`, enter
19818
20928
  # `CloudWatch`.
@@ -19826,6 +20936,9 @@ module Aws::SSM
19826
20936
  # * For `/ssm/managed-instance/activation-tier`, enter `standard` or
19827
20937
  # `advanced`.
19828
20938
  #
20939
+ # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
20940
+ # enter the name of an IAM role.
20941
+ #
19829
20942
  # * For `/ssm/opsinsights/opscenter`, enter `Enabled` or `Disabled`.
19830
20943
  #
19831
20944
  # * For `/ssm/parameter-store/default-parameter-tier`, enter
@@ -19850,5 +20963,25 @@ module Aws::SSM
19850
20963
  #
19851
20964
  class UpdateServiceSettingResult < Aws::EmptyStructure; end
19852
20965
 
20966
+ # The request isn't valid. Verify that you entered valid contents for
20967
+ # the command and try again.
20968
+ #
20969
+ # @!attribute [rw] message
20970
+ # @return [String]
20971
+ #
20972
+ # @!attribute [rw] reason_code
20973
+ # The reason code for the invalid request.
20974
+ # @return [String]
20975
+ #
20976
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ValidationException AWS API Documentation
20977
+ #
20978
+ class ValidationException < Struct.new(
20979
+ :message,
20980
+ :reason_code)
20981
+ SENSITIVE = []
20982
+ include Aws::Structure
20983
+ end
20984
+
19853
20985
  end
19854
20986
  end
20987
+