aws-sdk-eventbridge 1.50.0 → 1.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7aad6b8261dd586faa963ee95aac75e2a9231c3b026da044db1e4b6ae03661a1
4
- data.tar.gz: a8f9a1c473d18cfaaf6bece5ac1a0533cbb64899e2bab9d7544bde5a5c698d5c
3
+ metadata.gz: 7f62b62bd3c921007b1114d31fa5b448cff9bb44df0d06c41cdc3cd169763fa0
4
+ data.tar.gz: fbc4ff180c1e32645abba43e977e7a5ea10a69cd08dd2f8f0db1e397f9908ee8
5
5
  SHA512:
6
- metadata.gz: 36db39b72b4de9ac9e2837db5bdc23f43f935cad52c7e366ed508fba306b1c38ea8f75561f0196ac17d1aa813261eccfddff07c11dd6d1b9e9488c895d8229c1
7
- data.tar.gz: b8750d912dc9a45b64fad40f53c576b2cbadd8ec39fcf5a008a2110e579beaadea6f01124be996f5a552b90366dc58c40cb81abcbc64387bba7b4d79d3faabc0
6
+ metadata.gz: a4212940574b2d66b079b44e47e9152fa655cb8222a3afff1c3b88ea93d92d5f27c19b11bb744f49fad8c3a0ddfb2ba005d8175c9504db6e6683cffdee6a4bed
7
+ data.tar.gz: 77358b5675db9d6fdfcfa6de4256624af90614e5406f43aff9e71cefa61cd37243afbb0c4ccdc1ebea0ee2412dd81363f0ec9a6c05ce8949e6d7e5670e6d51c7
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.52.0 (2023-11-17)
5
+ ------------------
6
+
7
+ * Feature - Introduces a new rule state ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS for matching with Get, List and Describe AWS API call events from CloudTrail.
8
+
9
+ 1.51.0 (2023-09-27)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.50.0 (2023-09-12)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.50.0
1
+ 1.52.0
@@ -457,6 +457,16 @@ module Aws::EventBridge
457
457
  # Creates an API destination, which is an HTTP invocation endpoint
458
458
  # configured as a target for events.
459
459
  #
460
+ # API destinations do not support private destinations, such as
461
+ # interface VPC endpoints.
462
+ #
463
+ # For more information, see [API destinations][1] in the *EventBridge
464
+ # User Guide*.
465
+ #
466
+ #
467
+ #
468
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html
469
+ #
460
470
  # @option params [required, String] :name
461
471
  # The name for the API destination to create.
462
472
  #
@@ -848,14 +858,23 @@ module Aws::EventBridge
848
858
  #
849
859
  # ` partner_name/event_namespace/event_name `
850
860
  #
851
- # *partner\_name* is determined during partner registration and
852
- # identifies the partner to Amazon Web Services customers.
853
- # *event\_namespace* is determined by the partner and is a way for the
854
- # partner to categorize their events. *event\_name* is determined by the
855
- # partner, and should uniquely identify an event-generating resource
856
- # within the partner system. The combination of *event\_namespace* and
857
- # *event\_name* should help Amazon Web Services customers decide whether
858
- # to create an event bus to receive these events.
861
+ # * *partner\_name* is determined during partner registration, and
862
+ # identifies the partner to Amazon Web Services customers.
863
+ #
864
+ # * *event\_namespace* is determined by the partner, and is a way for
865
+ # the partner to categorize their events.
866
+ #
867
+ # * *event\_name* is determined by the partner, and should uniquely
868
+ # identify an event-generating resource within the partner system.
869
+ #
870
+ # The *event\_name* must be unique across all Amazon Web Services
871
+ # customers. This is because the event source is a shared resource
872
+ # between the partner and customer accounts, and each partner event
873
+ # source unique in the partner account.
874
+ #
875
+ # The combination of *event\_namespace* and *event\_name* should help
876
+ # Amazon Web Services customers decide whether to create an event bus to
877
+ # receive these events.
859
878
  #
860
879
  # @option params [required, String] :name
861
880
  # The name of the partner event source. This name must be unique and
@@ -1047,8 +1066,8 @@ module Aws::EventBridge
1047
1066
 
1048
1067
  # Delete an existing global endpoint. For more information about global
1049
1068
  # endpoints, see [Making applications Regional-fault tolerant with
1050
- # global endpoints and event replication][1] in the Amazon EventBridge
1051
- # User Guide.
1069
+ # global endpoints and event replication][1] in the *Amazon EventBridge
1070
+ # User Guide*.
1052
1071
  #
1053
1072
  #
1054
1073
  #
@@ -1360,7 +1379,7 @@ module Aws::EventBridge
1360
1379
  # Get the information about an existing global endpoint. For more
