aws-sdk-ssm 1.109.0 → 1.113.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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 98f3b8be27cd4306b6eb5d5b0770326f09467bfd2fb6a1f09d89489f1994860e
4
- data.tar.gz: de289cbd8ac3d1a01fd5f7ab5da37e28209ea608d1d057f8409bcc243343b088
3
+ metadata.gz: 0d2adfd936e87f1e3b137eb5b15ec927370a0fb80a87026483a0b5518174e08a
4
+ data.tar.gz: 3ff7c6174bc5e9c2b69309f37b7deefee00842a74ba0543dac2403bbac8f04a5
5
5
  SHA512:
6
- metadata.gz: fb5f748bb58c7e69d6635099fcb71b68dda928ef2af83262fcab9cfa7ad54c3643a00f03a7dbdf401eb187597776ac054cb2e3128c43bfe54abc9b5213c86ec5
7
- data.tar.gz: d9b30e15f9c075970c02af0b4d894daf53532deeac68bfdebc96fd32f14daf2cefdc95143a66b2fb6239db9e8eb08d26f781931be6f159a5b45a10bb651895b0
6
+ metadata.gz: cab85b1954548ce8468421928edb1941944a56deff74c211f81484e0e008185c0dceb79795a91e29abdf071a83dc1eee9041a9c50b6468f90b0ff1fc4c73c71f
7
+ data.tar.gz: 06db2b1969b9fcd5dcf6bf01d3fd605dd79fb778dd701c53285ead43bd91061e348ca7c78203b2bd11e039586e623f887f474edb49cc5618b0e467a06a4483f5
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.113.0 (2021-07-28)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.112.0 (2021-07-13)
10
+ ------------------
11
+
12
+ * Feature - Changes to OpsCenter APIs to support a new feature, operational insights.
13
+
14
+ 1.111.0 (2021-06-03)
15
+ ------------------
16
+
17
+ * Feature - Documentation updates for ssm to fix customer reported issue
18
+
19
+ 1.110.0 (2021-05-10)
20
+ ------------------
21
+
22
+ * Feature - This release adds new APIs to associate, disassociate and list related items in SSM OpsCenter; and this release adds DisplayName as a version-level attribute for SSM Documents and introduces two new document types: ProblemAnalysis, ProblemAnalysisTemplate.
23
+
4
24
  1.109.0 (2021-05-06)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.109.0
1
+ 1.113.0
data/lib/aws-sdk-ssm.rb CHANGED
@@ -49,6 +49,6 @@ require_relative 'aws-sdk-ssm/customizations'
49
49
  # @!group service
50
50
  module Aws::SSM
51
51
 
52
- GEM_VERSION = '1.109.0'
52
+ GEM_VERSION = '1.113.0'
53
53
 
54
54
  end
@@ -345,8 +345,18 @@ module Aws::SSM
345
345
  # and an optional value, both of which you define. For example, you
346
346
  # could define a set of tags for your account's managed instances that
347
347
  # helps you track each instance's owner and stack level. For example:
348
- # Key=Owner and Value=DbAdmin, SysAdmin, or Dev. Or Key=Stack and
349
- # Value=Production, Pre-Production, or Test.
348
+ #
349
+ # * `Key=Owner,Value=DbAdmin`
350
+ #
351
+ # * `Key=Owner,Value=SysAdmin`
352
+ #
353
+ # * `Key=Owner,Value=Dev`
354
+ #
355
+ # * `Key=Stack,Value=Production`
356
+ #
357
+ # * `Key=Stack,Value=Pre-Production`
358
+ #
359
+ # * `Key=Stack,Value=Test`
350
360
  #
351
361
  # Each resource can have a maximum of 50 tags.
352
362
  #
@@ -356,8 +366,9 @@ module Aws::SSM
356
366
  # resources based on the tags you add. Tags don't have any semantic
357
367
  # meaning to and are interpreted strictly as a string of characters.
358
368
  #
359
- # For more information about using tags with EC2 instances, see [Tagging
360
- # your Amazon EC2 resources][1] in the *Amazon EC2 User Guide*.
369
+ # For more information about using tags with Amazon Elastic Compute
370
+ # Cloud (Amazon EC2) instances, see [Tagging your Amazon EC2
371
+ # resources][1] in the *Amazon EC2 User Guide*.
361
372
  #
362
373
  #
363
374
  #
@@ -366,9 +377,10 @@ module Aws::SSM
366
377
  # @option params [required, String] :resource_type
367
378
  # Specifies the type of resource you are tagging.
368
379
  #
369
- # <note markdown="1"> The ManagedInstance type for this API action is for on-premises
380
+ # <note markdown="1"> The `ManagedInstance` type for this API operation is for on-premises
370
381
  # managed instances. You must specify the name of the managed instance
371
- # in the following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
382
+ # in the following format: `mi-ID_number `. For example,
383
+ # `mi-1a2b3c4d5e6f`.
372
384
  #
373
385
  # </note>
374
386
  #
@@ -377,13 +389,11 @@ module Aws::SSM
377
389
  #
378
390
  # Use the ID of the resource. Here are some examples:
379
391
  #
380
- # ManagedInstance: mi-012345abcde
381
- #
382
- # MaintenanceWindow: mw-012345abcde
392
+ # `MaintenanceWindow`\: `mw-012345abcde`
383
393
  #
384
- # PatchBaseline: pb-012345abcde
394
+ # `PatchBaseline`\: `pb-012345abcde`
385
395
  #
386
- # OpsMetadata object: `ResourceID` for tagging is created from the
396
+ # `OpsMetadata` object: `ResourceID` for tagging is created from the
387
397
  # Amazon Resource Name (ARN) for the object. Specifically, `ResourceID`
388
398
  # is created from the strings that come after the word `opsmetadata` in
389
399
  # the ARN. For example, an OpsMetadata object with an ARN of
@@ -391,18 +401,22 @@ module Aws::SSM
391
401
  # has a `ResourceID` of either `aws/ssm/MyGroup/appmanager` or
392
402
  # `/aws/ssm/MyGroup/appmanager`.
393
403
  #
394
- # For the Document and Parameter values, use the name of the resource.
404
+ # For the `Document` and `Parameter` values, use the name of the
405
+ # resource.
395
406
  #
396
- # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
397
- # managed instances. You must specify the name of the managed instance
398
- # in the following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
407
+ # `ManagedInstance`\: `mi-012345abcde`
408
+ #
409
+ # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
410
+ # on-premises managed instances. You must specify the name of the
411
+ # managed instance in the following format: `mi-ID_number `. For
412
+ # example, `mi-1a2b3c4d5e6f`.
399
413
  #
400
414
  # </note>
401
415
  #
402
416
  # @option params [required, Array<Types::Tag>] :tags
403
417
  # One or more tags. The value parameter is required.
404
418
  #
405
- # Do not enter personally identifiable information in this field.
419
+ # Don't enter personally identifiable information in this field.
406
420
  #
407
421
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
408
422
  #
@@ -428,6 +442,60 @@ module Aws::SSM
428
442
  req.send_request(options)
429
443
  end
430
444
 
445
+ # Associates a related resource to a Systems Manager OpsCenter OpsItem.
446
+ # For example, you can associate an Incident Manager incident or
447
+ # analysis with an OpsItem. Incident Manager is a capability of Amazon
448
+ # Web Services Systems Manager.
449
+ #
450
+ # @option params [required, String] :ops_item_id
451
+ # The ID of the OpsItem to which you want to associate a resource as a
452
+ # related item.
453
+ #
454
+ # @option params [required, String] :association_type
455
+ # The type of association that you want to create between an OpsItem and
456
+ # a resource. OpsCenter supports `IsParentOf` and `RelatesTo`
457
+ # association types.
458
+ #
459
+ # @option params [required, String] :resource_type
460
+ # The type of resource that you want to associate with an OpsItem.
461
+ # OpsCenter supports the following types:
462
+ #
463
+ # `AWS::SSMIncidents::IncidentRecord`\: an Incident Manager incident.
464
+ # Incident Manager is a capability of Amazon Web Services Systems
465
+ # Manager.
466
+ #
467
+ # `AWS::SSM::Document`\: a Systems Manager (SSM) document.
468
+ #
469
+ # @option params [required, String] :resource_uri
470
+ # The Amazon Resource Name (ARN) of the Amazon Web Services resource
471
+ # that you want to associate with the OpsItem.
472
+ #
473
+ # @return [Types::AssociateOpsItemRelatedItemResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
474
+ #
475
+ # * {Types::AssociateOpsItemRelatedItemResponse#association_id #association_id} => String
476
+ #
477
+ # @example Request syntax with placeholder values
478
+ #
479
+ # resp = client.associate_ops_item_related_item({
480
+ # ops_item_id: "OpsItemId", # required
481
+ # association_type: "OpsItemRelatedItemAssociationType", # required
482
+ # resource_type: "OpsItemRelatedItemAssociationResourceType", # required
483
+ # resource_uri: "OpsItemRelatedItemAssociationResourceUri", # required
484
+ # })
485
+ #
486
+ # @example Response structure
487
+ #
488
+ # resp.association_id #=> String
489
+ #
490
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/AssociateOpsItemRelatedItem AWS API Documentation
491
+ #
492
+ # @overload associate_ops_item_related_item(params = {})
493
+ # @param [Hash] params ({})
494
+ def associate_ops_item_related_item(params = {}, options = {})
495
+ req = build_request(:associate_ops_item_related_item, params)
496
+ req.send_request(options)
497
+ end
498
+
431
499
  # Attempts to cancel the command specified by the Command ID. There is
432
500
  # no guarantee that the command will be terminated and the underlying
433
501
  # process stopped.
@@ -459,8 +527,8 @@ module Aws::SSM
459
527
  end
460
528
 
461
529
  # Stops a maintenance window execution that is already in progress and
462
- # cancels any tasks in the window that have not already starting
463
- # running. (Tasks already in progress will continue to completion.)
530
+ # cancels any tasks in the window that haven't already starting
531
+ # running. Tasks already in progress will continue to completion.
464
532
  #
465
533
  # @option params [required, String] :window_execution_id
466
534
  # The ID of the maintenance window execution to stop.
@@ -489,18 +557,19 @@ module Aws::SSM
489
557
  end
490
558
 
491
559
  # Generates an activation code and activation ID you can use to register
492
- # your on-premises server or virtual machine (VM) with Systems Manager.
493
- # Registering these machines with Systems Manager makes it possible to
494
- # manage them using Systems Manager capabilities. You use the activation
495
- # code and ID when installing SSM Agent on machines in your hybrid
496
- # environment. For more information about requirements for managing
497
- # on-premises instances and VMs using Systems Manager, see [Setting up
498
- # AWS Systems Manager for hybrid environments][1] in the *AWS Systems
560
+ # your on-premises server or virtual machine (VM) with Amazon Web
561
+ # Services Systems Manager. Registering these machines with Systems
562
+ # Manager makes it possible to manage them using Systems Manager
563
+ # capabilities. You use the activation code and ID when installing SSM
564
+ # Agent on machines in your hybrid environment. For more information
565
+ # about requirements for managing on-premises instances and VMs using
566
+ # Systems Manager, see [Setting up Amazon Web Services Systems Manager
567
+ # for hybrid environments][1] in the *Amazon Web Services Systems
499
568
  # Manager User Guide*.
500
569
  #
501
570
  # <note markdown="1"> On-premises servers or VMs that are registered with Systems Manager
502
- # and EC2 instances that you manage with Systems Manager are all called
503
- # *managed instances*.
571
+ # and Amazon Elastic Compute Cloud (Amazon EC2) instances that you
572
+ # manage with Systems Manager are all called *managed instances*.
504
573
  #
505
574
  # </note>
506
575
  #
@@ -512,22 +581,22 @@ module Aws::SSM
512
581
  # A user-defined description of the resource that you want to register
513
582
  # with Systems Manager.
514
583
  #
515
- # Do not enter personally identifiable information in this field.
584
+ # Don't enter personally identifiable information in this field.
516
585
  #
517
586
  # @option params [String] :default_instance_name
518
587
  # The name of the registered, managed instance as it will appear in the
519
- # Systems Manager console or when you use the AWS command line tools to
520
- # list Systems Manager resources.
588
+ # Amazon Web Services Systems Manager console or when you use the Amazon
589
+ # Web Services command line tools to list Systems Manager resources.
521
590
  #
522
- # Do not enter personally identifiable information in this field.
591
+ # Don't enter personally identifiable information in this field.
523
592
  #
524
593
  # @option params [required, String] :iam_role
525
- # The Amazon Identity and Access Management (IAM) role that you want to
526
- # assign to the managed instance. This IAM role must provide AssumeRole
527
- # permissions for the Systems Manager service principal
528
- # `ssm.amazonaws.com`. For more information, see [Create an IAM service
529
- # role for a hybrid environment][1] in the *AWS Systems Manager User
530
- # Guide*.
594
+ # The Identity and Access Management (IAM) role that you want to assign
595
+ # to the managed instance. This IAMrole must provide AssumeRole
596
+ # permissions for the Amazon Web Services Systems Manager service
597
+ # principal `ssm.amazonaws.com`. For more information, see [Create an
598
+ # IAM service role for a hybrid environment][1] in the *Amazon Web
599
+ # Services Systems Manager User Guide*.
531
600
  #
532
601
  #
533
602
  #
@@ -535,7 +604,7 @@ module Aws::SSM
535
604
  #
536
605
  # @option params [Integer] :registration_limit
537
606
  # Specify the maximum number of managed instances you want to register.
538
- # The default value is 1 instance.
607
+ # The default value is `1`.
539
608
  #
540
609
  # @option params [Time,DateTime,Date,Integer,String] :expiration_date
541
610
  # The date by which this activation request should expire, in timestamp
@@ -549,7 +618,7 @@ module Aws::SSM
549
618
  # environment. For example, you might want to tag an activation to
550
619
  # identify which servers or virtual machines (VMs) in your on-premises
551
620
  # environment you intend to activate. In this case, you could specify
552
- # the following key name/value pairs:
621
+ # the following key-value pairs:
553
622
  #
554
623
  # * `Key=OS,Value=Windows`
555
624
  #
@@ -563,11 +632,11 @@ module Aws::SSM
563
632
  # You can't add tags to or delete tags from an existing activation. You
564
633
  # can tag your on-premises servers and VMs after they connect to Systems
565
634
  # Manager for the first time and are assigned a managed instance ID.
566
- # This means they are listed in the AWS Systems Manager console with an
567
- # ID that is prefixed with "mi-". For information about how to add
568
- # tags to your managed instances, see AddTagsToResource. For information
569
- # about how to remove tags from your managed instances, see
570
- # RemoveTagsFromResource.
635
+ # This means they are listed in the Amazon Web Services Systems Manager
636
+ # console with an ID that is prefixed with "mi-". For information
637
+ # about how to add tags to your managed instances, see
638
+ # AddTagsToResource. For information about how to remove tags from your
639
+ # managed instances, see RemoveTagsFromResource.
571
640
  #
572
641
  # @return [Types::CreateActivationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
573
642
  #
@@ -609,26 +678,28 @@ module Aws::SSM
609
678
  # that anti-virus software must be installed and running on your
610
679
  # instances, or that certain ports must be closed. For static targets,
611
680
  # the association specifies a schedule for when the configuration is
612
- # reapplied. For dynamic targets, such as an AWS Resource Group or an
613
- # AWS Autoscaling Group, State Manager applies the configuration when
614
- # new instances are added to the group. The association also specifies
615
- # actions to take when applying the configuration. For example, an
616
- # association for anti-virus software might run once a day. If the
617
- # software is not installed, then State Manager installs it. If the
618
- # software is installed, but the service is not running, then the
619
- # association might instruct State Manager to start the service.
681
+ # reapplied. For dynamic targets, such as an Amazon Web Services
682
+ # resource group or an Amazon Web Services autoscaling group, State
683
+ # Manager, a capability of Amazon Web Services Systems Manager applies
684
+ # the configuration when new instances are added to the group. The
685
+ # association also specifies actions to take when applying the
686
+ # configuration. For example, an association for anti-virus software
687
+ # might run once a day. If the software isn't installed, then State
688
+ # Manager installs it. If the software is installed, but the service
689
+ # isn't running, then the association might instruct State Manager to
690
+ # start the service.
620
691
  #
621
692
  # @option params [required, String] :name
622
- # The name of the SSM document that contains the configuration
623
- # information for the instance. You can specify Command or Automation
624
- # documents.
693
+ # The name of the SSM Command document or Automation runbook that
694
+ # contains the configuration information for the instance.
625
695
  #
626
- # You can specify AWS-predefined documents, documents you created, or a
627
- # document that is shared with you from another account.
696
+ # You can specify Amazon Web Services-predefined documents, documents
697
+ # you created, or a document that is shared with you from another
698
+ # account.
628
699
  #
629
- # For SSM documents that are shared with you from other AWS accounts,
630
- # you must specify the complete SSM document ARN, in the following
631
- # format:
700
+ # For Systems Manager documents (SSM documents) that are shared with you
701
+ # from other accounts, you must specify the complete SSM document ARN,
702
+ # in the following format:
632
703
  #
633
704
  # `arn:partition:ssm:region:account-id:document/document-name `
634
705
  #
@@ -636,9 +707,9 @@ module Aws::SSM
636
707
  #
637
708
  # `arn:aws:ssm:us-east-2:12345678912:document/My-Shared-Document`
638
709
  #
639
- # For AWS-predefined documents and SSM documents you created in your
640
- # account, you only need to specify the document name. For example,
641
- # `AWS-ApplyPatchBaseline` or `My-Document`.
710
+ # For Amazon Web Services-predefined documents and SSM documents you
711
+ # created in your account, you only need to specify the document name.
712
+ # For example, `AWS-ApplyPatchBaseline` or `My-Document`.
642
713
  #
643
714
  # @option params [String] :document_version
644
715
  # The document version you want to associate with the target(s). Can be
@@ -649,12 +720,12 @@ module Aws::SSM
649
720
  #
650
721
  # <note markdown="1"> `InstanceId` has been deprecated. To specify an instance ID for an
651
722
  # association, use the `Targets` parameter. Requests that include the
652
- # parameter `InstanceID` with SSM documents that use schema version 2.0
653
- # or later will fail. In addition, if you use the parameter
654
- # `InstanceId`, you cannot use the parameters `AssociationName`,
655
- # `DocumentVersion`, `MaxErrors`, `MaxConcurrency`, `OutputLocation`, or
656
- # `ScheduleExpression`. To use these parameters, you must use the
657
- # `Targets` parameter.
723
+ # parameter `InstanceID` with Systems Manager documents (SSM documents)
724
+ # that use schema version 2.0 or later will fail. In addition, if you
725
+ # use the parameter `InstanceId`, you can't use the parameters
726
+ # `AssociationName`, `DocumentVersion`, `MaxErrors`, `MaxConcurrency`,
727
+ # `OutputLocation`, or `ScheduleExpression`. To use these parameters,
728
+ # you must use the `Targets` parameter.
658
729
  #
659
730
  # </note>
660
731
  #
@@ -663,10 +734,11 @@ module Aws::SSM
663
734
  #
664
735
  # @option params [Array<Types::Target>] :targets
665
736
  # The targets for the association. You can target instances by using
666
- # tags, AWS Resource Groups, all instances in an AWS account, or
667
- # individual instance IDs. For more information about choosing targets
668
- # for an association, see [Using targets and rate controls with State
669
- # Manager associations][1] in the *AWS Systems Manager User Guide*.
737
+ # tags, Amazon Web Services resource groups, all instances in an
738
+ # account, or individual instance IDs. For more information about
739
+ # choosing targets for an association, see [Using targets and rate
740
+ # controls with State Manager associations][1] in the *Amazon Web
741
+ # Services Systems Manager User Guide*.
670
742
  #
671
743
  #
672
744
  #
@@ -677,16 +749,17 @@ module Aws::SSM
677
749
  # target(s).
678
750
  #
679
751
  # @option params [Types::InstanceAssociationOutputLocation] :output_location
680
- # An S3 bucket where you want to store the output details of the
681
- # request.
752
+ # An Amazon Simple Storage Service (Amazon S3) bucket where you want to
753
+ # store the output details of the request.
682
754
  #
683
755
  # @option params [String] :association_name
684
756
  # Specify a descriptive name for the association.
685
757
  #
686
758
  # @option params [String] :automation_target_parameter_name
687
759
  # Specify the target for the association. This target is required for
688
- # associations that use an Automation document and target resources by
689
- # using rate controls.
760
+ # associations that use an Automation runbook and target resources by
761
+ # using rate controls. Automation is a capability of Amazon Web Services
762
+ # Systems Manager.
690
763
  #
691
764
  # @option params [String] :max_errors
692
765
  # The number of errors that are allowed before the system stops sending
@@ -696,13 +769,13 @@ module Aws::SSM
696
769
  # system stops sending requests when the fourth error is received. If
697
770
  # you specify 0, then the system stops sending requests after the first
698
771
  # error is returned. If you run an association on 50 instances and set
699
- # MaxError to 10%, then the system stops sending the request when the
772
+ # `MaxError` to 10%, then the system stops sending the request when the
700
773
  # sixth error is received.
701
774
  #
702
- # Executions that are already running an association when MaxErrors is
775
+ # Executions that are already running an association when `MaxErrors` is
703
776
  # reached are allowed to complete, but some of these executions may fail
704
777
  # as well. If you need to ensure that there won't be more than
705
- # max-errors failed executions, set MaxConcurrency to 1 so that
778
+ # max-errors failed executions, set `MaxConcurrency` to 1 so that
706
779
  # executions proceed one at a time.
707
780
  #
708
781
  # @option params [String] :max_concurrency
@@ -712,10 +785,10 @@ module Aws::SSM
712
785
  # means all targets run the association at the same time.
713
786
  #
714
787
  # If a new instance starts and attempts to run an association while
715
- # Systems Manager is running MaxConcurrency associations, the
788
+ # Systems Manager is running `MaxConcurrency` associations, the
716
789
  # association is allowed to run. During the next association interval,
717
790
  # the new instance will process its association within the limit
718
- # specified for MaxConcurrency.
791
+ # specified for `MaxConcurrency`.
719
792
  #
720
793
  # @option params [String] :compliance_severity
721
794
  # The severity level to assign to the association.
@@ -729,9 +802,9 @@ module Aws::SSM
729
802
  # the association is `NON-COMPLIANT`.
730
803
  #
731
804
  # In `MANUAL` mode, you must specify the `AssociationId` as a parameter
732
- # for the PutComplianceItems API action. In this case, compliance data
733
- # is not managed by State Manager. It is managed by your direct call to
734
- # the PutComplianceItems API action.
805
+ # for the PutComplianceItems API operation. In this case, compliance
806
+ # data isn't managed by State Manager. It is managed by your direct
807
+ # call to the PutComplianceItems API operation.
735
808
  #
736
809
  # By default, all associations use `AUTO` mode.
737
810
  #
@@ -739,23 +812,23 @@ module Aws::SSM
739
812
  # By default, when you create a new association, the system runs it
740
813
  # immediately after it is created and then according to the schedule you
741
814
  # specified. Specify this option if you don't want an association to
742
- # run immediately after you create it. This parameter is not supported
815
+ # run immediately after you create it. This parameter isn't supported
743
816
  # for rate expressions.
744
817
  #
745
818
  # @option params [Array<String>] :calendar_names
746
- # The names or Amazon Resource Names (ARNs) of the Systems Manager
747
- # Change Calendar type documents you want to gate your associations
748
- # under. The associations only run when that Change Calendar is open.
749
- # For more information, see [AWS Systems Manager Change Calendar][1].
819
+ # The names or Amazon Resource Names (ARNs) of the Change Calendar type
820
+ # documents you want to gate your associations under. The associations
821
+ # only run when that change calendar is open. For more information, see
822
+ # [Amazon Web Services Systems Manager Change Calendar][1].
750
823
  #
751
824
  #
752
825
  #
753
826
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar
754
827
  #
755
828
  # @option params [Array<Types::TargetLocation>] :target_locations
756
- # A location is a combination of AWS Regions and AWS accounts where you
757
- # want to run the association. Use this action to create an association
758
- # in multiple Regions and multiple accounts.
829
+ # A location is a combination of Regions and accounts where you want to
830
+ # run the association. Use this action to create an association in
831
+ # multiple Regions and multiple accounts.
759
832
  #
760
833
  # @return [Types::CreateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
761
834
  #
@@ -860,12 +933,13 @@ module Aws::SSM
860
933
  req.send_request(options)
861
934
  end
862
935
 
863
- # Associates the specified Systems Manager document with the specified
864
- # instances or targets.
936
+ # Associates the specified Amazon Web Services Systems Manager document
937
+ # (SSM document) with the specified instances or targets.
865
938
  #
866
939
  # When you associate a document with one or more instances using
867
- # instance IDs or tags, SSM Agent running on the instance processes the
868
- # document and configures the instance as specified.
940
+ # instance IDs or tags, Amazon Web Services Systems Manager Agent (SSM
941
+ # Agent) running on the instance processes the document and configures
942
+ # the instance as specified.
869
943
  #
870
944
  # If you associate a document with an instance that already has an
871
945
  # associated document, the system returns the AssociationAlreadyExists
@@ -1017,11 +1091,12 @@ module Aws::SSM
1017
1091
  req.send_request(options)
1018
1092
  end
1019
1093
 
1020
- # Creates a Systems Manager (SSM) document. An SSM document defines the
1021
- # actions that Systems Manager performs on your managed instances. For
1022
- # more information about SSM documents, including information about
1023
- # supported schemas, features, and syntax, see [AWS Systems Manager
1024
- # Documents][1] in the *AWS Systems Manager User Guide*.
1094
+ # Creates a Amazon Web Services Systems Manager (SSM document). An SSM
1095
+ # document defines the actions that Systems Manager performs on your
1096
+ # managed instances. For more information about SSM documents, including
1097
+ # information about supported schemas, features, and syntax, see [Amazon
1098
+ # Web Services Systems Manager Documents][1] in the *Amazon Web Services
1099
+ # Systems Manager User Guide*.
1025
1100
  #
