aws-sdk-ssm 1.124.0 → 1.128.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.
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/defaults_mode.rb'
30
31
  require 'aws-sdk-core/plugins/signature_v4.rb'
31
32
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
32
33
 
@@ -73,6 +74,7 @@ module Aws::SSM
73
74
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
74
75
  add_plugin(Aws::Plugins::TransferEncoding)
75
76
  add_plugin(Aws::Plugins::HttpChecksum)
77
+ add_plugin(Aws::Plugins::DefaultsMode)
76
78
  add_plugin(Aws::Plugins::SignatureV4)
77
79
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
78
80
 
@@ -119,7 +121,9 @@ module Aws::SSM
119
121
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
122
  # are very aggressive. Construct and pass an instance of
121
123
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
- # enable retries and extended timeouts.
124
+ # enable retries and extended timeouts. Instance profile credential
125
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
126
+ # to true.
123
127
  #
124
128
  # @option options [required, String] :region
125
129
  # The AWS region to connect to. The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::SSM
173
177
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
174
178
  # a clock skew correction and retry requests with skewed client clocks.
175
179
  #
180
+ # @option options [String] :defaults_mode ("legacy")
181
+ # See {Aws::DefaultsModeConfiguration} for a list of the
182
+ # accepted modes and the configuration defaults that are included.
183
+ #
176
184
  # @option options [Boolean] :disable_host_prefix_injection (false)
177
185
  # Set to true to disable SDK automatically adding host prefix
178
186
  # to default service endpoint when available.
@@ -305,7 +313,7 @@ module Aws::SSM
305
313
  # seconds to wait when opening a HTTP session before raising a
306
314
  # `Timeout::Error`.
307
315
  #
308
- # @option options [Integer] :http_read_timeout (60) The default
316
+ # @option options [Float] :http_read_timeout (60) The default
309
317
  # number of seconds to wait for response data. This value can
310
318
  # safely be set per-request on the session.
311
319
  #
@@ -321,6 +329,9 @@ module Aws::SSM
321
329
  # disables this behaviour. This value can safely be set per
322
330
  # request on the session.
323
331
  #
332
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
333
+ # in seconds.
334
+ #
324
335
  # @option options [Boolean] :http_wire_trace (false) When `true`,
325
336
  # HTTP debug output will be sent to the `:logger`.
326
337
  #
@@ -347,13 +358,13 @@ module Aws::SSM
347
358
  # @!group API Operations
348
359
 
349
360
  # Adds or overwrites one or more tags for the specified resource. Tags
350
- # are metadata that you can assign to your documents, managed instances,
361
+ # are metadata that you can assign to your documents, managed nodes,
351
362
  # maintenance windows, Parameter Store parameters, and patch baselines.
352
363
  # Tags enable you to categorize your resources in different ways, for
353
364
  # example, by purpose, owner, or environment. Each tag consists of a key
354
365
  # and an optional value, both of which you define. For example, you
355
- # could define a set of tags for your account's managed instances that
356
- # helps you track each instance's owner and stack level. For example:
366
+ # could define a set of tags for your account's managed nodes that
367
+ # helps you track each node's owner and stack level. For example:
357
368
  #
358
369
  # * `Key=Owner,Value=DbAdmin`
359
370
  #
@@ -387,9 +398,8 @@ module Aws::SSM
387
398
  # Specifies the type of resource you are tagging.
388
399
  #
389
400
  # <note markdown="1"> The `ManagedInstance` type for this API operation is for on-premises
390
- # managed instances. You must specify the name of the managed instance
391
- # in the following format: `mi-ID_number `. For example,
392
- # `mi-1a2b3c4d5e6f`.
401
+ # managed nodes. You must specify the name of the managed node in the
402
+ # following format: `mi-ID_number `. For example, `mi-1a2b3c4d5e6f`.
393
403
  #
394
404
  # </note>
395
405
  #
@@ -416,9 +426,9 @@ module Aws::SSM
416
426
  # `ManagedInstance`\: `mi-012345abcde`
417
427
  #
418
428
  # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
419
- # on-premises managed instances. You must specify the name of the
420
- # managed instance in the following format: `mi-ID_number `. For
421
- # example, `mi-1a2b3c4d5e6f`.
429
+ # on-premises managed nodes. You must specify the name of the managed
430
+ # node in the following format: `mi-ID_number `. For example,
431
+ # `mi-1a2b3c4d5e6f`.
422
432
  #
423
433
  # </note>
424
434
  #
@@ -511,8 +521,8 @@ module Aws::SSM
511
521
  # The ID of the command you want to cancel.
512
522
  #
513
523
  # @option params [Array<String>] :instance_ids
514
- # (Optional) A list of instance IDs on which you want to cancel the
515
- # command. If not provided, the command is canceled on every instance on
524
+ # (Optional) A list of managed node IDs on which you want to cancel the
525
+ # command. If not provided, the command is canceled on every node on
516
526
  # which it was requested.
517
527
  #
518
528
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -564,19 +574,19 @@ module Aws::SSM
564
574
  end
565
575
 
566
576
  # Generates an activation code and activation ID you can use to register
567
- # your on-premises server or virtual machine (VM) with Amazon Web
568
- # Services Systems Manager. Registering these machines with Systems
569
- # Manager makes it possible to manage them using Systems Manager
577
+ # your on-premises servers, edge devices, or virtual machine (VM) with
578
+ # Amazon Web Services Systems Manager. Registering these machines with
579
+ # Systems Manager makes it possible to manage them using Systems Manager
570
580
  # capabilities. You use the activation code and ID when installing SSM
571
581
  # Agent on machines in your hybrid environment. For more information
572
- # about requirements for managing on-premises instances and VMs using
573
- # Systems Manager, see [Setting up Amazon Web Services Systems Manager
574
- # for hybrid environments][1] in the *Amazon Web Services Systems
575
- # Manager User Guide*.
582
+ # about requirements for managing on-premises machines using Systems
583
+ # Manager, see [Setting up Amazon Web Services Systems Manager for
584
+ # hybrid environments][1] in the *Amazon Web Services Systems Manager
585
+ # User Guide*.
576
586
  #
577
- # <note markdown="1"> On-premises servers or VMs that are registered with Systems Manager
578
- # and Amazon Elastic Compute Cloud (Amazon EC2) instances that you
579
- # manage with Systems Manager are all called *managed instances*.
587
+ # <note markdown="1"> Amazon Elastic Compute Cloud (Amazon EC2) instances, edge devices, and
588
+ # on-premises servers and VMs that are configured for Systems Manager
589
+ # are all called *managed nodes*.
580
590
  #
581
591
  # </note>
582
592
  #
@@ -591,7 +601,7 @@ module Aws::SSM
591
601
  # Don't enter personally identifiable information in this field.
592
602
  #
593
603
  # @option params [String] :default_instance_name
594
- # The name of the registered, managed instance as it will appear in the
604
+ # The name of the registered, managed node as it will appear in the
595
605
  # Amazon Web Services Systems Manager console or when you use the Amazon
596
606
  # Web Services command line tools to list Systems Manager resources.
597
607
  #
@@ -599,7 +609,7 @@ module Aws::SSM
599
609
  #
600
610
  # @option params [required, String] :iam_role
601
611
  # The name of the Identity and Access Management (IAM) role that you
602
- # want to assign to the managed instance. This IAM role must provide
612
+ # want to assign to the managed node. This IAM role must provide
603
613
  # AssumeRole permissions for the Amazon Web Services Systems Manager
604
614
  # service principal `ssm.amazonaws.com`. For more information, see
605
615
  # [Create an IAM service role for a hybrid environment][1] in the
@@ -610,8 +620,8 @@ module Aws::SSM
610
620
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-service-role.html
611
621
  #
612
622
  # @option params [Integer] :registration_limit
613
- # Specify the maximum number of managed instances you want to register.
614
- # The default value is `1`.
623
+ # Specify the maximum number of managed nodes you want to register. The
624
+ # default value is `1`.
615
625
  #
616
626
  # @option params [Time,DateTime,Date,Integer,String] :expiration_date
617
627
  # The date by which this activation request should expire, in timestamp
@@ -637,13 +647,13 @@ module Aws::SSM
637
647
  # the on-premises servers or VMs.
638
648
  #
639
649
  # You can't add tags to or delete tags from an existing activation. You
