aws-sdk-ssm 1.123.0 → 1.127.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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,16 @@ 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.
657
+ #
658
+ # @option params [Array<Types::RegistrationMetadataItem>] :registration_metadata
659
+ # Reserved for internal use.
647
660
  #
648
661
  # @return [Types::CreateActivationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
649
662
  #
@@ -664,6 +677,12 @@ module Aws::SSM
664
677
  # value: "TagValue", # required
665
678
  # },
666
679
  # ],
680
+ # registration_metadata: [
681
+ # {
682
+ # key: "RegistrationMetadataKey", # required
683
+ # value: "RegistrationMetadataValue", # required
684
+ # },
685
+ # ],
667
686
  # })
668
687
  #
669
688
  # @example Response structure
@@ -681,16 +700,16 @@ module Aws::SSM
681
700
  end
682
701
 
683
702
  # A State Manager association defines the state that you want to
684
- # maintain on your instances. For example, an association can specify
685
- # that anti-virus software must be installed and running on your
686
- # instances, or that certain ports must be closed. For static targets,
687
- # the association specifies a schedule for when the configuration is
688
- # reapplied. For dynamic targets, such as an Amazon Web Services
689
- # resource group or an Amazon Web Services autoscaling group, State
690
- # Manager, a capability of Amazon Web Services Systems Manager applies
691
- # the configuration when new instances are added to the group. The
692
- # association also specifies actions to take when applying the
693
- # 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
694
713
  # might run once a day. If the software isn't installed, then State
695
714
  # Manager installs it. If the software is installed, but the service
696
715
  # isn't running, then the association might instruct State Manager to
@@ -698,7 +717,7 @@ module Aws::SSM
698
717
  #
699
718
  # @option params [required, String] :name
700
719
  # The name of the SSM Command document or Automation runbook that
701
- # contains the configuration information for the instance.
720
+ # contains the configuration information for the managed node.
702
721
  #
703
722
  # You can specify Amazon Web Services-predefined documents, documents
704
723
  # you created, or a document that is shared with you from another
@@ -723,9 +742,9 @@ module Aws::SSM
723
742
  # a specific version or the default version.
724
743
  #
725
744
  # @option params [String] :instance_id
726
- # The instance ID.
745
+ # The managed node ID.
727
746
  #
728
- # <note markdown="1"> `InstanceId` has been deprecated. To specify an instance ID for an
747
+ # <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for an
729
748
  # association, use the `Targets` parameter. Requests that include the
730
749
  # parameter `InstanceID` with Systems Manager documents (SSM documents)
731
750
  # that use schema version 2.0 or later will fail. In addition, if you
@@ -740,14 +759,14 @@ module Aws::SSM
740
759
  # The parameters for the runtime configuration of the document.
741
760
  #
742
761
  # @option params [Array<Types::Target>] :targets
743
- # The targets for the association. You can target instances by using
744
- # tags, Amazon Web Services resource groups, all instances in an Amazon
745
- # Web Services account, or individual instance IDs. You can target all
746
- # instances in an Amazon Web Services account by specifying the
747
- # `InstanceIds` key with a value of `*`. For more information about
748
- # choosing targets for an association, see [Using targets and rate
749
- # controls with State Manager associations][1] in the *Amazon Web
750
- # Services Systems Manager User Guide*.
762
+ # The targets for the association. You can target managed nodes by using
763
+ # tags, Amazon Web Services resource groups, all managed nodes in an
764
+ # Amazon Web Services account, or individual managed node IDs. You can
765
+ # target all managed nodes in an Amazon Web Services account by
766
+ # specifying the `InstanceIds` key with a value of `*`. For more
767
+ # information about choosing targets for an association, see [Using
768
+ # targets and rate controls with State Manager associations][1] in the
769
+ # *Amazon Web Services Systems Manager User Guide*.
751
770
  #
752
771
  #
753
772
  #
@@ -777,9 +796,9 @@ module Aws::SSM
777
796
  # of the target set, for example 10%. If you specify 3, for example, the
778
797
  # system stops sending requests when the fourth error is received. If
779
798
  # you specify 0, then the system stops sending requests after the first
780
- # error is returned. If you run an association on 50 instances and set
781
- # `MaxError` to 10%, then the system stops sending the request when the
782
- # sixth error is received.
799
+ # error is returned. If you run an association on 50 managed nodes and
800
+ # set `MaxError` to 10%, then the system stops sending the request when
801
+ # the sixth error is received.
783
802
  #
784
803
  # Executions that are already running an association when `MaxErrors` is
785
804
  # reached are allowed to complete, but some of these executions may fail
@@ -793,10 +812,10 @@ module Aws::SSM
793
812
  # of the target set, for example 10%. The default value is 100%, which
794
813
  # means all targets run the association at the same time.
795
814
  #
796
- # If a new instance starts and attempts to run an association while
815
+ # If a new managed node starts and attempts to run an association while
797
816
  # Systems Manager is running `MaxConcurrency` associations, the
798
817
  # association is allowed to run. During the next association interval,
799
- # the new instance will process its association within the limit
818
+ # the new managed node will process its association within the limit
800
819
  # specified for `MaxConcurrency`.
801
820
  #
802
821
  # @option params [String] :compliance_severity
@@ -944,14 +963,14 @@ module Aws::SSM
944
963
  end
945
964
 
946
965
  # Associates the specified Amazon Web Services Systems Manager document
947
- # (SSM document) with the specified instances or targets.
966
+ # (SSM document) with the specified managed nodes or targets.
948
967
  #
949
- # When you associate a document with one or more instances using
950
- # instance IDs or tags, Amazon Web Services Systems Manager Agent (SSM
951
- # Agent) running on the instance processes the document and configures
952
- # the instance as specified.
968
+ # When you associate a document with one or more managed nodes using IDs
969
+ # or tags, Amazon Web Services Systems Manager Agent (SSM Agent) running
970
+ # on the managed node processes the document and configures the node as
971
+ # specified.
953
972
  #
954
- # If you associate a document with an instance that already has an
973
+ # If you associate a document with a managed node that already has an
955
974
  # associated document, the system returns the AssociationAlreadyExists
956
975
  # exception.
957
976
  #
@@ -1103,7 +1122,7 @@ module Aws::SSM
1103
1122
 
1104
1123
  # Creates a Amazon Web Services Systems Manager (SSM document). An SSM
1105
1124
  # document defines the actions that Systems Manager performs on your
1106
- # managed instances. For more information about SSM documents, including
1125
+ # managed nodes. For more information about SSM documents, including
1107
1126
  # information about supported schemas, features, and syntax, see [Amazon
1108
1127
  # Web Services Systems Manager Documents][1] in the *Amazon Web Services
1109
1128
  # Systems Manager User Guide*.
@@ -1264,7 +1283,7 @@ module Aws::SSM
1264
1283
  # resp.document_description.parameters[0].description #=> String
1265
1284
  # resp.document_description.parameters[0].default_value #=> String
