aws-sdk-ssm 1.178.0 → 1.180.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ssm/client.rb +221 -41
- data/lib/aws-sdk-ssm/client_api.rb +13 -0
- data/lib/aws-sdk-ssm/plugins/endpoints.rb +8 -5
- data/lib/aws-sdk-ssm/types.rb +187 -102
- data/lib/aws-sdk-ssm.rb +1 -1
- data/sig/client.rbs +58 -6
- data/sig/resource.rbs +1 -0
- data/sig/types.rbs +8 -0
- metadata +4 -4
data/lib/aws-sdk-ssm/types.rb
CHANGED
@@ -1124,12 +1124,12 @@ module Aws::SSM
|
|
1124
1124
|
# * For the key *SourceUrl*, the value is an S3 bucket location. For
|
1125
1125
|
# example:
|
1126
1126
|
#
|
1127
|
-
# `"Values": [ "s3://
|
1127
|
+
# `"Values": [ "s3://amzn-s3-demo-bucket/my-prefix" ]`
|
1128
1128
|
#
|
1129
1129
|
# * For the key *S3FileUrl*, the value is a file in an S3 bucket. For
|
1130
1130
|
# example:
|
1131
1131
|
#
|
1132
|
-
# `"Values": [ "s3://
|
1132
|
+
# `"Values": [ "s3://amzn-s3-demo-bucket/my-prefix/my-file.py" ]`
|
1133
1133
|
#
|
1134
1134
|
# * For the key *AttachmentReference*, the value is constructed from
|
1135
1135
|
# the name of another SSM document in your account, a version number
|
@@ -1326,6 +1326,12 @@ module Aws::SSM
|
|
1326
1326
|
# The CloudWatch alarm that was invoked by the automation.
|
1327
1327
|
# @return [Array<Types::AlarmStateInformation>]
|
1328
1328
|
#
|
1329
|
+
# @!attribute [rw] target_locations_url
|
1330
|
+
# A publicly accessible URL for a file that contains the
|
1331
|
+
# `TargetLocations` body. Currently, only files in presigned Amazon S3
|
1332
|
+
# buckets are supported
|
1333
|
+
# @return [String]
|
1334
|
+
#
|
1329
1335
|
# @!attribute [rw] automation_subtype
|
1330
1336
|
# The subtype of the Automation operation. Currently, the only
|
1331
1337
|
# supported value is `ChangeRequest`.
|
@@ -1394,6 +1400,7 @@ module Aws::SSM
|
|
1394
1400
|
:progress_counters,
|
1395
1401
|
:alarm_configuration,
|
1396
1402
|
:triggered_alarms,
|
1403
|
+
:target_locations_url,
|
1397
1404
|
:automation_subtype,
|
1398
1405
|
:scheduled_time,
|
1399
1406
|
:runbooks,
|
@@ -1534,9 +1541,9 @@ module Aws::SSM
|
|
1534
1541
|
# Use this filter with DescribeAutomationExecutions. Specify either
|
1535
1542
|
# Local or CrossAccount. CrossAccount is an Automation that runs in
|
1536
1543
|
# multiple Amazon Web Services Regions and Amazon Web Services
|
1537
|
-
# accounts. For more information, see [Running
|
1538
|
-
#
|
1539
|
-
#
|
1544
|
+
# accounts. For more information, see [Running automations in multiple
|
1545
|
+
# Amazon Web Services Regions and accounts][1] in the *Amazon Web
|
1546
|
+
# Services Systems Manager User Guide*.
|
1540
1547
|
#
|
1541
1548
|
#
|
1542
1549
|
#
|
@@ -1551,6 +1558,12 @@ module Aws::SSM
|
|
1551
1558
|
# The CloudWatch alarm that was invoked by the automation.
|
1552
1559
|
# @return [Array<Types::AlarmStateInformation>]
|
1553
1560
|
#
|
1561
|
+
# @!attribute [rw] target_locations_url
|
1562
|
+
# A publicly accessible URL for a file that contains the
|
1563
|
+
# `TargetLocations` body. Currently, only files in presigned Amazon S3
|
1564
|
+
# buckets are supported
|
1565
|
+
# @return [String]
|
1566
|
+
#
|
1554
1567
|
# @!attribute [rw] automation_subtype
|
1555
1568
|
# The subtype of the Automation operation. Currently, the only
|
1556
1569
|
# supported value is `ChangeRequest`.
|
@@ -1612,6 +1625,7 @@ module Aws::SSM
|
|
1612
1625
|
:automation_type,
|
1613
1626
|
:alarm_configuration,
|
1614
1627
|
:triggered_alarms,
|
1628
|
+
:target_locations_url,
|
1615
1629
|
:automation_subtype,
|
1616
1630
|
:scheduled_time,
|
1617
1631
|
:runbooks,
|
@@ -1668,9 +1682,9 @@ module Aws::SSM
|
|
1668
1682
|
# A list of explicitly approved patches for the baseline.
|
1669
1683
|
#
|
1670
1684
|
# For information about accepted formats for lists of approved patches
|
1671
|
-
# and rejected patches, see [
|
1672
|
-
#
|
1673
|
-
#
|
1685
|
+
# and rejected patches, see [Package name formats for approved and
|
1686
|
+
# rejected patch lists][1] in the *Amazon Web Services Systems Manager
|
1687
|
+
# User Guide*.
|
1674
1688
|
#
|
1675
1689
|
#
|
1676
1690
|
#
|
@@ -1687,9 +1701,9 @@ module Aws::SSM
|
|
1687
1701
|
# A list of explicitly rejected patches for the baseline.
|
1688
1702
|
#
|
1689
1703
|
# For information about accepted formats for lists of approved patches
|
1690
|
-
# and rejected patches, see [
|
1691
|
-
#
|
1692
|
-
#
|
1704
|
+
# and rejected patches, see [Package name formats for approved and
|
1705
|
+
# rejected patch lists][1] in the *Amazon Web Services Systems Manager
|
1706
|
+
# User Guide*.
|
1693
1707
|
#
|
1694
1708
|
#
|
1695
1709
|
#
|
@@ -2055,11 +2069,11 @@ module Aws::SSM
|
|
2055
2069
|
# The filter value. Valid values for each filter key are as follows:
|
2056
2070
|
#
|
2057
2071
|
# * **InvokedAfter**: Specify a timestamp to limit your results. For
|
2058
|
-
# example, specify `
|
2072
|
+
# example, specify `2024-07-07T00:00:00Z` to see a list of command
|
2059
2073
|
# executions occurring July 7, 2021, and later.
|
2060
2074
|
#
|
2061
2075
|
# * **InvokedBefore**: Specify a timestamp to limit your results. For
|
2062
|
-
# example, specify `
|
2076
|
+
# example, specify `2024-07-07T00:00:00Z` to see a list of command
|
2063
2077
|
# executions from before July 7, 2021.
|
2064
2078
|
#
|
2065
2079
|
# * **Status**: Specify a valid command status to see a list of all
|
@@ -2413,12 +2427,11 @@ module Aws::SSM
|
|
2413
2427
|
# be stored. This was requested when issuing the command. For example,
|
2414
2428
|
# in the following response:
|
2415
2429
|
#
|
2416
|
-
# `
|
2430
|
+
# `amzn-s3-demo-bucket/my-prefix/i-02573cafcfEXAMPLE/awsrunShellScript`
|
2417
2431
|
#
|
2418
|
-
# `
|
2432
|
+
# `amzn-s3-demo-bucket` is the name of the S3 bucket;
|
2419
2433
|
#
|
2420
|
-
# `
|
2421
|
-
# prefix;
|
2434
|
+
# `my-prefix` is the name of the S3 prefix;
|
2422
2435
|
#
|
2423
2436
|
# `i-02573cafcfEXAMPLE` is the managed node ID;
|
2424
2437
|
#
|
@@ -2430,12 +2443,11 @@ module Aws::SSM
|
|
2430
2443
|
# command executions should be stored. This was requested when issuing
|
2431
2444
|
# the command. For example, in the following response:
|
2432
2445
|
#
|
2433
|
-
# `
|
2446
|
+
# `amzn-s3-demo-bucket/my-prefix/i-02573cafcfEXAMPLE/awsrunShellScript`
|
2434
2447
|
#
|
2435
|
-
# `
|
2448
|
+
# `amzn-s3-demo-bucket` is the name of the S3 bucket;
|
2436
2449
|
#
|
2437
|
-
# `
|
2438
|
-
# prefix;
|
2450
|
+
# `my-prefix` is the name of the S3 prefix;
|
2439
2451
|
#
|
2440
2452
|
# `i-02573cafcfEXAMPLE` is the managed node ID;
|
2441
2453
|
#
|
@@ -2707,9 +2719,9 @@ module Aws::SSM
|
|
2707
2719
|
# want to assign to the managed node. This IAM role must provide
|
2708
2720
|
# AssumeRole permissions for the Amazon Web Services Systems Manager
|
2709
2721
|
# service principal `ssm.amazonaws.com`. For more information, see
|
2710
|
-
# [Create
|
2711
|
-
#
|
2712
|
-
# Guide*.
|
2722
|
+
# [Create the IAM service role required for Systems Manager in a
|
2723
|
+
# hybrid and multicloud environments][1] in the *Amazon Web Services
|
2724
|
+
# Systems Manager User Guide*.
|
2713
2725
|
#
|
2714
2726
|
# <note markdown="1"> You can't specify an IAM service-linked role for this parameter.
|
2715
2727
|
# You must create a unique role.
|
@@ -2718,7 +2730,7 @@ module Aws::SSM
|
|
2718
2730
|
#
|
2719
2731
|
#
|
2720
2732
|
#
|
2721
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
2733
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
|
2722
2734
|
# @return [String]
|
2723
2735
|
#
|
2724
2736
|
# @!attribute [rw] registration_limit
|
@@ -2728,7 +2740,7 @@ module Aws::SSM
|
|
2728
2740
|
#
|
2729
2741
|
# @!attribute [rw] expiration_date
|
2730
2742
|
# The date by which this activation request should expire, in
|
2731
|
-
# timestamp format, such as "
|
2743
|
+
# timestamp format, such as "2024-07-07T00:00:00". You can specify a
|
2732
2744
|
# date up to 30 days in advance. If you don't provide an expiration
|
2733
2745
|
# date, the activation code expires in 24 hours.
|
2734
2746
|
# @return [Time]
|
@@ -3099,9 +3111,10 @@ module Aws::SSM
|
|
3099
3111
|
# in an Amazon Web Services account, or individual managed node IDs.
|
3100
3112
|
# You can target all managed nodes in an Amazon Web Services account
|
3101
3113
|
# by specifying the `InstanceIds` key with a value of `*`. For more
|
3102
|
-
# information about choosing targets for an association, see
|
3103
|
-
# targets and rate controls in State Manager
|
3104
|
-
# *Amazon Web Services Systems Manager User
|
3114
|
+
# information about choosing targets for an association, see
|
3115
|
+
# [Understanding targets and rate controls in State Manager
|
3116
|
+
# associations][1] in the *Amazon Web Services Systems Manager User
|
3117
|
+
# Guide*.
|
3105
3118
|
#
|
3106
3119
|
#
|
3107
3120
|
#
|
@@ -3846,9 +3859,9 @@ module Aws::SSM
|
|
3846
3859
|
# A list of explicitly approved patches for the baseline.
|
3847
3860
|
#
|
3848
3861
|
# For information about accepted formats for lists of approved patches
|
3849
|
-
# and rejected patches, see [
|
3850
|
-
#
|
3851
|
-
#
|
3862
|
+
# and rejected patches, see [Package name formats for approved and
|
3863
|
+
# rejected patch lists][1] in the *Amazon Web Services Systems Manager
|
3864
|
+
# User Guide*.
|
3852
3865
|
#
|
3853
3866
|
#
|
3854
3867
|
#
|
@@ -3871,9 +3884,9 @@ module Aws::SSM
|
|
3871
3884
|
# A list of explicitly rejected patches for the baseline.
|
3872
3885
|
#
|
3873
3886
|
# For information about accepted formats for lists of approved patches
|
3874
|
-
# and rejected patches, see [
|
3875
|
-
#
|
3876
|
-
#
|
3887
|
+
# and rejected patches, see [Package name formats for approved and
|
3888
|
+
# rejected patch lists][1] in the *Amazon Web Services Systems Manager
|
3889
|
+
# User Guide*.
|
3877
3890
|
#
|
3878
3891
|
#
|
3879
3892
|
#
|
@@ -4178,12 +4191,12 @@ module Aws::SSM
|
|
4178
4191
|
#
|
4179
4192
|
# @!attribute [rw] deletion_summary
|
4180
4193
|
# A summary of the delete operation. For more information about this
|
4181
|
-
# summary, see [
|
4182
|
-
#
|
4194
|
+
# summary, see [Deleting custom inventory][1] in the *Amazon Web
|
4195
|
+
# Services Systems Manager User Guide*.
|
4183
4196
|
#
|
4184
4197
|
#
|
4185
4198
|
#
|
4186
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
4199
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-custom.html#delete-custom-inventory-summary
|
4187
4200
|
# @return [Types::InventoryDeletionSummary]
|
4188
4201
|
#
|
4189
4202
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DeleteInventoryResult AWS API Documentation
|
@@ -5372,9 +5385,9 @@ module Aws::SSM
|
|
5372
5385
|
# Sample values: `Installed` \| `InstalledOther` \|
|
5373
5386
|
# `InstalledPendingReboot`
|
5374
5387
|
#
|
5375
|
-
# For lists of all `State` values, see [
|
5376
|
-
#
|
5377
|
-
#
|
5388
|
+
# For lists of all `State` values, see [Patch compliance state
|
5389
|
+
# values][1] in the *Amazon Web Services Systems Manager User
|
5390
|
+
# Guide*.
|
5378
5391
|
#
|
5379
5392
|
#
|
5380
5393
|
#
|
@@ -5647,7 +5660,7 @@ module Aws::SSM
|
|
5647
5660
|
#
|
5648
5661
|
# * Values. An array of strings, each between 1 and 256 characters.
|
5649
5662
|
# Supported values are date/time strings in a valid ISO 8601
|
5650
|
-
# date/time format, such as `
|
5663
|
+
# date/time format, such as `2024-11-04T05:00:00Z`.
|
5651
5664
|
# @return [Array<Types::MaintenanceWindowFilter>]
|
5652
5665
|
#
|
5653
5666
|
# @!attribute [rw] max_results
|
@@ -8428,7 +8441,7 @@ module Aws::SSM
|
|
8428
8441
|
# creating a custom policy and custom service role for running your
|
8429
8442
|
# maintenance window tasks. The policy can be crafted to provide only
|
8430
8443
|
# the permissions needed for your particular maintenance window tasks.
|
8431
|
-
# For more information, see [Setting up
|
8444
|
+
# For more information, see [Setting up Maintenance Windows][1] in the
|
8432
8445
|
# in the *Amazon Web Services Systems Manager User Guide*.
|
8433
8446
|
#
|
8434
8447
|
#
|
@@ -8749,7 +8762,7 @@ module Aws::SSM
|
|
8749
8762
|
#
|
8750
8763
|
#
|
8751
8764
|
#
|
8752
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
8765
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
|
8753
8766
|
# @return [String]
|
8754
8767
|
#
|
8755
8768
|
# @!attribute [rw] with_decryption
|
@@ -9507,19 +9520,18 @@ module Aws::SSM
|
|
9507
9520
|
# The name is specified as the `DefaultInstanceName` property using
|
9508
9521
|
# the CreateActivation command. It is applied to the managed node by
|
9509
9522
|
# specifying the Activation Code and Activation ID when you install
|
9510
|
-
# SSM Agent on the node, as explained in [
|
9511
|
-
# hybrid
|
9512
|
-
#
|
9513
|
-
#
|
9514
|
-
#
|
9515
|
-
# [
|
9516
|
-
#
|
9517
|
-
# Reference*.
|
9523
|
+
# SSM Agent on the node, as explained in [How to install SSM Agent on
|
9524
|
+
# hybrid Linux nodes][1] and [How to install SSM Agent on hybrid
|
9525
|
+
# Windows Server nodes][2]. To retrieve the `Name` tag of an EC2
|
9526
|
+
# instance, use the Amazon EC2 `DescribeInstances` operation. For
|
9527
|
+
# information, see [DescribeInstances][3] in the *Amazon EC2 API
|
9528
|
+
# Reference* or [describe-instances][4] in the *Amazon Web Services
|
9529
|
+
# CLI Command Reference*.
|
9518
9530
|
#
|
9519
9531
|
#
|
9520
9532
|
#
|
9521
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
9522
|
-
# [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
9533
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-ssm-agent-install-linux.html
|
9534
|
+
# [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-ssm-agent-install-windows.html
|
9523
9535
|
# [3]: https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html
|
9524
9536
|
# [4]: https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html
|
9525
9537
|
# @return [String]
|
@@ -9685,8 +9697,8 @@ module Aws::SSM
|
|
9685
9697
|
# the patches specified by the default patch baseline.
|
9686
9698
|
#
|
9687
9699
|
# For more information about the `InstallOverrideList` parameter, see
|
9688
|
-
# [
|
9689
|
-
# Web Services Systems Manager User Guide*.
|
9700
|
+
# [SSM Command document for patching: `AWS-RunPatchBaseline` ][1] in
|
9701
|
+
# the *Amazon Web Services Systems Manager User Guide*.
|
9690
9702
|
#
|
9691
9703
|
#
|
9692
9704
|
#
|
@@ -10822,7 +10834,7 @@ module Aws::SSM
|
|
10822
10834
|
#
|
10823
10835
|
#
|
10824
10836
|
#
|
10825
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
10837
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-custom.html#delete-custom-inventory
|
10826
10838
|
# @return [Types::InventoryDeletionSummary]
|
10827
10839
|
#
|
10828
10840
|
# @!attribute [rw] last_status_update_time
|
@@ -10918,7 +10930,7 @@ module Aws::SSM
|
|
10918
10930
|
#
|
10919
10931
|
#
|
10920
10932
|
#
|
10921
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
10933
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/inventory-aggregate.html
|
10922
10934
|
# @return [String]
|
10923
10935
|
#
|
10924
10936
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InventoryFilter AWS API Documentation
|
@@ -12577,7 +12589,7 @@ module Aws::SSM
|
|
12577
12589
|
# creating a custom policy and custom service role for running your
|
12578
12590
|
# maintenance window tasks. The policy can be crafted to provide only
|
12579
12591
|
# the permissions needed for your particular maintenance window tasks.
|
12580
|
-
# For more information, see [Setting up
|
12592
|
+
# For more information, see [Setting up Maintenance Windows][1] in the
|
12581
12593
|
# in the *Amazon Web Services Systems Manager User Guide*.
|
12582
12594
|
#
|
12583
12595
|
#
|
@@ -12778,7 +12790,7 @@ module Aws::SSM
|
|
12778
12790
|
# creating a custom policy and custom service role for running your
|
12779
12791
|
# maintenance window tasks. The policy can be crafted to provide only
|
12780
12792
|
# the permissions needed for your particular maintenance window tasks.
|
12781
|
-
# For more information, see [Setting up
|
12793
|
+
# For more information, see [Setting up Maintenance Windows][1] in the
|
12782
12794
|
# in the *Amazon Web Services Systems Manager User Guide*.
|
12783
12795
|
#
|
12784
12796
|
#
|
@@ -13246,9 +13258,8 @@ module Aws::SSM
|
|
13246
13258
|
# @return [Array<Types::RelatedOpsItem>]
|
13247
13259
|
#
|
13248
13260
|
# @!attribute [rw] status
|
13249
|
-
# The OpsItem status.
|
13250
|
-
#
|
13251
|
-
# in the *Amazon Web Services Systems Manager User Guide*.
|
13261
|
+
# The OpsItem status. For more information, see [Editing OpsItem
|
13262
|
+
# details][1] in the *Amazon Web Services Systems Manager User Guide*.
|
13252
13263
|
#
|
13253
13264
|
#
|
13254
13265
|
#
|
@@ -13768,8 +13779,7 @@ module Aws::SSM
|
|
13768
13779
|
# @return [String]
|
13769
13780
|
#
|
13770
13781
|
# @!attribute [rw] status
|
13771
|
-
# The OpsItem status.
|
13772
|
-
# `Resolved`.
|
13782
|
+
# The OpsItem status.
|
13773
13783
|
# @return [String]
|
13774
13784
|
#
|
13775
13785
|
# @!attribute [rw] ops_item_id
|
@@ -14740,7 +14750,7 @@ module Aws::SSM
|
|
14740
14750
|
#
|
14741
14751
|
#
|
14742
14752
|
#
|
14743
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
14753
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html#compliance-monitor-patch
|
14744
14754
|
# @return [String]
|
14745
14755
|
#
|
14746
14756
|
# @!attribute [rw] installed_time
|
@@ -14896,26 +14906,46 @@ module Aws::SSM
|
|
14896
14906
|
# For example, a value of `7` means that patches are approved seven
|
14897
14907
|
# days after they are released.
|
14898
14908
|
#
|
14899
|
-
#
|
14909
|
+
# This parameter is marked as `Required: No`, but your request must
|
14900
14910
|
# include a value for either `ApproveAfterDays` or `ApproveUntilDate`.
|
14901
14911
|
#
|
14902
|
-
# </note>
|
14903
|
-
#
|
14904
14912
|
# Not supported for Debian Server or Ubuntu Server.
|
14913
|
+
#
|
14914
|
+
# Use caution when setting this value for Windows Server patch
|
14915
|
+
# baselines. Because patch updates that are replaced by later updates
|
14916
|
+
# are removed, setting too broad a value for this parameter can result
|
14917
|
+
# in crucial patches not being installed. For more information, see
|
14918
|
+
# the **Windows Server** tab in the topic [How security patches are
|
14919
|
+
# selected][1] in the *Amazon Web Services Systems Manager User
|
14920
|
+
# Guide*.
|
14921
|
+
#
|
14922
|
+
#
|
14923
|
+
#
|
14924
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-selecting-patches.html
|
14905
14925
|
# @return [Integer]
|
14906
14926
|
#
|
14907
14927
|
# @!attribute [rw] approve_until_date
|
14908
14928
|
# The cutoff date for auto approval of released patches. Any patches
|
14909
14929
|
# released on or before this date are installed automatically.
|
14910
14930
|
#
|
14911
|
-
# Enter dates in the format `YYYY-MM-DD`. For example, `
|
14931
|
+
# Enter dates in the format `YYYY-MM-DD`. For example, `2024-12-31`.
|
14912
14932
|
#
|
14913
|
-
#
|
14933
|
+
# This parameter is marked as `Required: No`, but your request must
|
14914
14934
|
# include a value for either `ApproveUntilDate` or `ApproveAfterDays`.
|
14915
14935
|
#
|
14916
|
-
# </note>
|
14917
|
-
#
|
14918
14936
|
# Not supported for Debian Server or Ubuntu Server.
|
14937
|
+
#
|
14938
|
+
# Use caution when setting this value for Windows Server patch
|
14939
|
+
# baselines. Because patch updates that are replaced by later updates
|
14940
|
+
# are removed, setting too broad a value for this parameter can result
|
14941
|
+
# in crucial patches not being installed. For more information, see
|
14942
|
+
# the **Windows Server** tab in the topic [How security patches are
|
14943
|
+
# selected][1] in the *Amazon Web Services Systems Manager User
|
14944
|
+
# Guide*.
|
14945
|
+
#
|
14946
|
+
#
|
14947
|
+
#
|
14948
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-selecting-patches.html
|
14919
14949
|
# @return [String]
|
14920
14950
|
#
|
14921
14951
|
# @!attribute [rw] enable_non_security
|
@@ -15772,7 +15802,7 @@ module Aws::SSM
|
|
15772
15802
|
# creating a custom policy and custom service role for running your
|
15773
15803
|
# maintenance window tasks. The policy can be crafted to provide only
|
15774
15804
|
# the permissions needed for your particular maintenance window tasks.
|
15775
|
-
# For more information, see [Setting up
|
15805
|
+
# For more information, see [Setting up Maintenance Windows][1] in the
|
15776
15806
|
# in the *Amazon Web Services Systems Manager User Guide*.
|
15777
15807
|
#
|
15778
15808
|
#
|
@@ -17289,12 +17319,12 @@ module Aws::SSM
|
|
17289
17319
|
# The filter value. Valid values for each filter key are as follows:
|
17290
17320
|
#
|
17291
17321
|
# * InvokedAfter: Specify a timestamp to limit your results. For
|
17292
|
-
# example, specify
|
17293
|
-
# August 29,
|
17322
|
+
# example, specify 2024-08-29T00:00:00Z to see sessions that started
|
17323
|
+
# August 29, 2024, and later.
|
17294
17324
|
#
|
17295
17325
|
# * InvokedBefore: Specify a timestamp to limit your results. For
|
17296
|
-
# example, specify
|
17297
|
-
# before August 29,
|
17326
|
+
# example, specify 2024-08-29T00:00:00Z to see sessions that started
|
17327
|
+
# before August 29, 2024.
|
17298
17328
|
#
|
17299
17329
|
# * Target: Specify a managed node to which session connections have
|
17300
17330
|
# been made.
|
@@ -17457,6 +17487,9 @@ module Aws::SSM
|
|
17457
17487
|
# @!attribute [rw] targets
|
17458
17488
|
# A key-value mapping to target resources. Required if you specify
|
17459
17489
|
# TargetParameterName.
|
17490
|
+
#
|
17491
|
+
# If both this parameter and the `TargetLocation:Targets` parameter
|
17492
|
+
# are supplied, `TargetLocation:Targets` takes precedence.
|
17460
17493
|
# @return [Array<Types::Target>]
|
17461
17494
|
#
|
17462
17495
|
# @!attribute [rw] target_maps
|
@@ -17468,6 +17501,10 @@ module Aws::SSM
|
|
17468
17501
|
# The maximum number of targets allowed to run this task in parallel.
|
17469
17502
|
# You can specify a number, such as 10, or a percentage, such as 10%.
|
17470
17503
|
# The default value is `10`.
|
17504
|
+
#
|
17505
|
+
# If both this parameter and the
|
17506
|
+
# `TargetLocation:TargetsMaxConcurrency` are supplied,
|
17507
|
+
# `TargetLocation:TargetsMaxConcurrency` takes precedence.
|
17471
17508
|
# @return [String]
|
17472
17509
|
#
|
17473
17510
|
# @!attribute [rw] max_errors
|
@@ -17487,6 +17524,10 @@ module Aws::SSM
|
|
17487
17524
|
# fail as well. If you need to ensure that there won't be more than
|
17488
17525
|
# max-errors failed executions, set max-concurrency to 1 so the
|
17489
17526
|
# executions proceed one at a time.
|
17527
|
+
#
|
17528
|
+
# If this parameter and the `TargetLocation:TargetsMaxErrors`
|
17529
|
+
# parameter are both supplied, `TargetLocation:TargetsMaxErrors` takes
|
17530
|
+
# precedence.
|
17490
17531
|
# @return [String]
|
17491
17532
|
#
|
17492
17533
|
# @!attribute [rw] target_locations
|
@@ -17494,9 +17535,9 @@ module Aws::SSM
|
|
17494
17535
|
# Amazon Web Services accounts where you want to run the automation.
|
17495
17536
|
# Use this operation to start an automation in multiple Amazon Web
|
17496
17537
|
# Services Regions and multiple Amazon Web Services accounts. For more
|
17497
|
-
# information, see [Running
|
17498
|
-
#
|
17499
|
-
#
|
17538
|
+
# information, see [Running automations in multiple Amazon Web
|
17539
|
+
# Services Regions and accounts][1] in the *Amazon Web Services
|
17540
|
+
# Systems Manager User Guide*.
|
17500
17541
|
#
|
17501
17542
|
#
|
17502
17543
|
#
|
@@ -17525,6 +17566,12 @@ module Aws::SSM
|
|
17525
17566
|
# The CloudWatch alarm you want to apply to your automation.
|
17526
17567
|
# @return [Types::AlarmConfiguration]
|
17527
17568
|
#
|
17569
|
+
# @!attribute [rw] target_locations_url
|
17570
|
+
# Specify a publicly accessible URL for a file that contains the
|
17571
|
+
# `TargetLocations` body. Currently, only files in presigned Amazon S3
|
17572
|
+
# buckets are supported.
|
17573
|
+
# @return [String]
|
17574
|
+
#
|
17528
17575
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/StartAutomationExecutionRequest AWS API Documentation
|
17529
17576
|
#
|
17530
17577
|
class StartAutomationExecutionRequest < Struct.new(
|
@@ -17540,7 +17587,8 @@ module Aws::SSM
|
|
17540
17587
|
:max_errors,
|
17541
17588
|
:target_locations,
|
17542
17589
|
:tags,
|
17543
|
-
:alarm_configuration
|
17590
|
+
:alarm_configuration,
|
17591
|
+
:target_locations_url)
|
17544
17592
|
SENSITIVE = []
|
17545
17593
|
include Aws::Structure
|
17546
17594
|
end
|
@@ -18130,6 +18178,39 @@ module Aws::SSM
|
|
18130
18178
|
# automation or command.
|
18131
18179
|
# @return [Types::AlarmConfiguration]
|
18132
18180
|
#
|
18181
|
+
# @!attribute [rw] include_child_organization_units
|
18182
|
+
# Indicates whether to include child organizational units (OUs) that
|
18183
|
+
# are children of the targeted OUs. The default is `false`.
|
18184
|
+
# @return [Boolean]
|
18185
|
+
#
|
18186
|
+
# @!attribute [rw] exclude_accounts
|
18187
|
+
# Amazon Web Services accounts or organizational units to exclude as
|
18188
|
+
# expanded targets.
|
18189
|
+
# @return [Array<String>]
|
18190
|
+
#
|
18191
|
+
# @!attribute [rw] targets
|
18192
|
+
# A list of key-value mappings to target resources. If you specify
|
18193
|
+
# values for this data type, you must also specify a value for
|
18194
|
+
# `TargetParameterName`.
|
18195
|
+
#
|
18196
|
+
# This `Targets` parameter takes precedence over the
|
18197
|
+
# `StartAutomationExecution:Targets` parameter if both are supplied.
|
18198
|
+
# @return [Array<Types::Target>]
|
18199
|
+
#
|
18200
|
+
# @!attribute [rw] targets_max_concurrency
|
18201
|
+
# The maximum number of targets allowed to run this task in parallel.
|
18202
|
+
# This `TargetsMaxConcurrency` takes precedence over the
|
18203
|
+
# `StartAutomationExecution:MaxConcurrency` parameter if both are
|
18204
|
+
# supplied.
|
18205
|
+
# @return [String]
|
18206
|
+
#
|
18207
|
+
# @!attribute [rw] targets_max_errors
|
18208
|
+
# The maximum number of errors that are allowed before the system
|
18209
|
+
# stops running the automation on additional targets. This
|
18210
|
+
# `TargetsMaxErrors` parameter takes precedence over the
|
18211
|
+
# `StartAutomationExecution:MaxErrors` parameter if both are supplied.
|
18212
|
+
# @return [String]
|
18213
|
+
#
|
18133
18214
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/TargetLocation AWS API Documentation
|
18134
18215
|
#
|
18135
18216
|
class TargetLocation < Struct.new(
|
@@ -18138,17 +18219,22 @@ module Aws::SSM
|
|
18138
18219
|
:target_location_max_concurrency,
|
18139
18220
|
:target_location_max_errors,
|
18140
18221
|
:execution_role_name,
|
18141
|
-
:target_location_alarm_configuration
|
18222
|
+
:target_location_alarm_configuration,
|
18223
|
+
:include_child_organization_units,
|
18224
|
+
:exclude_accounts,
|
18225
|
+
:targets,
|
18226
|
+
:targets_max_concurrency,
|
18227
|
+
:targets_max_errors)
|
18142
18228
|
SENSITIVE = []
|
18143
18229
|
include Aws::Structure
|
18144
18230
|
end
|
18145
18231
|
|
18146
18232
|
# The specified target managed node for the session isn't fully
|
18147
18233
|
# configured for use with Session Manager. For more information, see
|
18148
|
-
# [
|
18149
|
-
#
|
18150
|
-
#
|
18151
|
-
#
|
18234
|
+
# [Setting up Session Manager][1] in the *Amazon Web Services Systems
|
18235
|
+
# Manager User Guide*. This error is also returned if you attempt to
|
18236
|
+
# start a session on a managed node that is located in a different
|
18237
|
+
# account or Region
|
18152
18238
|
#
|
18153
18239
|
#
|
18154
18240
|
#
|
@@ -19134,7 +19220,7 @@ module Aws::SSM
|
|
19134
19220
|
# creating a custom policy and custom service role for running your
|
19135
19221
|
# maintenance window tasks. The policy can be crafted to provide only
|
19136
19222
|
# the permissions needed for your particular maintenance window tasks.
|
19137
|
-
# For more information, see [Setting up
|
19223
|
+
# For more information, see [Setting up Maintenance Windows][1] in the
|
19138
19224
|
# in the *Amazon Web Services Systems Manager User Guide*.
|
19139
19225
|
#
|
19140
19226
|
#
|
@@ -19334,7 +19420,7 @@ module Aws::SSM
|
|
19334
19420
|
# creating a custom policy and custom service role for running your
|
19335
19421
|
# maintenance window tasks. The policy can be crafted to provide only
|
19336
19422
|
# the permissions needed for your particular maintenance window tasks.
|
19337
|
-
# For more information, see [Setting up
|
19423
|
+
# For more information, see [Setting up Maintenance Windows][1] in the
|
19338
19424
|
# in the *Amazon Web Services Systems Manager User Guide*.
|
19339
19425
|
#
|
19340
19426
|
#
|
@@ -19433,9 +19519,9 @@ module Aws::SSM
|
|
19433
19519
|
# want to assign to the managed node. This IAM role must provide
|
19434
19520
|
# AssumeRole permissions for the Amazon Web Services Systems Manager
|
19435
19521
|
# service principal `ssm.amazonaws.com`. For more information, see
|
19436
|
-
# [Create
|
19437
|
-
#
|
19438
|
-
# Guide*.
|
19522
|
+
# [Create the IAM service role required for Systems Manager in hybrid
|
19523
|
+
# and multicloud environments][1] in the *Amazon Web Services Systems
|
19524
|
+
# Manager User Guide*.
|
19439
19525
|
#
|
19440
19526
|
# <note markdown="1"> You can't specify an IAM service-linked role for this parameter.
|
19441
19527
|
# You must create a unique role.
|
@@ -19444,7 +19530,7 @@ module Aws::SSM
|
|
19444
19530
|
#
|
19445
19531
|
#
|
19446
19532
|
#
|
19447
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/
|
19533
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/hybrid-multicloud-service-role.html
|
19448
19534
|
# @return [String]
|
19449
19535
|
#
|
19450
19536
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateManagedInstanceRoleRequest AWS API Documentation
|
@@ -19521,9 +19607,8 @@ module Aws::SSM
|
|
19521
19607
|
# @return [Array<Types::RelatedOpsItem>]
|
19522
19608
|
#
|
19523
19609
|
# @!attribute [rw] status
|
19524
|
-
# The OpsItem status.
|
19525
|
-
#
|
19526
|
-
# in the *Amazon Web Services Systems Manager User Guide*.
|
19610
|
+
# The OpsItem status. For more information, see [Editing OpsItem
|
19611
|
+
# details][1] in the *Amazon Web Services Systems Manager User Guide*.
|
19527
19612
|
#
|
19528
19613
|
#
|
19529
19614
|
#
|
@@ -19655,9 +19740,9 @@ module Aws::SSM
|
|
19655
19740
|
# A list of explicitly approved patches for the baseline.
|
19656
19741
|
#
|
19657
19742
|
# For information about accepted formats for lists of approved patches
|
19658
|
-
# and rejected patches, see [
|
19659
|
-
#
|
19660
|
-
#
|
19743
|
+
# and rejected patches, see [Package name formats for approved and
|
19744
|
+
# rejected patch lists][1] in the *Amazon Web Services Systems Manager
|
19745
|
+
# User Guide*.
|
19661
19746
|
#
|
19662
19747
|
#
|
19663
19748
|
#
|
@@ -19679,9 +19764,9 @@ module Aws::SSM
|
|
19679
19764
|
# A list of explicitly rejected patches for the baseline.
|
19680
19765
|
#
|
19681
19766
|
# For information about accepted formats for lists of approved patches
|
19682
|
-
# and rejected patches, see [
|
19683
|
-
#
|
19684
|
-
#
|
19767
|
+
# and rejected patches, see [Package name formats for approved and
|
19768
|
+
# rejected patch lists][1] in the *Amazon Web Services Systems Manager
|
19769
|
+
# User Guide*.
|
19685
19770
|
#
|
19686
19771
|
#
|
19687
19772
|
#
|