aws-sdk-ssm 1.124.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 +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ssm/client.rb +240 -242
- data/lib/aws-sdk-ssm/client_api.rb +4 -0
- data/lib/aws-sdk-ssm/types.rb +487 -471
- 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
|
@@ -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
|
#
|
@@ -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
|
#
|
@@ -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
|
#
|
@@ -1985,8 +1983,8 @@ module Aws::SSM
|
|
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
|
#
|
@@ -2081,7 +2079,7 @@ module Aws::SSM
|
|
2081
2079
|
# Manager document (SSM document) for which you want to see command
|
2082
2080
|
# execution results. For example, specify `AWS-RunPatchBaseline` to
|
2083
2081
|
# see command executions that used this SSM document to perform
|
2084
|
-
# security patching operations on
|
2082
|
+
# security patching operations on managed nodes.
|
2085
2083
|
#
|
2086
2084
|
# * **ExecutionStage**\: Specify one of the following values
|
2087
2085
|
# (`ListCommands` operations only):
|
@@ -2102,23 +2100,23 @@ module Aws::SSM
|
|
2102
2100
|
include Aws::Structure
|
2103
2101
|
end
|
2104
2102
|
|
2105
|
-
# An invocation is copy of a command sent to a specific
|
2106
|
-
# command can apply to one or more
|
2107
|
-
# applies to one
|
2108
|
-
# against three
|
2109
|
-
# requested
|
2110
|
-
# 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.
|
2111
2109
|
#
|
2112
2110
|
# @!attribute [rw] command_id
|
2113
2111
|
# The command against which this invocation was requested.
|
2114
2112
|
# @return [String]
|
2115
2113
|
#
|
2116
2114
|
# @!attribute [rw] instance_id
|
2117
|
-
# The
|
2115
|
+
# The managed node ID in which this invocation was requested.
|
2118
2116
|
# @return [String]
|
2119
2117
|
#
|
2120
2118
|
# @!attribute [rw] instance_name
|
2121
|
-
# The fully qualified host name of the managed
|
2119
|
+
# The fully qualified host name of the managed node.
|
2122
2120
|
# @return [String]
|
2123
2121
|
#
|
2124
2122
|
# @!attribute [rw] comment
|
@@ -2135,7 +2133,7 @@ module Aws::SSM
|
|
2135
2133
|
# @return [String]
|
2136
2134
|
#
|
2137
2135
|
# @!attribute [rw] requested_date_time
|
2138
|
-
# The time and date the request was sent to this
|
2136
|
+
# The time and date the request was sent to this managed node.
|
2139
2137
|
# @return [Time]
|
2140
2138
|
#
|
2141
2139
|
# @!attribute [rw] status
|
@@ -2144,7 +2142,7 @@ module Aws::SSM
|
|
2144
2142
|
#
|
2145
2143
|
# @!attribute [rw] status_details
|
2146
2144
|
# A detailed status of the command execution for each invocation (each
|
2147
|
-
#
|
2145
|
+
# managed node targeted by the command). StatusDetails includes more
|
2148
2146
|
# information than Status because it includes states resulting from
|
2149
2147
|
# error and concurrency control parameters. StatusDetails can show
|
2150
2148
|
# different results than Status. For more information about these
|
@@ -2152,26 +2150,26 @@ module Aws::SSM
|
|
2152
2150
|
# Services Systems Manager User Guide*. StatusDetails can be one of
|
2153
2151
|
# the following values:
|
2154
2152
|
#
|
2155
|
-
# * Pending: The command hasn't been sent to the
|
2153
|
+
# * Pending: The command hasn't been sent to the managed node.
|
2156
2154
|
#
|
2157
|
-
# * In Progress: The command has been sent to the
|
2158
|
-
# reached a terminal state.
|
2155
|
+
# * In Progress: The command has been sent to the managed node but
|
2156
|
+
# hasn't reached a terminal state.
|
2159
2157
|
#
|
2160
2158
|
# * Success: The execution of the command or plugin was successfully
|
2161
2159
|
# completed. This is a terminal state.
|
2162
2160
|
#
|
2163
|
-
# * Delivery Timed Out: The command wasn't delivered to the
|
2164
|
-
# 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
|
2165
2163
|
# count against the parent command's `MaxErrors` limit, but they do
|
2166
2164
|
# contribute to whether the parent command status is Success or
|
2167
2165
|
# Incomplete. This is a terminal state.
|
2168
2166
|
#
|
2169
|
-
# * Execution Timed Out: Command execution started on the
|
2170
|
-
# but the execution wasn't complete before the execution
|
2171
|
-
# expired. Execution timeouts count against the `MaxErrors`
|
2172
|
-
# 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.
|
2173
2171
|
#
|
2174
|
-
# * Failed: The command wasn't successful on the
|
2172
|
+
# * Failed: The command wasn't successful on the managed node. For a
|
2175
2173
|
# plugin, this indicates that the result code wasn't zero. For a
|
2176
2174
|
# command invocation, this indicates that the result code for one or
|
2177
2175
|
# more plugins wasn't zero. Invocation failures count against the
|
@@ -2180,8 +2178,8 @@ module Aws::SSM
|
|
2180
2178
|
# * Canceled: The command was terminated before it was completed. This
|
2181
2179
|
# is a terminal state.
|
2182
2180
|
#
|
2183
|
-
# * Undeliverable: The command can't be delivered to the
|
2184
|
-
# 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.
|
2185
2183
|
# Undeliverable invocations don't count against the parent
|
2186
2184
|
# command's MaxErrors limit and don't contribute to whether the
|
2187
2185
|
# parent command status is Success or Incomplete. This is a terminal
|
@@ -2224,12 +2222,12 @@ module Aws::SSM
|
|
2224
2222
|
# The Identity and Access Management (IAM) service role that Run
|
2225
2223
|
# Command, a capability of Amazon Web Services Systems Manager, uses
|
2226
2224
|
# to act on your behalf when sending notifications about command
|
2227
|
-
# status changes on a per
|
2225
|
+
# status changes on a per managed node basis.
|
2228
2226
|
# @return [String]
|
2229
2227
|
#
|
2230
2228
|
# @!attribute [rw] notification_config
|
2231
2229
|
# Configurations for sending notifications about command status
|
2232
|
-
# changes on a per
|
2230
|
+
# changes on a per managed node basis.
|
2233
2231
|
# @return [Types::NotificationConfig]
|
2234
2232
|
#
|
2235
2233
|
# @!attribute [rw] cloud_watch_output_config
|
@@ -2283,26 +2281,26 @@ module Aws::SSM
|
|
2283
2281
|
# Services Systems Manager User Guide*. StatusDetails can be one of
|
2284
2282
|
# the following values:
|
2285
2283
|
#
|
2286
|
-
# * Pending: The command hasn't been sent to the
|
2284
|
+
# * Pending: The command hasn't been sent to the managed node.
|
2287
2285
|
#
|
2288
|
-
# * In Progress: The command has been sent to the
|
2289
|
-
# reached a terminal state.
|
2286
|
+
# * In Progress: The command has been sent to the managed node but
|
2287
|
+
# hasn't reached a terminal state.
|
2290
2288
|
#
|
2291
2289
|
# * Success: The execution of the command or plugin was successfully
|
2292
2290
|
# completed. This is a terminal state.
|
2293
2291
|
#
|
2294
|
-
# * Delivery Timed Out: The command wasn't delivered to the
|
2295
|
-
# 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
|
2296
2294
|
# count against the parent command's `MaxErrors` limit, but they do
|
2297
2295
|
# contribute to whether the parent command status is Success or
|
2298
2296
|
# Incomplete. This is a terminal state.
|
2299
2297
|
#
|
2300
|
-
# * Execution Timed Out: Command execution started on the
|
2301
|
-
# but the execution wasn't complete before the execution
|
2302
|
-
# expired. Execution timeouts count against the `MaxErrors`
|
2303
|
-
# 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.
|
2304
2302
|
#
|
2305
|
-
# * Failed: The command wasn't successful on the
|
2303
|
+
# * Failed: The command wasn't successful on the managed node. For a
|
2306
2304
|
# plugin, this indicates that the result code wasn't zero. For a
|
2307
2305
|
# command invocation, this indicates that the result code for one or
|
2308
2306
|
# more plugins wasn't zero. Invocation failures count against the
|
@@ -2311,12 +2309,12 @@ module Aws::SSM
|
|
2311
2309
|
# * Canceled: The command was terminated before it was completed. This
|
2312
2310
|
# is a terminal state.
|
2313
2311
|
#
|
2314
|
-
# * Undeliverable: The command can't be delivered to the
|
2315
|
-
# The
|
2316
|
-
# Undeliverable invocations don't count against the
|
2317
|
-
# command's MaxErrors limit, and they don't contribute to
|
2318
|
-
# the parent command status is Success or Incomplete. This
|
2319
|
-
# 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.
|
2320
2318
|
#
|
2321
2319
|
# * Terminated: The parent command exceeded its MaxErrors limit and
|
2322
2320
|
# subsequent command invocations were canceled by the system. This
|
@@ -2373,7 +2371,7 @@ module Aws::SSM
|
|
2373
2371
|
# `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
|
2374
2372
|
# prefix;
|
2375
2373
|
#
|
2376
|
-
# `i-02573cafcfEXAMPLE` is the
|
2374
|
+
# `i-02573cafcfEXAMPLE` is the managed node ID;
|
2377
2375
|
#
|
2378
2376
|
# `awsrunShellScript` is the name of the plugin.
|
2379
2377
|
# @return [String]
|
@@ -2390,7 +2388,7 @@ module Aws::SSM
|
|
2390
2388
|
# `ab19cb99-a030-46dd-9dfc-8eSAMPLEPre-Fix` is the name of the S3
|
2391
2389
|
# prefix;
|
2392
2390
|
#
|
2393
|
-
# `i-02573cafcfEXAMPLE` is the
|
2391
|
+
# `i-02573cafcfEXAMPLE` is the managed node ID;
|
2394
2392
|
#
|
2395
2393
|
# `awsrunShellScript` is the name of the plugin.
|
2396
2394
|
# @return [String]
|
@@ -2470,8 +2468,7 @@ module Aws::SSM
|
|
2470
2468
|
# @return [String]
|
2471
2469
|
#
|
2472
2470
|
# @!attribute [rw] resource_id
|
2473
|
-
# An ID for the resource. For a managed
|
2474
|
-
# ID.
|
2471
|
+
# An ID for the resource. For a managed node, this is the node ID.
|
2475
2472
|
# @return [String]
|
2476
2473
|
#
|
2477
2474
|
# @!attribute [rw] id
|
@@ -2702,8 +2699,8 @@ module Aws::SSM
|
|
2702
2699
|
# @return [String]
|
2703
2700
|
#
|
2704
2701
|
# @!attribute [rw] default_instance_name
|
2705
|
-
# The name of the registered, managed
|
2706
|
-
#
|
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
|
2707
2704
|
# Amazon Web Services command line tools to list Systems Manager
|
2708
2705
|
# resources.
|
2709
2706
|
#
|
@@ -2712,7 +2709,7 @@ module Aws::SSM
|
|
2712
2709
|
#
|
2713
2710
|
# @!attribute [rw] iam_role
|
2714
2711
|
# The name of the Identity and Access Management (IAM) role that you
|
2715
|
-
# want to assign to the managed
|
2712
|
+
# want to assign to the managed node. This IAM role must provide
|
2716
2713
|
# AssumeRole permissions for the Amazon Web Services Systems Manager
|
2717
2714
|
# service principal `ssm.amazonaws.com`. For more information, see
|
2718
2715
|
# [Create an IAM service role for a hybrid environment][1] in the
|
@@ -2724,8 +2721,8 @@ module Aws::SSM
|
|
2724
2721
|
# @return [String]
|
2725
2722
|
#
|
2726
2723
|
# @!attribute [rw] registration_limit
|
2727
|
-
# Specify the maximum number of managed
|
2728
|
-
#
|
2724
|
+
# Specify the maximum number of managed nodes you want to register.
|
2725
|
+
# The default value is `1`.
|
2729
2726
|
# @return [Integer]
|
2730
2727
|
#
|
2731
2728
|
# @!attribute [rw] expiration_date
|
@@ -2753,13 +2750,13 @@ module Aws::SSM
|
|
2753
2750
|
# applied to the on-premises servers or VMs.
|
2754
2751
|
#
|
2755
2752
|
# You can't add tags to or delete tags from an existing activation.
|
2756
|
-
# You can tag your on-premises servers and VMs after
|
2757
|
-
# Systems Manager for the first time and are assigned
|
2758
|
-
#
|
2759
|
-
# Systems Manager console with an ID that is prefixed with
|
2760
|
-
# For information about how to add tags to your managed
|
2761
|
-
# AddTagsToResource. For information about how to remove
|
2762
|
-
# 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.
|
2763
2760
|
# @return [Array<Types::Tag>]
|
2764
2761
|
#
|
2765
2762
|
# @!attribute [rw] registration_metadata
|
@@ -2860,7 +2857,7 @@ module Aws::SSM
|
|
2860
2857
|
end
|
2861
2858
|
|
2862
2859
|
# Describes the association of a Amazon Web Services Systems Manager
|
2863
|
-
# document (SSM document) and
|
2860
|
+
# document (SSM document) and a managed node.
|
2864
2861
|
#
|
2865
2862
|
# @note When making an API call, you may pass CreateAssociationBatchRequestEntry
|
2866
2863
|
# data as a hash:
|
@@ -2907,8 +2904,8 @@ module Aws::SSM
|
|
2907
2904
|
#
|
2908
2905
|
# @!attribute [rw] name
|
2909
2906
|
# The name of the SSM document that contains the configuration
|
2910
|
-
# information for the
|
2911
|
-
# runbooks.
|
2907
|
+
# information for the managed node. You can specify Command or
|
2908
|
+
# Automation runbooks.
|
2912
2909
|
#
|
2913
2910
|
# You can specify Amazon Web Services-predefined documents, documents
|
2914
2911
|
# you created, or a document that is shared with you from another
|
@@ -2930,11 +2927,11 @@ module Aws::SSM
|
|
2930
2927
|
# @return [String]
|
2931
2928
|
#
|
2932
2929
|
# @!attribute [rw] instance_id
|
2933
|
-
# The
|
2930
|
+
# The managed node ID.
|
2934
2931
|
#
|
2935
|
-
# <note markdown="1"> `InstanceId` has been deprecated. To specify
|
2936
|
-
# association, use the `Targets` parameter. Requests that include
|
2937
|
-
# 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
|
2938
2935
|
# documents) that use schema version 2.0 or later will fail. In
|
2939
2936
|
# addition, if you use the parameter `InstanceId`, you can't use the
|
2940
2937
|
# parameters `AssociationName`, `DocumentVersion`, `MaxErrors`,
|
@@ -2960,7 +2957,7 @@ module Aws::SSM
|
|
2960
2957
|
# @return [String]
|
2961
2958
|
#
|
2962
2959
|
# @!attribute [rw] targets
|
2963
|
-
# The
|
2960
|
+
# The managed nodes targeted by the request.
|
2964
2961
|
# @return [Array<Types::Target>]
|
2965
2962
|
#
|
2966
2963
|
# @!attribute [rw] schedule_expression
|
@@ -2984,7 +2981,7 @@ module Aws::SSM
|
|
2984
2981
|
# for example, the system stops sending requests when the fourth error
|
2985
2982
|
# is received. If you specify 0, then the system stops sending
|
2986
2983
|
# requests after the first error is returned. If you run an
|
2987
|
-
# association on 50
|
2984
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
2988
2985
|
# system stops sending the request when the sixth error is received.
|
2989
2986
|
#
|
2990
2987
|
# Executions that are already running an association when `MaxErrors`
|
@@ -3000,10 +2997,10 @@ module Aws::SSM
|
|
3000
2997
|
# of the target set, for example 10%. The default value is 100%, which
|
3001
2998
|
# means all targets run the association at the same time.
|
3002
2999
|
#
|
3003
|
-
# If a new
|
3004
|
-
# 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
|
3005
3002
|
# association is allowed to run. During the next association interval,
|
3006
|
-
# the new
|
3003
|
+
# the new managed node will process its association within the limit
|
3007
3004
|
# specified for `MaxConcurrency`.
|
3008
3005
|
# @return [String]
|
3009
3006
|
#
|
@@ -3137,7 +3134,7 @@ module Aws::SSM
|
|
3137
3134
|
#
|
3138
3135
|
# @!attribute [rw] name
|
3139
3136
|
# The name of the SSM Command document or Automation runbook that
|
3140
|
-
# contains the configuration information for the
|
3137
|
+
# contains the configuration information for the managed node.
|
3141
3138
|
#
|
3142
3139
|
# You can specify Amazon Web Services-predefined documents, documents
|
3143
3140
|
# you created, or a document that is shared with you from another
|
@@ -3164,11 +3161,11 @@ module Aws::SSM
|
|
3164
3161
|
# @return [String]
|
3165
3162
|
#
|
3166
3163
|
# @!attribute [rw] instance_id
|
3167
|
-
# The
|
3164
|
+
# The managed node ID.
|
3168
3165
|
#
|
3169
|
-
# <note markdown="1"> `InstanceId` has been deprecated. To specify
|
3170
|
-
# association, use the `Targets` parameter. Requests that include
|
3171
|
-
# 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
|
3172
3169
|
# documents) that use schema version 2.0 or later will fail. In
|
3173
3170
|
# addition, if you use the parameter `InstanceId`, you can't use the
|
3174
3171
|
# parameters `AssociationName`, `DocumentVersion`, `MaxErrors`,
|
@@ -3183,14 +3180,14 @@ module Aws::SSM
|
|
3183
3180
|
# @return [Hash<String,Array<String>>]
|
3184
3181
|
#
|
3185
3182
|
# @!attribute [rw] targets
|
3186
|
-
# The targets for the association. You can target
|
3187
|
-
# tags, Amazon Web Services resource groups, all
|
3188
|
-
# Amazon Web Services account, or individual
|
3189
|
-
# target all
|
3190
|
-
# the `InstanceIds` key with a value of `*`. For more
|
3191
|
-
# about choosing targets for an association, see [Using
|
3192
|
-
# rate controls with State Manager associations][1] in the
|
3193
|
-
# 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*.
|
3194
3191
|
#
|
3195
3192
|
#
|
3196
3193
|
#
|
@@ -3226,7 +3223,7 @@ module Aws::SSM
|
|
3226
3223
|
# for example, the system stops sending requests when the fourth error
|
3227
3224
|
# is received. If you specify 0, then the system stops sending
|
3228
3225
|
# requests after the first error is returned. If you run an
|
3229
|
-
# association on 50
|
3226
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
3230
3227
|
# system stops sending the request when the sixth error is received.
|
3231
3228
|
#
|
3232
3229
|
# Executions that are already running an association when `MaxErrors`
|
@@ -3242,10 +3239,10 @@ module Aws::SSM
|
|
3242
3239
|
# of the target set, for example 10%. The default value is 100%, which
|
3243
3240
|
# means all targets run the association at the same time.
|
3244
3241
|
#
|
3245
|
-
# If a new
|
3246
|
-
# 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
|
3247
3244
|
# association is allowed to run. During the next association interval,
|
3248
|
-
# the new
|
3245
|
+
# the new managed node will process its association within the limit
|
3249
3246
|
# specified for `MaxConcurrency`.
|
3250
3247
|
# @return [String]
|
3251
3248
|
#
|
@@ -3589,10 +3586,10 @@ module Aws::SSM
|
|
3589
3586
|
# @return [Integer]
|
3590
3587
|
#
|
3591
3588
|
# @!attribute [rw] allow_unassociated_targets
|
3592
|
-
# Enables a maintenance window task to run on managed
|
3593
|
-
#
|
3594
|
-
#
|
3595
|
-
#
|
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.
|
3596
3593
|
#
|
3597
3594
|
# If you don't enable this option, then you must specify
|
3598
3595
|
# previously-registered targets when you register a task with the
|
@@ -4006,8 +4003,8 @@ module Aws::SSM
|
|
4006
4003
|
#
|
4007
4004
|
# @!attribute [rw] approved_patches_enable_non_security
|
4008
4005
|
# Indicates whether the list of approved patches includes non-security
|
4009
|
-
# updates that should be applied to the
|
4010
|
-
# 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.
|
4011
4008
|
# @return [Boolean]
|
4012
4009
|
#
|
4013
4010
|
# @!attribute [rw] rejected_patches
|
@@ -4046,9 +4043,9 @@ module Aws::SSM
|
|
4046
4043
|
# @return [String]
|
4047
4044
|
#
|
4048
4045
|
# @!attribute [rw] sources
|
4049
|
-
# Information about the patches to use to update the
|
4046
|
+
# Information about the patches to use to update the managed nodes,
|
4050
4047
|
# including target operating systems and source repositories. Applies
|
4051
|
-
# to Linux
|
4048
|
+
# to Linux managed nodes only.
|
4052
4049
|
# @return [Array<Types::PatchSource>]
|
4053
4050
|
#
|
4054
4051
|
# @!attribute [rw] client_token
|
@@ -4231,11 +4228,11 @@ module Aws::SSM
|
|
4231
4228
|
# @return [String]
|
4232
4229
|
#
|
4233
4230
|
# @!attribute [rw] instance_id
|
4234
|
-
# The
|
4231
|
+
# The managed node ID.
|
4235
4232
|
#
|
4236
|
-
# <note markdown="1"> `InstanceId` has been deprecated. To specify
|
4237
|
-
# association, use the `Targets` parameter. Requests that include
|
4238
|
-
# 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
|
4239
4236
|
# documents) that use schema version 2.0 or later will fail. In
|
4240
4237
|
# addition, if you use the parameter `InstanceId`, you can't use the
|
4241
4238
|
# parameters `AssociationName`, `DocumentVersion`, `MaxErrors`,
|
@@ -4581,8 +4578,8 @@ module Aws::SSM
|
|
4581
4578
|
# }
|
4582
4579
|
#
|
4583
4580
|
# @!attribute [rw] instance_id
|
4584
|
-
# The ID assigned to the managed
|
4585
|
-
#
|
4581
|
+
# The ID assigned to the managed node when you registered it using the
|
4582
|
+
# activation process.
|
4586
4583
|
# @return [String]
|
4587
4584
|
#
|
4588
4585
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DeregisterManagedInstanceRequest AWS API Documentation
|
@@ -4980,7 +4977,7 @@ module Aws::SSM
|
|
4980
4977
|
# @return [String]
|
4981
4978
|
#
|
4982
4979
|
# @!attribute [rw] instance_id
|
4983
|
-
# The
|
4980
|
+
# The managed node ID.
|
4984
4981
|
# @return [String]
|
4985
4982
|
#
|
4986
4983
|
# @!attribute [rw] association_id
|
@@ -4990,8 +4987,8 @@ module Aws::SSM
|
|
4990
4987
|
# @!attribute [rw] association_version
|
4991
4988
|
# Specify the association version to retrieve. To view the latest
|
4992
4989
|
# version, either specify `$LATEST` for this parameter, or omit this
|
4993
|
-
# parameter. To view a list of all associations for
|
4994
|
-
# 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
|
4995
4992
|
# association, use ListAssociationVersions.
|
4996
4993
|
# @return [String]
|
4997
4994
|
#
|
@@ -5169,7 +5166,7 @@ module Aws::SSM
|
|
5169
5166
|
#
|
5170
5167
|
# **Windows Server**
|
5171
5168
|
#
|
5172
|
-
# Supported keys for Windows Server
|
5169
|
+
# Supported keys for Windows Server managed node patches include the
|
5173
5170
|
# following:
|
5174
5171
|
#
|
5175
5172
|
# * <b> <code>PATCH_SET</code> </b>
|
@@ -5213,7 +5210,7 @@ module Aws::SSM
|
|
5213
5210
|
# Key=PRODUCT,Values=AmazonLinux2018.03
|
5214
5211
|
# Key=CVE_ID,Values=CVE-2018-3615`
|
5215
5212
|
#
|
5216
|
-
# Supported keys for Linux
|
5213
|
+
# Supported keys for Linux managed node patches include the following:
|
5217
5214
|
#
|
5218
5215
|
# * <b> <code>PRODUCT</code> </b>
|
5219
5216
|
#
|
@@ -5419,7 +5416,7 @@ module Aws::SSM
|
|
5419
5416
|
# }
|
5420
5417
|
#
|
5421
5418
|
# @!attribute [rw] instance_id
|
5422
|
-
# The
|
5419
|
+
# The managed node ID for which you want to view all associations.
|
5423
5420
|
# @return [String]
|
5424
5421
|
#
|
5425
5422
|
# @!attribute [rw] max_results
|
@@ -5444,7 +5441,7 @@ module Aws::SSM
|
|
5444
5441
|
end
|
5445
5442
|
|
5446
5443
|
# @!attribute [rw] associations
|
5447
|
-
# The associations for the requested
|
5444
|
+
# The associations for the requested managed node.
|
5448
5445
|
# @return [Array<Types::InstanceAssociation>]
|
5449
5446
|
#
|
5450
5447
|
# @!attribute [rw] next_token
|
@@ -5521,7 +5518,8 @@ module Aws::SSM
|
|
5521
5518
|
# }
|
5522
5519
|
#
|
5523
5520
|
# @!attribute [rw] instance_id
|
5524
|
-
# The
|
5521
|
+
# The managed node IDs for which you want association status
|
5522
|
+
# information.
|
5525
5523
|
# @return [String]
|
5526
5524
|
#
|
5527
5525
|
# @!attribute [rw] max_results
|
@@ -5586,8 +5584,8 @@ module Aws::SSM
|
|
5586
5584
|
# @!attribute [rw] instance_information_filter_list
|
5587
5585
|
# This is a legacy method. We recommend that you don't use this
|
5588
5586
|
# method. Instead, use the `Filters` data type. `Filters` enables you
|
5589
|
-
# to return
|
5590
|
-
# managed
|
5587
|
+
# to return node information by filtering based on tags applied to
|
5588
|
+
# managed nodes.
|
5591
5589
|
#
|
5592
5590
|
# <note markdown="1"> Attempting to use `InstanceInformationFilterList` and `Filters`
|
5593
5591
|
# leads to an exception error.
|
@@ -5597,8 +5595,8 @@ module Aws::SSM
|
|
5597
5595
|
#
|
5598
5596
|
# @!attribute [rw] filters
|
5599
5597
|
# One or more filters. Use a filter to return a more specific list of
|
5600
|
-
#
|
5601
|
-
# 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
|
5602
5600
|
# `InstanceInformationFilterList`, which is deprecated.
|
5603
5601
|
# @return [Array<Types::InstanceInformationStringFilter>]
|
5604
5602
|
#
|
@@ -5625,7 +5623,7 @@ module Aws::SSM
|
|
5625
5623
|
end
|
5626
5624
|
|
5627
5625
|
# @!attribute [rw] instance_information_list
|
5628
|
-
# The
|
5626
|
+
# The managed node information list.
|
5629
5627
|
# @return [Array<Types::InstanceInformation>]
|
5630
5628
|
#
|
5631
5629
|
# @!attribute [rw] next_token
|
@@ -5695,7 +5693,7 @@ module Aws::SSM
|
|
5695
5693
|
end
|
5696
5694
|
|
5697
5695
|
# @!attribute [rw] instance_patch_states
|
5698
|
-
# The high-level patch state for the requested
|
5696
|
+
# The high-level patch state for the requested managed nodes.
|
5699
5697
|
# @return [Array<Types::InstancePatchState>]
|
5700
5698
|
#
|
5701
5699
|
# @!attribute [rw] next_token
|
@@ -5722,8 +5720,8 @@ module Aws::SSM
|
|
5722
5720
|
# }
|
5723
5721
|
#
|
5724
5722
|
# @!attribute [rw] instance_ids
|
5725
|
-
# The ID of the
|
5726
|
-
# retrieved.
|
5723
|
+
# The ID of the managed node for which patch state information should
|
5724
|
+
# be retrieved.
|
5727
5725
|
# @return [Array<String>]
|
5728
5726
|
#
|
5729
5727
|
# @!attribute [rw] next_token
|
@@ -5732,7 +5730,7 @@ module Aws::SSM
|
|
5732
5730
|
# @return [String]
|
5733
5731
|
#
|
5734
5732
|
# @!attribute [rw] max_results
|
5735
|
-
# The maximum number of
|
5733
|
+
# The maximum number of managed nodes to return (per page).
|
5736
5734
|
# @return [Integer]
|
5737
5735
|
#
|
5738
5736
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstancePatchStatesRequest AWS API Documentation
|
@@ -5746,7 +5744,7 @@ module Aws::SSM
|
|
5746
5744
|
end
|
5747
5745
|
|
5748
5746
|
# @!attribute [rw] instance_patch_states
|
5749
|
-
# The high-level patch state for the requested
|
5747
|
+
# The high-level patch state for the requested managed nodes.
|
5750
5748
|
# @return [Array<Types::InstancePatchState>]
|
5751
5749
|
#
|
5752
5750
|
# @!attribute [rw] next_token
|
@@ -5779,7 +5777,7 @@ module Aws::SSM
|
|
5779
5777
|
# }
|
5780
5778
|
#
|
5781
5779
|
# @!attribute [rw] instance_id
|
5782
|
-
# The ID of the
|
5780
|
+
# The ID of the managed node whose patch state information should be
|
5783
5781
|
# retrieved.
|
5784
5782
|
# @return [String]
|
5785
5783
|
#
|
@@ -6150,7 +6148,7 @@ module Aws::SSM
|
|
6150
6148
|
# @return [String]
|
6151
6149
|
#
|
6152
6150
|
# @!attribute [rw] targets
|
6153
|
-
# The
|
6151
|
+
# The managed node ID or key-value pair to retrieve information about.
|
6154
6152
|
# @return [Array<Types::Target>]
|
6155
6153
|
#
|
6156
6154
|
# @!attribute [rw] resource_type
|
@@ -6353,7 +6351,7 @@ module Aws::SSM
|
|
6353
6351
|
# }
|
6354
6352
|
#
|
6355
6353
|
# @!attribute [rw] targets
|
6356
|
-
# The
|
6354
|
+
# The managed node ID or key-value pair to retrieve information about.
|
6357
6355
|
# @return [Array<Types::Target>]
|
6358
6356
|
#
|
6359
6357
|
# @!attribute [rw] resource_type
|
@@ -6384,8 +6382,8 @@ module Aws::SSM
|
|
6384
6382
|
end
|
6385
6383
|
|
6386
6384
|
# @!attribute [rw] window_identities
|
6387
|
-
# Information about the maintenance window targets and tasks
|
6388
|
-
#
|
6385
|
+
# Information about the maintenance window targets and tasks a managed
|
6386
|
+
# node is associated with.
|
6389
6387
|
# @return [Array<Types::MaintenanceWindowIdentityForTarget>]
|
6390
6388
|
#
|
6391
6389
|
# @!attribute [rw] next_token
|
@@ -6738,27 +6736,27 @@ module Aws::SSM
|
|
6738
6736
|
end
|
6739
6737
|
|
6740
6738
|
# @!attribute [rw] instances
|
6741
|
-
# The number of
|
6739
|
+
# The number of managed nodes in the patch group.
|
6742
6740
|
# @return [Integer]
|
6743
6741
|
#
|
6744
6742
|
# @!attribute [rw] instances_with_installed_patches
|
6745
|
-
# The number of
|
6743
|
+
# The number of managed nodes with installed patches.
|
6746
6744
|
# @return [Integer]
|
6747
6745
|
#
|
6748
6746
|
# @!attribute [rw] instances_with_installed_other_patches
|
6749
|
-
# The number of
|
6750
|
-
# in the patch baseline.
|
6747
|
+
# The number of managed nodes with patches installed that aren't
|
6748
|
+
# defined in the patch baseline.
|
6751
6749
|
# @return [Integer]
|
6752
6750
|
#
|
6753
6751
|
# @!attribute [rw] instances_with_installed_pending_reboot_patches
|
6754
|
-
# The number of
|
6755
|
-
# haven't been rebooted after the patch installation. The status
|
6756
|
-
# 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`.
|
6757
6755
|
# @return [Integer]
|
6758
6756
|
#
|
6759
6757
|
# @!attribute [rw] instances_with_installed_rejected_patches
|
6760
|
-
# The number of
|
6761
|
-
# 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
|
6762
6760
|
# `INSTALLED_REJECTED` were typically installed before they were added
|
6763
6761
|
# to a `RejectedPatches` list.
|
6764
6762
|
#
|
@@ -6770,45 +6768,46 @@ module Aws::SSM
|
|
6770
6768
|
# @return [Integer]
|
6771
6769
|
#
|
6772
6770
|
# @!attribute [rw] instances_with_missing_patches
|
6773
|
-
# The number of
|
6771
|
+
# The number of managed nodes with missing patches from the patch
|
6774
6772
|
# baseline.
|
6775
6773
|
# @return [Integer]
|
6776
6774
|
#
|
6777
6775
|
# @!attribute [rw] instances_with_failed_patches
|
6778
|
-
# The number of
|
6779
|
-
# failed to install.
|
6776
|
+
# The number of managed nodes with patches from the patch baseline
|
6777
|
+
# that failed to install.
|
6780
6778
|
# @return [Integer]
|
6781
6779
|
#
|
6782
6780
|
# @!attribute [rw] instances_with_not_applicable_patches
|
6783
|
-
# The number of
|
6781
|
+
# The number of managed nodes with patches that aren't applicable.
|
6784
6782
|
# @return [Integer]
|
6785
6783
|
#
|
6786
6784
|
# @!attribute [rw] instances_with_unreported_not_applicable_patches
|
6787
|
-
# The number of
|
6785
|
+
# The number of managed nodes with `NotApplicable` patches beyond the
|
6788
6786
|
# supported limit, which aren't reported by name to Inventory.
|
6789
6787
|
# Inventory is a capability of Amazon Web Services Systems Manager.
|
6790
6788
|
# @return [Integer]
|
6791
6789
|
#
|
6792
6790
|
# @!attribute [rw] instances_with_critical_non_compliant_patches
|
6793
|
-
# The number of
|
6791
|
+
# The number of managed nodes where patches that are specified as
|
6794
6792
|
# `Critical` for compliance reporting in the patch baseline aren't
|
6795
6793
|
# installed. These patches might be missing, have failed installation,
|
6796
|
-
# were rejected, or were installed but awaiting a required
|
6797
|
-
# 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`.
|
6798
6796
|
# @return [Integer]
|
6799
6797
|
#
|
6800
6798
|
# @!attribute [rw] instances_with_security_non_compliant_patches
|
6801
|
-
# The number of
|
6799
|
+
# The number of managed nodes where patches that are specified as
|
6802
6800
|
# `Security` in a patch advisory aren't installed. These patches
|
6803
6801
|
# might be missing, have failed installation, were rejected, or were
|
6804
|
-
# installed but awaiting a required
|
6805
|
-
# these
|
6802
|
+
# installed but awaiting a required managed node reboot. The status of
|
6803
|
+
# these managed nodes is `NON_COMPLIANT`.
|
6806
6804
|
# @return [Integer]
|
6807
6805
|
#
|
6808
6806
|
# @!attribute [rw] instances_with_other_non_compliant_patches
|
6809
|
-
# The number of
|
6810
|
-
# other than `Critical` or `Security` but aren't
|
6811
|
-
# 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`.
|
6812
6811
|
# @return [Integer]
|
6813
6812
|
#
|
6814
6813
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupStateResult AWS API Documentation
|
@@ -7851,7 +7850,7 @@ module Aws::SSM
|
|
7851
7850
|
include Aws::Structure
|
7852
7851
|
end
|
7853
7852
|
|
7854
|
-
# You can't specify
|
7853
|
+
# You can't specify a managed node ID in more than one association.
|
7855
7854
|
#
|
7856
7855
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DuplicateInstanceId AWS API Documentation
|
7857
7856
|
#
|
@@ -8068,10 +8067,11 @@ module Aws::SSM
|
|
8068
8067
|
# @return [String]
|
8069
8068
|
#
|
8070
8069
|
# @!attribute [rw] instance_id
|
8071
|
-
# (Required) The ID of the managed
|
8072
|
-
# managed
|
8073
|
-
# instance or
|
8074
|
-
# 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.
|
8075
8075
|
# @return [String]
|
8076
8076
|
#
|
8077
8077
|
# @!attribute [rw] plugin_name
|
@@ -8107,9 +8107,10 @@ module Aws::SSM
|
|
8107
8107
|
# @return [String]
|
8108
8108
|
#
|
8109
8109
|
# @!attribute [rw] instance_id
|
8110
|
-
# The ID of the managed
|
8111
|
-
#
|
8112
|
-
#
|
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.
|
8113
8114
|
# @return [String]
|
8114
8115
|
#
|
8115
8116
|
# @!attribute [rw] comment
|
@@ -8134,7 +8135,7 @@ module Aws::SSM
|
|
8134
8135
|
# @!attribute [rw] response_code
|
8135
8136
|
# The error level response code for the plugin script. If the response
|
8136
8137
|
# code is `-1`, then the command hasn't started running on the
|
8137
|
-
#
|
8138
|
+
# managed node, or it wasn't received by the node.
|
8138
8139
|
# @return [Integer]
|
8139
8140
|
#
|
8140
8141
|
# @!attribute [rw] execution_start_date_time
|
@@ -8180,42 +8181,43 @@ module Aws::SSM
|
|
8180
8181
|
# Systems Manager User Guide*. `StatusDetails` can be one of the
|
8181
8182
|
# following values:
|
8182
8183
|
#
|
8183
|
-
# * Pending: The command hasn't been sent to the
|
8184
|
+
# * Pending: The command hasn't been sent to the managed node.
|
8184
8185
|
#
|
8185
|
-
# * In Progress: The command has been sent to the
|
8186
|
-
# reached a terminal state.
|
8186
|
+
# * In Progress: The command has been sent to the managed node but
|
8187
|
+
# hasn't reached a terminal state.
|
8187
8188
|
#
|
8188
8189
|
# * Delayed: The system attempted to send the command to the target,
|
8189
|
-
# but the target wasn't available. The
|
8190
|
-
# available because of network issues, because the
|
8191
|
-
#
|
8192
|
-
#
|
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.
|
8193
8194
|
#
|
8194
8195
|
# * Success: The command or plugin ran successfully. This is a
|
8195
8196
|
# terminal state.
|
8196
8197
|
#
|
8197
|
-
# * Delivery Timed Out: The command wasn't delivered to the
|
8198
|
-
# 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
|
8199
8200
|
# count against the parent command's `MaxErrors` limit, but they do
|
8200
8201
|
# contribute to whether the parent command status is Success or
|
8201
8202
|
# Incomplete. This is a terminal state.
|
8202
8203
|
#
|
8203
|
-
# * Execution Timed Out: The command started to run on the
|
8204
|
-
# but the execution wasn't complete before the timeout
|
8205
|
-
# Execution timeouts count against the `MaxErrors` limit of
|
8206
|
-
# 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.
|
8207
8208
|
#
|
8208
|
-
# * Failed: The command wasn't run successfully on the
|
8209
|
-
# a plugin, this indicates that the result code wasn't zero.
|
8210
|
-
# command invocation, this indicates that the result code for
|
8211
|
-
# more plugins wasn't zero. Invocation failures count
|
8212
|
-
# `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.
|
8213
8215
|
#
|
8214
8216
|
# * Canceled: The command was terminated before it was completed. This
|
8215
8217
|
# is a terminal state.
|
8216
8218
|
#
|
8217
|
-
# * Undeliverable: The command can't be delivered to the
|
8218
|
-
# The
|
8219
|
+
# * Undeliverable: The command can't be delivered to the managed
|
8220
|
+
# node. The node might not exist or might not be responding.
|
8219
8221
|
# Undeliverable invocations don't count against the parent
|
8220
8222
|
# command's `MaxErrors` limit and don't contribute to whether the
|
8221
8223
|
# parent command status is Success or Incomplete. This is a terminal
|
@@ -8289,7 +8291,7 @@ module Aws::SSM
|
|
8289
8291
|
# }
|
8290
8292
|
#
|
8291
8293
|
# @!attribute [rw] target
|
8292
|
-
# The
|
8294
|
+
# The managed node ID.
|
8293
8295
|
# @return [String]
|
8294
8296
|
#
|
8295
8297
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetConnectionStatusRequest AWS API Documentation
|
@@ -8301,11 +8303,11 @@ module Aws::SSM
|
|
8301
8303
|
end
|
8302
8304
|
|
8303
8305
|
# @!attribute [rw] target
|
8304
|
-
# The ID of the
|
8306
|
+
# The ID of the managed node to check connection status.
|
8305
8307
|
# @return [String]
|
8306
8308
|
#
|
8307
8309
|
# @!attribute [rw] status
|
8308
|
-
# The status of the connection to the
|
8310
|
+
# The status of the connection to the managed node. For example,
|
8309
8311
|
# 'Connected' or 'Not Connected'.
|
8310
8312
|
# @return [String]
|
8311
8313
|
#
|
@@ -8405,7 +8407,7 @@ module Aws::SSM
|
|
8405
8407
|
# }
|
8406
8408
|
#
|
8407
8409
|
# @!attribute [rw] instance_id
|
8408
|
-
# The ID of the
|
8410
|
+
# The ID of the managed node for which the appropriate patch snapshot
|
8409
8411
|
# should be retrieved.
|
8410
8412
|
# @return [String]
|
8411
8413
|
#
|
@@ -8429,7 +8431,7 @@ module Aws::SSM
|
|
8429
8431
|
end
|
8430
8432
|
|
8431
8433
|
# @!attribute [rw] instance_id
|
8432
|
-
# The
|
8434
|
+
# The managed node ID.
|
8433
8435
|
# @return [String]
|
8434
8436
|
#
|
8435
8437
|
# @!attribute [rw] snapshot_id
|
@@ -8443,7 +8445,7 @@ module Aws::SSM
|
|
8443
8445
|
#
|
8444
8446
|
# @!attribute [rw] product
|
8445
8447
|
# Returns the specific operating system (for example Windows Server
|
8446
|
-
# 2012 or Amazon Linux 2015.09) on the
|
8448
|
+
# 2012 or Amazon Linux 2015.09) on the managed node for the specified
|
8447
8449
|
# patch snapshot.
|
8448
8450
|
# @return [String]
|
8449
8451
|
#
|
@@ -8640,7 +8642,7 @@ module Aws::SSM
|
|
8640
8642
|
# Returns counts of inventory types based on one or more expressions.
|
8641
8643
|
# For example, if you aggregate by using an expression that uses the
|
8642
8644
|
# `AWS:InstanceInformation.PlatformType` type, you can see a count of
|
8643
|
-
# how many Windows and Linux
|
8645
|
+
# how many Windows and Linux managed nodes exist in your inventoried
|
8644
8646
|
# fleet.
|
8645
8647
|
# @return [Array<Types::InventoryAggregator>]
|
8646
8648
|
#
|
@@ -8672,8 +8674,8 @@ module Aws::SSM
|
|
8672
8674
|
end
|
8673
8675
|
|
8674
8676
|
# @!attribute [rw] entities
|
8675
|
-
# Collection of inventory entities such as a collection of
|
8676
|
-
# inventory.
|
8677
|
+
# Collection of inventory entities such as a collection of managed
|
8678
|
+
# node inventory.
|
8677
8679
|
# @return [Array<Types::InventoryResultEntity>]
|
8678
8680
|
#
|
8679
8681
|
# @!attribute [rw] next_token
|
@@ -9855,8 +9857,8 @@ module Aws::SSM
|
|
9855
9857
|
#
|
9856
9858
|
# @!attribute [rw] approved_patches_enable_non_security
|
9857
9859
|
# Indicates whether the list of approved patches includes non-security
|
9858
|
-
# updates that should be applied to the
|
9859
|
-
# 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.
|
9860
9862
|
# @return [Boolean]
|
9861
9863
|
#
|
9862
9864
|
# @!attribute [rw] rejected_patches
|
@@ -9887,9 +9889,9 @@ module Aws::SSM
|
|
9887
9889
|
# @return [String]
|
9888
9890
|
#
|
9889
9891
|
# @!attribute [rw] sources
|
9890
|
-
# Information about the patches to use to update the
|
9892
|
+
# Information about the patches to use to update the managed nodes,
|
9891
9893
|
# including target operating systems and source repositories. Applies
|
9892
|
-
# to Linux
|
9894
|
+
# to Linux managed nodes only.
|
9893
9895
|
# @return [Array<Types::PatchSource>]
|
9894
9896
|
#
|
9895
9897
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/GetPatchBaselineResult AWS API Documentation
|
@@ -10045,7 +10047,7 @@ module Aws::SSM
|
|
10045
10047
|
# @return [String]
|
10046
10048
|
#
|
10047
10049
|
# @!attribute [rw] instance_association_status_aggregated_count
|
10048
|
-
# The number of associations for the
|
10050
|
+
# The number of associations for the managed node(s).
|
10049
10051
|
# @return [Hash<String,Integer>]
|
10050
10052
|
#
|
10051
10053
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceAggregatedAssociationOverview AWS API Documentation
|
@@ -10057,22 +10059,22 @@ module Aws::SSM
|
|
10057
10059
|
include Aws::Structure
|
10058
10060
|
end
|
10059
10061
|
|
10060
|
-
# One or more association documents on the
|
10062
|
+
# One or more association documents on the managed node.
|
10061
10063
|
#
|
10062
10064
|
# @!attribute [rw] association_id
|
10063
10065
|
# The association ID.
|
10064
10066
|
# @return [String]
|
10065
10067
|
#
|
10066
10068
|
# @!attribute [rw] instance_id
|
10067
|
-
# The
|
10069
|
+
# The managed node ID.
|
10068
10070
|
# @return [String]
|
10069
10071
|
#
|
10070
10072
|
# @!attribute [rw] content
|
10071
|
-
# The content of the association document for the
|
10073
|
+
# The content of the association document for the managed node(s).
|
10072
10074
|
# @return [String]
|
10073
10075
|
#
|
10074
10076
|
# @!attribute [rw] association_version
|
10075
|
-
# Version information for the association on the
|
10077
|
+
# Version information for the association on the managed node.
|
10076
10078
|
# @return [String]
|
10077
10079
|
#
|
10078
10080
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceAssociation AWS API Documentation
|
@@ -10135,7 +10137,7 @@ module Aws::SSM
|
|
10135
10137
|
include Aws::Structure
|
10136
10138
|
end
|
10137
10139
|
|
10138
|
-
# Status information about the
|
10140
|
+
# Status information about the association.
|
10139
10141
|
#
|
10140
10142
|
# @!attribute [rw] association_id
|
10141
10143
|
# The association ID.
|
@@ -10150,23 +10152,23 @@ module Aws::SSM
|
|
10150
10152
|
# @return [String]
|
10151
10153
|
#
|
10152
10154
|
# @!attribute [rw] association_version
|
10153
|
-
# The version of the association applied to the
|
10155
|
+
# The version of the association applied to the managed node.
|
10154
10156
|
# @return [String]
|
10155
10157
|
#
|
10156
10158
|
# @!attribute [rw] instance_id
|
10157
|
-
# The
|
10159
|
+
# The managed node ID where the association was created.
|
10158
10160
|
# @return [String]
|
10159
10161
|
#
|
10160
10162
|
# @!attribute [rw] execution_date
|
10161
|
-
# The date the
|
10163
|
+
# The date the association ran.
|
10162
10164
|
# @return [Time]
|
10163
10165
|
#
|
10164
10166
|
# @!attribute [rw] status
|
10165
|
-
# Status information about the
|
10167
|
+
# Status information about the association.
|
10166
10168
|
# @return [String]
|
10167
10169
|
#
|
10168
10170
|
# @!attribute [rw] detailed_status
|
10169
|
-
# Detailed status information about the
|
10171
|
+
# Detailed status information about the association.
|
10170
10172
|
# @return [String]
|
10171
10173
|
#
|
10172
10174
|
# @!attribute [rw] execution_summary
|
@@ -10183,7 +10185,7 @@ module Aws::SSM
|
|
10183
10185
|
# @return [Types::InstanceAssociationOutputUrl]
|
10184
10186
|
#
|
10185
10187
|
# @!attribute [rw] association_name
|
10186
|
-
# The name of the association applied to the
|
10188
|
+
# The name of the association applied to the managed node.
|
10187
10189
|
# @return [String]
|
10188
10190
|
#
|
10189
10191
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceAssociationStatusInfo AWS API Documentation
|
@@ -10205,10 +10207,10 @@ module Aws::SSM
|
|
10205
10207
|
include Aws::Structure
|
10206
10208
|
end
|
10207
10209
|
|
10208
|
-
# Describes a filter for a specific list of
|
10210
|
+
# Describes a filter for a specific list of managed nodes.
|
10209
10211
|
#
|
10210
10212
|
# @!attribute [rw] instance_id
|
10211
|
-
# The
|
10213
|
+
# The managed node ID.
|
10212
10214
|
# @return [String]
|
10213
10215
|
#
|
10214
10216
|
# @!attribute [rw] ping_status
|
@@ -10225,15 +10227,15 @@ module Aws::SSM
|
|
10225
10227
|
# @return [Time]
|
10226
10228
|
#
|
10227
10229
|
# @!attribute [rw] agent_version
|
10228
|
-
# The version of SSM Agent running on your Linux
|
10230
|
+
# The version of SSM Agent running on your Linux managed node.
|
10229
10231
|
# @return [String]
|
10230
10232
|
#
|
10231
10233
|
# @!attribute [rw] is_latest_version
|
10232
10234
|
# Indicates whether the latest version of SSM Agent is running on your
|
10233
|
-
# Linux
|
10234
|
-
#
|
10235
|
-
#
|
10236
|
-
#
|
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.
|
10237
10239
|
# @return [Boolean]
|
10238
10240
|
#
|
10239
10241
|
# @!attribute [rw] platform_type
|
@@ -10241,11 +10243,12 @@ module Aws::SSM
|
|
10241
10243
|
# @return [String]
|
10242
10244
|
#
|
10243
10245
|
# @!attribute [rw] platform_name
|
10244
|
-
# The name of the operating system platform running on your
|
10246
|
+
# The name of the operating system platform running on your managed
|
10247
|
+
# node.
|
10245
10248
|
# @return [String]
|
10246
10249
|
#
|
10247
10250
|
# @!attribute [rw] platform_version
|
10248
|
-
# The version of the OS platform running on your
|
10251
|
+
# The version of the OS platform running on your managed node.
|
10249
10252
|
# @return [String]
|
10250
10253
|
#
|
10251
10254
|
# @!attribute [rw] activation_id
|
@@ -10255,8 +10258,8 @@ module Aws::SSM
|
|
10255
10258
|
#
|
10256
10259
|
# @!attribute [rw] iam_role
|
10257
10260
|
# The Identity and Access Management (IAM) role assigned to the
|
10258
|
-
# on-premises Systems Manager managed
|
10259
|
-
#
|
10261
|
+
# on-premises Systems Manager managed node. This call doesn't return
|
10262
|
+
# the IAM role for Amazon Elastic Compute Cloud (Amazon EC2)
|
10260
10263
|
# instances. To retrieve the IAM role for an EC2 instance, use the
|
10261
10264
|
# Amazon EC2 `DescribeInstances` operation. For information, see
|
10262
10265
|
# [DescribeInstances][1] in the *Amazon EC2 API Reference* or
|
@@ -10271,7 +10274,7 @@ module Aws::SSM
|
|
10271
10274
|
#
|
10272
10275
|
# @!attribute [rw] registration_date
|
10273
10276
|
# The date the server or VM was registered with Amazon Web Services as
|
10274
|
-
# a managed
|
10277
|
+
# a managed node.
|
10275
10278
|
# @return [Time]
|
10276
10279
|
#
|
10277
10280
|
# @!attribute [rw] resource_type
|
@@ -10280,14 +10283,14 @@ module Aws::SSM
|
|
10280
10283
|
# @return [String]
|
10281
10284
|
#
|
10282
10285
|
# @!attribute [rw] name
|
10283
|
-
# The name assigned to an on-premises server or virtual
|
10284
|
-
# when it is activated as a Systems Manager managed
|
10285
|
-
# is specified as the `DefaultInstanceName` property using
|
10286
|
-
# 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
|
10287
10290
|
# specifying the Activation Code and Activation ID when you install
|
10288
|
-
# SSM Agent on the
|
10291
|
+
# SSM Agent on the node, as explained in [Install SSM Agent for a
|
10289
10292
|
# hybrid environment (Linux)][1] and [Install SSM Agent for a hybrid
|
10290
|
-
# environment (Windows)][2]. To retrieve the Name tag of an EC2
|
10293
|
+
# environment (Windows)][2]. To retrieve the `Name` tag of an EC2
|
10291
10294
|
# instance, use the Amazon EC2 `DescribeInstances` operation. For
|
10292
10295
|
# information, see [DescribeInstances][3] in the *Amazon EC2 API
|
10293
10296
|
# Reference* or [describe-instances][4] in the *Amazon Web Services
|
@@ -10302,11 +10305,11 @@ module Aws::SSM
|
|
10302
10305
|
# @return [String]
|
10303
10306
|
#
|
10304
10307
|
# @!attribute [rw] ip_address
|
10305
|
-
# The IP address of the managed
|
10308
|
+
# The IP address of the managed node.
|
10306
10309
|
# @return [String]
|
10307
10310
|
#
|
10308
10311
|
# @!attribute [rw] computer_name
|
10309
|
-
# The fully qualified host name of the managed
|
10312
|
+
# The fully qualified host name of the managed node.
|
10310
10313
|
# @return [String]
|
10311
10314
|
#
|
10312
10315
|
# @!attribute [rw] association_status
|
@@ -10325,6 +10328,16 @@ module Aws::SSM
|
|
10325
10328
|
# Information about the association.
|
10326
10329
|
# @return [Types::InstanceAggregatedAssociationOverview]
|
10327
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
|
+
#
|
10328
10341
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstanceInformation AWS API Documentation
|
10329
10342
|
#
|
10330
10343
|
class InstanceInformation < Struct.new(
|
@@ -10346,13 +10359,15 @@ module Aws::SSM
|
|
10346
10359
|
:association_status,
|
10347
10360
|
:last_association_execution_date,
|
10348
10361
|
:last_successful_association_execution_date,
|
10349
|
-
:association_overview
|
10362
|
+
:association_overview,
|
10363
|
+
:source_id,
|
10364
|
+
:source_type)
|
10350
10365
|
SENSITIVE = []
|
10351
10366
|
include Aws::Structure
|
10352
10367
|
end
|
10353
10368
|
|
10354
|
-
# Describes a filter for a specific list of
|
10355
|
-
#
|
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
|
10356
10371
|
# key-value mapping.
|
10357
10372
|
#
|
10358
10373
|
# Use this operation instead of the
|
@@ -10385,8 +10400,7 @@ module Aws::SSM
|
|
10385
10400
|
include Aws::Structure
|
10386
10401
|
end
|
10387
10402
|
|
10388
|
-
# The filters to describe or get information about your managed
|
10389
|
-
# instances.
|
10403
|
+
# The filters to describe or get information about your managed nodes.
|
10390
10404
|
#
|
10391
10405
|
# @note When making an API call, you may pass InstanceInformationStringFilter
|
10392
10406
|
# data as a hash:
|
@@ -10397,7 +10411,7 @@ module Aws::SSM
|
|
10397
10411
|
# }
|
10398
10412
|
#
|
10399
10413
|
# @!attribute [rw] key
|
10400
|
-
# The filter key name to describe your
|
10414
|
+
# The filter key name to describe your managed nodes. For example:
|
10401
10415
|
#
|
10402
10416
|
# "InstanceIds"\|"AgentVersion"\|"PingStatus"\|"PlatformTypes"\|"ActivationIds"\|"IamRole"\|"ResourceType"\|"AssociationStatus"\|"Tag
|
10403
10417
|
# Key"
|
@@ -10421,22 +10435,22 @@ module Aws::SSM
|
|
10421
10435
|
include Aws::Structure
|
10422
10436
|
end
|
10423
10437
|
|
10424
|
-
# Defines the high-level patch compliance state for a managed
|
10438
|
+
# Defines the high-level patch compliance state for a managed node,
|
10425
10439
|
# providing information about the number of installed, missing, not
|
10426
10440
|
# applicable, and failed patches along with metadata about the operation
|
10427
|
-
# when this information was gathered for the
|
10441
|
+
# when this information was gathered for the managed node.
|
10428
10442
|
#
|
10429
10443
|
# @!attribute [rw] instance_id
|
10430
|
-
# The ID of the managed
|
10444
|
+
# The ID of the managed node the high-level patch compliance
|
10431
10445
|
# information was collected for.
|
10432
10446
|
# @return [String]
|
10433
10447
|
#
|
10434
10448
|
# @!attribute [rw] patch_group
|
10435
|
-
# The name of the patch group the managed
|
10449
|
+
# The name of the patch group the managed node belongs to.
|
10436
10450
|
# @return [String]
|
10437
10451
|
#
|
10438
10452
|
# @!attribute [rw] baseline_id
|
10439
|
-
# The ID of the patch baseline used to patch the
|
10453
|
+
# The ID of the patch baseline used to patch the managed node.
|
10440
10454
|
# @return [String]
|
10441
10455
|
#
|
10442
10456
|
# @!attribute [rw] snapshot_id
|
@@ -10467,22 +10481,22 @@ module Aws::SSM
|
|
10467
10481
|
#
|
10468
10482
|
# @!attribute [rw] installed_count
|
10469
10483
|
# The number of patches from the patch baseline that are installed on
|
10470
|
-
# the
|
10484
|
+
# the managed node.
|
10471
10485
|
# @return [Integer]
|
10472
10486
|
#
|
10473
10487
|
# @!attribute [rw] installed_other_count
|
10474
10488
|
# The number of patches not specified in the patch baseline that are
|
10475
|
-
# installed on the
|
10489
|
+
# installed on the managed node.
|
10476
10490
|
# @return [Integer]
|
10477
10491
|
#
|
10478
10492
|
# @!attribute [rw] installed_pending_reboot_count
|
10479
10493
|
# The number of patches installed by Patch Manager since the last time
|
10480
|
-
# the
|
10494
|
+
# the managed node was rebooted.
|
10481
10495
|
# @return [Integer]
|
10482
10496
|
#
|
10483
10497
|
# @!attribute [rw] installed_rejected_count
|
10484
|
-
# The number of patches installed on
|
10485
|
-
# 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
|
10486
10500
|
# `InstalledRejected` were typically installed before they were added
|
10487
10501
|
# to a `RejectedPatches` list.
|
10488
10502
|
#
|
@@ -10495,7 +10509,7 @@ module Aws::SSM
|
|
10495
10509
|
#
|
10496
10510
|
# @!attribute [rw] missing_count
|
10497
10511
|
# The number of patches from the patch baseline that are applicable
|
10498
|
-
# for the
|
10512
|
+
# for the managed node but aren't currently installed.
|
10499
10513
|
# @return [Integer]
|
10500
10514
|
#
|
10501
10515
|
# @!attribute [rw] failed_count
|
@@ -10512,20 +10526,20 @@ module Aws::SSM
|
|
10512
10526
|
#
|
10513
10527
|
# @!attribute [rw] not_applicable_count
|
10514
10528
|
# The number of patches from the patch baseline that aren't
|
10515
|
-
# applicable for the
|
10516
|
-
#
|
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
|
10517
10531
|
# very large. The number of patches beyond this limit are reported in
|
10518
10532
|
# `UnreportedNotApplicableCount`.
|
10519
10533
|
# @return [Integer]
|
10520
10534
|
#
|
10521
10535
|
# @!attribute [rw] operation_start_time
|
10522
10536
|
# The time the most recent patching operation was started on the
|
10523
|
-
#
|
10537
|
+
# managed node.
|
10524
10538
|
# @return [Time]
|
10525
10539
|
#
|
10526
10540
|
# @!attribute [rw] operation_end_time
|
10527
|
-
# The time the most recent patching operation completed on the
|
10528
|
-
#
|
10541
|
+
# The time the most recent patching operation completed on the managed
|
10542
|
+
# node.
|
10529
10543
|
# @return [Time]
|
10530
10544
|
#
|
10531
10545
|
# @!attribute [rw] operation
|
@@ -10537,8 +10551,8 @@ module Aws::SSM
|
|
10537
10551
|
# @return [String]
|
10538
10552
|
#
|
10539
10553
|
# @!attribute [rw] last_no_reboot_install_operation_time
|
10540
|
-
# The time of the last attempt to patch the
|
10541
|
-
# 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.
|
10542
10556
|
# @return [Time]
|
10543
10557
|
#
|
10544
10558
|
# @!attribute [rw] reboot_option
|
@@ -10549,8 +10563,8 @@ module Aws::SSM
|
|
10549
10563
|
#
|
10550
10564
|
# </note>
|
10551
10565
|
#
|
10552
|
-
# * `RebootIfNeeded`\: Patch Manager tries to reboot the
|
10553
|
-
# 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
|
10554
10568
|
# status of `InstalledPendingReboot`.
|
10555
10569
|
#
|
10556
10570
|
# * `NoReboot`\: Patch Manager attempts to install missing packages
|
@@ -10560,25 +10574,26 @@ module Aws::SSM
|
|
10560
10574
|
# @return [String]
|
10561
10575
|
#
|
10562
10576
|
# @!attribute [rw] critical_non_compliant_count
|
10563
|
-
# The number of
|
10577
|
+
# The number of managed nodes where patches that are specified as
|
10564
10578
|
# `Critical` for compliance reporting in the patch baseline aren't
|
10565
10579
|
# installed. These patches might be missing, have failed installation,
|
10566
|
-
# were rejected, or were installed but awaiting a required
|
10567
|
-
# 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`.
|
10568
10582
|
# @return [Integer]
|
10569
10583
|
#
|
10570
10584
|
# @!attribute [rw] security_non_compliant_count
|
10571
|
-
# The number of
|
10585
|
+
# The number of managed nodes where patches that are specified as
|
10572
10586
|
# `Security` in a patch advisory aren't installed. These patches
|
10573
10587
|
# might be missing, have failed installation, were rejected, or were
|
10574
|
-
# installed but awaiting a required
|
10575
|
-
# these
|
10588
|
+
# installed but awaiting a required managed node reboot. The status of
|
10589
|
+
# these managed nodes is `NON_COMPLIANT`.
|
10576
10590
|
# @return [Integer]
|
10577
10591
|
#
|
10578
10592
|
# @!attribute [rw] other_non_compliant_count
|
10579
|
-
# The number of
|
10580
|
-
# other than `Critical` or `Security` but aren't
|
10581
|
-
# 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`.
|
10582
10597
|
# @return [Integer]
|
10583
10598
|
#
|
10584
10599
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InstancePatchState AWS API Documentation
|
@@ -10613,9 +10628,9 @@ module Aws::SSM
|
|
10613
10628
|
# Defines a filter used in DescribeInstancePatchStatesForPatchGroup to
|
10614
10629
|
# scope down the information returned by the API.
|
10615
10630
|
#
|
10616
|
-
# **Example**\: To filter for all
|
10617
|
-
# than three patches with a `FailedCount` status, use the following
|
10618
|
-
# 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:
|
10619
10634
|
#
|
10620
10635
|
# * Value for `Key`\: `FailedCount`
|
10621
10636
|
#
|
@@ -10980,7 +10995,7 @@ module Aws::SSM
|
|
10980
10995
|
|
10981
10996
|
# The following problems can cause this exception:
|
10982
10997
|
#
|
10983
|
-
# * You don't have permission to access the
|
10998
|
+
# * You don't have permission to access the managed node.
|
10984
10999
|
#
|
10985
11000
|
# * Amazon Web Services Systems Manager Agent(SSM Agent) isn't running.
|
10986
11001
|
# Verify that SSM Agent is running.
|
@@ -10988,7 +11003,7 @@ module Aws::SSM
|
|
10988
11003
|
# * SSM Agent isn't registered with the SSM endpoint. Try reinstalling
|
10989
11004
|
# SSM Agent.
|
10990
11005
|
#
|
10991
|
-
# * The
|
11006
|
+
# * The managed node isn't in valid state. Valid states are: `Running`,
|
10992
11007
|
# `Pending`, `Stopped`, and `Stopping`. Invalid states are:
|
10993
11008
|
# `Shutting-down` and `Terminated`.
|
10994
11009
|
#
|
@@ -11211,7 +11226,7 @@ module Aws::SSM
|
|
11211
11226
|
class InvalidResourceId < Aws::EmptyStructure; end
|
11212
11227
|
|
11213
11228
|
# The resource type isn't valid. For example, if you are attempting to
|
11214
|
-
# tag an instance, the instance must be a registered
|
11229
|
+
# tag an EC2 instance, the instance must be a registered managed node.
|
11215
11230
|
#
|
11216
11231
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InvalidResourceType AWS API Documentation
|
11217
11232
|
#
|
@@ -11492,8 +11507,8 @@ module Aws::SSM
|
|
11492
11507
|
# @return [String]
|
11493
11508
|
#
|
11494
11509
|
# @!attribute [rw] values
|
11495
|
-
# Inventory filter values. Example: inventory filter where
|
11496
|
-
# IDs are specified as values
|
11510
|
+
# Inventory filter values. Example: inventory filter where managed
|
11511
|
+
# node IDs are specified as values
|
11497
11512
|
# `Key=AWS:InstanceInformation.InstanceId,Values= i-a12b3c4d5e6g,
|
11498
11513
|
# i-1a2b3c4d5e6,Type=Equal`.
|
11499
11514
|
# @return [Array<String>]
|
@@ -11560,7 +11575,7 @@ module Aws::SSM
|
|
11560
11575
|
include Aws::Structure
|
11561
11576
|
end
|
11562
11577
|
|
11563
|
-
# Information collected from managed
|
11578
|
+
# Information collected from managed nodes based on your inventory
|
11564
11579
|
# policy document
|
11565
11580
|
#
|
11566
11581
|
# @note When making an API call, you may pass InventoryItem
|
@@ -11687,9 +11702,9 @@ module Aws::SSM
|
|
11687
11702
|
# Inventory query results.
|
11688
11703
|
#
|
11689
11704
|
# @!attribute [rw] id
|
11690
|
-
# ID of the inventory result entity. For example, for managed
|
11691
|
-
# inventory the result will be the managed
|
11692
|
-
#
|
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.
|
11693
11708
|
# @return [String]
|
11694
11709
|
#
|
11695
11710
|
# @!attribute [rw] data
|
@@ -11743,8 +11758,9 @@ module Aws::SSM
|
|
11743
11758
|
include Aws::Structure
|
11744
11759
|
end
|
11745
11760
|
|
11746
|
-
# The command ID and
|
11747
|
-
# 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.
|
11748
11764
|
#
|
11749
11765
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/InvocationDoesNotExist AWS API Documentation
|
11750
11766
|
#
|
@@ -11913,7 +11929,7 @@ module Aws::SSM
|
|
11913
11929
|
#
|
11914
11930
|
# <note markdown="1"> Filtering associations using the `InstanceID` attribute only returns
|
11915
11931
|
# legacy associations created using the `InstanceID` attribute.
|
11916
|
-
# Associations targeting the
|
11932
|
+
# Associations targeting the managed node that are part of the Target
|
11917
11933
|
# Attributes `ResourceGroup` or `Tags` aren't returned.
|
11918
11934
|
#
|
11919
11935
|
# </note>
|
@@ -11980,7 +11996,8 @@ module Aws::SSM
|
|
11980
11996
|
# @return [String]
|
11981
11997
|
#
|
11982
11998
|
# @!attribute [rw] instance_id
|
11983
|
-
# (Optional) The command execution details for a specific
|
11999
|
+
# (Optional) The command execution details for a specific managed node
|
12000
|
+
# ID.
|
11984
12001
|
# @return [String]
|
11985
12002
|
#
|
11986
12003
|
# @!attribute [rw] max_results
|
@@ -12056,11 +12073,11 @@ module Aws::SSM
|
|
12056
12073
|
# @return [String]
|
12057
12074
|
#
|
12058
12075
|
# @!attribute [rw] instance_id
|
12059
|
-
# (Optional) Lists commands issued against this
|
12076
|
+
# (Optional) Lists commands issued against this managed node ID.
|
12060
12077
|
#
|
12061
|
-
# <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
|
12062
12079
|
# specify `Status` = `Pending`. This is because the command hasn't
|
12063
|
-
# reached the
|
12080
|
+
# reached the managed node yet.
|
12064
12081
|
#
|
12065
12082
|
# </note>
|
12066
12083
|
# @return [String]
|
@@ -12480,7 +12497,7 @@ module Aws::SSM
|
|
12480
12497
|
# }
|
12481
12498
|
#
|
12482
12499
|
# @!attribute [rw] instance_id
|
12483
|
-
# The
|
12500
|
+
# The managed node ID for which you want inventory information.
|
12484
12501
|
# @return [String]
|
12485
12502
|
#
|
12486
12503
|
# @!attribute [rw] type_name
|
@@ -12520,21 +12537,21 @@ module Aws::SSM
|
|
12520
12537
|
# @return [String]
|
12521
12538
|
#
|
12522
12539
|
# @!attribute [rw] instance_id
|
12523
|
-
# The
|
12540
|
+
# The managed node ID targeted by the request to query inventory
|
12524
12541
|
# information.
|
12525
12542
|
# @return [String]
|
12526
12543
|
#
|
12527
12544
|
# @!attribute [rw] schema_version
|
12528
|
-
# The inventory schema version used by the
|
12545
|
+
# The inventory schema version used by the managed node(s).
|
12529
12546
|
# @return [String]
|
12530
12547
|
#
|
12531
12548
|
# @!attribute [rw] capture_time
|
12532
|
-
# The time that inventory information was collected for the
|
12533
|
-
#
|
12549
|
+
# The time that inventory information was collected for the managed
|
12550
|
+
# node(s).
|
12534
12551
|
# @return [String]
|
12535
12552
|
#
|
12536
12553
|
# @!attribute [rw] entries
|
12537
|
-
# A list of inventory items on the
|
12554
|
+
# A list of inventory items on the managed node(s).
|
12538
12555
|
# @return [Array<Hash<String,String>>]
|
12539
12556
|
#
|
12540
12557
|
# @!attribute [rw] next_token
|
@@ -12780,7 +12797,7 @@ module Aws::SSM
|
|
12780
12797
|
end
|
12781
12798
|
|
12782
12799
|
# @!attribute [rw] resource_compliance_summary_items
|
12783
|
-
# A summary count for specified or targeted managed
|
12800
|
+
# A summary count for specified or targeted managed nodes. Summary
|
12784
12801
|
# count includes information about compliant and non-compliant State
|
12785
12802
|
# Manager associations, patch status, or custom items according to the
|
12786
12803
|
# filter criteria that you specify.
|
@@ -12895,7 +12912,7 @@ module Aws::SSM
|
|
12895
12912
|
end
|
12896
12913
|
|
12897
12914
|
# Information about an Amazon Simple Storage Service (Amazon S3) bucket
|
12898
|
-
# to write
|
12915
|
+
# to write managed node-level logs to.
|
12899
12916
|
#
|
12900
12917
|
# <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple Storage
|
12901
12918
|
# Service (Amazon S3) bucket to contain logs, instead use the
|
@@ -13446,7 +13463,7 @@ module Aws::SSM
|
|
13446
13463
|
#
|
13447
13464
|
# @!attribute [rw] notification_config
|
13448
13465
|
# Configurations for sending notifications about command status
|
13449
|
-
# changes on a per-
|
13466
|
+
# changes on a per-managed node basis.
|
13450
13467
|
# @return [Types::NotificationConfig]
|
13451
13468
|
#
|
13452
13469
|
# @!attribute [rw] output_s3_bucket_name
|
@@ -13556,9 +13573,9 @@ module Aws::SSM
|
|
13556
13573
|
# @return [String]
|
13557
13574
|
#
|
13558
13575
|
# @!attribute [rw] targets
|
13559
|
-
# The targets, either
|
13576
|
+
# The targets, either managed nodes or tags.
|
13560
13577
|
#
|
13561
|
-
# Specify
|
13578
|
+
# Specify managed nodes using the following format:
|
13562
13579
|
#
|
13563
13580
|
# `Key=instanceids,Values=<instanceid1>,<instanceid2>`
|
13564
13581
|
#
|
@@ -13618,8 +13635,9 @@ module Aws::SSM
|
|
13618
13635
|
# @return [String]
|
13619
13636
|
#
|
13620
13637
|
# @!attribute [rw] targets
|
13621
|
-
# The targets (either
|
13622
|
-
# using
|
13638
|
+
# The targets (either managed nodes or tags). Managed nodes are
|
13639
|
+
# specified using
|
13640
|
+
# `Key=instanceids,Values=<instanceid1>,<instanceid2>`. Tags are
|
13623
13641
|
# specified using `Key=<tag name>,Values=<tag value>`.
|
13624
13642
|
# @return [Array<Types::Target>]
|
13625
13643
|
#
|
@@ -13943,9 +13961,9 @@ module Aws::SSM
|
|
13943
13961
|
# * `Command`\: Receive notification when the status of a command
|
13944
13962
|
# changes.
|
13945
13963
|
#
|
13946
|
-
# * `Invocation`\: For commands sent to multiple
|
13947
|
-
# notification on a per-
|
13948
|
-
# 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.
|
13949
13967
|
# @return [String]
|
13950
13968
|
#
|
13951
13969
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/NotificationConfig AWS API Documentation
|
@@ -15504,45 +15522,45 @@ module Aws::SSM
|
|
15504
15522
|
#
|
15505
15523
|
# @!attribute [rw] advisory_ids
|
15506
15524
|
# The Advisory ID of the patch. For example, `RHSA-2020:3779`. Applies
|
15507
|
-
# to Linux-based
|
15525
|
+
# to Linux-based managed nodes only.
|
15508
15526
|
# @return [Array<String>]
|
15509
15527
|
#
|
15510
15528
|
# @!attribute [rw] bugzilla_ids
|
15511
15529
|
# The Bugzilla ID of the patch. For example, `1600646`. Applies to
|
15512
|
-
# Linux-based
|
15530
|
+
# Linux-based managed nodes only.
|
15513
15531
|
# @return [Array<String>]
|
15514
15532
|
#
|
15515
15533
|
# @!attribute [rw] cve_ids
|
15516
15534
|
# The Common Vulnerabilities and Exposures (CVE) ID of the patch. For
|
15517
|
-
# example, `CVE-2011-3192`. Applies to Linux-based
|
15535
|
+
# example, `CVE-2011-3192`. Applies to Linux-based managed nodes only.
|
15518
15536
|
# @return [Array<String>]
|
15519
15537
|
#
|
15520
15538
|
# @!attribute [rw] name
|
15521
|
-
# The name of the patch. Applies to Linux-based
|
15539
|
+
# The name of the patch. Applies to Linux-based managed nodes only.
|
15522
15540
|
# @return [String]
|
15523
15541
|
#
|
15524
15542
|
# @!attribute [rw] epoch
|
15525
15543
|
# The epoch of the patch. For example in
|
15526
15544
|
# `pkg-example-EE-20180914-2.2.amzn1.noarch`, the epoch value is
|
15527
|
-
# `20180914-2`. Applies to Linux-based
|
15545
|
+
# `20180914-2`. Applies to Linux-based managed nodes only.
|
15528
15546
|
# @return [Integer]
|
15529
15547
|
#
|
15530
15548
|
# @!attribute [rw] version
|
15531
15549
|
# The version number of the patch. For example, in
|
15532
15550
|
# `example-pkg-1.710.10-2.7.abcd.x86_64`, the version number is
|
15533
|
-
# indicated by `-1`. Applies to Linux-based
|
15551
|
+
# indicated by `-1`. Applies to Linux-based managed nodes only.
|
15534
15552
|
# @return [String]
|
15535
15553
|
#
|
15536
15554
|
# @!attribute [rw] release
|
15537
15555
|
# The particular release of a patch. For example, in
|
15538
15556
|
# `pkg-example-EE-20180914-2.2.amzn1.noarch`, the release is
|
15539
|
-
# `2.amaz1`. Applies to Linux-based
|
15557
|
+
# `2.amaz1`. Applies to Linux-based managed nodes only.
|
15540
15558
|
# @return [String]
|
15541
15559
|
#
|
15542
15560
|
# @!attribute [rw] arch
|
15543
15561
|
# The architecture of the patch. For example, in
|
15544
15562
|
# `example-pkg-0.710.10-2.7.abcd.x86_64`, the architecture is
|
15545
|
-
# indicated by `x86_64`. Applies to Linux-based
|
15563
|
+
# indicated by `x86_64`. Applies to Linux-based managed nodes only.
|
15546
15564
|
# @return [String]
|
15547
15565
|
#
|
15548
15566
|
# @!attribute [rw] severity
|
@@ -15554,7 +15572,7 @@ module Aws::SSM
|
|
15554
15572
|
# The source patch repository for the operating system and version,
|
15555
15573
|
# such as `trusty-security` for Ubuntu Server 14.04 LTE and
|
15556
15574
|
# `focal-security` for Ubuntu Server 20.04 LTE. Applies to Linux-based
|
15557
|
-
#
|
15575
|
+
# managed nodes only.
|
15558
15576
|
# @return [String]
|
15559
15577
|
#
|
15560
15578
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/Patch AWS API Documentation
|
@@ -15625,8 +15643,8 @@ module Aws::SSM
|
|
15625
15643
|
include Aws::Structure
|
15626
15644
|
end
|
15627
15645
|
|
15628
|
-
# Information about the state of a patch on a particular
|
15629
|
-
# 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.
|
15630
15648
|
#
|
15631
15649
|
# @!attribute [rw] title
|
15632
15650
|
# The title of the patch.
|
@@ -15647,7 +15665,8 @@ module Aws::SSM
|
|
15647
15665
|
# @return [String]
|
15648
15666
|
#
|
15649
15667
|
# @!attribute [rw] state
|
15650
|
-
# The state of the patch on the
|
15668
|
+
# The state of the patch on the managed node, such as INSTALLED or
|
15669
|
+
# FAILED.
|
15651
15670
|
#
|
15652
15671
|
# For descriptions of each patch state, see [About patch
|
15653
15672
|
# compliance][1] in the *Amazon Web Services Systems Manager User
|
@@ -15659,7 +15678,7 @@ module Aws::SSM
|
|
15659
15678
|
# @return [String]
|
15660
15679
|
#
|
15661
15680
|
# @!attribute [rw] installed_time
|
15662
|
-
# The date/time the patch was installed on the
|
15681
|
+
# The date/time the patch was installed on the managed node. Not all
|
15663
15682
|
# operating systems provide this level of information.
|
15664
15683
|
# @return [Time]
|
15665
15684
|
#
|
@@ -15863,10 +15882,10 @@ module Aws::SSM
|
|
15863
15882
|
# @return [String]
|
15864
15883
|
#
|
15865
15884
|
# @!attribute [rw] enable_non_security
|
15866
|
-
# For
|
15885
|
+
# For managed nodes identified by the approval rule filters, enables a
|
15867
15886
|
# patch baseline to apply non-security updates available in the
|
15868
15887
|
# specified repository. The default value is `false`. Applies to Linux
|
15869
|
-
#
|
15888
|
+
# managed nodes only.
|
15870
15889
|
# @return [Boolean]
|
15871
15890
|
#
|
15872
15891
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PatchRule AWS API Documentation
|
@@ -15917,9 +15936,9 @@ module Aws::SSM
|
|
15917
15936
|
include Aws::Structure
|
15918
15937
|
end
|
15919
15938
|
|
15920
|
-
# Information about the patches to use to update the
|
15939
|
+
# Information about the patches to use to update the managed nodes,
|
15921
15940
|
# including target operating systems and source repository. Applies to
|
15922
|
-
# Linux
|
15941
|
+
# Linux managed nodes only.
|
15923
15942
|
#
|
15924
15943
|
# @note When making an API call, you may pass PatchSource
|
15925
15944
|
# data as a hash:
|
@@ -16085,8 +16104,8 @@ module Aws::SSM
|
|
16085
16104
|
# }
|
16086
16105
|
#
|
16087
16106
|
# @!attribute [rw] resource_id
|
16088
|
-
# Specify an ID for this resource. For a managed
|
16089
|
-
#
|
16107
|
+
# Specify an ID for this resource. For a managed node, this is the
|
16108
|
+
# node ID.
|
16090
16109
|
# @return [String]
|
16091
16110
|
#
|
16092
16111
|
# @!attribute [rw] resource_type
|
@@ -16177,11 +16196,11 @@ module Aws::SSM
|
|
16177
16196
|
# }
|
16178
16197
|
#
|
16179
16198
|
# @!attribute [rw] instance_id
|
16180
|
-
# An
|
16199
|
+
# An managed node ID where you want to add or update inventory items.
|
16181
16200
|
# @return [String]
|
16182
16201
|
#
|
16183
16202
|
# @!attribute [rw] items
|
16184
|
-
# 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.
|
16185
16204
|
# @return [Array<Types::InventoryItem>]
|
16186
16205
|
#
|
16187
16206
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/PutInventoryRequest AWS API Documentation
|
@@ -16639,7 +16658,8 @@ module Aws::SSM
|
|
16639
16658
|
#
|
16640
16659
|
# @!attribute [rw] targets
|
16641
16660
|
# The targets to register with the maintenance window. In other words,
|
16642
|
-
# the
|
16661
|
+
# the managed nodes to run commands on when the maintenance window
|
16662
|
+
# runs.
|
16643
16663
|
#
|
16644
16664
|
# <note markdown="1"> If a single maintenance window task is registered with multiple
|
16645
16665
|
# targets, its task invocations occur sequentially and not in
|
@@ -16649,35 +16669,33 @@ module Aws::SSM
|
|
16649
16669
|
#
|
16650
16670
|
# </note>
|
16651
16671
|
#
|
16652
|
-
# You can specify targets using
|
16653
|
-
# 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.
|
16654
16674
|
#
|
16655
|
-
# **Example 1**\: Specify
|
16675
|
+
# **Example 1**\: Specify managed node IDs
|
16656
16676
|
#
|
16657
|
-
# `Key=InstanceIds,Values
|
16677
|
+
# `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>,<instance-id-3>`
|
16658
16678
|
#
|
16659
|
-
# **Example 2**\: Use tag key-pairs applied to
|
16679
|
+
# **Example 2**\: Use tag key-pairs applied to managed nodes
|
16660
16680
|
#
|
16661
|
-
# `Key=tag
|
16681
|
+
# `Key=tag:<my-tag-key>,Values=<my-tag-value-1>,<my-tag-value-2>`
|
16662
16682
|
#
|
16663
|
-
# **Example 3**\: Use tag-keys applied to
|
16683
|
+
# **Example 3**\: Use tag-keys applied to managed nodes
|
16664
16684
|
#
|
16665
|
-
# `Key=tag-key,Values
|
16685
|
+
# `Key=tag-key,Values=<my-tag-key-1>,<my-tag-key-2>`
|
16666
16686
|
#
|
16667
16687
|
# **Example 4**\: Use resource group names
|
16668
16688
|
#
|
16669
|
-
# `Key=resource-groups:Name,Values
|
16689
|
+
# `Key=resource-groups:Name,Values=<resource-group-name>`
|
16670
16690
|
#
|
16671
16691
|
# **Example 5**\: Use filters for resource group types
|
16672
16692
|
#
|
16673
|
-
# `Key=resource-groups:ResourceTypeFilters,Values
|
16674
|
-
# `
|
16693
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=<resource-type-1>,<resource-type-2>`
|
16675
16694
|
#
|
16676
16695
|
# <note markdown="1"> For `Key=resource-groups:ResourceTypeFilters`, specify resource
|
16677
16696
|
# types in the following format
|
16678
16697
|
#
|
16679
|
-
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC
|
16680
|
-
# `
|
16698
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC`
|
16681
16699
|
#
|
16682
16700
|
# </note>
|
16683
16701
|
#
|
@@ -16815,7 +16833,7 @@ module Aws::SSM
|
|
16815
16833
|
# @return [String]
|
16816
16834
|
#
|
16817
16835
|
# @!attribute [rw] targets
|
16818
|
-
# The targets (either
|
16836
|
+
# The targets (either managed nodes or maintenance window targets).
|
16819
16837
|
#
|
16820
16838
|
# <note markdown="1"> One or more targets must be specified for maintenance window Run
|
16821
16839
|
# Command-type tasks. Depending on the task, targets are optional for
|
@@ -16826,7 +16844,7 @@ module Aws::SSM
|
|
16826
16844
|
#
|
16827
16845
|
# </note>
|
16828
16846
|
#
|
16829
|
-
# Specify
|
16847
|
+
# Specify managed nodes using the following format:
|
16830
16848
|
#
|
16831
16849
|
# `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
|
16832
16850
|
#
|
@@ -16919,7 +16937,7 @@ module Aws::SSM
|
|
16919
16937
|
#
|
16920
16938
|
# @!attribute [rw] logging_info
|
16921
16939
|
# A structure containing information about an Amazon Simple Storage
|
16922
|
-
# Service (Amazon S3) bucket to write
|
16940
|
+
# Service (Amazon S3) bucket to write managed node-level logs to.
|
16923
16941
|
#
|
16924
16942
|
# <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple
|
16925
16943
|
# Storage Service (Amazon S3) bucket to contain logs, instead use the
|
@@ -17066,8 +17084,8 @@ module Aws::SSM
|
|
17066
17084
|
# The type of resource from which you want to remove a tag.
|
17067
17085
|
#
|
17068
17086
|
# <note markdown="1"> The `ManagedInstance` type for this API operation is only for
|
17069
|
-
# on-premises managed
|
17070
|
-
#
|
17087
|
+
# on-premises managed nodes. Specify the name of the managed node in
|
17088
|
+
# the following format: `mi-ID_number `. For example,
|
17071
17089
|
# `mi-1a2b3c4d5e6f`.
|
17072
17090
|
#
|
17073
17091
|
# </note>
|
@@ -17094,10 +17112,9 @@ module Aws::SSM
|
|
17094
17112
|
#
|
17095
17113
|
# For the Document and Parameter values, use the name of the resource.
|
17096
17114
|
#
|
17097
|
-
# <note markdown="1"> The ManagedInstance type for this API operation is only for
|
17098
|
-
# on-premises managed
|
17099
|
-
#
|
17100
|
-
# 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.
|
17101
17118
|
#
|
17102
17119
|
# </note>
|
17103
17120
|
# @return [String]
|
@@ -17753,13 +17770,13 @@ module Aws::SSM
|
|
17753
17770
|
#
|
17754
17771
|
# @!attribute [rw] token_value
|
17755
17772
|
# An encrypted token value containing session and caller information.
|
17756
|
-
# Used to authenticate the connection to the
|
17773
|
+
# Used to authenticate the connection to the managed node.
|
17757
17774
|
# @return [String]
|
17758
17775
|
#
|
17759
17776
|
# @!attribute [rw] stream_url
|
17760
|
-
# A URL back to SSM Agent on the
|
17761
|
-
# client uses to send commands and receive output from the
|
17762
|
-
# 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:
|
17763
17780
|
# `wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output)`.
|
17764
17781
|
#
|
17765
17782
|
# **region** represents the Region identifier for an Amazon Web
|
@@ -18071,15 +18088,16 @@ module Aws::SSM
|
|
18071
18088
|
# }
|
18072
18089
|
#
|
18073
18090
|
# @!attribute [rw] instance_ids
|
18074
|
-
# The IDs of the
|
18075
|
-
#
|
18076
|
-
# 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.
|
18077
18095
|
#
|
18078
|
-
# To target a larger number of
|
18079
|
-
# 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
|
18080
18098
|
# instead. Using `Targets`, which accepts tag key-value pairs to
|
18081
|
-
# identify the
|
18082
|
-
# 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.
|
18083
18101
|
#
|
18084
18102
|
# For more information about how to use targets, see [Using targets
|
18085
18103
|
# and rate controls to send commands to a fleet][1] in the *Amazon Web
|
@@ -18091,15 +18109,15 @@ module Aws::SSM
|
|
18091
18109
|
# @return [Array<String>]
|
18092
18110
|
#
|
18093
18111
|
# @!attribute [rw] targets
|
18094
|
-
# An array of search criteria that targets
|
18112
|
+
# An array of search criteria that targets managed nodes using a
|
18095
18113
|
# `Key,Value` combination that you specify. Specifying targets is most
|
18096
|
-
# useful when you want to send a command to a large number of
|
18097
|
-
#
|
18098
|
-
#
|
18099
|
-
#
|
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.
|
18100
18118
|
#
|
18101
|
-
# To send a command to a smaller number of
|
18102
|
-
# `InstanceIds` option instead.
|
18119
|
+
# To send a command to a smaller number of managed nodes, you can use
|
18120
|
+
# the `InstanceIds` option instead.
|
18103
18121
|
#
|
18104
18122
|
# For more information about how to use targets, see [Sending commands
|
18105
18123
|
# to a fleet][1] in the *Amazon Web Services Systems Manager User
|
@@ -18193,9 +18211,9 @@ module Aws::SSM
|
|
18193
18211
|
# @return [String]
|
18194
18212
|
#
|
18195
18213
|
# @!attribute [rw] max_concurrency
|
18196
|
-
# (Optional) The maximum number of
|
18197
|
-
# the command at the same time. You can specify a number such as
|
18198
|
-
# 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
|
18199
18217
|
# information about how to use `MaxConcurrency`, see [Using
|
18200
18218
|
# concurrency controls][1] in the *Amazon Web Services Systems Manager
|
18201
18219
|
# User Guide*.
|
@@ -18355,14 +18373,14 @@ module Aws::SSM
|
|
18355
18373
|
include Aws::Structure
|
18356
18374
|
end
|
18357
18375
|
|
18358
|
-
# Information about a Session Manager connection to
|
18376
|
+
# Information about a Session Manager connection to a managed node.
|
18359
18377
|
#
|
18360
18378
|
# @!attribute [rw] session_id
|
18361
18379
|
# The ID of the session.
|
18362
18380
|
# @return [String]
|
18363
18381
|
#
|
18364
18382
|
# @!attribute [rw] target
|
18365
|
-
# The
|
18383
|
+
# The managed node that the Session Manager session connected to.
|
18366
18384
|
# @return [String]
|
18367
18385
|
#
|
18368
18386
|
# @!attribute [rw] status
|
@@ -18450,8 +18468,8 @@ module Aws::SSM
|
|
18450
18468
|
# example, specify 2018-08-29T00:00:00Z to see sessions that started
|
18451
18469
|
# before August 29, 2018.
|
18452
18470
|
#
|
18453
|
-
# * Target: Specify
|
18454
|
-
# made.
|
18471
|
+
# * Target: Specify a managed node to which session connections have
|
18472
|
+
# been made.
|
18455
18473
|
#
|
18456
18474
|
# * Owner: Specify an Amazon Web Services user account to see a list
|
18457
18475
|
# of sessions started by that user.
|
@@ -18503,7 +18521,7 @@ module Aws::SSM
|
|
18503
18521
|
include Aws::Structure
|
18504
18522
|
end
|
18505
18523
|
|
18506
|
-
# The number of managed
|
18524
|
+
# The number of managed nodes found for each patch severity level
|
18507
18525
|
# defined in the request filter.
|
18508
18526
|
#
|
18509
18527
|
# @!attribute [rw] critical_count
|
@@ -18938,7 +18956,7 @@ module Aws::SSM
|
|
18938
18956
|
# }
|
18939
18957
|
#
|
18940
18958
|
# @!attribute [rw] target
|
18941
|
-
# The
|
18959
|
+
# The managed node to connect to for the session.
|
18942
18960
|
# @return [String]
|
18943
18961
|
#
|
18944
18962
|
# @!attribute [rw] document_name
|
@@ -18946,7 +18964,7 @@ module Aws::SSM
|
|
18946
18964
|
# settings for the session. For example, `SSM-SessionManagerRunShell`.
|
18947
18965
|
# You can call the GetDocument API to verify the document exists
|
18948
18966
|
# before attempting to start a session. If no document name is
|
18949
|
-
# provided, a shell to the
|
18967
|
+
# provided, a shell to the managed node is launched by default.
|
18950
18968
|
# @return [String]
|
18951
18969
|
#
|
18952
18970
|
# @!attribute [rw] reason
|
@@ -18976,12 +18994,12 @@ module Aws::SSM
|
|
18976
18994
|
#
|
18977
18995
|
# @!attribute [rw] token_value
|
18978
18996
|
# An encrypted token value containing session and caller information.
|
18979
|
-
# Used to authenticate the connection to the
|
18997
|
+
# Used to authenticate the connection to the managed node.
|
18980
18998
|
# @return [String]
|
18981
18999
|
#
|
18982
19000
|
# @!attribute [rw] stream_url
|
18983
|
-
# A URL back to SSM Agent on the
|
18984
|
-
# 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.
|
18985
19003
|
# Format:
|
18986
19004
|
# `wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output)`
|
18987
19005
|
#
|
@@ -19226,7 +19244,7 @@ module Aws::SSM
|
|
19226
19244
|
# enable you to categorize your resources in different ways, for
|
19227
19245
|
# example, by purpose, owner, or environment. In Amazon Web Services
|
19228
19246
|
# Systems Manager, you can apply tags to Systems Manager documents (SSM
|
19229
|
-
# documents), managed
|
19247
|
+
# documents), managed nodes, maintenance windows, parameters, patch
|
19230
19248
|
# baselines, OpsItems, and OpsMetadata.
|
19231
19249
|
#
|
19232
19250
|
# @note When making an API call, you may pass Tag
|
@@ -19254,8 +19272,8 @@ module Aws::SSM
|
|
19254
19272
|
include Aws::Structure
|
19255
19273
|
end
|
19256
19274
|
|
19257
|
-
# An array of search criteria that targets
|
19258
|
-
# pair that you specify.
|
19275
|
+
# An array of search criteria that targets managed nodes using a
|
19276
|
+
# key-value pair that you specify.
|
19259
19277
|
#
|
19260
19278
|
# <note markdown="1"> One or more targets must be specified for maintenance window Run
|
19261
19279
|
# Command-type tasks. Depending on the task, targets are optional for
|
@@ -19268,21 +19286,20 @@ module Aws::SSM
|
|
19268
19286
|
#
|
19269
19287
|
# Supported formats include the following.
|
19270
19288
|
#
|
19271
|
-
# * `Key=InstanceIds,Values
|
19289
|
+
# * `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>,<instance-id-3>`
|
19272
19290
|
#
|
19273
|
-
# * `Key=tag
|
19291
|
+
# * `Key=tag:<my-tag-key>,Values=<my-tag-value-1>,<my-tag-value-2>`
|
19274
19292
|
#
|
19275
|
-
# * `Key=tag-key,Values
|
19293
|
+
# * `Key=tag-key,Values=<my-tag-key-1>,<my-tag-key-2>`
|
19276
19294
|
#
|
19277
19295
|
# * **Run Command and Maintenance window targets only**\:
|
19278
|
-
# `Key=resource-groups:Name,Values
|
19296
|
+
# `Key=resource-groups:Name,Values=<resource-group-name>`
|
19279
19297
|
#
|
19280
19298
|
# * **Maintenance window targets only**\:
|
19281
|
-
# `Key=resource-groups:ResourceTypeFilters,Values
|
19282
|
-
# `
|
19299
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=<resource-type-1>,<resource-type-2>`
|
19283
19300
|
#
|
19284
19301
|
# * **Automation targets only**\:
|
19285
|
-
# `Key=ResourceGroup;Values
|
19302
|
+
# `Key=ResourceGroup;Values=<resource-group-name>`
|
19286
19303
|
#
|
19287
19304
|
# For example:
|
19288
19305
|
#
|
@@ -19300,8 +19317,7 @@ module Aws::SSM
|
|
19300
19317
|
# window.
|
19301
19318
|
#
|
19302
19319
|
# * **Maintenance window targets only**\:
|
19303
|
-
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC
|
19304
|
-
# `
|
19320
|
+
# `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC`
|
19305
19321
|
#
|
19306
19322
|
# This example demonstrates how to target only Amazon Elastic Compute
|
19307
19323
|
# Cloud (Amazon EC2) instances and VPCs in your maintenance window.
|
@@ -19310,14 +19326,14 @@ module Aws::SSM
|
|
19310
19326
|
# `Key=ResourceGroup,Values=MyResourceGroup`
|
19311
19327
|
#
|
19312
19328
|
# * **State Manager association targets only**\:
|
19313
|
-
# `Key=InstanceIds,Values
|
19329
|
+
# `Key=InstanceIds,Values=*`
|
19314
19330
|
#
|
19315
19331
|
# This example demonstrates how to target all managed instances in the
|
19316
19332
|
# Amazon Web Services Region where the association was created.
|
19317
19333
|
#
|
19318
|
-
# For more information about how to send commands that target
|
19319
|
-
# using `Key,Value` parameters, see [Targeting multiple
|
19320
|
-
# 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*.
|
19321
19337
|
#
|
19322
19338
|
#
|
19323
19339
|
#
|
@@ -19333,7 +19349,7 @@ module Aws::SSM
|
|
19333
19349
|
# }
|
19334
19350
|
#
|
19335
19351
|
# @!attribute [rw] key
|
19336
|
-
# User-defined criteria for sending commands that target
|
19352
|
+
# User-defined criteria for sending commands that target managed nodes
|
19337
19353
|
# that meet the criteria.
|
19338
19354
|
# @return [String]
|
19339
19355
|
#
|
@@ -19424,12 +19440,12 @@ module Aws::SSM
|
|
19424
19440
|
include Aws::Structure
|
19425
19441
|
end
|
19426
19442
|
|
19427
|
-
# The specified target
|
19428
|
-
# for use with Session Manager. For more information, see
|
19429
|
-
# started with Session Manager][1] in the *Amazon Web Services
|
19430
|
-
# Manager User Guide*. This error is also returned if you
|
19431
|
-
# start a session on
|
19432
|
-
# 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
|
19433
19449
|
#
|
19434
19450
|
#
|
19435
19451
|
#
|
@@ -19658,9 +19674,9 @@ module Aws::SSM
|
|
19658
19674
|
include Aws::Structure
|
19659
19675
|
end
|
19660
19676
|
|
19661
|
-
# The document doesn't support the platform type of the given
|
19662
|
-
# ID(s). For example, you sent an document for a Windows
|
19663
|
-
# 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.
|
19664
19680
|
#
|
19665
19681
|
# @!attribute [rw] message
|
19666
19682
|
# @return [String]
|
@@ -19743,7 +19759,7 @@ module Aws::SSM
|
|
19743
19759
|
#
|
19744
19760
|
# @!attribute [rw] name
|
19745
19761
|
# The name of the SSM Command document or Automation runbook that
|
19746
|
-
# contains the configuration information for the
|
19762
|
+
# contains the configuration information for the managed node.
|
19747
19763
|
#
|
19748
19764
|
# You can specify Amazon Web Services-predefined documents, documents
|
19749
19765
|
# you created, or a document that is shared with you from another
|
@@ -19794,7 +19810,7 @@ module Aws::SSM
|
|
19794
19810
|
# for example, the system stops sending requests when the fourth error
|
19795
19811
|
# is received. If you specify 0, then the system stops sending
|
19796
19812
|
# requests after the first error is returned. If you run an
|
19797
|
-
# association on 50
|
19813
|
+
# association on 50 managed nodes and set `MaxError` to 10%, then the
|
19798
19814
|
# system stops sending the request when the sixth error is received.
|
19799
19815
|
#
|
19800
19816
|
# Executions that are already running an association when `MaxErrors`
|
@@ -19810,10 +19826,10 @@ module Aws::SSM
|
|
19810
19826
|
# of the target set, for example 10%. The default value is 100%, which
|
19811
19827
|
# means all targets run the association at the same time.
|
19812
19828
|
#
|
19813
|
-
# If a new
|
19814
|
-
# 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
|
19815
19831
|
# association is allowed to run. During the next association interval,
|
19816
|
-
# the new
|
19832
|
+
# the new managed node will process its association within the limit
|
19817
19833
|
# specified for `MaxConcurrency`.
|
19818
19834
|
# @return [String]
|
19819
19835
|
#
|
@@ -19927,7 +19943,7 @@ module Aws::SSM
|
|
19927
19943
|
# @return [String]
|
19928
19944
|
#
|
19929
19945
|
# @!attribute [rw] instance_id
|
19930
|
-
# The
|
19946
|
+
# The managed node ID.
|
19931
19947
|
# @return [String]
|
19932
19948
|
#
|
19933
19949
|
# @!attribute [rw] association_status
|
@@ -20524,8 +20540,8 @@ module Aws::SSM
|
|
20524
20540
|
# @return [String]
|
20525
20541
|
#
|
20526
20542
|
# @!attribute [rw] targets
|
20527
|
-
# The targets (either
|
20528
|
-
# specified using the format
|
20543
|
+
# The targets (either managed nodes or tags) to modify. Managed nodes
|
20544
|
+
# are specified using the format
|
20529
20545
|
# `Key=instanceids,Values=instanceID_1,instanceID_2`. Tags are
|
20530
20546
|
# specified using the format ` Key=tag_name,Values=tag_value`.
|
20531
20547
|
#
|
@@ -20820,7 +20836,7 @@ module Aws::SSM
|
|
20820
20836
|
# }
|
20821
20837
|
#
|
20822
20838
|
# @!attribute [rw] instance_id
|
20823
|
-
# The ID of the managed
|
20839
|
+
# The ID of the managed node where you want to update the role.
|
20824
20840
|
# @return [String]
|
20825
20841
|
#
|
20826
20842
|
# @!attribute [rw] iam_role
|
@@ -21142,8 +21158,8 @@ module Aws::SSM
|
|
21142
21158
|
#
|
21143
21159
|
# @!attribute [rw] approved_patches_enable_non_security
|
21144
21160
|
# Indicates whether the list of approved patches includes non-security
|
21145
|
-
# updates that should be applied to the
|
21146
|
-
# 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.
|
21147
21163
|
# @return [Boolean]
|
21148
21164
|
#
|
21149
21165
|
# @!attribute [rw] rejected_patches
|
@@ -21182,9 +21198,9 @@ module Aws::SSM
|
|
21182
21198
|
# @return [String]
|
21183
21199
|
#
|
21184
21200
|
# @!attribute [rw] sources
|
21185
|
-
# Information about the patches to use to update the
|
21201
|
+
# Information about the patches to use to update the managed nodes,
|
21186
21202
|
# including target operating systems and source repositories. Applies
|
21187
|
-
# to Linux
|
21203
|
+
# to Linux managed nodes only.
|
21188
21204
|
# @return [Array<Types::PatchSource>]
|
21189
21205
|
#
|
21190
21206
|
# @!attribute [rw] replace
|
@@ -21243,8 +21259,8 @@ module Aws::SSM
|
|
21243
21259
|
#
|
21244
21260
|
# @!attribute [rw] approved_patches_enable_non_security
|
21245
21261
|
# Indicates whether the list of approved patches includes non-security
|
21246
|
-
# updates that should be applied to the
|
21247
|
-
# 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.
|
21248
21264
|
# @return [Boolean]
|
21249
21265
|
#
|
21250
21266
|
# @!attribute [rw] rejected_patches
|
@@ -21271,9 +21287,9 @@ module Aws::SSM
|
|
21271
21287
|
# @return [String]
|
21272
21288
|
#
|
21273
21289
|
# @!attribute [rw] sources
|
21274
|
-
# Information about the patches to use to update the
|
21290
|
+
# Information about the patches to use to update the managed nodes,
|
21275
21291
|
# including target operating systems and source repositories. Applies
|
21276
|
-
# to Linux
|
21292
|
+
# to Linux managed nodes only.
|
21277
21293
|
# @return [Array<Types::PatchSource>]
|
21278
21294
|
#
|
21279
21295
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdatePatchBaselineResult AWS API Documentation
|