1026
1101
  #
1027
1102
  #
@@ -1032,12 +1107,12 @@ module Aws::SSM
1032
1107
  # recommend storing the contents for your new document in an external
1033
1108
  # JSON or YAML file and referencing the file in a command.
1034
1109
  #
1035
- # For examples, see the following topics in the *AWS Systems Manager
1036
- # User Guide*.
1110
+ # For examples, see the following topics in the *Amazon Web Services
1111
+ # Systems Manager User Guide*.
1037
1112
  #
1038
- # * [Create an SSM document (AWS API)][1]
1113
+ # * [Create an SSM document (Amazon Web Services API)][1]
1039
1114
  #
1040
- # * [Create an SSM document (AWS CLI)][2]
1115
+ # * [Create an SSM document (Amazon Web Services CLI)][2]
1041
1116
  #
1042
1117
  # * [Create an SSM document (API)][1]
1043
1118
  #
@@ -1048,27 +1123,27 @@ module Aws::SSM
1048
1123
  #
1049
1124
  # @option params [Array<Types::DocumentRequires>] :requires
1050
1125
  # A list of SSM documents required by a document. This parameter is used
1051
- # exclusively by AWS AppConfig. When a user creates an AppConfig
1126
+ # exclusively by AppConfig. When a user creates an AppConfig
1052
1127
  # configuration in an SSM document, the user must also specify a
1053
1128
  # required document for validation purposes. In this case, an
1054
1129
  # `ApplicationConfiguration` document requires an
1055
1130
  # `ApplicationConfigurationSchema` document for validation purposes. For
1056
- # more information, see [AWS AppConfig][1] in the *AWS Systems Manager
1057
- # User Guide*.
1131
+ # more information, see [What is AppConfig?][1] in the *AppConfig User
1132
+ # Guide*.
1058
1133
  #
1059
1134
  #
1060
1135
  #
1061
- # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/appconfig.html
1136
+ # [1]: https://docs.aws.amazon.com/appconfig/latest/userguide/what-is-appconfig.html
1062
1137
  #
1063
1138
  # @option params [Array<Types::AttachmentsSource>] :attachments
1064
- # A list of key and value pairs that describe attachments to a version
1065
- # of a document.
1139
+ # A list of key-value pairs that describe attachments to a version of a
1140
+ # document.
1066
1141
  #
1067
1142
  # @option params [required, String] :name
1068
- # A name for the Systems Manager document.
1143
+ # A name for the SSM document.
1069
1144
  #
1070
1145
  # You can't use the following strings as document name prefixes. These
1071
- # are reserved by AWS for use as document name prefixes:
1146
+ # are reserved by Amazon Web Services for use as document name prefixes:
1072
1147
  #
1073
1148
  # * `aws-`
1074
1149
  #
@@ -1076,10 +1151,16 @@ module Aws::SSM
1076
1151
  #
1077
1152
  # * `amzn`
1078
1153
  #
1154
+ # @option params [String] :display_name
1155
+ # An optional field where you can specify a friendly name for the SSM
1156
+ # document. This value can differ for each version of the document. You
1157
+ # can update this value at a later time using the UpdateDocument
1158
+ # operation.
1159
+ #
1079
1160
  # @option params [String] :version_name
1080
1161
  # An optional field specifying the version of the artifact you are
1081
1162
  # creating with the document. For example, "Release 12, Update 6".
1082
- # This value is unique across all versions of a document, and cannot be
1163
+ # This value is unique across all versions of a document, and can't be
1083
1164
  # changed.
1084
1165
  #
1085
1166
  # @option params [String] :document_type
@@ -1092,29 +1173,29 @@ module Aws::SSM
1092
1173
  # @option params [String] :target_type
1093
1174
  # Specify a target type to define the kinds of resources the document
1094
1175
  # can run on. For example, to run a document on EC2 instances, specify
1095
- # the following value: /AWS::EC2::Instance. If you specify a value of
1176
+ # the following value: `/AWS::EC2::Instance`. If you specify a value of
1096
1177
  # '/' the document can run on all types of resources. If you don't
1097
1178
  # specify a value, the document can't run on any resources. For a list
1098
- # of valid resource types, see [AWS resource and property types
1099
- # reference][1] in the *AWS CloudFormation User Guide*.
1179
+ # of valid resource types, see [Amazon Web Services resource and
1180
+ # property types reference][1] in the *CloudFormation User Guide*.
1100
1181
  #
1101
1182
  #
1102
1183
  #
1103
- # [1]: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html
1184
+ # [1]: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html
1104
1185
  #
1105
1186
  # @option params [Array<Types::Tag>] :tags
1106
1187
  # Optional metadata that you assign to a resource. Tags enable you to
1107
1188
  # categorize a resource in different ways, such as by purpose, owner, or
1108
1189
  # environment. For example, you might want to tag an SSM document to
1109
1190
  # identify the types of targets or the environment where it will run. In
1110
- # this case, you could specify the following key name/value pairs:
1191
+ # this case, you could specify the following key-value pairs:
1111
1192
  #
1112
1193
  # * `Key=OS,Value=Windows`
1113
1194
  #
1114
1195
  # * `Key=Environment,Value=Production`
1115
1196
  #
1116
1197
  # <note markdown="1"> To add tags to an existing SSM document, use the AddTagsToResource
1117
- # action.
1198
+ # operation.
1118
1199
  #
1119
1200
  # </note>
1120
1201
  #
@@ -1140,8 +1221,9 @@ module Aws::SSM
1140
1221
  # },
1141
1222
  # ],
1142
1223
  # name: "DocumentName", # required
1224
+ # display_name: "DocumentDisplayName",
1143
1225
  # version_name: "DocumentVersionName",
1144
- # document_type: "Command", # accepts Command, Policy, Automation, Session, Package, ApplicationConfiguration, ApplicationConfigurationSchema, DeploymentStrategy, ChangeCalendar, Automation.ChangeTemplate
1226
+ # document_type: "Command", # accepts Command, Policy, Automation, Session, Package, ApplicationConfiguration, ApplicationConfigurationSchema, DeploymentStrategy, ChangeCalendar, Automation.ChangeTemplate, ProblemAnalysis, ProblemAnalysisTemplate
1145
1227
  # document_format: "YAML", # accepts YAML, JSON, TEXT
1146
1228
  # target_type: "TargetType",
1147
1229
  # tags: [
@@ -1158,6 +1240,7 @@ module Aws::SSM
1158
1240
  # resp.document_description.hash #=> String
1159
1241
  # resp.document_description.hash_type #=> String, one of "Sha256", "Sha1"
1160
1242
  # resp.document_description.name #=> String
1243
+ # resp.document_description.display_name #=> String
1161
1244
  # resp.document_description.version_name #=> String
1162
1245
  # resp.document_description.owner #=> String
1163
1246
  # resp.document_description.created_date #=> Time
@@ -1172,7 +1255,7 @@ module Aws::SSM
1172
1255
  # resp.document_description.parameters[0].default_value #=> String
1173
1256
  # resp.document_description.platform_types #=> Array
1174
1257
  # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux"
1175
- # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate"
1258
+ # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
1176
1259
  # resp.document_description.schema_version #=> String
1177
1260
  # resp.document_description.latest_version #=> String
1178
1261
  # resp.document_description.default_version #=> String
@@ -1226,12 +1309,12 @@ module Aws::SSM
1226
1309
  #
1227
1310
  # @option params [String] :start_date
1228
1311
  # The date and time, in ISO-8601 Extended format, for when you want the
1229
- # maintenance window to become active. StartDate allows you to delay
1312
+ # maintenance window to become active. `StartDate` allows you to delay
1230
1313
  # activation of the maintenance window until the specified future date.
1231
1314
  #
1232
1315
  # @option params [String] :end_date
1233
1316
  # The date and time, in ISO-8601 Extended format, for when you want the
1234
- # maintenance window to become inactive. EndDate allows you to set a
1317
+ # maintenance window to become inactive. `EndDate` allows you to set a
1235
1318
  # date and time in the future when the maintenance window will no longer
1236
1319
  # run.
1237
1320
  #
@@ -1250,7 +1333,7 @@ module Aws::SSM
1250
1333
  # [1]: https://www.iana.org/time-zones
1251
1334
  #
1252
1335
  # @option params [Integer] :schedule_offset
1253
- # The number of days to wait after the date and time specified by a CRON
1336
+ # The number of days to wait after the date and time specified by a cron
1254
1337
  # expression before running the maintenance window.
1255
1338
  #
1256
1339
  # For example, the following cron expression schedules a maintenance
@@ -1266,11 +1349,12 @@ module Aws::SSM
1266
1349
  #
1267
1350
  # @option params [required, Integer] :cutoff
1268
1351
  # The number of hours before the end of the maintenance window that
1269
- # Systems Manager stops scheduling new tasks for execution.
1352
+ # Amazon Web Services Systems Manager stops scheduling new tasks for
1353
+ # execution.
1270
1354
  #
1271
1355
  # @option params [required, Boolean] :allow_unassociated_targets
1272
1356
  # Enables a maintenance window task to run on managed instances, even if
1273
- # you have not registered those instances as targets. If enabled, then
1357
+ # you haven't registered those instances as targets. If enabled, then
1274
1358
  # you must specify the unregistered instances (by instance ID) when you
1275
1359
  # register a task with the maintenance window.
1276
1360
  #
@@ -1290,7 +1374,7 @@ module Aws::SSM
1290
1374
  # environment. For example, you might want to tag a maintenance window
1291
1375
  # to identify the type of tasks it will run, the types of targets, and
1292
1376
  # the environment it will run in. In this case, you could specify the
1293
- # following key name/value pairs:
1377
+ # following key-value pairs:
1294
1378
  #
1295
1379
  # * `Key=TaskType,Value=AgentUpdate`
1296
1380
  #
@@ -1299,7 +1383,7 @@ module Aws::SSM
1299
1383
  # * `Key=Environment,Value=Production`
1300
1384
  #
1301
1385
  # <note markdown="1"> To add tags to an existing maintenance window, use the
1302
- # AddTagsToResource action.
1386
+ # AddTagsToResource operation.
1303
1387
  #
1304
1388
  # </note>
1305
1389
  #
@@ -1342,16 +1426,17 @@ module Aws::SSM
1342
1426
  req.send_request(options)
1343
1427
  end
1344
1428
 
1345
- # Creates a new OpsItem. You must have permission in AWS Identity and
1346
- # Access Management (IAM) to create a new OpsItem. For more information,
1347
- # see [Getting started with OpsCenter][1] in the *AWS Systems Manager
1348
- # User Guide*.
1429
+ # Creates a new OpsItem. You must have permission in Identity and Access
1430
+ # Management (IAM) to create a new OpsItem. For more information, see
1431
+ # [Getting started with OpsCenter][1] in the *Amazon Web Services
1432
+ # Systems Manager User Guide*.
1349
1433
  #
1350
- # Operations engineers and IT professionals use OpsCenter to view,
1351
- # investigate, and remediate operational issues impacting the
1352
- # performance and health of their AWS resources. For more information,
1353
- # see [AWS Systems Manager OpsCenter][2] in the *AWS Systems Manager
1354
- # User Guide*.
1434
+ # Operations engineers and IT professionals use Amazon Web Services
1435
+ # Systems Manager OpsCenter to view, investigate, and remediate
1436
+ # operational issues impacting the performance and health of their
1437
+ # Amazon Web Services resources. For more information, see [Amazon Web
1438
+ # Services Systems Manager OpsCenter][2] in the *Amazon Web Services
1439
+ # Systems Manager User Guide*.
1355
1440
  #
1356
1441
  #
1357
1442
  #
@@ -1372,22 +1457,23 @@ module Aws::SSM
1372
1457
  # You enter operational data as key-value pairs. The key has a maximum
1373
1458
  # length of 128 characters. The value has a maximum size of 20 KB.
1374
1459
  #
1375
- # Operational data keys *can't* begin with the following: amazon, aws,
1376
- # amzn, ssm, /amazon, /aws, /amzn, /ssm.
1460
+ # Operational data keys *can't* begin with the following: `amazon`,
1461
+ # `aws`, `amzn`, `ssm`, `/amazon`, `/aws`, `/amzn`, `/ssm`.
1377
1462
  #
1378
1463
  # You can choose to make the data searchable by other users in the
1379
1464
  # account or you can restrict search access. Searchable data means that
1380
1465
  # all users with access to the OpsItem Overview page (as provided by the
1381
- # DescribeOpsItems API action) can view and search on the specified
1382
- # data. Operational data that is not searchable is only viewable by
1466
+ # DescribeOpsItems API operation) can view and search on the specified
1467
+ # data. Operational data that isn't searchable is only viewable by
1383
1468
  # users who have access to the OpsItem (as provided by the GetOpsItem
1384
- # API action).
1469
+ # API operation).
1385
1470
  #
1386
1471
  # Use the `/aws/resources` key in OperationalData to specify a related
1387
1472
  # resource in the request. Use the `/aws/automations` key in
1388
1473
  # OperationalData to associate an Automation runbook with the OpsItem.
1389
- # To view AWS CLI example commands that use these keys, see [Creating
1390
- # OpsItems manually][1] in the *AWS Systems Manager User Guide*.
1474
+ # To view Amazon Web Services CLI example commands that use these keys,
1475
+ # see [Creating OpsItems manually][1] in the *Amazon Web Services
1476
+ # Systems Manager User Guide*.
1391
1477
  #
1392
1478
  #
1393
1479
  #
@@ -1410,8 +1496,8 @@ module Aws::SSM
1410
1496
  # @option params [required, String] :source
1411
1497
  # The origin of the OpsItem, such as Amazon EC2 or Systems Manager.
1412
1498
  #
1413
- # <note markdown="1"> The source name can't contain the following strings: aws, amazon, and
1414
- # amzn.
1499
+ # <note markdown="1"> The source name can't contain the following strings: `aws`, `amazon`,
1500
+ # and `amzn`.
1415
1501
  #
1416
1502
  # </note>
1417
1503
  #
@@ -1423,15 +1509,16 @@ module Aws::SSM
1423
1509
  # Optional metadata that you assign to a resource. You can restrict
1424
1510
  # access to OpsItems by using an inline IAM policy that specifies tags.
1425
1511
  # For more information, see [Getting started with OpsCenter][1] in the
1426
- # *AWS Systems Manager User Guide*.
1512
+ # *Amazon Web Services Systems Manager User Guide*.
1427
1513
  #
1428
1514
  # Tags use a key-value pair. For example:
1429
1515
  #
1430
1516
  # `Key=Department,Value=Finance`
1431
1517
  #
1432
- # <note markdown="1"> To add tags to an existing OpsItem, use the AddTagsToResource action.
1433
- #
1434
- # </note>
1518
+ # To add tags to a new OpsItem, a user must have IAM permissions for
1519
+ # both the `ssm:CreateOpsItems` operation and the
1520
+ # `ssm:AddTagsToResource` operation. To add tags to an existing OpsItem,
1521
+ # use the AddTagsToResource operation.
1435
1522
  #
1436
1523
  #
1437
1524
  #
@@ -1515,9 +1602,9 @@ module Aws::SSM
1515
1602
  req.send_request(options)
1516
1603
  end
1517
1604
 
1518
- # If you create a new application in Application Manager, Systems
1519
- # Manager calls this API action to specify information about the new
1520
- # application, including the application type.
1605
+ # If you create a new application in Application Manager, Amazon Web
1606
+ # Services Systems Manager calls this API operation to specify
1607
+ # information about the new application, including the application type.
1521
1608
  #
1522
1609
  # @option params [required, String] :resource_id
1523
1610
  # A resource ID for a new Application Manager application.
@@ -1530,8 +1617,8 @@ module Aws::SSM
1530
1617
  # maximum of five tags for an OpsMetadata object. Tags enable you to
1531
1618
  # categorize a resource in different ways, such as by purpose, owner, or
1532
1619
  # environment. For example, you might want to tag an OpsMetadata object
1533
- # to identify an environment or target AWS Region. In this case, you
1534
- # could specify the following key-value pairs:
1620
+ # to identify an environment or target Region. In this case, you could
1621
+ # specify the following key-value pairs:
1535
1622
  #
1536
1623
  # * `Key=Environment,Value=Production`
1537
1624
  #
@@ -1573,18 +1660,14 @@ module Aws::SSM
1573
1660
 
1574
1661
  # Creates a patch baseline.
1575
1662
  #
1576
- # <note markdown="1"> For information about valid key and value pairs in `PatchFilters` for
1577
- # each supported operating system type, see [PatchFilter][1].
1663
+ # <note markdown="1"> For information about valid key-value pairs in `PatchFilters` for each
1664
+ # supported operating system type, see PatchFilter.
1578
1665
  #
1579
1666
  # </note>
1580
1667
  #
1581
- #
1582
- #
1583
- # [1]: http://docs.aws.amazon.com/systems-manager/latest/APIReference/API_PatchFilter.html
1584
- #
1585
1668
  # @option params [String] :operating_system
1586
1669
  # Defines the operating system the patch baseline applies to. The
1587
- # Default value is WINDOWS.
1670
+ # default value is `WINDOWS`.
1588
1671
  #
1589
1672
  # @option params [required, String] :name
1590
1673
  # The name of the patch baseline.
@@ -1600,7 +1683,8 @@ module Aws::SSM
1600
1683
  #
1601
1684
  # For information about accepted formats for lists of approved patches
1602
1685
  # and rejected patches, see [About package name formats for approved and
1603
- # rejected patch lists][1] in the *AWS Systems Manager User Guide*.
1686
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
1687
+ # User Guide*.
1604
1688
  #
1605
1689
  #
1606
1690
  #
@@ -1609,19 +1693,20 @@ module Aws::SSM
1609
1693
  # @option params [String] :approved_patches_compliance_level
1610
1694
  # Defines the compliance level for approved patches. When an approved
1611
1695
  # patch is reported as missing, this value describes the severity of the
1612
- # compliance violation. The default value is UNSPECIFIED.
1696
+ # compliance violation. The default value is `UNSPECIFIED`.
1613
1697
  #
1614
1698
  # @option params [Boolean] :approved_patches_enable_non_security
1615
1699
  # Indicates whether the list of approved patches includes non-security
1616
1700
  # updates that should be applied to the instances. The default value is
1617
- # 'false'. Applies to Linux instances only.
1701
+ # `false`. Applies to Linux instances only.
1618
1702
  #
1619
1703
  # @option params [Array<String>] :rejected_patches
1620
1704
  # A list of explicitly rejected patches for the baseline.
1621
1705
  #
1622
1706
  # For information about accepted formats for lists of approved patches
1623
1707
  # and rejected patches, see [About package name formats for approved and
1624
- # rejected patch lists][1] in the *AWS Systems Manager User Guide*.
1708
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
1709
+ # User Guide*.
1625
1710
  #
1626
1711
  #
1627
1712
  #
@@ -1629,19 +1714,20 @@ module Aws::SSM
1629
1714
  #
1630
1715
  # @option params [String] :rejected_patches_action
1631
1716
  # The action for Patch Manager to take on patches included in the
1632
- # RejectedPackages list.
1717
+ # `RejectedPackages` list.
1633
1718
  #
1634
- # * **ALLOW\_AS\_DEPENDENCY**\: A package in the Rejected patches list
1635
- # is installed only if it is a dependency of another package. It is
1636
- # considered compliant with the patch baseline, and its status is
1637
- # reported as *InstalledOther*. This is the default action if no
1638
- # option is specified.
1719
+ # * <b> <code>ALLOW_AS_DEPENDENCY</code> </b>\: A package in the
1720
+ # `Rejected` patches list is installed only if it is a dependency of
1721
+ # another package. It is considered compliant with the patch baseline,
1722
+ # and its status is reported as `InstalledOther`. This is the default
1723
+ # action if no option is specified.
1639
1724
  #
1640
- # * **BLOCK**\: Packages in the RejectedPatches list, and packages that
1641
- # include them as dependencies, are not installed under any
1642
- # circumstances. If a package was installed before it was added to the
1643
- # Rejected patches list, it is considered non-compliant with the patch
1644
- # baseline, and its status is reported as *InstalledRejected*.
1725
+ # * <b> <code>BLOCK</code> </b>\: Packages in the `RejectedPatches`
1726
+ # list, and packages that include them as dependencies, aren't
1727
+ # installed under any circumstances. If a package was installed before
1728
+ # it was added to the Rejected patches list, it is considered
1729
+ # non-compliant with the patch baseline, and its status is reported as
1730
+ # `InstalledRejected`.
1645
1731
  #
1646
1732
  # @option params [String] :description
1647
1733
  # A description of the patch baseline.
@@ -1663,14 +1749,14 @@ module Aws::SSM
1663
1749
  # environment. For example, you might want to tag a patch baseline to
1664
1750
  # identify the severity level of patches it specifies and the operating
1665
1751
  # system family it applies to. In this case, you could specify the
1666
- # following key name/value pairs:
1752
+ # following key-value pairs:
1667
1753
  #
1668
1754
  # * `Key=PatchSeverity,Value=Critical`
1669
1755
  #
1670
1756
  # * `Key=OS,Value=Windows`
1671
1757
  #
1672
1758
  # <note markdown="1"> To add tags to an existing patch baseline, use the AddTagsToResource
1673
- # action.
1759
+ # operation.
1674
1760
  #
1675
1761
  # </note>
1676
1762
  #
@@ -1745,30 +1831,30 @@ module Aws::SSM
1745
1831
  end
1746
1832
 
1747
1833
  # A resource data sync helps you view data from multiple sources in a
1748
- # single location. Systems Manager offers two types of resource data
1749
- # sync: `SyncToDestination` and `SyncFromSource`.
1834
+ # single location. Amazon Web Services Systems Manager offers two types
1835
+ # of resource data sync: `SyncToDestination` and `SyncFromSource`.
1750
1836
  #
1751
1837
  # You can configure Systems Manager Inventory to use the
1752
1838
  # `SyncToDestination` type to synchronize Inventory data from multiple
1753
- # AWS Regions to a single S3 bucket. For more information, see
1754
- # [Configuring Resource Data Sync for Inventory][1] in the *AWS Systems
1755
- # Manager User Guide*.
1839
+ # Regions to a single Amazon Simple Storage Service (Amazon S3) bucket.
1840
+ # For more information, see [Configuring resource data sync for
1841
+ # Inventory][1] in the *Amazon Web Services Systems Manager User Guide*.
1756
1842
  #
1757
1843
  # You can configure Systems Manager Explorer to use the `SyncFromSource`
1758
1844
  # type to synchronize operational work items (OpsItems) and operational
1759
- # data (OpsData) from multiple AWS Regions to a single S3 bucket. This
1760
- # type can synchronize OpsItems and OpsData from multiple AWS accounts
1761
- # and Regions or `EntireOrganization` by using AWS Organizations. For
1762
- # more information, see [Setting up Systems Manager Explorer to display
1763
- # data from multiple accounts and Regions][2] in the *AWS Systems
1764
- # Manager User Guide*.
1845
+ # data (OpsData) from multiple Regions to a single Amazon S3 bucket.
1846
+ # This type can synchronize OpsItems and OpsData from multiple accounts
1847
+ # and Regions or `EntireOrganization` by using Organizations. For more
1848
+ # information, see [Setting up Systems Manager Explorer to display data
1849
+ # from multiple accounts and Regions][2] in the *Amazon Web Services
1850
+ # Systems Manager User Guide*.
1765
1851
  #
1766
1852
  # A resource data sync is an asynchronous operation that returns
1767
1853
  # immediately. After a successful initial sync is completed, the system
1768
1854
  # continuously syncs data. To check the status of a sync, use the
1769
1855
  # ListResourceDataSync.
1770
1856
  #
1771
- # <note markdown="1"> By default, data is not encrypted in Amazon S3. We strongly recommend
1857
+ # <note markdown="1"> By default, data isn't encrypted in Amazon S3. We strongly recommend
1772
1858
  # that you enable encryption in Amazon S3 to ensure secure data storage.
1773
1859
  # We also recommend that you secure access to the Amazon S3 bucket by
1774
1860
  # creating a restrictive bucket policy.
@@ -1792,9 +1878,9 @@ module Aws::SSM
1792
1878
  # synchronizes data to an S3 bucket for Inventory. If you specify
1793
1879
  # `SyncToDestination`, you must provide a value for `S3Destination`.
1794
1880
  # Specify `SyncFromSource` to synchronize data from a single account and
1795
- # multiple Regions, or multiple AWS accounts and Regions, as listed in
1796
- # AWS Organizations for Explorer. If you specify `SyncFromSource`, you
1797
- # must provide a value for `SyncSource`. The default value is
1881
+ # multiple Regions, or multiple accounts and Regions, as listed in
1882
+ # Organizations for Explorer. If you specify `SyncFromSource`, you must
1883
+ # provide a value for `SyncSource`. The default value is
1798
1884
  # `SyncToDestination`.
1799
1885
  #
1800
1886
  # @option params [Types::ResourceDataSyncSource] :sync_source
@@ -1843,9 +1929,9 @@ module Aws::SSM
1843
1929
  req.send_request(options)
1844
1930
  end
1845
1931
 
1846
- # Deletes an activation. You are not required to delete an activation.
1932
+ # Deletes an activation. You aren't required to delete an activation.
1847
1933
  # If you delete an activation, you can no longer use it to register
1848
- # additional managed instances. Deleting an activation does not
1934
+ # additional managed instances. Deleting an activation doesn't
1849
1935
  # de-register managed instances. You must manually de-register managed