640
- # can tag your on-premises servers and VMs after they connect to Systems
641
- # Manager for the first time and are assigned a managed instance ID.
642
- # This means they are listed in the Amazon Web Services Systems Manager
643
- # console with an ID that is prefixed with "mi-". For information
644
- # about how to add tags to your managed instances, see
650
+ # can tag your on-premises servers, edge devices, and VMs after they
651
+ # connect to Systems Manager for the first time and are assigned a
652
+ # managed node ID. This means they are listed in the Amazon Web Services
653
+ # Systems Manager console with an ID that is prefixed with "mi-". For
654
+ # information about how to add tags to your managed nodes, see
645
655
  # AddTagsToResource. For information about how to remove tags from your
646
- # managed instances, see RemoveTagsFromResource.
656
+ # managed nodes, see RemoveTagsFromResource.
647
657
  #
648
658
  # @option params [Array<Types::RegistrationMetadataItem>] :registration_metadata
649
659
  # Reserved for internal use.
@@ -690,16 +700,16 @@ module Aws::SSM
690
700
  end
691
701
 
692
702
  # A State Manager association defines the state that you want to
693
- # maintain on your instances. For example, an association can specify
694
- # that anti-virus software must be installed and running on your
695
- # instances, or that certain ports must be closed. For static targets,
696
- # the association specifies a schedule for when the configuration is
697
- # reapplied. For dynamic targets, such as an Amazon Web Services
698
- # resource group or an Amazon Web Services autoscaling group, State
699
- # Manager, a capability of Amazon Web Services Systems Manager applies
700
- # the configuration when new instances are added to the group. The
701
- # association also specifies actions to take when applying the
702
- # configuration. For example, an association for anti-virus software
703
+ # maintain on your managed nodes. For example, an association can
704
+ # specify that anti-virus software must be installed and running on your
705
+ # managed nodes, or that certain ports must be closed. For static
706
+ # targets, the association specifies a schedule for when the
707
+ # configuration is reapplied. For dynamic targets, such as an Amazon Web
708
+ # Services resource group or an Amazon Web Services autoscaling group,
709
+ # State Manager, a capability of Amazon Web Services Systems Manager
710
+ # applies the configuration when new managed nodes are added to the
711
+ # group. The association also specifies actions to take when applying
712
+ # the configuration. For example, an association for anti-virus software
703
713
  # might run once a day. If the software isn't installed, then State
704
714
  # Manager installs it. If the software is installed, but the service
705
715
  # isn't running, then the association might instruct State Manager to
@@ -707,7 +717,7 @@ module Aws::SSM
707
717
  #
708
718
  # @option params [required, String] :name
709
719
  # The name of the SSM Command document or Automation runbook that
710
- # contains the configuration information for the instance.
720
+ # contains the configuration information for the managed node.
711
721
  #
712
722
  # You can specify Amazon Web Services-predefined documents, documents
713
723
  # you created, or a document that is shared with you from another
@@ -731,10 +741,18 @@ module Aws::SSM
731
741
  # The document version you want to associate with the target(s). Can be
732
742
  # a specific version or the default version.
733
743
  #
744
+ # State Manager doesn't support running associations that use a new
745
+ # version of a document if that document is shared from another account.
746
+ # State Manager always runs the `default` version of a document if
747
+ # shared from another account, even though the Systems Manager console
748
+ # shows that a new version was processed. If you want to run an
749
+ # association using a new version of a document shared form another
750
+ # account, you must set the document version to `default`.
751
+ #
734
752
  # @option params [String] :instance_id
735
- # The instance ID.
753
+ # The managed node ID.
736
754
  #
737
- # <note markdown="1"> `InstanceId` has been deprecated. To specify an instance ID for an
755
+ # <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for an
738
756
  # association, use the `Targets` parameter. Requests that include the
739
757
  # parameter `InstanceID` with Systems Manager documents (SSM documents)
740
758
  # that use schema version 2.0 or later will fail. In addition, if you
@@ -749,14 +767,14 @@ module Aws::SSM
749
767
  # The parameters for the runtime configuration of the document.
750
768
  #
751
769
  # @option params [Array<Types::Target>] :targets
752
- # The targets for the association. You can target instances by using
753
- # tags, Amazon Web Services resource groups, all instances in an Amazon
754
- # Web Services account, or individual instance IDs. You can target all
755
- # instances in an Amazon Web Services account by specifying the
756
- # `InstanceIds` key with a value of `*`. For more information about
757
- # choosing targets for an association, see [Using targets and rate
758
- # controls with State Manager associations][1] in the *Amazon Web
759
- # Services Systems Manager User Guide*.
770
+ # The targets for the association. You can target managed nodes by using
771
+ # tags, Amazon Web Services resource groups, all managed nodes in an
772
+ # Amazon Web Services account, or individual managed node IDs. You can
773
+ # target all managed nodes in an Amazon Web Services account by
774
+ # specifying the `InstanceIds` key with a value of `*`. For more
775
+ # information about choosing targets for an association, see [Using
776
+ # targets and rate controls with State Manager associations][1] in the
777
+ # *Amazon Web Services Systems Manager User Guide*.
760
778
  #
761
779
  #
762
780
  #
@@ -786,9 +804,9 @@ module Aws::SSM
786
804
  # of the target set, for example 10%. If you specify 3, for example, the
787
805
  # system stops sending requests when the fourth error is received. If
788
806
  # you specify 0, then the system stops sending requests after the first
789
- # error is returned. If you run an association on 50 instances and set
790
- # `MaxError` to 10%, then the system stops sending the request when the
791
- # sixth error is received.
807
+ # error is returned. If you run an association on 50 managed nodes and
808
+ # set `MaxError` to 10%, then the system stops sending the request when
809
+ # the sixth error is received.
792
810
  #
793
811
  # Executions that are already running an association when `MaxErrors` is
794
812
  # reached are allowed to complete, but some of these executions may fail
@@ -802,10 +820,10 @@ module Aws::SSM
802
820
  # of the target set, for example 10%. The default value is 100%, which
803
821
  # means all targets run the association at the same time.
804
822
  #
805
- # If a new instance starts and attempts to run an association while
823
+ # If a new managed node starts and attempts to run an association while
806
824
  # Systems Manager is running `MaxConcurrency` associations, the
807
825
  # association is allowed to run. During the next association interval,
808
- # the new instance will process its association within the limit
826
+ # the new managed node will process its association within the limit
809
827
  # specified for `MaxConcurrency`.
810
828
  #
811
829
  # @option params [String] :compliance_severity
@@ -953,14 +971,14 @@ module Aws::SSM
953
971
  end
954
972
 
955
973
  # Associates the specified Amazon Web Services Systems Manager document
956
- # (SSM document) with the specified instances or targets.
974
+ # (SSM document) with the specified managed nodes or targets.
957
975
  #
958
- # When you associate a document with one or more instances using
959
- # instance IDs or tags, Amazon Web Services Systems Manager Agent (SSM
960
- # Agent) running on the instance processes the document and configures
961
- # the instance as specified.
976
+ # When you associate a document with one or more managed nodes using IDs
977
+ # or tags, Amazon Web Services Systems Manager Agent (SSM Agent) running
978
+ # on the managed node processes the document and configures the node as
979
+ # specified.
962
980
  #
963
- # If you associate a document with an instance that already has an
981
+ # If you associate a document with a managed node that already has an
964
982
  # associated document, the system returns the AssociationAlreadyExists
965
983
  # exception.
966
984
  #
@@ -1112,7 +1130,7 @@ module Aws::SSM
1112
1130
 
1113
1131
  # Creates a Amazon Web Services Systems Manager (SSM document). An SSM
1114
1132
  # document defines the actions that Systems Manager performs on your
1115
- # managed instances. For more information about SSM documents, including
1133
+ # managed nodes. For more information about SSM documents, including
1116
1134
  # information about supported schemas, features, and syntax, see [Amazon
1117
1135
  # Web Services Systems Manager Documents][1] in the *Amazon Web Services
1118
1136
  # Systems Manager User Guide*.
@@ -1273,7 +1291,7 @@ module Aws::SSM
1273
1291
  # resp.document_description.parameters[0].description #=> String
1274
1292
  # resp.document_description.parameters[0].default_value #=> String
1275
1293
  # resp.document_description.platform_types #=> Array
1276
- # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux"
1294
+ # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
1277
1295
  # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
1278
1296
  # resp.document_description.schema_version #=> String
1279
1297
  # resp.document_description.latest_version #=> String
@@ -1296,6 +1314,10 @@ module Aws::SSM
1296
1314
  # resp.document_description.approved_version #=> String
1297
1315
  # resp.document_description.pending_review_version #=> String
