aws-sdk-ssm 1.165.0 → 1.167.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 379229f09f8ced43ffcf26ddee43e686118db4c24fc8dfe9d6e9206552de5d29
4
- data.tar.gz: a07230ecc936c60d30858bba100a8c5002c423db3cf7b74f83938cd20b168124
3
+ metadata.gz: 8591c1fd66cbb4f99c5842c5de472f42dca18d962c1159683ae8ced61ed04aa0
4
+ data.tar.gz: 404cfa75c2fa9451c1536dbc026445d13e91f023622d3742ee89c049059c44d8
5
5
  SHA512:
6
- metadata.gz: 8f98f45763b1be34d0b4692ade07ceced01ec8761457342c06f3ae6c7d98fb7e10d16d38ff3cabd13bcfafd9c2d8de7bb4e3ac3af23c25fbea7350ec3729fa43
7
- data.tar.gz: 504d6371ee1a8a8c7e6089fb3e421b2cfaa5932cfb4384a6b8b5ce636e754e15e5bbb04cc98e385750e240087a6cc503c8e0b82e7c100c7a50633faf0267db02
6
+ metadata.gz: 5f4a565d4c57a5dfdb1c3ca999756b8ce7c3437f1a007fa5ed455acfa9385de813cad42131be7abb096d7b1efbfdf0220a08db7fb10daeff4b8ddc973692ec20
7
+ data.tar.gz: 8497d017148afd4a800ba181988b0ea4d20e663c4fc2a9718b228f5a373f9b8cb015ed6b1031ba8bce26a8941810e682c7a795d3dd24597e9a91733fd7c7fb4b
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.167.0 (2024-04-24)
5
+ ------------------
6
+
7
+ * Feature - Add SSM DescribeInstanceProperties API to public AWS SDK.
8
+
9
+ 1.166.0 (2024-03-12)
10
+ ------------------
11
+
12
+ * Feature - March 2024 doc-only updates for Systems Manager.
13
+
4
14
  1.165.0 (2024-02-21)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.165.0
1
+ 1.167.0
@@ -430,8 +430,8 @@ module Aws::SSM
430
430
  # meaning to and are interpreted strictly as a string of characters.
431
431
  #
432
432
  # For more information about using tags with Amazon Elastic Compute
433
- # Cloud (Amazon EC2) instances, see [Tagging your Amazon EC2
434
- # resources][1] in the *Amazon EC2 User Guide*.
433
+ # Cloud (Amazon EC2) instances, see [Tag your Amazon EC2 resources][1]
434
+ # in the *Amazon EC2 User Guide*.
435
435
  #
436
436
  #
437
437
  #
@@ -627,8 +627,8 @@ module Aws::SSM
627
627
  # Agent on machines in your hybrid environment. For more information
628
628
  # about requirements for managing on-premises machines using Systems
629
629
  # Manager, see [Setting up Amazon Web Services Systems Manager for
630
- # hybrid environments][1] in the *Amazon Web Services Systems Manager
631
- # User Guide*.
630
+ # hybrid and multicloud environments][1] in the *Amazon Web Services
631
+ # Systems Manager User Guide*.
632
632
  #
633
633
  # <note markdown="1"> Amazon Elastic Compute Cloud (Amazon EC2) instances, edge devices, and
634
634
  # on-premises servers and VMs that are configured for Systems Manager
@@ -658,8 +658,9 @@ module Aws::SSM
658
658
  # want to assign to the managed node. This IAM role must provide
659
659
  # AssumeRole permissions for the Amazon Web Services Systems Manager
660
660
  # service principal `ssm.amazonaws.com`. For more information, see
661
- # [Create an IAM service role for a hybrid environment][1] in the
662
- # *Amazon Web Services Systems Manager User Guide*.
661
+ # [Create an IAM service role for a hybrid and multicloud
662
+ # environment][1] in the *Amazon Web Services Systems Manager User
663
+ # Guide*.
663
664
  #
664
665
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
665
666
  # must create a unique role.
@@ -789,8 +790,8 @@ module Aws::SSM
789
790
  # For example, `AWS-ApplyPatchBaseline` or `My-Document`.
790
791
  #
791
792
  # @option params [String] :document_version
