aws-sdk-notifications 1.1.0 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -471,8 +471,8 @@ module Aws::Notifications
471
471
  # @!group API Operations
472
472
 
473
473
  # Associates a delivery [Channel][1] with a particular
474
- # NotificationConfiguration. Supported Channels include AWS Chatbot, the
475
- # AWS Console Mobile Application, and emails (notifications-contacts).
474
+ # `NotificationConfiguration`. Supported Channels include Chatbot, the
475
+ # Console Mobile Application, and emails (notifications-contacts).
476
476
  #
477
477
  #
478
478
  #
@@ -480,13 +480,13 @@ module Aws::Notifications
480
480
  #
481
481
  # @option params [required, String] :arn
482
482
  # The Amazon Resource Name (ARN) of the Channel to associate with the
483
- # NotificationConfiguration.
483
+ # `NotificationConfiguration`.
484
484
  #
485
- # Supported ARNs include AWS Chatbot, the Console Mobile Application,
486
- # and notifications-contacts.
485
+ # Supported ARNs include Chatbot, the Console Mobile Application, and
486
+ # notifications-contacts.
487
487
  #
488
488
  # @option params [required, String] :notification_configuration_arn
489
- # The ARN of the NotificationConfiguration to associate with the
489
+ # The ARN of the `NotificationConfiguration` to associate with the
490
490
  # Channel.
491
491
  #
492
492
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -507,24 +507,91 @@ module Aws::Notifications
507
507
  req.send_request(options)
508
508
  end
509
509
 
510
- # Creates an [EventRule][1] that is associated with a specified
511
- # Notification Configuration.
510
+ # Associates an Account Contact with a particular
511
+ # `ManagedNotificationConfiguration`.
512
+ #
513
+ # @option params [required, String] :contact_identifier
514
+ # A unique value of an Account Contact Type to associate with the
515
+ # `ManagedNotificationConfiguration`.
516
+ #
517
+ # @option params [required, String] :managed_notification_configuration_arn
518
+ # The Amazon Resource Name (ARN) of the
519
+ # `ManagedNotificationConfiguration` to associate with the Account
520
+ # Contact.
521
+ #
522
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
523
+ #
524
+ # @example Request syntax with placeholder values
525
+ #
526
+ # resp = client.associate_managed_notification_account_contact({
527
+ # contact_identifier: "ACCOUNT_PRIMARY", # required, accepts ACCOUNT_PRIMARY, ACCOUNT_ALTERNATE_BILLING, ACCOUNT_ALTERNATE_OPERATIONS, ACCOUNT_ALTERNATE_SECURITY
528
+ # managed_notification_configuration_arn: "ManagedNotificationConfigurationOsArn", # required
529
+ # })
530
+ #
531
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/AssociateManagedNotificationAccountContact AWS API Documentation
532
+ #
533
+ # @overload associate_managed_notification_account_contact(params = {})
534
+ # @param [Hash] params ({})
535
+ def associate_managed_notification_account_contact(params = {}, options = {})
536
+ req = build_request(:associate_managed_notification_account_contact, params)
537
+ req.send_request(options)
538
+ end
539
+
540
+ # Associates an additional Channel with a particular
541
+ # `ManagedNotificationConfiguration`.
542
+ #
543
+ # Supported Channels include Chatbot, the Console Mobile Application,
544
+ # and emails (notifications-contacts).
545
+ #
546
+ # @option params [required, String] :channel_arn
547
+ # The Amazon Resource Name (ARN) of the Channel to associate with the
548
+ # `ManagedNotificationConfiguration`.
549
+ #
550
+ # Supported ARNs include Chatbot, the Console Mobile Application, and
551
+ # email (notifications-contacts).
552
+ #
553
+ # @option params [required, String] :managed_notification_configuration_arn
554
+ # The Amazon Resource Name (ARN) of the
555
+ # `ManagedNotificationConfiguration` to associate with the additional
556
+ # Channel.
557
+ #
558
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
559
+ #
560
+ # @example Request syntax with placeholder values
561
+ #
562
+ # resp = client.associate_managed_notification_additional_channel({
563
+ # channel_arn: "ChannelArn", # required
564
+ # managed_notification_configuration_arn: "ManagedNotificationConfigurationOsArn", # required
565
+ # })
566
+ #
567
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/AssociateManagedNotificationAdditionalChannel AWS API Documentation
568
+ #
569
+ # @overload associate_managed_notification_additional_channel(params = {})
570
+ # @param [Hash] params ({})
571
+ def associate_managed_notification_additional_channel(params = {}, options = {})
572
+ req = build_request(:associate_managed_notification_additional_channel, params)
573
+ req.send_request(options)
574
+ end
575
+
576
+ # Creates an [ `EventRule` ][1] that is associated with a specified
577
+ # `NotificationConfiguration`.
512
578
  #
513
579
  #
514
580
  #
515
581
  # [1]: https://docs.aws.amazon.com/notifications/latest/userguide/glossary.html
516
582
  #
517
583
  # @option params [required, String] :notification_configuration_arn
518
- # The Amazon Resource Name (ARN) of the NotificationConfiguration
519
- # associated with this EventRule.
584
+ # The Amazon Resource Name (ARN) of the `NotificationConfiguration`
585
+ # associated with this `EventRule`.
520
586
  #
521
587
  # @option params [required, String] :source
522
588
  # The matched event source.
523
589
  #
524
- # Must match one of the valid EventBridge sources. Only AWS service
525
- # sourced events are supported. For example, `aws.ec2` and
526
- # `aws.cloudwatch`. For more information, see [Event delivery from AWS
527
- # services][1] in the *Amazon EventBridge User Guide*.
590
+ # Must match one of the valid EventBridge sources. Only Amazon Web
591
+ # Services service sourced events are supported. For example, `aws.ec2`
592
+ # and `aws.cloudwatch`. For more information, see [Event delivery from
593
+ # Amazon Web Services services][1] in the *Amazon EventBridge User
594
+ # Guide*.
528
595
  #
529
596
  #
530
597
  #
@@ -534,9 +601,10 @@ module Aws::Notifications
534
601
  # The event type to match.
535
602
  #
536
603
  # Must match one of the valid Amazon EventBridge event types. For
537
- # example, EC2 Instance State-change Notification and AWS CloudWatch
538
- # Alarm State Change. For more information, see [Event delivery from AWS
539
- # services][1] in the *Amazon EventBridge User Guide*.
604
+ # example, EC2 Instance State-change Notification and Amazon CloudWatch
605
+ # Alarm State Change. For more information, see [Event delivery from
606
+ # Amazon Web Services services][1] in the *Amazon EventBridge User
607
+ # Guide*.
540
608
  #
541
609
  #
542
610
  #
@@ -544,7 +612,7 @@ module Aws::Notifications
544
612
  #
545
613
  # @option params [String] :event_pattern
546
614
  # An additional event pattern used to further filter the events this
547
- # EventRule receives.
615
+ # `EventRule` receives.
548
616
  #
549
617
  # For more information, see [Amazon EventBridge event patterns][1] in
550
618
  # the *Amazon EventBridge User Guide.*
@@ -554,7 +622,8 @@ module Aws::Notifications
554
622
  # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html
555
623
  #
556
624
  # @option params [required, Array<String>] :regions
557
- # A list of AWS Regions that send events to this EventRule.
625
+ # A list of Amazon Web Services Regions that send events to this
626
+ # `EventRule`.
558
627
  #
559
628
  # @return [Types::CreateEventRuleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
560
629
  #
@@ -589,17 +658,17 @@ module Aws::Notifications
589
658
  req.send_request(options)
590
659
  end
591
660
 
592
- # Creates a new NotificationConfiguration.
661
+ # Creates a new `NotificationConfiguration`.
593
662
  #
594
663
  # @option params [required, String] :name
595
- # The name of the NotificationConfiguration. Supports RFC 3986's
664
+ # The name of the `NotificationConfiguration`. Supports RFC 3986's
596
665
  # unreserved characters.
597
666
  #
598
667
  # @option params [required, String] :description
599
- # The description of the NotificationConfiguration.
668
+ # The description of the `NotificationConfiguration`.
600
669
  #
601
670
  # @option params [String] :aggregation_duration
602
- # The aggregation preference of the NotificationConfiguration.
671
+ # The aggregation preference of the `NotificationConfiguration`.
603
672
  #
604
673
  # * Values:
605
674
  #
@@ -617,7 +686,7 @@ module Aws::Notifications
617
686
  #