1298
1316
  # resp.document_description.review_status #=> String, one of "APPROVED", "NOT_REVIEWED", "PENDING", "REJECTED"
1317
+ # resp.document_description.category #=> Array
1318
+ # resp.document_description.category[0] #=> String
1319
+ # resp.document_description.category_enum #=> Array
1320
+ # resp.document_description.category_enum[0] #=> String
1299
1321
  #
1300
1322
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/CreateDocument AWS API Documentation
1301
1323
  #
@@ -1372,10 +1394,10 @@ module Aws::SSM
1372
1394
  # execution.
1373
1395
  #
1374
1396
  # @option params [required, Boolean] :allow_unassociated_targets
1375
- # Enables a maintenance window task to run on managed instances, even if
1376
- # you haven't registered those instances as targets. If enabled, then
1377
- # you must specify the unregistered instances (by instance ID) when you
1378
- # register a task with the maintenance window.
1397
+ # Enables a maintenance window task to run on managed nodes, even if you
1398
+ # haven't registered those nodes as targets. If enabled, then you must
1399
+ # specify the unregistered managed nodes (by node ID) when you register
1400
+ # a task with the maintenance window.
1379
1401
  #
1380
1402
  # If you don't enable this option, then you must specify
1381
1403
  # previously-registered targets when you register a task with the
@@ -1716,8 +1738,8 @@ module Aws::SSM
1716
1738
  #
1717
1739
  # @option params [Boolean] :approved_patches_enable_non_security
1718
1740
  # Indicates whether the list of approved patches includes non-security
1719
- # updates that should be applied to the instances. The default value is
1720
- # `false`. Applies to Linux instances only.
1741
+ # updates that should be applied to the managed nodes. The default value
1742
+ # is `false`. Applies to Linux managed nodes only.
1721
1743
  #
1722
1744
  # @option params [Array<String>] :rejected_patches
1723
1745
  # A list of explicitly rejected patches for the baseline.
@@ -1752,9 +1774,9 @@ module Aws::SSM
1752
1774
  # A description of the patch baseline.
1753
1775
  #
1754
1776
  # @option params [Array<Types::PatchSource>] :sources
1755
- # Information about the patches to use to update the instances,
1777
+ # Information about the patches to use to update the managed nodes,
1756
1778
  # including target operating systems and source repositories. Applies to
1757
- # Linux instances only.
1779
+ # Linux managed nodes only.
1758
1780
  #
1759
1781
  # @option params [String] :client_token
1760
1782
  # User-provided idempotency token.
@@ -1952,9 +1974,8 @@ module Aws::SSM
1952
1974
 
1953
1975
  # Deletes an activation. You aren't required to delete an activation.
1954
1976
  # If you delete an activation, you can no longer use it to register
1955
- # additional managed instances. Deleting an activation doesn't
1956
- # de-register managed instances. You must manually de-register managed
1957
- # instances.
1977
+ # additional managed nodes. Deleting an activation doesn't de-register
1978
+ # managed nodes. You must manually de-register managed nodes.
1958
1979
  #
1959
1980
  # @option params [required, String] :activation_id
1960
1981
  # The ID of the activation that you want to delete.
@@ -1977,23 +1998,23 @@ module Aws::SSM
1977
1998
  end
1978
1999
 
1979
2000
  # Disassociates the specified Amazon Web Services Systems Manager
1980
- # document (SSM document) from the specified instance. If you created
1981
- # the association by using the `Targets` parameter, then you must delete
1982
- # the association by using the association ID.
2001
+ # document (SSM document) from the specified managed node. If you
2002
+ # created the association by using the `Targets` parameter, then you
2003
+ # must delete the association by using the association ID.
1983
2004
  #
1984
- # When you disassociate a document from an instance, it doesn't change
1985
- # the configuration of the instance. To change the configuration state
1986
- # of an instance after you disassociate a document, you must create a
1987
- # new document with the desired configuration and associate it with the
1988
- # instance.
2005
+ # When you disassociate a document from a managed node, it doesn't
2006
+ # change the configuration of the node. To change the configuration
2007
+ # state of a managed node after you disassociate a document, you must
2008
+ # create a new document with the desired configuration and associate it
2009
+ # with the node.
1989
2010
  #
1990
2011
  # @option params [String] :name
1991
2012
  # The name of the SSM document.
1992
2013
  #
1993
2014
  # @option params [String] :instance_id
1994
- # The instance ID.
2015
+ # The managed node ID.
1995
2016
  #
1996
- # <note markdown="1"> `InstanceId` has been deprecated. To specify an instance ID for an
2017
+ # <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for an
1997
2018
  # association, use the `Targets` parameter. Requests that include the
1998
2019
  # parameter `InstanceID` with Systems Manager documents (SSM documents)
1999
2020
  # that use schema version 2.0 or later will fail. In addition, if you
@@ -2027,11 +2048,11 @@ module Aws::SSM
2027
2048
  end
2028
2049
 
2029
2050
  # Deletes the Amazon Web Services Systems Manager document (SSM
2030
- # document) and all instance associations to the document.
2051
+ # document) and all managed node associations to the document.
2031
2052
  #
2032
2053
  # Before you delete the document, we recommend that you use
2033
- # DeleteAssociation to disassociate all instances that are associated
2034
- # with the document.
2054
+ # DeleteAssociation to disassociate all managed nodes that are
2055
+ # associated with the document.
2035
2056
  #
2036
2057
  # @option params [required, String] :name
2037
2058
  # The name of the document.
@@ -2277,9 +2298,8 @@ module Aws::SSM
2277
2298
  end
2278
2299
 
2279
2300
  # Deletes a resource data sync configuration. After the configuration is
2280
- # deleted, changes to data on managed instances are no longer synced to
2281
- # or from the target. Deleting a sync configuration doesn't delete
2282
- # data.
2301
+ # deleted, changes to data on managed nodes are no longer synced to or
2302
+ # from the target. Deleting a sync configuration doesn't delete data.
2283
2303
  #
2284
2304
  # @option params [required, String] :sync_name
2285
2305
  # The name of the configuration to delete.
@@ -2306,13 +2326,13 @@ module Aws::SSM
2306
2326
  end
2307
2327
 
2308
2328
  # Removes the server or virtual machine from the list of registered
2309
- # servers. You can reregister the instance again at any time. If you
2310
- # don't plan to use Run Command on the server, we suggest uninstalling
2311
- # SSM Agent first.
2329
+ # servers. You can reregister the node again at any time. If you don't
2330
+ # plan to use Run Command on the server, we suggest uninstalling SSM
2331
+ # Agent first.
2312
2332
  #
2313
2333
  # @option params [required, String] :instance_id
2314
- # The ID assigned to the managed instance when you registered it using
2315
- # the activation process.
2334
+ # The ID assigned to the managed node when you registered it using the
2335
+ # activation process.
2316
2336
  #
2317
2337
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2318
2338
  #
@@ -2442,8 +2462,8 @@ module Aws::SSM
2442
2462
 
2443
2463
  # Describes details about the activation, such as the date and time the
2444
2464
  # activation was created, its expiration date, the Identity and Access
2445
- # Management (IAM) role assigned to the instances in the activation, and
2446
- # the number of instances registered by using this activation.
2465
+ # Management (IAM) role assigned to the managed nodes in the activation,
2466
+ # and the number of nodes registered by using this activation.
2447
2467
  #
2448
2468
  # @option params [Array<Types::DescribeActivationsFilter>] :filters
2449
2469
  # A filter to view information about your activations.
@@ -2503,15 +2523,15 @@ module Aws::SSM
2503
2523
  req.send_request(options)
2504
2524
  end
2505
2525
 
2506
- # Describes the association for the specified target or instance. If you
2507
- # created the association by using the `Targets` parameter, then you
2526
+ # Describes the association for the specified target or managed node. If
2527
+ # you created the association by using the `Targets` parameter, then you
2508
2528
  # must retrieve the association by using the association ID.
2509
2529
  #
2510
2530
  # @option params [String] :name
2511
2531
  # The name of the SSM document.
2512
2532
  #
2513
2533
  # @option params [String] :instance_id
2514
- # The instance ID.
2534
+ # The managed node ID.
2515
2535
  #
2516
2536
  # @option params [String] :association_id
2517
2537
  # The association ID for which you want information.
@@ -2519,7 +2539,7 @@ module Aws::SSM
2519
2539
  # @option params [String] :association_version
2520
2540
  # Specify the association version to retrieve. To view the latest
2521
2541
  # version, either specify `$LATEST` for this parameter, or omit this