792
- # The document version you want to associate with the target(s). Can be
793
- # a specific version or the default version.
793
+ # The document version you want to associate with the targets. Can be a
794
+ # specific version or the default version.
794
795
  #
795
796
  # State Manager doesn't support running associations that use a new
796
797
  # version of a document if that document is shared from another account.
@@ -823,8 +824,8 @@ module Aws::SSM
823
824
  # Amazon Web Services account, or individual managed node IDs. You can
824
825
  # target all managed nodes in an Amazon Web Services account by
825
826
  # specifying the `InstanceIds` key with a value of `*`. For more
826
- # information about choosing targets for an association, see [Using
827
- # targets and rate controls with State Manager associations][1] in the
827
+ # information about choosing targets for an association, see [About
828
+ # targets and rate controls in State Manager associations][1] in the
828
829
  # *Amazon Web Services Systems Manager User Guide*.
829
830
  #
830
831
  #
@@ -832,8 +833,7 @@ module Aws::SSM
832
833
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-state-manager-targets-and-rate-controls.html
833
834
  #
834
835
  # @option params [String] :schedule_expression
835
- # A cron expression when the association will be applied to the
836
- # target(s).
836
+ # A cron expression when the association will be applied to the targets.
837
837
  #
838
838
  # @option params [Types::InstanceAssociationOutputLocation] :output_location
839
839
  # An Amazon Simple Storage Service (Amazon S3) bucket where you want to
@@ -1346,16 +1346,17 @@ module Aws::SSM
1346
1346
  # For examples, see the following topics in the *Amazon Web Services
1347
1347
  # Systems Manager User Guide*.
1348
1348
  #
1349
- # * [Create an SSM document (Amazon Web Services API)][1]
1349
+ # * [Create an SSM document (console)][1]
1350
1350
  #
1351
- # * [Create an SSM document (Amazon Web Services CLI)][2]
1351
+ # * [Create an SSM document (command line)][2]
1352
1352
  #
1353
- # * [Create an SSM document (API)][1]
1353
+ # * [Create an SSM document (API)][3]
1354
1354
  #
1355
1355
  #
1356
1356
  #
1357
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/create-ssm-document-api.html
1358
- # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/create-ssm-document-cli.html
1357
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-using.html#create-ssm-console
1358
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-using.html#create-ssm-document-cli
1359
+ # [3]: https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-using.html#create-ssm-document-api
1359
1360
  #
1360
1361
  # @option params [Array<Types::DocumentRequires>] :requires
1361
1362
  # A list of SSM documents required by a document. This parameter is used
@@ -1387,6 +1388,12 @@ module Aws::SSM
1387
1388
  #
1388
1389
  # * `amzn`
1389
1390
  #
1391
+ # * `AWSEC2`
1392
+ #
1393
+ # * `AWSConfigRemediation`
1394
+ #
1395
+ # * `AWSSupport`
1396
+ #
1390
1397
  # @option params [String] :display_name
1391
1398
  # An optional field where you can specify a friendly name for the SSM
1392
1399
  # document. This value can differ for each version of the document. You
@@ -1560,6 +1567,11 @@ module Aws::SSM
1560
1567
  # maintenance window to become active. `StartDate` allows you to delay
1561
1568
  # activation of the maintenance window until the specified future date.
1562
1569
  #
1570
+ # <note markdown="1"> When using a rate schedule, if you provide a start date that occurs in
1571
+ # the past, the current date and time are used as the start date.
1572
+ #
1573
+ # </note>
1574
+ #
1563
1575
  # @option params [String] :end_date
1564
1576
  # The date and time, in ISO-8601 Extended format, for when you want the
1565
1577
  # maintenance window to become inactive. `EndDate` allows you to set a
@@ -1741,8 +1753,8 @@ module Aws::SSM
1741
1753
  # resource in the request. Use the `/aws/automations` key in
1742
1754
  # OperationalData to associate an Automation runbook with the OpsItem.
1743
1755
  # To view Amazon Web Services CLI example commands that use these keys,
1744
- # see [Creating OpsItems manually][1] in the *Amazon Web Services
1745
- # Systems Manager User Guide*.
1756
+ # see [Create OpsItems manually][1] in the *Amazon Web Services Systems
1757
+ # Manager User Guide*.
1746
1758
  #
1747
1759
  #
1748
1760
  #