1266
1285
  # resp.document_description.platform_types #=> Array
1267
- # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux"
1286
+ # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
1268
1287
  # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
1269
1288
  # resp.document_description.schema_version #=> String
1270
1289
  # resp.document_description.latest_version #=> String
@@ -1363,10 +1382,10 @@ module Aws::SSM
1363
1382
  # execution.
1364
1383
  #
1365
1384
  # @option params [required, Boolean] :allow_unassociated_targets
1366
- # Enables a maintenance window task to run on managed instances, even if
1367
- # you haven't registered those instances as targets. If enabled, then
1368
- # you must specify the unregistered instances (by instance ID) when you
1369
- # register a task with the maintenance window.
1385
+ # Enables a maintenance window task to run on managed nodes, even if you
1386
+ # haven't registered those nodes as targets. If enabled, then you must
1387
+ # specify the unregistered managed nodes (by node ID) when you register
1388
+ # a task with the maintenance window.
1370
1389
  #
1371
1390
  # If you don't enable this option, then you must specify
1372
1391
  # previously-registered targets when you register a task with the
@@ -1707,8 +1726,8 @@ module Aws::SSM
1707
1726
  #
1708
1727
  # @option params [Boolean] :approved_patches_enable_non_security
1709
1728
  # Indicates whether the list of approved patches includes non-security
1710
- # updates that should be applied to the instances. The default value is
1711
- # `false`. Applies to Linux instances only.
1729
+ # updates that should be applied to the managed nodes. The default value
1730
+ # is `false`. Applies to Linux managed nodes only.
1712
1731
  #
1713
1732
  # @option params [Array<String>] :rejected_patches
1714
1733
  # A list of explicitly rejected patches for the baseline.
@@ -1743,9 +1762,9 @@ module Aws::SSM
1743
1762
  # A description of the patch baseline.
1744
1763
  #
1745
1764
  # @option params [Array<Types::PatchSource>] :sources
1746
- # Information about the patches to use to update the instances,
1765
+ # Information about the patches to use to update the managed nodes,
1747
1766
  # including target operating systems and source repositories. Applies to
1748
- # Linux instances only.
1767
+ # Linux managed nodes only.
1749
1768
  #
1750
1769
  # @option params [String] :client_token
1751
1770
  # User-provided idempotency token.
@@ -1943,9 +1962,8 @@ module Aws::SSM
1943
1962
 
1944
1963
  # Deletes an activation. You aren't required to delete an activation.
1945
1964
  # If you delete an activation, you can no longer use it to register
1946
- # additional managed instances. Deleting an activation doesn't
1947
- # de-register managed instances. You must manually de-register managed
1948
- # instances.
1965
+ # additional managed nodes. Deleting an activation doesn't de-register
1966
+ # managed nodes. You must manually de-register managed nodes.
1949
1967
  #
1950
1968
  # @option params [required, String] :activation_id
1951
1969
  # The ID of the activation that you want to delete.
@@ -1968,23 +1986,23 @@ module Aws::SSM
1968
1986
  end
1969
1987
 
1970
1988
  # Disassociates the specified Amazon Web Services Systems Manager
1971
- # document (SSM document) from the specified instance. If you created
1972
- # the association by using the `Targets` parameter, then you must delete
1973
- # the association by using the association ID.
1989
+ # document (SSM document) from the specified managed node. If you
1990
+ # created the association by using the `Targets` parameter, then you
1991
+ # must delete the association by using the association ID.
1974
1992
  #
1975
- # When you disassociate a document from an instance, it doesn't change
1976
- # the configuration of the instance. To change the configuration state
1977
- # of an instance after you disassociate a document, you must create a
1978
- # new document with the desired configuration and associate it with the
1979
- # instance.
1993
+ # When you disassociate a document from a managed node, it doesn't
1994
+ # change the configuration of the node. To change the configuration
1995
+ # state of a managed node after you disassociate a document, you must
1996
+ # create a new document with the desired configuration and associate it
1997
+ # with the node.
1980
1998
  #
1981
1999
  # @option params [String] :name
1982
2000
  # The name of the SSM document.
1983
2001
  #
1984
2002
  # @option params [String] :instance_id
1985
- # The instance ID.
2003
+ # The managed node ID.
1986
2004
  #
1987
- # <note markdown="1"> `InstanceId` has been deprecated. To specify an instance ID for an
2005
+ # <note markdown="1"> `InstanceId` has been deprecated. To specify a managed node ID for an
1988
2006
  # association, use the `Targets` parameter. Requests that include the
1989
2007
  # parameter `InstanceID` with Systems Manager documents (SSM documents)
1990
2008
  # that use schema version 2.0 or later will fail. In addition, if you
@@ -2018,11 +2036,11 @@ module Aws::SSM
2018
2036
  end
2019
2037
 
2020
2038
  # Deletes the Amazon Web Services Systems Manager document (SSM
2021
- # document) and all instance associations to the document.
2039
+ # document) and all managed node associations to the document.
2022
2040
  #
2023
2041
  # Before you delete the document, we recommend that you use
2024
- # DeleteAssociation to disassociate all instances that are associated
2025
- # with the document.
2042
+ # DeleteAssociation to disassociate all managed nodes that are
2043
+ # associated with the document.
2026
2044
  #
2027
2045
  # @option params [required, String] :name
2028
2046
  # The name of the document.
@@ -2268,9 +2286,8 @@ module Aws::SSM
2268
2286
  end
2269
2287
 
2270
2288
  # Deletes a resource data sync configuration. After the configuration is
2271
- # deleted, changes to data on managed instances are no longer synced to
2272
- # or from the target. Deleting a sync configuration doesn't delete
2273
- # data.
2289
+ # deleted, changes to data on managed nodes are no longer synced to or
2290
+ # from the target. Deleting a sync configuration doesn't delete data.
2274
2291
  #
2275
2292
  # @option params [required, String] :sync_name
2276
2293
  # The name of the configuration to delete.
@@ -2297,13 +2314,13 @@ module Aws::SSM
2297
2314
  end
2298
2315
 
2299
2316
  # Removes the server or virtual machine from the list of registered
2300
- # servers. You can reregister the instance again at any time. If you
2301
- # don't plan to use Run Command on the server, we suggest uninstalling
2302
- # SSM Agent first.
2317
+ # servers. You can reregister the node again at any time. If you don't
2318
+ # plan to use Run Command on the server, we suggest uninstalling SSM
2319
+ # Agent first.
2303
2320
  #
2304
2321
  # @option params [required, String] :instance_id
2305
- # The ID assigned to the managed instance when you registered it using
2306
- # the activation process.
2322
+ # The ID assigned to the managed node when you registered it using the
2323
+ # activation process.
2307
2324
  #
2308
2325
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2309
2326
  #
@@ -2433,8 +2450,8 @@ module Aws::SSM
2433
2450
 
2434
2451
  # Describes details about the activation, such as the date and time the
2435
2452
  # activation was created, its expiration date, the Identity and Access