1361
1380
  # information about global endpoints, see [Making applications
1362
1381
  # Regional-fault tolerant with global endpoints and event
1363
- # replication][1] in the Amazon EventBridge User Guide..
1382
+ # replication][1] in the *Amazon EventBridge User Guide*.
1364
1383
  #
1365
1384
  #
1366
1385
  #
@@ -1652,7 +1671,7 @@ module Aws::EventBridge
1652
1671
  # resp.arn #=> String
1653
1672
  # resp.event_pattern #=> String
1654
1673
  # resp.schedule_expression #=> String
1655
- # resp.state #=> String, one of "ENABLED", "DISABLED"
1674
+ # resp.state #=> String, one of "ENABLED", "DISABLED", "ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS"
1656
1675
  # resp.description #=> String
1657
1676
  # resp.role_arn #=> String
1658
1677
  # resp.managed_by #=> String
@@ -1899,7 +1918,7 @@ module Aws::EventBridge
1899
1918
  # List the global endpoints associated with this account. For more
1900
1919
  # information about global endpoints, see [Making applications
1901
1920
  # Regional-fault tolerant with global endpoints and event
1902
- # replication][1] in the Amazon EventBridge User Guide..
1921
+ # replication][1] in the *Amazon EventBridge User Guide*.
1903
1922
  #
1904
1923
  #
1905
1924
  #
@@ -2226,6 +2245,8 @@ module Aws::EventBridge
2226
2245
  # rules in Amazon EventBridge can invoke a specific target in your
2227
2246
  # account.
2228
2247
  #
2248
+ # The maximum number of results per page for requests is 100.
2249
+ #
2229
2250
  # @option params [required, String] :target_arn
2230
2251
  # The Amazon Resource Name (ARN) of the target resource.
2231
2252
  #
@@ -2272,6 +2293,8 @@ module Aws::EventBridge
2272
2293
  # Lists your Amazon EventBridge rules. You can either list all the rules
2273
2294
  # or you can provide a prefix to match to the rule names.
2274
2295
  #
2296
+ # The maximum number of results per page for requests is 100.
2297
+ #
2275
2298
  # ListRules does not list the targets of a rule. To see the targets
2276
2299
  # associated with a rule, use [ListTargetsByRule][1].
2277
2300
  #
@@ -2313,7 +2336,7 @@ module Aws::EventBridge
2313
2336
  # resp.rules[0].name #=> String
2314
2337
  # resp.rules[0].arn #=> String
2315
2338
  # resp.rules[0].event_pattern #=> String
2316
- # resp.rules[0].state #=> String, one of "ENABLED", "DISABLED"
2339
+ # resp.rules[0].state #=> String, one of "ENABLED", "DISABLED", "ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS"
2317
2340
  # resp.rules[0].description #=> String
2318
2341
  # resp.rules[0].schedule_expression #=> String
2319
2342
  # resp.rules[0].role_arn #=> String
@@ -2363,6 +2386,8 @@ module Aws::EventBridge
2363
2386
 
2364
2387
  # Lists the targets assigned to the specified rule.
2365
2388
  #
2389
+ # The maximum number of results per page for requests is 100.
2390
+ #
2366
2391
  # @option params [required, String] :rule
2367
2392
  # The name of the rule.
2368
2393
  #
@@ -2473,10 +2498,25 @@ module Aws::EventBridge
2473
2498
  # Sends custom events to Amazon EventBridge so that they can be matched
2474
2499
  # to rules.
2475
2500
  #
2501
+ # The maximum size for a PutEvents event entry is 256 KB. Entry size is
2502
+ # calculated including the event and any necessary characters and keys
2503
+ # of the JSON representation of the event. To learn more, see
2504
+ # [Calculating PutEvents event entry size][1] in the *Amazon EventBridge
2505
+ # User Guide*
2506
+ #
2507
+ # PutEvents accepts the data in JSON format. For the JSON number
2508
+ # (integer) data type, the constraints are: a minimum value of
2509
+ # -9,223,372,036,854,775,808 and a maximum value of
2510
+ # 9,223,372,036,854,775,807.
2511
+ #
2476
2512
  # <note markdown="1"> PutEvents will only process nested JSON up to 1100 levels deep.
2477
2513
  #
2478
2514
  # </note>
2479
2515
  #
2516
+ #
2517
+ #
2518
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevent-size.html
2519
+ #
2480
2520
  # @option params [required, Array<Types::PutEventsRequestEntry>] :entries
2481
2521
  # The entry that defines an event in your system. You can specify
2482
2522
  # several parameters for the entry such as the source and type of the
