aws-sdk-ssm 1.173.0 → 1.197.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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
@@ -4991,7 +5216,7 @@ module Aws::SSM
4991
5216
 
4992
5217
  # @!attribute [rw] account_ids
4993
5218
  # The account IDs that have permission to use this document. The ID
4994
- # can be either an Amazon Web Services account or *All*.
5219
+ # can be either an Amazon Web Services account number or `all`.
4995
5220
  # @return [Array<String>]
4996
5221
  #
4997
5222
  # @!attribute [rw] account_sharing_info_list
@@ -5016,6 +5241,12 @@ module Aws::SSM
5016
5241
 
5017
5242
  # @!attribute [rw] name
5018
5243
  # The name of the SSM document.
5244
+ #
5245
+ # <note markdown="1"> If you're calling a shared SSM document from a different Amazon Web
5246
+ # Services account, `Name` is the full Amazon Resource Name (ARN) of
5247
+ # the document.
5248
+ #
5249
+ # </note>
5019
5250
  # @return [String]
5020
5251
  #
5021
5252
  # @!attribute [rw] document_version
@@ -5363,9 +5594,9 @@ module Aws::SSM
5363
5594
  # Sample values: `Installed` \| `InstalledOther` \|
5364
5595
  # `InstalledPendingReboot`
5365
5596
  #
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*.
5597
+ # For lists of all `State` values, see [Patch compliance state
5598
+ # values][1] in the *Amazon Web Services Systems Manager User
5599
+ # Guide*.
5369
5600
  #
5370
5601
  #
5371
5602
  #
@@ -5638,7 +5869,7 @@ module Aws::SSM
5638
5869
  #
5639
5870
  # * Values. An array of strings, each between 1 and 256 characters.
5640
5871
  # Supported values are date/time strings in a valid ISO 8601
5641
- # date/time format, such as `2021-11-04T05:00:00Z`.
5872
+ # date/time format, such as `2024-11-04T05:00:00Z`.
5642
5873
  # @return [Array<Types::MaintenanceWindowFilter>]
5643
5874
  #
5644
5875
  # @!attribute [rw] max_results
@@ -6003,7 +6234,7 @@ module Aws::SSM
6003
6234
  #
6004
6235
  # **If you filter the response by using the OperationalData
6005
6236
  # operator, specify a key-value pair by using the following JSON
6006
- # format: \\\{"key":"key\_name","value":"a\_value"\\}
6237
+ # format: \{"key":"key\_name","value":"a\_value"}
6007
6238
  # @return [Array<Types::OpsItemFilter>]
6008
6239
  #
6009
6240
  # @!attribute [rw] max_results
@@ -6234,7 +6465,7 @@ module Aws::SSM
6234
6465
  # @!attribute [rw] instances_with_unreported_not_applicable_patches
6235
6466
  # The number of managed nodes with `NotApplicable` patches beyond the
6236
6467
  # supported limit, which aren't reported by name to Inventory.
6237
- # Inventory is a capability of Amazon Web Services Systems Manager.
6468
+ # Inventory is a tool in Amazon Web Services Systems Manager.
6238
6469
  # @return [Integer]
6239
6470
  #
6240
6471
  # @!attribute [rw] instances_with_critical_non_compliant_patches
@@ -6260,6 +6491,16 @@ module Aws::SSM
6260
6491
  # is `NON_COMPLIANT`.
6261
6492
  # @return [Integer]
6262
6493
  #
6494
+ # @!attribute [rw] instances_with_available_security_updates
6495
+ # The number of managed nodes for which security-related patches are
6496
+ # available but not approved because because they didn't meet the
6497
+ # patch baseline requirements. For example, an updated version of a
6498
+ # patch might have been released before the specified auto-approval
6499
+ # period was over.
6500
+ #
6501
+ # Applies to Windows Server managed nodes only.
6502
+ # @return [Integer]
6503
+ #
6263
6504
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupStateResult AWS API Documentation
6264
6505
  #
6265
6506
  class DescribePatchGroupStateResult < Struct.new(
@@ -6274,7 +6515,8 @@ module Aws::SSM
6274
6515
  :instances_with_unreported_not_applicable_patches,
6275
6516
  :instances_with_critical_non_compliant_patches,
6276
6517
  :instances_with_security_non_compliant_patches,
6277
- :instances_with_other_non_compliant_patches)
6518
+ :instances_with_other_non_compliant_patches,
6519
+ :instances_with_available_security_updates)
6278
6520
  SENSITIVE = []
6279
6521
  include Aws::Structure
6280
6522
  end
@@ -6317,7 +6559,7 @@ module Aws::SSM
6317
6559
  # Each entry in the array contains:
6318
6560
  #
6319
6561
  # * `PatchGroup`: string (between 1 and 256 characters. Regex:
6320
- # `^([\p\{L\}\p\{Z\}\p\{N\}_.:/=+\-@]*)$)`
6562
+ # `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$)`
6321
6563
  #
6322
6564
  # * `PatchBaselineIdentity`: A `PatchBaselineIdentity` element.
6323
6565
  # @return [Array<Types::PatchGroupPatchBaselineMapping>]
@@ -7268,6 +7510,51 @@ module Aws::SSM
7268
7510
  include Aws::Structure
7269
7511
  end
7270
7512
 
7513
+ # Information about the inputs for an execution preview.
7514
+ #
7515
+ # @note ExecutionInputs is a union - when making an API calls you must set exactly one of the members.
7516
+ #
7517
+ # @!attribute [rw] automation
7518
+ # Information about the optional inputs that can be specified for an
7519
+ # automation execution preview.
7520
+ # @return [Types::AutomationExecutionInputs]
7521
+ #
7522
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ExecutionInputs AWS API Documentation
7523
+ #
7524
+ class ExecutionInputs < Struct.new(
7525
+ :automation,
7526
+ :unknown)
7527
+ SENSITIVE = []
7528
+ include Aws::Structure
7529
+ include Aws::Structure::Union
7530
+
7531
+ class Automation < ExecutionInputs; end
7532
+ class Unknown < ExecutionInputs; end
7533
+ end
7534
+
7535
+ # Information about the changes that would be made if an execution were
7536
+ # run.
7537
+ #
7538
+ # @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.
7539
+ #
7540
+ # @!attribute [rw] automation
7541
+ # Information about the changes that would be made if an Automation
7542
+ # workflow were run.
7543
+ # @return [Types::AutomationExecutionPreview]
7544
+ #
7545
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ExecutionPreview AWS API Documentation
7546
+ #
7547
+ class ExecutionPreview < Struct.new(
7548
+ :automation,
7549
+ :unknown)
7550
+ SENSITIVE = []
7551
+ include Aws::Structure
7552
+ include Aws::Structure::Union
7553
+
7554
+ class Automation < ExecutionPreview; end
7555
+ class Unknown < ExecutionPreview; end
7556
+ end
7557
+
7271
7558
  # Describes a failed association.
7272
7559
  #
7273
7560
  # @!attribute [rw] entry
@@ -7333,6 +7620,36 @@ module Aws::SSM
7333
7620
  include Aws::Structure
7334
7621
  end
7335
7622
 
7623
+ # @!attribute [rw] access_request_id
7624
+ # The ID of a just-in-time node access request.
7625
+ # @return [String]
7626
+ #
7627
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAccessTokenRequest AWS API Documentation
7628
+ #
7629
+ class GetAccessTokenRequest < Struct.new(
7630
+ :access_request_id)
7631
+ SENSITIVE = []
7632
+ include Aws::Structure
7633
+ end
7634
+
7635
+ # @!attribute [rw] credentials
7636
+ # The temporary security credentials which can be used to start
7637
+ # just-in-time node access sessions.
7638
+ # @return [Types::Credentials]
7639
+ #
7640
+ # @!attribute [rw] access_request_status
7641
+ # The status of the access request.
7642
+ # @return [String]
7643
+ #
7644
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetAccessTokenResponse AWS API Documentation
7645
+ #
7646
+ class GetAccessTokenResponse < Struct.new(
7647
+ :credentials,
7648
+ :access_request_status)
7649
+ SENSITIVE = []
7650
+ include Aws::Structure
7651
+ end
7652
+
7336
7653
  # @!attribute [rw] automation_execution_id
7337
7654
  # The unique identifier for an existing automation execution to
7338
7655
  # examine. The execution ID is returned by StartAutomationExecution
@@ -7361,7 +7678,7 @@ module Aws::SSM
7361
7678
  end
7362
7679
 
7363
7680
  # @!attribute [rw] calendar_names
7364
- # The names or Amazon Resource Names (ARNs) of the Systems Manager
7681
+ # The names of Amazon Resource Names (ARNs) of the Systems Manager
7365
7682
  # documents (SSM documents) that represent the calendar entries for
7366
7683
  # which you want to get the state.
7367
7684
  # @return [Array<String>]
@@ -7876,6 +8193,53 @@ module Aws::SSM
7876
8193
  include Aws::Structure
7877
8194
  end
7878
8195
 
8196
+ # @!attribute [rw] execution_preview_id
8197
+ # The ID of the existing execution preview.
8198
+ # @return [String]
8199
+ #
8200
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreviewRequest AWS API Documentation
8201
+ #
8202
+ class GetExecutionPreviewRequest < Struct.new(
8203
+ :execution_preview_id)
8204
+ SENSITIVE = []
8205
+ include Aws::Structure
8206
+ end
8207
+
8208
+ # @!attribute [rw] execution_preview_id
8209
+ # The generated ID for the existing execution preview.
8210
+ # @return [String]
8211
+ #
8212
+ # @!attribute [rw] ended_at
8213
+ # A UTC timestamp indicating when the execution preview operation
8214
+ # ended.
8215
+ # @return [Time]
8216
+ #
8217
+ # @!attribute [rw] status
8218
+ # The current status of the execution preview operation.
8219
+ # @return [String]
8220
+ #
8221
+ # @!attribute [rw] status_message
8222
+ # Supplemental information about the current status of the execution
8223
+ # preview.
8224
+ # @return [String]
8225
+ #
8226
+ # @!attribute [rw] execution_preview
8227
+ # Information about the changes that would be made if an execution
8228
+ # were run.
8229
+ # @return [Types::ExecutionPreview]
8230
+ #
8231
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetExecutionPreviewResponse AWS API Documentation
8232
+ #
8233
+ class GetExecutionPreviewResponse < Struct.new(
8234
+ :execution_preview_id,
8235
+ :ended_at,
8236
+ :status,
8237
+ :status_message,
8238
+ :execution_preview)
8239
+ SENSITIVE = []
8240
+ include Aws::Structure
8241
+ end
8242
+
7879
8243
  # @!attribute [rw] filters