2522
- # parameter. To view a list of all associations for an instance, use
2542
+ # parameter. To view a list of all associations for a managed node, use
2523
2543
  # ListAssociations. To get a list of versions for a specific
2524
2544
  # association, use ListAssociationVersions.
2525
2545
  #
@@ -2952,7 +2972,7 @@ module Aws::SSM
2952
2972
  #
2953
2973
  # **Windows Server**
2954
2974
  #
2955
- # Supported keys for Windows Server instance patches include the
2975
+ # Supported keys for Windows Server managed node patches include the
2956
2976
  # following:
2957
2977
  #
2958
2978
  # * <b> <code>PATCH_SET</code> </b>
@@ -2995,7 +3015,7 @@ module Aws::SSM
2995
3015
  # `aws ssm describe-available-patches --filters
2996
3016
  # Key=PRODUCT,Values=AmazonLinux2018.03 Key=CVE_ID,Values=CVE-2018-3615`
2997
3017
  #
2998
- # Supported keys for Linux instance patches include the following:
3018
+ # Supported keys for Linux managed node patches include the following:
2999
3019
  #
3000
3020
  # * <b> <code>PRODUCT</code> </b>
3001
3021
  #
@@ -3155,7 +3175,7 @@ module Aws::SSM
3155
3175
  # resp.document.parameters[0].description #=> String
3156
3176
  # resp.document.parameters[0].default_value #=> String
3157
3177
  # resp.document.platform_types #=> Array
3158
- # resp.document.platform_types[0] #=> String, one of "Windows", "Linux"
3178
+ # resp.document.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
3159
3179
  # resp.document.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
3160
3180
  # resp.document.schema_version #=> String
3161
3181
  # resp.document.latest_version #=> String
@@ -3178,6 +3198,10 @@ module Aws::SSM
3178
3198
  # resp.document.approved_version #=> String
3179
3199
  # resp.document.pending_review_version #=> String
3180
3200
  # resp.document.review_status #=> String, one of "APPROVED", "NOT_REVIEWED", "PENDING", "REJECTED"
3201
+ # resp.document.category #=> Array
3202
+ # resp.document.category[0] #=> String
3203
+ # resp.document.category_enum #=> Array
3204
+ # resp.document.category_enum[0] #=> String
3181
3205
  #
3182
3206
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeDocument AWS API Documentation
3183
3207
  #
@@ -3243,10 +3267,10 @@ module Aws::SSM
3243
3267
  req.send_request(options)
3244
3268
  end
3245
3269
 
3246
- # All associations for the instance(s).
3270
+ # All associations for the managed node(s).
3247
3271
  #
3248
3272
  # @option params [required, String] :instance_id
3249
- # The instance ID for which you want to view all associations.
3273
+ # The managed node ID for which you want to view all associations.
3250
3274
  #
3251
3275
  # @option params [Integer] :max_results
3252
3276
  # The maximum number of items to return for this call. The call also
@@ -3362,10 +3386,11 @@ module Aws::SSM
3362
3386
  req.send_request(options)
3363
3387
  end
3364
3388
 
3365
- # The status of the associations for the instance(s).
3389
+ # The status of the associations for the managed node(s).
3366
3390
  #
3367
3391
  # @option params [required, String] :instance_id
3368
- # The instance IDs for which you want association status information.
3392
+ # The managed node IDs for which you want association status
3393
+ # information.
3369
3394
  #
3370
3395
  # @option params [Integer] :max_results
3371
3396
  # The maximum number of items to return for this call. The call also
@@ -3417,17 +3442,17 @@ module Aws::SSM
3417
3442
  req.send_request(options)
3418
3443
  end
3419
3444
 
3420
- # Describes one or more of your instances, including information about
3421
- # the operating system platform, the version of SSM Agent installed on
3422
- # the instance, instance status, and so on.
3445
+ # Describes one or more of your managed nodes, including information
3446
+ # about the operating system platform, the version of SSM Agent
3447
+ # installed on the managed node, node status, and so on.
3423
3448
  #
3424
- # If you specify one or more instance IDs, it returns information for
3425
- # those instances. If you don't specify instance IDs, it returns
3426
- # information for all your instances. If you specify an instance ID that
3427
- # isn't valid or an instance that you don't own, you receive an error.
3449
+ # If you specify one or more managed node IDs, it returns information
3450
+ # for those managed nodes. If you don't specify node IDs, it returns
3451
+ # information for all your managed nodes. If you specify a node ID that
3452
+ # isn't valid or a node that you don't own, you receive an error.
3428
3453
  #
3429
3454
  # <note markdown="1"> The `IamRole` field for this API operation is the Identity and Access
3430
- # Management (IAM) role assigned to on-premises instances. This call
3455
+ # Management (IAM) role assigned to on-premises managed nodes. This call
3431
3456
  # doesn't return the IAM role for EC2 instances.
3432
3457
  #
3433
3458
  # </note>
@@ -3435,8 +3460,7 @@ module Aws::SSM
3435
3460
  # @option params [Array<Types::InstanceInformationFilter>] :instance_information_filter_list
3436
3461
  # This is a legacy method. We recommend that you don't use this method.
3437
3462
  # Instead, use the `Filters` data type. `Filters` enables you to return
3438
- # instance information by filtering based on tags applied to managed
3439
- # instances.
3463
+ # node information by filtering based on tags applied to managed nodes.
3440
3464
  #
3441
3465
  # <note markdown="1"> Attempting to use `InstanceInformationFilterList` and `Filters` leads
3442
3466
  # to an exception error.
@@ -3445,9 +3469,9 @@ module Aws::SSM
3445
3469
  #
3446
3470
  # @option params [Array<Types::InstanceInformationStringFilter>] :filters
3447
3471
  # One or more filters. Use a filter to return a more specific list of
3448
- # instances. You can filter based on tags applied to EC2 instances. Use
3449
- # this `Filters` data type instead of `InstanceInformationFilterList`,
3450
- # which is deprecated.
3472
+ # managed nodes. You can filter based on tags applied to EC2 instances.
3473
+ # Use this `Filters` data type instead of
3474
+ # `InstanceInformationFilterList`, which is deprecated.
3451
3475
  #
3452
3476
  # @option params [Integer] :max_results
3453
3477
  # The maximum number of items to return for this call. The call also
@@ -3492,7 +3516,7 @@ module Aws::SSM
3492
3516
  # resp.instance_information_list[0].last_ping_date_time #=> Time
3493
3517
  # resp.instance_information_list[0].agent_version #=> String
3494
3518
  # resp.instance_information_list[0].is_latest_version #=> Boolean
3495
- # resp.instance_information_list[0].platform_type #=> String, one of "Windows", "Linux"
3519
+ # resp.instance_information_list[0].platform_type #=> String, one of "Windows", "Linux", "MacOS"
3496
3520
  # resp.instance_information_list[0].platform_name #=> String
3497
3521
  # resp.instance_information_list[0].platform_version #=> String
3498
3522
  # resp.instance_information_list[0].activation_id #=> String
@@ -3508,6 +3532,8 @@ module Aws::SSM
3508
3532
  # resp.instance_information_list[0].association_overview.detailed_status #=> String
3509
3533
  # resp.instance_information_list[0].association_overview.instance_association_status_aggregated_count #=> Hash
3510
3534
  # resp.instance_information_list[0].association_overview.instance_association_status_aggregated_count["StatusName"] #=> Integer
3535
+ # resp.instance_information_list[0].source_id #=> String
3536
+ # resp.instance_information_list[0].source_type #=> String, one of "AWS::EC2::Instance", "AWS::IoT::Thing", "AWS::SSM::ManagedInstance"
3511
3537
  # resp.next_token #=> String
3512
3538
  #
3513
3539
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstanceInformation AWS API Documentation
@@ -3519,10 +3545,10 @@ module Aws::SSM
3519
3545
  req.send_request(options)
3520
3546
  end
3521
3547
 
3522
- # Retrieves the high-level patch state of one or more instances.
3548
+ # Retrieves the high-level patch state of one or more managed nodes.
3523
3549
  #
3524
3550
  # @option params [required, Array<String>] :instance_ids
3525
- # The ID of the instance for which patch state information should be
3551
+ # The ID of the managed node for which patch state information should be
3526
3552
  # retrieved.
3527
3553
  #
3528
3554
  # @option params [String] :next_token
@@ -3530,7 +3556,7 @@ module Aws::SSM
3530
3556
  # token from a previous call.)
3531
3557
  #