618
687
  # * Don't aggregate notifications.
619
688
  #
620
- # No delay in delivery.
689
+ # ^
621
690
  #
622
691
  # @option params [Hash<String,String>] :tags
623
692
  # A map of tags assigned to a resource. A tag is a string-to-string map
@@ -653,10 +722,10 @@ module Aws::Notifications
653
722
  req.send_request(options)
654
723
  end
655
724
 
656
- # Deletes an EventRule.
725
+ # Deletes an `EventRule`.
657
726
  #
658
727
  # @option params [required, String] :arn
659
- # The Amazon Resource Name (ARN) of the EventRule to delete.
728
+ # The Amazon Resource Name (ARN) of the `EventRule` to delete.
660
729
  #
661
730
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
662
731
  #
@@ -675,10 +744,10 @@ module Aws::Notifications
675
744
  req.send_request(options)
676
745
  end
677
746
 
678
- # Deletes a NotificationConfiguration.
747
+ # Deletes a `NotificationConfiguration`.
679
748
  #
680
749
  # @option params [required, String] :arn
681
- # The Amazon Resource Name (ARN) of the NotificationConfiguration to
750
+ # The Amazon Resource Name (ARN) of the `NotificationConfiguration` to
682
751
  # delete.
683
752
  #
684
753
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -698,17 +767,18 @@ module Aws::Notifications
698
767
  req.send_request(options)
699
768
  end
700
769
 
701
- # Deregisters a NotificationHub in the specified Region.
770
+ # Deregisters a `NotificationConfiguration` in the specified Region.
702
771
  #
703
- # <note markdown="1"> You can't deregister the last NotificationHub in the account.
704
- # NotificationEvents stored in the deregistered NotificationHub are no
705
- # longer be visible. Recreating a new NotificationHub in the same Region
706
- # restores access to those NotificationEvents.
772
+ # <note markdown="1"> You can't deregister the last `NotificationHub` in the account.
773
+ # `NotificationEvents` stored in the deregistered
774
+ # `NotificationConfiguration` are no longer be visible. Recreating a new
775
+ # `NotificationConfiguration` in the same Region restores access to
776
+ # those `NotificationEvents`.
707
777
  #
708
778
  # </note>
709
779
  #
710
780
  # @option params [required, String] :notification_hub_region
711
- # The NotificationHub Region.
781
+ # The `NotificationConfiguration` Region.
712
782
  #
713
783
  # @return [Types::DeregisterNotificationHubResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
714
784
  #
@@ -736,15 +806,29 @@ module Aws::Notifications
736
806
  req.send_request(options)
737
807
  end
738
808
 
739
- # Disassociates a Channel from a specified NotificationConfiguration.
740
- # Supported Channels include AWS Chatbot, the AWS Console Mobile
741
- # Application, and emails (notifications-contacts).
809
+ # Disables service trust between User Notifications and Amazon Web
810
+ # Services Organizations.
811
+ #
812
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
813
+ #
814
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/DisableNotificationsAccessForOrganization AWS API Documentation
815
+ #
816
+ # @overload disable_notifications_access_for_organization(params = {})
817
+ # @param [Hash] params ({})
818
+ def disable_notifications_access_for_organization(params = {}, options = {})
819
+ req = build_request(:disable_notifications_access_for_organization, params)
820
+ req.send_request(options)
821
+ end
822
+
823
+ # Disassociates a Channel from a specified `NotificationConfiguration`.
824
+ # Supported Channels include Chatbot, the Console Mobile Application,
825
+ # and emails (notifications-contacts).
742
826
  #
743
827
  # @option params [required, String] :arn
744
828
  # The Amazon Resource Name (ARN) of the Channel to disassociate.
745
829
  #
746
830
  # @option params [required, String] :notification_configuration_arn
747
- # The ARN of the NotificationConfiguration to disassociate.
831
+ # The ARN of the `NotificationConfiguration` to disassociate.
748
832
  #
749
833
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
750
834
  #
@@ -764,10 +848,86 @@ module Aws::Notifications
764
848
  req.send_request(options)
765
849
  end
766
850
 
767
- # Returns a specified EventRule.
851
+ # Disassociates an Account Contact with a particular
852
+ # `ManagedNotificationConfiguration`.
853
+ #
854
+ # @option params [required, String] :contact_identifier
855
+ # The unique value of an Account Contact Type to associate with the
856
+ # `ManagedNotificationConfiguration`.
857
+ #
858
+ # @option params [required, String] :managed_notification_configuration_arn
859
+ # The Amazon Resource Name (ARN) of the
860
+ # `ManagedNotificationConfiguration` to associate with the Account
861
+ # Contact.
862
+ #
863
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
864
+ #
865
+ # @example Request syntax with placeholder values
866
+ #
867
+ # resp = client.disassociate_managed_notification_account_contact({
868
+ # contact_identifier: "ACCOUNT_PRIMARY", # required, accepts ACCOUNT_PRIMARY, ACCOUNT_ALTERNATE_BILLING, ACCOUNT_ALTERNATE_OPERATIONS, ACCOUNT_ALTERNATE_SECURITY
869
+ # managed_notification_configuration_arn: "ManagedNotificationConfigurationOsArn", # required
870
+ # })
871
+ #
872
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/DisassociateManagedNotificationAccountContact AWS API Documentation
873
+ #
874
+ # @overload disassociate_managed_notification_account_contact(params = {})
875
+ # @param [Hash] params ({})
876
+ def disassociate_managed_notification_account_contact(params = {}, options = {})
877
+ req = build_request(:disassociate_managed_notification_account_contact, params)
878
+ req.send_request(options)
879
+ end
880
+
881
+ # Disassociates an additional Channel from a particular
882
+ # `ManagedNotificationConfiguration`.
883
+ #
884
+ # Supported Channels include Chatbot, the Console Mobile Application,
885
+ # and emails (notifications-contacts).
886
+ #
887
+ # @option params [required, String] :channel_arn
888
+ # The Amazon Resource Name (ARN) of the Channel to associate with the
889
+ # `ManagedNotificationConfiguration`.
890
+ #
891
+ # @option params [required, String] :managed_notification_configuration_arn
892
+ # The Amazon Resource Name (ARN) of the Managed Notification
893
+ # Configuration to associate with the additional Channel.
894
+ #
895
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
896
+ #
897
+ # @example Request syntax with placeholder values
898
+ #
899
+ # resp = client.disassociate_managed_notification_additional_channel({
900
+ # channel_arn: "ChannelArn", # required
901
+ # managed_notification_configuration_arn: "ManagedNotificationConfigurationOsArn", # required
902
+ # })
903
+ #
904
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/DisassociateManagedNotificationAdditionalChannel AWS API Documentation
905
+ #
906
+ # @overload disassociate_managed_notification_additional_channel(params = {})
907
+ # @param [Hash] params ({})
908
+ def disassociate_managed_notification_additional_channel(params = {}, options = {})
909
+ req = build_request(:disassociate_managed_notification_additional_channel, params)
910
+ req.send_request(options)
911
+ end
912
+
913
+ # Enables service trust between User Notifications and Amazon Web
914
+ # Services Organizations.
915
+ #
916
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
917
+ #
918
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/EnableNotificationsAccessForOrganization AWS API Documentation
919
+ #
920
+ # @overload enable_notifications_access_for_organization(params = {})
921
+ # @param [Hash] params ({})
922
+ def enable_notifications_access_for_organization(params = {}, options = {})
923
+ req = build_request(:enable_notifications_access_for_organization, params)
924
+ req.send_request(options)
925
+ end
926
+
927
+ # Returns a specified `EventRule`.
768
928
  #
769
929
  # @option params [required, String] :arn
770
- # The Amazon Resource Name (ARN) of the EventRule to return.
930
+ # The Amazon Resource Name (ARN) of the `EventRule` to return.
771
931
  #
772
932
  # @return [Types::GetEventRuleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
773
933
  #
@@ -812,10 +972,195 @@ module Aws::Notifications
812
972
  req.send_request(options)
813
973
  end
814
974
 
