aws-sdk-ssm 1.178.0 → 1.180.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.
- 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
|
#
|