2436
- # Management (IAM) role assigned to the instances in the activation, and
2437
- # the number of instances registered by using this activation.
2453
+ # Management (IAM) role assigned to the managed nodes in the activation,
2454
+ # and the number of nodes registered by using this activation.
2438
2455
  #
2439
2456
  # @option params [Array<Types::DescribeActivationsFilter>] :filters
2440
2457
  # A filter to view information about your activations.
@@ -2494,15 +2511,15 @@ module Aws::SSM
2494
2511
  req.send_request(options)
2495
2512
  end
2496
2513
 
2497
- # Describes the association for the specified target or instance. If you
2498
- # created the association by using the `Targets` parameter, then you
2514
+ # Describes the association for the specified target or managed node. If
2515
+ # you created the association by using the `Targets` parameter, then you
2499
2516
  # must retrieve the association by using the association ID.
2500
2517
  #
2501
2518
  # @option params [String] :name
2502
2519
  # The name of the SSM document.
2503
2520
  #
2504
2521
  # @option params [String] :instance_id
2505
- # The instance ID.
2522
+ # The managed node ID.
2506
2523
  #
2507
2524
  # @option params [String] :association_id
2508
2525
  # The association ID for which you want information.
@@ -2510,7 +2527,7 @@ module Aws::SSM
2510
2527
  # @option params [String] :association_version
2511
2528
  # Specify the association version to retrieve. To view the latest
2512
2529
  # version, either specify `$LATEST` for this parameter, or omit this
2513
- # parameter. To view a list of all associations for an instance, use
2530
+ # parameter. To view a list of all associations for a managed node, use
2514
2531
  # ListAssociations. To get a list of versions for a specific
2515
2532
  # association, use ListAssociationVersions.
2516
2533
  #
@@ -2943,7 +2960,7 @@ module Aws::SSM
2943
2960
  #
2944
2961
  # **Windows Server**
2945
2962
  #
2946
- # Supported keys for Windows Server instance patches include the
2963
+ # Supported keys for Windows Server managed node patches include the
2947
2964
  # following:
2948
2965
  #
2949
2966
  # * <b> <code>PATCH_SET</code> </b>
@@ -2986,7 +3003,7 @@ module Aws::SSM
2986
3003
  # `aws ssm describe-available-patches --filters
2987
3004
  # Key=PRODUCT,Values=AmazonLinux2018.03 Key=CVE_ID,Values=CVE-2018-3615`
2988
3005
  #
2989
- # Supported keys for Linux instance patches include the following:
3006
+ # Supported keys for Linux managed node patches include the following:
2990
3007
  #
2991
3008
  # * <b> <code>PRODUCT</code> </b>
2992
3009
  #
@@ -3146,7 +3163,7 @@ module Aws::SSM
3146
3163
  # resp.document.parameters[0].description #=> String
3147
3164
  # resp.document.parameters[0].default_value #=> String
3148
3165
  # resp.document.platform_types #=> Array
3149
- # resp.document.platform_types[0] #=> String, one of "Windows", "Linux"
3166
+ # resp.document.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
3150
3167
  # resp.document.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
3151
3168
  # resp.document.schema_version #=> String
3152
3169
  # resp.document.latest_version #=> String
@@ -3234,10 +3251,10 @@ module Aws::SSM
3234
3251
  req.send_request(options)
3235
3252
  end
3236
3253
 
3237
- # All associations for the instance(s).
3254
+ # All associations for the managed node(s).
3238
3255
  #
3239
3256
  # @option params [required, String] :instance_id
3240
- # The instance ID for which you want to view all associations.
3257
+ # The managed node ID for which you want to view all associations.
3241
3258
  #
3242
3259
  # @option params [Integer] :max_results
3243
3260
  # The maximum number of items to return for this call. The call also
@@ -3353,10 +3370,11 @@ module Aws::SSM
3353
3370
  req.send_request(options)
3354
3371
  end
3355
3372
 
3356
- # The status of the associations for the instance(s).
3373
+ # The status of the associations for the managed node(s).
3357
3374
  #
3358
3375
  # @option params [required, String] :instance_id
3359
- # The instance IDs for which you want association status information.
3376
+ # The managed node IDs for which you want association status
3377
+ # information.
3360
3378
  #
3361
3379
  # @option params [Integer] :max_results
3362
3380
  # The maximum number of items to return for this call. The call also
@@ -3408,17 +3426,17 @@ module Aws::SSM
3408
3426
  req.send_request(options)
3409
3427
  end
3410
3428
 
3411
- # Describes one or more of your instances, including information about
3412
- # the operating system platform, the version of SSM Agent installed on
3413
- # the instance, instance status, and so on.
3429
+ # Describes one or more of your managed nodes, including information
3430
+ # about the operating system platform, the version of SSM Agent
3431
+ # installed on the managed node, node status, and so on.
3414
3432
  #
3415
- # If you specify one or more instance IDs, it returns information for
3416
- # those instances. If you don't specify instance IDs, it returns
3417
- # information for all your instances. If you specify an instance ID that
3418
- # isn't valid or an instance that you don't own, you receive an error.
3433
+ # If you specify one or more managed node IDs, it returns information
3434
+ # for those managed nodes. If you don't specify node IDs, it returns
3435
+ # information for all your managed nodes. If you specify a node ID that
3436
+ # isn't valid or a node that you don't own, you receive an error.
3419
3437
  #
3420
3438
  # <note markdown="1"> The `IamRole` field for this API operation is the Identity and Access
3421
- # Management (IAM) role assigned to on-premises instances. This call
3439
+ # Management (IAM) role assigned to on-premises managed nodes. This call
3422
3440
  # doesn't return the IAM role for EC2 instances.
3423
3441
  #
3424
3442
  # </note>
@@ -3426,8 +3444,7 @@ module Aws::SSM
3426
3444
  # @option params [Array<Types::InstanceInformationFilter>] :instance_information_filter_list
3427
3445
  # This is a legacy method. We recommend that you don't use this method.
3428
3446
  # Instead, use the `Filters` data type. `Filters` enables you to return
3429
- # instance information by filtering based on tags applied to managed
3430
- # instances.
3447
+ # node information by filtering based on tags applied to managed nodes.
3431
3448
  #
3432
3449
  # <note markdown="1"> Attempting to use `InstanceInformationFilterList` and `Filters` leads
3433
3450
  # to an exception error.
@@ -3436,9 +3453,9 @@ module Aws::SSM
3436
3453
  #
3437
3454
  # @option params [Array<Types::InstanceInformationStringFilter>] :filters
3438
3455
  # One or more filters. Use a filter to return a more specific list of
3439
- # instances. You can filter based on tags applied to EC2 instances. Use
3440
- # this `Filters` data type instead of `InstanceInformationFilterList`,
3441
- # which is deprecated.
3456
+ # managed nodes. You can filter based on tags applied to EC2 instances.
3457
+ # Use this `Filters` data type instead of
3458
+ # `InstanceInformationFilterList`, which is deprecated.
3442
3459
  #