3532
3558
  # @option params [Integer] :max_results
3533
- # The maximum number of instances to return (per page).
3559
+ # The maximum number of managed nodes to return (per page).
3534
3560
  #
3535
3561
  # @return [Types::DescribeInstancePatchStatesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3536
3562
  #
@@ -3583,7 +3609,7 @@ module Aws::SSM
3583
3609
  req.send_request(options)
3584
3610
  end
3585
3611
 
3586
- # Retrieves the high-level patch state for the instances in the
3612
+ # Retrieves the high-level patch state for the managed nodes in the
3587
3613
  # specified patch group.
3588
3614
  #
3589
3615
  # @option params [required, String] :patch_group
@@ -3664,12 +3690,12 @@ module Aws::SSM
3664
3690
  req.send_request(options)
3665
3691
  end
3666
3692
 
3667
- # Retrieves information about the patches on the specified instance and
3668
- # their state relative to the patch baseline being used for the
3669
- # instance.
3693
+ # Retrieves information about the patches on the specified managed node
3694
+ # and their state relative to the patch baseline being used for the
3695
+ # node.
3670
3696
  #
3671
3697
  # @option params [required, String] :instance_id
3672
- # The ID of the instance whose patch state information should be
3698
+ # The ID of the managed node whose patch state information should be
3673
3699
  # retrieved.
3674
3700
  #
3675
3701
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
@@ -4012,7 +4038,7 @@ module Aws::SSM
4012
4038
  # The ID of the maintenance window to retrieve information about.
4013
4039
  #
4014
4040
  # @option params [Array<Types::Target>] :targets
4015
- # The instance ID or key-value pair to retrieve information about.
4041
+ # The managed node ID or key-value pair to retrieve information about.
4016
4042
  #
4017
4043
  # @option params [String] :resource_type
4018
4044
  # The type of resource you want to retrieve information about. For
@@ -4287,10 +4313,10 @@ module Aws::SSM
4287
4313
  end
4288
4314
 
4289
4315
  # Retrieves information about the maintenance window targets or tasks
4290
- # that an instance is associated with.
4316
+ # that a managed node is associated with.
4291
4317
  #
4292
4318
  # @option params [required, Array<Types::Target>] :targets
4293
- # The instance ID or key-value pair to retrieve information about.
4319
+ # The managed node ID or key-value pair to retrieve information about.
4294
4320
  #
4295
4321
  # @option params [required, String] :resource_type
4296
4322
  # The type of resource you want to retrieve information about. For
@@ -5163,18 +5189,19 @@ module Aws::SSM
5163
5189
  # or plugin.
5164
5190
  #
5165
5191
  # `GetCommandInvocation` only gives the execution status of a plugin in
5166
- # a document. To get the command execution status on a specific
5167
- # instance, use ListCommandInvocations. To get the command execution
5168
- # status across instances, use ListCommands.
5192
+ # a document. To get the command execution status on a specific managed
5193
+ # node, use ListCommandInvocations. To get the command execution status
5194
+ # across managed nodes, use ListCommands.
5169
5195
  #
5170
5196
  # @option params [required, String] :command_id
5171
5197
  # (Required) The parent command ID of the invocation plugin.
5172
5198
  #
5173
5199
  # @option params [required, String] :instance_id
5174
- # (Required) The ID of the managed instance targeted by the command. A
5175
- # managed instance can be an Amazon Elastic Compute Cloud (Amazon EC2)
5176
- # instance or an instance in your hybrid environment that is configured
5177
- # for Amazon Web Services Systems Manager.
5200
+ # (Required) The ID of the managed node targeted by the command. A
5201
+ # *managed node* can be an Amazon Elastic Compute Cloud (Amazon EC2)
5202
+ # instance, edge device, and on-premises server or VM in your hybrid
5203
+ # environment that is configured for Amazon Web Services Systems
5204
+ # Manager.
5178
5205
  #
5179
5206
  # @option params [String] :plugin_name
5180
5207
  # The name of the plugin for which you want detailed results. If the
@@ -5255,12 +5282,12 @@ module Aws::SSM
5255
5282
  req.send_request(options)
5256
5283
  end
5257
5284
 
5258
- # Retrieves the Session Manager connection status for an instance to
5285
+ # Retrieves the Session Manager connection status for a managed node to
5259
5286
  # determine whether it is running and ready to receive Session Manager
5260
5287
  # connections.
5261
5288
  #
5262
5289
  # @option params [required, String] :target
5263
- # The instance ID.
5290
+ # The managed node ID.
5264
5291
  #
5265
5292
  # @return [Types::GetConnectionStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5266
5293
  #
@@ -5323,7 +5350,7 @@ module Aws::SSM
5323
5350
  req.send_request(options)
5324
5351
  end
5325
5352
 
5326
- # Retrieves the current snapshot for the patch baseline the instance
5353
+ # Retrieves the current snapshot for the patch baseline the managed node
5327
5354
  # uses. This API is primarily used by the `AWS-RunPatchBaseline` Systems
5328
5355
  # Manager document (SSM document).
5329
5356
  #
@@ -5332,7 +5359,7 @@ module Aws::SSM
5332
5359
  # Services credentials and the operation fails. To avoid this, you can
5333
5360
  # run the command in the Amazon Web Services Systems Manager console.
5334
5361
  # Use Run Command, a capability of Amazon Web Services Systems Manager,
5335
- # with an SSM document that enables you to target an instance with a
5362
+ # with an SSM document that enables you to target a managed node with a
5336
5363
  # script or command. For example, run the command using the
5337
5364
  # `AWS-RunShellScript` document or the `AWS-RunPowerShellScript`
5338
5365
  # document.
@@ -5340,8 +5367,8 @@ module Aws::SSM
5340
5367
  # </note>
5341
5368
  #
5342
5369
  # @option params [required, String] :instance_id
5343
- # The ID of the instance for which the appropriate patch snapshot should
5344
- # be retrieved.
5370
+ # The ID of the managed node for which the appropriate patch snapshot
5371
+ # should be retrieved.
5345
5372
  #
5346
5373
  # @option params [required, String] :snapshot_id
5347
5374
  # The snapshot ID provided by the user when running
@@ -5496,8 +5523,8 @@ module Aws::SSM
5496
5523
  req.send_request(options)
5497
5524
  end
5498
5525
 
5499
- # Query inventory information. This includes instance status, such as
5500
- # `Stopped` or `Terminated`.
5526
+ # Query inventory information. This includes managed node status, such
5527
+ # as `Stopped` or `Terminated`.
5501
5528
  #
5502
5529
  # @option params [Array<Types::InventoryFilter>] :filters
5503
5530
  # One or more filters. Use a filter to return a more specific list of
@@ -5507,7 +5534,8 @@ module Aws::SSM
5507
5534
  # Returns counts of inventory types based on one or more expressions.
5508
5535
  # For example, if you aggregate by using an expression that uses the
5509
5536
  # `AWS:InstanceInformation.PlatformType` type, you can see a count of
5510
- # how many Windows and Linux instances exist in your inventoried fleet.
5537
+ # how many Windows and Linux managed nodes exist in your inventoried
5538
+ # fleet.
5511
5539
  #
5512
5540
  # @option params [Array<Types::ResultAttribute>] :result_attributes
5513
5541
  # The list of inventory item types to return.
@@ -6786,9 +6814,9 @@ module Aws::SSM
6786
6814
 
6787
6815
  # Returns all State Manager associations in the current Amazon Web
6788
6816
  # Services account and Amazon Web Services Region. You can limit the
6789
- # results to a specific State Manager association document or instance
6790
- # by specifying a filter. State Manager is a capability of Amazon Web
6791
- # Services Systems Manager.
6817
+ # results to a specific State Manager association document or managed
6818
+ # node by specifying a filter. State Manager is a capability of Amazon
6819
+ # Web Services Systems Manager.
6792
6820
  #
6793
6821
  # @option params [Array<Types::AssociationFilter>] :association_filter_list
6794
6822
  # One or more filters. Use a filter to return a more specific list of
@@ -6796,7 +6824,7 @@ module Aws::SSM
6796
6824
  #
6797
6825
  # <note markdown="1"> Filtering associations using the `InstanceID` attribute only returns
6798
6826
  # legacy associations created using the `InstanceID` attribute.
6799
- # Associations targeting the instance that are part of the Target
6827
+ # Associations targeting the managed node that are part of the Target
6800
6828
  # Attributes `ResourceGroup` or `Tags` aren't returned.
6801
6829
  #
6802
6830
  # </note>