815
- # Returns a specified NotificationConfiguration.
975
+ # Returns the child event of a specific given
976
+ # `ManagedNotificationEvent`.
977
+ #
978
+ # @option params [required, String] :arn
979
+ # The Amazon Resource Name (ARN) of the `ManagedNotificationChildEvent`
980
+ # to return.
981
+ #
982
+ # @option params [String] :locale
983
+ # The locale code of the language used for the retrieved
984
+ # `ManagedNotificationChildEvent`. The default locale is English
985
+ # `en_US`.
986
+ #
987
+ # @return [Types::GetManagedNotificationChildEventResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
988
+ #
989
+ # * {Types::GetManagedNotificationChildEventResponse#arn #arn} => String
990
+ # * {Types::GetManagedNotificationChildEventResponse#managed_notification_configuration_arn #managed_notification_configuration_arn} => String
991
+ # * {Types::GetManagedNotificationChildEventResponse#creation_time #creation_time} => Time
992
+ # * {Types::GetManagedNotificationChildEventResponse#content #content} => Types::ManagedNotificationChildEvent
993
+ #
994
+ # @example Request syntax with placeholder values
995
+ #
996
+ # resp = client.get_managed_notification_child_event({
997
+ # arn: "ManagedNotificationChildEventArn", # required
998
+ # locale: "de_DE", # accepts de_DE, en_CA, en_US, en_UK, es_ES, fr_CA, fr_FR, id_ID, it_IT, ja_JP, ko_KR, pt_BR, tr_TR, zh_CN, zh_TW
999
+ # })
1000
+ #
1001
+ # @example Response structure
1002
+ #
1003
+ # resp.arn #=> String
1004
+ # resp.managed_notification_configuration_arn #=> String
1005
+ # resp.creation_time #=> Time
1006
+ # resp.content.schema_version #=> String, one of "v1.0"
1007
+ # resp.content.id #=> String
1008
+ # resp.content.message_components.headline #=> String
1009
+ # resp.content.message_components.paragraph_summary #=> String
1010
+ # resp.content.message_components.complete_description #=> String
1011
+ # resp.content.message_components.dimensions #=> Array
1012
+ # resp.content.message_components.dimensions[0].name #=> String
1013
+ # resp.content.message_components.dimensions[0].value #=> String
1014
+ # resp.content.source_event_detail_url #=> String
1015
+ # resp.content.source_event_detail_url_display_text #=> String
1016
+ # resp.content.notification_type #=> String, one of "ALERT", "WARNING", "ANNOUNCEMENT", "INFORMATIONAL"
1017
+ # resp.content.event_status #=> String, one of "HEALTHY", "UNHEALTHY"
1018
+ # resp.content.aggregate_managed_notification_event_arn #=> String
1019
+ # resp.content.start_time #=> Time
1020
+ # resp.content.end_time #=> Time
1021
+ # resp.content.text_parts #=> Hash
1022
+ # resp.content.text_parts["TextPartId"].type #=> String, one of "LOCALIZED_TEXT", "PLAIN_TEXT", "URL"
1023
+ # resp.content.text_parts["TextPartId"].display_text #=> String
1024
+ # resp.content.text_parts["TextPartId"].text_by_locale #=> Hash
1025
+ # resp.content.text_parts["TextPartId"].text_by_locale["LocaleCode"] #=> String
1026
+ # resp.content.text_parts["TextPartId"].url #=> String
1027
+ # resp.content.organizational_unit_id #=> String
1028
+ # resp.content.aggregation_detail.summarization_dimensions #=> Array
1029
+ # resp.content.aggregation_detail.summarization_dimensions[0].name #=> String
1030
+ # resp.content.aggregation_detail.summarization_dimensions[0].value #=> String
1031
+ #
1032
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/GetManagedNotificationChildEvent AWS API Documentation
1033
+ #
1034
+ # @overload get_managed_notification_child_event(params = {})
1035
+ # @param [Hash] params ({})
1036
+ def get_managed_notification_child_event(params = {}, options = {})
1037
+ req = build_request(:get_managed_notification_child_event, params)
1038
+ req.send_request(options)
1039
+ end
1040
+
1041
+ # Returns a specified `ManagedNotificationConfiguration`.
1042
+ #
1043
+ # @option params [required, String] :arn
1044
+ # The Amazon Resource Name (ARN) of the
1045
+ # `ManagedNotificationConfiguration` to return.
1046
+ #
1047
+ # @return [Types::GetManagedNotificationConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1048
+ #
1049
+ # * {Types::GetManagedNotificationConfigurationResponse#arn #arn} => String
1050
+ # * {Types::GetManagedNotificationConfigurationResponse#name #name} => String
1051
+ # * {Types::GetManagedNotificationConfigurationResponse#description #description} => String
1052
+ # * {Types::GetManagedNotificationConfigurationResponse#category #category} => String
1053
+ # * {Types::GetManagedNotificationConfigurationResponse#sub_category #sub_category} => String
1054
+ #
1055
+ # @example Request syntax with placeholder values
1056
+ #
1057
+ # resp = client.get_managed_notification_configuration({
1058
+ # arn: "ManagedNotificationConfigurationOsArn", # required
1059
+ # })
1060
+ #
1061
+ # @example Response structure
1062
+ #
1063
+ # resp.arn #=> String
1064
+ # resp.name #=> String
1065
+ # resp.description #=> String
1066
+ # resp.category #=> String
1067
+ # resp.sub_category #=> String
1068
+ #
1069
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/GetManagedNotificationConfiguration AWS API Documentation
1070
+ #
1071
+ # @overload get_managed_notification_configuration(params = {})
1072
+ # @param [Hash] params ({})
1073
+ def get_managed_notification_configuration(params = {}, options = {})
1074
+ req = build_request(:get_managed_notification_configuration, params)
1075
+ req.send_request(options)
1076
+ end
1077
+
1078
+ # Returns a specified `ManagedNotificationEvent`.
1079
+ #
1080
+ # @option params [required, String] :arn
1081
+ # The Amazon Resource Name (ARN) of the `ManagedNotificationEvent` to
1082
+ # return.
1083
+ #
1084
+ # @option params [String] :locale
1085
+ # The locale code of the language used for the retrieved
1086
+ # `ManagedNotificationEvent`. The default locale is English `(en_US)`.
1087
+ #
1088
+ # @return [Types::GetManagedNotificationEventResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1089
+ #
1090
+ # * {Types::GetManagedNotificationEventResponse#arn #arn} => String
1091
+ # * {Types::GetManagedNotificationEventResponse#managed_notification_configuration_arn #managed_notification_configuration_arn} => String
1092
+ # * {Types::GetManagedNotificationEventResponse#creation_time #creation_time} => Time
1093
+ # * {Types::GetManagedNotificationEventResponse#content #content} => Types::ManagedNotificationEvent
1094
+ #
1095
+ # @example Request syntax with placeholder values
1096
+ #
1097
+ # resp = client.get_managed_notification_event({
1098
+ # arn: "ManagedNotificationEventArn", # required
1099
+ # locale: "de_DE", # accepts de_DE, en_CA, en_US, en_UK, es_ES, fr_CA, fr_FR, id_ID, it_IT, ja_JP, ko_KR, pt_BR, tr_TR, zh_CN, zh_TW
1100
+ # })
1101
+ #
1102
+ # @example Response structure
1103
+ #
1104
+ # resp.arn #=> String
1105
+ # resp.managed_notification_configuration_arn #=> String
1106
+ # resp.creation_time #=> Time
1107
+ # resp.content.schema_version #=> String, one of "v1.0"
1108
+ # resp.content.id #=> String
1109
+ # resp.content.message_components.headline #=> String
1110
+ # resp.content.message_components.paragraph_summary #=> String
1111
+ # resp.content.message_components.complete_description #=> String
1112
+ # resp.content.message_components.dimensions #=> Array
1113
+ # resp.content.message_components.dimensions[0].name #=> String
1114
+ # resp.content.message_components.dimensions[0].value #=> String
1115
+ # resp.content.source_event_detail_url #=> String
1116
+ # resp.content.source_event_detail_url_display_text #=> String
1117
+ # resp.content.notification_type #=> String, one of "ALERT", "WARNING", "ANNOUNCEMENT", "INFORMATIONAL"
1118
+ # resp.content.event_status #=> String, one of "HEALTHY", "UNHEALTHY"
1119
+ # resp.content.aggregation_event_type #=> String, one of "AGGREGATE", "CHILD", "NONE"
1120
+ # resp.content.aggregation_summary.event_count #=> Integer
1121
+ # resp.content.aggregation_summary.aggregated_by #=> Array
1122
+ # resp.content.aggregation_summary.aggregated_by[0].name #=> String
1123
+ # resp.content.aggregation_summary.aggregated_by[0].value #=> String
1124
+ # resp.content.aggregation_summary.aggregated_accounts.name #=> String
1125
+ # resp.content.aggregation_summary.aggregated_accounts.count #=> Integer
1126
+ # resp.content.aggregation_summary.aggregated_accounts.sample_values #=> Array
1127
+ # resp.content.aggregation_summary.aggregated_accounts.sample_values[0] #=> String
1128
+ # resp.content.aggregation_summary.aggregated_regions.name #=> String
1129
+ # resp.content.aggregation_summary.aggregated_regions.count #=> Integer
1130
+ # resp.content.aggregation_summary.aggregated_regions.sample_values #=> Array
1131
+ # resp.content.aggregation_summary.aggregated_regions.sample_values[0] #=> String
1132
+ # resp.content.aggregation_summary.aggregated_organizational_units.name #=> String
1133
+ # resp.content.aggregation_summary.aggregated_organizational_units.count #=> Integer
1134
+ # resp.content.aggregation_summary.aggregated_organizational_units.sample_values #=> Array
1135
+ # resp.content.aggregation_summary.aggregated_organizational_units.sample_values[0] #=> String
1136
+ # resp.content.aggregation_summary.additional_summarization_dimensions #=> Array
1137
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].name #=> String
1138
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].count #=> Integer
1139
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].sample_values #=> Array
1140
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].sample_values[0] #=> String
1141
+ # resp.content.start_time #=> Time
1142
+ # resp.content.end_time #=> Time
1143
+ # resp.content.text_parts #=> Hash
1144
+ # resp.content.text_parts["TextPartId"].type #=> String, one of "LOCALIZED_TEXT", "PLAIN_TEXT", "URL"
1145
+ # resp.content.text_parts["TextPartId"].display_text #=> String
1146
+ # resp.content.text_parts["TextPartId"].text_by_locale #=> Hash
1147
+ # resp.content.text_parts["TextPartId"].text_by_locale["LocaleCode"] #=> String
1148
+ # resp.content.text_parts["TextPartId"].url #=> String
1149
+ # resp.content.organizational_unit_id #=> String
1150
+ #
1151
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/GetManagedNotificationEvent AWS API Documentation
1152
+ #
1153
+ # @overload get_managed_notification_event(params = {})
1154
+ # @param [Hash] params ({})
1155
+ def get_managed_notification_event(params = {}, options = {})
1156
+ req = build_request(:get_managed_notification_event, params)
1157
+ req.send_request(options)
1158
+ end
1159
+
1160
+ # Returns a specified `NotificationConfiguration`.
816
1161
  #