3443
3460
  # @option params [Integer] :max_results
3444
3461
  # The maximum number of items to return for this call. The call also
@@ -3483,7 +3500,7 @@ module Aws::SSM
3483
3500
  # resp.instance_information_list[0].last_ping_date_time #=> Time
3484
3501
  # resp.instance_information_list[0].agent_version #=> String
3485
3502
  # resp.instance_information_list[0].is_latest_version #=> Boolean
3486
- # resp.instance_information_list[0].platform_type #=> String, one of "Windows", "Linux"
3503
+ # resp.instance_information_list[0].platform_type #=> String, one of "Windows", "Linux", "MacOS"
3487
3504
  # resp.instance_information_list[0].platform_name #=> String
3488
3505
  # resp.instance_information_list[0].platform_version #=> String
3489
3506
  # resp.instance_information_list[0].activation_id #=> String
@@ -3499,6 +3516,8 @@ module Aws::SSM
3499
3516
  # resp.instance_information_list[0].association_overview.detailed_status #=> String
3500
3517
  # resp.instance_information_list[0].association_overview.instance_association_status_aggregated_count #=> Hash
3501
3518
  # resp.instance_information_list[0].association_overview.instance_association_status_aggregated_count["StatusName"] #=> Integer
3519
+ # resp.instance_information_list[0].source_id #=> String
3520
+ # resp.instance_information_list[0].source_type #=> String, one of "AWS::EC2::Instance", "AWS::IoT::Thing", "AWS::SSM::ManagedInstance"
3502
3521
  # resp.next_token #=> String
3503
3522
  #
3504
3523
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DescribeInstanceInformation AWS API Documentation
@@ -3510,10 +3529,10 @@ module Aws::SSM
3510
3529
  req.send_request(options)
3511
3530
  end
3512
3531
 
3513
- # Retrieves the high-level patch state of one or more instances.
3532
+ # Retrieves the high-level patch state of one or more managed nodes.
3514
3533
  #
3515
3534
  # @option params [required, Array<String>] :instance_ids
3516
- # The ID of the instance for which patch state information should be
3535
+ # The ID of the managed node for which patch state information should be
3517
3536
  # retrieved.
3518
3537
  #
3519
3538
  # @option params [String] :next_token
@@ -3521,7 +3540,7 @@ module Aws::SSM
3521
3540
  # token from a previous call.)
3522
3541
  #
3523
3542
  # @option params [Integer] :max_results
3524
- # The maximum number of instances to return (per page).
3543
+ # The maximum number of managed nodes to return (per page).
3525
3544
  #
3526
3545
  # @return [Types::DescribeInstancePatchStatesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3527
3546
  #
@@ -3574,7 +3593,7 @@ module Aws::SSM
3574
3593
  req.send_request(options)
3575
3594
  end
3576
3595
 
3577
- # Retrieves the high-level patch state for the instances in the
3596
+ # Retrieves the high-level patch state for the managed nodes in the
3578
3597
  # specified patch group.
3579
3598
  #
3580
3599
  # @option params [required, String] :patch_group
@@ -3655,12 +3674,12 @@ module Aws::SSM
3655
3674
  req.send_request(options)
3656
3675
  end
3657
3676
 
3658
- # Retrieves information about the patches on the specified instance and
3659
- # their state relative to the patch baseline being used for the
3660
- # instance.
3677
+ # Retrieves information about the patches on the specified managed node
3678
+ # and their state relative to the patch baseline being used for the
3679
+ # node.
3661
3680
  #
3662
3681
  # @option params [required, String] :instance_id
3663
- # The ID of the instance whose patch state information should be
3682
+ # The ID of the managed node whose patch state information should be
3664
3683
  # retrieved.
3665
3684
  #
3666
3685
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
@@ -4003,7 +4022,7 @@ module Aws::SSM
4003
4022
  # The ID of the maintenance window to retrieve information about.
4004
4023
  #
4005
4024
  # @option params [Array<Types::Target>] :targets
4006
- # The instance ID or key-value pair to retrieve information about.
4025
+ # The managed node ID or key-value pair to retrieve information about.
4007
4026
  #
4008
4027
  # @option params [String] :resource_type
4009
4028
  # The type of resource you want to retrieve information about. For
@@ -4278,10 +4297,10 @@ module Aws::SSM
4278
4297
  end
4279
4298
 
4280
4299
  # Retrieves information about the maintenance window targets or tasks
4281
- # that an instance is associated with.
4300
+ # that a managed node is associated with.
4282
4301
  #
4283
4302
  # @option params [required, Array<Types::Target>] :targets
4284
- # The instance ID or key-value pair to retrieve information about.
4303
+ # The managed node ID or key-value pair to retrieve information about.
4285
4304
  #
4286
4305
  # @option params [required, String] :resource_type
4287
4306
  # The type of resource you want to retrieve information about. For
@@ -5154,18 +5173,19 @@ module Aws::SSM
5154
5173
  # or plugin.
5155
5174
  #
5156
5175
  # `GetCommandInvocation` only gives the execution status of a plugin in
5157
- # a document. To get the command execution status on a specific
5158
- # instance, use ListCommandInvocations. To get the command execution
5159
- # status across instances, use ListCommands.
5176
+ # a document. To get the command execution status on a specific managed
5177
+ # node, use ListCommandInvocations. To get the command execution status
5178
+ # across managed nodes, use ListCommands.
5160
5179
  #
5161
5180
  # @option params [required, String] :command_id
5162
5181
  # (Required) The parent command ID of the invocation plugin.
5163
5182
  #
5164
5183
  # @option params [required, String] :instance_id
5165
- # (Required) The ID of the managed instance targeted by the command. A
5166
- # managed instance can be an Amazon Elastic Compute Cloud (Amazon EC2)
5167
- # instance or an instance in your hybrid environment that is configured
5168
- # for Amazon Web Services Systems Manager.
5184
+ # (Required) The ID of the managed node targeted by the command. A
5185
+ # *managed node* can be an Amazon Elastic Compute Cloud (Amazon EC2)
5186
+ # instance, edge device, and on-premises server or VM in your hybrid
5187
+ # environment that is configured for Amazon Web Services Systems
5188
+ # Manager.
5169
5189
  #
5170
5190
  # @option params [String] :plugin_name
5171
5191
  # The name of the plugin for which you want detailed results. If the
@@ -5246,12 +5266,12 @@ module Aws::SSM
5246
5266
  req.send_request(options)
5247
5267
  end
5248
5268
 
5249
- # Retrieves the Session Manager connection status for an instance to
5269
+ # Retrieves the Session Manager connection status for a managed node to
5250
5270
  # determine whether it is running and ready to receive Session Manager
5251
5271
  # connections.
5252
5272
  #
5253
5273
  # @option params [required, String] :target
5254
- # The instance ID.
5274
+ # The managed node ID.
5255
5275
  #
5256
5276
  # @return [Types::GetConnectionStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5257
5277
  #