@@ -6860,18 +6888,19 @@ module Aws::SSM
6860
6888
  req.send_request(options)
6861
6889
  end
6862
6890
 
6863
- # An invocation is copy of a command sent to a specific instance. A
6864
- # command can apply to one or more instances. A command invocation
6865
- # applies to one instance. For example, if a user runs `SendCommand`
6866
- # against three instances, then a command invocation is created for each
6867
- # requested instance ID. `ListCommandInvocations` provide status about
6868
- # command execution.
6891
+ # An invocation is copy of a command sent to a specific managed node. A
6892
+ # command can apply to one or more managed nodes. A command invocation
6893
+ # applies to one managed node. For example, if a user runs `SendCommand`
6894
+ # against three managed nodes, then a command invocation is created for
6895
+ # each requested managed node ID. `ListCommandInvocations` provide
6896
+ # status about command execution.
6869
6897
  #
6870
6898
  # @option params [String] :command_id
6871
6899
  # (Optional) The invocations for a specific command ID.
6872
6900
  #
6873
6901
  # @option params [String] :instance_id
6874
- # (Optional) The command execution details for a specific instance ID.
6902
+ # (Optional) The command execution details for a specific managed node
6903
+ # ID.
6875
6904
  #
6876
6905
  # @option params [Integer] :max_results
6877
6906
  # (Optional) The maximum number of items to return for this call. The
@@ -6966,11 +6995,11 @@ module Aws::SSM
6966
6995
  # (Optional) If provided, lists only the specified command.
6967
6996
  #
6968
6997
  # @option params [String] :instance_id
6969
- # (Optional) Lists commands issued against this instance ID.
6998
+ # (Optional) Lists commands issued against this managed node ID.
6970
6999
  #
6971
- # <note markdown="1"> You can't specify an instance ID in the same command that you specify
6972
- # `Status` = `Pending`. This is because the command hasn't reached the
6973
- # instance yet.
7000
+ # <note markdown="1"> You can't specify a managed node ID in the same command that you
7001
+ # specify `Status` = `Pending`. This is because the command hasn't
7002
+ # reached the managed node yet.
6974
7003
  #
6975
7004
  # </note>
6976
7005
  #
@@ -7384,7 +7413,7 @@ module Aws::SSM
7384
7413
  # resp.document_identifiers[0].owner #=> String
7385
7414
  # resp.document_identifiers[0].version_name #=> String
7386
7415
  # resp.document_identifiers[0].platform_types #=> Array
7387
- # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux"
7416
+ # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
7388
7417
  # resp.document_identifiers[0].document_version #=> String
7389
7418
  # resp.document_identifiers[0].document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
7390
7419
  # resp.document_identifiers[0].schema_version #=> String
@@ -7412,7 +7441,7 @@ module Aws::SSM
7412
7441
  # A list of inventory items returned by the request.
7413
7442
  #
7414
7443
  # @option params [required, String] :instance_id
7415
- # The instance ID for which you want inventory information.
7444
+ # The managed node ID for which you want inventory information.
7416
7445
  #
7417
7446
  # @option params [required, String] :type_name
7418
7447
  # The type of inventory item for which you want information.
@@ -7912,7 +7941,7 @@ module Aws::SSM
7912
7941
  # * ExecutionType: Specify patch, association, or Custom:`string`.
7913
7942
  #
7914
7943
  # * ExecutionTime. The time the patch, association, or custom compliance
7915
- # item was applied to the instance.
7944
+ # item was applied to the managed node.
7916
7945
  #
7917
7946
  # * Id: The patch, association, or custom compliance ID.
7918
7947
  #
@@ -7945,8 +7974,8 @@ module Aws::SSM
7945
7974
  # following format: yyyy-MM-dd'T'HH:mm:ss'Z'
7946
7975
  #
7947
7976
  # @option params [required, String] :resource_id
7948
- # Specify an ID for this resource. For a managed instance, this is the
7949
- # instance ID.
7977
+ # Specify an ID for this resource. For a managed node, this is the node
7978
+ # ID.
7950
7979
  #
7951
7980
  # @option params [required, String] :resource_type
7952
7981
  # Specify the type of resource. `ManagedInstance` is currently the only
@@ -8024,15 +8053,15 @@ module Aws::SSM
8024
8053
  req.send_request(options)
8025
8054
  end
8026
8055
 
8027
- # Bulk update custom inventory items on one more instance. The request
8028
- # adds an inventory item, if it doesn't already exist, or updates an
8029
- # inventory item, if it does exist.
8056
+ # Bulk update custom inventory items on one or more managed nodes. The
8057
+ # request adds an inventory item, if it doesn't already exist, or
8058
+ # updates an inventory item, if it does exist.
8030
8059
  #
8031
8060
  # @option params [required, String] :instance_id
8032
- # An instance ID where you want to add or update inventory items.
8061
+ # An managed node ID where you want to add or update inventory items.
8033
8062
  #
8034
8063
  # @option params [required, Array<Types::InventoryItem>] :items
8035
- # The inventory items that you want to add or update on instances.
8064
+ # The inventory items that you want to add or update on managed nodes.
8036
8065
  #
8037
8066
  # @return [Types::PutInventoryResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8038
8067
  #
@@ -8445,7 +8474,7 @@ module Aws::SSM
8445
8474
  #
8446
8475
  # @option params [required, Array<Types::Target>] :targets
8447
8476
  # The targets to register with the maintenance window. In other words,
8448
- # the instances to run commands on when the maintenance window runs.
8477
+ # the managed nodes to run commands on when the maintenance window runs.
8449
8478
  #
8450
8479
  # <note markdown="1"> If a single maintenance window task is registered with multiple
8451
8480
  # targets, its task invocations occur sequentially and not in parallel.
@@ -8455,35 +8484,33 @@ module Aws::SSM
8455
8484
  #
8456
8485
  # </note>
8457
8486
  #
8458
- # You can specify targets using instance IDs, resource group names, or
8459
- # tags that have been applied to instances.
8487
+ # You can specify targets using managed node IDs, resource group names,
8488
+ # or tags that have been applied to managed nodes.
8460
8489
  #
8461
- # **Example 1**\: Specify instance IDs
8490
+ # **Example 1**\: Specify managed node IDs
8462
8491
  #
8463
- # `Key=InstanceIds,Values=instance-id-1,instance-id-2,instance-id-3 `
8492
+ # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>,<instance-id-3>`
8464
8493
  #
8465
- # **Example 2**\: Use tag key-pairs applied to instances
8494
+ # **Example 2**\: Use tag key-pairs applied to managed nodes
8466
8495
  #
8467
- # `Key=tag:my-tag-key,Values=my-tag-value-1,my-tag-value-2 `
8496
+ # `Key=tag:<my-tag-key>,Values=<my-tag-value-1>,<my-tag-value-2>`
8468
8497
  #
8469
- # **Example 3**\: Use tag-keys applied to instances
8498
+ # **Example 3**\: Use tag-keys applied to managed nodes
8470
8499
  #
8471
- # `Key=tag-key,Values=my-tag-key-1,my-tag-key-2 `
8500
+ # `Key=tag-key,Values=<my-tag-key-1>,<my-tag-key-2>`
8472
8501
  #
8473
8502
  # **Example 4**\: Use resource group names
8474
8503
  #
8475
- # `Key=resource-groups:Name,Values=resource-group-name `
8504
+ # `Key=resource-groups:Name,Values=<resource-group-name>`
8476
8505
  #
8477
8506
  # **Example 5**\: Use filters for resource group types
8478
8507
  #
8479
- # `Key=resource-groups:ResourceTypeFilters,Values=resource-type-1,resource-type-2
8480
- # `
8508
+ # `Key=resource-groups:ResourceTypeFilters,Values=<resource-type-1>,<resource-type-2>`
8481
8509
  #
8482
8510
  # <note markdown="1"> For `Key=resource-groups:ResourceTypeFilters`, specify resource types
8483
8511
  # in the following format
8484
8512
  #
8485
- # `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC
8486
- # `
8513
+ # `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC`
8487
8514
  #
8488
8515
  # </note>
8489
8516
  #
@@ -8553,7 +8580,7 @@ module Aws::SSM
8553
8580
  # The ID of the maintenance window the task should be added to.
8554
8581
  #
8555
8582
  # @option params [Array<Types::Target>] :targets
8556
- # The targets (either instances or maintenance window targets).
8583
+ # The targets (either managed nodes or maintenance window targets).
8557
8584
  #