@@ -1997,12 +2009,13 @@ module Aws::SSM
1997
2009
  # and its status is reported as `InstalledOther`. This is the default
1998
2010
  # action if no option is specified.
1999
2011
  #
2000
- # * <b> <code>BLOCK</code> </b>: Packages in the `RejectedPatches` list,
2001
- # and packages that include them as dependencies, aren't installed
2002
- # under any circumstances. If a package was installed before it was
2003
- # added to the Rejected patches list, it is considered non-compliant
2004
- # with the patch baseline, and its status is reported as
2005
- # `InstalledRejected`.
2012
+ # * **BLOCK**: Packages in the **Rejected patches** list, and packages
2013
+ # that include them as dependencies, aren't installed by Patch
2014
+ # Manager under any circumstances. If a package was installed before
2015
+ # it was added to the **Rejected patches** list, or is installed
2016
+ # outside of Patch Manager afterward, it's considered noncompliant
2017
+ # with the patch baseline and its status is reported as
2018
+ # *InstalledRejected*.
2006
2019
  #
2007
2020
  # @option params [String] :description
2008
2021
  # A description of the patch baseline.
@@ -2630,9 +2643,12 @@ module Aws::SSM
2630
2643
  # * `Parameter` - The resource policy is used to share a parameter with
2631
2644
  # other accounts using Resource Access Manager (RAM). For more
2632
2645
  # information about cross-account sharing of parameters, see [Working
2633
- # with shared
2634
- # parameters](systems-manager/latest/userguide/parameter-store-shared-parameters.html)
2635
- # in the *Amazon Web Services Systems Manager User Guide*.
2646
+ # with shared parameters][1] in the *Amazon Web Services Systems
2647
+ # Manager User Guide*.
2648
+ #
2649
+ #
2650
+ #
2651
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
2636
2652
  #
2637
2653
  # @option params [required, String] :resource_arn
2638
2654
  # Amazon Resource Name (ARN) of the resource to which the policies are
@@ -3658,7 +3674,7 @@ module Aws::SSM
3658
3674
  req.send_request(options)
3659
3675
  end
3660
3676
 
3661
- # All associations for the managed node(s).
3677
+ # All associations for the managed nodes.
3662
3678
  #
3663
3679
  # @option params [required, String] :instance_id
3664
3680
  # The managed node ID for which you want to view all associations.
@@ -3777,7 +3793,7 @@ module Aws::SSM
3777
3793
  req.send_request(options)
3778
3794
  end
3779
3795
 
3780
- # The status of the associations for the managed node(s).
3796
+ # The status of the associations for the managed nodes.
3781
3797
  #
3782
3798
  # @option params [required, String] :instance_id
3783
3799
  # The managed node IDs for which you want association status
@@ -4170,6 +4186,93 @@ module Aws::SSM
4170
4186
  req.send_request(options)
4171
4187
  end
4172
4188
 