7880
8244
  # One or more filters. Use a filter to return a more specific list of
7881
8245
  # results.
@@ -8407,10 +8771,24 @@ module Aws::SSM
8407
8771
  # @return [String]
8408
8772
  #
8409
8773
  # @!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.
8774
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
8775
+ # Web Services Systems Manager to assume when running a maintenance
8776
+ # window task. If you do not specify a service role ARN, Systems
8777
+ # Manager uses a service-linked role in your account. If no
8778
+ # appropriate service-linked role for Systems Manager exists in your
8779
+ # account, it is created when you run
8780
+ # `RegisterTaskWithMaintenanceWindow`.
8781
+ #
8782
+ # However, for an improved security posture, we strongly recommend
8783
+ # creating a custom policy and custom service role for running your
8784
+ # maintenance window tasks. The policy can be crafted to provide only
8785
+ # the permissions needed for your particular maintenance window tasks.
8786
+ # For more information, see [Setting up Maintenance Windows][1] in the
8787
+ # in the *Amazon Web Services Systems Manager User Guide*.
8788
+ #
8789
+ #
8790
+ #
8791
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
8414
8792
  # @return [String]
8415
8793
  #
8416
8794
  # @!attribute [rw] task_type
@@ -8726,7 +9104,7 @@ module Aws::SSM
8726
9104
  #
8727
9105
  #
8728
9106
  #
8729
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sharing.html
9107
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
8730
9108
  # @return [String]
8731
9109
  #
8732
9110
  # @!attribute [rw] with_decryption
@@ -9021,6 +9399,15 @@ module Aws::SSM
9021
9399
  # to Linux managed nodes only.
9022
9400
  # @return [Array<Types::PatchSource>]
9023
9401
  #
9402
+ # @!attribute [rw] available_security_updates_compliance_status
9403
+ # Indicates the compliance status of managed nodes for which
9404
+ # security-related patches are available but were not approved. This
9405
+ # preference is specified when the `CreatePatchBaseline` or
9406
+ # `UpdatePatchBaseline` commands are run.
9407
+ #
9408
+ # Applies to Windows Server managed nodes only.
9409
+ # @return [String]
9410
+ #
9024
9411
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaselineResult AWS API Documentation
9025
9412
  #
9026
9413
  class GetPatchBaselineResult < Struct.new(
@@ -9038,7 +9425,8 @@ module Aws::SSM
9038
9425
  :created_date,
9039
9426
  :modified_date,
9040
9427
  :description,
9041
- :sources)
9428
+ :sources,
9429
+ :available_security_updates_compliance_status)
9042
9430
  SENSITIVE = []
9043
9431
  include Aws::Structure
9044
9432
  end
@@ -9129,16 +9517,20 @@ module Aws::SSM
9129
9517
  # The ID of the service setting to get. The setting ID can be one of
9130
9518
  # the following.
9131
9519
  #
9132
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
9520
+ # * `/ssm/appmanager/appmanager-enabled`
9133
9521
  #
9134
9522
  # * `/ssm/automation/customer-script-log-destination`
9135
9523
  #
9136
9524
  # * `/ssm/automation/customer-script-log-group-name`
9137
9525
  #
9526
+ # * /ssm/automation/enable-adaptive-concurrency
9527
+ #
9138
9528
  # * `/ssm/documents/console/public-sharing-permission`
9139
9529
  #
9140
9530
  # * `/ssm/managed-instance/activation-tier`
9141
9531
  #
9532
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
9533
+ #
9142
9534
  # * `/ssm/opsinsights/opscenter`
9143
9535
  #
9144
9536
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -9400,31 +9792,92 @@ module Aws::SSM
9400
9792
  include Aws::Structure
9401
9793
  end
9402
9794
 
9403
- # Describes a filter for a specific list of managed nodes.
9795
+ # Details about a specific managed node.
9404
9796
  #
9405
- # @!attribute [rw] instance_id
9406
- # The managed node ID.
9797
+ # @!attribute [rw] agent_type
9798
+ # The type of agent installed on the node.
9407
9799
  # @return [String]
9408
9800
  #
9409
- # @!attribute [rw] ping_status
9410
- # Connection status of SSM Agent.
9801
+ # @!attribute [rw] agent_version
9802
+ # The version number of the agent installed on the node.
9803
+ # @return [String]
9411
9804
  #
9412
- # <note markdown="1"> The status `Inactive` has been deprecated and is no longer in use.
9805
+ # @!attribute [rw] computer_name
9806
+ # The fully qualified host name of the managed node.
9807
+ # @return [String]
9413
9808
  #
9414
- # </note>
9809
+ # @!attribute [rw] instance_status
9810
+ # The current status of the managed node.
9415
9811
  # @return [String]
9416
9812
  #
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]
9813
+ # @!attribute [rw] ip_address
9814
+ # The IP address of the managed node.
9815
+ # @return [String]
9421
9816
  #
9422
- # @!attribute [rw] agent_version
9423
- # The version of SSM Agent running on your Linux managed node.
9817
+ # @!attribute [rw] managed_status
9818
+ # Indicates whether the node is managed by Systems Manager.
9424
9819
  # @return [String]
9425
9820
  #
9426
- # @!attribute [rw] is_latest_version
9427
- # Indicates whether the latest version of SSM Agent is running on your
9821
+ # @!attribute [rw] platform_type
9822
+ # The operating system platform type of the managed node.
9823
+ # @return [String]
9824
+ #
9825
+ # @!attribute [rw] platform_name
9826
+ # The name of the operating system platform running on your managed
9827
+ # node.
9828
+ # @return [String]
9829
+ #
9830
+ # @!attribute [rw] platform_version
9831
+ # The version of the OS platform running on your managed node.
9832
+ # @return [String]
9833
+ #
9834
+ # @!attribute [rw] resource_type
9835
+ # The type of instance, either an EC2 instance or another supported
9836
+ # machine type in a hybrid fleet.
9837
+ # @return [String]
9838
+ #
9839
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceInfo AWS API Documentation
9840
+ #
9841
+ class InstanceInfo < Struct.new(
9842
+ :agent_type,
9843
+ :agent_version,
9844
+ :computer_name,
9845
+ :instance_status,
9846
+ :ip_address,
9847
+ :managed_status,
9848
+ :platform_type,
9849
+ :platform_name,
9850
+ :platform_version,
9851
+ :resource_type)
9852
+ SENSITIVE = [:ip_address]
9853
+ include Aws::Structure
9854
+ end
9855
+
9856
+ # Describes a filter for a specific list of managed nodes.
9857
+ #
9858
+ # @!attribute [rw] instance_id
9859
+ # The managed node ID.
9860
+ # @return [String]
9861
+ #
9862
+ # @!attribute [rw] ping_status
9863
+ # Connection status of SSM Agent.
9864
+ #
9865
+ # <note markdown="1"> The status `Inactive` has been deprecated and is no longer in use.
9866
+ #
9867
+ # </note>
9868
+ # @return [String]
9869
+ #
9870
+ # @!attribute [rw] last_ping_date_time
9871
+ # The date and time when the agent last pinged the Systems Manager
9872
+ # service.
9873
+ # @return [Time]
9874
+ #
9875
+ # @!attribute [rw] agent_version
9876
+ # The version of SSM Agent running on your Linux managed node.
9877
+ # @return [String]
9878
+ #
9879
+ # @!attribute [rw] is_latest_version
9880
+ # Indicates whether the latest version of SSM Agent is running on your
9428
9881
  # Linux managed node. This field doesn't indicate whether or not the
9429
9882
  # latest version is installed on Windows managed nodes, because some
9430
9883
  # older versions of Windows Server use the EC2Config service to
@@ -9450,11 +9903,14 @@ module Aws::SSM
9450
9903
  # @return [String]
9451
9904
  #
9452
9905
  # @!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
9906
+ # The role assigned to an Amazon EC2 instance configured with a
9907
+ # Systems Manager Quick Setup host management configuration or the
9908
+ # role assigned to an on-premises managed node.
9909
+ #
9910
+ # This call doesn't return the IAM role for *unmanaged* Amazon EC2
9911
+ # instances (instances not configured for Systems Manager). To
9912
+ # retrieve the role for an unmanaged instance, use the Amazon EC2
9913
+ # `DescribeInstances` operation. For information, see
9458
9914
  # [DescribeInstances][1] in the *Amazon EC2 API Reference* or
9459
9915
  # [describe-instances][2] in the *Amazon Web Services CLI Command
9460
9916
  # Reference*.
@@ -9481,19 +9937,18 @@ module Aws::SSM
9481
9937
  # The name is specified as the `DefaultInstanceName` property using
9482
9938
  # the CreateActivation command. It is applied to the managed node by
9483
9939
  # 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*.
9940
+ # SSM Agent on the node, as explained in [How to install SSM Agent on
9941
+ # hybrid Linux nodes][1] and [How to install SSM Agent on hybrid
9942
+ # Windows Server nodes][2]. To retrieve the `Name` tag of an EC2
9943
+ # instance, use the Amazon EC2 `DescribeInstances` operation. For
9944
+ # information, see [DescribeInstances][3] in the *Amazon EC2 API
9945
+ # Reference* or [describe-instances][4] in the *Amazon Web Services
9946
+ # CLI Command Reference*.
9492
9947
  #
9493
9948
  #
9494
9949
  #
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
9950
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-ssm-agent-install-linux.html
9951
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-ssm-agent-install-windows.html
9497
9952
  # [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
9498
9953
  # [4]: https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html
9499
9954
  # @return [String]
@@ -9593,8 +10048,8 @@ module Aws::SSM
9593
10048
  #
9594
10049
  # Valid filter key values: ActivationIds \| AgentVersion \|
9595
10050
  # AssociationStatus \| IamRole \| InstanceIds \| PingStatus \|
9596
- # PlatformTypes \| ResourceType \| SourceIds \| SourceTypes \|
9597
- # "tag-key" \| "tag:`\{keyname\}`
10051
+ # PlatformType \| ResourceType \| SourceIds \| SourceTypes \|
10052
+ # "tag-key" \| "tag:`{keyname}`
9598
10053
  #
9599
10054
  # * Valid values for the `AssociationStatus` filter key: Success \|
9600
10055
  # Pending \| Failed
@@ -9659,8 +10114,8 @@ module Aws::SSM
9659
10114
  # the patches specified by the default patch baseline.
9660
10115
  #
9661
10116
  # 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*.