@@ -5314,7 +5334,7 @@ module Aws::SSM
5314
5334
  req.send_request(options)
5315
5335
  end
5316
5336
 
5317
- # Retrieves the current snapshot for the patch baseline the instance
5337
+ # Retrieves the current snapshot for the patch baseline the managed node
5318
5338
  # uses. This API is primarily used by the `AWS-RunPatchBaseline` Systems
5319
5339
  # Manager document (SSM document).
5320
5340
  #
@@ -5323,7 +5343,7 @@ module Aws::SSM
5323
5343
  # Services credentials and the operation fails. To avoid this, you can
5324
5344
  # run the command in the Amazon Web Services Systems Manager console.
5325
5345
  # Use Run Command, a capability of Amazon Web Services Systems Manager,
5326
- # with an SSM document that enables you to target an instance with a
5346
+ # with an SSM document that enables you to target a managed node with a
5327
5347
  # script or command. For example, run the command using the
5328
5348
  # `AWS-RunShellScript` document or the `AWS-RunPowerShellScript`
5329
5349
  # document.
@@ -5331,8 +5351,8 @@ module Aws::SSM
5331
5351
  # </note>
5332
5352
  #
5333
5353
  # @option params [required, String] :instance_id
5334
- # The ID of the instance for which the appropriate patch snapshot should
5335
- # be retrieved.
5354
+ # The ID of the managed node for which the appropriate patch snapshot
5355
+ # should be retrieved.
5336
5356
  #
5337
5357
  # @option params [required, String] :snapshot_id
5338
5358
  # The snapshot ID provided by the user when running
@@ -5487,8 +5507,8 @@ module Aws::SSM
5487
5507
  req.send_request(options)
5488
5508
  end
5489
5509
 
5490
- # Query inventory information. This includes instance status, such as
5491
- # `Stopped` or `Terminated`.
5510
+ # Query inventory information. This includes managed node status, such
5511
+ # as `Stopped` or `Terminated`.
5492
5512
  #
5493
5513
  # @option params [Array<Types::InventoryFilter>] :filters
5494
5514
  # One or more filters. Use a filter to return a more specific list of
@@ -5498,7 +5518,8 @@ module Aws::SSM
5498
5518
  # Returns counts of inventory types based on one or more expressions.
5499
5519
  # For example, if you aggregate by using an expression that uses the
5500
5520
  # `AWS:InstanceInformation.PlatformType` type, you can see a count of
5501
- # how many Windows and Linux instances exist in your inventoried fleet.
5521
+ # how many Windows and Linux managed nodes exist in your inventoried
5522
+ # fleet.
5502
5523
  #
5503
5524
  # @option params [Array<Types::ResultAttribute>] :result_attributes
5504
5525
  # The list of inventory item types to return.
@@ -6777,9 +6798,9 @@ module Aws::SSM
6777
6798
 
6778
6799
  # Returns all State Manager associations in the current Amazon Web
6779
6800
  # Services account and Amazon Web Services Region. You can limit the
6780
- # results to a specific State Manager association document or instance
6781
- # by specifying a filter. State Manager is a capability of Amazon Web
6782
- # Services Systems Manager.
6801
+ # results to a specific State Manager association document or managed
6802
+ # node by specifying a filter. State Manager is a capability of Amazon
6803
+ # Web Services Systems Manager.
6783
6804
  #
6784
6805
  # @option params [Array<Types::AssociationFilter>] :association_filter_list
6785
6806
  # One or more filters. Use a filter to return a more specific list of
@@ -6787,7 +6808,7 @@ module Aws::SSM
6787
6808
  #
6788
6809
  # <note markdown="1"> Filtering associations using the `InstanceID` attribute only returns
6789
6810
  # legacy associations created using the `InstanceID` attribute.
6790
- # Associations targeting the instance that are part of the Target
6811
+ # Associations targeting the managed node that are part of the Target
6791
6812
  # Attributes `ResourceGroup` or `Tags` aren't returned.
6792
6813
  #
6793
6814
  # </note>
@@ -6851,18 +6872,19 @@ module Aws::SSM
6851
6872
  req.send_request(options)
6852
6873
  end
6853
6874
 
6854
- # An invocation is copy of a command sent to a specific instance. A
6855
- # command can apply to one or more instances. A command invocation
6856
- # applies to one instance. For example, if a user runs `SendCommand`
6857
- # against three instances, then a command invocation is created for each
6858
- # requested instance ID. `ListCommandInvocations` provide status about
6859
- # command execution.
6875
+ # An invocation is copy of a command sent to a specific managed node. A
6876
+ # command can apply to one or more managed nodes. A command invocation
6877
+ # applies to one managed node. For example, if a user runs `SendCommand`
6878
+ # against three managed nodes, then a command invocation is created for
6879
+ # each requested managed node ID. `ListCommandInvocations` provide
6880
+ # status about command execution.
6860
6881
  #
6861
6882
  # @option params [String] :command_id
6862
6883
  # (Optional) The invocations for a specific command ID.
6863
6884
  #
6864
6885
  # @option params [String] :instance_id
6865
- # (Optional) The command execution details for a specific instance ID.
6886
+ # (Optional) The command execution details for a specific managed node
6887
+ # ID.
6866
6888
  #
6867
6889
  # @option params [Integer] :max_results
6868
6890
  # (Optional) The maximum number of items to return for this call. The
@@ -6957,11 +6979,11 @@ module Aws::SSM
6957
6979
  # (Optional) If provided, lists only the specified command.
6958
6980
  #
6959
6981
  # @option params [String] :instance_id
6960
- # (Optional) Lists commands issued against this instance ID.
6982
+ # (Optional) Lists commands issued against this managed node ID.
6961
6983
  #
6962
- # <note markdown="1"> You can't specify an instance ID in the same command that you specify
6963
- # `Status` = `Pending`. This is because the command hasn't reached the
6964
- # instance yet.
6984
+ # <note markdown="1"> You can't specify a managed node ID in the same command that you
6985
+ # specify `Status` = `Pending`. This is because the command hasn't
6986
+ # reached the managed node yet.
6965
6987
  #
6966
6988
  # </note>
6967
6989
  #
@@ -7375,7 +7397,7 @@ module Aws::SSM
7375
7397
  # resp.document_identifiers[0].owner #=> String
7376
7398
  # resp.document_identifiers[0].version_name #=> String
7377
7399
  # resp.document_identifiers[0].platform_types #=> Array
7378
- # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux"
7400
+ # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
7379
7401
  # resp.document_identifiers[0].document_version #=> String
7380
7402
  # resp.document_identifiers[0].document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
7381
7403
  # resp.document_identifiers[0].schema_version #=> String
@@ -7403,7 +7425,7 @@ module Aws::SSM
7403
7425
  # A list of inventory items returned by the request.
7404
7426
  #
7405
7427
  # @option params [required, String] :instance_id
7406
- # The instance ID for which you want inventory information.
7428
+ # The managed node ID for which you want inventory information.
7407
7429
  #