1850
1936
  # instances.
1851
1937
  #
@@ -1869,17 +1955,17 @@ module Aws::SSM
1869
1955
  req.send_request(options)
1870
1956
  end
1871
1957
 
1872
- # Disassociates the specified Systems Manager document from the
1873
- # specified instance.
1958
+ # Disassociates the specified Amazon Web Services Systems Manager
1959
+ # document (SSM document) from the specified instance.
1874
1960
  #
1875
- # When you disassociate a document from an instance, it does not change
1961
+ # When you disassociate a document from an instance, it doesn't change
1876
1962
  # the configuration of the instance. To change the configuration state
1877
1963
  # of an instance after you disassociate a document, you must create a
1878
1964
  # new document with the desired configuration and associate it with the
1879
1965
  # instance.
1880
1966
  #
1881
1967
  # @option params [String] :name
1882
- # The name of the Systems Manager document.
1968
+ # The name of the SSM document.
1883
1969
  #
1884
1970
  # @option params [String] :instance_id
1885
1971
  # The ID of the instance.
@@ -1906,8 +1992,8 @@ module Aws::SSM
1906
1992
  req.send_request(options)
1907
1993
  end
1908
1994
 
1909
- # Deletes the Systems Manager document and all instance associations to
1910
- # the document.
1995
+ # Deletes the Amazon Web Services Systems Manager document (SSM
1996
+ # document) and all instance associations to the document.
1911
1997
  #
1912
1998
  # Before you delete the document, we recommend that you use
1913
1999
  # DeleteAssociation to disassociate all instances that are associated
@@ -1928,8 +2014,8 @@ module Aws::SSM
1928
2014
  # Some SSM document types require that you specify a `Force` flag before
1929
2015
  # you can delete the document. For example, you must specify a `Force`
1930
2016
  # flag to delete a document of type `ApplicationConfigurationSchema`.
1931
- # You can restrict access to the `Force` flag in an AWS Identity and
1932
- # Access Management (IAM) policy.
2017
+ # You can restrict access to the `Force` flag in an Identity and Access
2018
+ # Management (IAM) policy.
1933
2019
  #
1934
2020
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1935
2021
  #
@@ -1967,8 +2053,8 @@ module Aws::SSM
1967
2053
  #
1968
2054
  # DisableSchema: If you choose this option, the system ignores all
1969
2055
  # inventory data for the specified version, and any earlier versions. To
1970
- # enable this schema again, you must call the `PutInventory` action for
1971
- # a version greater than the disabled version.
2056
+ # enable this schema again, you must call the `PutInventory` operation
2057
+ # for a version greater than the disabled version.
1972
2058
  #
1973
2059
  # DeleteSchema: This option deletes the specified custom type from the
1974
2060
  # Inventory service. You can recreate the schema later, if you want.
@@ -2153,9 +2239,9 @@ module Aws::SSM
2153
2239
  req.send_request(options)
2154
2240
  end
2155
2241
 
2156
- # Deletes a Resource Data Sync configuration. After the configuration is
2242
+ # Deletes a resource data sync configuration. After the configuration is
2157
2243
  # deleted, changes to data on managed instances are no longer synced to
2158
- # or from the target. Deleting a sync configuration does not delete
2244
+ # or from the target. Deleting a sync configuration doesn't delete
2159
2245
  # data.
2160
2246
  #
2161
2247
  # @option params [required, String] :sync_name
@@ -2253,7 +2339,7 @@ module Aws::SSM
2253
2339
  #
2254
2340
  # @option params [Boolean] :safe
2255
2341
  # The system checks if the target is being referenced by a task. If the
2256
- # target is being referenced, the system returns an error and does not
2342
+ # target is being referenced, the system returns an error and doesn't
2257
2343
  # deregister the target from the maintenance window.
2258
2344
  #
2259
2345
  # @return [Types::DeregisterTargetFromMaintenanceWindowResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2318,9 +2404,9 @@ module Aws::SSM
2318
2404
  end
2319
2405
 
2320
2406
  # Describes details about the activation, such as the date and time the
2321
- # activation was created, its expiration date, the IAM role assigned to
2322
- # the instances in the activation, and the number of instances
2323
- # registered by using this activation.
2407
+ # activation was created, its expiration date, the Identity and Access
2408
+ # Management (IAM) role assigned to the instances in the activation, and
2409
+ # the number of instances registered by using this activation.
2324
2410
  #
2325
2411
  # @option params [Array<Types::DescribeActivationsFilter>] :filters
2326
2412
  # A filter to view information about your activations.
@@ -2383,12 +2469,12 @@ module Aws::SSM
2383
2469
  # Describes the association for the specified target or instance. If you
2384
2470
  # created the association by using the `Targets` parameter, then you
2385
2471
  # must retrieve the association by using the association ID. If you
2386
- # created the association by specifying an instance ID and a Systems
2387
- # Manager document, then you retrieve the association by specifying the
2388
- # document name and the instance ID.
2472
+ # created the association by specifying an instance ID and an Amazon Web
2473
+ # Services Systems Manager document (SSM document), then you retrieve
2474
+ # the association by specifying the document name and the instance ID.
2389
2475
  #
2390
2476
  # @option params [String] :name
2391
- # The name of the Systems Manager document.
2477
+ # The name of the SSM document.
2392
2478
  #
2393
2479
  # @option params [String] :instance_id
2394
2480
  # The instance ID.
@@ -2473,8 +2559,8 @@ module Aws::SSM
2473
2559
  req.send_request(options)
2474
2560
  end
2475
2561
 
2476
- # Use this API action to view information about a specific execution of
2477
- # a specific association.
2562
+ # Views information about a specific execution of a specific
2563
+ # association.
2478
2564
  #
2479
2565
  # @option params [required, String] :association_id
2480
2566
  # The association ID that includes the execution for which you want to
@@ -2548,8 +2634,7 @@ module Aws::SSM
2548
2634
  req.send_request(options)
2549
2635
  end
2550
2636
 
2551
- # Use this API action to view all executions for a specific association
2552
- # ID.
2637
+ # Views all executions for a specific association ID.
2553
2638
  #
2554
2639
  # @option params [required, String] :association_id
2555
2640
  # The association ID for which you want to view execution history
@@ -2746,8 +2831,8 @@ module Aws::SSM
2746
2831
  # next set of results.
2747
2832
  #
2748
2833
  # @option params [Boolean] :reverse_order
2749
- # A boolean that indicates whether to list step executions in reverse
2750
- # order by start time. The default value is 'false'.
2834
+ # Indicates whether to list step executions in reverse order by start
2835
+ # time. The default value is 'false'.
2751
2836
  #
2752
2837
  # @return [Types::DescribeAutomationStepExecutionsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2753
2838
  #
@@ -2829,7 +2914,98 @@ module Aws::SSM
2829
2914
  # Lists all patches eligible to be included in a patch baseline.
2830
2915
  #
2831
2916
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
2832
- # Filters used to scope down the returned patches.
2917
+ # Each element in the array is a structure containing a key-value pair.
2918
+ #
2919
+ # **Windows Server**
2920
+ #
2921
+ # Supported keys for Windows Server instance patches include the
2922
+ # following:
2923
+ #
2924
+ # * <b> <code>PATCH_SET</code> </b>
2925
+ #
2926
+ # Sample values: `OS` \| `APPLICATION`
2927
+ #
2928
+ # * <b> <code>PRODUCT</code> </b>
2929
+ #
2930
+ # Sample values: `WindowsServer2012` \| `Office 2010` \|
2931
+ # `MicrosoftDefenderAntivirus`
2932
+ #
2933
+ # * <b> <code>PRODUCT_FAMILY</code> </b>
2934
+ #
2935
+ # Sample values: `Windows` \| `Office`
2936
+ #
2937
+ # * <b> <code>MSRC_SEVERITY</code> </b>
2938
+ #
2939
+ # Sample values: `ServicePacks` \| `Important` \| `Moderate`
2940
+ #
2941
+ # * <b> <code>CLASSIFICATION</code> </b>
2942
+ #
2943
+ # Sample values: `ServicePacks` \| `SecurityUpdates` \|
2944
+ # `DefinitionUpdates`
2945
+ #
2946
+ # * <b> <code>PATCH_ID</code> </b>
2947
+ #
2948
+ # Sample values: `KB123456` \| `KB4516046`
2949
+ #
2950
+ # **Linux**
2951
+ #
2952
+ # When specifying filters for Linux patches, you must specify a key-pair
2953
+ # for `PRODUCT`. For example, using the Command Line Interface (CLI),
2954
+ # the following command fails:
2955
+ #
2956
+ # `aws ssm describe-available-patches --filters
2957
+ # Key=CVE_ID,Values=CVE-2018-3615`
2958
+ #
2959
+ # However, the following command succeeds:
2960
+ #
2961
+ # `aws ssm describe-available-patches --filters
2962
+ # Key=PRODUCT,Values=AmazonLinux2018.03 Key=CVE_ID,Values=CVE-2018-3615`
2963
+ #
2964
+ # Supported keys for Linux instance patches include the following:
2965
+ #
2966
+ # * <b> <code>PRODUCT</code> </b>
2967
+ #
2968
+ # Sample values: `AmazonLinux2018.03` \| `AmazonLinux2.0`
2969
+ #
2970
+ # * <b> <code>NAME</code> </b>
2971
+ #
2972
+ # Sample values: `kernel-headers` \| `samba-python` \| `php`
2973
+ #
2974
+ # * <b> <code>SEVERITY</code> </b>
2975
+ #
2976
+ # Sample values: `Critical` \| `Important` \| `Medium` \| `Low`
2977
+ #
2978
+ # * <b> <code>EPOCH</code> </b>
2979
+ #
2980
+ # Sample values: `0` \| `1`
2981
+ #
2982
+ # * <b> <code>VERSION</code> </b>
2983
+ #
2984
+ # Sample values: `78.6.1` \| `4.10.16`
2985
+ #
2986
+ # * <b> <code>RELEASE</code> </b>
2987
+ #
2988
+ # Sample values: `9.56.amzn1` \| `1.amzn2`
2989
+ #
2990
+ # * <b> <code>ARCH</code> </b>
2991
+ #
2992
+ # Sample values: `i686` \| `x86_64`
2993
+ #
2994
+ # * <b> <code>REPOSITORY</code> </b>
2995
+ #
2996
+ # Sample values: `Core` \| `Updates`
2997
+ #
2998
+ # * <b> <code>ADVISORY_ID</code> </b>
2999
+ #
3000
+ # Sample values: `ALAS-2018-1058` \| `ALAS2-2021-1594`
3001
+ #
3002
+ # * <b> <code>CVE_ID</code> </b>
3003
+ #
3004
+ # Sample values: `CVE-2018-3615` \| `CVE-2020-1472`
3005
+ #
3006
+ # * <b> <code>BUGZILLA_ID</code> </b>
3007
+ #
3008
+ # Sample values: `1463241`
2833
3009
  #
2834
3010
  # @option params [Integer] :max_results
2835
3011
  # The maximum number of patches to return (per page).
@@ -2898,10 +3074,11 @@ module Aws::SSM
2898
3074
  req.send_request(options)
2899
3075
  end
2900
3076
 
2901
- # Describes the specified Systems Manager document.
3077
+ # Describes the specified Amazon Web Services Systems Manager document
3078
+ # (SSM document).
2902
3079
  #
2903
3080
  # @option params [required, String] :name
2904
- # The name of the Systems Manager document.
3081
+ # The name of the SSM document.
2905
3082
  #
2906
3083
  # @option params [String] :document_version
2907
3084
  # The document version for which you want information. Can be a specific
@@ -2910,7 +3087,7 @@ module Aws::SSM
2910
3087
  # @option params [String] :version_name
2911
3088
  # An optional field specifying the version of the artifact associated
2912
3089
  # with the document. For example, "Release 12, Update 6". This value
2913
- # is unique across all versions of a document, and cannot be changed.
3090
+ # is unique across all versions of a document, and can't be changed.
2914
3091
  #
2915
3092
  # @return [Types::DescribeDocumentResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2916
3093
  #
@@ -2930,6 +3107,7 @@ module Aws::SSM
2930
3107
  # resp.document.hash #=> String
2931
3108
  # resp.document.hash_type #=> String, one of "Sha256", "Sha1"
2932
3109
  # resp.document.name #=> String
3110
+ # resp.document.display_name #=> String
2933
3111
  # resp.document.version_name #=> String
2934
3112
  # resp.document.owner #=> String
2935
3113
  # resp.document.created_date #=> Time
@@ -2944,7 +3122,7 @@ module Aws::SSM
2944
3122
  # resp.document.parameters[0].default_value #=> String
2945
3123
  # resp.document.platform_types #=> Array
2946
3124
  # resp.document.platform_types[0] #=> String, one of "Windows", "Linux"
2947
- # resp.document.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate"
3125
+ # resp.document.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
2948
3126
  # resp.document.schema_version #=> String
2949
3127
  # resp.document.latest_version #=> String
2950
3128
  # resp.document.default_version #=> String
@@ -2976,10 +3154,10 @@ module Aws::SSM
2976
3154
  req.send_request(options)
2977
3155
  end
2978
3156
 
2979
- # Describes the permissions for a Systems Manager document. If you
2980
- # created the document, you are the owner. If a document is shared, it
2981
- # can either be shared privately (by specifying a user's AWS account
2982
- # ID) or publicly (*All*).
3157
+ # Describes the permissions for a Amazon Web Services Systems Manager
3158
+ # document (SSM document). If you created the document, you are the
3159
+ # owner. If a document is shared, it can either be shared privately (by
3160
+ # specifying a user's account ID) or publicly (*All*).
2983
3161
  #
2984
3162
  # @option params [required, String] :name
2985
3163
  # The name of the document for which you are the owner.
@@ -3078,8 +3256,8 @@ module Aws::SSM
3078
3256
  end
3079
3257
 
3080
3258
  # Retrieves the current effective patches (the patch and the approval
3081
- # state) for the specified patch baseline. Note that this API applies
3082
- # only to Windows patch baselines.
3259
+ # state) for the specified patch baseline. Applies to patch baselines
3260
+ # for Windows only.
3083
3261
  #
3084
3262
  # @option params [required, String] :baseline_id
3085
3263
  # The ID of the patch baseline to retrieve the effective patches for.
@@ -3209,13 +3387,13 @@ module Aws::SSM
3209
3387
  # the instance, instance status, and so on.
3210
3388
  #
3211
3389
  # If you specify one or more instance IDs, it returns information for
3212
- # those instances. If you do not specify instance IDs, it returns
3390
+ # those instances. If you don't specify instance IDs, it returns
3213
3391
  # information for all your instances. If you specify an instance ID that
3214
- # is not valid or an instance that you do not own, you receive an error.
3392
+ # isn't valid or an instance that you don't own, you receive an error.
3215
3393
  #
3216
- # <note markdown="1"> The IamRole field for this API action is the Amazon Identity and
3217
- # Access Management (IAM) role assigned to on-premises instances. This
3218
- # call does not return the IAM role for EC2 instances.
3394
+ # <note markdown="1"> The `IamRole` field for this API operation is the Identity and Access
3395
+ # Management (IAM) role assigned to on-premises instances. This call
3396
+ # doesn't return the IAM role for EC2 instances.
3219
3397
  #
3220
3398
  # </note>
3221
3399
  #
@@ -3309,7 +3487,7 @@ module Aws::SSM
3309
3487
  # Retrieves the high-level patch state of one or more instances.
3310
3488
  #
3311
3489
  # @option params [required, Array<String>] :instance_ids
3312
- # The ID of the instance whose patch state information should be
3490
+ # The ID of the instance for which patch state information should be
3313
3491
  # retrieved.
3314
3492
  #
3315
3493
  # @option params [String] :next_token
@@ -3380,11 +3558,11 @@ module Aws::SSM
3380
3558
  # @option params [Array<Types::InstancePatchStateFilter>] :filters
3381
3559
  # Each entry in the array is a structure containing:
3382
3560
  #
3383
- # Key (string between 1 and 200 characters)
3561
+ # * Key (string between 1 and 200 characters)
3384
3562
  #
3385
- # Values (array containing a single string)
3563
+ # * Values (array containing a single string)
3386
3564
  #
3387
- # Type (string "Equal", "NotEqual", "LessThan", "GreaterThan")
3565
+ # * Type (string "Equal", "NotEqual", "LessThan", "GreaterThan")
3388
3566
  #
3389
3567
  # @option params [String] :next_token
3390
3568
  # The token for the next set of items to return. (You received this
@@ -3460,9 +3638,26 @@ module Aws::SSM
3460
3638
  # retrieved.
3461
3639
  #
3462
3640
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
3463
- # An array of structures. Each entry in the array is a structure
3464
- # containing a Key, Value combination. Valid values for Key are
3465
- # `Classification` \| `KBId` \| `Severity` \| `State`.
3641
+ # Each element in the array is a structure containing a key-value pair.
3642
+ #
3643
+ # Supported keys for `DescribeInstancePatches`include the following:
3644
+ #
3645
+ # * <b> <code>Classification</code> </b>
3646
+ #
3647
+ # Sample values: `Security` \| `SecurityUpdates`
3648
+ #
3649
+ # * <b> <code>KBId</code> </b>
3650
+ #
3651
+ # Sample values: `KB4480056` \| `java-1.7.0-openjdk.x86_64`
3652
+ #
3653
+ # * <b> <code>Severity</code> </b>
3654
+ #
3655
+ # Sample values: `Important` \| `Medium` \| `Low`
3656
+ #
3657
+ # * <b> <code>State</code> </b>
3658
+ #
3659
+ # Sample values: `Installed` \| `InstalledOther` \|
3660
+ # `InstalledPendingReboot`
3466
3661
  #
3467
3662
  # @option params [String] :next_token
3468
3663
  # The token for the next set of items to return. (You received this
@@ -3517,7 +3712,7 @@ module Aws::SSM
3517
3712
  #
3518
3713
  # @option params [String] :deletion_id
3519
3714
  # Specify the delete inventory ID for which you want information. This
3520
- # ID was returned by the `DeleteInventory` action.
3715
+ # ID was returned by the `DeleteInventory` operation.
3521
3716
  #
3522
3717
  # @option params [String] :next_token
3523
3718
  # A token to start the list. Use this token to get the next set of
@@ -3581,8 +3776,9 @@ module Aws::SSM
3581
3776
  #
3582
3777
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
3583
3778
  # Optional filters used to scope down the returned task invocations. The
3584
- # supported filter key is STATUS with the corresponding values PENDING,
3585
- # IN\_PROGRESS, SUCCESS, FAILED, TIMED\_OUT, CANCELLING, and CANCELLED.
3779
+ # supported filter key is `STATUS` with the corresponding values
3780
+ # `PENDING`, `IN_PROGRESS`, `SUCCESS`, `FAILED`, `TIMED_OUT`,
3781
+ # `CANCELLING`, and `CANCELLED`.
3586
3782
  #
3587
3783
  # @option params [Integer] :max_results
3588
3784
  # The maximum number of items to return for this call. The call also
@@ -3650,8 +3846,9 @@ module Aws::SSM
3650
3846
  #
3651
3847
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
3652
3848
  # Optional filters used to scope down the returned tasks. The supported
3653
- # filter key is STATUS with the corresponding values PENDING,
3654
- # IN\_PROGRESS, SUCCESS, FAILED, TIMED\_OUT, CANCELLING, and CANCELLED.
3849
+ # filter key is `STATUS` with the corresponding values `PENDING`,
3850
+ # `IN_PROGRESS`, `SUCCESS`, `FAILED`, `TIMED_OUT`, `CANCELLING`, and
3851
+ # `CANCELLED`.
3655
3852
  #
3656
3853
  # @option params [Integer] :max_results
3657
3854
  # The maximum number of items to return for this call. The call also
@@ -3716,12 +3913,12 @@ module Aws::SSM
3716
3913
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
3717
3914
  # Each entry in the array is a structure containing:
3718
3915
  #
3719
- # Key (string, between 1 and 128 characters)
3720
- #
3721
- # Values (array of strings, each string is between 1 and 256 characters)
3916
+ # * Key. A string between 1 and 128 characters. Supported keys include
3917
+ # `ExecutedBefore` and `ExecutedAfter`.
3722
3918
  #
3723
- # The supported Keys are ExecutedBefore and ExecutedAfter with the value
3724
- # being a date/time string such as 2016-11-04T05:00:00Z.
3919
+ # * Values. An array of strings, each between 1 and 256 characters.
3920
+ # Supported values are date/time strings in a valid ISO 8601 date/time
3921
+ # format, such as `2021-11-04T05:00:00Z`.
3725
3922
  #
3726
3923
  # @option params [Integer] :max_results
3727
3924
  # The maximum number of items to return for this call. The call also
@@ -3780,11 +3977,11 @@ module Aws::SSM
3780
3977
  # The ID of the maintenance window to retrieve information about.
3781
3978
  #
3782
3979
  # @option params [Array<Types::Target>] :targets
3783
- # The instance ID or key/value pair to retrieve information about.
3980
+ # The instance ID or key-value pair to retrieve information about.
3784
3981
  #
3785
3982
  # @option params [String] :resource_type
3786
3983
  # The type of resource you want to retrieve information about. For
3787
- # example, "INSTANCE".
3984
+ # example, `INSTANCE`.
3788
3985
  #
3789
3986
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
3790
3987
  # Filters used to limit the range of results. For example, you can limit
@@ -3852,8 +4049,8 @@ module Aws::SSM
3852
4049
  #
3853
4050
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
3854
4051
  # Optional filters that can be used to narrow down the scope of the
3855
- # returned window targets. The supported filter keys are Type,
3856
- # WindowTargetId and OwnerInformation.
4052
+ # returned window targets. The supported filter keys are `Type`,
4053
+ # `WindowTargetId`, and `OwnerInformation`.
3857
4054
  #
3858
4055
  # @option params [Integer] :max_results
3859
4056
  # The maximum number of items to return for this call. The call also
@@ -3911,10 +4108,10 @@ module Aws::SSM
3911
4108
 
3912
4109
  # Lists the tasks in a maintenance window.
3913
4110
  #
3914
- # <note markdown="1"> For maintenance window tasks without a specified target, you cannot
4111
+ # <note markdown="1"> For maintenance window tasks without a specified target, you can't
3915
4112
  # supply values for `--max-errors` and `--max-concurrency`. Instead, the
3916
4113
  # system inserts a placeholder value of `1`, which may be reported in
3917
- # the response to this command. These values do not affect the running
4114
+ # the response to this command. These values don't affect the running
3918
4115
  # of your task and can be ignored.
3919
4116
  #
3920
4117
  # </note>
@@ -3924,8 +4121,8 @@ module Aws::SSM
3924
4121
  #
3925
4122
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
3926
4123
  # Optional filters used to narrow down the scope of the returned tasks.
3927
- # The supported filter keys are WindowTaskId, TaskArn, Priority, and
3928
- # TaskType.
4124
+ # The supported filter keys are `WindowTaskId`, `TaskArn`, `Priority`,
4125
+ # and `TaskType`.
3929
4126
  #
3930
4127
  # @option params [Integer] :max_results
3931
4128
  # The maximum number of items to return for this call. The call also
@@ -3991,12 +4188,12 @@ module Aws::SSM
3991
4188
  req.send_request(options)
3992
4189
  end
3993
4190
 
3994
- # Retrieves the maintenance windows in an AWS account.
4191
+ # Retrieves the maintenance windows in an account.
3995
4192
  #
3996
4193
  # @option params [Array<Types::MaintenanceWindowFilter>] :filters
3997
4194
  # Optional filters used to narrow down the scope of the returned
3998
- # maintenance windows. Supported filter keys are **Name** and
3999
- # **Enabled**.
4195
+ # maintenance windows. Supported filter keys are `Name` and `Enabled`.
4196
+ # For example, `Name=MyMaintenanceWindow` and `Enabled=True`.
4000
4197
  #
4001
4198
  # @option params [Integer] :max_results
4002
4199
  # The maximum number of items to return for this call. The call also
@@ -4057,11 +4254,11 @@ module Aws::SSM
4057
4254
  # that an instance is associated with.
4058
4255
  #
4059
4256
  # @option params [required, Array<Types::Target>] :targets
4060
- # The instance ID or key/value pair to retrieve information about.
4257
+ # The instance ID or key-value pair to retrieve information about.
4061
4258
  #
4062
4259
  # @option params [required, String] :resource_type
4063
4260
  # The type of resource you want to retrieve information about. For
4064
- # example, "INSTANCE".
4261
+ # example, `INSTANCE`.
4065
4262
  #
4066
4263
  # @option params [Integer] :max_results
4067
4264
  # The maximum number of items to return for this call. The call also
@@ -4109,16 +4306,17 @@ module Aws::SSM
4109
4306
  req.send_request(options)
4110
4307
  end
4111
4308
 
4112
- # Query a set of OpsItems. You must have permission in AWS Identity and
4309
+ # Query a set of OpsItems. You must have permission in Identity and
4113
4310
  # Access Management (IAM) to query a list of OpsItems. For more
4114
- # information, see [Getting started with OpsCenter][1] in the *AWS
4115
- # Systems Manager User Guide*.
4116
- #
4117
- # Operations engineers and IT professionals use OpsCenter to view,
4118
- # investigate, and remediate operational issues impacting the
4119
- # performance and health of their AWS resources. For more information,
4120
- # see [AWS Systems Manager OpsCenter][2] in the *AWS Systems Manager
4121
- # User Guide*.
4311
+ # information, see [Getting started with OpsCenter][1] in the *Amazon
4312
+ # Web Services Systems Manager User Guide*.
4313
+ #
4314
+ # Operations engineers and IT professionals use Amazon Web Services
4315
+ # Systems Manager OpsCenter to view, investigate, and remediate
4316
+ # operational issues impacting the performance and health of their
4317
+ # Amazon Web Services resources. For more information, see
4318
+ # [OpsCenter][2] in the *Amazon Web Services Systems Manager User
4319
+ # Guide*.
4122
4320
  #