10117
+ # [SSM Command document for patching: `AWS-RunPatchBaseline` ][1] in
10118
+ # the *Amazon Web Services Systems Manager User Guide*.
9664
10119
  #
9665
10120
  #
9666
10121
  #
@@ -9714,7 +10169,7 @@ module Aws::SSM
9714
10169
  # @!attribute [rw] unreported_not_applicable_count
9715
10170
  # The number of patches beyond the supported limit of
9716
10171
  # `NotApplicableCount` that aren't reported by name to Inventory.
9717
- # Inventory is a capability of Amazon Web Services Systems Manager.
10172
+ # Inventory is a tool in Amazon Web Services Systems Manager.
9718
10173
  # @return [Integer]
9719
10174
  #
9720
10175
  # @!attribute [rw] not_applicable_count
@@ -9725,6 +10180,15 @@ module Aws::SSM
9725
10180
  # `UnreportedNotApplicableCount`.
9726
10181
  # @return [Integer]
9727
10182
  #
10183
+ # @!attribute [rw] available_security_update_count
10184
+ # The number of security-related patches that are available but not
10185
+ # approved because they didn't meet the patch baseline requirements.
10186
+ # For example, an updated version of a patch might have been released
10187
+ # before the specified auto-approval period was over.
10188
+ #
10189
+ # Applies to Windows Server managed nodes only.
10190
+ # @return [Integer]
10191
+ #
9728
10192
  # @!attribute [rw] operation_start_time
9729
10193
  # The time the most recent patching operation was started on the
9730
10194
  # managed node.
@@ -9805,6 +10269,7 @@ module Aws::SSM
9805
10269
  :failed_count,
9806
10270
  :unreported_not_applicable_count,
9807
10271
  :not_applicable_count,
10272
+ :available_security_update_count,
9808
10273
  :operation_start_time,
9809
10274
  :operation_end_time,
9810
10275
  :operation,
@@ -9899,7 +10364,7 @@ module Aws::SSM
9899
10364
  # @return [String]
9900
10365
  #
9901
10366
  # @!attribute [rw] architecture
9902
- # The CPU architecture of the node. For example, x86\_64.
10367
+ # The CPU architecture of the node. For example, `x86_64`.
9903
10368
  # @return [String]
9904
10369
  #
9905
10370
  # @!attribute [rw] ip_address
@@ -9926,7 +10391,7 @@ module Aws::SSM
9926
10391
  #
9927
10392
  # @!attribute [rw] platform_type
9928
10393
  # The operating system platform type of the managed node. For example,
9929
- # Windows.
10394
+ # Windows Server or Amazon Linux 2.
9930
10395
  # @return [String]
9931
10396
  #
9932
10397
  # @!attribute [rw] platform_name
@@ -10090,7 +10555,7 @@ module Aws::SSM
10090
10555
  include Aws::Structure
10091
10556
  end
10092
10557
 
10093
- # The activation ID isn't valid. Verify the you entered the correct
10558
+ # The activation ID isn't valid. Verify that you entered the correct
10094
10559
  # ActivationId or ActivationCode and try again.
10095
10560
  #
10096
10561
  # @!attribute [rw] message
@@ -10104,9 +10569,8 @@ module Aws::SSM
10104
10569
  include Aws::Structure
10105
10570
  end