7408
7430
  # @option params [required, String] :type_name
7409
7431
  # The type of inventory item for which you want information.
@@ -7903,7 +7925,7 @@ module Aws::SSM
7903
7925
  # * ExecutionType: Specify patch, association, or Custom:`string`.
7904
7926
  #
7905
7927
  # * ExecutionTime. The time the patch, association, or custom compliance
7906
- # item was applied to the instance.
7928
+ # item was applied to the managed node.
7907
7929
  #
7908
7930
  # * Id: The patch, association, or custom compliance ID.
7909
7931
  #
@@ -7936,8 +7958,8 @@ module Aws::SSM
7936
7958
  # following format: yyyy-MM-dd'T'HH:mm:ss'Z'
7937
7959
  #
7938
7960
  # @option params [required, String] :resource_id
7939
- # Specify an ID for this resource. For a managed instance, this is the
7940
- # instance ID.
7961
+ # Specify an ID for this resource. For a managed node, this is the node
7962
+ # ID.
7941
7963
  #
7942
7964
  # @option params [required, String] :resource_type
7943
7965
  # Specify the type of resource. `ManagedInstance` is currently the only
@@ -8015,15 +8037,15 @@ module Aws::SSM
8015
8037
  req.send_request(options)
8016
8038
  end
8017
8039
 
8018
- # Bulk update custom inventory items on one more instance. The request
8019
- # adds an inventory item, if it doesn't already exist, or updates an
8020
- # inventory item, if it does exist.
8040
+ # Bulk update custom inventory items on one or more managed nodes. The
8041
+ # request adds an inventory item, if it doesn't already exist, or
8042
+ # updates an inventory item, if it does exist.
8021
8043
  #
8022
8044
  # @option params [required, String] :instance_id
8023
- # An instance ID where you want to add or update inventory items.
8045
+ # An managed node ID where you want to add or update inventory items.
8024
8046
  #
8025
8047
  # @option params [required, Array<Types::InventoryItem>] :items
8026
- # The inventory items that you want to add or update on instances.
8048
+ # The inventory items that you want to add or update on managed nodes.
8027
8049
  #
8028
8050
  # @return [Types::PutInventoryResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8029
8051
  #
@@ -8277,12 +8299,12 @@ module Aws::SSM
8277
8299
  # *parameter* doesn't affect the expiration date and time. When the
8278
8300
  # expiration time is reached, Parameter Store deletes the parameter.
8279
8301
  #
8280
- # ExpirationNotification: This policy triggers an event in Amazon
8302
+ # ExpirationNotification: This policy initiates an event in Amazon
8281
8303
  # CloudWatch Events that notifies you about the expiration. By using
8282
8304
  # this policy, you can receive notification before or after the
8283
8305
  # expiration time is reached, in units of days or hours.
8284
8306
  #
8285
- # NoChangeNotification: This policy triggers a CloudWatch Events event
8307
+ # NoChangeNotification: This policy initiates a CloudWatch Events event
8286
8308
  # if a parameter hasn't been modified for a specified period of time.
8287
8309
  # This policy type is useful when, for example, a secret needs to be
8288
8310
  # changed within a period of time, but it hasn't been changed.
@@ -8436,7 +8458,7 @@ module Aws::SSM
8436
8458
  #
8437
8459
  # @option params [required, Array<Types::Target>] :targets
8438
8460
  # The targets to register with the maintenance window. In other words,
8439
- # the instances to run commands on when the maintenance window runs.
8461
+ # the managed nodes to run commands on when the maintenance window runs.
8440
8462
  #
8441
8463
  # <note markdown="1"> If a single maintenance window task is registered with multiple
8442
8464
  # targets, its task invocations occur sequentially and not in parallel.
@@ -8446,35 +8468,33 @@ module Aws::SSM
8446
8468
  #
8447
8469
  # </note>
8448
8470
  #
8449
- # You can specify targets using instance IDs, resource group names, or
8450
- # tags that have been applied to instances.
8471
+ # You can specify targets using managed node IDs, resource group names,
8472
+ # or tags that have been applied to managed nodes.
8451
8473
  #
8452
- # **Example 1**\: Specify instance IDs
8474
+ # **Example 1**\: Specify managed node IDs
8453
8475
  #
8454
- # `Key=InstanceIds,Values=instance-id-1,instance-id-2,instance-id-3 `
8476
+ # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>,<instance-id-3>`
8455
8477
  #
8456
- # **Example 2**\: Use tag key-pairs applied to instances
8478
+ # **Example 2**\: Use tag key-pairs applied to managed nodes
8457
8479
  #
8458
- # `Key=tag:my-tag-key,Values=my-tag-value-1,my-tag-value-2 `
8480
+ # `Key=tag:<my-tag-key>,Values=<my-tag-value-1>,<my-tag-value-2>`
8459
8481
  #
8460
- # **Example 3**\: Use tag-keys applied to instances
8482
+ # **Example 3**\: Use tag-keys applied to managed nodes
8461
8483
  #
8462
- # `Key=tag-key,Values=my-tag-key-1,my-tag-key-2 `
8484
+ # `Key=tag-key,Values=<my-tag-key-1>,<my-tag-key-2>`
8463
8485
  #
8464
8486
  # **Example 4**\: Use resource group names
8465
8487
  #
8466
- # `Key=resource-groups:Name,Values=resource-group-name `
8488
+ # `Key=resource-groups:Name,Values=<resource-group-name>`
8467
8489
  #
8468
8490
  # **Example 5**\: Use filters for resource group types
8469
8491
  #
8470
- # `Key=resource-groups:ResourceTypeFilters,Values=resource-type-1,resource-type-2
8471
- # `
8492
+ # `Key=resource-groups:ResourceTypeFilters,Values=<resource-type-1>,<resource-type-2>`
8472
8493
  #
8473
8494
  # <note markdown="1"> For `Key=resource-groups:ResourceTypeFilters`, specify resource types
8474
8495
  # in the following format
8475
8496
  #
8476
- # `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC
8477
- # `
8497
+ # `Key=resource-groups:ResourceTypeFilters,Values=AWS::EC2::INSTANCE,AWS::EC2::VPC`
8478
8498
  #
8479
8499
  # </note>
8480
8500
  #
@@ -8544,7 +8564,7 @@ module Aws::SSM
8544
8564
  # The ID of the maintenance window the task should be added to.
8545
8565
  #
8546
8566
  # @option params [Array<Types::Target>] :targets
8547
- # The targets (either instances or maintenance window targets).
8567
+ # The targets (either managed nodes or maintenance window targets).
8548
8568
  #
8549
8569
  # <note markdown="1"> One or more targets must be specified for maintenance window Run
8550
8570
  # Command-type tasks. Depending on the task, targets are optional for
@@ -8555,7 +8575,7 @@ module Aws::SSM
8555
8575
  #
8556
8576
  # </note>
8557
8577
  #
8558
- # Specify instances using the following format:
8578
+ # Specify managed nodes using the following format:
8559
8579
  #
