aws-sdk-ssm 1.109.0 → 1.113.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 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