aws-sdk-ssm 1.121.0 → 1.125.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 +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ssm/client.rb +278 -263
- data/lib/aws-sdk-ssm/client_api.rb +21 -0
- data/lib/aws-sdk-ssm/types.rb +585 -507
- data/lib/aws-sdk-ssm.rb +1 -1
- metadata +2 -2
data/lib/aws-sdk-ssm/types.rb
CHANGED
@@ -35,7 +35,7 @@ module Aws::SSM
|
|
35
35
|
# machines (VMs) with Amazon Web Services so that you can configure
|
36
36
|
# those servers or VMs using Run Command. A server or VM that has been
|
37
37
|
# registered with Amazon Web Services Systems Manager is called a
|
38
|
-
# managed
|
38
|
+
# managed node.
|
39
39
|
#
|
40
40
|
# @!attribute [rw] activation_id
|
41
41
|
# The ID created by Systems Manager when you submitted the activation.
|
@@ -46,27 +46,26 @@ module Aws::SSM
|
|
46
46
|
# @return [String]
|
47
47
|
#
|
48
48
|
# @!attribute [rw] default_instance_name
|
49
|
-
# A name for the managed
|
49
|
+
# A name for the managed node when it is created.
|
50
50
|
# @return [String]
|
51
51
|
#
|
52
52
|
# @!attribute [rw] iam_role
|
53
53
|
# The Identity and Access Management (IAM) role to assign to the
|
54
|
-
# managed
|
54
|
+
# managed node.
|
55
55
|
# @return [String]
|
56
56
|
#
|
57
57
|
# @!attribute [rw] registration_limit
|
58
|
-
# The maximum number of managed
|
58
|
+
# The maximum number of managed nodes that can be registered using
|
59
59
|
# this activation.
|
60
60
|
# @return [Integer]
|
61
61
|
#
|
62
62
|
# @!attribute [rw] registrations_count
|
63
|
-
# The number of managed
|
64
|
-
# activation.
|
63
|
+
# The number of managed nodes already registered with this activation.
|
65
64
|
# @return [Integer]
|
66
65
|
#
|
67
66
|
# @!attribute [rw] expiration_date
|
68
67
|
# The date when this activation can no longer be used to register
|
69
|
-
# managed
|
68
|
+
# managed nodes.
|
70
69
|
# @return [Time]
|
71
70
|
#
|
72
71
|
# @!attribute [rw] expired
|
@@ -116,9 +115,8 @@ module Aws::SSM
|
|
116
115
|
# Specifies the type of resource you are tagging.
|
117
116
|
#
|
118
117
|
# <note markdown="1"> The `ManagedInstance` type for this API operation is for on-premises
|
119
|
-
# managed
|
120
|
-
#
|
121
|
-
# `mi-1a2b3c4d5e6f`.
|
118
|
+
# managed nodes. You must specify the name of the managed node in the
|
119
|
+
# following format: `mi-ID_number `. For example, `mi-1a2b3c4d5e6f`.
|
122
120
|
#
|
123
121
|
# </note>
|
124
122
|
# @return [String]
|
@@ -147,9 +145,9 @@ module Aws::SSM
|
|
147
145
|
# `ManagedInstance`\: `mi-012345abcde`
|
148
146
|
#
|
149
147
|
# <note markdown="1"> The `ManagedInstance` type for this API operation is only for
|
150
|
-
# on-premises managed
|
151
|
-
#
|
152
|
-
#
|
148
|
+
# on-premises managed nodes. You must specify the name of the managed
|
149
|
+
# node in the following format: `mi-ID_number `. For example,
|
150
|
+
# `mi-1a2b3c4d5e6f`.
|
153
151
|
#
|
154
152
|
# </note>
|
155
153
|
# @return [String]
|
@@ -247,7 +245,7 @@ module Aws::SSM
|
|
247
245
|
include Aws::Structure
|
248
246
|
end
|
249
247
|
|
250
|
-
# You must disassociate a document from all
|
248
|
+
# You must disassociate a document from all managed nodes before you can
|
251
249
|
# delete it.
|
252
250
|
#
|
253
251
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociatedInstances AWS API Documentation
|
@@ -255,14 +253,14 @@ module Aws::SSM
|
|
255
253
|
class AssociatedInstances < Aws::EmptyStructure; end
|
256
254
|
|
257
255
|
# Describes an association of a Amazon Web Services Systems Manager
|
258
|
-
# document (SSM document) and
|
256
|
+
# document (SSM document) and a managed node.
|
259
257
|
#
|
260
258
|
# @!attribute [rw] name
|
261
259
|
# The name of the SSM document.
|
262
260
|
# @return [String]
|
263
261
|
#
|
264
262
|
# @!attribute [rw] instance_id
|
265
|
-
# The
|
263
|
+
# The managed node ID.
|
266
264
|
# @return [String]
|
267
265
|
#
|
268
266
|
# @!attribute [rw] association_id
|
@@ -280,9 +278,9 @@ module Aws::SSM
|
|
280
278
|
# @return [String]
|
281
279
|
#
|
282
280
|
# @!attribute [rw] targets
|
283
|
-
# The
|
284
|
-
# can target all
|
285
|
-
# specifying the `InstanceIds` key with a value of `*`.
|
281
|
+
# The managed nodes targeted by the request to create an association.
|
282
|
+
# You can target all managed nodes in an Amazon Web Services account
|
283
|
+
# by specifying the `InstanceIds` key with a value of `*`.
|
286
284
|
# @return [Array<Types::Target>]
|
287
285
|
#
|
288
286
|
# @!attribute [rw] last_execution_date
|
@@ -332,7 +330,7 @@ module Aws::SSM
|
|
332
330
|
# @return [String]
|
333
331
|
#
|
334
332
|
# @!attribute [rw] instance_id
|
335
|
-
# The
|
333
|
+
# The managed node ID.
|
336
334
|
# @return [String]
|
337
335
|
#
|
338
336
|
# @!attribute [rw] association_version
|
@@ -360,10 +358,10 @@ module Aws::SSM
|
|
360
358
|
# @return [String]
|
361
359
|
#
|
362
360
|
# @!attribute [rw] automation_target_parameter_name
|
363
|
-
#
|
364
|
-
#
|
365
|
-
#
|
366
|
-
# Services Systems Manager.
|
361
|
+
# Choose the parameter that will define how your automation will
|
362
|
+
# branch out. This target is required for associations that use an
|
363
|
+
# Automation runbook and target resources by using rate controls.
|
364
|
+
# Automation is a capability of Amazon Web Services Systems Manager.
|
367
365
|
# @return [String]
|
368
366
|
#
|
369
367
|
# @!attribute [rw] parameters
|
@@ -375,7 +373,7 @@ module Aws::SSM
|
|
375
373
|
# @return [String]
|
376
374
|
#
|
377
375
|
# @!attribute [rw] targets
|
378
|
-
# The
|
376
|
+
# The managed nodes targeted by the request.
|
379
377
|
# @return [Array<Types::Target>]
|
380
378
|
#
|
381
379
|
# @!attribute [rw] schedule_expression
|
@@ -408,7 +406,7 @@ module Aws::SSM
|
|
408
406
|
# for example, the system stops sending requests when the fourth error
|
409
407
|
# is received. If you specify 0, then the system stops sending
|
410
408
|
# requests after the first error is returned. If you run an
|
411
|
-
# association on 50
|
409
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
412
410
|
# system stops sending the request when the sixth error is received.
|
413
411
|
#
|
414
412
|
# Executions that are already running an association when `MaxErrors`
|
@@ -424,10 +422,10 @@ module Aws::SSM
|
|
424
422
|
# of the target set, for example 10%. The default value is 100%, which
|
425
423
|
# means all targets run the association at the same time.
|
426
424
|
#
|
427
|
-
# If a new
|
428
|
-
# Systems Manager is running `MaxConcurrency` associations, the
|
425
|
+
# If a new managed node starts and attempts to run an association
|
426
|
+
# while Systems Manager is running `MaxConcurrency` associations, the
|
429
427
|
# association is allowed to run. During the next association interval,
|
430
|
-
# the new
|
428
|
+
# the new managed node will process its association within the limit
|
431
429
|
# specified for `MaxConcurrency`.
|
432
430
|
# @return [String]
|
433
431
|
#
|
@@ -503,7 +501,7 @@ module Aws::SSM
|
|
503
501
|
:apply_only_at_cron_interval,
|
504
502
|
:calendar_names,
|
505
503
|
:target_locations)
|
506
|
-
SENSITIVE = []
|
504
|
+
SENSITIVE = [:parameters]
|
507
505
|
include Aws::Structure
|
508
506
|
end
|
509
507
|
|
@@ -632,12 +630,12 @@ module Aws::SSM
|
|
632
630
|
# @return [String]
|
633
631
|
#
|
634
632
|
# @!attribute [rw] resource_id
|
635
|
-
# The resource ID, for example, the
|
636
|
-
# ran.
|
633
|
+
# The resource ID, for example, the managed node ID where the
|
634
|
+
# association ran.
|
637
635
|
# @return [String]
|
638
636
|
#
|
639
637
|
# @!attribute [rw] resource_type
|
640
|
-
# The resource type, for example,
|
638
|
+
# The resource type, for example, EC2.
|
641
639
|
# @return [String]
|
642
640
|
#
|
643
641
|
# @!attribute [rw] status
|
@@ -749,9 +747,9 @@ module Aws::SSM
|
|
749
747
|
#
|
750
748
|
# @!attribute [rw] association_status_aggregated_count
|
751
749
|
# Returns the number of targets for the association status. For
|
752
|
-
# example, if you created an association with two
|
753
|
-
# of them was successful, this would return the count of
|
754
|
-
# status.
|
750
|
+
# example, if you created an association with two managed nodes, and
|
751
|
+
# one of them was successful, this would return the count of managed
|
752
|
+
# nodes by status.
|
755
753
|
# @return [Hash<String,Integer>]
|
756
754
|
#
|
757
755
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociationOverview AWS API Documentation
|
@@ -858,7 +856,7 @@ module Aws::SSM
|
|
858
856
|
# for example, the system stops sending requests when the fourth error
|
859
857
|
# is received. If you specify 0, then the system stops sending
|
860
858
|
# requests after the first error is returned. If you run an
|
861
|
-
# association on 50
|
859
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
862
860
|
# system stops sending the request when the sixth error is received.
|
863
861
|
#
|
864
862
|
# Executions that are already running an association when `MaxErrors`
|
@@ -874,10 +872,10 @@ module Aws::SSM
|
|
874
872
|
# of the target set, for example 10%. The default value is 100%, which
|
875
873
|
# means all targets run the association at the same time.
|
876
874
|
#
|
877
|
-
# If a new
|
878
|
-
# Systems Manager is running `MaxConcurrency` associations, the
|
875
|
+
# If a new managed node starts and attempts to run an association
|
876
|
+
# while Systems Manager is running `MaxConcurrency` associations, the
|
879
877
|
# association is allowed to run. During the next association interval,
|
880
|
-
# the new
|
878
|
+
# the new managed node will process its association within the limit
|
881
879
|
# specified for `MaxConcurrency`.
|
882
880
|
# @return [String]
|
883
881
|
#
|
@@ -948,7 +946,7 @@ module Aws::SSM
|
|
948
946
|
:apply_only_at_cron_interval,
|
949
947
|
:calendar_names,
|
950
948
|
:target_locations)
|
951
|
-
SENSITIVE = []
|
949
|
+
SENSITIVE = [:parameters]
|
952
950
|
include Aws::Structure
|
953
951
|
end
|
954
952
|
|
@@ -1556,7 +1554,7 @@ module Aws::SSM
|
|
1556
1554
|
# data as a hash:
|
1557
1555
|
#
|
1558
1556
|
# {
|
1559
|
-
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
1557
|
+
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
|
1560
1558
|
# global_filters: {
|
1561
1559
|
# patch_filters: [ # required
|
1562
1560
|
# {
|
@@ -1650,14 +1648,14 @@ module Aws::SSM
|
|
1650
1648
|
#
|
1651
1649
|
# @!attribute [rw] approved_patches_enable_non_security
|
1652
1650
|
# Indicates whether the list of approved patches includes non-security
|
1653
|
-
# updates that should be applied to the
|
1654
|
-
# is `false`. Applies to Linux
|
1651
|
+
# updates that should be applied to the managed nodes. The default
|
1652
|
+
# value is `false`. Applies to Linux managed nodes only.
|
1655
1653
|
# @return [Boolean]
|
1656
1654
|
#
|
1657
1655
|
# @!attribute [rw] sources
|
1658
|
-
# Information about the patches to use to update the
|
1656
|
+
# Information about the patches to use to update the managed nodes,
|
1659
1657
|
# including target operating systems and source repositories. Applies
|
1660
|
-
# to Linux
|
1658
|
+
# to Linux managed nodes only.
|
1661
1659
|
# @return [Array<Types::PatchSource>]
|
1662
1660
|
#
|
1663
1661
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/BaselineOverride AWS API Documentation
|
@@ -1689,8 +1687,8 @@ module Aws::SSM
|
|
1689
1687
|
# @return [String]
|
1690
1688
|
#
|
1691
1689
|
# @!attribute [rw] instance_ids
|
1692
|
-
# (Optional) A list of
|
1693
|
-
# command. If not provided, the command is canceled on every
|
1690
|
+
# (Optional) A list of managed node IDs on which you want to cancel
|
1691
|
+
# the command. If not provided, the command is canceled on every node
|
1694
1692
|
# on which it was requested.
|
1695
1693
|
# @return [Array<String>]
|
1696
1694
|
#
|
@@ -1805,13 +1803,13 @@ module Aws::SSM
|
|
1805
1803
|
# @return [Hash<String,Array<String>>]
|
1806
1804
|
#
|
1807
1805
|
# @!attribute [rw] instance_ids
|
1808
|
-
# The
|
1806
|
+
# The managed node IDs against which this command was requested.
|
1809
1807
|
# @return [Array<String>]
|
1810
1808
|
#
|
1811
1809
|
# @!attribute [rw] targets
|
1812
|
-
# An array of search criteria that targets
|
1813
|
-
# combination that you specify. Targets is required if you
|
1814
|
-
# provide one or more
|
1810
|
+
# An array of search criteria that targets managed nodes using a
|
1811
|
+
# Key,Value combination that you specify. Targets is required if you
|
1812
|
+
# don't provide one or more managed node IDs in the call.
|
1815
1813
|
# @return [Array<Types::Target>]
|
1816
1814
|
#
|
1817
1815
|
# @!attribute [rw] requested_date_time
|
@@ -1831,10 +1829,10 @@ module Aws::SSM
|
|
1831
1829
|
# Services Systems Manager User Guide*. StatusDetails can be one of
|
1832
1830
|
# the following values:
|
1833
1831
|
#
|
1834
|
-
# * Pending: The command hasn't been sent to any
|
1832
|
+
# * Pending: The command hasn't been sent to any managed nodes.
|
1835
1833
|
#
|
1836
|
-
# * In Progress: The command has been sent to at least one
|
1837
|
-
# but hasn't reached a final state on all
|
1834
|
+
# * In Progress: The command has been sent to at least one managed
|
1835
|
+
# node but hasn't reached a final state on all managed nodes.
|
1838
1836
|
#
|
1839
1837
|
# * Success: The command successfully ran on all invocations. This is
|
1840
1838
|
# a terminal state.
|
@@ -1850,18 +1848,18 @@ module Aws::SSM
|
|
1850
1848
|
# * Failed: The value of MaxErrors or more command invocations shows a
|
1851
1849
|
# status of Failed. This is a terminal state.
|
1852
1850
|
#
|
1853
|
-
# * Incomplete: The command was attempted on all
|
1854
|
-
# more invocations doesn't have a value of Success but not
|
1855
|
-
# invocations failed for the status to be Failed. This is a
|
1856
|
-
# state.
|
1851
|
+
# * Incomplete: The command was attempted on all managed nodes and one
|
1852
|
+
# or more invocations doesn't have a value of Success but not
|
1853
|
+
# enough invocations failed for the status to be Failed. This is a
|
1854
|
+
# terminal state.
|
1857
1855
|
#
|
1858
1856
|
# * Canceled: The command was terminated before it was completed. This
|
1859
1857
|
# is a terminal state.
|
1860
1858
|
#
|
1861
|
-
# * Rate Exceeded: The number of
|
1859
|
+
# * Rate Exceeded: The number of managed nodes targeted by the command
|
1862
1860
|
# exceeded the account limit for pending invocations. The system has
|
1863
|
-
# canceled the command before running it on any
|
1864
|
-
# terminal state.
|
1861
|
+
# canceled the command before running it on any managed node. This
|
1862
|
+
# is a terminal state.
|
1865
1863
|
#
|
1866
1864
|
#
|
1867
1865
|
#
|
@@ -1886,12 +1884,12 @@ module Aws::SSM
|
|
1886
1884
|
# @return [String]
|
1887
1885
|
#
|
1888
1886
|
# @!attribute [rw] max_concurrency
|
1889
|
-
# The maximum number of
|
1890
|
-
# at the same time. You can specify a number of
|
1891
|
-
# or a percentage of
|
1892
|
-
# For more information about how to use `MaxConcurrency`, see
|
1893
|
-
# commands using Systems Manager Run Command][1] in the
|
1894
|
-
# Services Systems Manager User Guide*.
|
1887
|
+
# The maximum number of managed nodes that are allowed to run the
|
1888
|
+
# command at the same time. You can specify a number of managed nodes,
|
1889
|
+
# such as 10, or a percentage of nodes, such as 10%. The default value
|
1890
|
+
# is 50. For more information about how to use `MaxConcurrency`, see
|
1891
|
+
# [Running commands using Systems Manager Run Command][1] in the
|
1892
|
+
# *Amazon Web Services Systems Manager User Guide*.
|
1895
1893
|
#
|
1896
1894
|
#
|
1897
1895
|
#
|
@@ -1979,14 +1977,14 @@ module Aws::SSM
|
|
1979
1977
|
:notification_config,
|
1980
1978
|
:cloud_watch_output_config,
|
1981
1979
|
:timeout_seconds)
|
1982
|
-
SENSITIVE = []
|
1980
|
+
SENSITIVE = [:parameters]
|
1983
1981
|
include Aws::Structure
|
1984
1982
|
end
|
1985
1983
|
|
1986
1984
|
# Describes a command filter.
|
1987
1985
|
#
|
1988
|
-
# <note markdown="1">
|
1989
|
-
# because the command hasn't run on the
|
1986
|
+
# <note markdown="1"> A managed node ID can't be specified when a command status is
|
1987
|
+
# `Pending` because the command hasn't run on the node yet.
|
1990
1988
|
#
|
1991
1989
|
# </note>
|
1992
1990
|
#
|
@@ -2000,6 +1998,11 @@ module Aws::SSM
|
|
2000
1998
|
#
|
2001
1999
|
# @!attribute [rw] key
|
2002
2000
|
# The name of the filter.
|
2001
|
+
#
|
2002
|
+
# <note markdown="1"> The `ExecutionStage` filter can't be used with the
|
2003
|
+
# `ListCommandInvocations` operation, only with `ListCommands`.
|
2004
|
+
#
|
2005
|
+
# </note>
|
2003
2006
|
# @return [String]
|
2004
2007
|
#
|
2005
2008
|
# @!attribute [rw] value
|
@@ -2076,9 +2079,10 @@ module Aws::SSM
|
|
2076
2079
|
# Manager document (SSM document) for which you want to see command
|
2077
2080
|
# execution results. For example, specify `AWS-RunPatchBaseline` to
|
2078
2081
|
# see command executions that used this SSM document to perform
|
2079
|
-
# security patching operations on
|
2082
|
+
# security patching operations on managed nodes.
|
2080
2083
|
#
|
2081
|
-
# * **ExecutionStage**\: Specify one of the following values
|
2084
|
+
# * **ExecutionStage**\: Specify one of the following values
|
2085
|
+
# (`ListCommands` operations only):
|
2082
2086
|
#
|
2083
2087
|
# * `Executing`\: Returns a list of command executions that are
|
2084
2088
|
# currently still running.
|
@@ -2096,23 +2100,23 @@ module Aws::SSM
|
|
2096
2100
|
include Aws::Structure
|
2097
2101
|
end
|
2098
2102
|
|
2099
|
-
# An invocation is copy of a command sent to a specific
|
2100
|
-
# command can apply to one or more
|
2101
|
-
# applies to one
|
2102
|
-
# against three
|
2103
|
-
# requested
|
2104
|
-
# information about a command you ran.
|
2103
|
+
# An invocation is a copy of a command sent to a specific managed node.
|
2104
|
+
# A command can apply to one or more managed nodes. A command invocation
|
2105
|
+
# applies to one managed node. For example, if a user runs `SendCommand`
|
2106
|
+
# against three managed nodes, then a command invocation is created for
|
2107
|
+
# each requested managed node ID. A command invocation returns status
|
2108
|
+
# and detail information about a command you ran.
|
2105
2109
|
#
|
2106
2110
|
# @!attribute [rw] command_id
|
2107
2111
|
# The command against which this invocation was requested.
|
2108
2112
|
# @return [String]
|
2109
2113
|
#
|
2110
2114
|
# @!attribute [rw] instance_id
|
2111
|
-
# The
|
2115
|
+
# The managed node ID in which this invocation was requested.
|
2112
2116
|
# @return [String]
|
2113
2117
|
#
|
2114
2118
|
# @!attribute [rw] instance_name
|
2115
|
-
# The fully qualified host name of the managed
|
2119
|
+
# The fully qualified host name of the managed node.
|
2116
2120
|
# @return [String]
|
2117
2121
|
#
|
2118
2122
|
# @!attribute [rw] comment
|
@@ -2129,7 +2133,7 @@ module Aws::SSM
|
|
2129
2133
|
# @return [String]
|
2130
2134
|
#
|
2131
2135
|
# @!attribute [rw] requested_date_time
|
2132
|
-
# The time and date the request was sent to this
|
2136
|
+
# The time and date the request was sent to this managed node.
|
2133
2137
|
# @return [Time]
|
2134
2138
|
#
|
2135
2139
|
# @!attribute [rw] status
|
@@ -2138,7 +2142,7 @@ module Aws::SSM
|
|
2138
2142
|
#
|
2139
2143
|
# @!attribute [rw] status_details
|
2140
2144
|
# A detailed status of the command execution for each invocation (each
|
2141
|
-
#
|
2145
|
+
# managed node targeted by the command). StatusDetails includes more
|
2142
2146
|
# information than Status because it includes states resulting from
|
2143
2147
|
# error and concurrency control parameters. StatusDetails can show
|
2144
2148
|
# different results than Status. For more information about these
|
@@ -2146,26 +2150,26 @@ module Aws::SSM
|
|
2146
2150
|
# Services Systems Manager User Guide*. StatusDetails can be one of
|
2147
2151
|
# the following values:
|
2148
2152
|
#
|
2149
|
-
# * Pending: The command hasn't been sent to the
|
2153
|
+
# * Pending: The command hasn't been sent to the managed node.
|
2150
2154
|
#
|
2151
|
-
# * In Progress: The command has been sent to the
|
2152
|
-
# reached a terminal state.
|
2155
|
+
# * In Progress: The command has been sent to the managed node but
|
2156
|
+
# hasn't reached a terminal state.
|
2153
2157
|
#
|
2154
2158
|
# * Success: The execution of the command or plugin was successfully
|
2155
2159
|
# completed. This is a terminal state.
|
2156
2160
|
#
|
2157
|
-
# * Delivery Timed Out: The command wasn't delivered to the
|
2158
|
-
# before the delivery timeout expired. Delivery timeouts don't
|
2161
|
+
# * Delivery Timed Out: The command wasn't delivered to the managed
|
2162
|
+
# node before the delivery timeout expired. Delivery timeouts don't
|
2159
2163
|
# count against the parent command's `MaxErrors` limit, but they do
|
2160
2164
|
# contribute to whether the parent command status is Success or
|
2161
2165
|
# Incomplete. This is a terminal state.
|
2162
2166
|
#
|
2163
|
-
# * Execution Timed Out: Command execution started on the
|
2164
|
-
# but the execution wasn't complete before the execution
|
2165
|
-
# expired. Execution timeouts count against the `MaxErrors`
|
2166
|
-
# the parent command. This is a terminal state.
|
2167
|
+
# * Execution Timed Out: Command execution started on the managed
|
2168
|
+
# node, but the execution wasn't complete before the execution
|
2169
|
+
# timeout expired. Execution timeouts count against the `MaxErrors`
|
2170
|
+
# limit of the parent command. This is a terminal state.
|
2167
2171
|
#
|
2168
|
-
# * Failed: The command wasn't successful on the
|
2172
|
+
# * Failed: The command wasn't successful on the managed node. For a
|
2169
2173
|
# plugin, this indicates that the result code wasn't zero. For a
|
2170
2174
|
# command invocation, this indicates that the result code for one or
|
2171
2175
|
# more plugins wasn't zero. Invocation failures count against the
|
@@ -2174,8 +2178,8 @@ module Aws::SSM
|
|
2174
2178
|
# * Canceled: The command was terminated before it was completed. This
|
2175
2179
|
# is a terminal state.
|
2176
2180
|
#
|
2177
|
-
# * Undeliverable: The command can't be delivered to the
|
2178
|
-
# The
|
2181
|
+
# * Undeliverable: The command can't be delivered to the managed
|
2182
|
+
# node. The managed node might not exist or might not be responding.
|
2179
2183
|
# Undeliverable invocations don't count against the parent
|
2180
2184
|
# command's MaxErrors limit and don't contribute to whether the
|
2181
2185
|
# parent command status is Success or Incomplete. This is a terminal
|
@@ -2218,12 +2222,12 @@ module Aws::SSM
|
|
2218
2222
|
# The Identity and Access Management (IAM) service role that Run
|
2219
2223
|
# Command, a capability of Amazon Web Services Systems Manager, uses
|
2220
2224
|
# to act on your behalf when sending notifications about command
|
2221
|
-
# status changes on a per
|
2225
|
+
# status changes on a per managed node basis.
|
2222
2226
|
# @return [String]
|
2223
2227
|
#
|
2224
2228
|
# @!attribute [rw] notification_config
|
2225
2229
|
# Configurations for sending notifications about command status
|
2226
|
-
# changes on a per
|
2230
|
+
# changes on a per managed node basis.
|
2227
2231
|
# @return [Types::NotificationConfig]
|
2228
2232
|
#
|
2229
2233
|
# @!attribute [rw] cloud_watch_output_config
|
@@ -2277,26 +2281,26 @@ module Aws::SSM
|
|
2277
2281
|
# Services Systems Manager User Guide*. StatusDetails can be one of
|
2278
2282
|
# the following values:
|
2279
2283
|
#
|
2280
|
-
# * Pending: The command hasn't been sent to the
|
2284
|
+
# * Pending: The command hasn't been sent to the managed node.
|
2281
2285
|
#
|
2282
|
-
# * In Progress: The command has been sent to the
|
2283
|
-
# reached a terminal state.
|
2286
|
+
# * In Progress: The command has been sent to the managed node but
|
2287
|
+
# hasn't reached a terminal state.
|
2284
2288
|
#
|
2285
2289
|
# * Success: The execution of the command or plugin was successfully
|
2286
2290
|
# completed. This is a terminal state.
|
2287
2291
|
#
|
2288
|
-
# * Delivery Timed Out: The command wasn't delivered to the
|
2289
|
-
# before the delivery timeout expired. Delivery timeouts don't
|
2292
|
+
# * Delivery Timed Out: The command wasn't delivered to the managed
|
2293
|
+
# node before the delivery timeout expired. Delivery timeouts don't
|
2290
2294
|
# count against the parent command's `MaxErrors` limit, but they do
|
2291
2295
|
# contribute to whether the parent command status is Success or
|
2292
2296
|
# Incomplete. This is a terminal state.
|
2293
2297
|
#
|
2294
|
-
# * Execution Timed Out: Command execution started on the
|
2295
|
-
# but the execution wasn't complete before the execution
|
2296
|
-
# expired. Execution timeouts count against the `MaxErrors`
|
2297
|
-
# the parent command. This is a terminal state.
|
2298
|
+
# * Execution Timed Out: Command execution started on the managed
|
2299
|
+
# node, but the execution wasn't complete before the execution
|
2300
|
+
# timeout expired. Execution timeouts count against the `MaxErrors`
|
2301
|
+
# limit of the parent command. This is a terminal state.
|
2298
2302
|
#
|
2299
|
-
# * Failed: The command wasn't successful on the
|
2303
|
+
# * Failed: The command wasn't successful on the managed node. For a
|
2300
2304
|
# plugin, this indicates that the result code wasn't zero. For a
|
2301
2305
|
# command invocation, this indicates that the result code for one or
|
2302
2306
|
# more plugins wasn't zero. Invocation failures count against the
|
@@ -2305,12 +2309,12 @@ module Aws::SSM
|
|
2305
2309
|
# * Canceled: The command was terminated before it was completed. This
|
2306
2310
|
# is a terminal state.
|
2307
2311
|
#
|
2308
|
-
# * Undeliverable: The command can't be delivered to the
|
2309
|
-
# The
|
2310
|
-
# Undeliverable invocations don't count against the
|
2311
|
-
# command's MaxErrors limit, and they don't contribute to
|
2312
|
-
# the parent command status is Success or Incomplete. This
|
2313
|
-
# terminal state.
|
2312
|
+
# * Undeliverable: The command can't be delivered to the managed
|
2313
|
+
# node. The managed node might not exist, or it might not be
|
2314
|
+
# responding. Undeliverable invocations don't count against the
|
2315
|
+
# parent command's MaxErrors limit, and they don't contribute to
|
2316
|
+
# whether the parent command status is Success or Incomplete. This
|
2317
|
+
# is a terminal state.
|
2314
2318
|
#
|
2315
2319
|
# * Terminated: The parent command exceeded its MaxErrors limit and
|
2316
2320
|
# subsequent command invocations were canceled by the system. This
|
@@ -2367,7 +2371,7 @@ module Aws::SSM
|
|
2367
2371
|
# `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
|
2368
2372
|
# prefix;
|
2369
2373
|
#
|
2370
|
-
# `i-02573cafcfEXAMPLE` is the
|
2374
|
+
# `i-02573cafcfEXAMPLE` is the managed node ID;
|
2371
2375
|
#
|
2372
2376
|
# `awsrunShellScript` is the name of the plugin.
|
2373
2377
|
# @return [String]
|
@@ -2384,7 +2388,7 @@ module Aws::SSM
|
|
2384
2388
|
# `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
|
2385
2389
|
# prefix;
|
2386
2390
|
#
|
2387
|
-
# `i-02573cafcfEXAMPLE` is the
|
2391
|
+
# `i-02573cafcfEXAMPLE` is the managed node ID;
|
2388
2392
|
#
|
2389
2393
|
# `awsrunShellScript` is the name of the plugin.
|
2390
2394
|
# @return [String]
|
@@ -2464,8 +2468,7 @@ module Aws::SSM
|
|
2464
2468
|
# @return [String]
|
2465
2469
|
#
|
2466
2470
|
# @!attribute [rw] resource_id
|
2467
|
-
# An ID for the resource. For a managed
|
2468
|
-
# ID.
|
2471
|
+
# An ID for the resource. For a managed node, this is the node ID.
|
2469
2472
|
# @return [String]
|
2470
2473
|
#
|
2471
2474
|
# @!attribute [rw] id
|
@@ -2680,6 +2683,12 @@ module Aws::SSM
|
|
2680
2683
|
# value: "TagValue", # required
|
2681
2684
|
# },
|
2682
2685
|
# ],
|
2686
|
+
# registration_metadata: [
|
2687
|
+
# {
|
2688
|
+
# key: "RegistrationMetadataKey", # required
|
2689
|
+
# value: "RegistrationMetadataValue", # required
|
2690
|
+
# },
|
2691
|
+
# ],
|
2683
2692
|
# }
|
2684
2693
|
#
|
2685
2694
|
# @!attribute [rw] description
|
@@ -2690,8 +2699,8 @@ module Aws::SSM
|
|
2690
2699
|
# @return [String]
|
2691
2700
|
#
|
2692
2701
|
# @!attribute [rw] default_instance_name
|
2693
|
-
# The name of the registered, managed
|
2694
|
-
#
|
2702
|
+
# The name of the registered, managed node as it will appear in the
|
2703
|
+
# Amazon Web Services Systems Manager console or when you use the
|
2695
2704
|
# Amazon Web Services command line tools to list Systems Manager
|
2696
2705
|
# resources.
|
2697
2706
|
#
|
@@ -2700,7 +2709,7 @@ module Aws::SSM
|
|
2700
2709
|
#
|
2701
2710
|
# @!attribute [rw] iam_role
|
2702
2711
|
# The name of the Identity and Access Management (IAM) role that you
|
2703
|
-
# want to assign to the managed
|
2712
|
+
# want to assign to the managed node. This IAM role must provide
|
2704
2713
|
# AssumeRole permissions for the Amazon Web Services Systems Manager
|
2705
2714
|
# service principal `ssm.amazonaws.com`. For more information, see
|
2706
2715
|
# [Create an IAM service role for a hybrid environment][1] in the
|
@@ -2712,8 +2721,8 @@ module Aws::SSM
|
|
2712
2721
|
# @return [String]
|
2713
2722
|
#
|
2714
2723
|
# @!attribute [rw] registration_limit
|
2715
|
-
# Specify the maximum number of managed
|
2716
|
-
#
|
2724
|
+
# Specify the maximum number of managed nodes you want to register.
|
2725
|
+
# The default value is `1`.
|
2717
2726
|
# @return [Integer]
|
2718
2727
|
#
|
2719
2728
|
# @!attribute [rw] expiration_date
|
@@ -2741,15 +2750,19 @@ module Aws::SSM
|
|
2741
2750
|
# applied to the on-premises servers or VMs.
|
2742
2751
|
#
|
2743
2752
|
# You can't add tags to or delete tags from an existing activation.
|
2744
|
-
# You can tag your on-premises servers and VMs after
|
2745
|
-
# Systems Manager for the first time and are assigned
|
2746
|
-
#
|
2747
|
-
# Systems Manager console with an ID that is prefixed with
|
2748
|
-
# For information about how to add tags to your managed
|
2749
|
-
# AddTagsToResource. For information about how to remove
|
2750
|
-
# your managed
|
2753
|
+
# You can tag your on-premises servers, edge devices, and VMs after
|
2754
|
+
# they connect to Systems Manager for the first time and are assigned
|
2755
|
+
# a managed node ID. This means they are listed in the Amazon Web
|
2756
|
+
# Services Systems Manager console with an ID that is prefixed with
|
2757
|
+
# "mi-". For information about how to add tags to your managed
|
2758
|
+
# nodes, see AddTagsToResource. For information about how to remove
|
2759
|
+
# tags from your managed nodes, see RemoveTagsFromResource.
|
2751
2760
|
# @return [Array<Types::Tag>]
|
2752
2761
|
#
|
2762
|
+
# @!attribute [rw] registration_metadata
|
2763
|
+
# Reserved for internal use.
|
2764
|
+
# @return [Array<Types::RegistrationMetadataItem>]
|
2765
|
+
#
|
2753
2766
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateActivationRequest AWS API Documentation
|
2754
2767
|
#
|
2755
2768
|
class CreateActivationRequest < Struct.new(
|
@@ -2758,7 +2771,8 @@ module Aws::SSM
|
|
2758
2771
|
:iam_role,
|
2759
2772
|
:registration_limit,
|
2760
2773
|
:expiration_date,
|
2761
|
-
:tags
|
2774
|
+
:tags,
|
2775
|
+
:registration_metadata)
|
2762
2776
|
SENSITIVE = []
|
2763
2777
|
include Aws::Structure
|
2764
2778
|
end
|
@@ -2843,7 +2857,7 @@ module Aws::SSM
|
|
2843
2857
|
end
|
2844
2858
|
|
2845
2859
|
# Describes the association of a Amazon Web Services Systems Manager
|
2846
|
-
# document (SSM document) and
|
2860
|
+
# document (SSM document) and a managed node.
|
2847
2861
|
#
|
2848
2862
|
# @note When making an API call, you may pass CreateAssociationBatchRequestEntry
|
2849
2863
|
# data as a hash:
|
@@ -2890,8 +2904,8 @@ module Aws::SSM
|
|
2890
2904
|
#
|
2891
2905
|
# @!attribute [rw] name
|
2892
2906
|
# The name of the SSM document that contains the configuration
|
2893
|
-
# information for the
|
2894
|
-
# runbooks.
|
2907
|
+
# information for the managed node. You can specify Command or
|
2908
|
+
# Automation runbooks.
|
2895
2909
|
#
|
2896
2910
|
# You can specify Amazon Web Services-predefined documents, documents
|
2897
2911
|
# you created, or a document that is shared with you from another
|
@@ -2913,11 +2927,11 @@ module Aws::SSM
|
|
2913
2927
|
# @return [String]
|
2914
2928
|
#
|
2915
2929
|
# @!attribute [rw] instance_id
|
2916
|
-
# The
|
2930
|
+
# The managed node ID.
|
2917
2931
|
#
|
2918
|
-
# <note markdown="1"> `InstanceId` has been deprecated. To specify
|
2919
|
-
# association, use the `Targets` parameter. Requests that include
|
2920
|
-
# parameter `InstanceID` with Systems Manager documents (SSM
|
2932
|
+
# <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for
|
2933
|
+
# an association, use the `Targets` parameter. Requests that include
|
2934
|
+
# the parameter `InstanceID` with Systems Manager documents (SSM
|
2921
2935
|
# documents) that use schema version 2.0 or later will fail. In
|
2922
2936
|
# addition, if you use the parameter `InstanceId`, you can't use the
|
2923
2937
|
# parameters `AssociationName`, `DocumentVersion`, `MaxErrors`,
|
@@ -2943,7 +2957,7 @@ module Aws::SSM
|
|
2943
2957
|
# @return [String]
|
2944
2958
|
#
|
2945
2959
|
# @!attribute [rw] targets
|
2946
|
-
# The
|
2960
|
+
# The managed nodes targeted by the request.
|
2947
2961
|
# @return [Array<Types::Target>]
|
2948
2962
|
#
|
2949
2963
|
# @!attribute [rw] schedule_expression
|
@@ -2967,7 +2981,7 @@ module Aws::SSM
|
|
2967
2981
|
# for example, the system stops sending requests when the fourth error
|
2968
2982
|
# is received. If you specify 0, then the system stops sending
|
2969
2983
|
# requests after the first error is returned. If you run an
|
2970
|
-
# association on 50
|
2984
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
2971
2985
|
# system stops sending the request when the sixth error is received.
|
2972
2986
|
#
|
2973
2987
|
# Executions that are already running an association when `MaxErrors`
|
@@ -2983,10 +2997,10 @@ module Aws::SSM
|
|
2983
2997
|
# of the target set, for example 10%. The default value is 100%, which
|
2984
2998
|
# means all targets run the association at the same time.
|
2985
2999
|
#
|
2986
|
-
# If a new
|
2987
|
-
# Systems Manager is running `MaxConcurrency` associations, the
|
3000
|
+
# If a new managed node starts and attempts to run an association
|
3001
|
+
# while Systems Manager is running `MaxConcurrency` associations, the
|
2988
3002
|
# association is allowed to run. During the next association interval,
|
2989
|
-
# the new
|
3003
|
+
# the new managed node will process its association within the limit
|
2990
3004
|
# specified for `MaxConcurrency`.
|
2991
3005
|
# @return [String]
|
2992
3006
|
#
|
@@ -3054,7 +3068,7 @@ module Aws::SSM
|
|
3054
3068
|
:apply_only_at_cron_interval,
|
3055
3069
|
:calendar_names,
|
3056
3070
|
:target_locations)
|
3057
|
-
SENSITIVE = []
|
3071
|
+
SENSITIVE = [:parameters]
|
3058
3072
|
include Aws::Structure
|
3059
3073
|
end
|
3060
3074
|
|
@@ -3120,7 +3134,7 @@ module Aws::SSM
|
|
3120
3134
|
#
|
3121
3135
|
# @!attribute [rw] name
|
3122
3136
|
# The name of the SSM Command document or Automation runbook that
|
3123
|
-
# contains the configuration information for the
|
3137
|
+
# contains the configuration information for the managed node.
|
3124
3138
|
#
|
3125
3139
|
# You can specify Amazon Web Services-predefined documents, documents
|
3126
3140
|
# you created, or a document that is shared with you from another
|
@@ -3147,11 +3161,11 @@ module Aws::SSM
|
|
3147
3161
|
# @return [String]
|
3148
3162
|
#
|
3149
3163
|
# @!attribute [rw] instance_id
|
3150
|
-
# The
|
3164
|
+
# The managed node ID.
|
3151
3165
|
#
|
3152
|
-
# <note markdown="1"> `InstanceId` has been deprecated. To specify
|
3153
|
-
# association, use the `Targets` parameter. Requests that include
|
3154
|
-
# parameter `InstanceID` with Systems Manager documents (SSM
|
3166
|
+
# <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for
|
3167
|
+
# an association, use the `Targets` parameter. Requests that include
|
3168
|
+
# the parameter `InstanceID` with Systems Manager documents (SSM
|
3155
3169
|
# documents) that use schema version 2.0 or later will fail. In
|
3156
3170
|
# addition, if you use the parameter `InstanceId`, you can't use the
|
3157
3171
|
# parameters `AssociationName`, `DocumentVersion`, `MaxErrors`,
|
@@ -3166,14 +3180,14 @@ module Aws::SSM
|
|
3166
3180
|
# @return [Hash<String,Array<String>>]
|
3167
3181
|
#
|
3168
3182
|
# @!attribute [rw] targets
|
3169
|
-
# The targets for the association. You can target
|
3170
|
-
# tags, Amazon Web Services resource groups, all
|
3171
|
-
# Amazon Web Services account, or individual
|
3172
|
-
# target all
|
3173
|
-
# the `InstanceIds` key with a value of `*`. For more
|
3174
|
-
# about choosing targets for an association, see [Using
|
3175
|
-
# rate controls with State Manager associations][1] in the
|
3176
|
-
# Services Systems Manager User Guide*.
|
3183
|
+
# The targets for the association. You can target managed nodes by
|
3184
|
+
# using tags, Amazon Web Services resource groups, all managed nodes
|
3185
|
+
# in an Amazon Web Services account, or individual managed node IDs.
|
3186
|
+
# You can target all managed nodes in an Amazon Web Services account
|
3187
|
+
# by specifying the `InstanceIds` key with a value of `*`. For more
|
3188
|
+
# information about choosing targets for an association, see [Using
|
3189
|
+
# targets and rate controls with State Manager associations][1] in the
|
3190
|
+
# *Amazon Web Services Systems Manager User Guide*.
|
3177
3191
|
#
|
3178
3192
|
#
|
3179
3193
|
#
|
@@ -3195,10 +3209,10 @@ module Aws::SSM
|
|
3195
3209
|
# @return [String]
|
3196
3210
|
#
|
3197
3211
|
# @!attribute [rw] automation_target_parameter_name
|
3198
|
-
#
|
3199
|
-
#
|
3200
|
-
#
|
3201
|
-
# Services Systems Manager.
|
3212
|
+
# Choose the parameter that will define how your automation will
|
3213
|
+
# branch out. This target is required for associations that use an
|
3214
|
+
# Automation runbook and target resources by using rate controls.
|
3215
|
+
# Automation is a capability of Amazon Web Services Systems Manager.
|
3202
3216
|
# @return [String]
|
3203
3217
|
#
|
3204
3218
|
# @!attribute [rw] max_errors
|
@@ -3209,7 +3223,7 @@ module Aws::SSM
|
|
3209
3223
|
# for example, the system stops sending requests when the fourth error
|
3210
3224
|
# is received. If you specify 0, then the system stops sending
|
3211
3225
|
# requests after the first error is returned. If you run an
|
3212
|
-
# association on 50
|
3226
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
3213
3227
|
# system stops sending the request when the sixth error is received.
|
3214
3228
|
#
|
3215
3229
|
# Executions that are already running an association when `MaxErrors`
|
@@ -3225,10 +3239,10 @@ module Aws::SSM
|
|
3225
3239
|
# of the target set, for example 10%. The default value is 100%, which
|
3226
3240
|
# means all targets run the association at the same time.
|
3227
3241
|
#
|
3228
|
-
# If a new
|
3229
|
-
# Systems Manager is running `MaxConcurrency` associations, the
|
3242
|
+
# If a new managed node starts and attempts to run an association
|
3243
|
+
# while Systems Manager is running `MaxConcurrency` associations, the
|
3230
3244
|
# association is allowed to run. During the next association interval,
|
3231
|
-
# the new
|
3245
|
+
# the new managed node will process its association within the limit
|
3232
3246
|
# specified for `MaxConcurrency`.
|
3233
3247
|
# @return [String]
|
3234
3248
|
#
|
@@ -3298,7 +3312,7 @@ module Aws::SSM
|
|
3298
3312
|
:apply_only_at_cron_interval,
|
3299
3313
|
:calendar_names,
|
3300
3314
|
:target_locations)
|
3301
|
-
SENSITIVE = []
|
3315
|
+
SENSITIVE = [:parameters]
|
3302
3316
|
include Aws::Structure
|
3303
3317
|
end
|
3304
3318
|
|
@@ -3572,10 +3586,10 @@ module Aws::SSM
|
|
3572
3586
|
# @return [Integer]
|
3573
3587
|
#
|
3574
3588
|
# @!attribute [rw] allow_unassociated_targets
|
3575
|
-
# Enables a maintenance window task to run on managed
|
3576
|
-
#
|
3577
|
-
#
|
3578
|
-
#
|
3589
|
+
# Enables a maintenance window task to run on managed nodes, even if
|
3590
|
+
# you haven't registered those nodes as targets. If enabled, then you
|
3591
|
+
# must specify the unregistered managed nodes (by node ID) when you
|
3592
|
+
# register a task with the maintenance window.
|
3579
3593
|
#
|
3580
3594
|
# If you don't enable this option, then you must specify
|
3581
3595
|
# previously-registered targets when you register a task with the
|
@@ -3901,7 +3915,7 @@ module Aws::SSM
|
|
3901
3915
|
# data as a hash:
|
3902
3916
|
#
|
3903
3917
|
# {
|
3904
|
-
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
3918
|
+
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
|
3905
3919
|
# name: "BaselineName", # required
|
3906
3920
|
# global_filters: {
|
3907
3921
|
# patch_filters: [ # required
|
@@ -3989,8 +4003,8 @@ module Aws::SSM
|
|
3989
4003
|
#
|
3990
4004
|
# @!attribute [rw] approved_patches_enable_non_security
|
3991
4005
|
# Indicates whether the list of approved patches includes non-security
|
3992
|
-
# updates that should be applied to the
|
3993
|
-
# is `false`. Applies to Linux
|
4006
|
+
# updates that should be applied to the managed nodes. The default
|
4007
|
+
# value is `false`. Applies to Linux managed nodes only.
|
3994
4008
|
# @return [Boolean]
|
3995
4009
|
#
|
3996
4010
|
# @!attribute [rw] rejected_patches
|
@@ -4029,9 +4043,9 @@ module Aws::SSM
|
|
4029
4043
|
# @return [String]
|
4030
4044
|
#
|
4031
4045
|
# @!attribute [rw] sources
|
4032
|
-
# Information about the patches to use to update the
|
4046
|
+
# Information about the patches to use to update the managed nodes,
|
4033
4047
|
# including target operating systems and source repositories. Applies
|
4034
|
-
# to Linux
|
4048
|
+
# to Linux managed nodes only.
|
4035
4049
|
# @return [Array<Types::PatchSource>]
|
4036
4050
|
#
|
4037
4051
|
# @!attribute [rw] client_token
|
@@ -4214,11 +4228,11 @@ module Aws::SSM
|
|
4214
4228
|
# @return [String]
|
4215
4229
|
#
|
4216
4230
|
# @!attribute [rw] instance_id
|
4217
|
-
# The
|
4231
|
+
# The managed node ID.
|
4218
4232
|
#
|
4219
|
-
# <note markdown="1"> `InstanceId` has been deprecated. To specify
|
4220
|
-
# association, use the `Targets` parameter. Requests that include
|
4221
|
-
# parameter `InstanceID` with Systems Manager documents (SSM
|
4233
|
+
# <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for
|
4234
|
+
# an association, use the `Targets` parameter. Requests that include
|
4235
|
+
# the parameter `InstanceID` with Systems Manager documents (SSM
|
4222
4236
|
# documents) that use schema version 2.0 or later will fail. In
|
4223
4237
|
# addition, if you use the parameter `InstanceId`, you can't use the
|
4224
4238
|
# parameters `AssociationName`, `DocumentVersion`, `MaxErrors`,
|
@@ -4564,8 +4578,8 @@ module Aws::SSM
|
|
4564
4578
|
# }
|
4565
4579
|
#
|
4566
4580
|
# @!attribute [rw] instance_id
|
4567
|
-
# The ID assigned to the managed
|
4568
|
-
#
|
4581
|
+
# The ID assigned to the managed node when you registered it using the
|
4582
|
+
# activation process.
|
4569
4583
|
# @return [String]
|
4570
4584
|
#
|
4571
4585
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DeregisterManagedInstanceRequest AWS API Documentation
|
@@ -4963,7 +4977,7 @@ module Aws::SSM
|
|
4963
4977
|
# @return [String]
|
4964
4978
|
#
|
4965
4979
|
# @!attribute [rw] instance_id
|
4966
|
-
# The
|
4980
|
+
# The managed node ID.
|
4967
4981
|
# @return [String]
|
4968
4982
|
#
|
4969
4983
|
# @!attribute [rw] association_id
|
@@ -4973,8 +4987,8 @@ module Aws::SSM
|
|
4973
4987
|
# @!attribute [rw] association_version
|
4974
4988
|
# Specify the association version to retrieve. To view the latest
|
4975
4989
|
# version, either specify `$LATEST` for this parameter, or omit this
|
4976
|
-
# parameter. To view a list of all associations for
|
4977
|
-
# ListAssociations. To get a list of versions for a specific
|
4990
|
+
# parameter. To view a list of all associations for a managed node,
|
4991
|
+
# use ListAssociations. To get a list of versions for a specific
|
4978
4992
|
# association, use ListAssociationVersions.
|
4979
4993
|
# @return [String]
|
4980
4994
|
#
|
@@ -5152,7 +5166,7 @@ module Aws::SSM
|
|
5152
5166
|
#
|
5153
5167
|
# **Windows Server**
|
5154
5168
|
#
|
5155
|
-
# Supported keys for Windows Server
|
5169
|
+
# Supported keys for Windows Server managed node patches include the
|
5156
5170
|
# following:
|
5157
5171
|
#
|
5158
5172
|
# * <b> <code>PATCH_SET</code> </b>
|
@@ -5196,7 +5210,7 @@ module Aws::SSM
|
|
5196
5210
|
# Key=PRODUCT,Values=AmazonLinux2018.03
|
5197
5211
|
# Key=CVE_ID,Values=CVE-2018-3615`
|
5198
5212
|
#
|
5199
|
-
# Supported keys for Linux
|
5213
|
+
# Supported keys for Linux managed node patches include the following:
|
5200
5214
|
#
|
5201
5215
|
# * <b> <code>PRODUCT</code> </b>
|
5202
5216
|
#
|
@@ -5402,7 +5416,7 @@ module Aws::SSM
|
|
5402
5416
|
# }
|
5403
5417
|
#
|
5404
5418
|
# @!attribute [rw] instance_id
|
5405
|
-
# The
|
5419
|
+
# The managed node ID for which you want to view all associations.
|
5406
5420
|
# @return [String]
|
5407
5421
|
#
|
5408
5422
|
# @!attribute [rw] max_results
|
@@ -5427,7 +5441,7 @@ module Aws::SSM
|
|
5427
5441
|
end
|
5428
5442
|
|
5429
5443
|
# @!attribute [rw] associations
|
5430
|
-
# The associations for the requested
|
5444
|
+
# The associations for the requested managed node.
|
5431
5445
|
# @return [Array<Types::InstanceAssociation>]
|
5432
5446
|
#
|
5433
5447
|
# @!attribute [rw] next_token
|
@@ -5504,7 +5518,8 @@ module Aws::SSM
|
|
5504
5518
|
# }
|
5505
5519
|
#
|
5506
5520
|
# @!attribute [rw] instance_id
|
5507
|
-
# The
|
5521
|
+
# The managed node IDs for which you want association status
|
5522
|
+
# information.
|
5508
5523
|
# @return [String]
|
5509
5524
|
#
|
5510
5525
|
# @!attribute [rw] max_results
|
@@ -5569,8 +5584,8 @@ module Aws::SSM
|
|
5569
5584
|
# @!attribute [rw] instance_information_filter_list
|
5570
5585
|
# This is a legacy method. We recommend that you don't use this
|
5571
5586
|
# method. Instead, use the `Filters` data type. `Filters` enables you
|
5572
|
-
# to return
|
5573
|
-
# managed
|
5587
|
+
# to return node information by filtering based on tags applied to
|
5588
|
+
# managed nodes.
|
5574
5589
|
#
|
5575
5590
|
# <note markdown="1"> Attempting to use `InstanceInformationFilterList` and `Filters`
|
5576
5591
|
# leads to an exception error.
|
@@ -5580,8 +5595,8 @@ module Aws::SSM
|
|
5580
5595
|
#
|
5581
5596
|
# @!attribute [rw] filters
|
5582
5597
|
# One or more filters. Use a filter to return a more specific list of
|
5583
|
-
#
|
5584
|
-
# Use this `Filters` data type instead of
|
5598
|
+
# managed nodes. You can filter based on tags applied to EC2
|
5599
|
+
# instances. Use this `Filters` data type instead of
|
5585
5600
|
# `InstanceInformationFilterList`, which is deprecated.
|
5586
5601
|
# @return [Array<Types::InstanceInformationStringFilter>]
|
5587
5602
|
#
|
@@ -5608,7 +5623,7 @@ module Aws::SSM
|
|
5608
5623
|
end
|
5609
5624
|
|
5610
5625
|
# @!attribute [rw] instance_information_list
|
5611
|
-
# The
|
5626
|
+
# The managed node information list.
|
5612
5627
|
# @return [Array<Types::InstanceInformation>]
|
5613
5628
|
#
|
5614
5629
|
# @!attribute [rw] next_token
|
@@ -5678,7 +5693,7 @@ module Aws::SSM
|
|
5678
5693
|
end
|
5679
5694
|
|
5680
5695
|
# @!attribute [rw] instance_patch_states
|
5681
|
-
# The high-level patch state for the requested
|
5696
|
+
# The high-level patch state for the requested managed nodes.
|
5682
5697
|
# @return [Array<Types::InstancePatchState>]
|
5683
5698
|
#
|
5684
5699
|
# @!attribute [rw] next_token
|
@@ -5705,8 +5720,8 @@ module Aws::SSM
|
|
5705
5720
|
# }
|
5706
5721
|
#
|
5707
5722
|
# @!attribute [rw] instance_ids
|
5708
|
-
# The ID of the
|
5709
|
-
# retrieved.
|
5723
|
+
# The ID of the managed node for which patch state information should
|
5724
|
+
# be retrieved.
|
5710
5725
|
# @return [Array<String>]
|
5711
5726
|
#
|
5712
5727
|
# @!attribute [rw] next_token
|
@@ -5715,7 +5730,7 @@ module Aws::SSM
|
|
5715
5730
|
# @return [String]
|
5716
5731
|
#
|
5717
5732
|
# @!attribute [rw] max_results
|
5718
|
-
# The maximum number of
|
5733
|
+
# The maximum number of managed nodes to return (per page).
|
5719
5734
|
# @return [Integer]
|
5720
5735
|
#
|
5721
5736
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstancePatchStatesRequest AWS API Documentation
|
@@ -5729,7 +5744,7 @@ module Aws::SSM
|
|
5729
5744
|
end
|
5730
5745
|
|
5731
5746
|
# @!attribute [rw] instance_patch_states
|
5732
|
-
# The high-level patch state for the requested
|
5747
|
+
# The high-level patch state for the requested managed nodes.
|
5733
5748
|
# @return [Array<Types::InstancePatchState>]
|
5734
5749
|
#
|
5735
5750
|
# @!attribute [rw] next_token
|
@@ -5762,7 +5777,7 @@ module Aws::SSM
|
|
5762
5777
|
# }
|
5763
5778
|
#
|
5764
5779
|
# @!attribute [rw] instance_id
|
5765
|
-
# The ID of the
|
5780
|
+
# The ID of the managed node whose patch state information should be
|
5766
5781
|
# retrieved.
|
5767
5782
|
# @return [String]
|
5768
5783
|
#
|
@@ -6133,7 +6148,7 @@ module Aws::SSM
|
|
6133
6148
|
# @return [String]
|
6134
6149
|
#
|
6135
6150
|
# @!attribute [rw] targets
|
6136
|
-
# The
|
6151
|
+
# The managed node ID or key-value pair to retrieve information about.
|
6137
6152
|
# @return [Array<Types::Target>]
|
6138
6153
|
#
|
6139
6154
|
# @!attribute [rw] resource_type
|
@@ -6336,7 +6351,7 @@ module Aws::SSM
|
|
6336
6351
|
# }
|
6337
6352
|
#
|
6338
6353
|
# @!attribute [rw] targets
|
6339
|
-
# The
|
6354
|
+
# The managed node ID or key-value pair to retrieve information about.
|
6340
6355
|
# @return [Array<Types::Target>]
|
6341
6356
|
#
|
6342
6357
|
# @!attribute [rw] resource_type
|
@@ -6367,8 +6382,8 @@ module Aws::SSM
|
|
6367
6382
|
end
|
6368
6383
|
|
6369
6384
|
# @!attribute [rw] window_identities
|
6370
|
-
# Information about the maintenance window targets and tasks
|
6371
|
-
#
|
6385
|
+
# Information about the maintenance window targets and tasks a managed
|
6386
|
+
# node is associated with.
|
6372
6387
|
# @return [Array<Types::MaintenanceWindowIdentityForTarget>]
|
6373
6388
|
#
|
6374
6389
|
# @!attribute [rw] next_token
|
@@ -6721,27 +6736,27 @@ module Aws::SSM
|
|
6721
6736
|
end
|
6722
6737
|
|
6723
6738
|
# @!attribute [rw] instances
|
6724
|
-
# The number of
|
6739
|
+
# The number of managed nodes in the patch group.
|
6725
6740
|
# @return [Integer]
|
6726
6741
|
#
|
6727
6742
|
# @!attribute [rw] instances_with_installed_patches
|
6728
|
-
# The number of
|
6743
|
+
# The number of managed nodes with installed patches.
|
6729
6744
|
# @return [Integer]
|
6730
6745
|
#
|
6731
6746
|
# @!attribute [rw] instances_with_installed_other_patches
|
6732
|
-
# The number of
|
6733
|
-
# in the patch baseline.
|
6747
|
+
# The number of managed nodes with patches installed that aren't
|
6748
|
+
# defined in the patch baseline.
|
6734
6749
|
# @return [Integer]
|
6735
6750
|
#
|
6736
6751
|
# @!attribute [rw] instances_with_installed_pending_reboot_patches
|
6737
|
-
# The number of
|
6738
|
-
# haven't been rebooted after the patch installation. The status
|
6739
|
-
# these
|
6752
|
+
# The number of managed nodes with patches installed by Patch Manager
|
6753
|
+
# that haven't been rebooted after the patch installation. The status
|
6754
|
+
# of these managed nodes is `NON_COMPLIANT`.
|
6740
6755
|
# @return [Integer]
|
6741
6756
|
#
|
6742
6757
|
# @!attribute [rw] instances_with_installed_rejected_patches
|
6743
|
-
# The number of
|
6744
|
-
# a `RejectedPatches` list. Patches with a status of
|
6758
|
+
# The number of managed nodes with patches installed that are
|
6759
|
+
# specified in a `RejectedPatches` list. Patches with a status of
|
6745
6760
|
# `INSTALLED_REJECTED` were typically installed before they were added
|
6746
6761
|
# to a `RejectedPatches` list.
|
6747
6762
|
#
|
@@ -6753,45 +6768,46 @@ module Aws::SSM
|
|
6753
6768
|
# @return [Integer]
|
6754
6769
|
#
|
6755
6770
|
# @!attribute [rw] instances_with_missing_patches
|
6756
|
-
# The number of
|
6771
|
+
# The number of managed nodes with missing patches from the patch
|
6757
6772
|
# baseline.
|
6758
6773
|
# @return [Integer]
|
6759
6774
|
#
|
6760
6775
|
# @!attribute [rw] instances_with_failed_patches
|
6761
|
-
# The number of
|
6762
|
-
# failed to install.
|
6776
|
+
# The number of managed nodes with patches from the patch baseline
|
6777
|
+
# that failed to install.
|
6763
6778
|
# @return [Integer]
|
6764
6779
|
#
|
6765
6780
|
# @!attribute [rw] instances_with_not_applicable_patches
|
6766
|
-
# The number of
|
6781
|
+
# The number of managed nodes with patches that aren't applicable.
|
6767
6782
|
# @return [Integer]
|
6768
6783
|
#
|
6769
6784
|
# @!attribute [rw] instances_with_unreported_not_applicable_patches
|
6770
|
-
# The number of
|
6785
|
+
# The number of managed nodes with `NotApplicable` patches beyond the
|
6771
6786
|
# supported limit, which aren't reported by name to Inventory.
|
6772
6787
|
# Inventory is a capability of Amazon Web Services Systems Manager.
|
6773
6788
|
# @return [Integer]
|
6774
6789
|
#
|
6775
6790
|
# @!attribute [rw] instances_with_critical_non_compliant_patches
|
6776
|
-
# The number of
|
6791
|
+
# The number of managed nodes where patches that are specified as
|
6777
6792
|
# `Critical` for compliance reporting in the patch baseline aren't
|
6778
6793
|
# installed. These patches might be missing, have failed installation,
|
6779
|
-
# were rejected, or were installed but awaiting a required
|
6780
|
-
# reboot. The status of these
|
6794
|
+
# were rejected, or were installed but awaiting a required managed
|
6795
|
+
# node reboot. The status of these managed nodes is `NON_COMPLIANT`.
|
6781
6796
|
# @return [Integer]
|
6782
6797
|
#
|
6783
6798
|
# @!attribute [rw] instances_with_security_non_compliant_patches
|
6784
|
-
# The number of
|
6799
|
+
# The number of managed nodes where patches that are specified as
|
6785
6800
|
# `Security` in a patch advisory aren't installed. These patches
|
6786
6801
|
# might be missing, have failed installation, were rejected, or were
|
6787
|
-
# installed but awaiting a required
|
6788
|
-
# these
|
6802
|
+
# installed but awaiting a required managed node reboot. The status of
|
6803
|
+
# these managed nodes is `NON_COMPLIANT`.
|
6789
6804
|
# @return [Integer]
|
6790
6805
|
#
|
6791
6806
|
# @!attribute [rw] instances_with_other_non_compliant_patches
|
6792
|
-
# The number of
|
6793
|
-
# other than `Critical` or `Security` but aren't
|
6794
|
-
# patch baseline. The status of these
|
6807
|
+
# The number of managed nodes with patches installed that are
|
6808
|
+
# specified as other than `Critical` or `Security` but aren't
|
6809
|
+
# compliant with the patch baseline. The status of these managed nodes
|
6810
|
+
# is `NON_COMPLIANT`.
|
6795
6811
|
# @return [Integer]
|
6796
6812
|
#
|
6797
6813
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupStateResult AWS API Documentation
|
@@ -6888,7 +6904,7 @@ module Aws::SSM
|
|
6888
6904
|
# data as a hash:
|
6889
6905
|
#
|
6890
6906
|
# {
|
6891
|
-
# operating_system: "WINDOWS", # required, accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
6907
|
+
# operating_system: "WINDOWS", # required, accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
|
6892
6908
|
# property: "PRODUCT", # required, accepts PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, MSRC_SEVERITY, PRIORITY, SEVERITY
|
6893
6909
|
# patch_set: "OS", # accepts OS, APPLICATION
|
6894
6910
|
# max_results: 1,
|
@@ -7834,7 +7850,7 @@ module Aws::SSM
|
|
7834
7850
|
include Aws::Structure
|
7835
7851
|
end
|
7836
7852
|
|
7837
|
-
# You can't specify
|
7853
|
+
# You can't specify a managed node ID in more than one association.
|
7838
7854
|
#
|
7839
7855
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DuplicateInstanceId AWS API Documentation
|
7840
7856
|
#
|
@@ -8051,10 +8067,11 @@ module Aws::SSM
|
|
8051
8067
|
# @return [String]
|
8052
8068
|
#
|
8053
8069
|
# @!attribute [rw] instance_id
|
8054
|
-
# (Required) The ID of the managed
|
8055
|
-
# managed
|
8056
|
-
# instance or
|
8057
|
-
# configured for Amazon Web Services Systems
|
8070
|
+
# (Required) The ID of the managed node targeted by the command. A
|
8071
|
+
# *managed node* can be an Amazon Elastic Compute Cloud (Amazon EC2)
|
8072
|
+
# instance, edge device, and on-premises server or VM in your hybrid
|
8073
|
+
# environment that is configured for Amazon Web Services Systems
|
8074
|
+
# Manager.
|
8058
8075
|
# @return [String]
|
8059
8076
|
#
|
8060
8077
|
# @!attribute [rw] plugin_name
|
@@ -8090,9 +8107,10 @@ module Aws::SSM
|
|
8090
8107
|
# @return [String]
|
8091
8108
|
#
|
8092
8109
|
# @!attribute [rw] instance_id
|
8093
|
-
# The ID of the managed
|
8094
|
-
#
|
8095
|
-
#
|
8110
|
+
# The ID of the managed node targeted by the command. A *managed node*
|
8111
|
+
# can be an Amazon Elastic Compute Cloud (Amazon EC2) instance, edge
|
8112
|
+
# device, or on-premises server or VM in your hybrid environment that
|
8113
|
+
# is configured for Amazon Web Services Systems Manager.
|
8096
8114
|
# @return [String]
|
8097
8115
|
#
|
8098
8116
|
# @!attribute [rw] comment
|
@@ -8117,7 +8135,7 @@ module Aws::SSM
|
|
8117
8135
|
# @!attribute [rw] response_code
|
8118
8136
|
# The error level response code for the plugin script. If the response
|
8119
8137
|
# code is `-1`, then the command hasn't started running on the
|
8120
|
-
#
|
8138
|
+
# managed node, or it wasn't received by the node.
|
8121
8139
|
# @return [Integer]
|
8122
8140
|
#
|
8123
8141
|
# @!attribute [rw] execution_start_date_time
|
@@ -8163,42 +8181,43 @@ module Aws::SSM
|
|
8163
8181
|
# Systems Manager User Guide*. `StatusDetails` can be one of the
|
8164
8182
|
# following values:
|
8165
8183
|
#
|
8166
|
-
# * Pending: The command hasn't been sent to the
|
8184
|
+
# * Pending: The command hasn't been sent to the managed node.
|
8167
8185
|
#
|
8168
|
-
# * In Progress: The command has been sent to the
|
8169
|
-
# reached a terminal state.
|
8186
|
+
# * In Progress: The command has been sent to the managed node but
|
8187
|
+
# hasn't reached a terminal state.
|
8170
8188
|
#
|
8171
8189
|
# * Delayed: The system attempted to send the command to the target,
|
8172
|
-
# but the target wasn't available. The
|
8173
|
-
# available because of network issues, because the
|
8174
|
-
#
|
8175
|
-
#
|
8190
|
+
# but the target wasn't available. The managed node might not be
|
8191
|
+
# available because of network issues, because the node was stopped,
|
8192
|
+
# or for similar reasons. The system will try to send the command
|
8193
|
+
# again.
|
8176
8194
|
#
|
8177
8195
|
# * Success: The command or plugin ran successfully. This is a
|
8178
8196
|
# terminal state.
|
8179
8197
|
#
|
8180
|
-
# * Delivery Timed Out: The command wasn't delivered to the
|
8181
|
-
# before the delivery timeout expired. Delivery timeouts don't
|
8198
|
+
# * Delivery Timed Out: The command wasn't delivered to the managed
|
8199
|
+
# node before the delivery timeout expired. Delivery timeouts don't
|
8182
8200
|
# count against the parent command's `MaxErrors` limit, but they do
|
8183
8201
|
# contribute to whether the parent command status is Success or
|
8184
8202
|
# Incomplete. This is a terminal state.
|
8185
8203
|
#
|
8186
|
-
# * Execution Timed Out: The command started to run on the
|
8187
|
-
# but the execution wasn't complete before the timeout
|
8188
|
-
# Execution timeouts count against the `MaxErrors` limit of
|
8189
|
-
# parent command. This is a terminal state.
|
8204
|
+
# * Execution Timed Out: The command started to run on the managed
|
8205
|
+
# node, but the execution wasn't complete before the timeout
|
8206
|
+
# expired. Execution timeouts count against the `MaxErrors` limit of
|
8207
|
+
# the parent command. This is a terminal state.
|
8190
8208
|
#
|
8191
|
-
# * Failed: The command wasn't run successfully on the
|
8192
|
-
# a plugin, this indicates that the result code wasn't zero.
|
8193
|
-
# command invocation, this indicates that the result code for
|
8194
|
-
# more plugins wasn't zero. Invocation failures count
|
8195
|
-
# `MaxErrors` limit of the parent command. This is a
|
8209
|
+
# * Failed: The command wasn't run successfully on the managed node.
|
8210
|
+
# For a plugin, this indicates that the result code wasn't zero.
|
8211
|
+
# For a command invocation, this indicates that the result code for
|
8212
|
+
# one or more plugins wasn't zero. Invocation failures count
|
8213
|
+
# against the `MaxErrors` limit of the parent command. This is a
|
8214
|
+
# terminal state.
|
8196
8215
|
#
|
8197
8216
|
# * Canceled: The command was terminated before it was completed. This
|
8198
8217
|
# is a terminal state.
|
8199
8218
|
#
|
8200
|
-
# * Undeliverable: The command can't be delivered to the
|
8201
|
-
# The
|
8219
|
+
# * Undeliverable: The command can't be delivered to the managed
|
8220
|
+
# node. The node might not exist or might not be responding.
|
8202
8221
|
# Undeliverable invocations don't count against the parent
|
8203
8222
|
# command's `MaxErrors` limit and don't contribute to whether the
|
8204
8223
|
# parent command status is Success or Incomplete. This is a terminal
|
@@ -8272,7 +8291,7 @@ module Aws::SSM
|
|
8272
8291
|
# }
|
8273
8292
|
#
|
8274
8293
|
# @!attribute [rw] target
|
8275
|
-
# The
|
8294
|
+
# The managed node ID.
|
8276
8295
|
# @return [String]
|
8277
8296
|
#
|
8278
8297
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetConnectionStatusRequest AWS API Documentation
|
@@ -8284,11 +8303,11 @@ module Aws::SSM
|
|
8284
8303
|
end
|
8285
8304
|
|
8286
8305
|
# @!attribute [rw] target
|
8287
|
-
# The ID of the
|
8306
|
+
# The ID of the managed node to check connection status.
|
8288
8307
|
# @return [String]
|
8289
8308
|
#
|
8290
8309
|
# @!attribute [rw] status
|
8291
|
-
# The status of the connection to the
|
8310
|
+
# The status of the connection to the managed node. For example,
|
8292
8311
|
# 'Connected' or 'Not Connected'.
|
8293
8312
|
# @return [String]
|
8294
8313
|
#
|
@@ -8305,7 +8324,7 @@ module Aws::SSM
|
|
8305
8324
|
# data as a hash:
|
8306
8325
|
#
|
8307
8326
|
# {
|
8308
|
-
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
8327
|
+
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
|
8309
8328
|
# }
|
8310
8329
|
#
|
8311
8330
|
# @!attribute [rw] operating_system
|
@@ -8345,7 +8364,7 @@ module Aws::SSM
|
|
8345
8364
|
# instance_id: "InstanceId", # required
|
8346
8365
|
# snapshot_id: "SnapshotId", # required
|
8347
8366
|
# baseline_override: {
|
8348
|
-
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
8367
|
+
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
|
8349
8368
|
# global_filters: {
|
8350
8369
|
# patch_filters: [ # required
|
8351
8370
|
# {
|
@@ -8388,7 +8407,7 @@ module Aws::SSM
|
|
8388
8407
|
# }
|
8389
8408
|
#
|
8390
8409
|
# @!attribute [rw] instance_id
|
8391
|
-
# The ID of the
|
8410
|
+
# The ID of the managed node for which the appropriate patch snapshot
|
8392
8411
|
# should be retrieved.
|
8393
8412
|
# @return [String]
|
8394
8413
|
#
|
@@ -8412,7 +8431,7 @@ module Aws::SSM
|
|
8412
8431
|
end
|
8413
8432
|
|
8414
8433
|
# @!attribute [rw] instance_id
|
8415
|
-
# The
|
8434
|
+
# The managed node ID.
|
8416
8435
|
# @return [String]
|
8417
8436
|
#
|
8418
8437
|
# @!attribute [rw] snapshot_id
|
@@ -8426,7 +8445,7 @@ module Aws::SSM
|
|
8426
8445
|
#
|
8427
8446
|
# @!attribute [rw] product
|
8428
8447
|
# Returns the specific operating system (for example Windows Server
|
8429
|
-
# 2012 or Amazon Linux 2015.09) on the
|
8448
|
+
# 2012 or Amazon Linux 2015.09) on the managed node for the specified
|
8430
8449
|
# patch snapshot.
|
8431
8450
|
# @return [String]
|
8432
8451
|
#
|
@@ -8623,7 +8642,7 @@ module Aws::SSM
|
|
8623
8642
|
# Returns counts of inventory types based on one or more expressions.
|
8624
8643
|
# For example, if you aggregate by using an expression that uses the
|
8625
8644
|
# `AWS:InstanceInformation.PlatformType` type, you can see a count of
|
8626
|
-
# how many Windows and Linux
|
8645
|
+
# how many Windows and Linux managed nodes exist in your inventoried
|
8627
8646
|
# fleet.
|
8628
8647
|
# @return [Array<Types::InventoryAggregator>]
|
8629
8648
|
#
|
@@ -8655,8 +8674,8 @@ module Aws::SSM
|
|
8655
8674
|
end
|
8656
8675
|
|
8657
8676
|
# @!attribute [rw] entities
|
8658
|
-
# Collection of inventory entities such as a collection of
|
8659
|
-
# inventory.
|
8677
|
+
# Collection of inventory entities such as a collection of managed
|
8678
|
+
# node inventory.
|
8660
8679
|
# @return [Array<Types::InventoryResultEntity>]
|
8661
8680
|
#
|
8662
8681
|
# @!attribute [rw] next_token
|
@@ -9733,7 +9752,7 @@ module Aws::SSM
|
|
9733
9752
|
#
|
9734
9753
|
# {
|
9735
9754
|
# patch_group: "PatchGroup", # required
|
9736
|
-
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
9755
|
+
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS, RASPBIAN
|
9737
9756
|
# }
|
9738
9757
|
#
|
9739
9758
|
# @!attribute [rw] patch_group
|
@@ -9838,8 +9857,8 @@ module Aws::SSM
|
|
9838
9857
|
#
|
9839
9858
|
# @!attribute [rw] approved_patches_enable_non_security
|
9840
9859
|
# Indicates whether the list of approved patches includes non-security
|
9841
|
-
# updates that should be applied to the
|
9842
|
-
# is `false`. Applies to Linux
|
9860
|
+
# updates that should be applied to the managed nodes. The default
|
9861
|
+
# value is `false`. Applies to Linux managed nodes only.
|
9843
9862
|
# @return [Boolean]
|
9844
9863
|
#
|
9845
9864
|
# @!attribute [rw] rejected_patches
|
@@ -9870,9 +9889,9 @@ module Aws::SSM
|
|
9870
9889
|
# @return [String]
|
9871
9890
|
#
|
9872
9891
|
# @!attribute [rw] sources
|
9873
|
-
# Information about the patches to use to update the
|
9892
|
+
# Information about the patches to use to update the managed nodes,
|
9874
9893
|
# including target operating systems and source repositories. Applies
|
9875
|
-
# to Linux
|
9894
|
+
# to Linux managed nodes only.
|
9876
9895
|
# @return [Array<Types::PatchSource>]
|
9877
9896
|
#
|
9878
9897
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaselineResult AWS API Documentation
|
@@ -10028,7 +10047,7 @@ module Aws::SSM
|
|
10028
10047
|
# @return [String]
|
10029
10048
|
#
|
10030
10049
|
# @!attribute [rw] instance_association_status_aggregated_count
|
10031
|
-
# The number of associations for the
|
10050
|
+
# The number of associations for the managed node(s).
|
10032
10051
|
# @return [Hash<String,Integer>]
|
10033
10052
|
#
|
10034
10053
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceAggregatedAssociationOverview AWS API Documentation
|
@@ -10040,22 +10059,22 @@ module Aws::SSM
|
|
10040
10059
|
include Aws::Structure
|
10041
10060
|
end
|
10042
10061
|
|
10043
|
-
# One or more association documents on the
|
10062
|
+
# One or more association documents on the managed node.
|
10044
10063
|
#
|
10045
10064
|
# @!attribute [rw] association_id
|
10046
10065
|
# The association ID.
|
10047
10066
|
# @return [String]
|
10048
10067
|
#
|
10049
10068
|
# @!attribute [rw] instance_id
|
10050
|
-
# The
|
10069
|
+
# The managed node ID.
|
10051
10070
|
# @return [String]
|
10052
10071
|
#
|
10053
10072
|
# @!attribute [rw] content
|
10054
|
-
# The content of the association document for the
|
10073
|
+
# The content of the association document for the managed node(s).
|
10055
10074
|
# @return [String]
|
10056
10075
|
#
|
10057
10076
|
# @!attribute [rw] association_version
|
10058
|
-
# Version information for the association on the
|
10077
|
+
# Version information for the association on the managed node.
|
10059
10078
|
# @return [String]
|
10060
10079
|
#
|
10061
10080
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceAssociation AWS API Documentation
|
@@ -10118,7 +10137,7 @@ module Aws::SSM
|
|
10118
10137
|
include Aws::Structure
|
10119
10138
|
end
|
10120
10139
|
|
10121
|
-
# Status information about the
|
10140
|
+
# Status information about the association.
|
10122
10141
|
#
|
10123
10142
|
# @!attribute [rw] association_id
|
10124
10143
|
# The association ID.
|
@@ -10133,23 +10152,23 @@ module Aws::SSM
|
|
10133
10152
|
# @return [String]
|
10134
10153
|
#
|
10135
10154
|
# @!attribute [rw] association_version
|
10136
|
-
# The version of the association applied to the
|
10155
|
+
# The version of the association applied to the managed node.
|
10137
10156
|
# @return [String]
|
10138
10157
|
#
|
10139
10158
|
# @!attribute [rw] instance_id
|
10140
|
-
# The
|
10159
|
+
# The managed node ID where the association was created.
|
10141
10160
|
# @return [String]
|
10142
10161
|
#
|
10143
10162
|
# @!attribute [rw] execution_date
|
10144
|
-
# The date the
|
10163
|
+
# The date the association ran.
|
10145
10164
|
# @return [Time]
|
10146
10165
|
#
|
10147
10166
|
# @!attribute [rw] status
|
10148
|
-
# Status information about the
|
10167
|
+
# Status information about the association.
|
10149
10168
|
# @return [String]
|
10150
10169
|
#
|
10151
10170
|
# @!attribute [rw] detailed_status
|
10152
|
-
# Detailed status information about the
|
10171
|
+
# Detailed status information about the association.
|
10153
10172
|
# @return [String]
|
10154
10173
|
#
|
10155
10174
|
# @!attribute [rw] execution_summary
|
@@ -10166,7 +10185,7 @@ module Aws::SSM
|
|
10166
10185
|
# @return [Types::InstanceAssociationOutputUrl]
|
10167
10186
|
#
|
10168
10187
|
# @!attribute [rw] association_name
|
10169
|
-
# The name of the association applied to the
|
10188
|
+
# The name of the association applied to the managed node.
|
10170
10189
|
# @return [String]
|
10171
10190
|
#
|
10172
10191
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceAssociationStatusInfo AWS API Documentation
|
@@ -10188,10 +10207,10 @@ module Aws::SSM
|
|
10188
10207
|
include Aws::Structure
|
10189
10208
|
end
|
10190
10209
|
|
10191
|
-
# Describes a filter for a specific list of
|
10210
|
+
# Describes a filter for a specific list of managed nodes.
|
10192
10211
|
#
|
10193
10212
|
# @!attribute [rw] instance_id
|
10194
|
-
# The
|
10213
|
+
# The managed node ID.
|
10195
10214
|
# @return [String]
|
10196
10215
|
#
|
10197
10216
|
# @!attribute [rw] ping_status
|
@@ -10208,15 +10227,15 @@ module Aws::SSM
|
|
10208
10227
|
# @return [Time]
|
10209
10228
|
#
|
10210
10229
|
# @!attribute [rw] agent_version
|
10211
|
-
# The version of SSM Agent running on your Linux
|
10230
|
+
# The version of SSM Agent running on your Linux managed node.
|
10212
10231
|
# @return [String]
|
10213
10232
|
#
|
10214
10233
|
# @!attribute [rw] is_latest_version
|
10215
10234
|
# Indicates whether the latest version of SSM Agent is running on your
|
10216
|
-
# Linux
|
10217
|
-
#
|
10218
|
-
#
|
10219
|
-
#
|
10235
|
+
# Linux managed node. This field doesn't indicate whether or not the
|
10236
|
+
# latest version is installed on Windows managed nodes, because some
|
10237
|
+
# older versions of Windows Server use the EC2Config service to
|
10238
|
+
# process Systems Manager requests.
|
10220
10239
|
# @return [Boolean]
|
10221
10240
|
#
|
10222
10241
|
# @!attribute [rw] platform_type
|
@@ -10224,11 +10243,12 @@ module Aws::SSM
|
|
10224
10243
|
# @return [String]
|
10225
10244
|
#
|
10226
10245
|
# @!attribute [rw] platform_name
|
10227
|
-
# The name of the operating system platform running on your
|
10246
|
+
# The name of the operating system platform running on your managed
|
10247
|
+
# node.
|
10228
10248
|
# @return [String]
|
10229
10249
|
#
|
10230
10250
|
# @!attribute [rw] platform_version
|
10231
|
-
# The version of the OS platform running on your
|
10251
|
+
# The version of the OS platform running on your managed node.
|
10232
10252
|
# @return [String]
|
10233
10253
|
#
|
10234
10254
|
# @!attribute [rw] activation_id
|
@@ -10238,8 +10258,8 @@ module Aws::SSM
|
|
10238
10258
|
#
|
10239
10259
|
# @!attribute [rw] iam_role
|
10240
10260
|
# The Identity and Access Management (IAM) role assigned to the
|
10241
|
-
# on-premises Systems Manager managed
|
10242
|
-
#
|
10261
|
+
# on-premises Systems Manager managed node. This call doesn't return
|
10262
|
+
# the IAM role for Amazon Elastic Compute Cloud (Amazon EC2)
|
10243
10263
|
# instances. To retrieve the IAM role for an EC2 instance, use the
|
10244
10264
|
# Amazon EC2 `DescribeInstances` operation. For information, see
|
10245
10265
|
# [DescribeInstances][1] in the *Amazon EC2 API Reference* or
|
@@ -10254,7 +10274,7 @@ module Aws::SSM
|
|
10254
10274
|
#
|
10255
10275
|
# @!attribute [rw] registration_date
|
10256
10276
|
# The date the server or VM was registered with Amazon Web Services as
|
10257
|
-
# a managed
|
10277
|
+
# a managed node.
|
10258
10278
|
# @return [Time]
|
10259
10279
|
#
|
10260
10280
|
# @!attribute [rw] resource_type
|
@@ -10263,14 +10283,14 @@ module Aws::SSM
|
|
10263
10283
|
# @return [String]
|
10264
10284
|
#
|
10265
10285
|
# @!attribute [rw] name
|
10266
|
-
# The name assigned to an on-premises server or virtual
|
10267
|
-
# when it is activated as a Systems Manager managed
|
10268
|
-
# is specified as the `DefaultInstanceName` property using
|
10269
|
-
# CreateActivation command. It is applied to the managed
|
10286
|
+
# The name assigned to an on-premises server, edge device, or virtual
|
10287
|
+
# machine (VM) when it is activated as a Systems Manager managed node.
|
10288
|
+
# The name is specified as the `DefaultInstanceName` property using
|
10289
|
+
# the CreateActivation command. It is applied to the managed node by
|
10270
10290
|
# specifying the Activation Code and Activation ID when you install
|
10271
|
-
# SSM Agent on the
|
10291
|
+
# SSM Agent on the node, as explained in [Install SSM Agent for a
|
10272
10292
|
# hybrid environment (Linux)][1] and [Install SSM Agent for a hybrid
|
10273
|
-
# environment (Windows)][2]. To retrieve the Name tag of an EC2
|
10293
|
+
# environment (Windows)][2]. To retrieve the `Name` tag of an EC2
|
10274
10294
|
# instance, use the Amazon EC2 `DescribeInstances` operation. For
|
10275
10295
|
# information, see [DescribeInstances][3] in the *Amazon EC2 API
|
10276
10296
|
# Reference* or [describe-instances][4] in the *Amazon Web Services
|
@@ -10285,11 +10305,11 @@ module Aws::SSM
|
|
10285
10305
|
# @return [String]
|
10286
10306
|
#
|
10287
10307
|
# @!attribute [rw] ip_address
|
10288
|
-
# The IP address of the managed
|
10308
|
+
# The IP address of the managed node.
|
10289
10309
|
# @return [String]
|
10290
10310
|
#
|
10291
10311
|
# @!attribute [rw] computer_name
|
10292
|
-
# The fully qualified host name of the managed
|
10312
|
+
# The fully qualified host name of the managed node.
|
10293
10313
|
# @return [String]
|
10294
10314
|
#
|
10295
10315
|
# @!attribute [rw] association_status
|
@@ -10308,6 +10328,16 @@ module Aws::SSM
|
|
10308
10328
|
# Information about the association.
|
10309
10329
|
# @return [Types::InstanceAggregatedAssociationOverview]
|
10310
10330
|
#
|
10331
|
+
# @!attribute [rw] source_id
|
10332
|
+
# The ID of the source resource. For IoT Greengrass devices,
|
10333
|
+
# `SourceId` is the Thing name.
|
10334
|
+
# @return [String]
|
10335
|
+
#
|
10336
|
+
# @!attribute [rw] source_type
|
10337
|
+
# The type of the source resource. For IoT Greengrass devices,
|
10338
|
+
# `SourceType` is `AWS::IoT::Thing`.
|
10339
|
+
# @return [String]
|
10340
|
+
#
|
10311
10341
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceInformation AWS API Documentation
|
10312
10342
|
#
|
10313
10343
|
class InstanceInformation < Struct.new(
|
@@ -10329,13 +10359,15 @@ module Aws::SSM
|
|
10329
10359
|
:association_status,
|
10330
10360
|
:last_association_execution_date,
|
10331
10361
|
:last_successful_association_execution_date,
|
10332
|
-
:association_overview
|
10362
|
+
:association_overview,
|
10363
|
+
:source_id,
|
10364
|
+
:source_type)
|
10333
10365
|
SENSITIVE = []
|
10334
10366
|
include Aws::Structure
|
10335
10367
|
end
|
10336
10368
|
|
10337
|
-
# Describes a filter for a specific list of
|
10338
|
-
#
|
10369
|
+
# Describes a filter for a specific list of managed nodes. You can
|
10370
|
+
# filter node information by using tags. You specify tags by using a
|
10339
10371
|
# key-value mapping.
|
10340
10372
|
#
|
10341
10373
|
# Use this operation instead of the
|
@@ -10368,8 +10400,7 @@ module Aws::SSM
|
|
10368
10400
|
include Aws::Structure
|
10369
10401
|
end
|
10370
10402
|
|
10371
|
-
# The filters to describe or get information about your managed
|
10372
|
-
# instances.
|
10403
|
+
# The filters to describe or get information about your managed nodes.
|
10373
10404
|
#
|
10374
10405
|
# @note When making an API call, you may pass InstanceInformationStringFilter
|
10375
10406
|
# data as a hash:
|
@@ -10380,7 +10411,7 @@ module Aws::SSM
|
|
10380
10411
|
# }
|
10381
10412
|
#
|
10382
10413
|
# @!attribute [rw] key
|
10383
|
-
# The filter key name to describe your
|
10414
|
+
# The filter key name to describe your managed nodes. For example:
|
10384
10415
|
#
|
10385
10416
|
# "InstanceIds"\|"AgentVersion"\|"PingStatus"\|"PlatformTypes"\|"ActivationIds"\|"IamRole"\|"ResourceType"\|"AssociationStatus"\|"Tag
|
10386
10417
|
# Key"
|
@@ -10404,22 +10435,22 @@ module Aws::SSM
|
|
10404
10435
|
include Aws::Structure
|
10405
10436
|
end
|
10406
10437
|
|
10407
|
-
# Defines the high-level patch compliance state for a managed
|
10438
|
+
# Defines the high-level patch compliance state for a managed node,
|
10408
10439
|
# providing information about the number of installed, missing, not
|
10409
10440
|
# applicable, and failed patches along with metadata about the operation
|
10410
|
-
# when this information was gathered for the
|
10441
|
+
# when this information was gathered for the managed node.
|
10411
10442
|
#
|
10412
10443
|
# @!attribute [rw] instance_id
|
10413
|
-
# The ID of the managed
|
10444
|
+
# The ID of the managed node the high-level patch compliance
|
10414
10445
|
# information was collected for.
|
10415
10446
|
# @return [String]
|
10416
10447
|
#
|
10417
10448
|
# @!attribute [rw] patch_group
|
10418
|
-
# The name of the patch group the managed
|
10449
|
+
# The name of the patch group the managed node belongs to.
|
10419
10450
|
# @return [String]
|
10420
10451
|
#
|
10421
10452
|
# @!attribute [rw] baseline_id
|
10422
|
-
# The ID of the patch baseline used to patch the
|
10453
|
+
# The ID of the patch baseline used to patch the managed node.
|
10423
10454
|
# @return [String]
|
10424
10455
|
#
|
10425
10456
|
# @!attribute [rw] snapshot_id
|
@@ -10450,22 +10481,22 @@ module Aws::SSM
|
|
10450
10481
|
#
|
10451
10482
|
# @!attribute [rw] installed_count
|
10452
10483
|
# The number of patches from the patch baseline that are installed on
|
10453
|
-
# the
|
10484
|
+
# the managed node.
|
10454
10485
|
# @return [Integer]
|
10455
10486
|
#
|
10456
10487
|
# @!attribute [rw] installed_other_count
|
10457
10488
|
# The number of patches not specified in the patch baseline that are
|
10458
|
-
# installed on the
|
10489
|
+
# installed on the managed node.
|
10459
10490
|
# @return [Integer]
|
10460
10491
|
#
|
10461
10492
|
# @!attribute [rw] installed_pending_reboot_count
|
10462
10493
|
# The number of patches installed by Patch Manager since the last time
|
10463
|
-
# the
|
10494
|
+
# the managed node was rebooted.
|
10464
10495
|
# @return [Integer]
|
10465
10496
|
#
|
10466
10497
|
# @!attribute [rw] installed_rejected_count
|
10467
|
-
# The number of patches installed on
|
10468
|
-
# a `RejectedPatches` list. Patches with a status of
|
10498
|
+
# The number of patches installed on a managed node that are specified
|
10499
|
+
# in a `RejectedPatches` list. Patches with a status of
|
10469
10500
|
# `InstalledRejected` were typically installed before they were added
|
10470
10501
|
# to a `RejectedPatches` list.
|
10471
10502
|
#
|
@@ -10478,7 +10509,7 @@ module Aws::SSM
|
|
10478
10509
|
#
|
10479
10510
|
# @!attribute [rw] missing_count
|
10480
10511
|
# The number of patches from the patch baseline that are applicable
|
10481
|
-
# for the
|
10512
|
+
# for the managed node but aren't currently installed.
|
10482
10513
|
# @return [Integer]
|
10483
10514
|
#
|
10484
10515
|
# @!attribute [rw] failed_count
|
@@ -10495,20 +10526,20 @@ module Aws::SSM
|
|
10495
10526
|
#
|
10496
10527
|
# @!attribute [rw] not_applicable_count
|
10497
10528
|
# The number of patches from the patch baseline that aren't
|
10498
|
-
# applicable for the
|
10499
|
-
#
|
10529
|
+
# applicable for the managed node and therefore aren't installed on
|
10530
|
+
# the node. This number may be truncated if the list of patch names is
|
10500
10531
|
# very large. The number of patches beyond this limit are reported in
|
10501
10532
|
# `UnreportedNotApplicableCount`.
|
10502
10533
|
# @return [Integer]
|
10503
10534
|
#
|
10504
10535
|
# @!attribute [rw] operation_start_time
|
10505
10536
|
# The time the most recent patching operation was started on the
|
10506
|
-
#
|
10537
|
+
# managed node.
|
10507
10538
|
# @return [Time]
|
10508
10539
|
#
|
10509
10540
|
# @!attribute [rw] operation_end_time
|
10510
|
-
# The time the most recent patching operation completed on the
|
10511
|
-
#
|
10541
|
+
# The time the most recent patching operation completed on the managed
|
10542
|
+
# node.
|
10512
10543
|
# @return [Time]
|
10513
10544
|
#
|
10514
10545
|
# @!attribute [rw] operation
|
@@ -10520,8 +10551,8 @@ module Aws::SSM
|
|
10520
10551
|
# @return [String]
|
10521
10552
|
#
|
10522
10553
|
# @!attribute [rw] last_no_reboot_install_operation_time
|
10523
|
-
# The time of the last attempt to patch the
|
10524
|
-
# specified as the reboot option.
|
10554
|
+
# The time of the last attempt to patch the managed node with
|
10555
|
+
# `NoReboot` specified as the reboot option.
|
10525
10556
|
# @return [Time]
|
10526
10557
|
#
|
10527
10558
|
# @!attribute [rw] reboot_option
|
@@ -10532,8 +10563,8 @@ module Aws::SSM
|
|
10532
10563
|
#
|
10533
10564
|
# </note>
|
10534
10565
|
#
|
10535
|
-
# * `RebootIfNeeded`\: Patch Manager tries to reboot the
|
10536
|
-
# it installed any patches, or if any patches are detected with a
|
10566
|
+
# * `RebootIfNeeded`\: Patch Manager tries to reboot the managed node
|
10567
|
+
# if it installed any patches, or if any patches are detected with a
|
10537
10568
|
# status of `InstalledPendingReboot`.
|
10538
10569
|
#
|
10539
10570
|
# * `NoReboot`\: Patch Manager attempts to install missing packages
|
@@ -10543,25 +10574,26 @@ module Aws::SSM
|
|
10543
10574
|
# @return [String]
|
10544
10575
|
#
|
10545
10576
|
# @!attribute [rw] critical_non_compliant_count
|
10546
|
-
# The number of
|
10577
|
+
# The number of managed nodes where patches that are specified as
|
10547
10578
|
# `Critical` for compliance reporting in the patch baseline aren't
|
10548
10579
|
# installed. These patches might be missing, have failed installation,
|
10549
|
-
# were rejected, or were installed but awaiting a required
|
10550
|
-
# reboot. The status of these
|
10580
|
+
# were rejected, or were installed but awaiting a required managed
|
10581
|
+
# node reboot. The status of these managed nodes is `NON_COMPLIANT`.
|
10551
10582
|
# @return [Integer]
|
10552
10583
|
#
|
10553
10584
|
# @!attribute [rw] security_non_compliant_count
|
10554
|
-
# The number of
|
10585
|
+
# The number of managed nodes where patches that are specified as
|
10555
10586
|
# `Security` in a patch advisory aren't installed. These patches
|
10556
10587
|
# might be missing, have failed installation, were rejected, or were
|
10557
|
-
# installed but awaiting a required
|
10558
|
-
# these
|
10588
|
+
# installed but awaiting a required managed node reboot. The status of
|
10589
|
+
# these managed nodes is `NON_COMPLIANT`.
|
10559
10590
|
# @return [Integer]
|
10560
10591
|
#
|
10561
10592
|
# @!attribute [rw] other_non_compliant_count
|
10562
|
-
# The number of
|
10563
|
-
# other than `Critical` or `Security` but aren't
|
10564
|
-
# patch baseline. The status of these
|
10593
|
+
# The number of managed nodes with patches installed that are
|
10594
|
+
# specified as other than `Critical` or `Security` but aren't
|
10595
|
+
# compliant with the patch baseline. The status of these managed nodes
|
10596
|
+
# is `NON_COMPLIANT`.
|
10565
10597
|
# @return [Integer]
|
10566
10598
|
#
|
10567
10599
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstancePatchState AWS API Documentation
|
@@ -10596,9 +10628,9 @@ module Aws::SSM
|
|
10596
10628
|
# Defines a filter used in DescribeInstancePatchStatesForPatchGroup to
|
10597
10629
|
# scope down the information returned by the API.
|
10598
10630
|
#
|
10599
|
-
# **Example**\: To filter for all
|
10600
|
-
# than three patches with a `FailedCount` status, use the following
|
10601
|
-
# the filter:
|
10631
|
+
# **Example**\: To filter for all managed nodes in a patch group having
|
10632
|
+
# more than three patches with a `FailedCount` status, use the following
|
10633
|
+
# for the filter:
|
10602
10634
|
#
|
10603
10635
|
# * Value for `Key`\: `FailedCount`
|
10604
10636
|
#
|
@@ -10963,7 +10995,7 @@ module Aws::SSM
|
|
10963
10995
|
|
10964
10996
|
# The following problems can cause this exception:
|
10965
10997
|
#
|
10966
|
-
# * You don't have permission to access the
|
10998
|
+
# * You don't have permission to access the managed node.
|
10967
10999
|
#
|
10968
11000
|
# * Amazon Web Services Systems Manager Agent(SSM Agent) isn't running.
|
10969
11001
|
# Verify that SSM Agent is running.
|
@@ -10971,7 +11003,7 @@ module Aws::SSM
|
|
10971
11003
|
# * SSM Agent isn't registered with the SSM endpoint. Try reinstalling
|
10972
11004
|
# SSM Agent.
|
10973
11005
|
#
|
10974
|
-
# * The
|
11006
|
+
# * The managed node isn't in valid state. Valid states are: `Running`,
|
10975
11007
|
# `Pending`, `Stopped`, and `Stopping`. Invalid states are:
|
10976
11008
|
# `Shutting-down` and `Terminated`.
|
10977
11009
|
#
|
@@ -11194,7 +11226,7 @@ module Aws::SSM
|
|
11194
11226
|
class InvalidResourceId < Aws::EmptyStructure; end
|
11195
11227
|
|
11196
11228
|
# The resource type isn't valid. For example, if you are attempting to
|
11197
|
-
# tag an instance, the instance must be a registered
|
11229
|
+
# tag an EC2 instance, the instance must be a registered managed node.
|
11198
11230
|
#
|
11199
11231
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InvalidResourceType AWS API Documentation
|
11200
11232
|
#
|
@@ -11475,8 +11507,8 @@ module Aws::SSM
|
|
11475
11507
|
# @return [String]
|
11476
11508
|
#
|
11477
11509
|
# @!attribute [rw] values
|
11478
|
-
# Inventory filter values. Example: inventory filter where
|
11479
|
-
# IDs are specified as values
|
11510
|
+
# Inventory filter values. Example: inventory filter where managed
|
11511
|
+
# node IDs are specified as values
|
11480
11512
|
# `Key=AWS:InstanceInformation.InstanceId,Values= i-a12b3c4d5e6g,
|
11481
11513
|
# i-1a2b3c4d5e6,Type=Equal`.
|
11482
11514
|
# @return [Array<String>]
|
@@ -11543,7 +11575,7 @@ module Aws::SSM
|
|
11543
11575
|
include Aws::Structure
|
11544
11576
|
end
|
11545
11577
|
|
11546
|
-
# Information collected from managed
|
11578
|
+
# Information collected from managed nodes based on your inventory
|
11547
11579
|
# policy document
|
11548
11580
|
#
|
11549
11581
|
# @note When making an API call, you may pass InventoryItem
|
@@ -11670,9 +11702,9 @@ module Aws::SSM
|
|
11670
11702
|
# Inventory query results.
|
11671
11703
|
#
|
11672
11704
|
# @!attribute [rw] id
|
11673
|
-
# ID of the inventory result entity. For example, for managed
|
11674
|
-
# inventory the result will be the managed
|
11675
|
-
#
|
11705
|
+
# ID of the inventory result entity. For example, for managed node
|
11706
|
+
# inventory the result will be the managed node ID. For EC2 instance
|
11707
|
+
# inventory, the result will be the instance ID.
|
11676
11708
|
# @return [String]
|
11677
11709
|
#
|
11678
11710
|
# @!attribute [rw] data
|
@@ -11726,8 +11758,9 @@ module Aws::SSM
|
|
11726
11758
|
include Aws::Structure
|
11727
11759
|
end
|
11728
11760
|
|
11729
|
-
# The command ID and
|
11730
|
-
# invocations. Verify the command ID and the
|
11761
|
+
# The command ID and managed node ID you specified didn't match any
|
11762
|
+
# invocations. Verify the command ID and the managed node ID and try
|
11763
|
+
# again.
|
11731
11764
|
#
|
11732
11765
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InvocationDoesNotExist AWS API Documentation
|
11733
11766
|
#
|
@@ -11896,7 +11929,7 @@ module Aws::SSM
|
|
11896
11929
|
#
|
11897
11930
|
# <note markdown="1"> Filtering associations using the `InstanceID` attribute only returns
|
11898
11931
|
# legacy associations created using the `InstanceID` attribute.
|
11899
|
-
# Associations targeting the
|
11932
|
+
# Associations targeting the managed node that are part of the Target
|
11900
11933
|
# Attributes `ResourceGroup` or `Tags` aren't returned.
|
11901
11934
|
#
|
11902
11935
|
# </note>
|
@@ -11963,7 +11996,8 @@ module Aws::SSM
|
|
11963
11996
|
# @return [String]
|
11964
11997
|
#
|
11965
11998
|
# @!attribute [rw] instance_id
|
11966
|
-
# (Optional) The command execution details for a specific
|
11999
|
+
# (Optional) The command execution details for a specific managed node
|
12000
|
+
# ID.
|
11967
12001
|
# @return [String]
|
11968
12002
|
#
|
11969
12003
|
# @!attribute [rw] max_results
|
@@ -12039,11 +12073,11 @@ module Aws::SSM
|
|
12039
12073
|
# @return [String]
|
12040
12074
|
#
|
12041
12075
|
# @!attribute [rw] instance_id
|
12042
|
-
# (Optional) Lists commands issued against this
|
12076
|
+
# (Optional) Lists commands issued against this managed node ID.
|
12043
12077
|
#
|
12044
|
-
# <note markdown="1"> You can't specify
|
12078
|
+
# <note markdown="1"> You can't specify a managed node ID in the same command that you
|
12045
12079
|
# specify `Status` = `Pending`. This is because the command hasn't
|
12046
|
-
# reached the
|
12080
|
+
# reached the managed node yet.
|
12047
12081
|
#
|
12048
12082
|
# </note>
|
12049
12083
|
# @return [String]
|
@@ -12463,7 +12497,7 @@ module Aws::SSM
|
|
12463
12497
|
# }
|
12464
12498
|
#
|
12465
12499
|
# @!attribute [rw] instance_id
|
12466
|
-
# The
|
12500
|
+
# The managed node ID for which you want inventory information.
|
12467
12501
|
# @return [String]
|
12468
12502
|
#
|
12469
12503
|
# @!attribute [rw] type_name
|
@@ -12503,21 +12537,21 @@ module Aws::SSM
|
|
12503
12537
|
# @return [String]
|
12504
12538
|
#
|
12505
12539
|
# @!attribute [rw] instance_id
|
12506
|
-
# The
|
12540
|
+
# The managed node ID targeted by the request to query inventory
|
12507
12541
|
# information.
|
12508
12542
|
# @return [String]
|
12509
12543
|
#
|
12510
12544
|
# @!attribute [rw] schema_version
|
12511
|
-
# The inventory schema version used by the
|
12545
|
+
# The inventory schema version used by the managed node(s).
|
12512
12546
|
# @return [String]
|
12513
12547
|
#
|
12514
12548
|
# @!attribute [rw] capture_time
|
12515
|
-
# The time that inventory information was collected for the
|
12516
|
-
#
|
12549
|
+
# The time that inventory information was collected for the managed
|
12550
|
+
# node(s).
|
12517
12551
|
# @return [String]
|
12518
12552
|
#
|
12519
12553
|
# @!attribute [rw] entries
|
12520
|
-
# A list of inventory items on the
|
12554
|
+
# A list of inventory items on the managed node(s).
|
12521
12555
|
# @return [Array<Hash<String,String>>]
|
12522
12556
|
#
|
12523
12557
|
# @!attribute [rw] next_token
|
@@ -12763,7 +12797,7 @@ module Aws::SSM
|
|
12763
12797
|
end
|
12764
12798
|
|
12765
12799
|
# @!attribute [rw] resource_compliance_summary_items
|
12766
|
-
# A summary count for specified or targeted managed
|
12800
|
+
# A summary count for specified or targeted managed nodes. Summary
|
12767
12801
|
# count includes information about compliant and non-compliant State
|
12768
12802
|
# Manager associations, patch status, or custom items according to the
|
12769
12803
|
# filter criteria that you specify.
|
@@ -12878,7 +12912,7 @@ module Aws::SSM
|
|
12878
12912
|
end
|
12879
12913
|
|
12880
12914
|
# Information about an Amazon Simple Storage Service (Amazon S3) bucket
|
12881
|
-
# to write
|
12915
|
+
# to write managed node-level logs to.
|
12882
12916
|
#
|
12883
12917
|
# <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple Storage
|
12884
12918
|
# Service (Amazon S3) bucket to contain logs, instead use the
|
@@ -13429,7 +13463,7 @@ module Aws::SSM
|
|
13429
13463
|
#
|
13430
13464
|
# @!attribute [rw] notification_config
|
13431
13465
|
# Configurations for sending notifications about command status
|
13432
|
-
# changes on a per-
|
13466
|
+
# changes on a per-managed node basis.
|
13433
13467
|
# @return [Types::NotificationConfig]
|
13434
13468
|
#
|
13435
13469
|
# @!attribute [rw] output_s3_bucket_name
|
@@ -13470,7 +13504,7 @@ module Aws::SSM
|
|
13470
13504
|
:parameters,
|
13471
13505
|
:service_role_arn,
|
13472
13506
|
:timeout_seconds)
|
13473
|
-
SENSITIVE = []
|
13507
|
+
SENSITIVE = [:parameters]
|
13474
13508
|
include Aws::Structure
|
13475
13509
|
end
|
13476
13510
|
|
@@ -13539,9 +13573,9 @@ module Aws::SSM
|
|
13539
13573
|
# @return [String]
|
13540
13574
|
#
|
13541
13575
|
# @!attribute [rw] targets
|
13542
|
-
# The targets, either
|
13576
|
+
# The targets, either managed nodes or tags.
|
13543
13577
|
#
|
13544
|
-
# Specify
|
13578
|
+
# Specify managed nodes using the following format:
|
13545
13579
|
#
|
13546
13580
|
# `Key=instanceids,Values=<instanceid1>,<instanceid2>`
|
13547
13581
|
#
|
@@ -13601,8 +13635,9 @@ module Aws::SSM
|
|
13601
13635
|
# @return [String]
|
13602
13636
|
#
|
13603
13637
|
# @!attribute [rw] targets
|
13604
|
-
# The targets (either
|
13605
|
-
# using
|
13638
|
+
# The targets (either managed nodes or tags). Managed nodes are
|
13639
|
+
# specified using
|
13640
|
+
# `Key=instanceids,Values=<instanceid1>,<instanceid2>`. Tags are
|
13606
13641
|
# specified using `Key=<tag name>,Values=<tag value>`.
|
13607
13642
|
# @return [Array<Types::Target>]
|
13608
13643
|
#
|
@@ -13926,9 +13961,9 @@ module Aws::SSM
|
|
13926
13961
|
# * `Command`\: Receive notification when the status of a command
|
13927
13962
|
# changes.
|
13928
13963
|
#
|
13929
|
-
# * `Invocation`\: For commands sent to multiple
|
13930
|
-
# notification on a per-
|
13931
|
-
# changes.
|
13964
|
+
# * `Invocation`\: For commands sent to multiple managed nodes,
|
13965
|
+
# receive notification on a per-node basis when the status of a
|
13966
|
+
# command changes.
|
13932
13967
|
# @return [String]
|
13933
13968
|
#
|
13934
13969
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NotificationConfig AWS API Documentation
|
@@ -15325,8 +15360,8 @@ module Aws::SSM
|
|
15325
15360
|
# and GetParametersByPath API operations. However, not all of the
|
15326
15361
|
# pattern values listed for `Key` can be used with both operations.
|
15327
15362
|
#
|
15328
|
-
# For `
|
15329
|
-
# `Label`.
|
15363
|
+
# For `DescribeParameters`, all of the listed patterns are valid
|
15364
|
+
# except `Label`.
|
15330
15365
|
#
|
15331
15366
|
# For `GetParametersByPath`, the following patterns listed for `Key`
|
15332
15367
|
# aren't valid: `tag`, `DataType`, `Name`, `Path`, and `Tier`.
|
@@ -15487,45 +15522,45 @@ module Aws::SSM
|
|
15487
15522
|
#
|
15488
15523
|
# @!attribute [rw] advisory_ids
|
15489
15524
|
# The Advisory ID of the patch. For example, `RHSA-2020:3779`. Applies
|
15490
|
-
# to Linux-based
|
15525
|
+
# to Linux-based managed nodes only.
|
15491
15526
|
# @return [Array<String>]
|
15492
15527
|
#
|
15493
15528
|
# @!attribute [rw] bugzilla_ids
|
15494
15529
|
# The Bugzilla ID of the patch. For example, `1600646`. Applies to
|
15495
|
-
# Linux-based
|
15530
|
+
# Linux-based managed nodes only.
|
15496
15531
|
# @return [Array<String>]
|
15497
15532
|
#
|
15498
15533
|
# @!attribute [rw] cve_ids
|
15499
15534
|
# The Common Vulnerabilities and Exposures (CVE) ID of the patch. For
|
15500
|
-
# example, `CVE-2011-3192`. Applies to Linux-based
|
15535
|
+
# example, `CVE-2011-3192`. Applies to Linux-based managed nodes only.
|
15501
15536
|
# @return [Array<String>]
|
15502
15537
|
#
|
15503
15538
|
# @!attribute [rw] name
|
15504
|
-
# The name of the patch. Applies to Linux-based
|
15539
|
+
# The name of the patch. Applies to Linux-based managed nodes only.
|
15505
15540
|
# @return [String]
|
15506
15541
|
#
|
15507
15542
|
# @!attribute [rw] epoch
|
15508
15543
|
# The epoch of the patch. For example in
|
15509
15544
|
# `pkg-example-EE-20180914-2.2.amzn1.noarch`, the epoch value is
|
15510
|
-
# `20180914-2`. Applies to Linux-based
|
15545
|
+
# `20180914-2`. Applies to Linux-based managed nodes only.
|
15511
15546
|
# @return [Integer]
|
15512
15547
|
#
|
15513
15548
|
# @!attribute [rw] version
|
15514
15549
|
# The version number of the patch. For example, in
|
15515
15550
|
# `example-pkg-1.710.10-2.7.abcd.x86_64`, the version number is
|
15516
|
-
# indicated by `-1`. Applies to Linux-based
|
15551
|
+
# indicated by `-1`. Applies to Linux-based managed nodes only.
|
15517
15552
|
# @return [String]
|
15518
15553
|
#
|
15519
15554
|
# @!attribute [rw] release
|
15520
15555
|
# The particular release of a patch. For example, in
|
15521
15556
|
# `pkg-example-EE-20180914-2.2.amzn1.noarch`, the release is
|
15522
|
-
# `2.amaz1`. Applies to Linux-based
|
15557
|
+
# `2.amaz1`. Applies to Linux-based managed nodes only.
|
15523
15558
|
# @return [String]
|
15524
15559
|
#
|
15525
15560
|
# @!attribute [rw] arch
|
15526
15561
|
# The architecture of the patch. For example, in
|
15527
15562
|
# `example-pkg-0.710.10-2.7.abcd.x86_64`, the architecture is
|
15528
|
-
# indicated by `x86_64`. Applies to Linux-based
|
15563
|
+
# indicated by `x86_64`. Applies to Linux-based managed nodes only.
|
15529
15564
|
# @return [String]
|
15530
15565
|
#
|
15531
15566
|
# @!attribute [rw] severity
|
@@ -15537,7 +15572,7 @@ module Aws::SSM
|
|
15537
15572
|
# The source patch repository for the operating system and version,
|
15538
15573
|
# such as `trusty-security` for Ubuntu Server 14.04 LTE and
|
15539
15574
|
# `focal-security` for Ubuntu Server 20.04 LTE. Applies to Linux-based
|
15540
|
-
#
|
15575
|
+
# managed nodes only.
|
15541
15576
|
# @return [String]
|
15542
15577
|
#
|
15543
15578
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Patch AWS API Documentation
|
@@ -15608,8 +15643,8 @@ module Aws::SSM
|
|
15608
15643
|
include Aws::Structure
|
15609
15644
|
end
|
15610
15645
|
|
15611
|
-
# Information about the state of a patch on a particular
|
15612
|
-
# relates to the patch baseline used to patch the
|
15646
|
+
# Information about the state of a patch on a particular managed node as
|
15647
|
+
# it relates to the patch baseline used to patch the node.
|
15613
15648
|
#
|
15614
15649
|
# @!attribute [rw] title
|
15615
15650
|
# The title of the patch.
|
@@ -15630,7 +15665,8 @@ module Aws::SSM
|
|
15630
15665
|
# @return [String]
|
15631
15666
|
#
|
15632
15667
|
# @!attribute [rw] state
|
15633
|
-
# The state of the patch on the
|
15668
|
+
# The state of the patch on the managed node, such as INSTALLED or
|
15669
|
+
# FAILED.
|
15634
15670
|
#
|
15635
15671
|
# For descriptions of each patch state, see [About patch
|
15636
15672
|
# compliance][1] in the *Amazon Web Services Systems Manager User
|
@@ -15642,7 +15678,7 @@ module Aws::SSM
|
|
15642
15678
|
# @return [String]
|
15643
15679
|
#
|
15644
15680
|
# @!attribute [rw] installed_time
|
15645
|
-
# The date/time the patch was installed on the
|
15681
|
+
# The date/time the patch was installed on the managed node. Not all
|
15646
15682
|
# operating systems provide this level of information.
|
15647
15683
|
# @return [Time]
|
15648
15684
|
#
|
@@ -15846,10 +15882,10 @@ module Aws::SSM
|
|
15846
15882
|
# @return [String]
|
15847
15883
|
#
|
15848
15884
|
# @!attribute [rw] enable_non_security
|
15849
|
-
# For
|
15885
|
+
# For managed nodes identified by the approval rule filters, enables a
|
15850
15886
|
# patch baseline to apply non-security updates available in the
|
15851
15887
|
# specified repository. The default value is `false`. Applies to Linux
|
15852
|
-
#
|
15888
|
+
# managed nodes only.
|
15853
15889
|
# @return [Boolean]
|
15854
15890
|
#
|
15855
15891
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PatchRule AWS API Documentation
|
@@ -15900,9 +15936,9 @@ module Aws::SSM
|
|
15900
15936
|
include Aws::Structure
|
15901
15937
|
end
|
15902
15938
|
|
15903
|
-
# Information about the patches to use to update the
|
15939
|
+
# Information about the patches to use to update the managed nodes,
|
15904
15940
|
# including target operating systems and source repository. Applies to
|
15905
|
-
# Linux
|
15941
|
+
# Linux managed nodes only.
|
15906
15942
|
#
|
15907
15943
|
# @note When making an API call, you may pass PatchSource
|
15908
15944
|
# data as a hash:
|
@@ -16068,8 +16104,8 @@ module Aws::SSM
|
|
16068
16104
|
# }
|
16069
16105
|
#
|
16070
16106
|
# @!attribute [rw] resource_id
|
16071
|
-
# Specify an ID for this resource. For a managed
|
16072
|
-
#
|
16107
|
+
# Specify an ID for this resource. For a managed node, this is the
|
16108
|
+
# node ID.
|
16073
16109
|
# @return [String]
|
16074
16110
|
#
|
16075
16111
|
# @!attribute [rw] resource_type
|
@@ -16160,11 +16196,11 @@ module Aws::SSM
|
|
16160
16196
|
# }
|
16161
16197
|
#
|
16162
16198
|
# @!attribute [rw] instance_id
|
16163
|
-
# An
|
16199
|
+
# An managed node ID where you want to add or update inventory items.
|
16164
16200
|
# @return [String]
|
16165
16201
|
#
|
16166
16202
|
# @!attribute [rw] items
|
16167
|
-
# The inventory items that you want to add or update on
|
16203
|
+
# The inventory items that you want to add or update on managed nodes.
|
16168
16204
|
# @return [Array<Types::InventoryItem>]
|
16169
16205
|
#
|
16170
16206
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PutInventoryRequest AWS API Documentation
|
@@ -16435,15 +16471,15 @@ module Aws::SSM
|
|
16435
16471
|
# the expiration time is reached, Parameter Store deletes the
|
16436
16472
|
# parameter.
|
16437
16473
|
#
|
16438
|
-
# ExpirationNotification: This policy
|
16474
|
+
# ExpirationNotification: This policy initiates an event in Amazon
|
16439
16475
|
# CloudWatch Events that notifies you about the expiration. By using
|
16440
16476
|
# this policy, you can receive notification before or after the
|
16441
16477
|
# expiration time is reached, in units of days or hours.
|
16442
16478
|
#
|
16443
|
-
# NoChangeNotification: This policy
|
16444
|
-
# if a parameter hasn't been modified for a specified period of
|
16445
|
-
# This policy type is useful when, for example, a secret needs
|
16446
|
-
# changed within a period of time, but it hasn't been changed.
|
16479
|
+
# NoChangeNotification: This policy initiates a CloudWatch Events
|
16480
|
+
# event if a parameter hasn't been modified for a specified period of
|
16481
|
+
# time. This policy type is useful when, for example, a secret needs
|
16482
|
+
# to be changed within a period of time, but it hasn't been changed.
|
16447
16483
|
#
|
16448
16484
|
# All existing policies are preserved until you send new policies or
|
16449
16485
|
# an empty policy. For more information about parameter policies, see
|
@@ -16622,7 +16658,8 @@ module Aws::SSM
|
|
16622
16658
|
#
|
16623
16659
|
# @!attribute [rw] targets
|
16624
16660
|
# The targets to register with the maintenance window. In other words,
|
16625
|
-
# the
|
16661
|
+
# the managed nodes to run commands on when the maintenance window
|
16662
|
+
# runs.
|
16626
16663
|
#
|
16627
16664
|
# <note markdown="1"> If a single maintenance window task is registered with multiple
|
16628
16665
|
# targets, its task invocations occur sequentially and not in
|
@@ -16632,35 +16669,33 @@ module Aws::SSM
|
|
16632
16669
|
#
|
16633
16670
|
# </note>
|
16634
16671
|
#
|
16635
|
-
# You can specify targets using
|
16636
|
-
# tags that have been applied to
|
16672
|
+
# You can specify targets using managed node IDs, resource group
|
16673
|
+
# names, or tags that have been applied to managed nodes.
|
16637
16674
|
#
|
16638
|
-
# **Example 1**\: Specify
|
16675
|
+
# **Example 1**\: Specify managed node IDs
|
16639
16676
|
#
|
16640
|
-
# `Key=InstanceIds,Values
|
16677
|
+
# `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>,<instance-id-3>`
|
16641
16678
|
#
|
16642
|
-
# **Example 2**\: Use tag key-pairs applied to
|
16679
|
+
# **Example 2**\: Use tag key-pairs applied to managed nodes
|
16643
16680
|
#
|
16644
|
-
# `Key=tag
|
16681
|
+
# `Key=tag:<my-tag-key>,Values=<my-tag-value-1>,<my-tag-value-2>`
|
16645
16682
|
#
|
16646
|
-
# **Example 3**\: Use tag-keys applied to
|
16683
|
+
# **Example 3**\: Use tag-keys applied to managed nodes
|
16647
16684
|
#
|
16648
|
-
# `Key=tag-key,Values
|
16685
|
+
# `Key=tag-key,Values=<my-tag-key-1>,<my-tag-key-2>`
|
16649
16686
|
#
|
16650
16687
|
# **Example 4**\: Use resource group names
|
16651
16688
|
#
|
16652
|
-
# `Key=resource-groups:Name,Values
|
16689
|
+
# `Key=resource-groups:Name,Values=<resource-group-name>`
|
16653
16690
|
#
|
16654
16691
|
# **Example 5**\: Use filters for resource group types
|
16655
16692
|
#
|
16656
|
-
# `Key=resource-groups:ResourceTypeFilters,Values
|
16657
|
-
# `
|
16693
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=<resource-type-1>,<resource-type-2>`
|
16658
16694
|
#
|
16659
16695
|
# <note markdown="1"> For `Key=resource-groups:ResourceTypeFilters`, specify resource
|
16660
16696
|
# types in the following format
|
16661
16697
|
#
|
16662
|
-
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC
|
16663
|
-
# `
|
16698
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC`
|
16664
16699
|
#
|
16665
16700
|
# </note>
|
16666
16701
|
#
|
@@ -16798,7 +16833,7 @@ module Aws::SSM
|
|
16798
16833
|
# @return [String]
|
16799
16834
|
#
|
16800
16835
|
# @!attribute [rw] targets
|
16801
|
-
# The targets (either
|
16836
|
+
# The targets (either managed nodes or maintenance window targets).
|
16802
16837
|
#
|
16803
16838
|
# <note markdown="1"> One or more targets must be specified for maintenance window Run
|
16804
16839
|
# Command-type tasks. Depending on the task, targets are optional for
|
@@ -16809,7 +16844,7 @@ module Aws::SSM
|
|
16809
16844
|
#
|
16810
16845
|
# </note>
|
16811
16846
|
#
|
16812
|
-
# Specify
|
16847
|
+
# Specify managed nodes using the following format:
|
16813
16848
|
#
|
16814
16849
|
# `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
|
16815
16850
|
#
|
@@ -16902,7 +16937,7 @@ module Aws::SSM
|
|
16902
16937
|
#
|
16903
16938
|
# @!attribute [rw] logging_info
|
16904
16939
|
# A structure containing information about an Amazon Simple Storage
|
16905
|
-
# Service (Amazon S3) bucket to write
|
16940
|
+
# Service (Amazon S3) bucket to write managed node-level logs to.
|
16906
16941
|
#
|
16907
16942
|
# <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple
|
16908
16943
|
# Storage Service (Amazon S3) bucket to contain logs, instead use the
|
@@ -16986,6 +17021,33 @@ module Aws::SSM
|
|
16986
17021
|
include Aws::Structure
|
16987
17022
|
end
|
16988
17023
|
|
17024
|
+
# Reserved for internal use.
|
17025
|
+
#
|
17026
|
+
# @note When making an API call, you may pass RegistrationMetadataItem
|
17027
|
+
# data as a hash:
|
17028
|
+
#
|
17029
|
+
# {
|
17030
|
+
# key: "RegistrationMetadataKey", # required
|
17031
|
+
# value: "RegistrationMetadataValue", # required
|
17032
|
+
# }
|
17033
|
+
#
|
17034
|
+
# @!attribute [rw] key
|
17035
|
+
# Reserved for internal use.
|
17036
|
+
# @return [String]
|
17037
|
+
#
|
17038
|
+
# @!attribute [rw] value
|
17039
|
+
# Reserved for internal use.
|
17040
|
+
# @return [String]
|
17041
|
+
#
|
17042
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/RegistrationMetadataItem AWS API Documentation
|
17043
|
+
#
|
17044
|
+
class RegistrationMetadataItem < Struct.new(
|
17045
|
+
:key,
|
17046
|
+
:value)
|
17047
|
+
SENSITIVE = []
|
17048
|
+
include Aws::Structure
|
17049
|
+
end
|
17050
|
+
|
16989
17051
|
# An OpsItems that shares something in common with the current OpsItem.
|
16990
17052
|
# For example, related OpsItems can include OpsItems with similar error
|
16991
17053
|
# messages, impacted resources, or statuses for the impacted resource.
|
@@ -17022,8 +17084,8 @@ module Aws::SSM
|
|
17022
17084
|
# The type of resource from which you want to remove a tag.
|
17023
17085
|
#
|
17024
17086
|
# <note markdown="1"> The `ManagedInstance` type for this API operation is only for
|
17025
|
-
# on-premises managed
|
17026
|
-
#
|
17087
|
+
# on-premises managed nodes. Specify the name of the managed node in
|
17088
|
+
# the following format: `mi-ID_number `. For example,
|
17027
17089
|
# `mi-1a2b3c4d5e6f`.
|
17028
17090
|
#
|
17029
17091
|
# </note>
|
@@ -17050,10 +17112,9 @@ module Aws::SSM
|
|
17050
17112
|
#
|
17051
17113
|
# For the Document and Parameter values, use the name of the resource.
|
17052
17114
|
#
|
17053
|
-
# <note markdown="1"> The ManagedInstance type for this API operation is only for
|
17054
|
-
# on-premises managed
|
17055
|
-
#
|
17056
|
-
# mi-1a2b3c4d5e6f.
|
17115
|
+
# <note markdown="1"> The `ManagedInstance` type for this API operation is only for
|
17116
|
+
# on-premises managed nodes. Specify the name of the managed node in
|
17117
|
+
# the following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
|
17057
17118
|
#
|
17058
17119
|
# </note>
|
17059
17120
|
# @return [String]
|
@@ -17709,13 +17770,13 @@ module Aws::SSM
|
|
17709
17770
|
#
|
17710
17771
|
# @!attribute [rw] token_value
|
17711
17772
|
# An encrypted token value containing session and caller information.
|
17712
|
-
# Used to authenticate the connection to the
|
17773
|
+
# Used to authenticate the connection to the managed node.
|
17713
17774
|
# @return [String]
|
17714
17775
|
#
|
17715
17776
|
# @!attribute [rw] stream_url
|
17716
|
-
# A URL back to SSM Agent on the
|
17717
|
-
# client uses to send commands and receive output from the
|
17718
|
-
# Format:
|
17777
|
+
# A URL back to SSM Agent on the managed node that the Session Manager
|
17778
|
+
# client uses to send commands and receive output from the managed
|
17779
|
+
# node. Format:
|
17719
17780
|
# `wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output)`.
|
17720
17781
|
#
|
17721
17782
|
# **region** represents the Region identifier for an Amazon Web
|
@@ -18027,15 +18088,16 @@ module Aws::SSM
|
|
18027
18088
|
# }
|
18028
18089
|
#
|
18029
18090
|
# @!attribute [rw] instance_ids
|
18030
|
-
# The IDs of the
|
18031
|
-
#
|
18032
|
-
# of
|
18091
|
+
# The IDs of the managed nodes where the command should run.
|
18092
|
+
# Specifying managed node IDs is most useful when you are targeting a
|
18093
|
+
# limited number of managed nodes, though you can specify up to 50
|
18094
|
+
# IDs.
|
18033
18095
|
#
|
18034
|
-
# To target a larger number of
|
18035
|
-
# individual
|
18096
|
+
# To target a larger number of managed nodes, or if you prefer not to
|
18097
|
+
# list individual node IDs, we recommend using the `Targets` option
|
18036
18098
|
# instead. Using `Targets`, which accepts tag key-value pairs to
|
18037
|
-
# identify the
|
18038
|
-
# to tens, hundreds, or thousands of
|
18099
|
+
# identify the managed nodes to send commands to, you can a send
|
18100
|
+
# command to tens, hundreds, or thousands of nodes at once.
|
18039
18101
|
#
|
18040
18102
|
# For more information about how to use targets, see [Using targets
|
18041
18103
|
# and rate controls to send commands to a fleet][1] in the *Amazon Web
|
@@ -18047,15 +18109,15 @@ module Aws::SSM
|
|
18047
18109
|
# @return [Array<String>]
|
18048
18110
|
#
|
18049
18111
|
# @!attribute [rw] targets
|
18050
|
-
# An array of search criteria that targets
|
18112
|
+
# An array of search criteria that targets managed nodes using a
|
18051
18113
|
# `Key,Value` combination that you specify. Specifying targets is most
|
18052
|
-
# useful when you want to send a command to a large number of
|
18053
|
-
#
|
18054
|
-
#
|
18055
|
-
#
|
18114
|
+
# useful when you want to send a command to a large number of managed
|
18115
|
+
# nodes at once. Using `Targets`, which accepts tag key-value pairs to
|
18116
|
+
# identify managed nodes, you can send a command to tens, hundreds, or
|
18117
|
+
# thousands of nodes at once.
|
18056
18118
|
#
|
18057
|
-
# To send a command to a smaller number of
|
18058
|
-
# `InstanceIds` option instead.
|
18119
|
+
# To send a command to a smaller number of managed nodes, you can use
|
18120
|
+
# the `InstanceIds` option instead.
|
18059
18121
|
#
|
18060
18122
|
# For more information about how to use targets, see [Sending commands
|
18061
18123
|
# to a fleet][1] in the *Amazon Web Services Systems Manager User
|
@@ -18149,9 +18211,9 @@ module Aws::SSM
|
|
18149
18211
|
# @return [String]
|
18150
18212
|
#
|
18151
18213
|
# @!attribute [rw] max_concurrency
|
18152
|
-
# (Optional) The maximum number of
|
18153
|
-
# the command at the same time. You can specify a number such as
|
18154
|
-
# a percentage such as 10%. The default value is `50`. For more
|
18214
|
+
# (Optional) The maximum number of managed nodes that are allowed to
|
18215
|
+
# run the command at the same time. You can specify a number such as
|
18216
|
+
# 10 or a percentage such as 10%. The default value is `50`. For more
|
18155
18217
|
# information about how to use `MaxConcurrency`, see [Using
|
18156
18218
|
# concurrency controls][1] in the *Amazon Web Services Systems Manager
|
18157
18219
|
# User Guide*.
|
@@ -18211,7 +18273,7 @@ module Aws::SSM
|
|
18211
18273
|
:service_role_arn,
|
18212
18274
|
:notification_config,
|
18213
18275
|
:cloud_watch_output_config)
|
18214
|
-
SENSITIVE = []
|
18276
|
+
SENSITIVE = [:parameters]
|
18215
18277
|
include Aws::Structure
|
18216
18278
|
end
|
18217
18279
|
|
@@ -18311,14 +18373,14 @@ module Aws::SSM
|
|
18311
18373
|
include Aws::Structure
|
18312
18374
|
end
|
18313
18375
|
|
18314
|
-
# Information about a Session Manager connection to
|
18376
|
+
# Information about a Session Manager connection to a managed node.
|
18315
18377
|
#
|
18316
18378
|
# @!attribute [rw] session_id
|
18317
18379
|
# The ID of the session.
|
18318
18380
|
# @return [String]
|
18319
18381
|
#
|
18320
18382
|
# @!attribute [rw] target
|
18321
|
-
# The
|
18383
|
+
# The managed node that the Session Manager session connected to.
|
18322
18384
|
# @return [String]
|
18323
18385
|
#
|
18324
18386
|
# @!attribute [rw] status
|
@@ -18347,6 +18409,10 @@ module Aws::SSM
|
|
18347
18409
|
# session.
|
18348
18410
|
# @return [String]
|
18349
18411
|
#
|
18412
|
+
# @!attribute [rw] reason
|
18413
|
+
# The reason for connecting to the instance.
|
18414
|
+
# @return [String]
|
18415
|
+
#
|
18350
18416
|
# @!attribute [rw] details
|
18351
18417
|
# Reserved for future use.
|
18352
18418
|
# @return [String]
|
@@ -18355,6 +18421,10 @@ module Aws::SSM
|
|
18355
18421
|
# Reserved for future use.
|
18356
18422
|
# @return [Types::SessionManagerOutputUrl]
|
18357
18423
|
#
|
18424
|
+
# @!attribute [rw] max_session_duration
|
18425
|
+
# The maximum duration of a session before it terminates.
|
18426
|
+
# @return [String]
|
18427
|
+
#
|
18358
18428
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Session AWS API Documentation
|
18359
18429
|
#
|
18360
18430
|
class Session < Struct.new(
|
@@ -18365,8 +18435,10 @@ module Aws::SSM
|
|
18365
18435
|
:end_date,
|
18366
18436
|
:document_name,
|
18367
18437
|
:owner,
|
18438
|
+
:reason,
|
18368
18439
|
:details,
|
18369
|
-
:output_url
|
18440
|
+
:output_url,
|
18441
|
+
:max_session_duration)
|
18370
18442
|
SENSITIVE = []
|
18371
18443
|
include Aws::Structure
|
18372
18444
|
end
|
@@ -18396,8 +18468,8 @@ module Aws::SSM
|
|
18396
18468
|
# example, specify 2018-08-29T00:00:00Z to see sessions that started
|
18397
18469
|
# before August 29, 2018.
|
18398
18470
|
#
|
18399
|
-
# * Target: Specify
|
18400
|
-
# made.
|
18471
|
+
# * Target: Specify a managed node to which session connections have
|
18472
|
+
# been made.
|
18401
18473
|
#
|
18402
18474
|
# * Owner: Specify an Amazon Web Services user account to see a list
|
18403
18475
|
# of sessions started by that user.
|
@@ -18449,7 +18521,7 @@ module Aws::SSM
|
|
18449
18521
|
include Aws::Structure
|
18450
18522
|
end
|
18451
18523
|
|
18452
|
-
# The number of managed
|
18524
|
+
# The number of managed nodes found for each patch severity level
|
18453
18525
|
# defined in the request filter.
|
18454
18526
|
#
|
18455
18527
|
# @!attribute [rw] critical_count
|
@@ -18877,13 +18949,14 @@ module Aws::SSM
|
|
18877
18949
|
# {
|
18878
18950
|
# target: "SessionTarget", # required
|
18879
18951
|
# document_name: "DocumentARN",
|
18952
|
+
# reason: "SessionReason",
|
18880
18953
|
# parameters: {
|
18881
18954
|
# "SessionManagerParameterName" => ["SessionManagerParameterValue"],
|
18882
18955
|
# },
|
18883
18956
|
# }
|
18884
18957
|
#
|
18885
18958
|
# @!attribute [rw] target
|
18886
|
-
# The
|
18959
|
+
# The managed node to connect to for the session.
|
18887
18960
|
# @return [String]
|
18888
18961
|
#
|
18889
18962
|
# @!attribute [rw] document_name
|
@@ -18891,7 +18964,13 @@ module Aws::SSM
|
|
18891
18964
|
# settings for the session. For example, `SSM-SessionManagerRunShell`.
|
18892
18965
|
# You can call the GetDocument API to verify the document exists
|
18893
18966
|
# before attempting to start a session. If no document name is
|
18894
|
-
# provided, a shell to the
|
18967
|
+
# provided, a shell to the managed node is launched by default.
|
18968
|
+
# @return [String]
|
18969
|
+
#
|
18970
|
+
# @!attribute [rw] reason
|
18971
|
+
# The reason for connecting to the instance. This value is included in
|
18972
|
+
# the details for the Amazon CloudWatch Events event created when you
|
18973
|
+
# start the session.
|
18895
18974
|
# @return [String]
|
18896
18975
|
#
|
18897
18976
|
# @!attribute [rw] parameters
|
@@ -18903,6 +18982,7 @@ module Aws::SSM
|
|
18903
18982
|
class StartSessionRequest < Struct.new(
|
18904
18983
|
:target,
|
18905
18984
|
:document_name,
|
18985
|
+
:reason,
|
18906
18986
|
:parameters)
|
18907
18987
|
SENSITIVE = []
|
18908
18988
|
include Aws::Structure
|
@@ -18914,12 +18994,12 @@ module Aws::SSM
|
|
18914
18994
|
#
|
18915
18995
|
# @!attribute [rw] token_value
|
18916
18996
|
# An encrypted token value containing session and caller information.
|
18917
|
-
# Used to authenticate the connection to the
|
18997
|
+
# Used to authenticate the connection to the managed node.
|
18918
18998
|
# @return [String]
|
18919
18999
|
#
|
18920
19000
|
# @!attribute [rw] stream_url
|
18921
|
-
# A URL back to SSM Agent on the
|
18922
|
-
# client uses to send commands and receive output from the
|
19001
|
+
# A URL back to SSM Agent on the managed node that the Session Manager
|
19002
|
+
# client uses to send commands and receive output from the node.
|
18923
19003
|
# Format:
|
18924
19004
|
# `wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output)`
|
18925
19005
|
#
|
@@ -19164,7 +19244,7 @@ module Aws::SSM
|
|
19164
19244
|
# enable you to categorize your resources in different ways, for
|
19165
19245
|
# example, by purpose, owner, or environment. In Amazon Web Services
|
19166
19246
|
# Systems Manager, you can apply tags to Systems Manager documents (SSM
|
19167
|
-
# documents), managed
|
19247
|
+
# documents), managed nodes, maintenance windows, parameters, patch
|
19168
19248
|
# baselines, OpsItems, and OpsMetadata.
|
19169
19249
|
#
|
19170
19250
|
# @note When making an API call, you may pass Tag
|
@@ -19192,8 +19272,8 @@ module Aws::SSM
|
|
19192
19272
|
include Aws::Structure
|
19193
19273
|
end
|
19194
19274
|
|
19195
|
-
# An array of search criteria that targets
|
19196
|
-
# pair that you specify.
|
19275
|
+
# An array of search criteria that targets managed nodes using a
|
19276
|
+
# key-value pair that you specify.
|
19197
19277
|
#
|
19198
19278
|
# <note markdown="1"> One or more targets must be specified for maintenance window Run
|
19199
19279
|
# Command-type tasks. Depending on the task, targets are optional for
|
@@ -19206,21 +19286,20 @@ module Aws::SSM
|
|
19206
19286
|
#
|
19207
19287
|
# Supported formats include the following.
|
19208
19288
|
#
|
19209
|
-
# * `Key=InstanceIds,Values
|
19289
|
+
# * `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>,<instance-id-3>`
|
19210
19290
|
#
|
19211
|
-
# * `Key=tag
|
19291
|
+
# * `Key=tag:<my-tag-key>,Values=<my-tag-value-1>,<my-tag-value-2>`
|
19212
19292
|
#
|
19213
|
-
# * `Key=tag-key,Values
|
19293
|
+
# * `Key=tag-key,Values=<my-tag-key-1>,<my-tag-key-2>`
|
19214
19294
|
#
|
19215
19295
|
# * **Run Command and Maintenance window targets only**\:
|
19216
|
-
# `Key=resource-groups:Name,Values
|
19296
|
+
# `Key=resource-groups:Name,Values=<resource-group-name>`
|
19217
19297
|
#
|
19218
19298
|
# * **Maintenance window targets only**\:
|
19219
|
-
# `Key=resource-groups:ResourceTypeFilters,Values
|
19220
|
-
# `
|
19299
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=<resource-type-1>,<resource-type-2>`
|
19221
19300
|
#
|
19222
19301
|
# * **Automation targets only**\:
|
19223
|
-
# `Key=ResourceGroup;Values
|
19302
|
+
# `Key=ResourceGroup;Values=<resource-group-name>`
|
19224
19303
|
#
|
19225
19304
|
# For example:
|
19226
19305
|
#
|
@@ -19238,8 +19317,7 @@ module Aws::SSM
|
|
19238
19317
|
# window.
|
19239
19318
|
#
|
19240
19319
|
# * **Maintenance window targets only**\:
|
19241
|
-
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC
|
19242
|
-
# `
|
19320
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC`
|
19243
19321
|
#
|
19244
19322
|
# This example demonstrates how to target only Amazon Elastic Compute
|
19245
19323
|
# Cloud (Amazon EC2) instances and VPCs in your maintenance window.
|
@@ -19248,14 +19326,14 @@ module Aws::SSM
|
|
19248
19326
|
# `Key=ResourceGroup,Values=MyResourceGroup`
|
19249
19327
|
#
|
19250
19328
|
# * **State Manager association targets only**\:
|
19251
|
-
# `Key=InstanceIds,Values
|
19329
|
+
# `Key=InstanceIds,Values=*`
|
19252
19330
|
#
|
19253
19331
|
# This example demonstrates how to target all managed instances in the
|
19254
19332
|
# Amazon Web Services Region where the association was created.
|
19255
19333
|
#
|
19256
|
-
# For more information about how to send commands that target
|
19257
|
-
# using `Key,Value` parameters, see [Targeting multiple
|
19258
|
-
# the *Amazon Web Services Systems Manager User Guide*.
|
19334
|
+
# For more information about how to send commands that target managed
|
19335
|
+
# nodes using `Key,Value` parameters, see [Targeting multiple
|
19336
|
+
# instances][2] in the *Amazon Web Services Systems Manager User Guide*.
|
19259
19337
|
#
|
19260
19338
|
#
|
19261
19339
|
#
|
@@ -19271,7 +19349,7 @@ module Aws::SSM
|
|
19271
19349
|
# }
|
19272
19350
|
#
|
19273
19351
|
# @!attribute [rw] key
|
19274
|
-
# User-defined criteria for sending commands that target
|
19352
|
+
# User-defined criteria for sending commands that target managed nodes
|
19275
19353
|
# that meet the criteria.
|
19276
19354
|
# @return [String]
|
19277
19355
|
#
|
@@ -19362,12 +19440,12 @@ module Aws::SSM
|
|
19362
19440
|
include Aws::Structure
|
19363
19441
|
end
|
19364
19442
|
|
19365
|
-
# The specified target
|
19366
|
-
# for use with Session Manager. For more information, see
|
19367
|
-
# started with Session Manager][1] in the *Amazon Web Services
|
19368
|
-
# Manager User Guide*. This error is also returned if you
|
19369
|
-
# start a session on
|
19370
|
-
# or Region
|
19443
|
+
# The specified target managed node for the session isn't fully
|
19444
|
+
# configured for use with Session Manager. For more information, see
|
19445
|
+
# [Getting started with Session Manager][1] in the *Amazon Web Services
|
19446
|
+
# Systems Manager User Guide*. This error is also returned if you
|
19447
|
+
# attempt to start a session on a managed node that is located in a
|
19448
|
+
# different account or Region
|
19371
19449
|
#
|
19372
19450
|
#
|
19373
19451
|
#
|
@@ -19596,9 +19674,9 @@ module Aws::SSM
|
|
19596
19674
|
include Aws::Structure
|
19597
19675
|
end
|
19598
19676
|
|
19599
|
-
# The document doesn't support the platform type of the given
|
19600
|
-
# ID(s). For example, you sent an document for a Windows
|
19601
|
-
# Linux
|
19677
|
+
# The document doesn't support the platform type of the given managed
|
19678
|
+
# node ID(s). For example, you sent an document for a Windows managed
|
19679
|
+
# node to a Linux node.
|
19602
19680
|
#
|
19603
19681
|
# @!attribute [rw] message
|
19604
19682
|
# @return [String]
|
@@ -19681,7 +19759,7 @@ module Aws::SSM
|
|
19681
19759
|
#
|
19682
19760
|
# @!attribute [rw] name
|
19683
19761
|
# The name of the SSM Command document or Automation runbook that
|
19684
|
-
# contains the configuration information for the
|
19762
|
+
# contains the configuration information for the managed node.
|
19685
19763
|
#
|
19686
19764
|
# You can specify Amazon Web Services-predefined documents, documents
|
19687
19765
|
# you created, or a document that is shared with you from another
|
@@ -19718,10 +19796,10 @@ module Aws::SSM
|
|
19718
19796
|
# @return [String]
|
19719
19797
|
#
|
19720
19798
|
# @!attribute [rw] automation_target_parameter_name
|
19721
|
-
#
|
19722
|
-
#
|
19723
|
-
#
|
19724
|
-
# Services Systems Manager.
|
19799
|
+
# Choose the parameter that will define how your automation will
|
19800
|
+
# branch out. This target is required for associations that use an
|
19801
|
+
# Automation runbook and target resources by using rate controls.
|
19802
|
+
# Automation is a capability of Amazon Web Services Systems Manager.
|
19725
19803
|
# @return [String]
|
19726
19804
|
#
|
19727
19805
|
# @!attribute [rw] max_errors
|
@@ -19732,7 +19810,7 @@ module Aws::SSM
|
|
19732
19810
|
# for example, the system stops sending requests when the fourth error
|
19733
19811
|
# is received. If you specify 0, then the system stops sending
|
19734
19812
|
# requests after the first error is returned. If you run an
|
19735
|
-
# association on 50
|
19813
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
19736
19814
|
# system stops sending the request when the sixth error is received.
|
19737
19815
|
#
|
19738
19816
|
# Executions that are already running an association when `MaxErrors`
|
@@ -19748,10 +19826,10 @@ module Aws::SSM
|
|
19748
19826
|
# of the target set, for example 10%. The default value is 100%, which
|
19749
19827
|
# means all targets run the association at the same time.
|
19750
19828
|
#
|
19751
|
-
# If a new
|
19752
|
-
# Systems Manager is running `MaxConcurrency` associations, the
|
19829
|
+
# If a new managed node starts and attempts to run an association
|
19830
|
+
# while Systems Manager is running `MaxConcurrency` associations, the
|
19753
19831
|
# association is allowed to run. During the next association interval,
|
19754
|
-
# the new
|
19832
|
+
# the new managed node will process its association within the limit
|
19755
19833
|
# specified for `MaxConcurrency`.
|
19756
19834
|
# @return [String]
|
19757
19835
|
#
|
@@ -19830,7 +19908,7 @@ module Aws::SSM
|
|
19830
19908
|
:apply_only_at_cron_interval,
|
19831
19909
|
:calendar_names,
|
19832
19910
|
:target_locations)
|
19833
|
-
SENSITIVE = []
|
19911
|
+
SENSITIVE = [:parameters]
|
19834
19912
|
include Aws::Structure
|
19835
19913
|
end
|
19836
19914
|
|
@@ -19865,7 +19943,7 @@ module Aws::SSM
|
|
19865
19943
|
# @return [String]
|
19866
19944
|
#
|
19867
19945
|
# @!attribute [rw] instance_id
|
19868
|
-
# The
|
19946
|
+
# The managed node ID.
|
19869
19947
|
# @return [String]
|
19870
19948
|
#
|
19871
19949
|
# @!attribute [rw] association_status
|
@@ -20462,8 +20540,8 @@ module Aws::SSM
|
|
20462
20540
|
# @return [String]
|
20463
20541
|
#
|
20464
20542
|
# @!attribute [rw] targets
|
20465
|
-
# The targets (either
|
20466
|
-
# specified using the format
|
20543
|
+
# The targets (either managed nodes or tags) to modify. Managed nodes
|
20544
|
+
# are specified using the format
|
20467
20545
|
# `Key=instanceids,Values=instanceID_1,instanceID_2`. Tags are
|
20468
20546
|
# specified using the format ` Key=tag_name,Values=tag_value`.
|
20469
20547
|
#
|
@@ -20758,7 +20836,7 @@ module Aws::SSM
|
|
20758
20836
|
# }
|
20759
20837
|
#
|
20760
20838
|
# @!attribute [rw] instance_id
|
20761
|
-
# The ID of the managed
|
20839
|
+
# The ID of the managed node where you want to update the role.
|
20762
20840
|
# @return [String]
|
20763
20841
|
#
|
20764
20842
|
# @!attribute [rw] iam_role
|
@@ -21080,8 +21158,8 @@ module Aws::SSM
|
|
21080
21158
|
#
|
21081
21159
|
# @!attribute [rw] approved_patches_enable_non_security
|
21082
21160
|
# Indicates whether the list of approved patches includes non-security
|
21083
|
-
# updates that should be applied to the
|
21084
|
-
# is `false`. Applies to Linux
|
21161
|
+
# updates that should be applied to the managed nodes. The default
|
21162
|
+
# value is `false`. Applies to Linux managed nodes only.
|
21085
21163
|
# @return [Boolean]
|
21086
21164
|
#
|
21087
21165
|
# @!attribute [rw] rejected_patches
|
@@ -21120,9 +21198,9 @@ module Aws::SSM
|
|
21120
21198
|
# @return [String]
|
21121
21199
|
#
|
21122
21200
|
# @!attribute [rw] sources
|
21123
|
-
# Information about the patches to use to update the
|
21201
|
+
# Information about the patches to use to update the managed nodes,
|
21124
21202
|
# including target operating systems and source repositories. Applies
|
21125
|
-
# to Linux
|
21203
|
+
# to Linux managed nodes only.
|
21126
21204
|
# @return [Array<Types::PatchSource>]
|
21127
21205
|
#
|
21128
21206
|
# @!attribute [rw] replace
|
@@ -21181,8 +21259,8 @@ module Aws::SSM
|
|
21181
21259
|
#
|
21182
21260
|
# @!attribute [rw] approved_patches_enable_non_security
|
21183
21261
|
# Indicates whether the list of approved patches includes non-security
|
21184
|
-
# updates that should be applied to the
|
21185
|
-
# is `false`. Applies to Linux
|
21262
|
+
# updates that should be applied to the managed nodes. The default
|
21263
|
+
# value is `false`. Applies to Linux managed nodes only.
|
21186
21264
|
# @return [Boolean]
|
21187
21265
|
#
|
21188
21266
|
# @!attribute [rw] rejected_patches
|
@@ -21209,9 +21287,9 @@ module Aws::SSM
|
|
21209
21287
|
# @return [String]
|
21210
21288
|
#
|
21211
21289
|
# @!attribute [rw] sources
|
21212
|
-
# Information about the patches to use to update the
|
21290
|
+
# Information about the patches to use to update the managed nodes,
|
21213
21291
|
# including target operating systems and source repositories. Applies
|
21214
|
-
# to Linux
|
21292
|
+
# to Linux managed nodes only.
|
21215
21293
|
# @return [Array<Types::PatchSource>]
|
21216
21294
|
#
|
21217
21295
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdatePatchBaselineResult AWS API Documentation
|