aws-sdk-ssm 1.124.0 → 1.128.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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