@@ -2531,6 +2571,14 @@ module Aws::EventBridge
2531
2571
  # This is used by SaaS partners to write events to a customer's partner
2532
2572
  # event bus. Amazon Web Services customers do not use this operation.
2533
2573
  #
2574
+ # For information on calculating event batch size, see [Calculating
2575
+ # EventBridge PutEvents event entry size][1] in the *EventBridge User
2576
+ # Guide*.
2577
+ #
2578
+ #
2579
+ #
2580
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevent-size.html
2581
+ #
2534
2582
  # @option params [required, Array<Types::PutPartnerEventsRequestEntry>] :entries
2535
2583
  # The list of events to write to the event bus.
2536
2584
  #
@@ -2768,7 +2816,39 @@ module Aws::EventBridge
2768
2816
  # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html
2769
2817
  #
2770
2818
  # @option params [String] :state
2771
- # Indicates whether the rule is enabled or disabled.
2819
+ # The state of the rule.
2820
+ #
2821
+ # Valid values include:
2822
+ #
2823
+ # * `DISABLED`: The rule is disabled. EventBridge does not match any
2824
+ # events against the rule.
2825
+ #
2826
+ # * `ENABLED`: The rule is enabled. EventBridge matches events against
2827
+ # the rule, *except* for Amazon Web Services management events
2828
+ # delivered through CloudTrail.
2829
+ #
2830
+ # * `ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`: The rule is enabled
2831
+ # for all events, including Amazon Web Services management events
2832
+ # delivered through CloudTrail.
2833
+ #
2834
+ # Management events provide visibility into management operations that
2835
+ # are performed on resources in your Amazon Web Services account.
2836
+ # These are also known as control plane operations. For more
2837
+ # information, see [Logging management events][1] in the *CloudTrail
2838
+ # User Guide*, and [Filtering management events from Amazon Web
2839
+ # Services services][2] in the *Amazon EventBridge User Guide*.
2840
+ #
2841
+ # This value is only valid for rules on the [default][3] event bus or
2842
+ # [custom event buses][4]. It does not apply to [partner event
2843
+ # buses][5].
2844
+ #
2845
+ #
2846
+ #
2847
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events
2848
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-cloudtrail
2849
+ # [3]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is-how-it-works-concepts.html#eb-bus-concepts-buses
2850
+ # [4]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html
2851
+ # [5]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-saas.html
2772
2852
  #
2773
2853
  # @option params [String] :description
2774
2854
  # A description of the rule.
@@ -2800,7 +2880,7 @@ module Aws::EventBridge
2800
2880
  # name: "RuleName", # required
2801
2881
  # schedule_expression: "ScheduleExpression",
2802
2882
  # event_pattern: "EventPattern",
2803
- # state: "ENABLED", # accepts ENABLED, DISABLED
2883
+ # state: "ENABLED", # accepts ENABLED, DISABLED, ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS
2804
2884
  # description: "RuleDescription",
2805
2885
  # role_arn: "RoleArn",
2806
2886
  # tags: [
@@ -2830,75 +2910,26 @@ module Aws::EventBridge
2830
2910
  #
2831
2911
  # Targets are the resources that are invoked when a rule is triggered.
2832
2912
  #
2913
+ # The maximum number of entries per request is 10.
2914
+ #
2833
2915
  # <note markdown="1"> Each rule can have up to five (5) targets associated with it at one
2834
2916
  # time.
2835
2917
  #
2836
2918
  # </note>
2837
2919
  #
2838
- # You can configure the following as targets for Events:
2839
- #
2840
- # * [API destination][1]
2841
- #
2842
- # * [API Gateway][2]
2920
+ # For a list of services you can configure as targets for events, see
2921
+ # [EventBridge targets][1] in the *Amazon EventBridge User Guide*.
2843
2922
  #
2844
- # * Batch job queue
2845
- #
2846
- # * CloudWatch group
2847
- #
2848
- # * CodeBuild project
2849
- #
2850
- # * CodePipeline
2851
- #
2852
- # * EC2 `CreateSnapshot` API call
2853
- #
2854
- # * EC2 Image Builder
2855
- #
2856
- # * EC2 `RebootInstances` API call
2857
- #
2858
- # * EC2 `StopInstances` API call
2859
- #
2860
- # * EC2 `TerminateInstances` API call
2861
- #
2862
- # * ECS task
2863
- #
2864
- # * [Event bus in a different account or Region][3]
2865
- #
2866
- # * [Event bus in the same account and Region][4]
2867
- #
2868
- # * Firehose delivery stream
2869
- #
2870
- # * Glue workflow
2871
- #
2872
- # * [Incident Manager response plan][5]
2873
- #
2874
- # * Inspector assessment template
2875
- #
2876
- # * Kinesis stream
2877
- #
2878
- # * Lambda function
2879
- #
2880
- # * Redshift cluster
2881
- #
2882
- # * Redshift Serverless workgroup
2883
- #
2884
- # * SageMaker Pipeline
2885
- #
2886
- # * SNS topic
2887
- #
2888
- # * SQS queue
2889
- #
2890
- # * Step Functions state machine
2923
+ # Creating rules with built-in targets is supported only in the Amazon
2924
+ # Web Services Management Console. The built-in targets are:
2891
2925
  #