8558
8585
  # <note markdown="1"> One or more targets must be specified for maintenance window Run
8559
8586
  # Command-type tasks. Depending on the task, targets are optional for
@@ -8564,7 +8591,7 @@ module Aws::SSM
8564
8591
  #
8565
8592
  # </note>
8566
8593
  #
8567
- # Specify instances using the following format:
8594
+ # Specify managed nodes using the following format:
8568
8595
  #
8569
8596
  # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
8570
8597
  #
@@ -8648,7 +8675,7 @@ module Aws::SSM
8648
8675
  #
8649
8676
  # @option params [Types::LoggingInfo] :logging_info
8650
8677
  # A structure containing information about an Amazon Simple Storage
8651
- # Service (Amazon S3) bucket to write instance-level logs to.
8678
+ # Service (Amazon S3) bucket to write managed node-level logs to.
8652
8679
  #
8653
8680
  # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple Storage
8654
8681
  # Service (Amazon S3) bucket to contain logs, instead use the
@@ -8787,9 +8814,8 @@ module Aws::SSM
8787
8814
  # The type of resource from which you want to remove a tag.
8788
8815
  #
8789
8816
  # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
8790
- # on-premises managed instances. Specify the name of the managed
8791
- # instance in the following format: `mi-ID_number `. For example,
8792
- # `mi-1a2b3c4d5e6f`.
8817
+ # on-premises managed nodes. Specify the name of the managed node in the
8818
+ # following format: `mi-ID_number `. For example, `mi-1a2b3c4d5e6f`.
8793
8819
  #
8794
8820
  # </note>
8795
8821
  #
@@ -8813,10 +8839,9 @@ module Aws::SSM
8813
8839
  #
8814
8840
  # For the Document and Parameter values, use the name of the resource.
8815
8841
  #
8816
- # <note markdown="1"> The ManagedInstance type for this API operation is only for
8817
- # on-premises managed instances. Specify the name of the managed
8818
- # instance in the following format: mi-ID\_number. For example,
8819
- # mi-1a2b3c4d5e6f.
8842
+ # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
8843
+ # on-premises managed nodes. Specify the name of the managed node in the
8844
+ # following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
8820
8845
  #
8821
8846
  # </note>
8822
8847
  #
@@ -8906,7 +8931,7 @@ module Aws::SSM
8906
8931
  req.send_request(options)
8907
8932
  end
8908
8933
 
8909
- # Reconnects a session to an instance after it has been disconnected.
8934
+ # Reconnects a session to a managed node after it has been disconnected.
8910
8935
  # Connections can be resumed for disconnected sessions, but not
8911
8936
  # terminated sessions.
8912
8937
  #
@@ -8996,18 +9021,18 @@ module Aws::SSM
8996
9021
  req.send_request(options)
8997
9022
  end
8998
9023
 
8999
- # Runs commands on one or more managed instances.
9024
+ # Runs commands on one or more managed nodes.
9000
9025
  #
9001
9026
  # @option params [Array<String>] :instance_ids
9002
- # The IDs of the instances where the command should run. Specifying
9003
- # instance IDs is most useful when you are targeting a limited number of
9004
- # instances, though you can specify up to 50 IDs.
9027
+ # The IDs of the managed nodes where the command should run. Specifying
9028
+ # managed node IDs is most useful when you are targeting a limited
9029
+ # number of managed nodes, though you can specify up to 50 IDs.
9005
9030
  #
9006
- # To target a larger number of instances, or if you prefer not to list
9007
- # individual instance IDs, we recommend using the `Targets` option
9031
+ # To target a larger number of managed nodes, or if you prefer not to
9032
+ # list individual node IDs, we recommend using the `Targets` option
9008
9033
  # instead. Using `Targets`, which accepts tag key-value pairs to
9009
- # identify the instances to send commands to, you can a send command to
9010
- # tens, hundreds, or thousands of instances at once.
9034
+ # identify the managed nodes to send commands to, you can a send command
9035
+ # to tens, hundreds, or thousands of nodes at once.
9011
9036
  #
9012
9037
  # For more information about how to use targets, see [Using targets and
9013
9038
  # rate controls to send commands to a fleet][1] in the *Amazon Web
@@ -9018,15 +9043,15 @@ module Aws::SSM
9018
9043
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html
9019
9044
  #
9020
9045
  # @option params [Array<Types::Target>] :targets
9021
- # An array of search criteria that targets instances using a `Key,Value`
9022
- # combination that you specify. Specifying targets is most useful when
9023
- # you want to send a command to a large number of instances at once.
9024
- # Using `Targets`, which accepts tag key-value pairs to identify
9025
- # instances, you can send a command to tens, hundreds, or thousands of
9026
- # instances at once.
9046
+ # An array of search criteria that targets managed nodes using a
9047
+ # `Key,Value` combination that you specify. Specifying targets is most
9048
+ # useful when you want to send a command to a large number of managed
9049
+ # nodes at once. Using `Targets`, which accepts tag key-value pairs to
9050
+ # identify managed nodes, you can send a command to tens, hundreds, or
9051
+ # thousands of nodes at once.
9027
9052
  #
9028
- # To send a command to a smaller number of instances, you can use the
9029
- # `InstanceIds` option instead.
9053
+ # To send a command to a smaller number of managed nodes, you can use
9054
+ # the `InstanceIds` option instead.
9030
9055
  #
9031
9056
  # For more information about how to use targets, see [Sending commands
9032
9057
  # to a fleet][1] in the *Amazon Web Services Systems Manager User
@@ -9108,8 +9133,8 @@ module Aws::SSM
9108
9133
  # should be stored.
9109
9134
  #
9110
9135
  # @option params [String] :max_concurrency
9111
- # (Optional) The maximum number of instances that are allowed to run the
9112
- # command at the same time. You can specify a number such as 10 or a
9136
+ # (Optional) The maximum number of managed nodes that are allowed to run
9137
+ # the command at the same time. You can specify a number such as 10 or a
9113
9138
  # percentage such as 10%. The default value is `50`. For more
9114
9139
  # information about how to use `MaxConcurrency`, see [Using concurrency
9115
9140
  # controls][1] in the *Amazon Web Services Systems Manager User Guide*.
@@ -9553,7 +9578,7 @@ module Aws::SSM
9553
9578
  req.send_request(options)
9554
9579
  end
9555
9580
 
9556
- # Initiates a connection to a target (for example, an instance) for a
9581
+ # Initiates a connection to a target (for example, a managed node) for a
9557
9582
  # Session Manager session. Returns a URL and token that can be used to
9558
9583
  # open a WebSocket connection for sending input and receiving outputs.
9559
9584
  #
@@ -9574,14 +9599,14 @@ module Aws::SSM
9574
9599
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html
9575
9600
  #
9576
9601
  # @option params [required, String] :target
9577
- # The instance to connect to for the session.
9602
+ # The managed node to connect to for the session.
9578
9603
  #
9579
9604
  # @option params [String] :document_name
9580
9605
  # The name of the SSM document to define the parameters and plugin
9581
9606
  # settings for the session. For example, `SSM-SessionManagerRunShell`.
9582
9607
  # You can call the GetDocument API to verify the document exists before
9583
9608
  # attempting to start a session. If no document name is provided, a
9584
- # shell to the instance is launched by default.
9609
+ # shell to the managed node is launched by default.
9585
9610
  #
9586
9611
  # @option params [String] :reason
9587
9612
  # The reason for connecting to the instance. This value is included in
@@ -9651,7 +9676,7 @@ module Aws::SSM
9651
9676
  end
9652
9677
 
9653
9678
  # Permanently ends a session and closes the data connection between the
9654
- # Session Manager client and SSM Agent on the instance. A terminated
9679
+ # Session Manager client and SSM Agent on the managed node. A terminated
9655
9680
  # session isn't be resumed.
9656
9681
  #
9657
9682
  # @option params [required, String] :session_id
@@ -9724,7 +9749,14 @@ module Aws::SSM
9724
9749
 
9725
9750
  # Updates an association. You can update the association name and
9726
9751
  # version, the document version, schedule, parameters, and Amazon Simple
9727
- # Storage Service (Amazon S3) output.
9752
+ # Storage Service (Amazon S3) output. When you call `UpdateAssociation`,
9753
+ # the system drops all optional parameters from the request and
9754
+ # overwrites the association with null values for those parameters. This
9755
+ # is by design. You must specify all optional parameters in the call,
9756
+ # even if you are not changing the parameters. This includes the `Name`
9757
+ # parameter. Before calling this API action, we recommend that you call
9758
+ # the DescribeAssociation API operation and make a note of all optional
9759
+ # parameters required for your `UpdateAssociation` call.
9728
9760
  #