10106
10571
 
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`.
10572
+ # The specified aggregator isn't valid for the group type. Verify that
10573
+ # the aggregator you provided is supported.
10110
10574
  #
10111
10575
  # @!attribute [rw] message
10112
10576
  # @return [String]
@@ -10320,7 +10784,7 @@ module Aws::SSM
10320
10784
  include Aws::Structure
10321
10785
  end
10322
10786
 
10323
- # The filter name isn't valid. Verify the you entered the correct name
10787
+ # The filter name isn't valid. Verify that you entered the correct name
10324
10788
  # and try again.
10325
10789
  #
10326
10790
  # @!attribute [rw] message
@@ -10796,7 +11260,7 @@ module Aws::SSM
10796
11260
  #
10797
11261
  #
10798
11262
  #
10799
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-custom.html#sysman-inventory-delete
11263
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-custom.html#delete-custom-inventory
10800
11264
  # @return [Types::InventoryDeletionSummary]
10801
11265
  #
10802
11266
  # @!attribute [rw] last_status_update_time
@@ -10892,7 +11356,7 @@ module Aws::SSM
10892
11356
  #
10893
11357
  #
10894
11358
  #
10895
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-inventory-aggregate.html
11359
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-aggregate.html
10896
11360
  # @return [String]
10897
11361
  #
10898
11362
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InventoryFilter AWS API Documentation
@@ -11759,6 +12223,129 @@ module Aws::SSM
11759
12223
  include Aws::Structure
11760
12224
  end
11761
12225
 
12226
+ # @!attribute [rw] sync_name
12227
+ # The name of the Amazon Web Services managed resource data sync to
12228
+ # retrieve information about.
12229
+ #
12230
+ # For cross-account/cross-Region configurations, this parameter is
12231
+ # required, and the name of the supported resource data sync is
12232
+ # `AWS-QuickSetup-ManagedNode`.
12233
+ #
12234
+ # For single account/single-Region configurations, the parameter is
12235
+ # not required.
12236
+ # @return [String]
12237
+ #
12238
+ # @!attribute [rw] filters
12239
+ # One or more filters. Use a filter to return a more specific list of
12240
+ # managed nodes.
12241
+ # @return [Array<Types::NodeFilter>]
12242
+ #
12243
+ # @!attribute [rw] next_token
12244
+ # The token for the next set of items to return. (You received this
12245
+ # token from a previous call.)
12246
+ # @return [String]
12247
+ #
12248
+ # @!attribute [rw] max_results
12249
+ # The maximum number of items to return for this call. The call also
12250
+ # returns a token that you can specify in a subsequent call to get the
12251
+ # next set of results.
12252
+ # @return [Integer]
12253
+ #
12254
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesRequest AWS API Documentation
12255
+ #
12256
+ class ListNodesRequest < Struct.new(
12257
+ :sync_name,
12258
+ :filters,
12259
+ :next_token,
12260
+ :max_results)
12261
+ SENSITIVE = []
12262
+ include Aws::Structure
12263
+ end
12264
+
12265
+ # @!attribute [rw] nodes
12266
+ # A list of managed nodes that match the specified filter criteria.
12267
+ # @return [Array<Types::Node>]
12268
+ #
12269
+ # @!attribute [rw] next_token
12270
+ # The token to use when requesting the next set of items. If there are
12271
+ # no additional items to return, the string is empty.
12272
+ # @return [String]
12273
+ #
12274
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesResult AWS API Documentation
12275
+ #
12276
+ class ListNodesResult < Struct.new(
12277
+ :nodes,
12278
+ :next_token)
12279
+ SENSITIVE = []
12280
+ include Aws::Structure
12281
+ end
12282
+
12283
+ # @!attribute [rw] sync_name
12284
+ # The name of the Amazon Web Services managed resource data sync to
12285
+ # retrieve information about.
12286
+ #
12287
+ # For cross-account/cross-Region configurations, this parameter is
12288
+ # required, and the name of the supported resource data sync is
12289
+ # `AWS-QuickSetup-ManagedNode`.
12290
+ #
12291
+ # For single account/single-Region configurations, the parameter is
12292
+ # not required.
12293
+ # @return [String]
12294
+ #
12295
+ # @!attribute [rw] filters
12296
+ # One or more filters. Use a filter to generate a summary that matches
12297
+ # your specified filter criteria.
12298
+ # @return [Array<Types::NodeFilter>]
12299
+ #
12300
+ # @!attribute [rw] aggregators
12301
+ # Specify one or more aggregators to return a count of managed nodes
12302
+ # that match that expression. For example, a count of managed nodes by
12303
+ # operating system.
12304
+ # @return [Array<Types::NodeAggregator>]
12305
+ #
12306
+ # @!attribute [rw] next_token
12307
+ # The token for the next set of items to return. (You received this
12308
+ # token from a previous call.) The call also returns a token that you
12309
+ # can specify in a subsequent call to get the next set of results.
12310
+ # @return [String]
12311
+ #
12312
+ # @!attribute [rw] max_results
12313
+ # The maximum number of items to return for this call. The call also
12314
+ # returns a token that you can specify in a subsequent call to get the
12315
+ # next set of results.
12316
+ # @return [Integer]
12317
+ #
12318
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummaryRequest AWS API Documentation
12319
+ #
12320
+ class ListNodesSummaryRequest < Struct.new(
12321
+ :sync_name,
12322
+ :filters,
12323
+ :aggregators,
12324
+ :next_token,
12325
+ :max_results)
12326
+ SENSITIVE = []
12327
+ include Aws::Structure
12328
+ end
12329
+
12330
+ # @!attribute [rw] summary
12331
+ # A collection of objects reporting information about your managed
12332
+ # nodes, such as the count of nodes by operating system.
12333
+ # @return [Array<Hash<String,String>>]
12334
+ #
12335
+ # @!attribute [rw] next_token
12336
+ # The token to use when requesting the next set of items. If there are
12337
+ # no additional items to return, the string is empty.
12338
+ # @return [String]
12339
+ #
12340
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListNodesSummaryResult AWS API Documentation
12341
+ #
12342
+ class ListNodesSummaryResult < Struct.new(
12343
+ :summary,
12344
+ :next_token)
12345
+ SENSITIVE = []
12346
+ include Aws::Structure
12347
+ end
12348
+
11762
12349
  # @!attribute [rw] filters
11763
12350
  # One or more OpsItem filters. Use a filter to return a more specific
11764
12351
  # list of results.
@@ -12539,10 +13126,24 @@ module Aws::SSM
12539
13126
  # @return [Hash<String,Array<String>>]
12540
13127
  #
12541
13128
  # @!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.
13129
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
13130
+ # Web Services Systems Manager to assume when running a maintenance
13131
+ # window task. If you do not specify a service role ARN, Systems
13132
+ # Manager uses a service-linked role in your account. If no
13133
+ # appropriate service-linked role for Systems Manager exists in your
13134
+ # account, it is created when you run
13135
+ # `RegisterTaskWithMaintenanceWindow`.
13136
+ #
13137
+ # However, for an improved security posture, we strongly recommend
13138
+ # creating a custom policy and custom service role for running your
13139
+ # maintenance window tasks. The policy can be crafted to provide only
13140
+ # the permissions needed for your particular maintenance window tasks.
13141
+ # For more information, see [Setting up Maintenance Windows][1] in the
13142
+ # in the *Amazon Web Services Systems Manager User Guide*.
13143
+ #
13144
+ #
13145
+ #
13146
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
12546
13147
  # @return [String]
12547
13148
  #
12548
13149
  # @!attribute [rw] timeout_seconds
@@ -12726,10 +13327,24 @@ module Aws::SSM
12726
13327
  # @return [Types::LoggingInfo]
12727
13328
  #
12728
13329
  # @!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.
13330
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
13331
+ # Web Services Systems Manager to assume when running a maintenance
13332
+ # window task. If you do not specify a service role ARN, Systems
13333
+ # Manager uses a service-linked role in your account. If no
13334
+ # appropriate service-linked role for Systems Manager exists in your
13335
+ # account, it is created when you run
13336
+ # `RegisterTaskWithMaintenanceWindow`.
13337
+ #
13338
+ # However, for an improved security posture, we strongly recommend
13339
+ # creating a custom policy and custom service role for running your
13340
+ # maintenance window tasks. The policy can be crafted to provide only
13341
+ # the permissions needed for your particular maintenance window tasks.
13342
+ # For more information, see [Setting up Maintenance Windows][1] in the
13343
+ # in the *Amazon Web Services Systems Manager User Guide*.
13344
+ #
13345
+ #
13346
+ #
13347
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
12733
13348
  # @return [String]
12734
13349
  #
12735
13350
  # @!attribute [rw] max_concurrency
@@ -12908,7 +13523,8 @@ module Aws::SSM
12908
13523
  # @!attribute [rw] account_ids_to_add
12909
13524
  # The Amazon Web Services users that should have access to the
12910
13525
  # document. The account IDs can either be a group of account IDs or
12911
- # *All*.
13526
+ # *All*. You must specify a value for this parameter or the
13527
+ # `AccountIdsToRemove` parameter.
12912
13528
  # @return [Array<String>]
12913
13529
  #
12914
13530
  # @!attribute [rw] account_ids_to_remove
@@ -12916,7 +13532,8 @@ module Aws::SSM
12916
13532
  # the document. The Amazon Web Services user can either be a group of
12917
13533
  # account IDs or *All*. This action has a higher priority than
12918
13534
  # `AccountIdsToAdd`. If you specify an ID to add and the same ID to
12919
- # remove, the system removes access to the document.
13535
+ # remove, the system removes access to the document. You must specify
13536
+ # a value for this parameter or the `AccountIdsToAdd` parameter.
12920
13537
  # @return [Array<String>]
12921
13538
  #
12922
13539
  # @!attribute [rw] shared_document_version
@@ -12940,6 +13557,149 @@ module Aws::SSM
12940
13557
  #
12941
13558
  class ModifyDocumentPermissionResponse < Aws::EmptyStructure; end
12942
13559
 
13560
+ # Details about an individual managed node.
13561
+ #
13562
+ # @!attribute [rw] capture_time
13563
+ # The UTC timestamp for when the managed node data was last captured.
13564
+ # @return [Time]
13565
+ #
13566
+ # @!attribute [rw] id
13567
+ # The ID of the managed node.
13568
+ # @return [String]
13569
+ #
13570
+ # @!attribute [rw] owner
13571
+ # Information about the ownership of the managed node.
13572
+ # @return [Types::NodeOwnerInfo]
13573
+ #
13574
+ # @!attribute [rw] region
13575
+ # The Amazon Web Services Region that a managed node was created in or
13576
+ # assigned to.
13577
+ # @return [String]
13578
+ #
13579
+ # @!attribute [rw] node_type
13580
+ # Information about the type of node.
13581
+ # @return [Types::NodeType]
13582
+ #
13583
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Node AWS API Documentation
13584
+ #
13585
+ class Node < Struct.new(
13586
+ :capture_time,
13587
+ :id,
13588
+ :owner,
13589
+ :region,
13590
+ :node_type)
13591
+ SENSITIVE = []
13592
+ include Aws::Structure
13593
+ end
13594
+
13595
+ # One or more aggregators for viewing counts of nodes using different
13596
+ # dimensions.
13597
+ #
13598
+ # @!attribute [rw] aggregator_type
13599
+ # The aggregator type for limiting a node summary. Currently, only
13600
+ # `Count` is supported.
13601
+ # @return [String]
13602
+ #
13603
+ # @!attribute [rw] type_name
13604
+ # The data type name to use for viewing counts of nodes. Currently,
13605
+ # only `Instance` is supported.
13606
+ # @return [String]
13607
+ #
13608
+ # @!attribute [rw] attribute_name
13609
+ # The name of a node attribute on which to limit the count of nodes.
13610
+ # @return [String]
13611
+ #
13612
+ # @!attribute [rw] aggregators
13613
+ # Information about aggregators used to refine a node summary.
13614
+ # @return [Array<Types::NodeAggregator>]
13615
+ #
13616
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeAggregator AWS API Documentation
13617
+ #
13618
+ class NodeAggregator < Struct.new(
13619
+ :aggregator_type,
13620
+ :type_name,
13621
+ :attribute_name,
13622
+ :aggregators)
13623
+ SENSITIVE = []
13624
+ include Aws::Structure
13625
+ end
13626
+
13627
+ # The filters for the operation.
13628
+ #
13629
+ # @!attribute [rw] key
13630
+ # The name of the filter.
13631
+ # @return [String]
13632
+ #
13633
+ # @!attribute [rw] values
13634
+ # A filter value supported by the specified key. For example, for the
13635
+ # key `PlatformType`, supported values include `Linux` and `Windows`.
13636
+ # @return [Array<String>]
13637
+ #
13638
+ # @!attribute [rw] type
13639
+ # The type of filter operator.
13640
+ # @return [String]
13641
+ #
13642
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeFilter AWS API Documentation
13643
+ #
13644
+ class NodeFilter < Struct.new(
13645
+ :key,
13646
+ :values,
13647
+ :type)
13648
+ SENSITIVE = []
13649
+ include Aws::Structure
13650
+ end
13651
+
13652
+ # Information about ownership of a managed node.
13653
+ #
13654
+ # @!attribute [rw] account_id
13655
+ # The ID of the Amazon Web Services account that owns the managed
13656
+ # node.
13657
+ # @return [String]
13658
+ #
13659
+ # @!attribute [rw] organizational_unit_id
13660
+ # The ID of the organization unit (OU) that the account is part of.
13661
+ # @return [String]
13662
+ #
13663
+ # @!attribute [rw] organizational_unit_path
13664
+ # The path for the organizational unit (OU) that owns the managed
13665
+ # node. The path for the OU is built using the IDs of the
13666
+ # organization, root, and all OUs in the path down to and including
13667
+ # the OU. For example:
13668
+ #
13669
+ # `o-a1b2c3d4e5/r-f6g7h8i9j0example/ou-ghi0-awsccccc/ou-jkl0-awsddddd/`
13670
+ # @return [String]
13671
+ #
13672
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeOwnerInfo AWS API Documentation
13673
+ #
13674
+ class NodeOwnerInfo < Struct.new(
13675
+ :account_id,
13676
+ :organizational_unit_id,
13677
+ :organizational_unit_path)
13678
+ SENSITIVE = []
13679
+ include Aws::Structure
13680
+ end
13681
+
13682
+ # Information about a managed node's type.
13683
+ #
13684
+ # @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.
13685
+ #
13686
+ # @!attribute [rw] instance
13687
+ # Information about a specific managed node.
13688
+ # @return [Types::InstanceInfo]
13689
+ #
13690
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NodeType AWS API Documentation
13691
+ #
13692
+ class NodeType < Struct.new(
13693
+ :instance,
13694
+ :unknown)
13695
+ SENSITIVE = []
13696
+ include Aws::Structure
13697
+ include Aws::Structure::Union
13698
+
13699
+ class Instance < NodeType; end
13700
+ class Unknown < NodeType; end
13701
+ end
13702
+
12943
13703
  # A summary of resources that aren't compliant. The summary is
12944
13704
  # organized according to resource type.
12945
13705
  #
@@ -13192,9 +13952,8 @@ module Aws::SSM
13192
13952
  # @return [Array<Types::RelatedOpsItem>]
13193
13953
  #
13194
13954
  # @!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*.
13955
+ # The OpsItem status. For more information, see [Editing OpsItem
13956
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
13198
13957
  #
13199
13958
  #
13200
13959
  #
@@ -13714,8 +14473,7 @@ module Aws::SSM
13714
14473
  # @return [String]
13715
14474
  #
13716
14475
  # @!attribute [rw] status
13717
- # The OpsItem status. Status can be `Open`, `In Progress`, or
13718
- # `Resolved`.
14476
+ # The OpsItem status.
13719
14477
  # @return [String]
13720
14478
  #
13721
14479
  # @!attribute [rw] ops_item_id
@@ -14159,9 +14917,9 @@ module Aws::SSM
14159
14917
  # @return [String]
14160
14918
  #
14161
14919
  # @!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.
14920
+ # The type of policy. Parameter Store, a tool in Amazon Web Services
14921
+ # Systems Manager, supports the following policy types: Expiration,
14922
+ # ExpirationNotification, and NoChangeNotification.
14165
14923
  # @return [String]
14166
14924
  #
14167
14925
  # @!attribute [rw] policy_status
@@ -14241,7 +14999,7 @@ module Aws::SSM
14241
14999
  # @return [String]
14242
15000
  #
14243
15001
  # @!attribute [rw] arn
14244
- # The (ARN) of the last user to update the parameter.
15002
+ # The Amazon Resource Name (ARN) of the parameter.
14245
15003
  # @return [String]
14246
15004
  #
14247
15005
  # @!attribute [rw] type
@@ -14311,6 +15069,12 @@ module Aws::SSM
14311
15069
 
14312
15070
  # The parameter couldn't be found. Verify the name and try again.
14313
15071
  #
15072
+ # <note markdown="1"> For the `DeleteParameter` and `GetParameter` actions, if the specified
15073
+ # parameter doesn't exist, the `ParameterNotFound` exception is *not*
15074
+ # recorded in CloudTrail event logs.
15075
+ #
15076
+ # </note>
15077
+ #
14314
15078
  # @!attribute [rw] message
14315
15079
  # @return [String]
14316
15080
  #
@@ -14637,10 +15401,10 @@ module Aws::SSM
14637
15401
  # @return [String]
14638
15402
  #
14639
15403
  # @!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.
15404
+ # Indicates whether this is the default baseline. Amazon Web Services
15405
+ # Systems Manager supports creating multiple default patch baselines.
15406
+ # For example, you can create a default patch baseline for each
15407
+ # operating system.
14644
15408
  # @return [Boolean]
14645
15409
  #
14646
15410
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PatchBaselineIdentity AWS API Documentation
@@ -14686,7 +15450,7 @@ module Aws::SSM
14686
15450
  #
14687
15451
  #
14688
15452
  #
14689
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-compliance-about.html#sysman-compliance-monitor-patch
15453
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html#compliance-monitor-patch
14690
15454
  # @return [String]
14691
15455
  #
14692
15456
  # @!attribute [rw] installed_time
@@ -14840,16 +15604,48 @@ module Aws::SSM
14840
15604
  # The number of days after the release date of each patch matched by
14841
15605
  # the rule that the patch is marked as approved in the patch baseline.
14842
15606
  # 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.
15607
+ # days after they are released.
15608
+ #
15609
+ # This parameter is marked as `Required: No`, but your request must
15610
+ # include a value for either `ApproveAfterDays` or `ApproveUntilDate`.
15611
+ #
15612
+ # Not supported for Debian Server or Ubuntu Server.
15613
+ #
15614
+ # Use caution when setting this value for Windows Server patch
15615
+ # baselines. Because patch updates that are replaced by later updates
15616
+ # are removed, setting too broad a value for this parameter can result
15617
+ # in crucial patches not being installed. For more information, see
15618
+ # the **Windows Server** tab in the topic [How security patches are
15619
+ # selected][1] in the *Amazon Web Services Systems Manager User
15620
+ # Guide*.
15621
+ #
15622
+ #
15623
+ #
15624
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-selecting-patches.html
14845
15625
  # @return [Integer]
14846
15626
  #
14847
15627
  # @!attribute [rw] approve_until_date
14848
15628
  # 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.
15629
+ # released on or before this date are installed automatically.
15630
+ #
15631
+ # Enter dates in the format `YYYY-MM-DD`. For example, `2024-12-31`.
15632
+ #
15633
+ # This parameter is marked as `Required: No`, but your request must
15634
+ # include a value for either `ApproveUntilDate` or `ApproveAfterDays`.
15635
+ #
15636
+ # Not supported for Debian Server or Ubuntu Server.
15637
+ #
15638
+ # Use caution when setting this value for Windows Server patch
15639
+ # baselines. Because patch updates that are replaced by later updates
15640
+ # are removed, setting too broad a value for this parameter can result
15641
+ # in crucial patches not being installed. For more information, see
15642
+ # the **Windows Server** tab in the topic [How security patches are
15643
+ # selected][1] in the *Amazon Web Services Systems Manager User
15644
+ # Guide*.
15645
+ #
15646
+ #
14851
15647
  #
14852
- # Enter dates in the format `YYYY-MM-DD`. For example, `2021-12-31`.
15648
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-selecting-patches.html
14853
15649
  # @return [String]
14854
15650
  #
14855
15651
  # @!attribute [rw] enable_non_security
@@ -15115,8 +15911,8 @@ module Aws::SSM
15115
15911
  end
15116
15912
 
15117
15913
  # @!attribute [rw] name
15118
- # The fully qualified name of the parameter that you want to add to
15119
- # the system.
15914
+ # The fully qualified name of the parameter that you want to create or
15915
+ # update.
15120
15916
  #
15121
15917
  # <note markdown="1"> You can't enter the Amazon Resource Name (ARN) for a parameter,
15122
15918
  # only the parameter name itself.
@@ -15155,11 +15951,16 @@ module Aws::SSM
15155
15951
  # see [Creating Systems Manager parameters][1] in the *Amazon Web
15156
15952
  # Services Systems Manager User Guide*.
15157
15953
  #
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
15954
+ # <note markdown="1"> The reported maximum length of 2048 characters for a parameter name
15955
+ # includes 1037 characters that are reserved for internal use by
15956
+ # Systems Manager. The maximum length for a parameter name that you
15957
+ # specify is 1011 characters.
15958
+ #
15959
+ # This count of 1011 characters includes the characters in the ARN
15960
+ # that precede the name you specify. This ARN length will vary
15961
+ # depending on your partition and Region. For example, the following
15962
+ # 45 characters count toward the 1011 character maximum for a
15963
+ # parameter created in the US East (Ohio) Region:
15163
15964
  # `arn:aws:ssm:us-east-2:111122223333:parameter/`.
15164
15965
  #
15165
15966
  # </note>
@@ -15182,14 +15983,14 @@ module Aws::SSM
15182
15983
  # value limit of 8 KB.
15183
15984
  #
15184
15985
  # <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.
15986
+ # parameters. You can't include values wrapped in double brackets
15987
+ # `{{}}` or `{{ssm:parameter-name}}` in a parameter value.
15187
15988
  #
15188
15989
  # </note>
15189
15990
  # @return [String]
15190
15991
  #
15191
15992
  # @!attribute [rw] type
15192
- # The type of parameter that you want to add to the system.
15993
+ # The type of parameter that you want to create.
15193
15994
  #
15194
15995
  # <note markdown="1"> `SecureString` isn't currently supported for CloudFormation
15195
15996
  # templates.
@@ -15212,7 +16013,7 @@ module Aws::SSM
15212
16013
  # parameters that use the `SecureString` data type.
15213
16014
  #
15214
16015
  # 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
16016
+ # associated with your Amazon Web Services account, which is not as
15216
16017
  # secure as using a custom key.
15217
16018
  #
15218
16019
  # * To use a custom KMS key, choose the `SecureString` data type with
@@ -15332,8 +16133,8 @@ module Aws::SSM
15332
16133
  #
15333
16134
  # @!attribute [rw] policies
15334
16135
  # 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:
16136
+ # JSON array. Parameter Store, a tool in Amazon Web Services Systems
16137
+ # Manager supports the following policy types:
15337
16138
  #
15338
16139
  # Expiration: This policy deletes the parameter after it expires. When
15339
16140
  # you create the policy, you specify the expiration date. You can
@@ -15706,7 +16507,7 @@ module Aws::SSM
15706
16507
  # creating a custom policy and custom service role for running your
15707
16508
  # maintenance window tasks. The policy can be crafted to provide only
15708
16509
  # the permissions needed for your particular maintenance window tasks.
15709
- # For more information, see [Setting up maintenance windows][1] in the
16510
+ # For more information, see [Setting up Maintenance Windows][1] in the
15710
16511
  # in the *Amazon Web Services Systems Manager User Guide*.
15711
16512
  #
15712
16513
  #
@@ -15830,7 +16631,6 @@ module Aws::SSM
15830
16631
  # the command associated with the task. However, there is no
15831
16632
  # guarantee that the command will be terminated and the underlying
15832
16633
  # process stopped.
15833
- #
15834
16634
  # The status for tasks that are not completed is `TIMED_OUT`.
15835
16635
  # @return [String]
15836
16636
  #
@@ -15974,16 +16774,20 @@ module Aws::SSM
15974
16774
  # The Amazon Resource Name (ARN) of the service setting to reset. The
15975
16775
  # setting ID can be one of the following.
15976
16776
  #
15977
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
16777
+ # * `/ssm/appmanager/appmanager-enabled`
15978
16778
  #
15979
16779
  # * `/ssm/automation/customer-script-log-destination`
15980
16780
  #
15981
16781
  # * `/ssm/automation/customer-script-log-group-name`
15982
16782
  #
16783
+ # * /ssm/automation/enable-adaptive-concurrency
16784
+ #
15983
16785
  # * `/ssm/documents/console/public-sharing-permission`
15984
16786
  #
15985
16787
  # * `/ssm/managed-instance/activation-tier`
15986
16788
  #
16789
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
16790
+ #
15987
16791
  # * `/ssm/opsinsights/opscenter`
15988
16792
  #
15989
16793
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -17015,8 +17819,8 @@ module Aws::SSM
17015
17819
  #
17016
17820
  # @!attribute [rw] cloud_watch_output_config
17017
17821
  # 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.
17822
+ # output to Amazon CloudWatch Logs. Run Command is a tool in Amazon
17823
+ # Web Services Systems Manager.
17020
17824
  # @return [Types::CloudWatchOutputConfig]
17021
17825
  #
17022
17826
  # @!attribute [rw] alarm_configuration
@@ -17061,6 +17865,42 @@ module Aws::SSM
17061
17865
  include Aws::Structure
17062
17866
  end
17063
17867
 
17868
+ # The request exceeds the service quota. Service quotas, also referred
17869
+ # to as limits, are the maximum number of service resources or
17870
+ # operations for your Amazon Web Services account.
17871
+ #
17872
+ # @!attribute [rw] message
17873
+ # @return [String]
17874
+ #
17875
+ # @!attribute [rw] resource_id
17876
+ # The unique ID of the resource referenced in the failed request.
17877
+ # @return [String]
17878
+ #
17879
+ # @!attribute [rw] resource_type
17880
+ # The resource type of the resource referenced in the failed request.
17881
+ # @return [String]
17882
+ #
17883
+ # @!attribute [rw] quota_code
17884
+ # The quota code recognized by the Amazon Web Services Service Quotas
17885
+ # service.
17886
+ # @return [String]
17887
+ #
17888
+ # @!attribute [rw] service_code
17889
+ # The code for the Amazon Web Services service that owns the quota.
17890
+ # @return [String]
17891
+ #
17892
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ServiceQuotaExceededException AWS API Documentation
17893
+ #
17894
+ class ServiceQuotaExceededException < Struct.new(
17895
+ :message,
17896
+ :resource_id,
17897
+ :resource_type,
17898
+ :quota_code,
17899
+ :service_code)
17900
+ SENSITIVE = []
17901
+ include Aws::Structure
17902
+ end
17903
+
17064
17904
  # The service setting data structure.
17065
17905
  #
17066
17906
  # `ServiceSetting` is an account-level setting for an Amazon Web
@@ -17195,6 +18035,15 @@ module Aws::SSM
17195
18035
  # The maximum duration of a session before it terminates.
17196
18036
  # @return [String]
17197
18037
  #
18038
+ # @!attribute [rw] access_type
18039
+ # `Standard` access type is the default for Session Manager sessions.
18040
+ # `JustInTime` is the access type for [Just-in-time node access][1].
18041
+ #
18042
+ #
18043
+ #
18044
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-just-in-time-node-access.html
18045
+ # @return [String]
18046
+ #
17198
18047
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Session AWS API Documentation
17199
18048
  #
17200
18049
  class Session < Struct.new(
@@ -17208,7 +18057,8 @@ module Aws::SSM
17208
18057
  :reason,
17209
18058
  :details,
17210
18059
  :output_url,
17211
- :max_session_duration)
18060
+ :max_session_duration,
18061
+ :access_type)
17212
18062
  SENSITIVE = []
17213
18063
  include Aws::Structure
17214
18064
  end
@@ -17223,12 +18073,12 @@ module Aws::SSM
17223
18073
  # The filter value. Valid values for each filter key are as follows:
17224
18074
  #
17225
18075
  # * 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.
18076
+ # example, specify 2024-08-29T00:00:00Z to see sessions that started
18077
+ # August 29, 2024, and later.
17228
18078
  #
17229
18079
  # * 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.
18080
+ # example, specify 2024-08-29T00:00:00Z to see sessions that started
18081
+ # before August 29, 2024.
17232
18082
  #
17233
18083
  # * Target: Specify a managed node to which session connections have
17234
18084
  # been made.
@@ -17250,7 +18100,6 @@ module Aws::SSM
17250
18100
  # * Terminating
17251
18101
  #
17252
18102
  # * Failed
17253
- #
17254
18103
  # * SessionId: Specify a session ID to return details about the
17255
18104
  # session.
17256
18105
  # @return [String]
@@ -17335,6 +18184,42 @@ module Aws::SSM
17335
18184
  include Aws::Structure
17336
18185
  end
17337
18186
 
18187
+ # @!attribute [rw] reason
18188
+ # A brief description explaining why you are requesting access to the
18189
+ # node.
18190
+ # @return [String]
18191
+ #
18192
+ # @!attribute [rw] targets
18193
+ # The node you are requesting access to.
18194
+ # @return [Array<Types::Target>]
18195
+ #
18196
+ # @!attribute [rw] tags
18197
+ # Key-value pairs of metadata you want to assign to the access
18198
+ # request.
18199
+ # @return [Array<Types::Tag>]
18200
+ #
18201
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAccessRequestRequest AWS API Documentation
18202
+ #
18203
+ class StartAccessRequestRequest < Struct.new(
18204
+ :reason,
18205
+ :targets,
18206
+ :tags)
18207
+ SENSITIVE = []
18208
+ include Aws::Structure
18209
+ end
18210
+
18211
+ # @!attribute [rw] access_request_id
18212
+ # The ID of the access request.
18213
+ # @return [String]
18214
+ #
18215
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAccessRequestResponse AWS API Documentation
18216
+ #
18217
+ class StartAccessRequestResponse < Struct.new(
18218
+ :access_request_id)
18219
+ SENSITIVE = []
18220
+ include Aws::Structure
18221
+ end
18222
+
17338
18223
  # @!attribute [rw] association_ids
17339
18224
  # The association IDs that you want to run immediately and only one
17340
18225
  # time.
@@ -17391,6 +18276,9 @@ module Aws::SSM
17391
18276
  # @!attribute [rw] targets
17392
18277
  # A key-value mapping to target resources. Required if you specify
17393
18278
  # TargetParameterName.
18279
+ #
18280
+ # If both this parameter and the `TargetLocation:Targets` parameter
18281
+ # are supplied, `TargetLocation:Targets` takes precedence.
17394
18282
  # @return [Array<Types::Target>]
17395
18283
  #
17396
18284
  # @!attribute [rw] target_maps
@@ -17402,6 +18290,10 @@ module Aws::SSM
17402
18290
  # The maximum number of targets allowed to run this task in parallel.
17403
18291
  # You can specify a number, such as 10, or a percentage, such as 10%.
17404
18292
  # The default value is `10`.
18293
+ #
18294
+ # If both this parameter and the
18295
+ # `TargetLocation:TargetsMaxConcurrency` are supplied,
18296
+ # `TargetLocation:TargetsMaxConcurrency` takes precedence.
17405
18297
  # @return [String]
17406
18298
  #
17407
18299
  # @!attribute [rw] max_errors
@@ -17421,6 +18313,10 @@ module Aws::SSM
17421
18313
  # fail as well. If you need to ensure that there won't be more than
17422
18314
  # max-errors failed executions, set max-concurrency to 1 so the
17423
18315
  # executions proceed one at a time.
18316
+ #
18317
+ # If this parameter and the `TargetLocation:TargetsMaxErrors`
18318
+ # parameter are both supplied, `TargetLocation:TargetsMaxErrors` takes
18319
+ # precedence.
17424
18320
  # @return [String]
17425
18321
  #
17426
18322
  # @!attribute [rw] target_locations
@@ -17428,9 +18324,9 @@ module Aws::SSM
17428
18324
  # Amazon Web Services accounts where you want to run the automation.
17429
18325
  # Use this operation to start an automation in multiple Amazon Web
17430
18326
  # 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*.
18327
+ # information, see [Running automations in multiple Amazon Web
18328
+ # Services Regions and accounts][1] in the *Amazon Web Services
18329
+ # Systems Manager User Guide*.
17434
18330
  #
17435
18331
  #
17436
18332
  #
@@ -17449,8 +18345,11 @@ module Aws::SSM
17449
18345
  #
17450
18346
  # * `Key=OS,Value=Windows`
17451
18347
  #
17452
- # <note markdown="1"> To add tags to an existing automation, use the AddTagsToResource
17453
- # operation.
18348
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
18349
+ # includes capacity reserved for internal operations. When calling the
18350
+ # `StartAutomationExecution` action, you can specify a maximum of 5
18351
+ # tags. You can, however, use the AddTagsToResource action to add up
18352
+ # to a total of 50 tags to an existing automation configuration.
17454
18353
  #
17455
18354
  # </note>
17456
18355
  # @return [Array<Types::Tag>]
@@ -17459,6 +18358,12 @@ module Aws::SSM
17459
18358
  # The CloudWatch alarm you want to apply to your automation.
17460
18359
  # @return [Types::AlarmConfiguration]
17461
18360
  #
18361
+ # @!attribute [rw] target_locations_url
18362
+ # Specify a publicly accessible URL for a file that contains the
18363
+ # `TargetLocations` body. Currently, only files in presigned Amazon S3
18364
+ # buckets are supported.
18365
+ # @return [String]
18366
+ #
17462
18367
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAutomationExecutionRequest AWS API Documentation
17463
18368
  #
17464
18369
  class StartAutomationExecutionRequest < Struct.new(
@@ -17474,7 +18379,8 @@ module Aws::SSM
17474
18379
  :max_errors,
17475
18380
  :target_locations,
17476
18381
  :tags,
17477
- :alarm_configuration)
18382
+ :alarm_configuration,
18383
+ :target_locations_url)
17478
18384
  SENSITIVE = []
17479
18385
  include Aws::Structure
17480
18386
  end
@@ -17566,6 +18472,14 @@ module Aws::SSM
17566
18472
  # * `Key=Environment,Value=Production`
17567
18473
  #
17568
18474
  # * `Key=Region,Value=us-east-2`
18475
+ #
18476
+ # <note markdown="1"> The `Array Members` maximum value is reported as 1000. This number
18477
+ # includes capacity reserved for internal operations. When calling the
18478
+ # `StartChangeRequestExecution` action, you can specify a maximum of 5
18479
+ # tags. You can, however, use the AddTagsToResource action to add up
18480
+ # to a total of 50 tags to an existing change request configuration.
18481
+ #
18482
+ # </note>
17569
18483
  # @return [Array<Types::Tag>]
17570
18484
  #
17571
18485
  # @!attribute [rw] scheduled_end_time
@@ -17611,6 +18525,44 @@ module Aws::SSM
17611
18525
  include Aws::Structure
17612
18526
  end
17613
18527
 
18528
+ # @!attribute [rw] document_name
18529
+ # The name of the Automation runbook to run. The result of the
18530
+ # execution preview indicates what the impact would be of running this
18531
+ # runbook.
18532
+ # @return [String]
18533
+ #
18534
+ # @!attribute [rw] document_version
18535
+ # The version of the Automation runbook to run. The default value is
18536
+ # `$DEFAULT`.
18537
+ # @return [String]
18538
+ #
18539
+ # @!attribute [rw] execution_inputs
18540
+ # Information about the inputs that can be specified for the preview
18541
+ # operation.
18542
+ # @return [Types::ExecutionInputs]
18543
+ #
18544
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreviewRequest AWS API Documentation
18545
+ #
18546
+ class StartExecutionPreviewRequest < Struct.new(
18547
+ :document_name,
18548
+ :document_version,
18549
+ :execution_inputs)
18550
+ SENSITIVE = []
18551
+ include Aws::Structure
18552
+ end
18553
+
18554
+ # @!attribute [rw] execution_preview_id
18555
+ # The ID of the execution preview generated by the system.
18556
+ # @return [String]
18557
+ #
18558
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartExecutionPreviewResponse AWS API Documentation
18559
+ #
18560
+ class StartExecutionPreviewResponse < Struct.new(
18561
+ :execution_preview_id)
18562
+ SENSITIVE = []
18563
+ include Aws::Structure
18564
+ end
18565
+
17614
18566
  # @!attribute [rw] target
17615
18567
  # The managed node to connect to for the session.
17616
18568
  # @return [String]
@@ -17637,7 +18589,13 @@ module Aws::SSM
17637
18589
  #
17638
18590
  # @!attribute [rw] parameters
17639
18591
  # The values you want to specify for the parameters defined in the
17640
- # Session document.
18592
+ # Session document. For more information about these parameters, see
18593
+ # [Create a Session Manager preferences document][1] in the *Amazon
18594
+ # Web Services Systems Manager User Guide*.
18595
+ #
18596
+ #
18597
+ #
18598
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/getting-started-create-preferences-cli.html
17641
18599
  # @return [Hash<String,Array<String>>]
17642
18600
  #
17643
18601
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartSessionRequest AWS API Documentation
@@ -17935,7 +18893,7 @@ module Aws::SSM
17935
18893
  #
17936
18894
  # Supported formats include the following.
17937
18895
  #
17938
- # **For all Systems Manager capabilities:**
18896
+ # **For all Systems Manager tools:**
17939
18897
  #
17940
18898
  # * `Key=tag-key,Values=tag-value-1,tag-value-2`
17941
18899
  #
@@ -18064,6 +19022,39 @@ module Aws::SSM
18064
19022
  # automation or command.
18065
19023
  # @return [Types::AlarmConfiguration]
18066
19024
  #
19025
+ # @!attribute [rw] include_child_organization_units
19026
+ # Indicates whether to include child organizational units (OUs) that
19027
+ # are children of the targeted OUs. The default is `false`.
19028
+ # @return [Boolean]
19029
+ #
19030
+ # @!attribute [rw] exclude_accounts
19031
+ # Amazon Web Services accounts or organizational units to exclude as
19032
+ # expanded targets.
19033
+ # @return [Array<String>]
19034
+ #
19035
+ # @!attribute [rw] targets
19036
+ # A list of key-value mappings to target resources. If you specify
19037
+ # values for this data type, you must also specify a value for
19038
+ # `TargetParameterName`.
19039
+ #
19040
+ # This `Targets` parameter takes precedence over the
19041
+ # `StartAutomationExecution:Targets` parameter if both are supplied.
19042
+ # @return [Array<Types::Target>]
19043
+ #
19044
+ # @!attribute [rw] targets_max_concurrency
19045
+ # The maximum number of targets allowed to run this task in parallel.
19046
+ # This `TargetsMaxConcurrency` takes precedence over the
19047
+ # `StartAutomationExecution:MaxConcurrency` parameter if both are
19048
+ # supplied.
19049
+ # @return [String]
19050
+ #
19051
+ # @!attribute [rw] targets_max_errors
19052
+ # The maximum number of errors that are allowed before the system
19053
+ # stops running the automation on additional targets. This
19054
+ # `TargetsMaxErrors` parameter takes precedence over the
19055
+ # `StartAutomationExecution:MaxErrors` parameter if both are supplied.
19056
+ # @return [String]
19057
+ #
18067
19058
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/TargetLocation AWS API Documentation
18068
19059
  #
18069
19060
  class TargetLocation < Struct.new(
@@ -18072,17 +19063,22 @@ module Aws::SSM
18072
19063
  :target_location_max_concurrency,
18073
19064
  :target_location_max_errors,
18074
19065
  :execution_role_name,
18075
- :target_location_alarm_configuration)
19066
+ :target_location_alarm_configuration,
19067
+ :include_child_organization_units,
19068
+ :exclude_accounts,
19069
+ :targets,
19070
+ :targets_max_concurrency,
19071
+ :targets_max_errors)
18076
19072
  SENSITIVE = []
18077
19073
  include Aws::Structure
18078
19074
  end
18079
19075
 
18080
19076
  # The specified target managed node for the session isn't fully
18081
19077
  # 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
19078
+ # [Setting up Session Manager][1] in the *Amazon Web Services Systems
19079
+ # Manager User Guide*. This error is also returned if you attempt to
19080
+ # start a session on a managed node that is located in a different
19081
+ # account or Region
18086
19082
  #
18087
19083
  #
18088
19084
  #
@@ -18099,6 +19095,27 @@ module Aws::SSM
18099
19095
  include Aws::Structure
18100
19096
  end
18101
19097
 
19098
+ # Information about the resources that would be included in the actual
19099
+ # runbook execution, if it were to be run.
19100
+ #
19101
+ # @!attribute [rw] count
19102
+ # The number of resources of a certain type included in an execution
19103
+ # preview.
19104
+ # @return [Integer]
19105
+ #
19106
+ # @!attribute [rw] target_type
19107
+ # A type of resource that was included in the execution preview.
19108
+ # @return [String]
19109
+ #
19110
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/TargetPreview AWS API Documentation
19111
+ #
19112
+ class TargetPreview < Struct.new(
19113
+ :count,
19114
+ :target_type)
19115
+ SENSITIVE = []
19116
+ include Aws::Structure
19117
+ end
19118
+
18102
19119
  # @!attribute [rw] session_id
18103
19120
  # The ID of the session to terminate.
18104
19121
  # @return [String]
@@ -18123,6 +19140,31 @@ module Aws::SSM
18123
19140
  include Aws::Structure
18124
19141
  end
18125
19142
 
19143
+ # The request or operation couldn't be performed because the service is
19144
+ # throttling requests.
19145
+ #
19146
+ # @!attribute [rw] message
19147
+ # @return [String]
19148
+ #
19149
+ # @!attribute [rw] quota_code
19150
+ # The quota code recognized by the Amazon Web Services Service Quotas
19151
+ # service.
19152
+ # @return [String]
19153
+ #
19154
+ # @!attribute [rw] service_code
19155
+ # The code for the Amazon Web Services service that owns the quota.
19156
+ # @return [String]
19157
+ #
19158
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ThrottlingException AWS API Documentation
19159
+ #
19160
+ class ThrottlingException < Struct.new(
19161
+ :message,
19162
+ :quota_code,
19163
+ :service_code)
19164
+ SENSITIVE = []
19165
+ include Aws::Structure
19166
+ end
19167
+
18126
19168
  # The `Targets` parameter includes too many tags. Remove one or more
18127
19169
  # tags and try the command again.
18128
19170
  #
@@ -18288,6 +19330,21 @@ module Aws::SSM
18288
19330
  include Aws::Structure
18289
19331
  end
18290
19332
 
19333
+ # This operation is not supported for the current account. You must
19334
+ # first enable the Systems Manager integrated experience in your
19335
+ # account.
19336
+ #
19337
+ # @!attribute [rw] message
19338
+ # @return [String]
19339
+ #
19340
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UnsupportedOperationException AWS API Documentation
19341
+ #
19342
+ class UnsupportedOperationException < Struct.new(
19343
+ :message)
19344
+ SENSITIVE = []
19345
+ include Aws::Structure
19346
+ end
19347
+
18291
19348
  # The parameter type isn't supported.
18292
19349
  #
18293
19350
  # @!attribute [rw] message
@@ -18322,9 +19379,9 @@ module Aws::SSM
18322
19379
  #
18323
19380
  # @!attribute [rw] parameters
18324
19381
  # 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\}\}`.