4189
+ # An API operation used by the Systems Manager console to display
4190
+ # information about Systems Manager managed nodes.
4191
+ #
4192
+ # @option params [Array<Types::InstancePropertyFilter>] :instance_property_filter_list
4193
+ # An array of instance property filters.
4194
+ #
4195
+ # @option params [Array<Types::InstancePropertyStringFilter>] :filters_with_operator
4196
+ # The request filters to use with the operator.
4197
+ #
4198
+ # @option params [Integer] :max_results
4199
+ # The maximum number of items to return for the call. The call also
4200
+ # returns a token that you can specify in a subsequent call to get the
4201
+ # next set of results.
4202
+ #
4203
+ # @option params [String] :next_token
4204
+ # The token provided by a previous request to use to return the next set
4205
+ # of properties.
4206
+ #
4207
+ # @return [Types::DescribeInstancePropertiesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4208
+ #
4209
+ # * {Types::DescribeInstancePropertiesResult#instance_properties #instance_properties} => Array&lt;Types::InstanceProperty&gt;
4210
+ # * {Types::DescribeInstancePropertiesResult#next_token #next_token} => String
4211
+ #
4212
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4213
+ #
4214
+ # @example Request syntax with placeholder values
4215
+ #
4216
+ # resp = client.describe_instance_properties({
4217
+ # instance_property_filter_list: [
4218
+ # {
4219
+ # key: "InstanceIds", # required, accepts InstanceIds, AgentVersion, PingStatus, PlatformTypes, DocumentName, ActivationIds, IamRole, ResourceType, AssociationStatus
4220
+ # value_set: ["InstancePropertyFilterValue"], # required
4221
+ # },
4222
+ # ],
4223
+ # filters_with_operator: [
4224
+ # {
4225
+ # key: "InstancePropertyStringFilterKey", # required
4226
+ # values: ["InstancePropertyFilterValue"], # required
4227
+ # operator: "Equal", # accepts Equal, NotEqual, BeginWith, LessThan, GreaterThan
4228
+ # },
4229
+ # ],
4230
+ # max_results: 1,
4231
+ # next_token: "NextToken",
4232
+ # })
4233
+ #
4234
+ # @example Response structure
4235
+ #
4236
+ # resp.instance_properties #=> Array
4237
+ # resp.instance_properties[0].name #=> String
4238
+ # resp.instance_properties[0].instance_id #=> String
4239
+ # resp.instance_properties[0].instance_type #=> String
4240
+ # resp.instance_properties[0].instance_role #=> String
4241
+ # resp.instance_properties[0].key_name #=> String
4242
+ # resp.instance_properties[0].instance_state #=> String
4243
+ # resp.instance_properties[0].architecture #=> String
4244
+ # resp.instance_properties[0].ip_address #=> String
4245
+ # resp.instance_properties[0].launch_time #=> Time
4246
+ # resp.instance_properties[0].ping_status #=> String, one of "Online", "ConnectionLost", "Inactive"
4247
+ # resp.instance_properties[0].last_ping_date_time #=> Time
4248
+ # resp.instance_properties[0].agent_version #=> String
4249
+ # resp.instance_properties[0].platform_type #=> String, one of "Windows", "Linux", "MacOS"
4250
+ # resp.instance_properties[0].platform_name #=> String
4251
+ # resp.instance_properties[0].platform_version #=> String
4252
+ # resp.instance_properties[0].activation_id #=> String
4253
+ # resp.instance_properties[0].iam_role #=> String
4254
+ # resp.instance_properties[0].registration_date #=> Time
4255
+ # resp.instance_properties[0].resource_type #=> String
4256
+ # resp.instance_properties[0].computer_name #=> String
4257
+ # resp.instance_properties[0].association_status #=> String
4258
+ # resp.instance_properties[0].last_association_execution_date #=> Time
4259
+ # resp.instance_properties[0].last_successful_association_execution_date #=> Time
4260
+ # resp.instance_properties[0].association_overview.detailed_status #=> String
4261
+ # resp.instance_properties[0].association_overview.instance_association_status_aggregated_count #=> Hash
4262
+ # resp.instance_properties[0].association_overview.instance_association_status_aggregated_count["StatusName"] #=> Integer
4263
+ # resp.instance_properties[0].source_id #=> String
4264
+ # resp.instance_properties[0].source_type #=> String, one of "AWS::EC2::Instance", "AWS::IoT::Thing", "AWS::SSM::ManagedInstance"
4265
+ # resp.next_token #=> String
4266
+ #
4267
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstanceProperties AWS API Documentation
4268
+ #
4269
+ # @overload describe_instance_properties(params = {})
4270
+ # @param [Hash] params ({})
4271
+ def describe_instance_properties(params = {}, options = {})
4272
+ req = build_request(:describe_instance_properties, params)
4273
+ req.send_request(options)
4274
+ end
4275
+
4173
4276
  # Describes a specific delete inventory operation.
4174
4277
  #
4175
4278
  # @option params [String] :deletion_id
@@ -4786,9 +4889,9 @@ module Aws::SSM
4786
4889
  # Operations engineers and IT professionals use Amazon Web Services
4787
4890
  # Systems Manager OpsCenter to view, investigate, and remediate
4788
4891
  # operational issues impacting the performance and health of their
4789
- # Amazon Web Services resources. For more information, see
4790
- # [OpsCenter][2] in the *Amazon Web Services Systems Manager User
4791
- # Guide*.
4892
+ # Amazon Web Services resources. For more information, see [Amazon Web
4893
+ # Services Systems Manager OpsCenter][2] in the *Amazon Web Services
4894
+ # Systems Manager User Guide*.
4792
4895
  #