9729
9761
  # In order to call this API operation, your Identity and Access
9730
9762
  # Management (IAM) user account, group, or role must be configured with
@@ -9736,7 +9768,9 @@ module Aws::SSM
9736
9768
  # <resource_arn>`
9737
9769
  #
9738
9770
  # When you update an association, the association immediately runs
9739
- # against the specified targets.
9771
+ # against the specified targets. You can add the
9772
+ # `ApplyOnlyAtCronInterval` parameter to run the association during the
9773
+ # next schedule run.
9740
9774
  #
9741
9775
  # @option params [required, String] :association_id
9742
9776
  # The ID of the association you want to update.
@@ -9750,6 +9784,14 @@ module Aws::SSM
9750
9784
  # @option params [String] :document_version
9751
9785
  # The document version you want update for the association.
9752
9786
  #
9787
+ # State Manager doesn't support running associations that use a new
9788
+ # version of a document if that document is shared from another account.
9789
+ # State Manager always runs the `default` version of a document if
9790
+ # shared from another account, even though the Systems Manager console
9791
+ # shows that a new version was processed. If you want to run an
9792
+ # association using a new version of a document shared form another
9793
+ # account, you must set the document version to `default`.
9794
+ #
9753
9795
  # @option params [String] :schedule_expression
9754
9796
  # The cron expression used to schedule the association that you want to
9755
9797
  # update.
@@ -9759,7 +9801,7 @@ module Aws::SSM
9759
9801
  #
9760
9802
  # @option params [String] :name
9761
9803
  # The name of the SSM Command document or Automation runbook that
9762
- # contains the configuration information for the instance.
9804
+ # contains the configuration information for the managed node.
9763
9805
  #
9764
9806
  # You can specify Amazon Web Services-predefined documents, documents
9765
9807
  # you created, or a document that is shared with you from another
@@ -9804,9 +9846,9 @@ module Aws::SSM
9804
9846
  # of the target set, for example 10%. If you specify 3, for example, the
9805
9847
  # system stops sending requests when the fourth error is received. If
9806
9848
  # you specify 0, then the system stops sending requests after the first
9807
- # error is returned. If you run an association on 50 instances and set
9808
- # `MaxError` to 10%, then the system stops sending the request when the
9809
- # sixth error is received.
9849
+ # error is returned. If you run an association on 50 managed nodes and
9850
+ # set `MaxError` to 10%, then the system stops sending the request when
9851
+ # the sixth error is received.
9810
9852
  #
9811
9853
  # Executions that are already running an association when `MaxErrors` is
9812
9854
  # reached are allowed to complete, but some of these executions may fail
@@ -9820,10 +9862,10 @@ module Aws::SSM
9820
9862
  # of the target set, for example 10%. The default value is 100%, which
9821
9863
  # means all targets run the association at the same time.
9822
9864
  #
9823
- # If a new instance starts and attempts to run an association while
9865
+ # If a new managed node starts and attempts to run an association while
9824
9866
  # Systems Manager is running `MaxConcurrency` associations, the
9825
9867
  # association is allowed to run. During the next association interval,
9826
- # the new instance will process its association within the limit
9868
+ # the new managed node will process its association within the limit
9827
9869
  # specified for `MaxConcurrency`.
9828
9870
  #
9829
9871
  # @option params [String] :compliance_severity
@@ -9980,7 +10022,7 @@ module Aws::SSM
9980
10022
  end
9981
10023
 
9982
10024
  # Updates the status of the Amazon Web Services Systems Manager document
9983
- # (SSM document) associated with the specified instance.
10025
+ # (SSM document) associated with the specified managed node.
9984
10026
  #
9985
10027
  # `UpdateAssociationStatus` is primarily used by the Amazon Web Services
9986
10028
  # Systems Manager Agent (SSM Agent) to report status updates about your
@@ -9991,7 +10033,7 @@ module Aws::SSM
9991
10033
  # The name of the SSM document.
9992
10034
  #
9993
10035
  # @option params [required, String] :instance_id
9994
- # The instance ID.
10036
+ # The managed node ID.
9995
10037
  #
9996
10038
  # @option params [required, Types::AssociationStatus] :association_status
9997
10039
  # The association status.
@@ -10150,7 +10192,7 @@ module Aws::SSM
10150
10192
  # resp.document_description.parameters[0].description #=> String
10151
10193
  # resp.document_description.parameters[0].default_value #=> String
10152
10194
  # resp.document_description.platform_types #=> Array
10153
- # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux"
10195
+ # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
10154
10196
  # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
10155
10197
  # resp.document_description.schema_version #=> String
10156
10198
  # resp.document_description.latest_version #=> String
@@ -10173,6 +10215,10 @@ module Aws::SSM
10173
10215
  # resp.document_description.approved_version #=> String
10174
10216
  # resp.document_description.pending_review_version #=> String
10175
10217
  # resp.document_description.review_status #=> String, one of "APPROVED", "NOT_REVIEWED", "PENDING", "REJECTED"
10218
+ # resp.document_description.category #=> Array
10219
+ # resp.document_description.category[0] #=> String
10220
+ # resp.document_description.category_enum #=> Array
10221
+ # resp.document_description.category_enum[0] #=> String
10176
10222
  #
10177
10223
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/UpdateDocument AWS API Documentation
10178
10224
  #
@@ -10546,8 +10592,8 @@ module Aws::SSM
10546
10592
  # The task ID to modify.
10547
10593
  #
10548
10594
  # @option params [Array<Types::Target>] :targets
10549
- # The targets (either instances or tags) to modify. Instances are
10550
- # specified using the format
10595
+ # The targets (either managed nodes or tags) to modify. Managed nodes
10596
+ # are specified using the format
10551
10597
  # `Key=instanceids,Values=instanceID_1,instanceID_2`. Tags are specified
10552
10598
  # using the format ` Key=tag_name,Values=tag_value`.
10553
10599
  #
@@ -10843,12 +10889,12 @@ module Aws::SSM
10843
10889
  end
10844
10890
 
10845
10891
  # Changes the Identity and Access Management (IAM) role that is assigned
10846
- # to the on-premises instance or virtual machines (VM). IAM roles are
10847
- # first assigned to these hybrid instances during the activation
10892
+ # to the on-premises server, edge device, or virtual machines (VM). IAM
10893
+ # roles are first assigned to these hybrid nodes during the activation
10848
10894
  # process. For more information, see CreateActivation.
10849
10895
  #
10850
10896
  # @option params [required, String] :instance_id
10851
- # The ID of the managed instance where you want to update the role.
10897
+ # The ID of the managed node where you want to update the role.
10852
10898
  #
10853
10899
  # @option params [required, String] :iam_role
10854
10900
  # The IAM role you want to assign or change.
@@ -11103,8 +11149,8 @@ module Aws::SSM
11103
11149
  #
11104
11150
  # @option params [Boolean] :approved_patches_enable_non_security
11105
11151
  # Indicates whether the list of approved patches includes non-security
11106
- # updates that should be applied to the instances. The default value is
11107
- # `false`. Applies to Linux instances only.
11152
+ # updates that should be applied to the managed nodes. The default value
11153
+ # is `false`. Applies to Linux managed nodes only.
11108
11154
  #
11109
11155
  # @option params [Array<String>] :rejected_patches
11110
11156
  # A list of explicitly rejected patches for the baseline.
@@ -11139,9 +11185,9 @@ module Aws::SSM
11139
11185
  # A description of the patch baseline.
11140
11186
  #
11141
11187
  # @option params [Array<Types::PatchSource>] :sources
11142
- # Information about the patches to use to update the instances,
11188
+ # Information about the patches to use to update the managed nodes,
11143
11189
  # including target operating systems and source repositories. Applies to
11144
- # Linux instances only.
11190
+ # Linux managed nodes only.
11145
11191
  #
11146
11192
  # @option params [Boolean] :replace
11147
11193
  # If True, then all fields that are required by the CreatePatchBaseline
@@ -11399,7 +11445,7 @@ module Aws::SSM
11399
11445
  params: params,
11400
11446
  config: config)
11401
11447
  context[:gem_name] = 'aws-sdk-ssm'
11402
- context[:gem_version] = '1.124.0'
11448
+ context[:gem_version] = '1.128.0'
11403
11449
  Seahorse::Client::Request.new(handlers, context)
11404
11450
  end
11405
11451