19382
+ # a parameter using Parameter Store, a tool in Amazon Web Services
19383
+ # Systems Manager, you can reference the parameter using
19384
+ # `{{ssm:parameter-name}}`.
18328
19385
  # @return [Hash<String,Array<String>>]
18329
19386
  #
18330
19387
  # @!attribute [rw] document_version
@@ -18390,7 +19447,7 @@ module Aws::SSM
18390
19447
  # Choose the parameter that will define how your automation will
18391
19448
  # branch out. This target is required for associations that use an
18392
19449
  # Automation runbook and target resources by using rate controls.
18393
- # Automation is a capability of Amazon Web Services Systems Manager.
19450
+ # Automation is a tool in Amazon Web Services Systems Manager.
18394
19451
  # @return [String]
18395
19452
  #
18396
19453
  # @!attribute [rw] max_errors
@@ -18438,9 +19495,9 @@ module Aws::SSM
18438
19495
  #
18439
19496
  # In `MANUAL` mode, you must specify the `AssociationId` as a
18440
19497
  # 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.
19498
+ # compliance data isn't managed by State Manager, a tool in Amazon
19499
+ # Web Services Systems Manager. It is managed by your direct call to
19500
+ # the PutComplianceItems API operation.
18444
19501
  #
18445
19502
  # By default, all associations use `AUTO` mode.