8560
8580
  # `Key=InstanceIds,Values=<instance-id-1>,<instance-id-2>`
8561
8581
  #
@@ -8639,7 +8659,7 @@ module Aws::SSM
8639
8659
  #
8640
8660
  # @option params [Types::LoggingInfo] :logging_info
8641
8661
  # A structure containing information about an Amazon Simple Storage
8642
- # Service (Amazon S3) bucket to write instance-level logs to.
8662
+ # Service (Amazon S3) bucket to write managed node-level logs to.
8643
8663
  #
8644
8664
  # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple Storage
8645
8665
  # Service (Amazon S3) bucket to contain logs, instead use the
@@ -8778,9 +8798,8 @@ module Aws::SSM
8778
8798
  # The type of resource from which you want to remove a tag.
8779
8799
  #
8780
8800
  # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
8781
- # on-premises managed instances. Specify the name of the managed
8782
- # instance in the following format: `mi-ID_number `. For example,
8783
- # `mi-1a2b3c4d5e6f`.
8801
+ # on-premises managed nodes. Specify the name of the managed node in the
8802
+ # following format: `mi-ID_number `. For example, `mi-1a2b3c4d5e6f`.
8784
8803
  #
8785
8804
  # </note>
8786
8805
  #
@@ -8804,10 +8823,9 @@ module Aws::SSM
8804
8823
  #
8805
8824
  # For the Document and Parameter values, use the name of the resource.
8806
8825
  #
8807
- # <note markdown="1"> The ManagedInstance type for this API operation is only for
8808
- # on-premises managed instances. Specify the name of the managed
8809
- # instance in the following format: mi-ID\_number. For example,
8810
- # mi-1a2b3c4d5e6f.
8826
+ # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
8827
+ # on-premises managed nodes. Specify the name of the managed node in the
8828
+ # following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
8811
8829
  #
8812
8830
  # </note>
8813
8831
  #
@@ -8897,7 +8915,7 @@ module Aws::SSM
8897
8915
  req.send_request(options)
8898
8916
  end
8899
8917
 
8900
- # Reconnects a session to an instance after it has been disconnected.
8918
+ # Reconnects a session to a managed node after it has been disconnected.
8901
8919
  # Connections can be resumed for disconnected sessions, but not
8902
8920
  # terminated sessions.
8903
8921
  #
@@ -8987,18 +9005,18 @@ module Aws::SSM
8987
9005
  req.send_request(options)
8988
9006
  end
8989
9007
 
8990
- # Runs commands on one or more managed instances.
9008
+ # Runs commands on one or more managed nodes.
8991
9009
  #
8992
9010
  # @option params [Array<String>] :instance_ids
8993
- # The IDs of the instances where the command should run. Specifying
8994
- # instance IDs is most useful when you are targeting a limited number of
8995
- # instances, though you can specify up to 50 IDs.
9011
+ # The IDs of the managed nodes where the command should run. Specifying
9012
+ # managed node IDs is most useful when you are targeting a limited
9013
+ # number of managed nodes, though you can specify up to 50 IDs.
8996
9014
  #
8997
- # To target a larger number of instances, or if you prefer not to list
8998
- # individual instance IDs, we recommend using the `Targets` option
9015
+ # To target a larger number of managed nodes, or if you prefer not to
9016
+ # list individual node IDs, we recommend using the `Targets` option
8999
9017
  # instead. Using `Targets`, which accepts tag key-value pairs to
9000
- # identify the instances to send commands to, you can a send command to
9001
- # tens, hundreds, or thousands of instances at once.
9018
+ # identify the managed nodes to send commands to, you can a send command
9019
+ # to tens, hundreds, or thousands of nodes at once.
9002
9020
  #
9003
9021
  # For more information about how to use targets, see [Using targets and
9004
9022
  # rate controls to send commands to a fleet][1] in the *Amazon Web
@@ -9009,15 +9027,15 @@ module Aws::SSM
9009
9027
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html
9010
9028
  #
9011
9029
  # @option params [Array<Types::Target>] :targets
9012
- # An array of search criteria that targets instances using a `Key,Value`
9013
- # combination that you specify. Specifying targets is most useful when
9014
- # you want to send a command to a large number of instances at once.
9015
- # Using `Targets`, which accepts tag key-value pairs to identify
9016
- # instances, you can send a command to tens, hundreds, or thousands of
9017
- # instances at once.
9030
+ # An array of search criteria that targets managed nodes using a
9031
+ # `Key,Value` combination that you specify. Specifying targets is most
9032
+ # useful when you want to send a command to a large number of managed
9033
+ # nodes at once. Using `Targets`, which accepts tag key-value pairs to
9034
+ # identify managed nodes, you can send a command to tens, hundreds, or
9035
+ # thousands of nodes at once.
9018
9036
  #
9019
- # To send a command to a smaller number of instances, you can use the
9020
- # `InstanceIds` option instead.
9037
+ # To send a command to a smaller number of managed nodes, you can use
9038
+ # the `InstanceIds` option instead.
9021
9039
  #
9022
9040
  # For more information about how to use targets, see [Sending commands
9023
9041
  # to a fleet][1] in the *Amazon Web Services Systems Manager User
@@ -9099,8 +9117,8 @@ module Aws::SSM
9099
9117
  # should be stored.
9100
9118
  #
9101
9119
  # @option params [String] :max_concurrency
9102
- # (Optional) The maximum number of instances that are allowed to run the
9103
- # command at the same time. You can specify a number such as 10 or a
9120
+ # (Optional) The maximum number of managed nodes that are allowed to run
9121
+ # the command at the same time. You can specify a number such as 10 or a
9104
9122
  # percentage such as 10%. The default value is `50`. For more
9105
9123
  # information about how to use `MaxConcurrency`, see [Using concurrency
9106
9124
  # controls][1] in the *Amazon Web Services Systems Manager User Guide*.
@@ -9544,7 +9562,7 @@ module Aws::SSM
9544
9562
  req.send_request(options)
9545
9563
  end
9546
9564
 
9547
- # Initiates a connection to a target (for example, an instance) for a
9565
+ # Initiates a connection to a target (for example, a managed node) for a
9548
9566
  # Session Manager session. Returns a URL and token that can be used to
9549
9567
  # open a WebSocket connection for sending input and receiving outputs.
9550
9568
  #
@@ -9565,14 +9583,14 @@ module Aws::SSM
9565
9583
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html
9566
9584
  #
9567
9585
  # @option params [required, String] :target
9568
- # The instance to connect to for the session.
9586
+ # The managed node to connect to for the session.
9569
9587
  #
9570
9588
  # @option params [String] :document_name
9571
9589
  # The name of the SSM document to define the parameters and plugin
9572
9590
  # settings for the session. For example, `SSM-SessionManagerRunShell`.
9573
9591
  # You can call the GetDocument API to verify the document exists before
9574
9592
  # attempting to start a session. If no document name is provided, a
9575
- # shell to the instance is launched by default.
9593
+ # shell to the managed node is launched by default.
9576
9594
  #