4123
4321
  #
4124
4322
  #
@@ -4152,11 +4350,11 @@ module Aws::SSM
4152
4350
  #
4153
4351
  # Operations: Equals
4154
4352
  #
4155
- # * Key: Title
4353
+ # * Key: Title*
4156
4354
  #
4157
- # Operations: Contains
4355
+ # Operations: Equals,Contains
4158
4356
  #
4159
- # * Key: OperationalData*
4357
+ # * Key: OperationalData**
4160
4358
  #
4161
4359
  # Operations: Equals
4162
4360
  #
@@ -4180,7 +4378,11 @@ module Aws::SSM
4180
4378
  #
4181
4379
  # Operations: Equals
4182
4380
  #
4183
- # *If you filter the response by using the OperationalData operator,
4381
+ # *The Equals operator for Title matches the first 100 characters. If
4382
+ # you specify more than 100 characters, they system returns an error
4383
+ # that the filter value exceeds the length limit.
4384
+ #
4385
+ # **If you filter the response by using the OperationalData operator,
4184
4386
  # specify a key-value pair by using the following JSON format:
4185
4387
  # \\\{"key":"key\_name","value":"a\_value"\\}
4186
4388
  #
@@ -4205,7 +4407,7 @@ module Aws::SSM
4205
4407
  # resp = client.describe_ops_items({
4206
4408
  # ops_item_filters: [
4207
4409
  # {
4208
- # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, ActualStartTime, ActualEndTime, PlannedStartTime, PlannedEndTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity, OpsItemType, ChangeRequestByRequesterArn, ChangeRequestByRequesterName, ChangeRequestByApproverArn, ChangeRequestByApproverName, ChangeRequestByTemplate, ChangeRequestByTargetsResourceGroup
4410
+ # key: "Status", # required, accepts Status, CreatedBy, Source, Priority, Title, OpsItemId, CreatedTime, LastModifiedTime, ActualStartTime, ActualEndTime, PlannedStartTime, PlannedEndTime, OperationalData, OperationalDataKey, OperationalDataValue, ResourceId, AutomationId, Category, Severity, OpsItemType, ChangeRequestByRequesterArn, ChangeRequestByRequesterName, ChangeRequestByApproverArn, ChangeRequestByApproverName, ChangeRequestByTemplate, ChangeRequestByTargetsResourceGroup, InsightByType
4209
4411
  # values: ["OpsItemFilterValue"], # required
4210
4412
  # operator: "Equal", # required, accepts Equal, Contains, GreaterThan, LessThan
4211
4413
  # },
@@ -4224,7 +4426,7 @@ module Aws::SSM
4224
4426
  # resp.ops_item_summaries[0].last_modified_time #=> Time
4225
4427
  # resp.ops_item_summaries[0].priority #=> Integer
4226
4428
  # resp.ops_item_summaries[0].source #=> String
4227
- # resp.ops_item_summaries[0].status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Rejected"
4429
+ # resp.ops_item_summaries[0].status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Rejected", "Closed"
4228
4430
  # resp.ops_item_summaries[0].ops_item_id #=> String
4229
4431
  # resp.ops_item_summaries[0].title #=> String
4230
4432
  # resp.ops_item_summaries[0].operational_data #=> Hash
@@ -4249,7 +4451,7 @@ module Aws::SSM
4249
4451
 
4250
4452
  # Get information about a parameter.
4251
4453
  #
4252
- # <note markdown="1"> Request results are returned on a best-effort basis. If you specify
4454
+ # Request results are returned on a best-effort basis. If you specify
4253
4455
  # `MaxResults` in the request, the response includes information up to
4254
4456
  # the limit specified. The number of items returned, however, can be
4255
4457
  # between zero and the value of `MaxResults`. If the service reaches an
@@ -4258,8 +4460,6 @@ module Aws::SSM
4258
4460
  # You can specify the `NextToken` in a subsequent call to get the next
4259
4461
  # set of results.
4260
4462
  #
4261
- # </note>
4262
- #
4263
4463
  # @option params [Array<Types::ParametersFilter>] :filters
4264
4464
  # This data type is deprecated. Instead, use `ParameterFilters`.
4265
4465
  #
@@ -4330,15 +4530,24 @@ module Aws::SSM
4330
4530
  req.send_request(options)
4331
4531
  end
4332
4532
 
4333
- # Lists the patch baselines in your AWS account.
4533
+ # Lists the patch baselines in your account.
4334
4534
  #
4335
4535
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
4336
- # Each element in the array is a structure containing:
4536
+ # Each element in the array is a structure containing a key-value pair.
4537
+ #
4538
+ # Supported keys for `DescribePatchBaselines` include the following:
4539
+ #
4540
+ # * <b> <code>NAME_PREFIX</code> </b>
4541
+ #
4542
+ # Sample values: `AWS-` \| `My-`
4543
+ #
4544
+ # * <b> <code>OWNER</code> </b>
4337
4545
  #
4338
- # Key: (string, "NAME\_PREFIX" or "OWNER")
4546
+ # Sample values: `AWS` \| `Self`
4339
4547
  #
4340
- # Value: (array of strings, exactly 1 entry, between 1 and 255
4341
- # characters)
4548
+ # * <b> <code>OPERATING_SYSTEM</code> </b>
4549
+ #
4550
+ # Sample values: `AMAZON_LINUX` \| `SUSE` \| `WINDOWS`
4342
4551
  #
4343
4552
  # @option params [Integer] :max_results
4344
4553
  # The maximum number of patch baselines to return (per page).
@@ -4386,8 +4595,8 @@ module Aws::SSM
4386
4595
  req.send_request(options)
4387
4596
  end
4388
4597
 
4389
- # Returns high-level aggregated patch compliance state for a patch
4390
- # group.
4598
+ # Returns high-level aggregated patch compliance state information for a
4599
+ # patch group.
4391
4600
  #
4392
4601
  # @option params [required, String] :patch_group
4393
4602
  # The name of the patch group whose patch snapshot should be retrieved.
@@ -4443,24 +4652,17 @@ module Aws::SSM
4443
4652
  # The maximum number of patch groups to return (per page).
4444
4653
  #
4445
4654
  # @option params [Array<Types::PatchOrchestratorFilter>] :filters
4446
- # One or more filters. Use a filter to return a more specific list of
4447
- # results.
4655
+ # Each element in the array is a structure containing a key-value pair.
4448
4656
  #
4449
- # For `DescribePatchGroups`,valid filter keys include the following:
4657
+ # Supported keys for `DescribePatchGroups` include the following:
4450
4658
  #
4451
- # * `NAME_PREFIX`\: The name of the patch group. Wildcards (*) are
4452
- # accepted.
4659
+ # * <b> <code>NAME_PREFIX</code> </b>
4453
4660
  #
4454
- # * `OPERATING_SYSTEM`\: The supported operating system type to return
4455
- # results for. For valid operating system values, see
4456
- # GetDefaultPatchBaselineRequest$OperatingSystem in
4457
- # CreatePatchBaseline.
4661
+ # Sample values: `AWS-` \| `My-`.
4458
4662
  #
4459
- # Examples:
4663
+ # * <b> <code>OPERATING_SYSTEM</code> </b>
4460
4664
  #
4461
- # * `--filters Key=NAME_PREFIX,Values=MyPatchGroup*`
4462
- #
4463
- # * `--filters Key=OPERATING_SYSTEM,Values=AMAZON_LINUX_2`
4665
+ # Sample values: `AMAZON_LINUX` \| `SUSE` \| `WINDOWS`
4464
4666
  #
4465
4667
  # @option params [String] :next_token
4466
4668
  # The token for the next set of items to return. (You received this
@@ -4509,7 +4711,7 @@ module Aws::SSM
4509
4711
  # Lists the properties of available patches organized by product,
4510
4712
  # product family, classification, severity, and other properties of
4511
4713
  # available patches. You can use the reported properties in the filters
4512
- # you specify in requests for actions such as CreatePatchBaseline,
4714
+ # you specify in requests for operations such as CreatePatchBaseline,
4513
4715
  # UpdatePatchBaseline, DescribeAvailablePatches, and
4514
4716
  # DescribePatchBaselines.
4515
4717
  #
@@ -4518,44 +4720,44 @@ module Aws::SSM
4518
4720
  #
4519
4721
  # AMAZON\_LINUX
4520
4722
  #
4521
- # : Valid properties: PRODUCT, CLASSIFICATION, SEVERITY
4723
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
4522
4724
  #
4523
4725
  # AMAZON\_LINUX\_2
4524
4726
  #
4525
- # : Valid properties: PRODUCT, CLASSIFICATION, SEVERITY
4727
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
4526
4728
  #
4527
4729
  # CENTOS
4528
4730
  #
4529
- # : Valid properties: PRODUCT, CLASSIFICATION, SEVERITY
4731
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
4530
4732
  #
4531
4733
  # DEBIAN
4532
4734
  #
4533
- # : Valid properties: PRODUCT, PRIORITY
4735
+ # : Valid properties: `PRODUCT` \| `PRIORITY`
4534
4736
  #
4535
4737
  # MACOS
4536
4738
  #