817
1162
  # @option params [required, String] :arn
818
- # The Amazon Resource Name (ARN) of the NotificationConfiguration to
1163
+ # The Amazon Resource Name (ARN) of the `NotificationConfiguration` to
819
1164
  # return.
820
1165
  #
821
1166
  # @return [Types::GetNotificationConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -851,27 +1196,27 @@ module Aws::Notifications
851
1196
  req.send_request(options)
852
1197
  end
853
1198
 
854
- # Returns a specified NotificationEvent.
1199
+ # Returns a specified `NotificationEvent`.
855
1200
  #
856
1201
  # User Notifications stores notifications in the individual Regions you
857
1202
  # register as notification hubs and the Region of the source event rule.
858
- # GetNotificationEvent only returns notifications stored in the same
1203
+ # `GetNotificationEvent` only returns notifications stored in the same
859
1204
  # Region in which the action is called. User Notifications doesn't
860
1205
  # backfill notifications to new Regions selected as notification hubs.
861
1206
  # For this reason, we recommend that you make calls in your oldest
862
1207
  # registered notification hub. For more information, see [Notification
863
- # hubs][1] in the *AWS User Notifications User Guide*.
1208
+ # hubs][1] in the *Amazon Web Services User Notifications User Guide*.
864
1209
  #
865
1210
  #
866
1211
  #
867
1212
  # [1]: https://docs.aws.amazon.com/notifications/latest/userguide/notification-hubs.html
868
1213
  #
869
1214
  # @option params [required, String] :arn
870
- # The Amazon Resource Name (ARN) of the NotificationEvent to return.
1215
+ # The Amazon Resource Name (ARN) of the `NotificationEvent` to return.
871
1216
  #
872
1217
  # @option params [String] :locale
873
1218
  # The locale code of the language used for the retrieved
874
- # NotificationEvent. The default locale is English `en_US`.
1219
+ # `NotificationEvent`. The default locale is English `en_US`.
875
1220
  #
876
1221
  # @return [Types::GetNotificationEventResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
877
1222
  #
@@ -919,6 +1264,27 @@ module Aws::Notifications
919
1264
  # resp.content.event_status #=> String, one of "HEALTHY", "UNHEALTHY"
920
1265
  # resp.content.aggregation_event_type #=> String, one of "AGGREGATE", "CHILD", "NONE"
921
1266
  # resp.content.aggregate_notification_event_arn #=> String
1267
+ # resp.content.aggregation_summary.event_count #=> Integer
1268
+ # resp.content.aggregation_summary.aggregated_by #=> Array
1269
+ # resp.content.aggregation_summary.aggregated_by[0].name #=> String
1270
+ # resp.content.aggregation_summary.aggregated_by[0].value #=> String
1271
+ # resp.content.aggregation_summary.aggregated_accounts.name #=> String
1272
+ # resp.content.aggregation_summary.aggregated_accounts.count #=> Integer
1273
+ # resp.content.aggregation_summary.aggregated_accounts.sample_values #=> Array
1274
+ # resp.content.aggregation_summary.aggregated_accounts.sample_values[0] #=> String
1275
+ # resp.content.aggregation_summary.aggregated_regions.name #=> String
1276
+ # resp.content.aggregation_summary.aggregated_regions.count #=> Integer
1277
+ # resp.content.aggregation_summary.aggregated_regions.sample_values #=> Array
1278
+ # resp.content.aggregation_summary.aggregated_regions.sample_values[0] #=> String
1279
+ # resp.content.aggregation_summary.aggregated_organizational_units.name #=> String
1280
+ # resp.content.aggregation_summary.aggregated_organizational_units.count #=> Integer
1281
+ # resp.content.aggregation_summary.aggregated_organizational_units.sample_values #=> Array
1282
+ # resp.content.aggregation_summary.aggregated_organizational_units.sample_values[0] #=> String
1283
+ # resp.content.aggregation_summary.additional_summarization_dimensions #=> Array
1284
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].name #=> String
1285
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].count #=> Integer
1286
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].sample_values #=> Array
1287
+ # resp.content.aggregation_summary.additional_summarization_dimensions[0].sample_values[0] #=> String
922
1288
  # resp.content.start_time #=> Time
923
1289
  # resp.content.end_time #=> Time
924
1290
  # resp.content.text_parts #=> Hash
@@ -942,10 +1308,30 @@ module Aws::Notifications
942
1308
  req.send_request(options)
943
1309
  end
944
1310
 
945
- # Returns a list of Channels for a NotificationConfiguration.
1311
+ # Returns the AccessStatus of Service Trust Enablement for User
1312
+ # Notifications and Amazon Web Services Organizations.
1313
+ #
1314
+ # @return [Types::GetNotificationsAccessForOrganizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1315
+ #
1316
+ # * {Types::GetNotificationsAccessForOrganizationResponse#notifications_access_for_organization #notifications_access_for_organization} => Types::NotificationsAccessForOrganization
1317
+ #
1318
+ # @example Response structure
1319
+ #
1320
+ # resp.notifications_access_for_organization.access_status #=> String, one of "ENABLED", "DISABLED", "PENDING"
1321
+ #
1322
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/GetNotificationsAccessForOrganization AWS API Documentation
1323
+ #
1324
+ # @overload get_notifications_access_for_organization(params = {})
1325
+ # @param [Hash] params ({})
1326
+ def get_notifications_access_for_organization(params = {}, options = {})
1327
+ req = build_request(:get_notifications_access_for_organization, params)
1328
+ req.send_request(options)
1329
+ end
1330
+
1331
+ # Returns a list of Channels for a `NotificationConfiguration`.
946
1332
  #
947
1333
  # @option params [required, String] :notification_configuration_arn
948
- # The Amazon Resource Name (ARN) of the NotificationConfiguration.
1334
+ # The Amazon Resource Name (ARN) of the `NotificationConfiguration`.
949
1335
  #
950
1336
  # @option params [Integer] :max_results
951
1337
  # The maximum number of results to be returned in this call. The default
@@ -953,7 +1339,8 @@ module Aws::Notifications
953
1339
  #
954
1340
  # @option params [String] :next_token