2892
- # * Systems Manager Automation
2926
+ # * `Amazon EBS CreateSnapshot API call`
2893
2927
  #
2894
- # * Systems Manager OpsItem
2928
+ # * `Amazon EC2 RebootInstances API call`
2895
2929
  #
2896
- # * Systems Manager Run Command
2930
+ # * `Amazon EC2 StopInstances API call`
2897
2931
  #
2898
- # Creating rules with built-in targets is supported only in the Amazon
2899
- # Web Services Management Console. The built-in targets are `EC2
2900
- # CreateSnapshot API call`, `EC2 RebootInstances API call`, `EC2
2901
- # StopInstances API call`, and `EC2 TerminateInstances API call`.
2932
+ # * `Amazon EC2 TerminateInstances API call`
2902
2933
  #
2903
2934
  # For some target types, `PutTargets` provides target-specific
2904
2935
  # parameters. If the target is a Kinesis data stream, you can optionally
@@ -2907,13 +2938,17 @@ module Aws::EventBridge
2907
2938
  # you can use the `RunCommandParameters` field.
2908
2939
  #
2909
2940
  # To be able to make API calls against the resources that you own,
2910
- # Amazon EventBridge needs the appropriate permissions. For Lambda and
2911
- # Amazon SNS resources, EventBridge relies on resource-based policies.
2912
- # For EC2 instances, Kinesis Data Streams, Step Functions state machines
2913
- # and API Gateway APIs, EventBridge relies on IAM roles that you specify
2914
- # in the `RoleARN` argument in `PutTargets`. For more information, see
2915
- # [Authentication and Access Control][6] in the *Amazon EventBridge User
2916
- # Guide*.
2941
+ # Amazon EventBridge needs the appropriate permissions:
2942
+ #
2943
+ # * For Lambda and Amazon SNS resources, EventBridge relies on
2944
+ # resource-based policies.
2945
+ #
2946
+ # * For EC2 instances, Kinesis Data Streams, Step Functions state
2947
+ # machines and API Gateway APIs, EventBridge relies on IAM roles that
2948
+ # you specify in the `RoleARN` argument in `PutTargets`.
2949
+ #
2950
+ # For more information, see [Authentication and Access Control][2] in
2951
+ # the *Amazon EventBridge User Guide*.
2917
2952
  #
2918
2953
  # If another Amazon Web Services account is in the same region and has
2919
2954
  # granted you permission (using `PutPermission`), you can send events to
@@ -2924,7 +2959,7 @@ module Aws::EventBridge
2924
2959
  # account is charged for each sent event. Each event sent to another
2925
2960
  # account is charged as a custom event. The account receiving the event
2926
2961
  # is not charged. For more information, see [Amazon EventBridge
2927
- # Pricing][7].
2962
+ # Pricing][3].
2928
2963
  #
2929
2964
  # <note markdown="1"> `Input`, `InputPath`, and `InputTransformer` are not available with
2930
2965
  # `PutTarget` if the target is an event bus of a different Amazon Web
@@ -2937,10 +2972,16 @@ module Aws::EventBridge
2937
2972
  # organization instead of directly by the account ID, then you must
2938
2973
  # specify a `RoleArn` with proper permissions in the `Target` structure.
2939
2974
  # For more information, see [Sending and Receiving Events Between Amazon
2940
- # Web Services Accounts][8] in the *Amazon EventBridge User Guide*.
2975
+ # Web Services Accounts][4] in the *Amazon EventBridge User Guide*.
2976
+ #
2977
+ # <note markdown="1"> If you have an IAM role on a cross-account event bus target, a
2978
+ # `PutTargets` call without a role on the same target (same `Id` and
2979
+ # `Arn`) will not remove the role.
2980
+ #
2981
+ # </note>
2941
2982
  #
2942
2983
  # For more information about enabling cross-account events, see
2943
- # [PutPermission][9].
2984
+ # [PutPermission][5].
2944
2985
  #
2945
2986
  # **Input**, **InputPath**, and **InputTransformer** are mutually
2946
2987
  # exclusive and optional parameters of a target. When a rule is