4537
- # : Valid properties: PRODUCT, CLASSIFICATION
4739
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION`
4538
4740
  #
4539
4741
  # ORACLE\_LINUX
4540
4742
  #
4541
- # : Valid properties: PRODUCT, CLASSIFICATION, SEVERITY
4743
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
4542
4744
  #
4543
4745
  # REDHAT\_ENTERPRISE\_LINUX
4544
4746
  #
4545
- # : Valid properties: PRODUCT, CLASSIFICATION, SEVERITY
4747
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
4546
4748
  #
4547
4749
  # SUSE
4548
4750
  #
4549
- # : Valid properties: PRODUCT, CLASSIFICATION, SEVERITY
4751
+ # : Valid properties: `PRODUCT` \| `CLASSIFICATION` \| `SEVERITY`
4550
4752
  #
4551
4753
  # UBUNTU
4552
4754
  #
4553
- # : Valid properties: PRODUCT, PRIORITY
4755
+ # : Valid properties: `PRODUCT` \| `PRIORITY`
4554
4756
  #
4555
4757
  # WINDOWS
4556
4758
  #
4557
- # : Valid properties: PRODUCT, PRODUCT\_FAMILY, CLASSIFICATION,
4558
- # MSRC\_SEVERITY
4759
+ # : Valid properties: `PRODUCT` \| `PRODUCT_FAMILY` \| `CLASSIFICATION`
4760
+ # \| `MSRC_SEVERITY`
4559
4761
  #
4560
4762
  # @option params [required, String] :operating_system
4561
4763
  # The operating system type for which to list patches.
@@ -4565,8 +4767,8 @@ module Aws::SSM
4565
4767
  #
4566
4768
  # @option params [String] :patch_set
4567
4769
  # Indicates whether to list patches for the Windows operating system or
4568
- # for Microsoft applications. Not applicable for the Linux or macOS
4569
- # operating systems.
4770
+ # for applications released by Microsoft. Not applicable for the Linux
4771
+ # or macOS operating systems.
4570
4772
  #
4571
4773
  # @option params [Integer] :max_results
4572
4774
  # The maximum number of items to return for this call. The call also
@@ -4675,12 +4877,43 @@ module Aws::SSM
4675
4877
  req.send_request(options)
4676
4878
  end
4677
4879
 
4880
+ # Deletes the association between an OpsItem and a related resource. For
4881
+ # example, this API operation can delete an Incident Manager incident
4882
+ # from an OpsItem. Incident Manager is a capability of Amazon Web
4883
+ # Services Systems Manager.
4884
+ #
4885
+ # @option params [required, String] :ops_item_id
4886
+ # The ID of the OpsItem for which you want to delete an association
4887
+ # between the OpsItem and a related resource.
4888
+ #
4889
+ # @option params [required, String] :association_id
4890
+ # The ID of the association for which you want to delete an association
4891
+ # between the OpsItem and a related resource.
4892
+ #
4893
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4894
+ #
4895
+ # @example Request syntax with placeholder values
4896
+ #
4897
+ # resp = client.disassociate_ops_item_related_item({
4898
+ # ops_item_id: "OpsItemId", # required
4899
+ # association_id: "OpsItemRelatedItemAssociationId", # required
4900
+ # })
4901
+ #
4902
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/DisassociateOpsItemRelatedItem AWS API Documentation
4903
+ #
4904
+ # @overload disassociate_ops_item_related_item(params = {})
4905
+ # @param [Hash] params ({})
4906
+ def disassociate_ops_item_related_item(params = {}, options = {})
4907
+ req = build_request(:disassociate_ops_item_related_item, params)
4908
+ req.send_request(options)
4909
+ end
4910
+
4678
4911
  # Get detailed information about a particular Automation execution.
4679
4912
  #
4680
4913
  # @option params [required, String] :automation_execution_id
4681
4914
  # The unique identifier for an existing automation execution to examine.
4682
4915
  # The execution ID is returned by StartAutomationExecution when the
4683
- # execution of an Automation document is initiated.
4916
+ # execution of an Automation runbook is initiated.
4684
4917
  #
4685
4918
  # @return [Types::GetAutomationExecutionResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4686
4919
  #
@@ -4819,20 +5052,22 @@ module Aws::SSM
4819
5052
  req.send_request(options)
4820
5053
  end
4821
5054
 
4822
- # Gets the state of the AWS Systems Manager Change Calendar at an
4823
- # optional, specified time. If you specify a time, `GetCalendarState`
4824
- # returns the state of the calendar at a specific time, and returns the
4825
- # next time that the Change Calendar state will transition. If you do
4826
- # not specify a time, `GetCalendarState` assumes the current time.
4827
- # Change Calendar entries have two possible states: `OPEN` or `CLOSED`.
5055
+ # Gets the state of a Amazon Web Services Systems Manager change
5056
+ # calendar at the current time or a specified time. If you specify a
5057
+ # time, `GetCalendarState` returns the state of the calendar at that
5058
+ # specific time, and returns the next time that the change calendar
5059
+ # state will transition. If you don't specify a time,
5060
+ # `GetCalendarState` uses the current time. Change Calendar entries have
5061
+ # two possible states: `OPEN` or `CLOSED`.
4828
5062
  #
4829
5063
  # If you specify more than one calendar in a request, the command
4830
5064
  # returns the status of `OPEN` only if all calendars in the request are
4831
5065
  # open. If one or more calendars in the request are closed, the status
4832
5066
  # returned is `CLOSED`.
4833
5067
  #
4834
- # For more information about Systems Manager Change Calendar, see [AWS
4835
- # Systems Manager Change Calendar][1] in the *AWS Systems Manager User
5068
+ # For more information about Change Calendar, a capability of Amazon Web
5069
+ # Services Systems Manager, see [Amazon Web Services Systems Manager
5070
+ # Change Calendar][1] in the *Amazon Web Services Systems Manager User
4836
5071
  # Guide*.
4837
5072
  #
4838
5073
  #
@@ -4841,13 +5076,13 @@ module Aws::SSM
4841
5076
  #
4842
5077
  # @option params [required, Array<String>] :calendar_names
4843
5078
  # The names or Amazon Resource Names (ARNs) of the Systems Manager
4844
- # documents that represent the calendar entries for which you want to
4845
- # get the state.
5079
+ # documents (SSM documents) that represent the calendar entries for
5080
+ # which you want to get the state.
4846
5081
  #
4847
5082
  # @option params [String] :at_time
4848
5083
  # (Optional) The specific time for which you want to get calendar state
4849
- # information, in [ISO 8601][1] format. If you do not add `AtTime`, the
4850
- # current time is assumed.
5084
+ # information, in [ISO 8601][1] format. If you don't specify a value or
5085
+ # `AtTime`, the current time is used.
4851
5086
  #
4852
5087
  #
4853
5088
  #
@@ -4896,7 +5131,7 @@ module Aws::SSM
4896
5131
  # (Required) The ID of the managed instance targeted by the command. A
4897
5132
  # managed instance can be an Amazon Elastic Compute Cloud (Amazon EC2)
4898
5133
  # instance or an instance in your hybrid environment that is configured
4899
- # for AWS Systems Manager.
5134
+ # for Amazon Web Services Systems Manager.
4900
5135
  #
4901
5136
  # @option params [String] :plugin_name
4902
5137
  # The name of the plugin for which you want detailed results. If the
@@ -4906,7 +5141,8 @@ module Aws::SSM
4906
5141
  # details.
4907
5142
  #
4908
5143
  # Plugin names are also referred to as *step names* in Systems Manager
4909
- # documents. For example, `aws:RunShellScript` is a plugin.
5144
+ # documents (SSM documents). For example, `aws:RunShellScript` is a
5145
+ # plugin.
4910
5146
  #
4911
5147
  # To find the `PluginName`, check the document content and find the name
4912
5148
  # of the plugin. Alternatively, use ListCommandInvocations with the
@@ -5008,11 +5244,12 @@ module Aws::SSM
5008
5244
  req.send_request(options)
5009
5245
  end
5010
5246
 
5011
- # Retrieves the default patch baseline. Note that Systems Manager
5012
- # supports creating multiple default patch baselines. For example, you
5013
- # can create a default patch baseline for each operating system.
5247
+ # Retrieves the default patch baseline. Amazon Web Services Systems
5248
+ # Manager supports creating multiple default patch baselines. For
5249
+ # example, you can create a default patch baseline for each operating
5250
+ # system.
5014
5251
  #
5015
- # If you do not specify an operating system value, the default patch
5252
+ # If you don't specify an operating system value, the default patch
5016
5253
  # baseline for Windows is returned.
5017
5254
  #
5018
5255
  # @option params [String] :operating_system
@@ -5044,15 +5281,27 @@ module Aws::SSM
5044
5281
  end
5045
5282
 
5046
5283
  # Retrieves the current snapshot for the patch baseline the instance
5047
- # uses. This API is primarily used by the AWS-RunPatchBaseline Systems
5048
- # Manager document.
5284
+ # uses. This API is primarily used by the `AWS-RunPatchBaseline` Systems
5285
+ # Manager document (SSM document).
5286
+ #
5287
+ # <note markdown="1"> If you run the command locally, such as with the Command Line
5288
+ # Interface (CLI), the system attempts to use your local AWS credentials
5289
+ # and the operation fails. To avoid this, you can run the command in the
5290
+ # Amazon Web Services Systems Manager console. Use Run Command, a
5291
+ # capability of Amazon Web Services Systems Manager, with an SSM
5292
+ # document that enables you to target an instance with a script or
5293
+ # command. For example, run the command using the `AWS-RunShellScript`
5294
+ # document or the `AWS-RunPowerShellScript` document.
5295
+ #
5296
+ # </note>
5049
5297
  #
5050
5298
  # @option params [required, String] :instance_id
5051
5299
  # The ID of the instance for which the appropriate patch snapshot should
5052
5300
  # be retrieved.
5053
5301
  #
5054
5302
  # @option params [required, String] :snapshot_id
5055
- # The user-defined snapshot ID.
5303
+ # The snapshot ID provided by the user when running
5304
+ # `AWS-RunPatchBaseline`.
5056
5305
  #
5057
5306
  # @option params [Types::BaselineOverride] :baseline_override
5058
5307
  # Defines the basic information about a patch baseline override.
@@ -5128,10 +5377,11 @@ module Aws::SSM
5128
5377
  req.send_request(options)
5129
5378
  end
5130
5379
 
5131
- # Gets the contents of the specified Systems Manager document.
5380
+ # Gets the contents of the specified Amazon Web Services Systems Manager
5381
+ # document (SSM document).
5132
5382
  #
5133
5383
  # @option params [required, String] :name
5134
- # The name of the Systems Manager document.
5384
+ # The name of the SSM document.
5135
5385
  #
5136
5386
  # @option params [String] :version_name
5137
5387
  # An optional field specifying the version of the artifact associated
@@ -5148,6 +5398,8 @@ module Aws::SSM
5148
5398
  # @return [Types::GetDocumentResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5149
5399
  #
5150
5400
  # * {Types::GetDocumentResult#name #name} => String
5401
+ # * {Types::GetDocumentResult#created_date #created_date} => Time
5402
+ # * {Types::GetDocumentResult#display_name #display_name} => String
5151
5403
  # * {Types::GetDocumentResult#version_name #version_name} => String
5152
5404
  # * {Types::GetDocumentResult#document_version #document_version} => String
5153
5405
  # * {Types::GetDocumentResult#status #status} => String
@@ -5171,12 +5423,14 @@ module Aws::SSM
5171
5423
  # @example Response structure
5172
5424
  #
5173
5425
  # resp.name #=> String
5426
+ # resp.created_date #=> Time
5427
+ # resp.display_name #=> String
5174
5428
  # resp.version_name #=> String
5175
5429
  # resp.document_version #=> String
5176
5430
  # resp.status #=> String, one of "Creating", "Active", "Updating", "Deleting", "Failed"
5177
5431
  # resp.status_information #=> String
5178
5432
  # resp.content #=> String
5179
- # resp.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate"
5433
+ # resp.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
5180
5434
  # resp.document_format #=> String, one of "YAML", "JSON", "TEXT"
5181
5435
  # resp.requires #=> Array
5182
5436
  # resp.requires[0].name #=> String
@@ -5572,10 +5826,10 @@ module Aws::SSM
5572
5826
 
5573
5827
  # Lists the tasks in a maintenance window.
5574
5828
  #
5575
- # <note markdown="1"> For maintenance window tasks without a specified target, you cannot
5829
+ # <note markdown="1"> For maintenance window tasks without a specified target, you can't
5576
5830
  # supply values for `--max-errors` and `--max-concurrency`. Instead, the
5577
5831
  # system inserts a placeholder value of `1`, which may be reported in
5578
- # the response to this command. These values do not affect the running
5832
+ # the response to this command. These values don't affect the running
5579
5833
  # of your task and can be ignored.
5580
5834
  #
5581
5835
  # </note>
@@ -5669,15 +5923,16 @@ module Aws::SSM
5669
5923
  end
5670
5924
 
5671
5925
  # Get information about an OpsItem by using the ID. You must have
5672
- # permission in AWS Identity and Access Management (IAM) to view
5673
- # information about an OpsItem. For more information, see [Getting
5674
- # started with OpsCenter][1] in the *AWS Systems Manager User Guide*.
5675
- #
5676
- # Operations engineers and IT professionals use OpsCenter to view,
5677
- # investigate, and remediate operational issues impacting the
5678
- # performance and health of their AWS resources. For more information,
5679
- # see [AWS Systems Manager OpsCenter][2] in the *AWS Systems Manager
5680
- # User Guide*.
5926
+ # permission in Identity and Access Management (IAM) to view information
5927
+ # about an OpsItem. For more information, see [Getting started with
5928
+ # OpsCenter][1] in the *Amazon Web Services Systems Manager User Guide*.
5929
+ #
5930
+ # Operations engineers and IT professionals use Amazon Web Services
5931
+ # Systems Manager OpsCenter to view, investigate, and remediate
5932
+ # operational issues impacting the performance and health of their
5933
+ # Amazon Web Services resources. For more information, see
5934
+ # [OpsCenter][2] in the *Amazon Web Services Systems Manager User
5935
+ # Guide*.
5681
5936
  #
5682
5937
  #
5683
5938
  #
@@ -5710,7 +5965,7 @@ module Aws::SSM
5710
5965
  # resp.ops_item.priority #=> Integer
5711
5966
  # resp.ops_item.related_ops_items #=> Array
5712
5967
  # resp.ops_item.related_ops_items[0].ops_item_id #=> String
5713
- # resp.ops_item.status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Rejected"
5968
+ # resp.ops_item.status #=> String, one of "Open", "InProgress", "Resolved", "Pending", "TimedOut", "Cancelling", "Cancelled", "Failed", "CompletedWithSuccess", "CompletedWithFailure", "Scheduled", "RunbookInProgress", "PendingChangeCalendarOverride", "ChangeCalendarOverrideApproved", "ChangeCalendarOverrideRejected", "PendingApproval", "Approved", "Rejected", "Closed"
5714
5969
  # resp.ops_item.ops_item_id #=> String
5715
5970
  # resp.ops_item.version #=> String
5716
5971
  # resp.ops_item.title #=> String
@@ -5779,20 +6034,25 @@ module Aws::SSM
5779
6034
  req.send_request(options)
5780
6035
  end
5781
6036
 
5782
- # View a summary of OpsItems based on specified filters and aggregators.
6037
+ # View a summary of operations metadata (OpsData) based on specified
6038
+ # filters and aggregators. OpsData can include information about Amazon
6039
+ # Web Services Systems Manager OpsCenter operational workitems
6040
+ # (OpsItems) as well as information about any Amazon Web Services
6041
+ # resource or service configured to report OpsData to Amazon Web
6042
+ # Services Systems Manager Explorer.
5783
6043
  #
5784
6044
  # @option params [String] :sync_name
5785
6045
  # Specify the name of a resource data sync to get.
5786
6046
  #
5787
6047
  # @option params [Array<Types::OpsFilter>] :filters
5788
- # Optional filters used to scope down the returned OpsItems.
6048
+ # Optional filters used to scope down the returned OpsData.
5789
6049
  #
5790
6050
  # @option params [Array<Types::OpsAggregator>] :aggregators
5791
- # Optional aggregators that return counts of OpsItems based on one or
6051
+ # Optional aggregators that return counts of OpsData based on one or
5792
6052
  # more expressions.
5793
6053
  #
5794
6054
  # @option params [Array<Types::OpsResultAttribute>] :result_attributes
5795
- # The OpsItem data type to return.
6055
+ # The OpsData data type to return.
5796
6056
  #
5797
6057
  # @option params [String] :next_token
5798
6058
  # A token to start the list. Use this token to get the next set of
@@ -5871,14 +6131,14 @@ module Aws::SSM
5871
6131
  end
5872
6132
 
5873
6133
  # Get information about a parameter by using the parameter name. Don't
5874
- # confuse this API action with the GetParameters API action.
6134
+ # confuse this API operation with the GetParameters API operation.
5875
6135
  #
5876
6136
  # @option params [required, String] :name
5877
6137
  # The name of the parameter you want to query.
5878
6138
  #
5879
6139
  # @option params [Boolean] :with_decryption
5880
6140
  # Return decrypted values for secure string parameters. This flag is
5881
- # ignored for String and StringList parameter types.
6141
+ # ignored for `String` and `StringList` parameter types.
5882
6142
  #
5883
6143
  # @return [Types::GetParameterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5884
6144
  #
@@ -5919,7 +6179,7 @@ module Aws::SSM
5919
6179
  #
5920
6180
  # @option params [Boolean] :with_decryption
5921
6181
  # Return decrypted values for secure string parameters. This flag is
5922
- # ignored for String and StringList parameter types.
6182
+ # ignored for `String` and `StringList` parameter types.
5923
6183
  #
5924
6184
  # @option params [Integer] :max_results
5925
6185
  # The maximum number of items to return for this call. The call also
@@ -5977,16 +6237,16 @@ module Aws::SSM
5977
6237
  req.send_request(options)
5978
6238
  end
5979
6239
 
5980
- # Get details of a parameter. Don't confuse this API action with the
5981
- # GetParameter API action.
6240
+ # Get details of a parameter. Don't confuse this API operation with the
6241
+ # GetParameter API operation.
5982
6242
  #
5983
6243
  # @option params [required, Array<String>] :names
5984
6244
  # Names of the parameters for which you want to query information.
5985
6245
  #
5986
6246
  # @option params [Boolean] :with_decryption
5987
6247
  # Return decrypted secure string value. Return decrypted values for
5988
- # secure string parameters. This flag is ignored for String and
5989
- # StringList parameter types.
6248
+ # secure string parameters. This flag is ignored for `String` and
6249
+ # `StringList` parameter types.
5990
6250
  #
5991
6251
  # @return [Types::GetParametersResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5992
6252
  #
@@ -6027,7 +6287,7 @@ module Aws::SSM
6027
6287
  # Retrieve information about one or more parameters in a specific
6028
6288
  # hierarchy.
6029
6289
  #
6030
- # <note markdown="1"> Request results are returned on a best-effort basis. If you specify
6290
+ # Request results are returned on a best-effort basis. If you specify
6031
6291
  # `MaxResults` in the request, the response includes information up to
6032
6292
  # the limit specified. The number of items returned, however, can be
6033
6293
  # between zero and the value of `MaxResults`. If the service reaches an
@@ -6036,13 +6296,11 @@ module Aws::SSM
6036
6296
  # You can specify the `NextToken` in a subsequent call to get the next
6037
6297
  # set of results.
6038
6298
  #
6039
- # </note>
6040
- #
6041
6299
  # @option params [required, String] :path
6042
6300
  # The hierarchy for the parameter. Hierarchies start with a forward
6043
6301
  # slash (/). The hierachy is the parameter name except the last part of
6044
6302
  # the parameter. For the API call to succeeed, the last part of the
6045
- # parameter name cannot be in the path. A parameter name hierarchy can
6303
+ # parameter name can't be in the path. A parameter name hierarchy can
6046
6304
  # have a maximum of 15 levels. Here is an example of a hierarchy:
6047
6305
  # `/Finance/Prod/IAD/WinServ2016/license33 `
6048
6306
  #
@@ -6053,7 +6311,7 @@ module Aws::SSM
6053
6311
  # that path. For example, if a user has permission to access path `/a`,
6054
6312
  # then the user can also access `/a/b`. Even if a user has explicitly
6055
6313
  # been denied access in IAM for parameter `/a/b`, they can still call
6056
- # the GetParametersByPath API action recursively for `/a` and view
6314
+ # the GetParametersByPath API operation recursively for `/a` and view
6057
6315
  # `/a/b`.
6058
6316
  #
6059
6317
  # @option params [Array<Types::ParameterStringFilter>] :parameter_filters
@@ -6238,31 +6496,41 @@ module Aws::SSM
6238
6496
  req.send_request(options)
6239
6497
  end
6240
6498
 
6241
- # `ServiceSetting` is an account-level setting for an AWS service. This
6242
- # setting defines how a user interacts with or uses a service or a
6243
- # feature of a service. For example, if an AWS service charges money to
6244
- # the account based on feature or service usage, then the AWS service
6245
- # team might create a default setting of "false". This means the user
6246
- # can't use this feature unless they change the setting to "true" and
6247
- # intentionally opt in for a paid feature.
6499
+ # `ServiceSetting` is an account-level setting for an Amazon Web
6500
+ # Services service. This setting defines how a user interacts with or
6501
+ # uses a service or a feature of a service. For example, if an Amazon
6502
+ # Web Services service charges money to the account based on feature or
6503
+ # service usage, then the Amazon Web Services service team might create
6504
+ # a default setting of `false`. This means the user can't use this
6505
+ # feature unless they change the setting to `true` and intentionally opt
6506
+ # in for a paid feature.
6248
6507
  #
6249
- # Services map a `SettingId` object to a setting value. AWS services
6250
- # teams define the default value for a `SettingId`. You can't create a
6251
- # new `SettingId`, but you can overwrite the default value if you have
6252
- # the `ssm:UpdateServiceSetting` permission for the setting. Use the
6253
- # UpdateServiceSetting API action to change the default setting. Or use
6254
- # the ResetServiceSetting to change the value back to the original value
6255
- # defined by the AWS service team.
6508
+ # Services map a `SettingId` object to a setting value. Amazon Web
6509
+ # Services services teams define the default value for a `SettingId`.
6510
+ # You can't create a new `SettingId`, but you can overwrite the default
6511
+ # value if you have the `ssm:UpdateServiceSetting` permission for the
6512
+ # setting. Use the UpdateServiceSetting API operation to change the
6513
+ # default setting. Or use the ResetServiceSetting to change the value
6514
+ # back to the original value defined by the Amazon Web Services service
6515
+ # team.
6256
6516
  #
6257
6517
  # Query the current service setting for the account.
6258
6518
  #
6259
6519
  # @option params [required, String] :setting_id
6260
- # The ID of the service setting to get. The setting ID can be
6261
- # `/ssm/automation/customer-script-log-destination`,
6262
- # `/ssm/automation/customer-script-log-group-name`,
6263
- # `/ssm/parameter-store/default-parameter-tier`,
6264
- # `/ssm/parameter-store/high-throughput-enabled`, or
6265
- # `/ssm/managed-instance/activation-tier`.
6520
+ # The ID of the service setting to get. The setting ID can be one of the
6521
+ # following.
6522
+ #
6523
+ # * `/ssm/automation/customer-script-log-destination`
6524
+ #
6525
+ # * `/ssm/automation/customer-script-log-group-name`
6526
+ #
6527
+ # * `/ssm/documents/console/public-sharing-permission`
6528
+ #
6529
+ # * `/ssm/parameter-store/default-parameter-tier`
6530
+ #
6531
+ # * `/ssm/parameter-store/high-throughput-enabled`
6532
+ #
6533
+ # * `/ssm/managed-instance/activation-tier`
6266
6534
  #
6267
6535
  # @return [Types::GetServiceSettingResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6268
6536
  #
@@ -6293,10 +6561,10 @@ module Aws::SSM
6293
6561
  end
6294
6562
 
6295
6563
  # A parameter label is a user-defined alias to help you manage different
6296
- # versions of a parameter. When you modify a parameter, Systems Manager
6297
- # automatically saves a new version and increments the version number by
6298
- # one. A label can help you remember the purpose of a parameter when
6299
- # there are multiple versions.
6564
+ # versions of a parameter. When you modify a parameter, Amazon Web
6565
+ # Services Systems Manager automatically saves a new version and
6566
+ # increments the version number by one. A label can help you remember
6567
+ # the purpose of a parameter when there are multiple versions.
6300
6568
  #
6301
6569
  # Parameter labels have the following requirements and restrictions.
6302
6570
  #
@@ -6319,9 +6587,9 @@ module Aws::SSM
6319
6587
  # * Labels can contain letters (case sensitive), numbers, periods (.),
6320
6588
  # hyphens (-), or underscores (\_).
6321
6589
  #
6322
- # * Labels can't begin with a number, "aws," or "ssm" (not case
6590
+ # * Labels can't begin with a number, "`aws`" or "`ssm`" (not case
6323
6591
  # sensitive). If a label fails to meet these requirements, then the
6324
- # label is not associated with a parameter and the system displays it
6592
+ # label isn't associated with a parameter and the system displays it
6325
6593
  # in the list of InvalidLabels.
6326
6594
  #
6327
6595
  # @option params [required, String] :name
@@ -6439,9 +6707,10 @@ module Aws::SSM
6439
6707
  req.send_request(options)
6440
6708
  end
6441
6709
 
6442
- # Returns all State Manager associations in the current AWS account and
6710
+ # Returns all State Manager associations in the current account and
6443
6711
  # Region. You can limit the results to a specific State Manager
6444
- # association document or instance by specifying a filter.
6712
+ # association document or instance by specifying a filter. State Manager
6713
+ # is a capability of Amazon Web Services Systems Manager.
6445
6714
  #
6446
6715
  # @option params [Array<Types::AssociationFilter>] :association_filter_list
6447
6716
  # One or more filters. Use a filter to return a more specific list of
@@ -6450,7 +6719,7 @@ module Aws::SSM
6450
6719
  # <note markdown="1"> Filtering associations using the `InstanceID` attribute only returns
6451
6720
  # legacy associations created using the `InstanceID` attribute.
6452
6721
  # Associations targeting the instance that are part of the Target
6453
- # Attributes `ResourceGroup` or `Tags` are not returned.
6722
+ # Attributes `ResourceGroup` or `Tags` aren't returned.
6454
6723
  #
6455
6724
  # </note>
6456
6725
  #
@@ -6515,9 +6784,9 @@ module Aws::SSM
6515
6784
 
6516
6785
  # An invocation is copy of a command sent to a specific instance. A
6517
6786
  # command can apply to one or more instances. A command invocation
6518
- # applies to one instance. For example, if a user runs SendCommand
6787
+ # applies to one instance. For example, if a user runs `SendCommand`
6519
6788
  # against three instances, then a command invocation is created for each
6520
- # requested instance ID. ListCommandInvocations provide status about
6789
+ # requested instance ID. `ListCommandInvocations` provide status about
6521
6790
  # command execution.
6522
6791
  #
6523
6792
  # @option params [String] :command_id
@@ -6541,7 +6810,7 @@ module Aws::SSM
6541
6810
  #
6542
6811
  # @option params [Boolean] :details
6543
6812
  # (Optional) If set this returns the response of the command executions
6544
- # and any command output. The default value is 'false'.
6813
+ # and any command output. The default value is `false`.
6545
6814
  #
6546
6815
  # @return [Types::ListCommandInvocationsResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6547
6816
  #
@@ -6612,7 +6881,7 @@ module Aws::SSM
6612
6881
  req.send_request(options)
6613
6882
  end
6614
6883
 
6615
- # Lists the commands requested by users of the AWS account.
6884
+ # Lists the commands requested by users of the account.
6616
6885
  #
6617
6886
  # @option params [String] :command_id
6618
6887
  # (Optional) If provided, lists only the specified command.
@@ -6621,7 +6890,7 @@ module Aws::SSM
6621
6890
  # (Optional) Lists commands issued against this instance ID.
6622
6891
  #
6623
6892
  # <note markdown="1"> You can't specify an instance ID in the same command that you specify
6624
- # `Status` = `Pending`. This is because the command has not reached the
6893
+ # `Status` = `Pending`. This is because the command hasn't reached the
6625
6894
  # instance yet.
6626
6895
  #
6627
6896
  # </note>
@@ -6709,7 +6978,7 @@ module Aws::SSM
6709
6978
  req.send_request(options)
6710
6979
  end
6711
6980
 
6712
- # For a specified resource ID, this API action returns a list of
6981
+ # For a specified resource ID, this API operation returns a list of
6713
6982
  # compliance statuses for different resource types. Currently, you can
6714
6983
  # only specify one resource ID per call. List results depend on the
6715
6984
  # criteria specified in the filter.
@@ -6949,6 +7218,7 @@ module Aws::SSM
6949
7218
  #
6950
7219
  # resp.document_versions #=> Array
6951
7220
  # resp.document_versions[0].name #=> String
7221
+ # resp.document_versions[0].display_name #=> String
6952
7222
  # resp.document_versions[0].document_version #=> String
6953
7223
  # resp.document_versions[0].version_name #=> String
6954
7224
  # resp.document_versions[0].created_date #=> Time
@@ -6968,9 +7238,8 @@ module Aws::SSM
6968
7238
  req.send_request(options)
6969
7239
  end
6970
7240
 
6971
- # Returns all Systems Manager (SSM) documents in the current AWS account
6972
- # and Region. You can limit the results of this request by using a
6973
- # filter.
7241
+ # Returns all Systems Manager (SSM) documents in the current account and
7242
+ # Region. You can limit the results of this request by using a filter.
6974
7243
  #
6975
7244
  # @option params [Array<Types::DocumentFilter>] :document_filter_list
6976
7245
  # This data type is deprecated. Instead, use `Filters`.
@@ -6984,7 +7253,7 @@ module Aws::SSM
6984
7253
  # `Key=Owner,Values=Self`. To specify a custom key-value pair, use the
6985
7254
  # format `Key=tag:tagName,Values=valueName`.
6986
7255
  #
6987
- # <note markdown="1"> This API action only supports filtering documents by using a single
7256
+ # <note markdown="1"> This API operation only supports filtering documents by using a single
6988
7257
  # tag key and one or more tag values. For example:
6989
7258
  # `Key=tag:tagName,Values=valueName1,valueName2`
6990
7259
  #
@@ -7029,12 +7298,14 @@ module Aws::SSM
7029
7298
  #
7030
7299
  # resp.document_identifiers #=> Array
7031
7300
  # resp.document_identifiers[0].name #=> String
7301
+ # resp.document_identifiers[0].created_date #=> Time
7302
+ # resp.document_identifiers[0].display_name #=> String
7032
7303
  # resp.document_identifiers[0].owner #=> String
7033
7304
  # resp.document_identifiers[0].version_name #=> String
7034
7305
  # resp.document_identifiers[0].platform_types #=> Array
7035
7306
  # resp.document_identifiers[0].platform_types[0] #=> String, one of "Windows", "Linux"
7036
7307
  # resp.document_identifiers[0].document_version #=> String
7037
- # resp.document_identifiers[0].document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate"
7308
+ # resp.document_identifiers[0].document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
7038
7309
  # resp.document_identifiers[0].schema_version #=> String
7039
7310
  # resp.document_identifiers[0].document_format #=> String, one of "YAML", "JSON", "TEXT"
7040
7311
  # resp.document_identifiers[0].target_type #=> String
@@ -7084,7 +7355,7 @@ module Aws::SSM
7084
7355
  # * {Types::ListInventoryEntriesResult#instance_id #instance_id} => String
7085
7356
  # * {Types::ListInventoryEntriesResult#schema_version #schema_version} => String
7086
7357
  # * {Types::ListInventoryEntriesResult#capture_time #capture_time} => String
7087
- # * {Types::ListInventoryEntriesResult#entries #entries} => Array&lt;Hash&lt;String,String&gt;&gt;
7358
+ # * {Types::ListInventoryEntriesResult#entries #data.entries} => Array&lt;Hash&lt;String,String&gt;&gt; (This method conflicts with a method on Response, call it through the data member)
7088
7359
  # * {Types::ListInventoryEntriesResult#next_token #next_token} => String
7089
7360
  #
7090
7361
  # @example Request syntax with placeholder values
@@ -7109,9 +7380,9 @@ module Aws::SSM
7109
7380
  # resp.instance_id #=> String
7110
7381
  # resp.schema_version #=> String
7111
7382
  # resp.capture_time #=> String
7112
- # resp.entries #=> Array
7113
- # resp.entries[0] #=> Hash
7114
- # resp.entries[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
7383
+ # resp.data.entries #=> Array
7384
+ # resp.data.entries[0] #=> Hash
7385
+ # resp.data.entries[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
7115
7386
  # resp.next_token #=> String
7116
7387
  #
7117
7388
  # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListInventoryEntries AWS API Documentation
@@ -7123,8 +7394,8 @@ module Aws::SSM
7123
7394
  req.send_request(options)
7124
7395
  end
7125
7396
 
7126
- # Returns a list of all OpsItem events in the current AWS account and
7127
- # Region. You can limit the results to events associated with specific
7397
+ # Returns a list of all OpsItem events in the current Region and
7398
+ # account. You can limit the results to events associated with specific
7128
7399
  # OpsItems by specifying a filter.
7129
7400
  #
7130
7401
  # @option params [Array<Types::OpsItemEventFilter>] :filters
@@ -7182,8 +7453,72 @@ module Aws::SSM
7182
7453
  req.send_request(options)
7183
7454
  end
7184
7455
 
7185
- # Systems Manager calls this API action when displaying all Application
7186
- # Manager OpsMetadata objects or blobs.
7456
+ # Lists all related-item resources associated with an OpsItem.
7457
+ #
7458
+ # @option params [String] :ops_item_id
7459
+ # The ID of the OpsItem for which you want to list all related-item
7460
+ # resources.
7461
+ #
7462
+ # @option params [Array<Types::OpsItemRelatedItemsFilter>] :filters
7463
+ # One or more OpsItem filters. Use a filter to return a more specific
7464
+ # list of results.
7465
+ #
7466
+ # @option params [Integer] :max_results
7467
+ # The maximum number of items to return for this call. The call also
7468
+ # returns a token that you can specify in a subsequent call to get the
7469
+ # next set of results.
7470
+ #
7471
+ # @option params [String] :next_token
7472
+ # The token for the next set of items to return. (You received this
7473
+ # token from a previous call.)
7474
+ #
7475
+ # @return [Types::ListOpsItemRelatedItemsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7476
+ #
7477
+ # * {Types::ListOpsItemRelatedItemsResponse#next_token #next_token} => String
7478
+ # * {Types::ListOpsItemRelatedItemsResponse#summaries #summaries} => Array&lt;Types::OpsItemRelatedItemSummary&gt;
7479
+ #
7480
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7481
+ #
7482
+ # @example Request syntax with placeholder values
7483
+ #
7484
+ # resp = client.list_ops_item_related_items({
7485
+ # ops_item_id: "OpsItemId",
7486
+ # filters: [
7487
+ # {
7488
+ # key: "ResourceType", # required, accepts ResourceType, AssociationId, ResourceUri
7489
+ # values: ["OpsItemRelatedItemsFilterValue"], # required
7490
+ # operator: "Equal", # required, accepts Equal
7491
+ # },
7492
+ # ],
7493
+ # max_results: 1,
7494
+ # next_token: "String",
7495
+ # })
7496
+ #
7497
+ # @example Response structure
7498
+ #
7499
+ # resp.next_token #=> String
7500
+ # resp.summaries #=> Array
7501
+ # resp.summaries[0].ops_item_id #=> String
7502
+ # resp.summaries[0].association_id #=> String
7503
+ # resp.summaries[0].resource_type #=> String
7504
+ # resp.summaries[0].association_type #=> String
7505
+ # resp.summaries[0].resource_uri #=> String
7506
+ # resp.summaries[0].created_by.arn #=> String
7507
+ # resp.summaries[0].created_time #=> Time
7508
+ # resp.summaries[0].last_modified_by.arn #=> String
7509
+ # resp.summaries[0].last_modified_time #=> Time
7510
+ #
7511
+ # @see http://docs.aws.amazon.com/goto/WebAPI/ssm-2014-11-06/ListOpsItemRelatedItems AWS API Documentation
7512
+ #
7513
+ # @overload list_ops_item_related_items(params = {})
7514
+ # @param [Hash] params ({})
7515
+ def list_ops_item_related_items(params = {}, options = {})
7516
+ req = build_request(:list_ops_item_related_items, params)
7517
+ req.send_request(options)
7518
+ end
7519
+
7520
+ # Amazon Web Services Systems Manager calls this API operation when
7521
+ # displaying all Application Manager OpsMetadata objects or blobs.
7187
7522
  #
7188
7523
  # @option params [Array<Types::OpsMetadataFilter>] :filters
7189
7524
  # One or more filters to limit the number of OpsMetadata objects
@@ -7329,7 +7664,7 @@ module Aws::SSM
7329
7664
  # View a list of resource data syncs according to the sync type. Specify
7330
7665
  # `SyncToDestination` to view resource data syncs that synchronize data
7331
7666
  # to an Amazon S3 bucket. Specify `SyncFromSource` to view resource data
7332
- # syncs from AWS Organizations or from multiple AWS Regions.
7667
+ # syncs from Organizations or from multiple Regions.
7333
7668
  #
7334
7669
  # @option params [String] :next_token
7335
7670
  # A token to start the list. Use this token to get the next set of
@@ -7394,6 +7729,9 @@ module Aws::SSM
7394
7729
 
7395
7730
  # Returns a list of the tags assigned to the specified resource.
7396
7731
  #
7732
+ # For information about the ID format for each supported resource type,
7733
+ # see AddTagsToResource.
7734
+ #
7397
7735
  # @option params [required, String] :resource_type
7398
7736
  # Returns a list of tags for a specific resource type.
7399
7737
  #
@@ -7426,10 +7764,11 @@ module Aws::SSM
7426
7764
  req.send_request(options)
7427
7765
  end
7428
7766
 
7429
- # Shares a Systems Manager document publicly or privately. If you share
7430
- # a document privately, you must specify the AWS user account IDs for
7431
- # those people who can use the document. If you share a document
7432
- # publicly, you must specify *All* as the account ID.
7767
+ # Shares a Amazon Web Services Systems Manager document (SSM
7768
+ # document)publicly or privately. If you share a document privately, you
7769
+ # must specify the Amazon Web Services user account IDs for those people
7770
+ # who can use the document. If you share a document publicly, you must
7771
+ # specify *All* as the account ID.
7433
7772
  #
7434
7773
  # @option params [required, String] :name
7435
7774
  # The name of the document that you want to share.
@@ -7439,18 +7778,19 @@ module Aws::SSM
7439
7778
  # *Share*.
7440
7779
  #
7441
7780
  # @option params [Array<String>] :account_ids_to_add
7442
- # The AWS user accounts that should have access to the document. The
7443
- # account IDs can either be a group of account IDs or *All*.
7781
+ # The Amazon Web Services user accounts that should have access to the
7782
+ # document. The account IDs can either be a group of account IDs or
7783
+ # *All*.
7444
7784
  #
7445
7785
  # @option params [Array<String>] :account_ids_to_remove
7446
- # The AWS user accounts that should no longer have access to the
7447
- # document. The AWS user account can either be a group of account IDs or
7448
- # *All*. This action has a higher priority than *AccountIdsToAdd*. If
7449
- # you specify an account ID to add and the same ID to remove, the system
7450
- # removes access to the document.
7786
+ # The Amazon Web Services user accounts that should no longer have
7787
+ # access to the document. The Amazon Web Services user account can
7788
+ # either be a group of account IDs or *All*. This action has a higher
7789
+ # priority than *AccountIdsToAdd*. If you specify an account ID to add
7790
+ # and the same ID to remove, the system removes access to the document.
7451
7791
  #
7452
7792
  # @option params [String] :shared_document_version
7453
- # (Optional) The version of the document to share. If it's not
7793
+ # (Optional) The version of the document to share. If it isn't
7454
7794
  # specified, the system choose the `Default` version to share.
7455
7795
  #
7456
7796
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -7475,10 +7815,10 @@ module Aws::SSM
7475
7815
  end
7476
7816
 
7477
7817
  # Registers a compliance type and other compliance details on a
7478
- # designated resource. This action lets you register custom compliance
7479
- # details with a resource. This call overwrites existing compliance
7480
- # information on the resource, so you must provide a full list of
7481
- # compliance items each time that you send the request.
7818
+ # designated resource. This operation lets you register custom
7819
+ # compliance details with a resource. This call overwrites existing
7820
+ # compliance information on the resource, so you must provide a full
7821
+ # list of compliance items each time that you send the request.
7482
7822
  #
7483
7823
  # ComplianceType can be one of the following:
7484
7824
  #
@@ -7499,8 +7839,8 @@ module Aws::SSM
7499
7839
  #
7500
7840
  # * Severity: A patch severity. For example, `critical`.
7501
7841
  #
7502
- # * DocumentName: A SSM document name. For example,
7503
- # AWS-RunPatchBaseline.
7842
+ # * DocumentName: An SSM document name. For example,
7843
+ # `AWS-RunPatchBaseline`.
7504
7844
  #
7505
7845
  # * DocumentVersion: An SSM document version number. For example, 4.
7506
7846
  #
@@ -7662,9 +8002,9 @@ module Aws::SSM
7662
8002
  #
7663
8003
  # * Parameter names are case sensitive.
7664
8004
  #
7665
- # * A parameter name must be unique within an AWS Region
8005
+ # * A parameter name must be unique within an Region
7666
8006
  #
7667
- # * A parameter name can't be prefixed with "aws" or "ssm"
8007
+ # * A parameter name can't be prefixed with "`aws`" or "`ssm`"
7668
8008
  # (case-insensitive).
7669
8009
  #
7670
8010
  # * Parameter names can include only the following symbols and letters:
@@ -7680,11 +8020,11 @@ module Aws::SSM
7680
8020
  # levels.
7681
8021
  #
7682
8022
  # For additional information about valid values for parameter names, see
7683
- # [Creating Systems Manager parameters][1] in the *AWS Systems Manager
7684
- # User Guide*.
8023
+ # [Creating Systems Manager parameters][1] in the *Amazon Web Services
8024
+ # Systems Manager User Guide*.
7685
8025
  #
7686
8026
  # <note markdown="1"> The maximum length constraint listed below includes capacity for
7687
- # additional system attributes that are not part of the name. The
8027
+ # additional system attributes that aren't part of the name. The
7688
8028
  # maximum length for a parameter name, including the full length of the
7689
8029
  # parameter ARN, is 1011 characters. For example, the length of the
7690
8030
  # following parameter name is 65 characters, not 20 characters:
@@ -7701,7 +8041,7 @@ module Aws::SSM
7701
8041
  # Information about the parameter that you want to add to the system.
7702
8042
  # Optional but recommended.
7703
8043
  #
7704
- # Do not enter personally identifiable information in this field.
8044
+ # Don't enter personally identifiable information in this field.
7705
8045
  #
7706
8046
  # @option params [required, String] :value
7707
8047
  # The parameter value that you want to add to the system. Standard
@@ -7717,7 +8057,7 @@ module Aws::SSM
7717
8057
  # @option params [String] :type
7718
8058
  # The type of parameter that you want to add to the system.
7719
8059
  #
7720
- # <note markdown="1"> `SecureString` is not currently supported for AWS CloudFormation
8060
+ # <note markdown="1"> `SecureString` isn't currently supported for CloudFormation
7721
8061
  # templates.
7722
8062
  #
7723
8063
  # </note>
@@ -7727,28 +8067,27 @@ module Aws::SSM
7727
8067
  # list. If you have a parameter value that requires a comma, then use
7728
8068
  # the `String` data type.
7729
8069
  #
7730
- # Specifying a parameter type is not required when updating a parameter.
8070
+ # Specifying a parameter type isn't required when updating a parameter.
7731
8071
  # You must specify a parameter type when creating a parameter.
7732
8072
  #
7733
8073
  # @option params [String] :key_id
7734
- # The KMS Key ID that you want to use to encrypt a parameter. Either the
7735
- # default AWS Key Management Service (AWS KMS) key automatically
7736
- # assigned to your AWS account or a custom key. Required for parameters
7737
- # that use the `SecureString` data type.
8074
+ # The Key Management Service (KMS) ID that you want to use to encrypt a
8075
+ # parameter. Either the default KMS key automatically assigned to your
8076
+ # account or a custom key. Required for parameters that use the
8077
+ # `SecureString` data type.
7738
8078
  #
7739
8079
  # If you don't specify a key ID, the system uses the default key
7740
- # associated with your AWS account.
8080
+ # associated with your account.
7741
8081
  #
7742
- # * To use your default AWS KMS key, choose the `SecureString` data
7743
- # type, and do *not* specify the `Key ID` when you create the
7744
- # parameter. The system automatically populates `Key ID` with your
7745
- # default KMS key.
8082
+ # * To use your default KMS key, choose the `SecureString` data type,
8083
+ # and do *not* specify the `Key ID` when you create the parameter. The
8084
+ # system automatically populates `Key ID` with your default KMS key.
7746
8085
  #
7747
8086
  # * To use a custom KMS key, choose the `SecureString` data type with
7748
8087
  # the `Key ID` parameter.
7749
8088
  #
7750
8089
  # @option params [Boolean] :overwrite
7751
- # Overwrite an existing parameter. The default value is 'false'.
8090
+ # Overwrite an existing parameter. The default value is `false`.
7752
8091
  #
7753
8092
  # @option params [String] :allowed_pattern
7754
8093
  # A regular expression used to validate the parameter value. For
@@ -7761,8 +8100,8 @@ module Aws::SSM
7761
8100
  # environment. For example, you might want to tag a Systems Manager
7762
8101
  # parameter to identify the type of resource to which it applies, the
7763
8102
  # environment, or the type of configuration data referenced by the
7764
- # parameter. In this case, you could specify the following key
7765
- # name/value pairs:
8103
+ # parameter. In this case, you could specify the following key-value
8104
+ # pairs:
7766
8105
  #
7767
8106
  # * `Key=Resource,Value=S3bucket`
7768
8107
  #
@@ -7771,7 +8110,7 @@ module Aws::SSM
7771
8110
  # * `Key=ParameterType,Value=LicenseKey`
7772
8111
  #
7773
8112
  # <note markdown="1"> To add tags to an existing Systems Manager parameter, use the
7774
- # AddTagsToResource action.
8113
+ # AddTagsToResource operation.
7775
8114
  #
7776
8115
  # </note>
7777
8116
  #
@@ -7781,15 +8120,15 @@ module Aws::SSM
7781
8120
  # Parameter Store offers a standard tier and an advanced tier for
7782
8121
  # parameters. Standard parameters have a content size limit of 4 KB and
7783
8122
  # can't be configured to use parameter policies. You can create a
7784
- # maximum of 10,000 standard parameters for each Region in an AWS
7785
- # account. Standard parameters are offered at no additional cost.
8123
+ # maximum of 10,000 standard parameters for each Region in an account.
8124
+ # Standard parameters are offered at no additional cost.
7786
8125
  #
7787
8126
  # Advanced parameters have a content size limit of 8 KB and can be
7788
8127
  # configured to use parameter policies. You can create a maximum of
7789
- # 100,000 advanced parameters for each Region in an AWS account.
7790
- # Advanced parameters incur a charge. For more information, see
7791
- # [Standard and advanced parameter tiers][1] in the *AWS Systems Manager
7792
- # User Guide*.
8128
+ # 100,000 advanced parameters for each Region in an account. Advanced
8129
+ # parameters incur a charge. For more information, see [Standard and
8130
+ # advanced parameter tiers][1] in the *Amazon Web Services Systems
8131
+ # Manager User Guide*.
7793
8132
  #
7794
8133
  # You can change a standard parameter to an advanced parameter any time.
7795
8134
  # But you can't revert an advanced parameter to a standard parameter.
@@ -7808,7 +8147,7 @@ module Aws::SSM
7808
8147
  # In `PutParameter` requests, you can specify the tier to create the
7809
8148
  # parameter in. Whenever you specify a tier in the request, Parameter
7810
8149
  # Store creates or updates the parameter according to that request.
7811
- # However, if you do not specify a tier in a request, Parameter Store
8150
+ # However, if you don't specify a tier in a request, Parameter Store
7812
8151
  # assigns the tier based on the current Parameter Store default tier
7813
8152
  # configuration.
7814
8153
  #
@@ -7839,12 +8178,12 @@ module Aws::SSM
7839
8178
  #
7840
8179
  # * The parameter uses a parameter policy.
7841
8180
  #
7842
- # * More than 10,000 parameters already exist in your AWS account in the
8181
+ # * More than 10,000 parameters already exist in your account in the
7843
8182
  # current Region.
7844
8183
  #
7845
8184
  # For more information about configuring the default tier option, see
7846
- # [Specifying a default parameter tier][2] in the *AWS Systems Manager
7847
- # User Guide*.
8185
+ # [Specifying a default parameter tier][2] in the *Amazon Web Services
8186
+ # Systems Manager User Guide*.
7848
8187
  #
7849
8188
  #
7850
8189
  #
@@ -7852,13 +8191,14 @@ module Aws::SSM
7852
8191
  # [2]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ps-default-tier.html
7853
8192
  #
7854
8193
  # @option params [String] :policies
7855
- # One or more policies to apply to a parameter. This action takes a JSON
7856
- # array. Parameter Store supports the following policy types:
8194
+ # One or more policies to apply to a parameter. This operation takes a
8195
+ # JSON array. Parameter Store, a capability of Amazon Web Services
8196
+ # Systems Manager supports the following policy types:
7857
8197
  #
7858
8198
  # Expiration: This policy deletes the parameter after it expires. When
7859
8199
  # you create the policy, you specify the expiration date. You can update
7860
8200
  # the expiration date and time by updating the policy. Updating the
7861
- # *parameter* does not affect the expiration date and time. When the
8201
+ # *parameter* doesn't affect the expiration date and time. When the
7862
8202
  # expiration time is reached, Parameter Store deletes the parameter.
7863
8203
  #
7864
8204
  # ExpirationNotification: This policy triggers an event in Amazon
@@ -7866,10 +8206,10 @@ module Aws::SSM
7866
8206
  # this policy, you can receive notification before or after the
7867
8207
  # expiration time is reached, in units of days or hours.
7868
8208
  #
7869
- # NoChangeNotification: This policy triggers a CloudWatch event if a
7870
- # parameter has not been modified for a specified period of time. This
7871
- # policy type is useful when, for example, a secret needs to be changed
7872
- # within a period of time, but it has not been changed.
8209
+ # NoChangeNotification: This policy triggers a CloudWatch Events event
8210
+ # if a parameter hasn't been modified for a specified period of time.
8211
+ # This policy type is useful when, for example, a secret needs to be
8212
+ # changed within a period of time, but it hasn't been changed.
7873
8213
  #
7874
8214
  # All existing policies are preserved until you send new policies or an
7875
8215
  # empty policy. For more information about parameter policies, see
@@ -7881,7 +8221,7 @@ module Aws::SSM
7881
8221
  #
7882
8222
  # @option params [String] :data_type
7883
8223
  # The data type for a `String` parameter. Supported data types include
7884
- # plain text and Amazon Machine Image IDs.
8224
+ # plain text and Amazon Machine Image (AMI) IDs.
7885
8225
  #
7886
8226
  # **The following data type values are supported.**
7887
8227
  #
@@ -7890,15 +8230,15 @@ module Aws::SSM
7890
8230
  # * `aws:ec2:image`
7891
8231
  #
7892
8232
  # When you create a `String` parameter and specify `aws:ec2:image`,
7893
- # Systems Manager validates the parameter value is in the required
7894
- # format, such as `ami-12345abcdeEXAMPLE`, and that the specified AMI is
7895
- # available in your AWS account. For more information, see [Native
7896
- # parameter support for Amazon Machine Image IDs][1] in the *AWS Systems
7897
- # Manager User Guide*.
8233
+ # Amazon Web Services Systems Manager validates the parameter value is
8234
+ # in the required format, such as `ami-12345abcdeEXAMPLE`, and that the
8235
+ # specified AMI is available in your account. For more information, see
8236
+ # [Native parameter support for Amazon Machine Image (AMI) IDs][1] in
8237
+ # the *Amazon Web Services Systems Manager User Guide*.
7898
8238
  #
7899
8239
  #
7900
8240
  #
7901
- # [1]: http://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html
8241
+ # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html
7902
8242
  #
7903
8243
  # @return [Types::PutParameterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7904
8244
  #
@@ -7942,9 +8282,9 @@ module Aws::SSM
7942
8282
 
7943
8283
  # Defines the default patch baseline for the relevant operating system.
7944
8284
  #
7945
- # To reset the AWS predefined patch baseline as the default, specify the
7946
- # full patch baseline ARN as the baseline ID value. For example, for
7947
- # CentOS, specify
8285
+ # To reset the Amazon Web Services-predefined patch baseline as the
8286
+ # default, specify the full patch baseline Amazon Resource Name (ARN) as
8287
+ # the baseline ID value. For example, for CentOS, specify
7948
8288
  # `arn:aws:ssm:us-east-2:733109147000:patchbaseline/pb-0574b43a65ea646ed`
7949
8289
  # instead of `pb-0574b43a65ea646ed`.
7950
8290
  #
@@ -7978,11 +8318,10 @@ module Aws::SSM
7978
8318
  # Registers a patch baseline for a patch group.
7979
8319
  #
7980
8320
  # @option params [required, String] :baseline_id
7981
- # The ID of the patch baseline to register the patch group with.
8321
+ # The ID of the patch baseline to register with the patch group.
7982
8322
  #
7983
8323
  # @option params [required, String] :patch_group
7984
- # The name of the patch group that should be registered with the patch
7985
- # baseline.
8324
+ # The name of the patch group to be registered with the patch baseline.
7986
8325
  #
7987
8326
  # @return [Types::RegisterPatchBaselineForPatchGroupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7988
8327
  #
@@ -8064,16 +8403,17 @@ module Aws::SSM
8064
8403
  #
8065
8404
  # For more information about these examples formats, including the best
8066
8405
  # use case for each one, see [Examples: Register targets with a
8067
- # maintenance window][1] in the *AWS Systems Manager User Guide*.
8406
+ # maintenance window][1] in the *Amazon Web Services Systems Manager
8407
+ # User Guide*.
8068
8408
  #
8069
8409
  #
8070
8410
  #
8071
8411
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/mw-cli-tutorial-targets-examples.html
8072
8412
  #
8073
8413
  # @option params [String] :owner_information
8074
- # User-provided value that will be included in any CloudWatch events
8075
- # raised while running tasks for these targets in this maintenance
8076
- # window.
8414
+ # User-provided value that will be included in any Amazon CloudWatch
8415
+ # Events events raised while running tasks for these targets in this
8416
+ # maintenance window.
8077
8417
  #
8078
8418
  # @option params [String] :name
8079
8419
  # An optional name for the target.
@@ -8131,10 +8471,10 @@ module Aws::SSM
8131
8471
  #
8132
8472
  # <note markdown="1"> One or more targets must be specified for maintenance window Run
8133
8473
  # Command-type tasks. Depending on the task, targets are optional for
8134
- # other maintenance window task types (Automation, AWS Lambda, and AWS
8135
- # Step Functions). For more information about running tasks that do not
8474
+ # other maintenance window task types (Automation, Lambda, and Step
8475
+ # Functions). For more information about running tasks that don't
8136
8476
  # specify targets, see [Registering maintenance window tasks without
8137
- # targets][1] in the *AWS Systems Manager User Guide*.
8477
+ # targets][1] in the *Amazon Web Services Systems Manager User Guide*.
8138
8478
  #
8139
8479
  # </note>
8140
8480
  #
@@ -8154,14 +8494,15 @@ module Aws::SSM
8154
8494
  # The ARN of the task to run.
8155
8495
  #
8156
8496
  # @option params [String] :service_role_arn
8157
- # The ARN of the IAM service role for Systems Manager to assume when
8158
- # running a maintenance window task. If you do not specify a service
8159
- # role ARN, Systems Manager uses your account's service-linked role. If
8160
- # no service-linked role for Systems Manager exists in your account, it
8161
- # is created when you run `RegisterTaskWithMaintenanceWindow`.
8497
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon Web
8498
+ # Services Systems Manager to assume when running a maintenance window
8499
+ # task. If you do not specify a service role ARN, Systems Manager uses
8500
+ # your account's service-linked role. If no service-linked role for
8501
+ # Systems Manager exists in your account, it is created when you run
8502
+ # `RegisterTaskWithMaintenanceWindow`.
8162
8503
  #
8163
- # For more information, see the following topics in the in the *AWS
8164
- # Systems Manager User Guide*\:
8504
+ # For more information, see the following topics in the in the *Amazon
8505
+ # Web Services Systems Manager User Guide*\:
8165
8506
  #
8166
8507
  # * [Using service-linked roles for Systems Manager][1]
8167
8508
  #
@@ -8201,9 +8542,9 @@ module Aws::SSM
8201
8542
  # @option params [String] :max_concurrency
8202
8543
  # The maximum number of targets this task can be run for in parallel.
8203
8544
  #
8204
- # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8545
+ # <note markdown="1"> For maintenance window tasks without a target specified, you can't
8205
8546
  # supply a value for this option. Instead, the system inserts a
8206
- # placeholder value of `1`. This value does not affect the running of
8547
+ # placeholder value of `1`. This value doesn't affect the running of
8207
8548
  # your task.
8208
8549
  #
8209
8550
  # </note>
@@ -8212,21 +8553,22 @@ module Aws::SSM
8212
8553
  # The maximum number of errors allowed before this task stops being
8213
8554
  # scheduled.
8214
8555
  #
8215
- # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
8556
+ # <note markdown="1"> For maintenance window tasks without a target specified, you can't
8216
8557
  # supply a value for this option. Instead, the system inserts a
8217
- # placeholder value of `1`. This value does not affect the running of
8558
+ # placeholder value of `1`. This value doesn't affect the running of
8218
8559
  # your task.
8219
8560
  #
8220
8561
  # </note>
8221
8562
  #
8222
8563
  # @option params [Types::LoggingInfo] :logging_info
8223
- # A structure containing information about an S3 bucket to write
8224
- # instance-level logs to.
8225
- #
8226
- # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
8227
- # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
8228
- # options in the `TaskInvocationParameters` structure. For information
8229
- # about how Systems Manager handles these options for the supported
8564
+ # A structure containing information about an Amazon Simple Storage
8565
+ # Service (Amazon S3) bucket to write instance-level logs to.
8566
+ #
8567
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple Storage
8568
+ # Service (Amazon S3) bucket to contain logs, instead use the
8569
+ # `OutputS3BucketName` and `OutputS3KeyPrefix` options in the
8570
+ # `TaskInvocationParameters` structure. For information about how Amazon
8571
+ # Web Services Systems Manager handles these options for the supported
8230
8572
  # maintenance window task types, see
8231
8573
  # MaintenanceWindowTaskInvocationParameters.
8232
8574
  #
@@ -8336,9 +8678,10 @@ module Aws::SSM
8336
8678
  # @option params [required, String] :resource_type
8337
8679
  # The type of resource from which you want to remove a tag.
8338
8680
  #
8339
- # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
8340
- # managed instances. Specify the name of the managed instance in the
8341
- # following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
8681
+ # <note markdown="1"> The `ManagedInstance` type for this API operation is only for
8682
+ # on-premises managed instances. Specify the name of the managed
8683
+ # instance in the following format: `mi-ID_number `. For example,
8684
+ # `mi-1a2b3c4d5e6f`.
8342
8685
  #
8343
8686
  # </note>
8344
8687
  #
@@ -8362,9 +8705,10 @@ module Aws::SSM
8362
8705
  #
8363
8706
  # For the Document and Parameter values, use the name of the resource.
8364
8707
  #
8365
- # <note markdown="1"> The ManagedInstance type for this API action is only for on-premises
8366
- # managed instances. Specify the name of the managed instance in the
8367
- # following format: mi-ID\_number. For example, mi-1a2b3c4d5e6f.
8708
+ # <note markdown="1"> The ManagedInstance type for this API operation is only for
8709
+ # on-premises managed instances. Specify the name of the managed
8710
+ # instance in the following format: mi-ID\_number. For example,
8711
+ # mi-1a2b3c4d5e6f.
8368
8712
  #
8369
8713
  # </note>
8370
8714
  #
@@ -8390,32 +8734,41 @@ module Aws::SSM
8390
8734
  req.send_request(options)
8391
8735
  end
8392
8736
 
8393
- # `ServiceSetting` is an account-level setting for an AWS service. This
8394
- # setting defines how a user interacts with or uses a service or a
8395
- # feature of a service. For example, if an AWS service charges money to
8396
- # the account based on feature or service usage, then the AWS service
8397
- # team might create a default setting of "false". This means the user
8398
- # can't use this feature unless they change the setting to "true" and
8399
- # intentionally opt in for a paid feature.
8737
+ # `ServiceSetting` is an account-level setting for an Amazon Web
8738
+ # Services service. This setting defines how a user interacts with or
8739
+ # uses a service or a feature of a service. For example, if an Amazon
8740
+ # Web Services service charges money to the account based on feature or
8741
+ # service usage, then the Amazon Web Services service team might create
8742
+ # a default setting of "false". This means the user can't use this
8743
+ # feature unless they change the setting to "true" and intentionally
8744
+ # opt in for a paid feature.
8400
8745
  #
8401
- # Services map a `SettingId` object to a setting value. AWS services
8402
- # teams define the default value for a `SettingId`. You can't create a
8403
- # new `SettingId`, but you can overwrite the default value if you have
8404
- # the `ssm:UpdateServiceSetting` permission for the setting. Use the
8405
- # GetServiceSetting API action to view the current value. Use the
8406
- # UpdateServiceSetting API action to change the default setting.
8746
+ # Services map a `SettingId` object to a setting value. Amazon Web
8747
+ # Services services teams define the default value for a `SettingId`.
8748
+ # You can't create a new `SettingId`, but you can overwrite the default
8749
+ # value if you have the `ssm:UpdateServiceSetting` permission for the
8750
+ # setting. Use the GetServiceSetting API operation to view the current
8751
+ # value. Use the UpdateServiceSetting API operation to change the
8752
+ # default setting.
8407
8753
  #
8408
8754
  # Reset the service setting for the account to the default value as
8409
- # provisioned by the AWS service team.
8755
+ # provisioned by the Amazon Web Services service team.
8410
8756
  #
8411
8757
  # @option params [required, String] :setting_id
8412
8758
  # The Amazon Resource Name (ARN) of the service setting to reset. The
8413
- # setting ID can be `/ssm/automation/customer-script-log-destination`,
8414
- # `/ssm/automation/customer-script-log-group-name`,
8415
- # `/ssm/parameter-store/default-parameter-tier`,
8416
- # `/ssm/parameter-store/high-throughput-enabled`, or
8417
- # `/ssm/managed-instance/activation-tier`. For example,
8418
- # `arn:aws:ssm:us-east-1:111122223333:servicesetting/ssm/parameter-store/high-throughput-enabled`.
8759
+ # setting ID can be one of the following.
8760
+ #
8761
+ # * `/ssm/automation/customer-script-log-destination`
8762
+ #
8763
+ # * `/ssm/automation/customer-script-log-group-name`
8764
+ #
8765
+ # * `/ssm/documents/console/public-sharing-permission`
8766
+ #
8767
+ # * `/ssm/parameter-store/default-parameter-tier`
8768
+ #
8769
+ # * `/ssm/parameter-store/high-throughput-enabled`
8770
+ #
8771
+ # * `/ssm/managed-instance/activation-tier`
8419
8772
  #
8420
8773
  # @return [Types::ResetServiceSettingResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8421
8774
  #
@@ -8450,7 +8803,7 @@ module Aws::SSM
8450
8803
  # terminated sessions.
8451
8804
  #
8452
8805
  # <note markdown="1"> This command is primarily for use by client machines to automatically
8453
- # reconnect during intermittent network issues. It is not intended for
8806
+ # reconnect during intermittent network issues. It isn't intended for
8454
8807
  # any other use.
8455
8808
  #
8456
8809
  # </note>
@@ -8549,8 +8902,8 @@ module Aws::SSM
8549
8902
  # tens, hundreds, or thousands of instances at once.
8550
8903
  #
8551
8904
  # For more information about how to use targets, see [Using targets and
8552
- # rate controls to send commands to a fleet][1] in the *AWS Systems
8553
- # Manager User Guide*.
8905
+ # rate controls to send commands to a fleet][1] in the *Amazon Web
8906
+ # Services Systems Manager User Guide*.
8554
8907
  #
8555
8908
  #
8556
8909
  #
@@ -8568,18 +8921,20 @@ module Aws::SSM
8568
8921
  # `InstanceIds` option instead.
8569
8922
  #
8570
8923
  # For more information about how to use targets, see [Sending commands
8571
- # to a fleet][1] in the *AWS Systems Manager User Guide*.
8924
+ # to a fleet][1] in the *Amazon Web Services Systems Manager User
8925
+ # Guide*.
8572
8926
  #
8573
8927
  #
8574
8928
  #
8575
8929
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html
8576
8930
  #
8577
8931
  # @option params [required, String] :document_name
8578
- # The name of the Systems Manager document to run. This can be a public
8579
- # document or a custom document. To run a shared document belonging to
8580
- # another account, specify the document ARN. For more information about
8581
- # how to use shared documents, see [Using shared SSM documents][1] in
8582
- # the *AWS Systems Manager User Guide*.
8932
+ # The name of the Amazon Web Services Systems Manager document (SSM
8933
+ # document) to run. This can be a public document or a custom document.
8934
+ # To run a shared document belonging to another account, specify the
8935
+ # document ARN. For more information about how to use shared documents,
8936
+ # see [Using shared SSM documents][1] in the *Amazon Web Services
8937
+ # Systems Manager User Guide*.
8583
8938
  #
8584
8939
  #
8585
8940
  #
@@ -8588,9 +8943,10 @@ module Aws::SSM
8588
8943
  # @option params [String] :document_version
8589
8944
  # The SSM document version to use in the request. You can specify
8590
8945
  # $DEFAULT, $LATEST, or a specific version number. If you run commands
8591
- # by using the AWS CLI, then you must escape the first two options by
8592
- # using a backslash. If you specify a version number, then you don't
8593
- # need to use the backslash. For example:
8946
+ # by using the Command Line Interface (Amazon Web Services CLI), then
8947
+ # you must escape the first two options by using a backslash. If you
8948
+ # specify a version number, then you don't need to use the backslash.
8949
+ # For example:
8594
8950
  #
8595
8951
  # --document-version "\\$DEFAULT"
8596
8952
  #
@@ -8614,8 +8970,8 @@ module Aws::SSM
8614
8970
  # </note>
8615
8971
  #
8616
8972
  # @option params [Integer] :timeout_seconds
8617
- # If this time is reached and the command has not already started
8618
- # running, it will not run.
8973
+ # If this time is reached and the command hasn't already started
8974
+ # running, it won't run.
8619
8975
  #
8620
8976
  # @option params [String] :comment
8621
8977
  # User-specified information about the command, such as a brief
@@ -8641,9 +8997,9 @@ module Aws::SSM
8641
8997
  # @option params [String] :max_concurrency
8642
8998
  # (Optional) The maximum number of instances that are allowed to run the
8643
8999
  # command at the same time. You can specify a number such as 10 or a
8644
- # percentage such as 10%. The default value is 50. For more information
8645
- # about how to use MaxConcurrency, see [Using concurrency controls][1]
8646
- # in the *AWS Systems Manager User Guide*.
9000
+ # percentage such as 10%. The default value is `50`. For more
9001
+ # information about how to use `MaxConcurrency`, see [Using concurrency
9002
+ # controls][1] in the *Amazon Web Services Systems Manager User Guide*.
8647
9003
  #
8648
9004
  #
8649
9005
  #
@@ -8651,27 +9007,29 @@ module Aws::SSM
8651
9007
  #
8652
9008
  # @option params [String] :max_errors
8653
9009
  # The maximum number of errors allowed without the command failing. When
8654
- # the command fails one more time beyond the value of MaxErrors, the
9010
+ # the command fails one more time beyond the value of `MaxErrors`, the
8655
9011
  # systems stops sending the command to additional targets. You can
8656
9012
  # specify a number like 10 or a percentage like 10%. The default value
8657
- # is 0. For more information about how to use MaxErrors, see [Using
8658
- # error controls][1] in the *AWS Systems Manager User Guide*.
9013
+ # is `0`. For more information about how to use `MaxErrors`, see [Using
9014
+ # error controls][1] in the *Amazon Web Services Systems Manager User
9015
+ # Guide*.
8659
9016
  #
8660
9017
  #
8661
9018
  #
8662
9019
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/send-commands-multiple.html#send-commands-maxerrors
8663
9020
  #
8664
9021
  # @option params [String] :service_role_arn
8665
- # The ARN of the IAM service role to use to publish Amazon Simple
8666
- # Notification Service (Amazon SNS) notifications for Run Command
8667
- # commands.
9022
+ # The ARN of the Identity and Access Management (IAM) service role to
9023
+ # use to publish Amazon Simple Notification Service (Amazon SNS)
9024
+ # notifications for Run Command commands.
8668
9025
  #
8669
9026
  # @option params [Types::NotificationConfig] :notification_config
8670
9027
  # Configurations for sending notifications.
8671
9028
  #
8672
9029
  # @option params [Types::CloudWatchOutputConfig] :cloud_watch_output_config
8673
- # Enables Systems Manager to send Run Command output to Amazon
8674
- # CloudWatch Logs.
9030
+ # Enables Amazon Web Services Systems Manager to send Run Command output
9031
+ # to Amazon CloudWatch Logs. Run Command is a capability of Amazon Web
9032
+ # Services Systems Manager.
8675
9033
  #
8676
9034
  # @return [Types::SendCommandResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8677
9035
  #
@@ -8759,8 +9117,8 @@ module Aws::SSM
8759
9117
  req.send_request(options)
8760
9118
  end
8761
9119
 
8762
- # Use this API action to run an association immediately and only one
8763
- # time. This action can be helpful when troubleshooting associations.
9120
+ # Runs an association immediately and only one time. This operation can
9121
+ # be helpful when troubleshooting associations.
8764
9122
  #
8765
9123
  # @option params [required, Array<String>] :association_ids
8766
9124
  # The association IDs that you want to run immediately and only one
@@ -8783,25 +9141,25 @@ module Aws::SSM
8783
9141
  req.send_request(options)
8784
9142
  end
8785
9143
 
8786
- # Initiates execution of an Automation document.
9144
+ # Initiates execution of an Automation runbook.
8787
9145
  #
8788
9146
  # @option params [required, String] :document_name
8789
- # The name of the Systems Manager document to run. This can be a public
8790
- # document or a custom document. To run a shared document belonging to
8791
- # another account, specify the document ARN. For more information about
8792
- # how to use shared documents, see [Using shared SSM documents][1] in
8793
- # the *AWS Systems Manager User Guide*.
9147
+ # The name of the SSM document to run. This can be a public document or
9148
+ # a custom document. To run a shared document belonging to another
9149
+ # account, specify the document ARN. For more information about how to
9150
+ # use shared documents, see [Using shared SSM documents][1] in the
9151
+ # *Amazon Web Services Systems Manager User Guide*.
8794
9152
  #
8795
9153
  #
8796
9154
  #
8797
9155
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html
8798
9156
  #
8799
9157
  # @option params [String] :document_version
8800
- # The version of the Automation document to use for this execution.
9158
+ # The version of the Automation runbook to use for this execution.
8801
9159
  #
8802
9160
  # @option params [Hash<String,Array>] :parameters
8803
9161
  # A key-value map of execution parameters, which match the declared
8804
- # parameters in the Automation document.
9162
+ # parameters in the Automation runbook.
8805
9163
  #
8806
9164
  # @option params [String] :client_token
8807
9165
  # User-provided idempotency token. The token must be unique, is case
@@ -8821,12 +9179,12 @@ module Aws::SSM
8821
9179
  #
8822
9180
  # @option params [Array<Hash>] :target_maps
8823
9181
  # A key-value mapping of document parameters to target resources. Both
8824
- # Targets and TargetMaps cannot be specified together.
9182
+ # Targets and TargetMaps can't be specified together.
8825
9183
  #
8826
9184
  # @option params [String] :max_concurrency
8827
9185
  # The maximum number of targets allowed to run this task in parallel.
8828
9186
  # You can specify a number, such as 10, or a percentage, such as 10%.
8829
- # The default value is 10.
9187
+ # The default value is `10`.
8830
9188
  #
8831
9189
  # @option params [String] :max_errors
8832
9190
  # The number of errors that are allowed before the system stops running
@@ -8847,11 +9205,11 @@ module Aws::SSM
8847
9205
  # executions proceed one at a time.
8848
9206
  #
8849
9207
  # @option params [Array<Types::TargetLocation>] :target_locations
8850
- # A location is a combination of AWS Regions and/or AWS accounts where
8851
- # you want to run the Automation. Use this action to start an Automation
8852
- # in multiple Regions and multiple accounts. For more information, see
8853
- # [Running Automation workflows in multiple AWS Regions and accounts][1]
8854
- # in the *AWS Systems Manager User Guide*.
9208
+ # A location is a combination of Regions and/or accounts where you want
9209
+ # to run the automation. Use this operation to start an automation in
9210
+ # multiple Regions and multiple accounts. For more information, see
9211
+ # [Running Automation workflows in multiple Regions and accounts][1] in
9212
+ # the *Amazon Web Services Systems Manager User Guide*.
8855
9213
  #
8856
9214
  #
8857
9215
  #
@@ -8863,14 +9221,14 @@ module Aws::SSM
8863
9221
  # a resource in different ways, such as by purpose, owner, or
8864
9222
  # environment. For example, you might want to tag an automation to
8865
9223
  # identify an environment or operating system. In this case, you could
8866
- # specify the following key name/value pairs:
9224
+ # specify the following key-value pairs:
8867
9225
  #
8868
9226
  # * `Key=environment,Value=test`
8869
9227
  #
8870
9228
  # * `Key=OS,Value=Windows`
8871
9229
  #
8872
9230
  # <note markdown="1"> To add tags to an existing patch baseline, use the AddTagsToResource
8873
- # action.
9231
+ # operation.
8874
9232
  #
8875
9233
  # </note>
8876
9234
  #
@@ -8932,9 +9290,9 @@ module Aws::SSM
8932
9290
  req.send_request(options)
8933
9291
  end
8934
9292
 
8935
- # Creates a change request for Change Manager. The runbooks (Automation
8936
- # documents) specified in the change request run only after all required
8937
- # approvals for the change request have been received.
9293
+ # Creates a change request for Change Manager. The Automation runbooks
9294
+ # specified in the change request run only after all required approvals
9295
+ # for the change request have been received.
8938
9296
  #
8939
9297
  # @option params [Time,DateTime,Date,Integer,String] :scheduled_time
8940
9298
  # The date and time specified in the change request to run the
@@ -8967,8 +9325,8 @@ module Aws::SSM
8967
9325
  # insensitive, enforces the UUID format, and can't be reused.
8968
9326
  #
8969
9327
  # @option params [required, Array<Types::Runbook>] :runbooks
8970
- # Information about the Automation runbooks (Automation documents) that
8971
- # are run during the runbook workflow.
9328
+ # Information about the Automation runbooks that are run during the
9329
+ # runbook workflow.
8972
9330
  #
8973
9331
  # <note markdown="1"> The Automation runbooks specified for the runbook workflow can't run
8974
9332
  # until all required approvals for the change request have been
@@ -8981,7 +9339,7 @@ module Aws::SSM
8981
9339
  # maximum of five tags for a change request. Tags enable you to
8982
9340
  # categorize a resource in different ways, such as by purpose, owner, or
8983
9341
  # environment. For example, you might want to tag a change request to
8984
- # identify an environment or target AWS Region. In this case, you could
9342
+ # identify an environment or target Region. In this case, you could
8985
9343
  # specify the following key-value pairs:
8986
9344
  #
8987
9345
  # * `Key=Environment,Value=Production`
@@ -9067,13 +9425,15 @@ module Aws::SSM
9067
9425
  # Session Manager session. Returns a URL and token that can be used to
9068
9426
  # open a WebSocket connection for sending input and receiving outputs.
9069
9427
  #
9070
- # <note markdown="1"> AWS CLI usage: `start-session` is an interactive command that requires
9071
- # the Session Manager plugin to be installed on the client machine
9072
- # making the call. For information, see [Install the Session Manager
9073
- # plugin for the AWS CLI][1] in the *AWS Systems Manager User Guide*.
9428
+ # <note markdown="1"> Amazon Web Services CLI usage: `start-session` is an interactive
9429
+ # command that requires the Session Manager plugin to be installed on
9430
+ # the client machine making the call. For information, see [Install the
9431
+ # Session Manager plugin for the Amazon Web Services CLI][1] in the
9432
+ # *Amazon Web Services Systems Manager User Guide*.
9074
9433
  #
9075
- # AWS Tools for PowerShell usage: Start-SSMSession is not currently
9076
- # supported by AWS Tools for PowerShell on Windows local machines.
9434
+ # Amazon Web Services Tools for PowerShell usage: Start-SSMSession
9435
+ # isn't currently supported by Amazon Web Services Tools for PowerShell
9436
+ # on Windows local machines.
9077
9437
  #
9078
9438
  # </note>
9079
9439
  #
@@ -9154,7 +9514,7 @@ module Aws::SSM
9154
9514
 
9155
9515
  # Permanently ends a session and closes the data connection between the
9156
9516
  # Session Manager client and SSM Agent on the instance. A terminated
9157
- # session cannot be resumed.
9517
+ # session isn't be resumed.
9158
9518
  #
9159
9519
  # @option params [required, String] :session_id
9160
9520
  # The ID of the session to terminate.
@@ -9185,11 +9545,12 @@ module Aws::SSM
9185
9545
  # Remove a label or labels from a parameter.
9186
9546
  #
9187
9547
  # @option params [required, String] :name
9188
- # The parameter name of which you want to delete one or more labels.
9548
+ # The name of the parameter from which you want to delete one or more
9549
+ # labels.
9189
9550
  #
9190
9551
  # @option params [required, Integer] :parameter_version
9191
9552
  # The specific version of the parameter which you want to delete one or
9192
- # more labels from. If it is not present, the call will fail.
9553
+ # more labels from. If it isn't present, the call will fail.
9193
9554
  #
9194
9555
  # @option params [required, Array<String>] :labels
9195
9556
  # One or more labels to delete from the specified parameter version.
@@ -9224,16 +9585,17 @@ module Aws::SSM
9224
9585
  end
9225
9586
 
9226
9587
  # Updates an association. You can update the association name and
9227
- # version, the document version, schedule, parameters, and Amazon S3
9228
- # output.
9229
- #
9230
- # In order to call this API action, your IAM user account, group, or
9231
- # role must be configured with permission to call the
9232
- # DescribeAssociation API action. If you don't have permission to call
9233
- # DescribeAssociation, then you receive the following error: `An error
9234
- # occurred (AccessDeniedException) when calling the UpdateAssociation
9235
- # operation: User: <user_arn> is not authorized to perform:
9236
- # ssm:DescribeAssociation on resource: <resource_arn>`
9588
+ # version, the document version, schedule, parameters, and Amazon Simple
9589
+ # Storage Service (Amazon S3) output.
9590
+ #
9591
+ # In order to call this API operation, your Identity and Access
9592
+ # Management (IAM) user account, group, or role must be configured with
9593
+ # permission to call the DescribeAssociation API operation. If you
9594
+ # don't have permission to call `DescribeAssociation`, then you receive
9595
+ # the following error: `An error occurred (AccessDeniedException) when
9596
+ # calling the UpdateAssociation operation: User: <user_arn> isn't
9597
+ # authorized to perform: ssm:DescribeAssociation on resource:
9598
+ # <resource_arn>`
9237
9599
  #