955
1341
  # The start token for paginated calls. Retrieved from the response of a
956
- # previous ListNotificationEvents call. NextToken uses Base64 encoding.
1342
+ # previous ListNotificationEvents call. `NextToken` uses Base64
1343
+ # encoding.
957
1344
  #
958
1345
  # @return [Types::ListChannelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
959
1346
  #
@@ -985,11 +1372,11 @@ module Aws::Notifications
985
1372
  req.send_request(options)
986
1373
  end
987
1374
 
988
- # Returns a list of EventRules according to specified filters, in
1375
+ # Returns a list of `EventRules` according to specified filters, in
989
1376
  # reverse chronological order (newest first).
990
1377
  #
991
1378
  # @option params [required, String] :notification_configuration_arn
992
- # The Amazon Resource Name (ARN) of the NotificationConfiguration.
1379
+ # The Amazon Resource Name (ARN) of the `NotificationConfiguration`.
993
1380
  #
994
1381
  # @option params [Integer] :max_results
995
1382
  # The maximum number of results to be returned in this call. The default
@@ -997,7 +1384,7 @@ module Aws::Notifications
997
1384
  #
998
1385
  # @option params [String] :next_token
999
1386
  # The start token for paginated calls. Retrieved from the response of a
1000
- # previous ListEventRules call. Next token uses Base64 encoding.
1387
+ # previous `ListEventRules` call. Next token uses Base64 encoding.
1001
1388
  #
1002
1389
  # @return [Types::ListEventRulesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1003
1390
  #
@@ -1041,16 +1428,302 @@ module Aws::Notifications
1041
1428
  req.send_request(options)
1042
1429
  end
1043
1430
 