4793
4896
  #
4794
4897
  #
@@ -4973,15 +5076,15 @@ module Aws::SSM
4973
5076
  # [PromoteResourceShareCreatedFromPolicy][1] API operation.
4974
5077
  #
4975
5078
  # For more information about sharing parameters, see [Working with
4976
- # shared
4977
- # parameters](systems-manager/latest/userguide/parameter-store-shared-parameters.html)
4978
- # in the *Amazon Web Services Systems Manager User Guide*.
5079
+ # shared parameters][2] in the *Amazon Web Services Systems Manager User
5080
+ # Guide*.
4979
5081
  #
4980
5082
  # </note>
4981
5083
  #
4982
5084
  #
4983
5085
  #
4984
5086
  # [1]: https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html
5087
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
4985
5088
  #
4986
5089
  # @return [Types::DescribeParametersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4987
5090
  #
@@ -6493,9 +6596,9 @@ module Aws::SSM
6493
6596
  # Operations engineers and IT professionals use Amazon Web Services
6494
6597
  # Systems Manager OpsCenter to view, investigate, and remediate
6495
6598
  # operational issues impacting the performance and health of their
6496
- # Amazon Web Services resources. For more information, see
6497
- # [OpsCenter][2] in the *Amazon Web Services Systems Manager User
6498
- # Guide*.
6599
+ # Amazon Web Services resources. For more information, see [Amazon Web
6600
+ # Services Systems Manager OpsCenter][2] in the *Amazon Web Services
6601
+ # Systems Manager User Guide*.
6499
6602
  #
6500
6603
  #
6501
6604
  #
@@ -6846,13 +6949,18 @@ module Aws::SSM
6846
6949
  # To query by parameter label, use `"Name": "name:label"`. To query by
6847
6950
  # parameter version, use `"Name": "name:version"`.
6848
6951
  #
6849
- # For more information about shared parameters, see [Working with shared
6952
+ # <note markdown="1"> The results for `GetParameters` requests are listed in alphabetical
6953
+ # order in query responses.
6954
+ #
6955
+ # </note>
6956
+ #
6957
+ # For information about shared parameters, see [Working with shared
6850
6958
  # parameters][1] in the *Amazon Web Services Systems Manager User
6851
6959
  # Guide*.
6852
6960
  #
6853
6961
  #
6854
6962
  #
6855
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sharing.html
6963
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html
6856
6964
  #
6857
6965
  # @option params [Boolean] :with_decryption
6858
6966
  # Return decrypted secure string value. Return decrypted values for
@@ -8492,7 +8600,7 @@ module Aws::SSM
8492
8600
  # The Amazon Web Services users that should no longer have access to the
8493
8601
  # document. The Amazon Web Services user can either be a group of
8494
8602
  # account IDs or *All*. This action has a higher priority than
8495
- # *AccountIdsToAdd*. If you specify an ID to add and the same ID to
8603
+ # `AccountIdsToAdd`. If you specify an ID to add and the same ID to
8496
8604
  # remove, the system removes access to the document.
8497
8605
  #
8498
8606
  # @option params [String] :shared_document_version
@@ -8564,7 +8672,7 @@ module Aws::SSM
8564
8672
  #
8565
8673
  # * InstalledTime: The time the association, patch, or custom compliance
8566
8674
  # item was applied to the resource. Specify the time by using the
8567
- # following format: yyyy-MM-dd'T'HH:mm:ss'Z'
8675
+ # following format: `yyyy-MM-dd'T'HH:mm:ss'Z'`
8568
8676
  #
8569
8677
  # @option params [required, String] :resource_id
8570
8678
  # Specify an ID for this resource. For a managed node, this is the node
@@ -8582,7 +8690,7 @@ module Aws::SSM
8582
8690
  # A summary of the call execution that includes an execution ID, the
8583
8691
  # type of execution (for example, `Command`), and the date/time of the
8584
8692
  # execution using a datetime object that is saved in the following
8585
- # format: yyyy-MM-dd'T'HH:mm:ss'Z'.
8693
+ # format: `yyyy-MM-dd'T'HH:mm:ss'Z'`
8586
8694
  #
8587
8695
  # @option params [required, Array<Types::ComplianceItemEntry>] :items