@@ -2977,15 +3018,11 @@ module Aws::EventBridge
2977
3018
  #
2978
3019
  #
2979
3020
  #
2980
- # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html
2981
- # [2]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-gateway-target.html
2982
- # [3]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cross-account.html
2983
- # [4]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-bus-to-bus.html
2984
- # [5]: https://docs.aws.amazon.com/incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-eventbridge
2985
- # [6]: https://docs.aws.amazon.com/eventbridge/latest/userguide/auth-and-access-control-eventbridge.html
2986
- # [7]: http://aws.amazon.com/eventbridge/pricing/
2987
- # [8]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html
2988
- # [9]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPermission.html
3021
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html
3022
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/userguide/auth-and-access-control-eventbridge.html
3023
+ # [3]: http://aws.amazon.com/eventbridge/pricing/
3024
+ # [4]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html
3025
+ # [5]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPermission.html
2989
3026
  #
2990
3027
  # @option params [required, String] :rule
2991
3028
  # The name of the rule.
@@ -3199,6 +3236,8 @@ module Aws::EventBridge
3199
3236
  # response and each entry in `FailedEntries` provides the ID of the
3200
3237
  # failed target and the error code.
3201
3238
  #
3239
+ # The maximum number of entries per request is 10.
3240
+ #
3202
3241
  # @option params [required, String] :rule
3203
3242
  # The name of the rule.
3204
3243
  #
@@ -3667,8 +3706,8 @@ module Aws::EventBridge
3667
3706
 
3668
3707
  # Update an existing endpoint. For more information about global
3669
3708
  # endpoints, see [Making applications Regional-fault tolerant with
3670
- # global endpoints and event replication][1] in the Amazon EventBridge
3671
- # User Guide..
3709
+ # global endpoints and event replication][1] in the *Amazon EventBridge
3710
+ # User Guide*.
3672
3711
  #
3673
3712
  #
3674
3713
  #
@@ -3767,7 +3806,7 @@ module Aws::EventBridge
3767
3806
  params: params,
3768
3807
  config: config)
3769
3808
  context[:gem_name] = 'aws-sdk-eventbridge'
3770
- context[:gem_version] = '1.50.0'
3809
+ context[:gem_version] = '1.52.0'
3771
3810
  Seahorse::Client::Request.new(handlers, context)
3772
3811
  end
3773
3812
 
@@ -51,7 +51,7 @@ module Aws::EventBridge
51
51
  raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
52
52
  end
53
53
  if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
54
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
54
+ if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
55
55
  if Aws::Endpoints::Matchers.string_equals?(region, "us-gov-east-1")
56
56
  return Aws::Endpoints::Endpoint.new(url: "https://events.us-gov-east-1.amazonaws.com", headers: {}, properties: {})
57
57
  end
@@ -2104,8 +2104,8 @@ module Aws::EventBridge
2104
2104
  # A global endpoint used to improve your application's availability by
2105
2105
  # making it regional-fault tolerant. For more information about global
2106
2106
  # endpoints, see [Making applications Regional-fault tolerant with
2107
- # global endpoints and event replication][1] in the Amazon EventBridge
2108
- # User Guide.
2107
+ # global endpoints and event replication][1] in the *Amazon EventBridge
2108
+ # User Guide*.
2109
2109
  #
2110
2110
  #
2111
2111
  #
@@ -3296,6 +3296,15 @@ module Aws::EventBridge
3296
3296
  #
3297
3297
  # @!attribute [rw] source
3298
3298
  # The source of the event.
3299
+ #
3300
+ # <note markdown="1"> `Detail`, `DetailType`, and `Source` are required for EventBridge to
3301
+ # successfully send an event to an event bus. If you include event
3302
+ # entries in a request that do not include each of those properties,
3303
+ # EventBridge fails that entry. If you submit a request in which
3304
+ # *none* of the entries have each of these properties, EventBridge
3305
+ # fails the entire request.
3306
+ #
3307
+ # </note>
3299
3308
  # @return [String]
3300
3309
  #
3301
3310
  # @!attribute [rw] resources
@@ -3307,11 +3316,29 @@ module Aws::EventBridge
3307
3316
  # @!attribute [rw] detail_type
3308
3317
  # Free-form string, with a maximum of 128 characters, used to decide
3309
3318
  # what fields to expect in the event detail.
3319
+ #
3320
+ # <note markdown="1"> `Detail`, `DetailType`, and `Source` are required for EventBridge to
3321
+ # successfully send an event to an event bus. If you include event
3322
+ # entries in a request that do not include each of those properties,
3323
+ # EventBridge fails that entry. If you submit a request in which
3324
+ # *none* of the entries have each of these properties, EventBridge
3325
+ # fails the entire request.
3326
+ #
3327
+ # </note>
3310
3328
  # @return [String]