18446
19503
  # @return [String]
@@ -18448,27 +19505,39 @@ module Aws::SSM
18448
19505
  # @!attribute [rw] apply_only_at_cron_interval
18449
19506
  # By default, when you update an association, the system runs it
18450
19507
  # 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.
19508
+ # you specified. Specify `true` for `ApplyOnlyAtCronInterval` if you
19509
+ # want the association to run only according to the schedule you
19510
+ # specified.
18454
19511
  #
18455
19512
  # 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
19513
+ # you edit that association or you make changes to the Automation
19514
+ # runbook or SSM document on which that association is based, State
19515
+ # Manager applies the association at the next specified cron interval.
19516
+ # For example, if you chose the `Latest` version of an SSM document
19517
+ # when you created an association and you edit the association by
19518
+ # choosing a different document version on the Documents page, State
19519
+ # Manager applies the association at the next specified cron interval
19520
+ # if you previously set `ApplyOnlyAtCronInterval` to `true`. If this
19521
+ # option wasn't selected, State Manager immediately runs the
18465
19522
  # association.
18466
19523
  #
18467
- # You can reset this option. To do so, specify the
19524
+ # For more information, see [Understanding when associations are
19525
+ # applied to resources][1] and [About target updates with Automation
19526
+ # runbooks][2] in the *Amazon Web Services Systems Manager User
19527
+ # Guide*.
19528
+ #
19529
+ # This parameter isn't supported for rate expressions.
19530
+ #
19531
+ # You can reset this parameter. To do so, specify the
18468
19532
  # `no-apply-only-at-cron-interval` parameter when you update the