8588
8696
  # Information about the compliance as defined by the resource type. For
@@ -8838,8 +8946,8 @@ module Aws::SSM
8838
8946
  # configured to use parameter policies. You can create a maximum of
8839
8947
  # 100,000 advanced parameters for each Region in an Amazon Web Services
8840
8948
  # account. Advanced parameters incur a charge. For more information, see
8841
- # [Standard and advanced parameter tiers][1] in the *Amazon Web Services
8842
- # Systems Manager User Guide*.
8949
+ # [Managing parameter tiers][1] in the *Amazon Web Services Systems
8950
+ # Manager User Guide*.
8843
8951
  #
8844
8952
  # You can change a standard parameter to an advanced parameter any time.
8845
8953
  # But you can't revert an advanced parameter to a standard parameter.
@@ -8898,7 +9006,7 @@ module Aws::SSM
8898
9006
  #
8899
9007
  #
8900
9008
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html
8901
- # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ps-default-tier.html
9009
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html#ps-default-tier
8902
9010
  #
8903
9011
  # @option params [String] :policies
8904
9012
  # One or more policies to apply to a parameter. This operation takes a
@@ -8959,7 +9067,7 @@ module Aws::SSM
8959
9067
  # `aws:ec2:image` parameters are created successfully, see [Setting up
8960
9068
  # notifications or trigger actions based on Parameter Store events][1].
8961
9069
  # For more information about AMI format validation , see [Native
8962
- # parameter support for Amazon Machine Image (AMI) IDs][2].
9070
+ # parameter support for Amazon Machine Image IDs][2].
8963
9071
  #
8964
9072
  # </note>
8965
9073
  #
@@ -9048,9 +9156,9 @@ module Aws::SSM
9048
9156
  #
9049
9157
  #
9050
9158
  #
9051
- # [1]: https://docs.aws.amazon.com/parameter-store- advanced-parameters.html
9052
- # [2]: https://docs.aws.amazon.com/parameter-store-advanced-parameters.html#parameter- store-advanced-parameters-enabling
9053
- # [3]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt
9159
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html
9160
+ # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-advanced-parameters.html#parameter-store-advanced-parameters-enabling
9161
+ # [3]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html
9054
9162
  # [4]: https://docs.aws.amazon.com/ram/latest/APIReference/API_PromoteResourceShareCreatedFromPolicy.html
9055
9163
  # [5]: https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeParameters.html
9056
9164
  # [6]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html#share
@@ -9312,23 +9420,21 @@ module Aws::SSM
9312
9420
  # @option params [String] :service_role_arn
9313
9421
  # The Amazon Resource Name (ARN) of the IAM service role for Amazon Web
9314
9422
  # Services Systems Manager to assume when running a maintenance window
9315
- # task. If you do not specify a service role ARN, Systems Manager uses
9316
- # your account's service-linked role. If no service-linked role for
9317
- # Systems Manager exists in your account, it is created when you run
9318
- # `RegisterTaskWithMaintenanceWindow`.
9319
- #
9320
- # For more information, see the following topics in the in the *Amazon
9321
- # Web Services Systems Manager User Guide*:
9322
- #
9323
- # * [Using service-linked roles for Systems Manager][1]
9324
- #
9325
- # * [Should I use a service-linked role or a custom service role to run
9326
- # maintenance window tasks? ][2]
9423
+ # task. If you do not specify a service role ARN, Systems Manager uses a
9424
+ # service-linked role in your account. If no appropriate service-linked
9425
+ # role for Systems Manager exists in your account, it is created when
9426
+ # you run `RegisterTaskWithMaintenanceWindow`.
9427
+ #
9428
+ # However, for an improved security posture, we strongly recommend
9429
+ # creating a custom policy and custom service role for running your
9430
+ # maintenance window tasks. The policy can be crafted to provide only
9431
+ # the permissions needed for your particular maintenance window tasks.
9432
+ # For more information, see [Setting up maintenance windows][1] in the
9433
+ # in the *Amazon Web Services Systems Manager User Guide*.
9327
9434
  #
9328
9435
  #
9329
9436
  #
9330
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/using-service-linked-roles.html#slr-permissions
9331
- # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html#maintenance-window-tasks-service-role
9437
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
9332
9438
  #
9333
9439
  # @option params [required, String] :task_type