1044
- # Returns a list of abbreviated NotificationConfigurations according to
1045
- # specified filters, in reverse chronological order (newest first).
1431
+ # Returns a list of Account contacts and Channels associated with a
1432
+ # `ManagedNotificationConfiguration`, in paginated format.
1433
+ #
1434
+ # @option params [required, String] :managed_notification_configuration_arn
1435
+ # The Amazon Resource Name (ARN) of the
1436
+ # `ManagedNotificationConfiguration` to match.
1437
+ #
1438
+ # @option params [Integer] :max_results
1439
+ # The maximum number of results to be returned in this call. Defaults to
1440
+ # 20.
1441
+ #
1442
+ # @option params [String] :next_token
1443
+ # The start token for paginated calls. Retrieved from the response of a
1444
+ # previous `ListManagedNotificationChannelAssociations` call.
1445
+ #
1446
+ # @return [Types::ListManagedNotificationChannelAssociationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1447
+ #
1448
+ # * {Types::ListManagedNotificationChannelAssociationsResponse#next_token #next_token} => String
1449
+ # * {Types::ListManagedNotificationChannelAssociationsResponse#channel_associations #channel_associations} => Array&lt;Types::ManagedNotificationChannelAssociationSummary&gt;
1450
+ #
1451
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1452
+ #
1453
+ # @example Request syntax with placeholder values
1454
+ #
1455
+ # resp = client.list_managed_notification_channel_associations({
1456
+ # managed_notification_configuration_arn: "ManagedNotificationConfigurationOsArn", # required
1457
+ # max_results: 1,
1458
+ # next_token: "NextToken",
1459
+ # })
1460
+ #
1461
+ # @example Response structure
1462
+ #
1463
+ # resp.next_token #=> String
1464
+ # resp.channel_associations #=> Array
1465
+ # resp.channel_associations[0].channel_identifier #=> String
1466
+ # resp.channel_associations[0].channel_type #=> String, one of "MOBILE", "CHATBOT", "EMAIL", "ACCOUNT_CONTACT"
1467
+ # resp.channel_associations[0].override_option #=> String, one of "ENABLED", "DISABLED"
1468
+ #
1469
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/ListManagedNotificationChannelAssociations AWS API Documentation
1470
+ #
1471
+ # @overload list_managed_notification_channel_associations(params = {})
1472
+ # @param [Hash] params ({})
1473
+ def list_managed_notification_channel_associations(params = {}, options = {})
1474
+ req = build_request(:list_managed_notification_channel_associations, params)
1475
+ req.send_request(options)
1476
+ end
1477
+
1478
+ # Returns a list of `ManagedNotificationChildEvents` for a specified
1479
+ # aggregate `ManagedNotificationEvent`, ordered by creation time in
1480
+ # reverse chronological order (newest first).
1481
+ #
1482
+ # @option params [required, String] :aggregate_managed_notification_event_arn
1483
+ # The Amazon Resource Name (ARN) of the `ManagedNotificationEvent`.
1484
+ #
1485
+ # @option params [Time,DateTime,Date,Integer,String] :start_time
1486
+ # The earliest time of events to return from this call.
1487
+ #
1488
+ # @option params [Time,DateTime,Date,Integer,String] :end_time
1489
+ # Latest time of events to return from this call.
1490
+ #
1491
+ # @option params [String] :locale
1492
+ # The locale code of the language used for the retrieved
1493
+ # `NotificationEvent`. The default locale is English.`en_US`.
1494
+ #
1495
+ # @option params [Integer] :max_results
1496
+ # The maximum number of results to be returned in this call. Defaults to
1497
+ # 20.
1498
+ #
1499
+ # @option params [String] :related_account
1500
+ # The Amazon Web Services account ID associated with the Managed
1501
+ # Notification Child Events.
1502
+ #
1503
+ # @option params [String] :organizational_unit_id
1504
+ # The identifier of the Amazon Web Services Organizations organizational
1505
+ # unit (OU) associated with the Managed Notification Child Events.
1506
+ #
1507
+ # @option params [String] :next_token
1508
+ # The start token for paginated calls. Retrieved from the response of a
1509
+ # previous ListManagedNotificationChannelAssociations call. Next token
1510
+ # uses Base64 encoding.
1511
+ #
1512
+ # @return [Types::ListManagedNotificationChildEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1513
+ #
1514
+ # * {Types::ListManagedNotificationChildEventsResponse#next_token #next_token} => String
1515
+ # * {Types::ListManagedNotificationChildEventsResponse#managed_notification_child_events #managed_notification_child_events} => Array&lt;Types::ManagedNotificationChildEventOverview&gt;
1516
+ #
1517
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1518
+ #
1519
+ # @example Request syntax with placeholder values
1520
+ #
1521
+ # resp = client.list_managed_notification_child_events({
1522
+ # aggregate_managed_notification_event_arn: "ManagedNotificationEventArn", # required
1523
+ # start_time: Time.now,
1524
+ # end_time: Time.now,
1525
+ # locale: "de_DE", # accepts de_DE, en_CA, en_US, en_UK, es_ES, fr_CA, fr_FR, id_ID, it_IT, ja_JP, ko_KR, pt_BR, tr_TR, zh_CN, zh_TW
1526
+ # max_results: 1,
1527
+ # related_account: "AccountId",
1528
+ # organizational_unit_id: "OrganizationalUnitId",
1529
+ # next_token: "NextToken",
1530
+ # })
1531
+ #
1532
+ # @example Response structure
1533
+ #
1534
+ # resp.next_token #=> String
1535
+ # resp.managed_notification_child_events #=> Array
1536
+ # resp.managed_notification_child_events[0].arn #=> String
1537
+ # resp.managed_notification_child_events[0].managed_notification_configuration_arn #=> String
1538
+ # resp.managed_notification_child_events[0].related_account #=> String
1539
+ # resp.managed_notification_child_events[0].creation_time #=> Time
1540
+ # resp.managed_notification_child_events[0].child_event.schema_version #=> String, one of "v1.0"
1541
+ # resp.managed_notification_child_events[0].child_event.source_event_metadata.event_origin_region #=> String
1542
+ # resp.managed_notification_child_events[0].child_event.source_event_metadata.source #=> String
1543
+ # resp.managed_notification_child_events[0].child_event.source_event_metadata.event_type #=> String
1544
+ # resp.managed_notification_child_events[0].child_event.message_components.headline #=> String
1545
+ # resp.managed_notification_child_events[0].child_event.aggregation_detail.summarization_dimensions #=> Array
1546
+ # resp.managed_notification_child_events[0].child_event.aggregation_detail.summarization_dimensions[0].name #=> String
1547
+ # resp.managed_notification_child_events[0].child_event.aggregation_detail.summarization_dimensions[0].value #=> String
1548
+ # resp.managed_notification_child_events[0].child_event.event_status #=> String, one of "HEALTHY", "UNHEALTHY"
1549
+ # resp.managed_notification_child_events[0].child_event.notification_type #=> String, one of "ALERT", "WARNING", "ANNOUNCEMENT", "INFORMATIONAL"
1550
+ # resp.managed_notification_child_events[0].aggregate_managed_notification_event_arn #=> String
1551
+ # resp.managed_notification_child_events[0].organizational_unit_id #=> String
1552
+ #
1553
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/ListManagedNotificationChildEvents AWS API Documentation
1554
+ #
1555
+ # @overload list_managed_notification_child_events(params = {})
1556
+ # @param [Hash] params ({})
1557
+ def list_managed_notification_child_events(params = {}, options = {})
1558
+ req = build_request(:list_managed_notification_child_events, params)
1559
+ req.send_request(options)
1560
+ end
1561
+
1562
+ # Returns a list of Managed Notification Configurations according to
1563
+ # specified filters, ordered by creation time in reverse chronological
1564
+ # order (newest first).
1565
+ #
1566
+ # @option params [String] :channel_identifier
1567
+ # The identifier or ARN of the notification channel to filter
1568
+ # configurations by.
1569
+ #
1570
+ # @option params [Integer] :max_results
1571
+ # The maximum number of results to be returned in this call. Defaults to
1572
+ # 20.
1573
+ #
1574
+ # @option params [String] :next_token
1575
+ # The start token for paginated calls. Retrieved from the response of a
1576
+ # previous ListManagedNotificationChannelAssociations call. Next token
1577
+ # uses Base64 encoding.
1578
+ #
1579
+ # @return [Types::ListManagedNotificationConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1580
+ #
1581
+ # * {Types::ListManagedNotificationConfigurationsResponse#next_token #next_token} => String
1582
+ # * {Types::ListManagedNotificationConfigurationsResponse#managed_notification_configurations #managed_notification_configurations} => Array&lt;Types::ManagedNotificationConfigurationStructure&gt;
1583
+ #
1584
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1585
+ #
1586
+ # @example Request syntax with placeholder values
1587
+ #
1588
+ # resp = client.list_managed_notification_configurations({
1589
+ # channel_identifier: "ChannelIdentifier",
1590
+ # max_results: 1,
1591
+ # next_token: "NextToken",
1592
+ # })
1593
+ #
1594
+ # @example Response structure
1595
+ #
1596
+ # resp.next_token #=> String
1597
+ # resp.managed_notification_configurations #=> Array
1598
+ # resp.managed_notification_configurations[0].arn #=> String
1599
+ # resp.managed_notification_configurations[0].name #=> String
1600
+ # resp.managed_notification_configurations[0].description #=> String
1601
+ #
1602
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/ListManagedNotificationConfigurations AWS API Documentation
1603
+ #
1604
+ # @overload list_managed_notification_configurations(params = {})
1605
+ # @param [Hash] params ({})
1606
+ def list_managed_notification_configurations(params = {}, options = {})
1607
+ req = build_request(:list_managed_notification_configurations, params)
1608
+ req.send_request(options)
1609
+ end
1610
+
1611
+ # Returns a list of Managed Notification Events according to specified
1612
+ # filters, ordered by creation time in reverse chronological order
1613
+ # (newest first).
1614
+ #
1615
+ # @option params [Time,DateTime,Date,Integer,String] :start_time
1616
+ # The earliest time of events to return from this call.
1617
+ #
1618
+ # @option params [Time,DateTime,Date,Integer,String] :end_time
1619
+ # Latest time of events to return from this call.
1620
+ #
1621
+ # @option params [String] :locale
1622
+ # The locale code of the language used for the retrieved
1623
+ # NotificationEvent. The default locale is English (en\_US).
1624
+ #
1625
+ # @option params [String] :source
1626
+ # The Amazon Web Services service the event originates from. For example
1627
+ # aws.cloudwatch.
1628
+ #
1629
+ # @option params [Integer] :max_results
1630
+ # The maximum number of results to be returned in this call. Defaults to
1631
+ # 20.
1632
+ #
1633
+ # @option params [String] :next_token
1634
+ # The start token for paginated calls. Retrieved from the response of a
1635
+ # previous `ListManagedNotificationChannelAssociations` call. Next token
1636
+ # uses Base64 encoding.
1637
+ #
1638
+ # @option params [String] :organizational_unit_id
1639
+ # The Organizational Unit Id that an Amazon Web Services account belongs
1640
+ # to.
1641
+ #
1642
+ # @option params [String] :related_account
1643
+ # The Amazon Web Services account ID associated with the Managed
1644
+ # Notification Events.
1645
+ #
1646
+ # @return [Types::ListManagedNotificationEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1647
+ #
1648
+ # * {Types::ListManagedNotificationEventsResponse#next_token #next_token} => String
1649
+ # * {Types::ListManagedNotificationEventsResponse#managed_notification_events #managed_notification_events} => Array&lt;Types::ManagedNotificationEventOverview&gt;
1650
+ #
1651
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1652
+ #
1653
+ # @example Request syntax with placeholder values
1654
+ #
1655
+ # resp = client.list_managed_notification_events({
1656
+ # start_time: Time.now,
1657
+ # end_time: Time.now,
1658
+ # locale: "de_DE", # accepts de_DE, en_CA, en_US, en_UK, es_ES, fr_CA, fr_FR, id_ID, it_IT, ja_JP, ko_KR, pt_BR, tr_TR, zh_CN, zh_TW
1659
+ # source: "Source",
1660
+ # max_results: 1,
1661
+ # next_token: "NextToken",
1662
+ # organizational_unit_id: "OrganizationalUnitId",
1663
+ # related_account: "AccountId",
1664
+ # })
1665
+ #
1666
+ # @example Response structure
1667
+ #
1668
+ # resp.next_token #=> String
1669
+ # resp.managed_notification_events #=> Array
1670
+ # resp.managed_notification_events[0].arn #=> String
1671
+ # resp.managed_notification_events[0].managed_notification_configuration_arn #=> String
1672
+ # resp.managed_notification_events[0].related_account #=> String
1673
+ # resp.managed_notification_events[0].creation_time #=> Time
1674
+ # resp.managed_notification_events[0].notification_event.schema_version #=> String, one of "v1.0"
1675
+ # resp.managed_notification_events[0].notification_event.source_event_metadata.event_origin_region #=> String
1676
+ # resp.managed_notification_events[0].notification_event.source_event_metadata.source #=> String
1677
+ # resp.managed_notification_events[0].notification_event.source_event_metadata.event_type #=> String
1678
+ # resp.managed_notification_events[0].notification_event.message_components.headline #=> String
1679
+ # resp.managed_notification_events[0].notification_event.event_status #=> String, one of "HEALTHY", "UNHEALTHY"
1680
+ # resp.managed_notification_events[0].notification_event.notification_type #=> String, one of "ALERT", "WARNING", "ANNOUNCEMENT", "INFORMATIONAL"
1681
+ # resp.managed_notification_events[0].aggregation_event_type #=> String, one of "AGGREGATE", "CHILD", "NONE"
1682
+ # resp.managed_notification_events[0].organizational_unit_id #=> String
1683
+ # resp.managed_notification_events[0].aggregation_summary.event_count #=> Integer
1684
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_by #=> Array
1685
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_by[0].name #=> String
1686
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_by[0].value #=> String
1687
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_accounts.name #=> String
1688
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_accounts.count #=> Integer
1689
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_accounts.sample_values #=> Array
1690
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_accounts.sample_values[0] #=> String
1691
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_regions.name #=> String
1692
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_regions.count #=> Integer
1693
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_regions.sample_values #=> Array
1694
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_regions.sample_values[0] #=> String
1695
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_organizational_units.name #=> String
1696
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_organizational_units.count #=> Integer
1697
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_organizational_units.sample_values #=> Array
1698
+ # resp.managed_notification_events[0].aggregation_summary.aggregated_organizational_units.sample_values[0] #=> String
1699
+ # resp.managed_notification_events[0].aggregation_summary.additional_summarization_dimensions #=> Array
1700
+ # resp.managed_notification_events[0].aggregation_summary.additional_summarization_dimensions[0].name #=> String
1701
+ # resp.managed_notification_events[0].aggregation_summary.additional_summarization_dimensions[0].count #=> Integer
1702
+ # resp.managed_notification_events[0].aggregation_summary.additional_summarization_dimensions[0].sample_values #=> Array
1703
+ # resp.managed_notification_events[0].aggregation_summary.additional_summarization_dimensions[0].sample_values[0] #=> String
1704
+ # resp.managed_notification_events[0].aggregated_notification_regions #=> Array
1705
+ # resp.managed_notification_events[0].aggregated_notification_regions[0] #=> String
1706
+ #
1707
+ # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/ListManagedNotificationEvents AWS API Documentation
1708
+ #
1709
+ # @overload list_managed_notification_events(params = {})
1710
+ # @param [Hash] params ({})
1711
+ def list_managed_notification_events(params = {}, options = {})
1712
+ req = build_request(:list_managed_notification_events, params)
1713
+ req.send_request(options)
1714
+ end
1715
+
1716
+ # Returns a list of abbreviated `NotificationConfigurations` according
1717
+ # to specified filters, in reverse chronological order (newest first).
1046
1718
  #
