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