9334
9440
  # The type of task being registered.
@@ -9771,9 +9877,8 @@ module Aws::SSM
9771
9877
  # identify the managed nodes to send commands to, you can a send command
9772
9878
  # to tens, hundreds, or thousands of nodes at once.
9773
9879
  #
9774
- # For more information about how to use targets, see [Using targets and
9775
- # rate controls to send commands to a fleet][1] in the *Amazon Web
9776
- # Services Systems Manager User Guide*.
9880
+ # For more information about how to use targets, see [Run commands at
9881
+ # scale][1] in the *Amazon Web Services Systems Manager User Guide*.
9777
9882
  #
9778
9883
  #
9779
9884
  #
@@ -9790,9 +9895,8 @@ module Aws::SSM
9790
9895
  # To send a command to a smaller number of managed nodes, you can use
9791
9896
  # the `InstanceIds` option instead.
9792
9897
  #
9793
- # For more information about how to use targets, see [Sending commands
9794
- # to a fleet][1] in the *Amazon Web Services Systems Manager User
9795
- # Guide*.
9898
+ # For more information about how to use targets, see [Run commands at
9899
+ # scale][1] in the *Amazon Web Services Systems Manager User Guide*.
9796
9900
  #
9797
9901
  #
9798
9902
  #
@@ -9803,8 +9907,8 @@ module Aws::SSM
9803
9907
  # document) to run. This can be a public document or a custom document.
9804
9908
  # To run a shared document belonging to another account, specify the
9805
9909
  # document Amazon Resource Name (ARN). For more information about how to
9806
- # use shared documents, see [Using shared SSM documents][1] in the
9807
- # *Amazon Web Services Systems Manager User Guide*.
9910
+ # use shared documents, see [Sharing SSM documents][1] in the *Amazon
9911
+ # Web Services Systems Manager User Guide*.
9808
9912
  #
9809
9913
  # <note markdown="1"> If you specify a document name or ARN that hasn't been shared with
9810
9914
  # your account, you receive an `InvalidDocument` error.
@@ -10049,12 +10153,12 @@ module Aws::SSM
10049
10153
  # The name of the SSM document to run. This can be a public document or
10050
10154
  # a custom document. To run a shared document belonging to another
10051
10155
  # account, specify the document ARN. For more information about how to
10052
- # use shared documents, see [Using shared SSM documents][1] in the
10053
- # *Amazon Web Services Systems Manager User Guide*.
10156
+ # use shared documents, see [Sharing SSM documents][1] in the *Amazon
10157
+ # Web Services Systems Manager User Guide*.
10054
10158
  #
10055
10159
  #
10056
10160
  #
10057
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
10161
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-ssm-sharing.html
10058
10162
  #
10059
10163
  # @option params [String] :document_version
10060
10164
  # The version of the Automation runbook to use for this execution.
@@ -11260,6 +11364,11 @@ module Aws::SSM
11260
11364
  # maintenance window to become active. `StartDate` allows you to delay
11261
11365
  # activation of the maintenance window until the specified future date.
11262
11366
  #
11367
+ # <note markdown="1"> When using a rate schedule, if you provide a start date that occurs in
11368
+ # the past, the current date and time are used as the start date.
11369
+ #
11370
+ # </note>
11371
+ #
11263
11372
  # @option params [String] :end_date
11264
11373
  # The date and time, in ISO-8601 Extended format, for when you want the
11265
11374
  # maintenance window to become inactive. `EndDate` allows you to set a
@@ -11539,23 +11648,21 @@ module Aws::SSM
11539
11648
  # @option params [String] :service_role_arn
11540
11649
  # The Amazon Resource Name (ARN) of the IAM service role for Amazon Web
11541
11650
  # Services Systems Manager to assume when running a maintenance window