1047
1719
  # @option params [String] :event_rule_source
1048
1720
  # The matched event source.
1049
1721
  #
1050
- # Must match one of the valid EventBridge sources. Only AWS service
1051
- # sourced events are supported. For example, `aws.ec2` and
1052
- # `aws.cloudwatch`. For more information, see [Event delivery from AWS
1053
- # services][1] in the *Amazon EventBridge User Guide*.
1722
+ # Must match one of the valid EventBridge sources. Only Amazon Web
1723
+ # Services service sourced events are supported. For example, `aws.ec2`
1724
+ # and `aws.cloudwatch`. For more information, see [Event delivery from
1725
+ # Amazon Web Services services][1] in the *Amazon EventBridge User
1726
+ # Guide*.
1054
1727
  #
1055
1728
  #
1056
1729
  #
@@ -1060,29 +1733,29 @@ module Aws::Notifications
1060
1733
  # The Amazon Resource Name (ARN) of the Channel to match.
1061
1734
  #
1062
1735
  # @option params [String] :status
1063
- # The NotificationConfiguration status to match.
1736
+ # The `NotificationConfiguration` status to match.
1064
1737
  #
1065
1738
  # * Values:
1066
1739
  #
1067
1740
  # * `ACTIVE`
1068
1741
  #
1069
- # * All EventRules are `ACTIVE` and any call can be run.
1742
+ # * All `EventRules` are `ACTIVE` and any call can be run.
1070
1743
  #
1071
1744
  # ^
1072
1745
  # * `PARTIALLY_ACTIVE`
1073
1746
  #
1074
- # * Some EventRules are `ACTIVE` and some are `INACTIVE`. Any call
1747
+ # * Some `EventRules` are `ACTIVE` and some are `INACTIVE`. Any call
1075
1748
  # can be run.
1076
1749
  #
1077
1750
  # * Any call can be run.
1078
1751
  # * `INACTIVE`
1079
1752
  #
1080
- # * All EventRules are `INACTIVE` and any call can be run.
1753
+ # * All `EventRules` are `INACTIVE` and any call can be run.
1081
1754
  #
1082
1755
  # ^
1083
1756
  # * `DELETING`
1084
1757
  #
1085
- # * This NotificationConfiguration is being deleted.
1758
+ # * This `NotificationConfiguration` is being deleted.
1086
1759
  #
1087
1760
  # * Only `GET` and `LIST` calls can be run.
1088
1761
  #
@@ -1092,7 +1765,7 @@ module Aws::Notifications
1092
1765
  #
1093
1766
  # @option params [String] :next_token
1094
1767
  # The start token for paginated calls. Retrieved from the response of a
1095
- # previous ListEventRules call. Next token uses Base64 encoding.
1768
+ # previous `ListEventRules` call. Next token uses Base64 encoding.
1096
1769
  #
1097
1770
  # @return [Types::ListNotificationConfigurationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1098
1771
  #
@@ -1131,7 +1804,7 @@ module Aws::Notifications
1131
1804
  req.send_request(options)
1132
1805
  end
1133
1806
 
1134
- # Returns a list of NotificationEvents according to specified filters,
1807
+ # Returns a list of `NotificationEvents` according to specified filters,
1135
1808
  # in reverse chronological order (newest first).
1136
1809
  #
1137
1810
  # User Notifications stores notifications in the individual Regions you
@@ -1141,7 +1814,7 @@ module Aws::Notifications
1141
1814
  # backfill notifications to new Regions selected as notification hubs.
1142
1815
  # For this reason, we recommend that you make calls in your oldest
1143
1816
  # registered notification hub. For more information, see [Notification
1144
- # hubs][1] in the *AWS User Notifications User Guide*.
1817
+ # hubs][1] in the *Amazon Web Services User Notifications User Guide*.
1145
1818
  #
1146
1819
  #
1147
1820
  #
@@ -1155,15 +1828,16 @@ module Aws::Notifications
1155
1828
  #
1156
1829
  # @option params [String] :locale
1157
1830
  # The locale code of the language used for the retrieved
1158
- # NotificationEvent. The default locale is English `(en_US)`.
1831
+ # `NotificationEvent`. The default locale is English `(en_US)`.
1159
1832
  #
1160
1833
  # @option params [String] :source
1161
1834
  # The matched event source.
1162
1835
  #
1163
- # Must match one of the valid EventBridge sources. Only AWS service
1164
- # sourced events are supported. For example, `aws.ec2` and
1165
- # `aws.cloudwatch`. For more information, see [Event delivery from AWS
1166
- # services][1] in the *Amazon EventBridge User Guide*.
1836
+ # Must match one of the valid EventBridge sources. Only Amazon Web
1837
+ # Services service sourced events are supported. For example, `aws.ec2`
1838
+ # and `aws.cloudwatch`. For more information, see [Event delivery from
1839
+ # Amazon Web Services services][1] in the *Amazon EventBridge User
1840
+ # Guide*.
1167
1841
  #
1168
1842
  #
1169
1843
  #
@@ -1173,7 +1847,7 @@ module Aws::Notifications
1173
1847
  # Include aggregated child events in the result.
1174
1848
  #
1175
1849
  # @option params [String] :aggregate_notification_event_arn
1176
- # The Amazon Resource Name (ARN) of the aggregatedNotificationEventArn
1850
+ # The Amazon Resource Name (ARN) of the `aggregatedNotificationEventArn`
1177
1851
  # to match.
1178
1852
  #
1179
1853
  # @option params [Integer] :max_results
@@ -1182,7 +1856,7 @@ module Aws::Notifications
1182
1856
  #
1183
1857
  # @option params [String] :next_token
1184
1858
  # The start token for paginated calls. Retrieved from the response of a
1185
- # previous ListEventRules call. Next token uses Base64 encoding.
1859
+ # previous `ListEventRules` call. Next token uses Base64 encoding.
1186
1860
  #
1187
1861
  # @return [Types::ListNotificationEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1188
1862
  #
@@ -1221,6 +1895,27 @@ module Aws::Notifications
1221
1895
  # resp.notification_events[0].notification_event.notification_type #=> String, one of "ALERT", "WARNING", "ANNOUNCEMENT", "INFORMATIONAL"
1222
1896
  # resp.notification_events[0].aggregation_event_type #=> String, one of "AGGREGATE", "CHILD", "NONE"
1223
1897
  # resp.notification_events[0].aggregate_notification_event_arn #=> String
1898
+ # resp.notification_events[0].aggregation_summary.event_count #=> Integer
1899
+ # resp.notification_events[0].aggregation_summary.aggregated_by #=> Array
1900
+ # resp.notification_events[0].aggregation_summary.aggregated_by[0].name #=> String
1901
+ # resp.notification_events[0].aggregation_summary.aggregated_by[0].value #=> String
1902
+ # resp.notification_events[0].aggregation_summary.aggregated_accounts.name #=> String
1903
+ # resp.notification_events[0].aggregation_summary.aggregated_accounts.count #=> Integer
1904
+ # resp.notification_events[0].aggregation_summary.aggregated_accounts.sample_values #=> Array
1905
+ # resp.notification_events[0].aggregation_summary.aggregated_accounts.sample_values[0] #=> String
1906
+ # resp.notification_events[0].aggregation_summary.aggregated_regions.name #=> String
1907
+ # resp.notification_events[0].aggregation_summary.aggregated_regions.count #=> Integer
1908
+ # resp.notification_events[0].aggregation_summary.aggregated_regions.sample_values #=> Array
1909
+ # resp.notification_events[0].aggregation_summary.aggregated_regions.sample_values[0] #=> String
1910
+ # resp.notification_events[0].aggregation_summary.aggregated_organizational_units.name #=> String
1911
+ # resp.notification_events[0].aggregation_summary.aggregated_organizational_units.count #=> Integer
1912
+ # resp.notification_events[0].aggregation_summary.aggregated_organizational_units.sample_values #=> Array
1913
+ # resp.notification_events[0].aggregation_summary.aggregated_organizational_units.sample_values[0] #=> String
1914
+ # resp.notification_events[0].aggregation_summary.additional_summarization_dimensions #=> Array
1915
+ # resp.notification_events[0].aggregation_summary.additional_summarization_dimensions[0].name #=> String
1916
+ # resp.notification_events[0].aggregation_summary.additional_summarization_dimensions[0].count #=> Integer
1917
+ # resp.notification_events[0].aggregation_summary.additional_summarization_dimensions[0].sample_values #=> Array
1918
+ # resp.notification_events[0].aggregation_summary.additional_summarization_dimensions[0].sample_values[0] #=> String
1224
1919
  #