3311
3329
  #
3312
3330
  # @!attribute [rw] detail
3313
3331
  # A valid JSON object. There is no other schema imposed. The JSON
3314
- # object may contain fields and nested subobjects.
3332
+ # object may contain fields and nested sub-objects.
3333
+ #
3334
+ # <note markdown="1"> `Detail`, `DetailType`, and `Source` are required for EventBridge to
3335
+ # successfully send an event to an event bus. If you include event
3336
+ # entries in a request that do not include each of those properties,
3337
+ # EventBridge fails that entry. If you submit a request in which
3338
+ # *none* of the entries have each of these properties, EventBridge
3339
+ # fails the entire request.
3340
+ #
3341
+ # </note>
3315
3342
  # @return [String]
3316
3343
  #
3317
3344
  # @!attribute [rw] event_bus_name
@@ -3319,11 +3346,12 @@ module Aws::EventBridge
3319
3346
  # rules that are associated with this event bus are used to match the
3320
3347
  # event. If you omit this, the default event bus is used.
3321
3348
  #
3322
- # <note markdown="1"> If you're using a global endpoint with a custom bus, you must enter
3323
- # the name, not the ARN, of the event bus in either the primary or
3324
- # secondary Region here and the corresponding event bus in the other
3325
- # Region will be determined based on the endpoint referenced by the
3326
- # `EndpointId`.
3349
+ # <note markdown="1"> If you're using a global endpoint with a custom bus, you can enter
3350
+ # either the name or Amazon Resource Name (ARN) of the event bus in
3351
+ # either the primary or secondary Region here. EventBridge then
3352
+ # determines the corresponding event bus in the other Region based on
3353
+ # the endpoint referenced by the `EndpointId`. Specifying the event
3354
+ # bus ARN is preferred.
3327
3355
  #
3328
3356
  # </note>
3329
3357
  # @return [String]
@@ -3377,8 +3405,14 @@ module Aws::EventBridge
3377
3405
  include Aws::Structure
3378
3406
  end
3379
3407
 
3380
- # Represents an event that failed to be submitted. For information about
3381
- # the errors that are common to all actions, see [Common Errors][1].
3408
+ # Represents the results of an event submitted to an event bus.
3409
+ #
3410
+ # If the submission was successful, the entry has the event ID in it.
3411
+ # Otherwise, you can use the error code and error message to identify
3412
+ # the problem with the entry.
3413
+ #
3414
+ # For information about the errors that are common to all actions, see
3415
+ # [Common Errors][1].
3382
3416
  #
3383
3417
  #
3384
3418
  #
@@ -3390,6 +3424,49 @@ module Aws::EventBridge
3390
3424
  #
3391
3425
  # @!attribute [rw] error_code
3392
3426
  # The error code that indicates why the event submission failed.
3427
+ #
3428
+ # Retryable errors include:
3429
+ #
3430
+ # * ` InternalFailure `
3431
+ #
3432
+ # The request processing has failed because of an unknown error,
3433
+ # exception or failure.
3434
+ #
3435
+ # * ` ThrottlingException `
3436
+ #
3437
+ # The request was denied due to request throttling.
3438
+ #
3439
+ # Non-retryable errors include:
3440
+ #
3441
+ # * ` AccessDeniedException `
3442
+ #
3443
+ # You do not have sufficient access to perform this action.
3444
+ #
3445
+ # * `InvalidAccountIdException`
3446
+ #
3447
+ # The account ID provided is not valid.
3448
+ #
3449
+ # * `InvalidArgument`
3450
+ #
3451
+ # A specified parameter is not valid.
3452
+ #
3453
+ # * `MalformedDetail`
3454
+ #
3455
+ # The JSON provided is not valid.
3456
+ #
3457
+ # * `RedactionFailure`
3458
+ #
3459
+ # Redacting the CloudTrail event failed.
3460
+ #
3461
+ # * `NotAuthorizedForSourceException`
3462
+ #
3463
+ # You do not have permissions to publish events with this source
3464
+ # onto this event bus.
3465
+ #
3466
+ # * `NotAuthorizedForDetailTypeException`
3467
+ #
3468
+ # You do not have permissions to publish events with this detail
3469
+ # type onto this event bus.
3393
3470
  # @return [String]
3394
3471
  #
3395
3472
  # @!attribute [rw] error_message
@@ -3426,6 +3503,15 @@ module Aws::EventBridge
3426
3503
  #
3427
3504
  # @!attribute [rw] source
3428
3505
  # The event source that is generating the entry.
