aws-sdk-ssm 1.124.0 → 1.125.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +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
|