aws-sdk-eventbridge 1.50.0 → 1.52.0

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