18469
19533
  # association from the command line. This parameter forces the
18470
19534
  # association to run immediately after updating it and according to
18471
19535
  # the interval specified.
19536
+ #
19537
+ #
19538
+ #
19539
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#state-manager-about-scheduling
19540
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-about.html#runbook-target-updates
18472
19541
  # @return [Boolean]
18473
19542
  #
18474
19543
  # @!attribute [rw] calendar_names
@@ -18476,7 +19545,8 @@ module Aws::SSM
18476
19545
  # type documents you want to gate your associations under. The
18477
19546
  # associations only run when that change calendar is open. For more
18478
19547
  # information, see [Amazon Web Services Systems Manager Change
18479
- # Calendar][1].
19548
+ # Calendar][1] in the *Amazon Web Services Systems Manager User
19549
+ # Guide*.
18480
19550
  #
18481
19551
  #
18482
19552
  #
@@ -19068,7 +20138,7 @@ module Aws::SSM
19068
20138
  # creating a custom policy and custom service role for running your
19069
20139
  # maintenance window tasks. The policy can be crafted to provide only
19070
20140
  # the permissions needed for your particular maintenance window tasks.
19071
- # For more information, see [Setting up maintenance windows][1] in the
20141
+ # For more information, see [Setting up Maintenance Windows][1] in the
19072
20142
  # in the *Amazon Web Services Systems Manager User Guide*.
19073
20143
  #
19074
20144
  #
@@ -19207,7 +20277,6 @@ module Aws::SSM
19207
20277
  # the command associated with the task. However, there is no
19208
20278
  # guarantee that the command will be terminated and the underlying
19209
20279
  # process stopped.
19210
- #
19211
20280
  # The status for tasks that are not completed is `TIMED_OUT`.
19212
20281
  # @return [String]
19213
20282
  #
@@ -19256,10 +20325,24 @@ module Aws::SSM
19256
20325
  # @return [String]
19257
20326
  #
19258
20327
  # @!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.