11542
- # task. If you do not specify a service role ARN, Systems Manager uses
11543
- # your account's service-linked role. If no service-linked role for
11544
- # Systems Manager exists in your account, it is created when you run
11545
- # `RegisterTaskWithMaintenanceWindow`.
11546
- #
11547
- # For more information, see the following topics in the in the *Amazon
11548
- # Web Services Systems Manager User Guide*:
11549
- #
11550
- # * [Using service-linked roles for Systems Manager][1]
11551
- #
11552
- # * [Should I use a service-linked role or a custom service role to run
11553
- # maintenance window tasks? ][2]
11651
+ # task. If you do not specify a service role ARN, Systems Manager uses a
11652
+ # service-linked role in your account. If no appropriate service-linked
11653
+ # role for Systems Manager exists in your account, it is created when
11654
+ # you run `RegisterTaskWithMaintenanceWindow`.
11655
+ #
11656
+ # However, for an improved security posture, we strongly recommend
11657
+ # creating a custom policy and custom service role for running your
11658
+ # maintenance window tasks. The policy can be crafted to provide only
11659
+ # the permissions needed for your particular maintenance window tasks.
11660
+ # For more information, see [Setting up maintenance windows][1] in the
11661
+ # in the *Amazon Web Services Systems Manager User Guide*.
11554
11662
  #
11555
11663
  #
11556
11664
  #
11557
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/using-service-linked-roles.html#slr-permissions
11558
- # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html#maintenance-window-tasks-service-role
11665
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-permissions.html
11559
11666
  #
11560
11667
  # @option params [Hash<String,Types::MaintenanceWindowTaskParameterValueExpression>] :task_parameters
11561
11668
  # The parameters to modify.
@@ -11854,8 +11961,9 @@ module Aws::SSM
11854
11961
  # want to assign to the managed node. This IAM role must provide
11855
11962
  # AssumeRole permissions for the Amazon Web Services Systems Manager
11856
11963
  # service principal `ssm.amazonaws.com`. For more information, see
11857
- # [Create an IAM service role for a hybrid environment][1] in the
11858
- # *Amazon Web Services Systems Manager User Guide*.
11964
+ # [Create an IAM service role for a hybrid and multicloud
11965
+ # environment][1] in the *Amazon Web Services Systems Manager User
11966
+ # Guide*.
11859
11967
  #
11860
11968
  # <note markdown="1"> You can't specify an IAM service-linked role for this parameter. You
11861
11969
  # must create a unique role.
@@ -11892,9 +12000,9 @@ module Aws::SSM
11892
12000
  # Operations engineers and IT professionals use Amazon Web Services
11893
12001
  # Systems Manager OpsCenter to view, investigate, and remediate
11894
12002
  # operational issues impacting the performance and health of their
11895
- # Amazon Web Services resources. For more information, see
11896
- # [OpsCenter][2] in the *Amazon Web Services Systems Manager User
11897
- # Guide*.
12003
+ # Amazon Web Services resources. For more information, see [Amazon Web
12004
+ # Services Systems Manager OpsCenter][2] in the *Amazon Web Services
12005
+ # Systems Manager User Guide*.
11898
12006
  #
11899
12007
  #
11900
12008
  #
@@ -12144,12 +12252,13 @@ module Aws::SSM
12144
12252
  # and its status is reported as `InstalledOther`. This is the default
12145
12253
  # action if no option is specified.
12146
12254
  #
12147
- # * <b> <code>BLOCK</code> </b>: Packages in the `RejectedPatches` list,
12148
- # and packages that include them as dependencies, aren't installed
12149
- # under any circumstances. If a package was installed before it was
12150
- # added to the `Rejected` patches list, it is considered non-compliant
12151
- # with the patch baseline, and its status is reported as
12152
- # `InstalledRejected`.
12255
+ # * **BLOCK**: Packages in the **Rejected patches** list, and packages
12256
+ # that include them as dependencies, aren't installed by Patch
12257
+ # Manager under any circumstances. If a package was installed before
12258
+ # it was added to the **Rejected patches** list, or is installed
12259
+ # outside of Patch Manager afterward, it's considered noncompliant
12260
+ # with the patch baseline and its status is reported as
12261
+ # *InstalledRejected*.
12153
12262
  #
12154
12263
  # @option params [String] :description
12155
12264
  # A description of the patch baseline.
@@ -12433,7 +12542,7 @@ module Aws::SSM
12433
12542
  params: params,
12434
12543
  config: config)
12435
12544
  context[:gem_name] = 'aws-sdk-ssm'
12436
- context[:gem_version] = '1.165.0'
12545
+ context[:gem_version] = '1.167.0'
12437
12546
  Seahorse::Client::Request.new(handlers, context)
12438
12547
  end
12439
12548