1225
1920
  # @see http://docs.aws.amazon.com/goto/WebAPI/notifications-2018-05-10/ListNotificationEvents AWS API Documentation
1226
1921
  #
@@ -1231,7 +1926,7 @@ module Aws::Notifications
1231
1926
  req.send_request(options)
1232
1927
  end
1233
1928
 
1234
- # Returns a list of NotificationHubs.
1929
+ # Returns a list of `NotificationHubs`.
1235
1930
  #
1236
1931
  # @option params [Integer] :max_results
1237
1932
  # The maximum number of records to list in a single response.
@@ -1275,10 +1970,11 @@ module Aws::Notifications
1275
1970
 
1276
1971
  # Returns a list of tags for a specified Amazon Resource Name (ARN).
1277
1972
  #
1278
- # For more information, see [Tagging your AWS resources][1] in the
1279
- # *Tagging AWS Resources User Guide*.
1973
+ # For more information, see [Tagging your Amazon Web Services
1974
+ # resources][1] in the *Tagging Amazon Web Services Resources User
1975
+ # Guide*.
1280
1976
  #
1281
- # <note markdown="1"> This is only supported for NotificationConfigurations.
1977
+ # <note markdown="1"> This is only supported for `NotificationConfigurations`.
1282
1978
  #
1283
1979
  # </note>
1284
1980
  #
@@ -1313,13 +2009,13 @@ module Aws::Notifications
1313
2009
  req.send_request(options)
1314
2010
  end
1315
2011
 
1316
- # Registers a NotificationHub in the specified Region.
2012
+ # Registers a `NotificationConfiguration` in the specified Region.
1317
2013
  #
1318
- # There is a maximum of one NotificationHub per Region. You can have a
1319
- # maximum of 3 NotificationHubs at a time.
2014
+ # There is a maximum of one `NotificationConfiguration` per Region. You
2015
+ # can have a maximum of 3 `NotificationHub` resources at a time.
1320
2016
  #
1321
2017
  # @option params [required, String] :notification_hub_region
1322
- # The Region of the NotificationHub.
2018
+ # The Region of the `NotificationHub`.
1323
2019
  #
1324
2020
  # @return [Types::RegisterNotificationHubResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1325
2021
  #
@@ -1353,10 +2049,11 @@ module Aws::Notifications
1353
2049
 
1354
2050
  # Tags the resource with a tag key and value.
1355
2051
  #
1356
- # For more information, see [Tagging your AWS resources][1] in the
1357
- # *Tagging AWS Resources User Guide*.
2052
+ # For more information, see [Tagging your Amazon Web Services
2053
+ # resources][1] in the *Tagging Amazon Web Services Resources User
2054
+ # Guide*.
1358
2055
  #
1359
- # <note markdown="1"> This is only supported for NotificationConfigurations.
2056
+ # <note markdown="1"> This is only supported for `NotificationConfigurations`.
1360
2057
  #
1361
2058
  # </note>
1362
2059
  #
@@ -1393,8 +2090,9 @@ module Aws::Notifications
1393
2090
 
1394
2091
  # Untags a resource with a specified Amazon Resource Name (ARN).
1395
2092
  #
1396
- # For more information, see [Tagging your AWS resources][1] in the
1397
- # *Tagging AWS Resources User Guide*.
2093
+ # For more information, see [Tagging your Amazon Web Services
2094
+ # resources][1] in the *Tagging Amazon Web Services Resources User
2095
+ # Guide*.
1398
2096
  #
1399
2097
  #
1400
2098
  #
@@ -1424,14 +2122,14 @@ module Aws::Notifications
1424
2122
  req.send_request(options)
1425
2123
  end
1426
2124
 
1427
- # Updates an existing EventRule.
2125
+ # Updates an existing `EventRule`.
1428
2126
  #
1429
2127
  # @option params [required, String] :arn
1430
- # The Amazon Resource Name (ARN) to use to update the EventRule.
2128
+ # The Amazon Resource Name (ARN) to use to update the `EventRule`.
1431
2129
  #
1432
2130
  # @option params [String] :event_pattern
1433
2131
  # An additional event pattern used to further filter the events this
1434
- # EventRule receives.
2132
+ # `EventRule` receives.
1435
2133
  #
1436
2134
  # For more information, see [Amazon EventBridge event patterns][1] in
1437
2135
  # the *Amazon EventBridge User Guide.*
@@ -1441,7 +2139,8 @@ module Aws::Notifications
1441
2139
  # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html
1442
2140
  #
1443
2141
  # @option params [Array<String>] :regions
1444
- # A list of AWS Regions that sends events to this EventRule.
2142
+ # A list of Amazon Web Services Regions that sends events to this
2143
+ # `EventRule`.
1445
2144
  #
1446
2145
  # @return [Types::UpdateEventRuleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1447
2146
  #
@@ -1474,47 +2173,38 @@ module Aws::Notifications
1474
2173
  req.send_request(options)
1475
2174
  end
1476
2175
 
1477
- # Updates a NotificationConfiguration.
2176
+ # Updates a `NotificationConfiguration`.
1478
2177
  #
1479
2178
  # @option params [required, String] :arn
1480
2179
  # The Amazon Resource Name (ARN) used to update the
1481
- # NotificationConfiguration.
2180
+ # `NotificationConfiguration`.
1482
2181
  #
1483
2182
  # @option params [String] :name
1484
- # The name of the NotificationConfiguration.
2183
+ # The name of the `NotificationConfiguration`.
1485
2184
  #
1486
2185
  # @option params [String] :description
1487
- # The description of the NotificationConfiguration.
2186
+ # The description of the `NotificationConfiguration`.
1488
2187
  #
1489
2188
  # @option params [String] :aggregation_duration
1490
- # The status of this NotificationConfiguration.
1491
- #
1492
- # The status should always be `INACTIVE` when part of the
1493
- # CreateNotificationConfiguration response.
2189
+ # The aggregation preference of the `NotificationConfiguration`.
1494
2190
  #
1495
2191
  # * Values:
1496
2192
  #
1497
- # * `ACTIVE`
2193
+ # * `LONG`
1498
2194
  #
1499
- # * All EventRules are `ACTIVE` and any call can be run.
2195
+ # * Aggregate notifications for long periods of time (12 hours).
1500
2196
  #
1501
2197
  # ^
1502
- # * `PARTIALLY_ACTIVE`
1503
- #
1504
- # * Some EventRules are `ACTIVE` and some are `INACTIVE`. Any call
1505
- # can be run.
1506
- #
1507
- # * Any call can be run.
1508
- # * `INACTIVE`
2198
+ # * `SHORT`
1509
2199
  #
1510
- # * All EventRules are `INACTIVE` and any call can be run.
2200
+ # * Aggregate notifications for short periods of time (5 minutes).
1511
2201
  #
1512
2202
  # ^
1513
- # * `DELETING`
2203
+ # * `NONE`
1514
2204
  #
1515
- # * This NotificationConfiguration is being deleted.
2205
+ # * Don't aggregate notifications.
1516
2206
  #
1517
- # * Only `GET` and `LIST` calls can be run.
2207
+ # ^
1518
2208
  #
1519
2209
  # @return [Types::UpdateNotificationConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1520
2210
  #
@@ -1560,7 +2250,7 @@ module Aws::Notifications
1560
2250
  tracer: tracer
1561
2251
  )
1562
2252
  context[:gem_name] = 'aws-sdk-notifications'
1563
- context[:gem_version] = '1.1.0'
2253
+ context[:gem_version] = '1.2.0'
1564
2254
  Seahorse::Client::Request.new(handlers, context)
1565
2255
  end
1566
2256