9238
9600
  # When you update an association, the association immediately runs
9239
9601
  # against the specified targets.
@@ -9243,8 +9605,9 @@ module Aws::SSM
9243
9605
  #
9244
9606
  # @option params [Hash<String,Array>] :parameters
9245
9607
  # The parameters you want to update for the association. If you create a
9246
- # parameter using Parameter Store, you can reference the parameter using
9247
- # \\\{\\\{ssm:parameter-name\\}\\}
9608
+ # parameter using Parameter Store, a capability of Amazon Web Services
9609
+ # Systems Manager, you can reference the parameter using
9610
+ # `\{\{ssm:parameter-name\}\}`.
9248
9611
  #
9249
9612
  # @option params [String] :document_version
9250
9613
  # The document version you want update for the association.
@@ -9257,16 +9620,16 @@ module Aws::SSM
9257
9620
  # An S3 bucket where you want to store the results of this request.
9258
9621
  #
9259
9622
  # @option params [String] :name
9260
- # The name of the SSM document that contains the configuration
9261
- # information for the instance. You can specify Command or Automation
9262
- # documents.
9623
+ # The name of the SSM Command document or Automation runbook that
9624
+ # contains the configuration information for the instance.
9263
9625
  #
9264
- # You can specify AWS-predefined documents, documents you created, or a
9265
- # document that is shared with you from another account.
9626
+ # You can specify Amazon Web Services-predefined documents, documents
9627
+ # you created, or a document that is shared with you from another
9628
+ # account.
9266
9629
  #