20328
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon
20329
+ # Web Services Systems Manager to assume when running a maintenance
20330
+ # window task. If you do not specify a service role ARN, Systems
20331
+ # Manager uses a service-linked role in your account. If no
20332
+ # appropriate service-linked role for Systems Manager exists in your
20333
+ # account, it is created when you run
20334
+ # `RegisterTaskWithMaintenanceWindow`.
20335
+ #
20336
+ # However, for an improved security posture, we strongly recommend
20337
+ # creating a custom policy and custom service role for running your
20338
+ # maintenance window tasks. The policy can be crafted to provide only
20339
+ # the permissions needed for your particular maintenance window tasks.
20340
+ # For more information, see [Setting up Maintenance Windows][1] in the
20341
+ # in the *Amazon Web Services Systems Manager User Guide*.
20342
+ #
20343
+ #
20344
+ #
20345
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
19263
20346
  # @return [String]
19264
20347
  #
19265
20348
  # @!attribute [rw] task_parameters
@@ -19353,9 +20436,9 @@ module Aws::SSM
19353
20436
  # want to assign to the managed node. This IAM role must provide
19354
20437
  # AssumeRole permissions for the Amazon Web Services Systems Manager
19355
20438
  # 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*.
20439
+ # [Create the IAM service role required for Systems Manager in hybrid
20440
+ # and multicloud environments][1] in the *Amazon Web Services Systems
20441
+ # Manager User Guide*.
19359
20442
  #
19360
20443
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter.
19361
20444
  # You must create a unique role.
@@ -19364,7 +20447,7 @@ module Aws::SSM
19364
20447
  #
19365
20448
  #
19366
20449
  #
19367
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
20450
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
19368
20451
  # @return [String]
19369
20452
  #
19370
20453
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateManagedInstanceRoleRequest AWS API Documentation
@@ -19441,9 +20524,8 @@ module Aws::SSM
19441
20524
  # @return [Array<Types::RelatedOpsItem>]
19442
20525
  #
19443
20526
  # @!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*.
20527
+ # The OpsItem status. For more information, see [Editing OpsItem
20528
+ # details][1] in the *Amazon Web Services Systems Manager User Guide*.
19447
20529
  #
19448
20530
  #
19449
20531
  #
@@ -19565,6 +20647,11 @@ module Aws::SSM
19565
20647
  #
19566
20648
  # @!attribute [rw] global_filters
19567
20649
  # A set of global filters used to include patches in the baseline.
20650
+ #
20651
+ # The `GlobalFilters` parameter can be configured only by using the
20652
+ # CLI or an Amazon Web Services SDK. It can't be configured from the
20653
+ # Patch Manager console, and its value isn't displayed in the
20654
+ # console.
19568
20655
  # @return [Types::PatchFilterGroup]
19569
20656
  #
19570
20657
  # @!attribute [rw] approval_rules
@@ -19575,9 +20662,9 @@ module Aws::SSM
19575
20662
  # A list of explicitly approved patches for the baseline.
19576
20663
  #
19577
20664
  # 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*.
20665
+ # and rejected patches, see [Package name formats for approved and
20666
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
20667
+ # User Guide*.
19581
20668
  #
19582
20669
  #
19583
20670
  #
@@ -19599,9 +20686,9 @@ module Aws::SSM
19599
20686
  # A list of explicitly rejected patches for the baseline.
19600
20687
  #
19601
20688
  # 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*.
20689
+ # and rejected patches, see [Package name formats for approved and
20690
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
20691
+ # User Guide*.
19605
20692
  #
19606
20693
  #
19607
20694
  #
@@ -19612,19 +20699,28 @@ module Aws::SSM
19612
20699
  # The action for Patch Manager to take on patches included in the
19613
20700
  # `RejectedPackages` list.
19614
20701
  #
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.
20702
+ # ALLOW\_AS\_DEPENDENCY
20703
+ #
20704
+ # : **Linux and macOS**: A package in the rejected patches list is
20705
+ # installed only if it is a dependency of another package. It is
20706
+ # considered compliant with the patch baseline, and its status is
20707
+ # reported as `INSTALLED_OTHER`. This is the default action if no
20708
+ # option is specified.
20709
+ #
20710
+ # **Windows Server**: Windows Server doesn't support the concept of
20711
+ # package dependencies. If a package in the rejected patches list
20712
+ # and already installed on the node, its status is reported as
20713
+ # `INSTALLED_OTHER`. Any package not already installed on the node
20714
+ # is skipped. This is the default action if no option is specified.
19620
20715
  #
19621
- # * **BLOCK**: Packages in the **Rejected patches** list, and packages
20716
+ # BLOCK
20717
+ #
20718
+ # : **All OSs**: Packages in the rejected patches list, and packages
19622
20719
  # that include them as dependencies, aren't installed by Patch
19623
20720
  # 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*.
20721
+ # it was added to the rejected patches list, or is installed outside
20722
+ # of Patch Manager afterward, it's considered noncompliant with the
20723
+ # patch baseline and its status is reported as `INSTALLED_REJECTED`.
19628
20724
  # @return [String]
19629
20725
  #
19630
20726
  # @!attribute [rw] description
@@ -19637,6 +20733,22 @@ module Aws::SSM
19637
20733
  # to Linux managed nodes only.
19638
20734
  # @return [Array<Types::PatchSource>]
19639
20735
  #
20736
+ # @!attribute [rw] available_security_updates_compliance_status
20737
+ # Indicates the status to be assigned to security patches that are
20738
+ # available but not approved because they don't meet the installation
20739
+ # criteria specified in the patch baseline.
20740
+ #
20741
+ # Example scenario: Security patches that you might want installed can
20742
+ # be skipped if you have specified a long period to wait after a patch
20743
+ # is released before installation. If an update to the patch is
20744
+ # released during your specified waiting period, the waiting period
20745
+ # for installing the patch starts over. If the waiting period is too
20746
+ # long, multiple versions of the patch could be released but never
20747
+ # installed.
20748
+ #
20749
+ # Supported for Windows Server managed nodes only.
20750
+ # @return [String]
20751
+ #
19640
20752
  # @!attribute [rw] replace
19641
20753
  # If True, then all fields that are required by the
19642
20754
  # CreatePatchBaseline operation are also required for this API
@@ -19657,6 +20769,7 @@ module Aws::SSM
19657
20769
  :rejected_patches_action,
19658
20770
  :description,
19659
20771
  :sources,
20772
+ :available_security_updates_compliance_status,
19660
20773
  :replace)
19661
20774
  SENSITIVE = []
19662
20775
  include Aws::Structure
@@ -19726,6 +20839,15 @@ module Aws::SSM
19726
20839
  # to Linux managed nodes only.
19727
20840
  # @return [Array<Types::PatchSource>]
19728
20841
  #
20842
+ # @!attribute [rw] available_security_updates_compliance_status
20843
+ # Indicates the compliance status of managed nodes for which
20844
+ # security-related patches are available but were not approved. This
20845
+ # preference is specified when the `CreatePatchBaseline` or
20846
+ # `UpdatePatchBaseline` commands are run.
20847
+ #
20848
+ # Applies to Windows Server managed nodes only.
20849
+ # @return [String]
20850
+ #
19729
20851
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdatePatchBaselineResult AWS API Documentation
19730
20852
  #
19731
20853
  class UpdatePatchBaselineResult < Struct.new(
@@ -19742,7 +20864,8 @@ module Aws::SSM
19742
20864
  :created_date,
19743
20865
  :modified_date,
19744
20866
  :description,
19745
- :sources)
20867
+ :sources,
20868
+ :available_security_updates_compliance_status)
19746
20869
  SENSITIVE = []
19747
20870
  include Aws::Structure
19748
20871
  end
@@ -19782,16 +20905,20 @@ module Aws::SSM
19782
20905
  # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
19783
20906
  # The setting ID can be one of the following.
19784
20907
  #
19785
- # * `/ssm/managed-instance/default-ec2-instance-management-role`
20908
+ # * `/ssm/appmanager/appmanager-enabled`
19786
20909
  #
19787
20910
  # * `/ssm/automation/customer-script-log-destination`
19788
20911
  #
19789
20912
  # * `/ssm/automation/customer-script-log-group-name`
19790
20913
  #
20914
+ # * /ssm/automation/enable-adaptive-concurrency
20915
+ #
19791
20916
  # * `/ssm/documents/console/public-sharing-permission`
19792
20917
  #
19793
20918
  # * `/ssm/managed-instance/activation-tier`
19794
20919
  #
20920
+ # * `/ssm/managed-instance/default-ec2-instance-management-role`
20921
+ #
19795
20922
  # * `/ssm/opsinsights/opscenter`
19796
20923
  #
19797
20924
  # * `/ssm/parameter-store/default-parameter-tier`
@@ -19811,8 +20938,7 @@ module Aws::SSM
19811
20938
  # The new value to specify for the service setting. The following list
19812
20939
  # specifies the available values for each setting.
19813
20940
  #
19814
- # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
19815
- # enter the name of an IAM role.
20941
+ # * For `/ssm/appmanager/appmanager-enabled`, enter `True` or `False`.
19816
20942
  #
19817
20943
  # * For `/ssm/automation/customer-script-log-destination`, enter
19818
20944
  # `CloudWatch`.
@@ -19826,6 +20952,9 @@ module Aws::SSM
19826
20952
  # * For `/ssm/managed-instance/activation-tier`, enter `standard` or
19827
20953
  # `advanced`.
19828
20954
  #
20955
+ # * For `/ssm/managed-instance/default-ec2-instance-management-role`,
20956
+ # enter the name of an IAM role.
20957
+ #
19829
20958
  # * For `/ssm/opsinsights/opscenter`, enter `Enabled` or `Disabled`.
19830
20959
  #
19831
20960
  # * For `/ssm/parameter-store/default-parameter-tier`, enter
@@ -19850,5 +20979,25 @@ module Aws::SSM
19850
20979
  #
19851
20980
  class UpdateServiceSettingResult < Aws::EmptyStructure; end
19852
20981
 
20982
+ # The request isn't valid. Verify that you entered valid contents for
20983
+ # the command and try again.
20984
+ #
20985
+ # @!attribute [rw] message
20986
+ # @return [String]
20987
+ #
20988
+ # @!attribute [rw] reason_code
20989
+ # The reason code for the invalid request.
20990
+ # @return [String]
20991
+ #
20992
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ValidationException AWS API Documentation
20993
+ #
20994
+ class ValidationException < Struct.new(
20995
+ :message,
20996
+ :reason_code)
20997
+ SENSITIVE = []
20998
+ include Aws::Structure
20999
+ end
21000
+
19853
21001
  end
19854
21002
  end
21003
+