3506
+ #
3507
+ # <note markdown="1"> `Detail`, `DetailType`, and `Source` are required for EventBridge to
3508
+ # successfully send an event to an event bus. If you include event
3509
+ # entries in a request that do not include each of those properties,
3510
+ # EventBridge fails that entry. If you submit a request in which
3511
+ # *none* of the entries have each of these properties, EventBridge
3512
+ # fails the entire request.
3513
+ #
3514
+ # </note>
3429
3515
  # @return [String]
3430
3516
  #
3431
3517
  # @!attribute [rw] resources
@@ -3437,11 +3523,29 @@ module Aws::EventBridge
3437
3523
  # @!attribute [rw] detail_type
3438
3524
  # A free-form string, with a maximum of 128 characters, used to decide
3439
3525
  # what fields to expect in the event detail.
3526
+ #
3527
+ # <note markdown="1"> `Detail`, `DetailType`, and `Source` are required for EventBridge to
3528
+ # successfully send an event to an event bus. If you include event
3529
+ # entries in a request that do not include each of those properties,
3530
+ # EventBridge fails that entry. If you submit a request in which
3531
+ # *none* of the entries have each of these properties, EventBridge
3532
+ # fails the entire request.
3533
+ #
3534
+ # </note>
3440
3535
  # @return [String]
3441
3536
  #
3442
3537
  # @!attribute [rw] detail
3443
3538
  # A valid JSON string. There is no other schema imposed. The JSON
3444
- # string may contain fields and nested subobjects.
3539
+ # string may contain fields and nested sub-objects.
3540
+ #
3541
+ # <note markdown="1"> `Detail`, `DetailType`, and `Source` are required for EventBridge to
3542
+ # successfully send an event to an event bus. If you include event
3543
+ # entries in a request that do not include each of those properties,
3544
+ # EventBridge fails that entry. If you submit a request in which
3545
+ # *none* of the entries have each of these properties, EventBridge
3546
+ # fails the entire request.
3547
+ #
3548
+ # </note>
3445
3549
  # @return [String]
3446
3550
  #
3447
3551
  # @see http://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/PutPartnerEventsRequestEntry AWS API Documentation
@@ -3462,8 +3566,13 @@ module Aws::EventBridge
3462
3566
  # @return [Integer]
3463
3567
  #
3464
3568
  # @!attribute [rw] entries
3465
- # The list of events from this operation that were successfully
3466
- # written to the partner event bus.
3569
+ # The results for each event entry the partner submitted in this
3570
+ # request. If the event was successfully submitted, the entry has the
3571
+ # event ID in it. Otherwise, you can use the error code and error
3572
+ # message to identify the problem with the entry.
3573
+ #
3574
+ # For each record, the index of the response element is the same as
3575
+ # the index in the request array.
3467
3576
  # @return [Array<Types::PutPartnerEventsResultEntry>]
3468
3577
  #
3469
3578
  # @see http://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/PutPartnerEventsResponse AWS API Documentation
@@ -3475,7 +3584,10 @@ module Aws::EventBridge
3475
3584
  include Aws::Structure
3476
3585
  end
3477
3586
 
3478
- # Represents an event that a partner tried to generate, but failed.
3587
+ # The result of an event entry the partner submitted in this request. If
3588
+ # the event was successfully submitted, the entry has the event ID in
3589
+ # it. Otherwise, you can use the error code and error message to
3590
+ # identify the problem with the entry.
3479
3591
  #
3480
3592
  # @!attribute [rw] event_id
3481
3593
  # The ID of the event.
@@ -3594,7 +3706,40 @@ module Aws::EventBridge
3594
3706
  # @return [String]
3595
3707
  #
3596
3708
  # @!attribute [rw] state
3597
- # Indicates whether the rule is enabled or disabled.
3709
+ # The state of the rule.
3710
+ #
3711
+ # Valid values include:
3712
+ #
3713
+ # * `DISABLED`: The rule is disabled. EventBridge does not match any
3714
+ # events against the rule.
3715
+ #
3716
+ # * `ENABLED`: The rule is enabled. EventBridge matches events against
3717
+ # the rule, *except* for Amazon Web Services management events
3718
+ # delivered through CloudTrail.
3719
+ #
3720
+ # * `ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`: The rule is
3721
+ # enabled for all events, including Amazon Web Services management
3722
+ # events delivered through CloudTrail.
3723
+ #
3724
+ # Management events provide visibility into management operations
3725
+ # that are performed on resources in your Amazon Web Services
3726
+ # account. These are also known as control plane operations. For
3727
+ # more information, see [Logging management events][1] in the
3728
+ # *CloudTrail User Guide*, and [Filtering management events from
3729
+ # Amazon Web Services services][2] in the *Amazon EventBridge User
3730
+ # Guide*.
3731
+ #
3732
+ # This value is only valid for rules on the [default][3] event bus
3733
+ # or [custom event buses][4]. It does not apply to [partner event
3734
+ # buses][5].
3735
+ #
3736
+ #
3737
+ #
3738
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events
3739
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-cloudtrail
3740
+ # [3]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is-how-it-works-concepts.html#eb-bus-concepts-buses
3741
+ # [4]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html
3742
+ # [5]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-saas.html
3598
3743
  # @return [String]