9267
- # For SSM documents that are shared with you from other AWS accounts,
9268
- # you must specify the complete SSM document ARN, in the following
9269
- # format:
9630
+ # For Systems Manager document (SSM document) that are shared with you
9631
+ # from other accounts, you must specify the complete SSM document ARN,
9632
+ # in the following format:
9270
9633
  #
9271
9634
  # `arn:aws:ssm:region:account-id:document/document-name `
9272
9635
  #
@@ -9274,9 +9637,9 @@ module Aws::SSM
9274
9637
  #
9275
9638
  # `arn:aws:ssm:us-east-2:12345678912:document/My-Shared-Document`
9276
9639
  #
9277
- # For AWS-predefined documents and SSM documents you created in your
9278
- # account, you only need to specify the document name. For example,
9279
- # `AWS-ApplyPatchBaseline` or `My-Document`.
9640
+ # For Amazon Web Services-predefined documents and SSM documents you
9641
+ # created in your account, you only need to specify the document name.
9642
+ # For example, `AWS-ApplyPatchBaseline` or `My-Document`.
9280
9643
  #
9281
9644
  # @option params [Array<Types::Target>] :targets
9282
9645
  # The targets of the association.
@@ -9292,8 +9655,9 @@ module Aws::SSM
9292
9655
  #
9293
9656
  # @option params [String] :automation_target_parameter_name
9294
9657
  # Specify the target for the association. This target is required for
9295
- # associations that use an Automation document and target resources by
9296
- # using rate controls.
9658
+ # associations that use an Automation runbook and target resources by
9659
+ # using rate controls. Automation is a capability of Amazon Web Services
9660
+ # Systems Manager.
9297
9661
  #
9298
9662
  # @option params [String] :max_errors
9299
9663
  # The number of errors that are allowed before the system stops sending
@@ -9303,13 +9667,13 @@ module Aws::SSM
9303
9667
  # system stops sending requests when the fourth error is received. If
9304
9668
  # you specify 0, then the system stops sending requests after the first
9305
9669
  # error is returned. If you run an association on 50 instances and set
9306
- # MaxError to 10%, then the system stops sending the request when the
9670
+ # `MaxError` to 10%, then the system stops sending the request when the
9307
9671
  # sixth error is received.
9308
9672
  #
9309
- # Executions that are already running an association when MaxErrors is
9673
+ # Executions that are already running an association when `MaxErrors` is
9310
9674
  # reached are allowed to complete, but some of these executions may fail
9311
9675
  # as well. If you need to ensure that there won't be more than
9312
- # max-errors failed executions, set MaxConcurrency to 1 so that
9676
+ # max-errors failed executions, set `MaxConcurrency` to 1 so that
9313
9677
  # executions proceed one at a time.
9314
9678
  #
9315
9679
  # @option params [String] :max_concurrency
@@ -9319,10 +9683,10 @@ module Aws::SSM
9319
9683
  # means all targets run the association at the same time.
9320
9684
  #
9321
9685
  # If a new instance starts and attempts to run an association while
9322
- # Systems Manager is running MaxConcurrency associations, the
9686
+ # Systems Manager is running `MaxConcurrency` associations, the
9323
9687
  # association is allowed to run. During the next association interval,
9324
9688
  # the new instance will process its association within the limit
9325
- # specified for MaxConcurrency.
9689
+ # specified for `MaxConcurrency`.
9326
9690
  #
9327
9691
  # @option params [String] :compliance_severity
9328
9692
  # The severity level to assign to the association.
@@ -9336,9 +9700,10 @@ module Aws::SSM
9336
9700
  # the association is `NON-COMPLIANT`.
9337
9701
  #
9338
9702
  # In `MANUAL` mode, you must specify the `AssociationId` as a parameter
9339
- # for the PutComplianceItems API action. In this case, compliance data
9340
- # is not managed by State Manager. It is managed by your direct call to
9341
- # the PutComplianceItems API action.
9703
+ # for the PutComplianceItems API operation. In this case, compliance
9704
+ # data isn't managed by State Manager, a capability of Amazon Web
9705
+ # Services Systems Manager. It is managed by your direct call to the
9706
+ # PutComplianceItems API operation.
9342
9707
  #
9343
9708
  # By default, all associations use `AUTO` mode.
9344
9709
  #
@@ -9346,7 +9711,7 @@ module Aws::SSM
9346
9711
  # By default, when you update an association, the system runs it
9347
9712
  # immediately after it is updated and then according to the schedule you
9348
9713
  # specified. Specify this option if you don't want an association to
9349
- # run immediately after you update it. This parameter is not supported
9714
+ # run immediately after you update it. This parameter isn't supported
9350
9715
  # for rate expressions.
9351
9716
  #
9352
9717
  # Also, if you specified this option when you created the association,
@@ -9357,19 +9722,19 @@ module Aws::SSM
9357
9722
  # interval specified.
9358
9723
  #
9359
9724
  # @option params [Array<String>] :calendar_names
9360
- # The names or Amazon Resource Names (ARNs) of the Systems Manager
9361
- # Change Calendar type documents you want to gate your associations
9362
- # under. The associations only run when that Change Calendar is open.
9363
- # For more information, see [AWS Systems Manager Change Calendar][1].
9725
+ # The names or Amazon Resource Names (ARNs) of the Change Calendar type
9726
+ # documents you want to gate your associations under. The associations
9727
+ # only run when that change calendar is open. For more information, see
9728
+ # [Amazon Web Services Systems Manager Change Calendar][1].
9364
9729
  #
9365
9730
  #
9366
9731
  #
9367
9732
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar
9368
9733
  #
9369
9734
  # @option params [Array<Types::TargetLocation>] :target_locations
9370
- # A location is a combination of AWS Regions and AWS accounts where you
9371
- # want to run the association. Use this action to update an association
9372
- # in multiple Regions and multiple accounts.
9735
+ # A location is a combination of Regions and accounts where you want to
9736
+ # run the association. Use this action to update an association in
9737
+ # multiple Regions and multiple accounts.
9373
9738
  #
9374
9739
  # @return [Types::UpdateAssociationResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9375
9740
  #
@@ -9475,11 +9840,11 @@ module Aws::SSM
9475
9840
  req.send_request(options)
9476
9841
  end
9477
9842
 
9478
- # Updates the status of the Systems Manager document associated with the
9479
- # specified instance.
9843
+ # Updates the status of the Amazon Web Services Systems Manager document
9844
+ # (SSM document) associated with the specified instance.
9480
9845
  #
9481
9846
  # @option params [required, String] :name
9482
- # The name of the Systems Manager document.
9847
+ # The name of the SSM document.
9483
9848
  #
9484
9849
  # @option params [required, String] :instance_id
9485
9850
  # The ID of the instance.
@@ -9567,16 +9932,22 @@ module Aws::SSM
9567
9932
  # A valid JSON or YAML string.
9568
9933
  #
9569
9934
  # @option params [Array<Types::AttachmentsSource>] :attachments
9570
- # A list of key and value pairs that describe attachments to a version
9571
- # of a document.
9935
+ # A list of key-value pairs that describe attachments to a version of a
9936
+ # document.
9572
9937
  #
9573
9938
  # @option params [required, String] :name
9574
- # The name of the document that you want to update.
9939
+ # The name of the SSM document that you want to update.
9940
+ #
9941
+ # @option params [String] :display_name
9942
+ # The friendly name of the SSM document that you want to update. This
9943
+ # value can differ for each version of the document. If you don't
9944
+ # specify a value for this parameter in your request, the existing value
9945
+ # is applied to the new document version.
9575
9946
  #
9576
9947
  # @option params [String] :version_name
9577
9948
  # An optional field specifying the version of the artifact you are
9578
9949
  # updating with the document. For example, "Release 12, Update 6".
9579
- # This value is unique across all versions of a document, and cannot be
9950
+ # This value is unique across all versions of a document, and can't be
9580
9951
  # changed.
9581
9952
  #
9582
9953
  # @option params [String] :document_version
@@ -9608,6 +9979,7 @@ module Aws::SSM
9608
9979
  # },
9609
9980
  # ],
9610
9981
  # name: "DocumentName", # required
9982
+ # display_name: "DocumentDisplayName",
9611
9983
  # version_name: "DocumentVersionName",
9612
9984
  # document_version: "DocumentVersion",
9613
9985
  # document_format: "YAML", # accepts YAML, JSON, TEXT
@@ -9620,6 +9992,7 @@ module Aws::SSM
9620
9992
  # resp.document_description.hash #=> String
9621
9993
  # resp.document_description.hash_type #=> String, one of "Sha256", "Sha1"
9622
9994
  # resp.document_description.name #=> String
9995
+ # resp.document_description.display_name #=> String
9623
9996
  # resp.document_description.version_name #=> String
9624
9997
  # resp.document_description.owner #=> String
9625
9998
  # resp.document_description.created_date #=> Time
@@ -9634,7 +10007,7 @@ module Aws::SSM
9634
10007
  # resp.document_description.parameters[0].default_value #=> String
9635
10008
  # resp.document_description.platform_types #=> Array
9636
10009
  # resp.document_description.platform_types[0] #=> String, one of "Windows", "Linux"
9637
- # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate"
10010
+ # resp.document_description.document_type #=> String, one of "Command", "Policy", "Automation", "Session", "Package", "ApplicationConfiguration", "ApplicationConfigurationSchema", "DeploymentStrategy", "ChangeCalendar", "Automation.ChangeTemplate", "ProblemAnalysis", "ProblemAnalysisTemplate"
9638
10011
  # resp.document_description.schema_version #=> String
9639
10012
  # resp.document_description.latest_version #=> String
9640
10013
  # resp.document_description.default_version #=> String
@@ -9775,7 +10148,7 @@ module Aws::SSM
9775
10148
  #
9776
10149
  # @option params [String] :end_date
9777
10150
  # The date and time, in ISO-8601 Extended format, for when you want the
9778
- # maintenance window to become inactive. EndDate allows you to set a
10151
+ # maintenance window to become inactive. `EndDate` allows you to set a
9779
10152
  # date and time in the future when the maintenance window will no longer
9780
10153
  # run.
9781
10154
  #
@@ -9794,7 +10167,7 @@ module Aws::SSM
9794
10167
  # [1]: https://www.iana.org/time-zones
9795
10168
  #
9796
10169
  # @option params [Integer] :schedule_offset
9797
- # The number of days to wait after the date and time specified by a CRON
10170
+ # The number of days to wait after the date and time specified by a cron
9798
10171
  # expression before running the maintenance window.
9799
10172
  #
9800
10173
  # For example, the following cron expression schedules a maintenance
@@ -9810,7 +10183,8 @@ module Aws::SSM
9810
10183
  #
9811
10184
  # @option params [Integer] :cutoff
9812
10185
  # The number of hours before the end of the maintenance window that
9813
- # Systems Manager stops scheduling new tasks for execution.
10186
+ # Amazon Web Services Systems Manager stops scheduling new tasks for
10187
+ # execution.
9814
10188
  #
9815
10189
  # @option params [Boolean] :allow_unassociated_targets
9816
10190
  # Whether targets must be registered with the maintenance window before
@@ -9820,9 +10194,9 @@ module Aws::SSM
9820
10194
  # Whether the maintenance window is enabled.
9821
10195
  #
9822
10196
  # @option params [Boolean] :replace
9823
- # If True, then all fields that are required by the
9824
- # CreateMaintenanceWindow action are also required for this API request.
9825
- # Optional fields that are not specified are set to null.
10197
+ # If `True`, then all fields that are required by the
10198
+ # CreateMaintenanceWindow operation are also required for this API
10199
+ # request. Optional fields that aren't specified are set to null.
9826
10200
  #
9827
10201
  # @return [Types::UpdateMaintenanceWindowResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9828
10202
  #
@@ -9898,7 +10272,7 @@ module Aws::SSM
9898
10272
  # types are ID target, Tag target, and resource group. For more
9899
10273
  # information, see Target.
9900
10274
  #
9901
- # <note markdown="1"> If a parameter is null, then the corresponding field is not modified.
10275
+ # <note markdown="1"> If a parameter is null, then the corresponding field isn't modified.
9902
10276
  #
9903
10277
  # </note>
9904
10278
  #
@@ -9912,9 +10286,9 @@ module Aws::SSM
9912
10286
  # The targets to add or replace.
9913
10287
  #
9914
10288
  # @option params [String] :owner_information
9915
- # User-provided value that will be included in any CloudWatch events
9916
- # raised while running tasks for these targets in this maintenance
9917
- # window.
10289
+ # User-provided value that will be included in any Amazon CloudWatch
10290
+ # Events events raised while running tasks for these targets in this
10291
+ # maintenance window.
9918
10292
  #
9919
10293
  # @option params [String] :name
9920
10294
  # A name for the update.
@@ -9923,9 +10297,10 @@ module Aws::SSM
9923
10297
  # An optional description for the update.
9924
10298
  #
9925
10299
  # @option params [Boolean] :replace
9926
- # If True, then all fields that are required by the
9927
- # RegisterTargetWithMaintenanceWindow action are also required for this
9928
- # API request. Optional fields that are not specified are set to null.
10300
+ # If `True`, then all fields that are required by the
10301
+ # RegisterTargetWithMaintenanceWindow operation are also required for
10302
+ # this API request. Optional fields that aren't specified are set to
10303
+ # null.
9929
10304
  #
9930
10305
  # @return [Types::UpdateMaintenanceWindowTargetResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9931
10306
  #
@@ -9977,38 +10352,38 @@ module Aws::SSM
9977
10352
  # Modifies a task assigned to a maintenance window. You can't change
9978
10353
  # the task type, but you can change the following values:
9979
10354
  #
9980
- # * TaskARN. For example, you can change a RUN\_COMMAND task from
9981
- # AWS-RunPowerShellScript to AWS-RunShellScript.
10355
+ # * `TaskARN`. For example, you can change a `RUN_COMMAND` task from
10356
+ # `AWS-RunPowerShellScript` to `AWS-RunShellScript`.
9982
10357
  #
9983
- # * ServiceRoleArn
10358
+ # * `ServiceRoleArn`
9984
10359
  #
9985
- # * TaskInvocationParameters
10360
+ # * `TaskInvocationParameters`
9986
10361
  #
9987
- # * Priority
10362
+ # * `Priority`
9988
10363
  #
9989
- # * MaxConcurrency
10364
+ # * `MaxConcurrency`
9990
10365
  #
9991
- # * MaxErrors
10366
+ # * `MaxErrors`
9992
10367
  #
9993
10368
  # <note markdown="1"> One or more targets must be specified for maintenance window Run
9994
10369
  # Command-type tasks. Depending on the task, targets are optional for
9995
- # other maintenance window task types (Automation, AWS Lambda, and AWS
9996
- # Step Functions). For more information about running tasks that do not
10370
+ # other maintenance window task types (Automation, Lambda, and Step
10371
+ # Functions). For more information about running tasks that don't
9997
10372
  # specify targets, see [Registering maintenance window tasks without
9998
- # targets][1] in the *AWS Systems Manager User Guide*.
10373
+ # targets][1] in the *Amazon Web Services Systems Manager User Guide*.
9999
10374
  #
10000
10375
  # </note>
10001
10376
  #
10002
10377
  # If the value for a parameter in `UpdateMaintenanceWindowTask` is null,
10003
- # then the corresponding field is not modified. If you set `Replace` to
10378
+ # then the corresponding field isn't modified. If you set `Replace` to
10004
10379
  # true, then all fields required by the
10005
- # RegisterTaskWithMaintenanceWindow action are required for this
10380
+ # RegisterTaskWithMaintenanceWindow operation are required for this
10006
10381
  # request. Optional fields that aren't specified are set to null.
10007
10382
  #
10008
10383
  # When you update a maintenance window task that has options specified
10009
10384
  # in `TaskInvocationParameters`, you must provide again all the
10010
10385
  # `TaskInvocationParameters` values that you want to retain. The values
10011
- # you do not specify again are removed. For example, suppose that when
10386
+ # you don't specify again are removed. For example, suppose that when
10012
10387
  # you registered a Run Command task, you specified
10013
10388
  # `TaskInvocationParameters` values for `Comment`, `NotificationConfig`,
10014
10389
  # and `OutputS3BucketName`. If you update the maintenance window task
@@ -10027,15 +10402,16 @@ module Aws::SSM
10027
10402
  #
10028
10403
  # @option params [Array<Types::Target>] :targets
10029
10404
  # The targets (either instances or tags) to modify. Instances are
10030
- # specified using Key=instanceids,Values=instanceID\_1,instanceID\_2.
10031
- # Tags are specified using Key=tag\_name,Values=tag\_value.
10405
+ # specified using the format
10406
+ # `Key=instanceids,Values=instanceID_1,instanceID_2`. Tags are specified
10407
+ # using the format ` Key=tag_name,Values=tag_value`.
10032
10408
  #
10033
10409
  # <note markdown="1"> One or more targets must be specified for maintenance window Run
10034
10410
  # Command-type tasks. Depending on the task, targets are optional for
10035
- # other maintenance window task types (Automation, AWS Lambda, and AWS
10036
- # Step Functions). For more information about running tasks that do not
10411
+ # other maintenance window task types (Automation, Lambda, and Step
10412
+ # Functions). For more information about running tasks that don't
10037
10413
  # specify targets, see [Registering maintenance window tasks without
10038
- # targets][1] in the *AWS Systems Manager User Guide*.
10414
+ # targets][1] in the *Amazon Web Services Systems Manager User Guide*.
10039
10415
  #
10040
10416
  # </note>
10041
10417
  #
@@ -10047,14 +10423,15 @@ module Aws::SSM
10047
10423
  # The task ARN to modify.
10048
10424
  #
10049
10425
  # @option params [String] :service_role_arn
10050
- # The ARN of the IAM service role for Systems Manager to assume when
10051
- # running a maintenance window task. If you do not specify a service
10052
- # role ARN, Systems Manager uses your account's service-linked role. If
10053
- # no service-linked role for Systems Manager exists in your account, it
10054
- # is created when you run `RegisterTaskWithMaintenanceWindow`.
10426
+ # The Amazon Resource Name (ARN) of the IAM service role for Amazon Web
10427
+ # Services Systems Manager to assume when running a maintenance window
10428
+ # task. If you do not specify a service role ARN, Systems Manager uses
10429
+ # your account's service-linked role. If no service-linked role for
10430
+ # Systems Manager exists in your account, it is created when you run
10431
+ # `RegisterTaskWithMaintenanceWindow`.
10055
10432
  #
10056
- # For more information, see the following topics in the in the *AWS
10057
- # Systems Manager User Guide*\:
10433
+ # For more information, see the following topics in the in the *Amazon
10434
+ # Web Services Systems Manager User Guide*\:
10058
10435
  #
10059
10436
  # * [Using service-linked roles for Systems Manager][1]
10060
10437
  #
@@ -10092,7 +10469,7 @@ module Aws::SSM
10092
10469
  # When you update a maintenance window task that has options specified
10093
10470
  # in `TaskInvocationParameters`, you must provide again all the
10094
10471
  # `TaskInvocationParameters` values that you want to retain. The values
10095
- # you do not specify again are removed. For example, suppose that when
10472
+ # you don't specify again are removed. For example, suppose that when
10096
10473
  # you registered a Run Command task, you specified
10097
10474
  # `TaskInvocationParameters` values for `Comment`, `NotificationConfig`,
10098
10475
  # and `OutputS3BucketName`. If you update the maintenance window task
@@ -10108,10 +10485,10 @@ module Aws::SSM
10108
10485
  # is the number of targets that are allowed to run this task in
10109
10486
  # parallel.
10110
10487
  #
10111
- # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
10488
+ # <note markdown="1"> For maintenance window tasks without a target specified, you can't
10112
10489
  # supply a value for this option. Instead, the system inserts a
10113
10490
  # placeholder value of `1`, which may be reported in the response to
10114
- # this command. This value does not affect the running of your task and
10491
+ # this command. This value doesn't affect the running of your task and
10115
10492
  # can be ignored.
10116
10493
  #
10117
10494
  # </note>
@@ -10121,10 +10498,10 @@ module Aws::SSM
10121
10498
  # number of errors that are allowed before the task stops being
10122
10499
  # scheduled.
10123
10500
  #
10124
- # <note markdown="1"> For maintenance window tasks without a target specified, you cannot
10501
+ # <note markdown="1"> For maintenance window tasks without a target specified, you can't
10125
10502
  # supply a value for this option. Instead, the system inserts a
10126
10503
  # placeholder value of `1`, which may be reported in the response to
10127
- # this command. This value does not affect the running of your task and
10504
+ # this command. This value doesn't affect the running of your task and
10128
10505
  # can be ignored.
10129
10506
  #
10130
10507
  # </note>
@@ -10132,10 +10509,11 @@ module Aws::SSM
10132
10509
  # @option params [Types::LoggingInfo] :logging_info
10133
10510
  # The new logging location in Amazon S3 to specify.
10134
10511
  #
10135
- # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an S3 bucket to contain
10136
- # logs, instead use the `OutputS3BucketName` and `OutputS3KeyPrefix`
10137
- # options in the `TaskInvocationParameters` structure. For information
10138
- # about how Systems Manager handles these options for the supported
10512
+ # <note markdown="1"> `LoggingInfo` has been deprecated. To specify an Amazon Simple Storage
10513
+ # Service (Amazon S3) bucket to contain logs, instead use the
10514
+ # `OutputS3BucketName` and `OutputS3KeyPrefix` options in the
10515
+ # `TaskInvocationParameters` structure. For information about how Amazon
10516
+ # Web Services Systems Manager handles these options for the supported
10139
10517
  # maintenance window task types, see
10140
10518
  # MaintenanceWindowTaskInvocationParameters.
10141
10519
  #
@@ -10149,8 +10527,8 @@ module Aws::SSM
10149
10527
  #
10150
10528
  # @option params [Boolean] :replace
10151
10529
  # If True, then all fields that are required by the
10152
- # RegisterTaskWithMaintenanceWindow action are also required for this
10153
- # API request. Optional fields that are not specified are set to null.
10530
+ # RegisterTaskWithMaintenanceWindow operation are also required for this
10531
+ # API request. Optional fields that aren't specified are set to null.
10154
10532
  #
10155
10533
  # @return [Types::UpdateMaintenanceWindowTaskResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10156
10534
  #
@@ -10295,10 +10673,10 @@ module Aws::SSM
10295
10673
  req.send_request(options)
10296
10674
  end
10297
10675
 
10298
- # Changes the Amazon Identity and Access Management (IAM) role that is
10299
- # assigned to the on-premises instance or virtual machines (VM). IAM
10300
- # roles are first assigned to these hybrid instances during the
10301
- # activation process. For more information, see CreateActivation.
10676
+ # Changes the Identity and Access Management (IAM) role that is assigned
10677
+ # to the on-premises instance or virtual machines (VM). IAM roles are
10678
+ # first assigned to these hybrid instances during the activation
10679
+ # process. For more information, see CreateActivation.
10302
10680
  #
10303
10681
  # @option params [required, String] :instance_id
10304
10682
  # The ID of the managed instance where you want to update the role.
@@ -10324,16 +10702,17 @@ module Aws::SSM
10324
10702
  req.send_request(options)
10325
10703
  end
10326
10704
 
10327
- # Edit or change an OpsItem. You must have permission in AWS Identity
10328
- # and Access Management (IAM) to update an OpsItem. For more
10329
- # information, see [Getting started with OpsCenter][1] in the *AWS
10705
+ # Edit or change an OpsItem. You must have permission in Identity and
10706
+ # Access Management (IAM) to update an OpsItem. For more information,
10707
+ # see [Getting started with OpsCenter][1] in the *Amazon Web Services
10330
10708
  # Systems Manager User Guide*.
10331
10709
  #
10332
- # Operations engineers and IT professionals use OpsCenter to view,
10333
- # investigate, and remediate operational issues impacting the
10334
- # performance and health of their AWS resources. For more information,
10335
- # see [AWS Systems Manager OpsCenter][2] in the *AWS Systems Manager
10336
- # User Guide*.
10710
+ # Operations engineers and IT professionals use Amazon Web Services
10711
+ # Systems Manager OpsCenter to view, investigate, and remediate
10712
+ # operational issues impacting the performance and health of their
10713
+ # Amazon Web Services resources. For more information, see
10714
+ # [OpsCenter][2] in the *Amazon Web Services Systems Manager User
10715
+ # Guide*.
10337
10716
  #
10338
10717
  #
10339
10718
  #
@@ -10355,22 +10734,23 @@ module Aws::SSM
10355
10734
  # You enter operational data as key-value pairs. The key has a maximum
10356
10735
  # length of 128 characters. The value has a maximum size of 20 KB.
10357
10736
  #
10358
- # Operational data keys *can't* begin with the following: amazon, aws,
10359
- # amzn, ssm, /amazon, /aws, /amzn, /ssm.
10737
+ # Operational data keys *can't* begin with the following: `amazon`,
10738
+ # `aws`, `amzn`, `ssm`, `/amazon`, `/aws`, `/amzn`, `/ssm`.
10360
10739
  #
10361
10740
  # You can choose to make the data searchable by other users in the
10362
10741
  # account or you can restrict search access. Searchable data means that
10363
10742
  # all users with access to the OpsItem Overview page (as provided by the
10364
- # DescribeOpsItems API action) can view and search on the specified
10365
- # data. Operational data that is not searchable is only viewable by
10743
+ # DescribeOpsItems API operation) can view and search on the specified
10744
+ # data. Operational data that isn't searchable is only viewable by
10366
10745
  # users who have access to the OpsItem (as provided by the GetOpsItem
10367
- # API action).
10746
+ # API operation).
10368
10747
  #
10369
10748
  # Use the `/aws/resources` key in OperationalData to specify a related
10370
10749
  # resource in the request. Use the `/aws/automations` key in
10371
10750
  # OperationalData to associate an Automation runbook with the OpsItem.
10372
- # To view AWS CLI example commands that use these keys, see [Creating
10373
- # OpsItems manually][1] in the *AWS Systems Manager User Guide*.
10751
+ # To view Amazon Web Services CLI example commands that use these keys,
10752
+ # see [Creating OpsItems manually][1] in the *Amazon Web Services
10753
+ # Systems Manager User Guide*.
10374
10754
  #
10375
10755
  #
10376
10756
  #
@@ -10396,7 +10776,7 @@ module Aws::SSM
10396
10776
  # @option params [String] :status
10397
10777
  # The OpsItem status. Status can be `Open`, `In Progress`, or
10398
10778
  # `Resolved`. For more information, see [Editing OpsItem details][1] in
10399
- # the *AWS Systems Manager User Guide*.
10779
+ # the *Amazon Web Services Systems Manager User Guide*.
10400
10780
  #
10401
10781
  #
10402
10782
  #
@@ -10456,7 +10836,7 @@ module Aws::SSM
10456
10836
  # ops_item_id: "String", # required
10457
10837
  # },
10458
10838
  # ],
10459
- # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Rejected
10839
+ # status: "Open", # accepts Open, InProgress, Resolved, Pending, TimedOut, Cancelling, Cancelled, Failed, CompletedWithSuccess, CompletedWithFailure, Scheduled, RunbookInProgress, PendingChangeCalendarOverride, ChangeCalendarOverrideApproved, ChangeCalendarOverrideRejected, PendingApproval, Approved, Rejected, Closed
10460
10840
  # ops_item_id: "OpsItemId", # required
10461
10841
  # title: "OpsItemTitle",
10462
10842
  # category: "OpsItemCategory",
@@ -10476,8 +10856,8 @@ module Aws::SSM
10476
10856
  req.send_request(options)
10477
10857
  end
10478
10858
 
10479
- # Systems Manager calls this API action when you edit OpsMetadata in
10480
- # Application Manager.
10859
+ # Amazon Web Services Systems Manager calls this API operation when you
10860
+ # edit OpsMetadata in Application Manager.
10481
10861
  #
10482
10862
  # @option params [required, String] :ops_metadata_arn
10483
10863
  # The Amazon Resoure Name (ARN) of the OpsMetadata Object to update.
@@ -10520,15 +10900,11 @@ module Aws::SSM
10520
10900
  # Modifies an existing patch baseline. Fields not specified in the
10521
10901
  # request are left unchanged.
10522
10902
  #
10523
- # <note markdown="1"> For information about valid key and value pairs in `PatchFilters` for
10524
- # each supported operating system type, see [PatchFilter][1].
10903
+ # <note markdown="1"> For information about valid key-value pairs in `PatchFilters` for each
10904
+ # supported operating system type, see PatchFilter.
10525
10905
  #
10526
10906
  # </note>
10527
10907
  #
10528
- #
10529
- #
10530
- # [1]: http://docs.aws.amazon.com/systems-manager/latest/APIReference/API_PatchFilter.html
10531
- #
10532
10908
  # @option params [required, String] :baseline_id
10533
10909
  # The ID of the patch baseline to update.
10534
10910
  #
@@ -10546,7 +10922,8 @@ module Aws::SSM
10546
10922
  #
10547
10923
  # For information about accepted formats for lists of approved patches
10548
10924
  # and rejected patches, see [About package name formats for approved and
10549
- # rejected patch lists][1] in the *AWS Systems Manager User Guide*.
10925
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
10926
+ # User Guide*.
10550
10927
  #
10551
10928
  #
10552
10929
  #
@@ -10558,14 +10935,15 @@ module Aws::SSM
10558
10935
  # @option params [Boolean] :approved_patches_enable_non_security
10559
10936
  # Indicates whether the list of approved patches includes non-security
10560
10937
  # updates that should be applied to the instances. The default value is
10561
- # 'false'. Applies to Linux instances only.
10938
+ # `false`. Applies to Linux instances only.
10562
10939
  #
10563
10940
  # @option params [Array<String>] :rejected_patches
10564
10941
  # A list of explicitly rejected patches for the baseline.
10565
10942
  #
10566
10943
  # For information about accepted formats for lists of approved patches
10567
10944
  # and rejected patches, see [About package name formats for approved and
10568
- # rejected patch lists][1] in the *AWS Systems Manager User Guide*.
10945
+ # rejected patch lists][1] in the *Amazon Web Services Systems Manager
10946
+ # User Guide*.
10569
10947
  #
10570
10948
  #
10571
10949
  #
@@ -10573,19 +10951,20 @@ module Aws::SSM
10573
10951
  #
10574
10952
  # @option params [String] :rejected_patches_action
10575
10953
  # The action for Patch Manager to take on patches included in the
10576
- # RejectedPackages list.
10954
+ # `RejectedPackages` list.
10577
10955
  #
10578
- # * **ALLOW\_AS\_DEPENDENCY**\: A package in the Rejected patches list
10579
- # is installed only if it is a dependency of another package. It is
10580
- # considered compliant with the patch baseline, and its status is
10581
- # reported as *InstalledOther*. This is the default action if no
10582
- # option is specified.
10956
+ # * <b> <code>ALLOW_AS_DEPENDENCY</code> </b>\: A package in the
10957
+ # `Rejected` patches list is installed only if it is a dependency of
10958
+ # another package. It is considered compliant with the patch baseline,
10959
+ # and its status is reported as `InstalledOther`. This is the default
10960
+ # action if no option is specified.
10583
10961
  #
10584
- # * **BLOCK**\: Packages in the RejectedPatches list, and packages that
10585
- # include them as dependencies, are not installed under any
10586
- # circumstances. If a package was installed before it was added to the
10587
- # Rejected patches list, it is considered non-compliant with the patch
10588
- # baseline, and its status is reported as *InstalledRejected*.
10962
+ # * <b> <code>BLOCK</code> </b>\: Packages in the `RejectedPatches`
10963
+ # list, and packages that include them as dependencies, aren't
10964
+ # installed under any circumstances. If a package was installed before
10965
+ # it was added to the `Rejected` patches list, it is considered
10966
+ # non-compliant with the patch baseline, and its status is reported as
10967
+ # `InstalledRejected`.
10589
10968
  #
10590
10969
  # @option params [String] :description
10591
10970
  # A description of the patch baseline.
@@ -10597,8 +10976,8 @@ module Aws::SSM
10597
10976
  #
10598
10977
  # @option params [Boolean] :replace
10599
10978
  # If True, then all fields that are required by the CreatePatchBaseline
10600
- # action are also required for this API request. Optional fields that
10601
- # are not specified are set to null.
10979
+ # operation are also required for this API request. Optional fields that
10980
+ # aren't specified are set to null.
10602
10981
  #
10603
10982
  # @return [Types::UpdatePatchBaselineResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10604
10983
  #
@@ -10710,12 +11089,12 @@ module Aws::SSM
10710
11089
  # Update a resource data sync. After you create a resource data sync for
10711
11090
  # a Region, you can't change the account options for that sync. For
10712
11091
  # example, if you create a sync in the us-east-2 (Ohio) Region and you
10713
- # choose the Include only the current account option, you can't edit
10714
- # that sync later and choose the Include all accounts from my AWS
10715
- # Organizations configuration option. Instead, you must delete the first
10716
- # resource data sync, and create a new one.
11092
+ # choose the `Include only the current account` option, you can't edit
11093
+ # that sync later and choose the `Include all accounts from my
11094
+ # Organizations configuration` option. Instead, you must delete the
11095
+ # first resource data sync, and create a new one.
10717
11096
  #
10718
- # <note markdown="1"> This API action only supports a resource data sync that was created
11097
+ # <note markdown="1"> This API operation only supports a resource data sync that was created
10719
11098
  # with a SyncFromSource `SyncType`.
10720
11099
  #
10721
11100
  # </note>
@@ -10762,21 +11141,22 @@ module Aws::SSM
10762
11141
  req.send_request(options)
10763
11142
  end
10764
11143
 
10765
- # `ServiceSetting` is an account-level setting for an AWS service. This
10766
- # setting defines how a user interacts with or uses a service or a
10767
- # feature of a service. For example, if an AWS service charges money to
10768
- # the account based on feature or service usage, then the AWS service
10769
- # team might create a default setting of "false". This means the user
10770
- # can't use this feature unless they change the setting to "true" and
10771
- # intentionally opt in for a paid feature.
11144
+ # `ServiceSetting` is an account-level setting for an Amazon Web
11145
+ # Services service. This setting defines how a user interacts with or
11146
+ # uses a service or a feature of a service. For example, if an Amazon
11147
+ # Web Services service charges money to the account based on feature or
11148
+ # service usage, then the Amazon Web Services service team might create
11149
+ # a default setting of "false". This means the user can't use this
11150
+ # feature unless they change the setting to "true" and intentionally
11151
+ # opt in for a paid feature.
10772
11152
  #
10773
- # Services map a `SettingId` object to a setting value. AWS services
10774
- # teams define the default value for a `SettingId`. You can't create a
10775
- # new `SettingId`, but you can overwrite the default value if you have
10776
- # the `ssm:UpdateServiceSetting` permission for the setting. Use the
10777
- # GetServiceSetting API action to view the current value. Or, use the
10778
- # ResetServiceSetting to change the value back to the original value
10779
- # defined by the AWS service team.
11153
+ # Services map a `SettingId` object to a setting value. Amazon Web
11154
+ # Services services teams define the default value for a `SettingId`.
11155
+ # You can't create a new `SettingId`, but you can overwrite the default
11156
+ # value if you have the `ssm:UpdateServiceSetting` permission for the
11157
+ # setting. Use the GetServiceSetting API operation to view the current
11158
+ # value. Or, use the ResetServiceSetting to change the value back to the
11159
+ # original value defined by the Amazon Web Services service team.
10780
11160
  #
10781
11161
  # Update the service setting for the account.
10782
11162
  #
@@ -10790,6 +11170,8 @@ module Aws::SSM
10790
11170
  #
10791
11171
  # * `/ssm/automation/customer-script-log-group-name`
10792
11172
  #
11173
+ # * `/ssm/documents/console/public-sharing-permission`
11174
+ #
10793
11175
  # * `/ssm/parameter-store/default-parameter-tier`
10794
11176
  #
10795
11177
  # * `/ssm/parameter-store/high-throughput-enabled`
@@ -10812,10 +11194,14 @@ module Aws::SSM
10812
11194
  # can be true or false.
10813
11195
  #
10814
11196
  # For the `/ssm/automation/customer-script-log-destination` setting ID,
10815
- # the setting value can be CloudWatch.
11197
+ # the setting value can be `CloudWatch`.
10816
11198
  #
10817
11199
  # For the `/ssm/automation/customer-script-log-group-name` setting ID,
10818
- # the setting value can be the name of a CloudWatch Logs log group.
11200
+ # the setting value can be the name of an Amazon CloudWatch Logs log
11201
+ # group.
11202
+ #
11203
+ # For the `/ssm/documents/console/public-sharing-permission` setting ID,
11204
+ # the setting value can be `Enable` or `Disable`.
10819
11205
  #
10820
11206
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
10821
11207
  #
@@ -10848,7 +11234,7 @@ module Aws::SSM
10848
11234
  params: params,
10849
11235
  config: config)
10850
11236
  context[:gem_name] = 'aws-sdk-ssm'
10851
- context[:gem_version] = '1.109.0'
11237
+ context[:gem_version] = '1.113.0'
10852
11238
  Seahorse::Client::Request.new(handlers, context)
10853
11239
  end
10854
11240