9577
9595
  # @option params [String] :reason
9578
9596
  # The reason for connecting to the instance. This value is included in
@@ -9642,7 +9660,7 @@ module Aws::SSM
9642
9660
  end
9643
9661
 
9644
9662
  # Permanently ends a session and closes the data connection between the
9645
- # Session Manager client and SSM Agent on the instance. A terminated
9663
+ # Session Manager client and SSM Agent on the managed node. A terminated
9646
9664
  # session isn't be resumed.
9647
9665
  #
9648
9666
  # @option params [required, String] :session_id
@@ -9750,7 +9768,7 @@ module Aws::SSM
9750
9768
  #
9751
9769
  # @option params [String] :name
9752
9770
  # The name of the SSM Command document or Automation runbook that
9753
- # contains the configuration information for the instance.
9771
+ # contains the configuration information for the managed node.
9754
9772
  #
9755
9773
  # You can specify Amazon Web Services-predefined documents, documents
9756
9774
  # you created, or a document that is shared with you from another
@@ -9795,9 +9813,9 @@ module Aws::SSM
9795
9813
  # of the target set, for example 10%. If you specify 3, for example, the
9796
9814
  # system stops sending requests when the fourth error is received. If
9797
9815
  # you specify 0, then the system stops sending requests after the first
9798
- # error is returned. If you run an association on 50 instances and set
9799
- # `MaxError` to 10%, then the system stops sending the request when the
9800
- # sixth error is received.
9816
+ # error is returned. If you run an association on 50 managed nodes and
9817
+ # set `MaxError` to 10%, then the system stops sending the request when
9818
+ # the sixth error is received.
9801
9819
  #
9802
9820
  # Executions that are already running an association when `MaxErrors` is
9803
9821
  # reached are allowed to complete, but some of these executions may fail
@@ -9811,10 +9829,10 @@ module Aws::SSM
9811
9829
  # of the target set, for example 10%. The default value is 100%, which
9812
9830
  # means all targets run the association at the same time.
9813
9831
  #
9814
- # If a new instance starts and attempts to run an association while
9832
+ # If a new managed node starts and attempts to run an association while
9815
9833
  # Systems Manager is running `MaxConcurrency` associations, the
9816
9834
  # association is allowed to run. During the next association interval,
9817
- # the new instance will process its association within the limit
9835
+ # the new managed node will process its association within the limit
9818
9836
  # specified for `MaxConcurrency`.
9819
9837
  #
9820
9838
  # @option params [String] :compliance_severity
@@ -9971,7 +9989,7 @@ module Aws::SSM
9971
9989
  end
9972
9990
 
9973
9991
  # Updates the status of the Amazon Web Services Systems Manager document
9974
- # (SSM document) associated with the specified instance.
9992
+ # (SSM document) associated with the specified managed node.
9975
9993
  #
9976
9994
  # `UpdateAssociationStatus` is primarily used by the Amazon Web Services
9977
9995
  # Systems Manager Agent (SSM Agent) to report status updates about your
@@ -9982,7 +10000,7 @@ module Aws::SSM
9982
10000
  # The name of the SSM document.
9983
10001
  #
9984
10002
  # @option params [required, String] :instance_id
9985
- # The instance ID.
10003
+ # The managed node ID.
9986
10004
  #
9987
10005
  # @option params [required, Types::AssociationStatus] :association_status
9988
10006
  # The association status.
@@ -10141,7 +10159,7 @@ module Aws::SSM
10141
10159
  # resp.document_description.parameters[0].description #=> String
10142
10160
  # resp.document_description.parameters[0].default_value #=> String
10143
10161
  # resp.document_description.platform_types #=> Array
10144
- # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux"
10162
+ # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux", "MacOS"
10145
10163
  # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
10146
10164
  # resp.document_description.schema_version #=> String
10147
10165
  # resp.document_description.latest_version #=> String
@@ -10537,8 +10555,8 @@ module Aws::SSM
10537
10555
  # The task ID to modify.
10538
10556
  #
10539
10557
  # @option params [Array<Types::Target>] :targets
10540
- # The targets (either instances or tags) to modify. Instances are
10541
- # specified using the format
10558
+ # The targets (either managed nodes or tags) to modify. Managed nodes
10559
+ # are specified using the format
10542
10560
  # `Key=instanceids,Values=instanceID_1,instanceID_2`. Tags are specified
10543
10561
  # using the format ` Key=tag_name,Values=tag_value`.
10544
10562
  #
@@ -10834,12 +10852,12 @@ module Aws::SSM
10834
10852
  end
10835
10853
 
10836
10854
  # Changes the Identity and Access Management (IAM) role that is assigned
10837
- # to the on-premises instance or virtual machines (VM). IAM roles are
10838
- # first assigned to these hybrid instances during the activation
10855
+ # to the on-premises server, edge device, or virtual machines (VM). IAM
10856
+ # roles are first assigned to these hybrid nodes during the activation
10839
10857
  # process. For more information, see CreateActivation.
10840
10858
  #
10841
10859
  # @option params [required, String] :instance_id
10842
- # The ID of the managed instance where you want to update the role.
10860
+ # The ID of the managed node where you want to update the role.
10843
10861
  #
10844
10862
  # @option params [required, String] :iam_role
10845
10863
  # The IAM role you want to assign or change.
@@ -11094,8 +11112,8 @@ module Aws::SSM
11094
11112
  #
11095
11113
  # @option params [Boolean] :approved_patches_enable_non_security
11096
11114
  # Indicates whether the list of approved patches includes non-security
11097
- # updates that should be applied to the instances. The default value is
11098
- # `false`. Applies to Linux instances only.
11115
+ # updates that should be applied to the managed nodes. The default value
11116
+ # is `false`. Applies to Linux managed nodes only.
11099
11117
  #
11100
11118
  # @option params [Array<String>] :rejected_patches
11101
11119
  # A list of explicitly rejected patches for the baseline.
@@ -11130,9 +11148,9 @@ module Aws::SSM
11130
11148
  # A description of the patch baseline.
11131
11149
  #
11132
11150
  # @option params [Array<Types::PatchSource>] :sources
11133
- # Information about the patches to use to update the instances,
11151
+ # Information about the patches to use to update the managed nodes,
11134
11152
  # including target operating systems and source repositories. Applies to
11135
- # Linux instances only.
11153
+ # Linux managed nodes only.
11136
11154
  #
11137
11155
  # @option params [Boolean] :replace
11138
11156
  # If True, then all fields that are required by the CreatePatchBaseline
@@ -11390,7 +11408,7 @@ module Aws::SSM
11390
11408
  params: params,
11391
11409
  config: config)
11392
11410
  context[:gem_name] = 'aws-sdk-ssm'
11393
- context[:gem_version] = '1.123.0'
11411
+ context[:gem_version] = '1.127.0'
11394
11412
  Seahorse::Client::Request.new(handlers, context)
11395
11413
  end
11396
11414