3599
3744
  #
3600
3745
  # @!attribute [rw] description
@@ -3715,8 +3860,8 @@ module Aws::EventBridge
3715
3860
  end
3716
3861
 
3717
3862
  # These are custom parameters to be used when the target is a Amazon
3718
- # Redshift cluster or Redshift Serverless workgroup to invoke the Amazon
3719
- # Redshift Data API ExecuteStatement based on EventBridge events.
3863
+ # Redshift cluster to invoke the Amazon Redshift Data API
3864
+ # ExecuteStatement based on EventBridge events.
3720
3865
  #
3721
3866
  # @!attribute [rw] secret_manager_arn
3722
3867
  # The name or ARN of the secret that enables access to the database.
@@ -3732,9 +3877,6 @@ module Aws::EventBridge
3732
3877
  # @!attribute [rw] db_user
3733
3878
  # The database user name. Required when authenticating using temporary
3734
3879
  # credentials.
3735
- #
3736
- # Do not provide this parameter when connecting to a Redshift
3737
- # Serverless workgroup.
3738
3880
  # @return [String]
3739
3881
  #
3740
3882
  # @!attribute [rw] sql
@@ -3752,7 +3894,11 @@ module Aws::EventBridge
3752
3894
  # @return [Boolean]
3753
3895
  #
3754
3896
  # @!attribute [rw] sqls
3755
- # A list of SQLs.
3897
+ # One or more SQL statements to run. The SQL statements are run as a
3898
+ # single transaction. They run serially in the order of the array.
3899
+ # Subsequent SQL statements don't start until the previous statement
3900
+ # in the array completes. If any SQL statement fails, then because
3901
+ # they are run as one transaction, all work is rolled back.
3756
3902
  # @return [Array<String>]
3757
3903
  #
3758
3904
  # @see http://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/RedshiftDataParameters AWS API Documentation
@@ -4035,6 +4181,39 @@ module Aws::EventBridge
4035
4181
  #
4036
4182
  # @!attribute [rw] state
4037
4183
  # The state of the rule.
4184
+ #
4185
+ # Valid values include:
4186
+ #
4187
+ # * `DISABLED`: The rule is disabled. EventBridge does not match any
4188
+ # events against the rule.
4189
+ #
4190
+ # * `ENABLED`: The rule is enabled. EventBridge matches events against
4191
+ # the rule, *except* for Amazon Web Services management events
4192
+ # delivered through CloudTrail.
4193
+ #
4194
+ # * `ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`: The rule is
4195
+ # enabled for all events, including Amazon Web Services management
4196
+ # events delivered through CloudTrail.
4197
+ #
4198
+ # Management events provide visibility into management operations
4199
+ # that are performed on resources in your Amazon Web Services
4200
+ # account. These are also known as control plane operations. For
4201
+ # more information, see [Logging management events][1] in the
4202
+ # *CloudTrail User Guide*, and [Filtering management events from
4203
+ # Amazon Web Services services][2] in the *Amazon EventBridge User
4204
+ # Guide*.
4205
+ #
4206
+ # This value is only valid for rules on the [default][3] event bus
4207
+ # or [custom event buses][4]. It does not apply to [partner event
4208
+ # buses][5].
4209
+ #
4210
+ #
4211
+ #
4212
+ # [1]: https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events
4213
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-cloudtrail
4214
+ # [3]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is-how-it-works-concepts.html#eb-bus-concepts-buses
4215
+ # [4]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html
4216
+ # [5]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-saas.html
4038
4217
  # @return [String]
4039
4218
  #
4040
4219
  # @!attribute [rw] description
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-eventbridge/customizations'
52
52
  # @!group service
53
53
  module Aws::EventBridge
54
54
 
55
- GEM_VERSION = '1.50.0'
55
+ GEM_VERSION = '1.52.0'
56
56
 
57
57
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-eventbridge
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.50.0
4
+ version: 1.52.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-09-12 00:00:00.000000000 Z
11
+ date: 2023-11-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.177.0
22
+ version: 3.184.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.177.0
32
+ version: 3.184.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement