aws-sdk-ssm 1.103.0 → 1.108.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +628 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-ssm.rb +2 -2
- data/lib/aws-sdk-ssm/client.rb +218 -35
- data/lib/aws-sdk-ssm/client_api.rb +53 -1
- data/lib/aws-sdk-ssm/customizations.rb +1 -1
- data/lib/aws-sdk-ssm/errors.rb +1 -1
- data/lib/aws-sdk-ssm/resource.rb +1 -1
- data/lib/aws-sdk-ssm/types.rb +474 -67
- data/lib/aws-sdk-ssm/waiters.rb +1 -1
- metadata +10 -7
data/LICENSE.txt
ADDED
@@ -0,0 +1,202 @@
|
|
1
|
+
|
2
|
+
Apache License
|
3
|
+
Version 2.0, January 2004
|
4
|
+
http://www.apache.org/licenses/
|
5
|
+
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
7
|
+
|
8
|
+
1. Definitions.
|
9
|
+
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
12
|
+
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
14
|
+
the copyright owner that is granting the License.
|
15
|
+
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
17
|
+
other entities that control, are controlled by, or are under common
|
18
|
+
control with that entity. For the purposes of this definition,
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
20
|
+
direction or management of such entity, whether by contract or
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
23
|
+
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
25
|
+
exercising permissions granted by this License.
|
26
|
+
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
28
|
+
including but not limited to software source code, documentation
|
29
|
+
source, and configuration files.
|
30
|
+
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
32
|
+
transformation or translation of a Source form, including but
|
33
|
+
not limited to compiled object code, generated documentation,
|
34
|
+
and conversions to other media types.
|
35
|
+
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
37
|
+
Object form, made available under the License, as indicated by a
|
38
|
+
copyright notice that is included in or attached to the work
|
39
|
+
(an example is provided in the Appendix below).
|
40
|
+
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
47
|
+
the Work and Derivative Works thereof.
|
48
|
+
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
50
|
+
the original version of the Work and any modifications or additions
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
62
|
+
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
65
|
+
subsequently incorporated within the Work.
|
66
|
+
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
73
|
+
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
79
|
+
where such license applies only to those patent claims licensable
|
80
|
+
by such Contributor that are necessarily infringed by their
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
83
|
+
institute patent litigation against any entity (including a
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
86
|
+
or contributory patent infringement, then any patent licenses
|
87
|
+
granted to You under this License for that Work shall terminate
|
88
|
+
as of the date such litigation is filed.
|
89
|
+
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
92
|
+
modifications, and in Source or Object form, provided that You
|
93
|
+
meet the following conditions:
|
94
|
+
|
95
|
+
(a) You must give any other recipients of the Work or
|
96
|
+
Derivative Works a copy of this License; and
|
97
|
+
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
99
|
+
stating that You changed the files; and
|
100
|
+
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
103
|
+
attribution notices from the Source form of the Work,
|
104
|
+
excluding those notices that do not pertain to any part of
|
105
|
+
the Derivative Works; and
|
106
|
+
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
109
|
+
include a readable copy of the attribution notices contained
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
112
|
+
of the following places: within a NOTICE text file distributed
|
113
|
+
as part of the Derivative Works; within the Source form or
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
115
|
+
within a display generated by the Derivative Works, if and
|
116
|
+
wherever such third-party notices normally appear. The contents
|
117
|
+
of the NOTICE file are for informational purposes only and
|
118
|
+
do not modify the License. You may add Your own attribution
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
121
|
+
that such additional attribution notices cannot be construed
|
122
|
+
as modifying the License.
|
123
|
+
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
125
|
+
may provide additional or different license terms and conditions
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
129
|
+
the conditions stated in this License.
|
130
|
+
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
134
|
+
this License, without any additional terms or conditions.
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
136
|
+
the terms of any separate license agreement you may have executed
|
137
|
+
with Licensor regarding such Contributions.
|
138
|
+
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
141
|
+
except as required for reasonable and customary use in describing the
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
143
|
+
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
153
|
+
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
159
|
+
incidental, or consequential damages of any character arising as a
|
160
|
+
result of this License or out of the use or inability to use the
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
163
|
+
other commercial damages or losses), even if such Contributor
|
164
|
+
has been advised of the possibility of such damages.
|
165
|
+
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
169
|
+
or other liability obligations and/or rights consistent with this
|
170
|
+
License. However, in accepting such obligations, You may act only
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
175
|
+
of your accepting any such warranty or additional liability.
|
176
|
+
|
177
|
+
END OF TERMS AND CONDITIONS
|
178
|
+
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
180
|
+
|
181
|
+
To apply the Apache License to your work, attach the following
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
183
|
+
replaced with your own identifying information. (Don't include
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
185
|
+
comment syntax for the file format. We also recommend that a
|
186
|
+
file or class name and description of purpose be included on the
|
187
|
+
same "printed page" as the copyright notice for easier
|
188
|
+
identification within third-party archives.
|
189
|
+
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
191
|
+
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
193
|
+
you may not use this file except in compliance with the License.
|
194
|
+
You may obtain a copy of the License at
|
195
|
+
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
197
|
+
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
201
|
+
See the License for the specific language governing permissions and
|
202
|
+
limitations under the License.
|
data/VERSION
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
1.108.0
|
data/lib/aws-sdk-ssm.rb
CHANGED
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ssm/customizations'
|
|
49
49
|
# @!group service
|
50
50
|
module Aws::SSM
|
51
51
|
|
52
|
-
GEM_VERSION = '1.
|
52
|
+
GEM_VERSION = '1.108.0'
|
53
53
|
|
54
54
|
end
|
data/lib/aws-sdk-ssm/client.rb
CHANGED
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -383,6 +383,14 @@ module Aws::SSM
|
|
383
383
|
#
|
384
384
|
# PatchBaseline: pb-012345abcde
|
385
385
|
#
|
386
|
+
# OpsMetadata object: `ResourceID` for tagging is created from the
|
387
|
+
# Amazon Resource Name (ARN) for the object. Specifically, `ResourceID`
|
388
|
+
# is created from the strings that come after the word `opsmetadata` in
|
389
|
+
# the ARN. For example, an OpsMetadata object with an ARN of
|
390
|
+
# `arn:aws:ssm:us-east-2:1234567890:opsmetadata/aws/ssm/MyGroup/appmanager`
|
391
|
+
# has a `ResourceID` of either `aws/ssm/MyGroup/appmanager` or
|
392
|
+
# `/aws/ssm/MyGroup/appmanager`.
|
393
|
+
#
|
386
394
|
# For the Document and Parameter values, use the name of the resource.
|
387
395
|
#
|
388
396
|
# <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
|
@@ -392,9 +400,7 @@ module Aws::SSM
|
|
392
400
|
# </note>
|
393
401
|
#
|
394
402
|
# @option params [required, Array<Types::Tag>] :tags
|
395
|
-
# One or more tags. The value parameter is required
|
396
|
-
# want the tag to have a value, specify the parameter with no value, and
|
397
|
-
# we set the value to an empty string.
|
403
|
+
# One or more tags. The value parameter is required.
|
398
404
|
#
|
399
405
|
# Do not enter personally identifiable information in this field.
|
400
406
|
#
|
@@ -403,7 +409,7 @@ module Aws::SSM
|
|
403
409
|
# @example Request syntax with placeholder values
|
404
410
|
#
|
405
411
|
# resp = client.add_tags_to_resource({
|
406
|
-
# resource_type: "Document", # required, accepts Document, ManagedInstance, MaintenanceWindow, Parameter, PatchBaseline, OpsItem
|
412
|
+
# resource_type: "Document", # required, accepts Document, ManagedInstance, MaintenanceWindow, Parameter, PatchBaseline, OpsItem, OpsMetadata
|
407
413
|
# resource_id: "ResourceId", # required
|
408
414
|
# tags: [ # required
|
409
415
|
# {
|
@@ -532,8 +538,10 @@ module Aws::SSM
|
|
532
538
|
# The default value is 1 instance.
|
533
539
|
#
|
534
540
|
# @option params [Time,DateTime,Date,Integer,String] :expiration_date
|
535
|
-
# The date by which this activation request should expire
|
536
|
-
#
|
541
|
+
# The date by which this activation request should expire, in timestamp
|
542
|
+
# format, such as "2021-07-07T00:00:00". You can specify a date up to
|
543
|
+
# 30 days in advance. If you don't provide an expiration date, the
|
544
|
+
# activation code expires in 24 hours.
|
537
545
|
#
|
538
546
|
# @option params [Array<Types::Tag>] :tags
|
539
547
|
# Optional metadata that you assign to a resource. Tags enable you to
|
@@ -1499,6 +1507,18 @@ module Aws::SSM
|
|
1499
1507
|
# @option params [Hash<String,Types::MetadataValue>] :metadata
|
1500
1508
|
# Metadata for a new Application Manager application.
|
1501
1509
|
#
|
1510
|
+
# @option params [Array<Types::Tag>] :tags
|
1511
|
+
# Optional metadata that you assign to a resource. You can specify a
|
1512
|
+
# maximum of five tags for an OpsMetadata object. Tags enable you to
|
1513
|
+
# categorize a resource in different ways, such as by purpose, owner, or
|
1514
|
+
# environment. For example, you might want to tag an OpsMetadata object
|
1515
|
+
# to identify an environment or target AWS Region. In this case, you
|
1516
|
+
# could specify the following key-value pairs:
|
1517
|
+
#
|
1518
|
+
# * `Key=Environment,Value=Production`
|
1519
|
+
#
|
1520
|
+
# * `Key=Region,Value=us-east-2`
|
1521
|
+
#
|
1502
1522
|
# @return [Types::CreateOpsMetadataResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1503
1523
|
#
|
1504
1524
|
# * {Types::CreateOpsMetadataResult#ops_metadata_arn #ops_metadata_arn} => String
|
@@ -1512,6 +1532,12 @@ module Aws::SSM
|
|
1512
1532
|
# value: "MetadataValueString",
|
1513
1533
|
# },
|
1514
1534
|
# },
|
1535
|
+
# tags: [
|
1536
|
+
# {
|
1537
|
+
# key: "TagKey", # required
|
1538
|
+
# value: "TagValue", # required
|
1539
|
+
# },
|
1540
|
+
# ],
|
1515
1541
|
# })
|
1516
1542
|
#
|
1517
1543
|
# @example Response structure
|
@@ -1563,8 +1589,8 @@ module Aws::SSM
|
|
1563
1589
|
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/patch-manager-approved-rejected-package-name-formats.html
|
1564
1590
|
#
|
1565
1591
|
# @option params [String] :approved_patches_compliance_level
|
1566
|
-
# Defines the compliance level for approved patches.
|
1567
|
-
#
|
1592
|
+
# Defines the compliance level for approved patches. When an approved
|
1593
|
+
# patch is reported as missing, this value describes the severity of the
|
1568
1594
|
# compliance violation. The default value is UNSPECIFIED.
|
1569
1595
|
#
|
1570
1596
|
# @option params [Boolean] :approved_patches_enable_non_security
|
@@ -1786,6 +1812,7 @@ module Aws::SSM
|
|
1786
1812
|
# },
|
1787
1813
|
# source_regions: ["ResourceDataSyncSourceRegion"], # required
|
1788
1814
|
# include_future_regions: false,
|
1815
|
+
# enable_all_ops_data_sources: false,
|
1789
1816
|
# },
|
1790
1817
|
# })
|
1791
1818
|
#
|
@@ -2700,7 +2727,7 @@ module Aws::SSM
|
|
2700
2727
|
#
|
2701
2728
|
# @option params [Boolean] :reverse_order
|
2702
2729
|
# A boolean that indicates whether to list step executions in reverse
|
2703
|
-
# order by start time. The default value is false.
|
2730
|
+
# order by start time. The default value is 'false'.
|
2704
2731
|
#
|
2705
2732
|
# @return [Types::DescribeAutomationStepExecutionsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2706
2733
|
#
|
@@ -3309,6 +3336,9 @@ module Aws::SSM
|
|
3309
3336
|
# resp.instance_patch_states[0].operation #=> String, one of "Scan", "Install"
|
3310
3337
|
# resp.instance_patch_states[0].last_no_reboot_install_operation_time #=> Time
|
3311
3338
|
# resp.instance_patch_states[0].reboot_option #=> String, one of "RebootIfNeeded", "NoReboot"
|
3339
|
+
# resp.instance_patch_states[0].critical_non_compliant_count #=> Integer
|
3340
|
+
# resp.instance_patch_states[0].security_non_compliant_count #=> Integer
|
3341
|
+
# resp.instance_patch_states[0].other_non_compliant_count #=> Integer
|
3312
3342
|
# resp.next_token #=> String
|
3313
3343
|
#
|
3314
3344
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstancePatchStates AWS API Documentation
|
@@ -3387,6 +3417,9 @@ module Aws::SSM
|
|
3387
3417
|
# resp.instance_patch_states[0].operation #=> String, one of "Scan", "Install"
|
3388
3418
|
# resp.instance_patch_states[0].last_no_reboot_install_operation_time #=> Time
|
3389
3419
|
# resp.instance_patch_states[0].reboot_option #=> String, one of "RebootIfNeeded", "NoReboot"
|
3420
|
+
# resp.instance_patch_states[0].critical_non_compliant_count #=> Integer
|
3421
|
+
# resp.instance_patch_states[0].security_non_compliant_count #=> Integer
|
3422
|
+
# resp.instance_patch_states[0].other_non_compliant_count #=> Integer
|
3390
3423
|
# resp.next_token #=> String
|
3391
3424
|
#
|
3392
3425
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstancePatchStatesForPatchGroup AWS API Documentation
|
@@ -4350,6 +4383,9 @@ module Aws::SSM
|
|
4350
4383
|
# * {Types::DescribePatchGroupStateResult#instances_with_failed_patches #instances_with_failed_patches} => Integer
|
4351
4384
|
# * {Types::DescribePatchGroupStateResult#instances_with_not_applicable_patches #instances_with_not_applicable_patches} => Integer
|
4352
4385
|
# * {Types::DescribePatchGroupStateResult#instances_with_unreported_not_applicable_patches #instances_with_unreported_not_applicable_patches} => Integer
|
4386
|
+
# * {Types::DescribePatchGroupStateResult#instances_with_critical_non_compliant_patches #instances_with_critical_non_compliant_patches} => Integer
|
4387
|
+
# * {Types::DescribePatchGroupStateResult#instances_with_security_non_compliant_patches #instances_with_security_non_compliant_patches} => Integer
|
4388
|
+
# * {Types::DescribePatchGroupStateResult#instances_with_other_non_compliant_patches #instances_with_other_non_compliant_patches} => Integer
|
4353
4389
|
#
|
4354
4390
|
# @example Request syntax with placeholder values
|
4355
4391
|
#
|
@@ -4368,6 +4404,9 @@ module Aws::SSM
|
|
4368
4404
|
# resp.instances_with_failed_patches #=> Integer
|
4369
4405
|
# resp.instances_with_not_applicable_patches #=> Integer
|
4370
4406
|
# resp.instances_with_unreported_not_applicable_patches #=> Integer
|
4407
|
+
# resp.instances_with_critical_non_compliant_patches #=> Integer
|
4408
|
+
# resp.instances_with_security_non_compliant_patches #=> Integer
|
4409
|
+
# resp.instances_with_other_non_compliant_patches #=> Integer
|
4371
4410
|
#
|
4372
4411
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribePatchGroupState AWS API Documentation
|
4373
4412
|
#
|
@@ -4825,21 +4864,34 @@ module Aws::SSM
|
|
4825
4864
|
# Returns detailed information about command execution for an invocation
|
4826
4865
|
# or plugin.
|
4827
4866
|
#
|
4867
|
+
# `GetCommandInvocation` only gives the execution status of a plugin in
|
4868
|
+
# a document. To get the command execution status on a specific
|
4869
|
+
# instance, use ListCommandInvocations. To get the command execution
|
4870
|
+
# status across instances, use ListCommands.
|
4871
|
+
#
|
4828
4872
|
# @option params [required, String] :command_id
|
4829
4873
|
# (Required) The parent command ID of the invocation plugin.
|
4830
4874
|
#
|
4831
4875
|
# @option params [required, String] :instance_id
|
4832
4876
|
# (Required) The ID of the managed instance targeted by the command. A
|
4833
|
-
# managed instance can be an
|
4834
|
-
# environment that is configured
|
4877
|
+
# managed instance can be an Amazon Elastic Compute Cloud (Amazon EC2)
|
4878
|
+
# instance or an instance in your hybrid environment that is configured
|
4879
|
+
# for AWS Systems Manager.
|
4835
4880
|
#
|
4836
4881
|
# @option params [String] :plugin_name
|
4837
|
-
#
|
4838
|
-
#
|
4839
|
-
# the
|
4882
|
+
# The name of the plugin for which you want detailed results. If the
|
4883
|
+
# document contains only one plugin, you can omit the name and details
|
4884
|
+
# for that plugin. If the document contains more than one plugin, you
|
4885
|
+
# must specify the name of the plugin for which you want to view
|
4886
|
+
# details.
|
4840
4887
|
#
|
4841
|
-
# Plugin names are also referred to as step names in Systems Manager
|
4842
|
-
# documents.
|
4888
|
+
# Plugin names are also referred to as *step names* in Systems Manager
|
4889
|
+
# documents. For example, `aws:RunShellScript` is a plugin.
|
4890
|
+
#
|
4891
|
+
# To find the `PluginName`, check the document content and find the name
|
4892
|
+
# of the plugin. Alternatively, use ListCommandInvocations with the
|
4893
|
+
# `CommandId` and `Details` parameters. The `PluginName` is the `Name`
|
4894
|
+
# attribute of the `CommandPlugin` object in the `CommandPlugins` list.
|
4843
4895
|
#
|
4844
4896
|
# @return [Types::GetCommandInvocationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4845
4897
|
#
|
@@ -4982,6 +5034,9 @@ module Aws::SSM
|
|
4982
5034
|
# @option params [required, String] :snapshot_id
|
4983
5035
|
# The user-defined snapshot ID.
|
4984
5036
|
#
|
5037
|
+
# @option params [Types::BaselineOverride] :baseline_override
|
5038
|
+
# Defines the basic information about a patch baseline override.
|
5039
|
+
#
|
4985
5040
|
# @return [Types::GetDeployablePatchSnapshotForInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4986
5041
|
#
|
4987
5042
|
# * {Types::GetDeployablePatchSnapshotForInstanceResult#instance_id #instance_id} => String
|
@@ -4994,6 +5049,47 @@ module Aws::SSM
|
|
4994
5049
|
# resp = client.get_deployable_patch_snapshot_for_instance({
|
4995
5050
|
# instance_id: "InstanceId", # required
|
4996
5051
|
# snapshot_id: "SnapshotId", # required
|
5052
|
+
# baseline_override: {
|
5053
|
+
# operating_system: "WINDOWS", # accepts WINDOWS, AMAZON_LINUX, AMAZON_LINUX_2, UBUNTU, REDHAT_ENTERPRISE_LINUX, SUSE, CENTOS, ORACLE_LINUX, DEBIAN, MACOS
|
5054
|
+
# global_filters: {
|
5055
|
+
# patch_filters: [ # required
|
5056
|
+
# {
|
5057
|
+
# key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
|
5058
|
+
# values: ["PatchFilterValue"], # required
|
5059
|
+
# },
|
5060
|
+
# ],
|
5061
|
+
# },
|
5062
|
+
# approval_rules: {
|
5063
|
+
# patch_rules: [ # required
|
5064
|
+
# {
|
5065
|
+
# patch_filter_group: { # required
|
5066
|
+
# patch_filters: [ # required
|
5067
|
+
# {
|
5068
|
+
# key: "ARCH", # required, accepts ARCH, ADVISORY_ID, BUGZILLA_ID, PATCH_SET, PRODUCT, PRODUCT_FAMILY, CLASSIFICATION, CVE_ID, EPOCH, MSRC_SEVERITY, NAME, PATCH_ID, SECTION, PRIORITY, REPOSITORY, RELEASE, SEVERITY, SECURITY, VERSION
|
5069
|
+
# values: ["PatchFilterValue"], # required
|
5070
|
+
# },
|
5071
|
+
# ],
|
5072
|
+
# },
|
5073
|
+
# compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
|
5074
|
+
# approve_after_days: 1,
|
5075
|
+
# approve_until_date: "PatchStringDateTime",
|
5076
|
+
# enable_non_security: false,
|
5077
|
+
# },
|
5078
|
+
# ],
|
5079
|
+
# },
|
5080
|
+
# approved_patches: ["PatchId"],
|
5081
|
+
# approved_patches_compliance_level: "CRITICAL", # accepts CRITICAL, HIGH, MEDIUM, LOW, INFORMATIONAL, UNSPECIFIED
|
5082
|
+
# rejected_patches: ["PatchId"],
|
5083
|
+
# rejected_patches_action: "ALLOW_AS_DEPENDENCY", # accepts ALLOW_AS_DEPENDENCY, BLOCK
|
5084
|
+
# approved_patches_enable_non_security: false,
|
5085
|
+
# sources: [
|
5086
|
+
# {
|
5087
|
+
# name: "PatchSourceName", # required
|
5088
|
+
# products: ["PatchSourceProduct"], # required
|
5089
|
+
# configuration: "PatchSourceConfiguration", # required
|
5090
|
+
# },
|
5091
|
+
# ],
|
5092
|
+
# },
|
4997
5093
|
# })
|
4998
5094
|
#
|
4999
5095
|
# @example Response structure
|
@@ -6142,6 +6238,8 @@ module Aws::SSM
|
|
6142
6238
|
#
|
6143
6239
|
# @option params [required, String] :setting_id
|
6144
6240
|
# The ID of the service setting to get. The setting ID can be
|
6241
|
+
# `/ssm/automation/customer-script-log-destination`,
|
6242
|
+
# `/ssm/automation/customer-script-log-group-name`,
|
6145
6243
|
# `/ssm/parameter-store/default-parameter-tier`,
|
6146
6244
|
# `/ssm/parameter-store/high-throughput-enabled`, or
|
6147
6245
|
# `/ssm/managed-instance/activation-tier`.
|
@@ -6193,9 +6291,8 @@ module Aws::SSM
|
|
6193
6291
|
# * You can't create a label when you create a new parameter. You must
|
6194
6292
|
# attach a label to a specific version of a parameter.
|
6195
6293
|
#
|
6196
|
-
# *
|
6197
|
-
#
|
6198
|
-
# parameter.
|
6294
|
+
# * If you no longer want to use a parameter label, then you can either
|
6295
|
+
# delete it or move it to a different version of a parameter.
|
6199
6296
|
#
|
6200
6297
|
# * A label can have a maximum of 100 characters.
|
6201
6298
|
#
|
@@ -6422,7 +6519,7 @@ module Aws::SSM
|
|
6422
6519
|
#
|
6423
6520
|
# @option params [Boolean] :details
|
6424
6521
|
# (Optional) If set this returns the response of the command executions
|
6425
|
-
# and any command output.
|
6522
|
+
# and any command output. The default value is 'false'.
|
6426
6523
|
#
|
6427
6524
|
# @return [Types::ListCommandInvocationsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6428
6525
|
#
|
@@ -7249,6 +7346,7 @@ module Aws::SSM
|
|
7249
7346
|
# resp.resource_data_sync_items[0].sync_source.source_regions[0] #=> String
|
7250
7347
|
# resp.resource_data_sync_items[0].sync_source.include_future_regions #=> Boolean
|
7251
7348
|
# resp.resource_data_sync_items[0].sync_source.state #=> String
|
7349
|
+
# resp.resource_data_sync_items[0].sync_source.enable_all_ops_data_sources #=> Boolean
|
7252
7350
|
# resp.resource_data_sync_items[0].s3_destination.bucket_name #=> String
|
7253
7351
|
# resp.resource_data_sync_items[0].s3_destination.prefix #=> String
|
7254
7352
|
# resp.resource_data_sync_items[0].s3_destination.sync_format #=> String, one of "JsonSerDe"
|
@@ -7287,7 +7385,7 @@ module Aws::SSM
|
|
7287
7385
|
# @example Request syntax with placeholder values
|
7288
7386
|
#
|
7289
7387
|
# resp = client.list_tags_for_resource({
|
7290
|
-
# resource_type: "Document", # required, accepts Document, ManagedInstance, MaintenanceWindow, Parameter, PatchBaseline, OpsItem
|
7388
|
+
# resource_type: "Document", # required, accepts Document, ManagedInstance, MaintenanceWindow, Parameter, PatchBaseline, OpsItem, OpsMetadata
|
7291
7389
|
# resource_id: "ResourceId", # required
|
7292
7390
|
# })
|
7293
7391
|
#
|
@@ -7548,7 +7646,11 @@ module Aws::SSM
|
|
7548
7646
|
# (case-insensitive).
|
7549
7647
|
#
|
7550
7648
|
# * Parameter names can include only the following symbols and letters:
|
7551
|
-
# `a-zA-Z0-9_
|
7649
|
+
# `a-zA-Z0-9_.-`
|
7650
|
+
#
|
7651
|
+
# In addition, the slash character ( / ) is used to delineate
|
7652
|
+
# hierarchies in parameter names. For example:
|
7653
|
+
# `/Dev/Production/East/Project-ABC/MyParameter`
|
7552
7654
|
#
|
7553
7655
|
# * A parameter name can't include spaces.
|
7554
7656
|
#
|
@@ -7556,8 +7658,8 @@ module Aws::SSM
|
|
7556
7658
|
# levels.
|
7557
7659
|
#
|
7558
7660
|
# For additional information about valid values for parameter names, see
|
7559
|
-
# [
|
7560
|
-
#
|
7661
|
+
# [Creating Systems Manager parameters][1] in the *AWS Systems Manager
|
7662
|
+
# User Guide*.
|
7561
7663
|
#
|
7562
7664
|
# <note markdown="1"> The maximum length constraint listed below includes capacity for
|
7563
7665
|
# additional system attributes that are not part of the name. The
|
@@ -7571,7 +7673,7 @@ module Aws::SSM
|
|
7571
7673
|
#
|
7572
7674
|
#
|
7573
7675
|
#
|
7574
|
-
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-
|
7676
|
+
# [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html
|
7575
7677
|
#
|
7576
7678
|
# @option params [String] :description
|
7577
7679
|
# Information about the parameter that you want to add to the system.
|
@@ -7624,8 +7726,7 @@ module Aws::SSM
|
|
7624
7726
|
# the `Key ID` parameter.
|
7625
7727
|
#
|
7626
7728
|
# @option params [Boolean] :overwrite
|
7627
|
-
# Overwrite an existing parameter.
|
7628
|
-
# "false".
|
7729
|
+
# Overwrite an existing parameter. The default value is 'false'.
|
7629
7730
|
#
|
7630
7731
|
# @option params [String] :allowed_pattern
|
7631
7732
|
# A regular expression used to validate the parameter value. For
|
@@ -7899,6 +8000,14 @@ module Aws::SSM
|
|
7899
8000
|
# The targets to register with the maintenance window. In other words,
|
7900
8001
|
# the instances to run commands on when the maintenance window runs.
|
7901
8002
|
#
|
8003
|
+
# <note markdown="1"> If a single maintenance window task is registered with multiple
|
8004
|
+
# targets, its task invocations occur sequentially and not in parallel.
|
8005
|
+
# If your task must run on multiple targets at the same time, register a
|
8006
|
+
# task for each target individually and assign each task the same
|
8007
|
+
# priority level.
|
8008
|
+
#
|
8009
|
+
# </note>
|
8010
|
+
#
|
7902
8011
|
# You can specify targets using instance IDs, resource group names, or
|
7903
8012
|
# tags that have been applied to instances.
|
7904
8013
|
#
|
@@ -8221,6 +8330,14 @@ module Aws::SSM
|
|
8221
8330
|
#
|
8222
8331
|
# PatchBaseline: pb-012345abcde
|
8223
8332
|
#
|
8333
|
+
# OpsMetadata object: `ResourceID` for tagging is created from the
|
8334
|
+
# Amazon Resource Name (ARN) for the object. Specifically, `ResourceID`
|
8335
|
+
# is created from the strings that come after the word `opsmetadata` in
|
8336
|
+
# the ARN. For example, an OpsMetadata object with an ARN of
|
8337
|
+
# `arn:aws:ssm:us-east-2:1234567890:opsmetadata/aws/ssm/MyGroup/appmanager`
|
8338
|
+
# has a `ResourceID` of either `aws/ssm/MyGroup/appmanager` or
|
8339
|
+
# `/aws/ssm/MyGroup/appmanager`.
|
8340
|
+
#
|
8224
8341
|
# For the Document and Parameter values, use the name of the resource.
|
8225
8342
|
#
|
8226
8343
|
# <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
|
@@ -8237,7 +8354,7 @@ module Aws::SSM
|
|
8237
8354
|
# @example Request syntax with placeholder values
|
8238
8355
|
#
|
8239
8356
|
# resp = client.remove_tags_from_resource({
|
8240
|
-
# resource_type: "Document", # required, accepts Document, ManagedInstance, MaintenanceWindow, Parameter, PatchBaseline, OpsItem
|
8357
|
+
# resource_type: "Document", # required, accepts Document, ManagedInstance, MaintenanceWindow, Parameter, PatchBaseline, OpsItem, OpsMetadata
|
8241
8358
|
# resource_id: "ResourceId", # required
|
8242
8359
|
# tag_keys: ["TagKey"], # required
|
8243
8360
|
# })
|
@@ -8271,7 +8388,9 @@ module Aws::SSM
|
|
8271
8388
|
#
|
8272
8389
|
# @option params [required, String] :setting_id
|
8273
8390
|
# The Amazon Resource Name (ARN) of the service setting to reset. The
|
8274
|
-
# setting ID can be `/ssm/
|
8391
|
+
# setting ID can be `/ssm/automation/customer-script-log-destination`,
|
8392
|
+
# `/ssm/automation/customer-script-log-group-name`,
|
8393
|
+
# `/ssm/parameter-store/default-parameter-tier`,
|
8275
8394
|
# `/ssm/parameter-store/high-throughput-enabled`, or
|
8276
8395
|
# `/ssm/managed-instance/activation-tier`. For example,
|
8277
8396
|
# `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
|
@@ -8847,6 +8966,16 @@ module Aws::SSM
|
|
8847
8966
|
#
|
8848
8967
|
# * `Key=Region,Value=us-east-2`
|
8849
8968
|
#
|
8969
|
+
# @option params [Time,DateTime,Date,Integer,String] :scheduled_end_time
|
8970
|
+
# The time that the requester expects the runbook workflow related to
|
8971
|
+
# the change request to complete. The time is an estimate only that the
|
8972
|
+
# requester provides for reviewers.
|
8973
|
+
#
|
8974
|
+
# @option params [String] :change_details
|
8975
|
+
# User-provided details about the change. If no details are provided,
|
8976
|
+
# content specified in the **Template information** section of the
|
8977
|
+
# associated change template is added.
|
8978
|
+
#
|
8850
8979
|
# @return [Types::StartChangeRequestExecutionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8851
8980
|
#
|
8852
8981
|
# * {Types::StartChangeRequestExecutionResult#automation_execution_id #automation_execution_id} => String
|
@@ -8895,6 +9024,8 @@ module Aws::SSM
|
|
8895
9024
|
# value: "TagValue", # required
|
8896
9025
|
# },
|
8897
9026
|
# ],
|
9027
|
+
# scheduled_end_time: Time.now,
|
9028
|
+
# change_details: "ChangeDetailsValue",
|
8898
9029
|
# })
|
8899
9030
|
#
|
8900
9031
|
# @example Response structure
|
@@ -9029,6 +9160,47 @@ module Aws::SSM
|
|
9029
9160
|
req.send_request(options)
|
9030
9161
|
end
|
9031
9162
|
|
9163
|
+
# Remove a label or labels from a parameter.
|
9164
|
+
#
|
9165
|
+
# @option params [required, String] :name
|
9166
|
+
# The parameter name of which you want to delete one or more labels.
|
9167
|
+
#
|
9168
|
+
# @option params [required, Integer] :parameter_version
|
9169
|
+
# The specific version of the parameter which you want to delete one or
|
9170
|
+
# more labels from. If it is not present, the call will fail.
|
9171
|
+
#
|
9172
|
+
# @option params [required, Array<String>] :labels
|
9173
|
+
# One or more labels to delete from the specified parameter version.
|
9174
|
+
#
|
9175
|
+
# @return [Types::UnlabelParameterVersionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
9176
|
+
#
|
9177
|
+
# * {Types::UnlabelParameterVersionResult#removed_labels #removed_labels} => Array<String>
|
9178
|
+
# * {Types::UnlabelParameterVersionResult#invalid_labels #invalid_labels} => Array<String>
|
9179
|
+
#
|
9180
|
+
# @example Request syntax with placeholder values
|
9181
|
+
#
|
9182
|
+
# resp = client.unlabel_parameter_version({
|
9183
|
+
# name: "PSParameterName", # required
|
9184
|
+
# parameter_version: 1, # required
|
9185
|
+
# labels: ["ParameterLabel"], # required
|
9186
|
+
# })
|
9187
|
+
#
|
9188
|
+
# @example Response structure
|
9189
|
+
#
|
9190
|
+
# resp.removed_labels #=> Array
|
9191
|
+
# resp.removed_labels[0] #=> String
|
9192
|
+
# resp.invalid_labels #=> Array
|
9193
|
+
# resp.invalid_labels[0] #=> String
|
9194
|
+
#
|
9195
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UnlabelParameterVersion AWS API Documentation
|
9196
|
+
#
|
9197
|
+
# @overload unlabel_parameter_version(params = {})
|
9198
|
+
# @param [Hash] params ({})
|
9199
|
+
def unlabel_parameter_version(params = {}, options = {})
|
9200
|
+
req = build_request(:unlabel_parameter_version, params)
|
9201
|
+
req.send_request(options)
|
9202
|
+
end
|
9203
|
+
|
9032
9204
|
# Updates an association. You can update the association name and
|
9033
9205
|
# version, the document version, schedule, parameters, and Amazon S3
|
9034
9206
|
# output.
|
@@ -9371,10 +9543,10 @@ module Aws::SSM
|
|
9371
9543
|
# changed.
|
9372
9544
|
#
|
9373
9545
|
# @option params [String] :document_version
|
9374
|
-
#
|
9375
|
-
#
|
9376
|
-
#
|
9377
|
-
#
|
9546
|
+
# The version of the document that you want to update. Currently,
|
9547
|
+
# Systems Manager supports updating only the latest version of the
|
9548
|
+
# document. You can specify the version number of the latest version or
|
9549
|
+
# use the `$LATEST` variable.
|
9378
9550
|
#
|
9379
9551
|
# @option params [String] :document_format
|
9380
9552
|
# Specify the document format for the new document version. Systems
|
@@ -10540,6 +10712,7 @@ module Aws::SSM
|
|
10540
10712
|
# },
|
10541
10713
|
# source_regions: ["ResourceDataSyncSourceRegion"], # required
|
10542
10714
|
# include_future_regions: false,
|
10715
|
+
# enable_all_ops_data_sources: false,
|
10543
10716
|
# },
|
10544
10717
|
# })
|
10545
10718
|
#
|
@@ -10576,6 +10749,10 @@ module Aws::SSM
|
|
10576
10749
|
# `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
|
10577
10750
|
# The setting ID can be one of the following.
|
10578
10751
|
#
|
10752
|
+
# * `/ssm/automation/customer-script-log-destination`
|
10753
|
+
#
|
10754
|
+
# * `/ssm/automation/customer-script-log-group-name`
|
10755
|
+
#
|
10579
10756
|
# * `/ssm/parameter-store/default-parameter-tier`
|
10580
10757
|
#
|
10581
10758
|
# * `/ssm/parameter-store/high-throughput-enabled`
|
@@ -10597,6 +10774,12 @@ module Aws::SSM
|
|
10597
10774
|
# `/ssm/managed-instance/activation-tier` setting IDs, the setting value
|
10598
10775
|
# can be true or false.
|
10599
10776
|
#
|
10777
|
+
# For the `/ssm/automation/customer-script-log-destination` setting ID,
|
10778
|
+
# the setting value can be CloudWatch.
|
10779
|
+
#
|
10780
|
+
# For the `/ssm/automation/customer-script-log-group-name` setting ID,
|
10781
|
+
# the setting value can be the name of a CloudWatch Logs log group.
|
10782
|
+
#
|
10600
10783
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
10601
10784
|
#
|
10602
10785
|
# @example Request syntax with placeholder values
|
@@ -10628,7 +10811,7 @@ module Aws::SSM
|
|
10628
10811
|
params: params,
|
10629
10812
|
config: config)
|
10630
10813
|
context[:gem_name] = 'aws-sdk-ssm'
|
10631
|
-
context[:gem_version] = '1.
|
10814
|
+
context[:gem_version] = '1.108.0'
|
10632
10815
|
Seahorse::Client::Request.new(handlers, context)
|
10633
10816
|
end
|
10634
10817
|
|