aws-sdk-eventbridge 1.24.0 → 1.28.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: 562712dc7f840fcdff6169182f661d22d47c3db786db83500d693d9b107b0ca2
4
- data.tar.gz: dd4d9ee9fe8d47addd1ef663f04c726226754cc7753a0a91d69c5f40e338ff0c
3
+ metadata.gz: a1618a0927c207c8c6f1ef83a6cc69e78d168101b42d745a254e5fa178d556f7
4
+ data.tar.gz: 0fb7d2cb90e719fe74fa51506a4737fc19db3c6e70c849f3279dd60f32db18c3
5
5
  SHA512:
6
- metadata.gz: 6a17289de36d47e042006ce5af1cb9e2af2a8c480d2e1747858b8dd29288447f63c17951a6871f4e73575e475066809bb57d53797c6b05d8f39771b187534277
7
- data.tar.gz: 75211d6852f29584a12bdad4f4c46db0679f4f19d804a6ca59957060f711f18bdadda7436cc6dad8f1832a36d57102b63d3653219f3a8a087c22d2b82ce747a1
6
+ metadata.gz: 1e33b18d5ce2605dcac512d99e132ab45fbf7c0df7b0d14a27b896c2abd85ab43ef25107db25b7229adb1bf38d4a422169e21724dafeae4622eeb785f8a9f4a8
7
+ data.tar.gz: b13a4bce6232be62a75aa51d908b1eab0210c7f5571a569cea6648d0b2c789274520135898684f9c47a009789899992daae0b6d6dfc93495573ebbf07bd77e4f
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.28.0 (2021-08-04)
5
+ ------------------
6
+
7
+ * Feature - Documentation updates to add EC2 Image Builder as a target on PutTargets.
8
+
9
+ 1.27.0 (2021-07-30)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.26.0 (2021-07-28)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.25.0 (2021-06-23)
20
+ ------------------
21
+
22
+ * Feature - Added the following parameters to ECS targets: CapacityProviderStrategy, EnableECSManagedTags, EnableExecuteCommand, PlacementConstraints, PlacementStrategy, PropagateTags, ReferenceId, and Tags
23
+
4
24
  1.24.0 (2021-05-14)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.24.0
1
+ 1.28.0
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-eventbridge/customizations'
48
48
  # @!group service
49
49
  module Aws::EventBridge
50
50
 
51
- GEM_VERSION = '1.24.0'
51
+ GEM_VERSION = '1.28.0'
52
52
 
53
53
  end
@@ -462,7 +462,7 @@ module Aws::EventBridge
462
462
  # The name for the archive to create.
463
463
  #
464
464
  # @option params [required, String] :event_source_arn
465
- # The ARN of the event source associated with the archive.
465
+ # The ARN of the event bus that sends events to the archive.
466
466
  #
467
467
  # @option params [String] :description
468
468
  # A description for the archive.
@@ -672,43 +672,45 @@ module Aws::EventBridge
672
672
  end
673
673
 
674
674
  # Called by an SaaS partner to create a partner event source. This
675
- # operation is not used by AWS customers.
675
+ # operation is not used by Amazon Web Services customers.
676
676
  #
677
- # Each partner event source can be used by one AWS account to create a
678
- # matching partner event bus in that AWS account. A SaaS partner must
679
- # create one partner event source for each AWS account that wants to
680
- # receive those event types.
677
+ # Each partner event source can be used by one Amazon Web Services
678
+ # account to create a matching partner event bus in that Amazon Web
679
+ # Services account. A SaaS partner must create one partner event source
680
+ # for each Amazon Web Services account that wants to receive those event
681
+ # types.
681
682
  #
682
683
  # A partner event source creates events based on resources within the
683
684
  # SaaS partner's service or application.
684
685
  #
685
- # An AWS account that creates a partner event bus that matches the
686
- # partner event source can use that event bus to receive events from the
687
- # partner, and then process them using AWS Events rules and targets.
686
+ # An Amazon Web Services account that creates a partner event bus that
687
+ # matches the partner event source can use that event bus to receive
688
+ # events from the partner, and then process them using Amazon Web
689
+ # Services Events rules and targets.
688
690
  #
689
691
  # Partner event source names follow this format:
690
692
  #
691
693
  # ` partner_name/event_namespace/event_name `
692
694
  #
693
695
  # *partner\_name* is determined during partner registration and
694
- # identifies the partner to AWS customers. *event\_namespace* is
695
- # determined by the partner and is a way for the partner to categorize
696
- # their events. *event\_name* is determined by the partner, and should
697
- # uniquely identify an event-generating resource within the partner
698
- # system. The combination of *event\_namespace* and *event\_name* should
699
- # help AWS customers decide whether to create an event bus to receive
700
- # these events.
696
+ # identifies the partner to Amazon Web Services customers.
697
+ # *event\_namespace* is determined by the partner and is a way for the
698
+ # partner to categorize their events. *event\_name* is determined by the
699
+ # partner, and should uniquely identify an event-generating resource
700
+ # within the partner system. The combination of *event\_namespace* and
701
+ # *event\_name* should help Amazon Web Services customers decide whether
702
+ # to create an event bus to receive these events.
701
703
  #
702
704
  # @option params [required, String] :name
703
705
  # The name of the partner event source. This name must be unique and
704
706
  # must be in the format ` partner_name/event_namespace/event_name `. The
705
- # AWS account that wants to use this partner event source must create a
706
- # partner event bus with a name that matches the name of the partner
707
- # event source.
707
+ # Amazon Web Services account that wants to use this partner event
708
+ # source must create a partner event bus with a name that matches the
709
+ # name of the partner event source.
708
710
  #
709
711
  # @option params [required, String] :account
710
- # The AWS account ID that is permitted to create a matching partner
711
- # event bus for this partner event source.
712
+ # The Amazon Web Services account ID that is permitted to create a
713
+ # matching partner event bus for this partner event source.
712
714
  #
713
715
  # @return [Types::CreatePartnerEventSourceResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
714
716
  #
@@ -743,7 +745,11 @@ module Aws::EventBridge
743
745
  # it is deleted.
744
746
  #
745
747
  # To activate a deactivated partner event source, use
746
- # ActivateEventSource.
748
+ # [ActivateEventSource][1].
749
+ #
750
+ #
751
+ #
752
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_ActivateEventSource.html
747
753
  #
748
754
  # @option params [required, String] :name
749
755
  # The name of the partner event source to deactivate.
@@ -908,17 +914,18 @@ module Aws::EventBridge
908
914
  end
909
915
 
910
916
  # This operation is used by SaaS partners to delete a partner event
911
- # source. This operation is not used by AWS customers.
917
+ # source. This operation is not used by Amazon Web Services customers.
912
918
  #
913
919
  # When you delete an event source, the status of the corresponding
914
- # partner event bus in the AWS customer account becomes DELETED.
920
+ # partner event bus in the Amazon Web Services customer account becomes
921
+ # DELETED.
915
922
  #
916
923
  # @option params [required, String] :name
917
924
  # The name of the event source to delete.
918
925
  #
919
926
  # @option params [required, String] :account
920
- # The AWS account ID of the AWS customer that the event source was
921
- # created for.
927
+ # The Amazon Web Services account ID of the Amazon Web Services customer
928
+ # that the event source was created for.
922
929
  #
923
930
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
924
931
  #
@@ -941,16 +948,25 @@ module Aws::EventBridge
941
948
  # Deletes the specified rule.
942
949
  #
943
950
  # Before you can delete the rule, you must remove all targets, using
944
- # RemoveTargets.
951
+ # [RemoveTargets][1].
945
952
  #
946
953
  # When you delete a rule, incoming events might continue to match to the
947
954
  # deleted rule. Allow a short period of time for changes to take effect.
948
955
  #
949
- # Managed rules are rules created and managed by another AWS service on
950
- # your behalf. These rules are created by those other AWS services to
951
- # support functionality in those services. You can delete these rules
952
- # using the `Force` option, but you should do so only if you are sure
953
- # the other service is not still using that rule.
956
+ # If you call delete rule multiple times for the same rule, all calls
957
+ # will succeed. When you call delete rule for a non-existent custom
958
+ # eventbus, `ResourceNotFoundException` is returned.
959
+ #
960
+ # Managed rules are rules created and managed by another Amazon Web
961
+ # Services service on your behalf. These rules are created by those
962
+ # other Amazon Web Services services to support functionality in those
963
+ # services. You can delete these rules using the `Force` option, but you
964
+ # should do so only if you are sure the other service is not still using
965
+ # that rule.
966
+ #
967
+ #
968
+ #
969
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RemoveTargets.html
954
970
  #
955
971
  # @option params [required, String] :name
956
972
  # The name of the rule.
@@ -960,11 +976,11 @@ module Aws::EventBridge
960
976
  # this, the default event bus is used.
961
977
  #
962
978
  # @option params [Boolean] :force
963
- # If this is a managed rule, created by an AWS service on your behalf,
964
- # you must specify `Force` as `True` to delete the rule. This parameter
965
- # is ignored for rules that are not managed rules. You can check whether
966
- # a rule is a managed rule by using `DescribeRule` or `ListRules` and
967
- # checking the `ManagedBy` field of the response.
979
+ # If this is a managed rule, created by an Amazon Web Services service
980
+ # on your behalf, you must specify `Force` as `True` to delete the rule.
981
+ # This parameter is ignored for rules that are not managed rules. You
982
+ # can check whether a rule is a managed rule by using `DescribeRule` or
983
+ # `ListRules` and checking the `ManagedBy` field of the response.
968
984
  #
969
985
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
970
986
  #
@@ -1156,15 +1172,21 @@ module Aws::EventBridge
1156
1172
  end
1157
1173
 
1158
1174
  # Displays details about an event bus in your account. This can include
1159
- # the external AWS accounts that are permitted to write events to your
1160
- # default event bus, and the associated policy. For custom event buses
1161
- # and partner event buses, it displays the name, ARN, policy, state, and
1162
- # creation time.
1175
+ # the external Amazon Web Services accounts that are permitted to write
1176
+ # events to your default event bus, and the associated policy. For
1177
+ # custom event buses and partner event buses, it displays the name, ARN,
1178
+ # policy, state, and creation time.
1163
1179
  #
1164
1180
  # To enable your account to receive events from other accounts on its
1165
- # default event bus, use PutPermission.
1181
+ # default event bus, use [PutPermission][1].
1182
+ #
1183
+ # For more information about partner event buses, see
1184
+ # [CreateEventBus][2].
1185
+ #
1186
+ #
1166
1187
  #
1167
- # For more information about partner event buses, see CreateEventBus.
1188
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPermission.html
1189
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateEventBus.html
1168
1190
  #
1169
1191
  # @option params [String] :name
1170
1192
  # The name or ARN of the event bus to show details for. If you omit
@@ -1237,9 +1259,14 @@ module Aws::EventBridge
1237
1259
  end
1238
1260
 
1239
1261
  # An SaaS partner can use this operation to list details about a partner
1240
- # event source that they have created. AWS customers do not use this
1241
- # operation. Instead, AWS customers can use DescribeEventSource to see
1242
- # details about a partner event source that is shared with them.
1262
+ # event source that they have created. Amazon Web Services customers do
1263
+ # not use this operation. Instead, Amazon Web Services customers can use
1264
+ # [DescribeEventSource][1] to see details about a partner event source
1265
+ # that is shared with them.
1266
+ #
1267
+ #
1268
+ #
1269
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeEventSource.html
1243
1270
  #
1244
1271
  # @option params [required, String] :name
1245
1272
  # The name of the event source to display.
@@ -1333,7 +1360,11 @@ module Aws::EventBridge
1333
1360
  # Describes the specified rule.
1334
1361
  #
1335
1362
  # DescribeRule does not list the targets of a rule. To see the targets
1336
- # associated with a rule, use ListTargetsByRule.
1363
+ # associated with a rule, use [ListTargetsByRule][1].
1364
+ #
1365
+ #
1366
+ #
1367
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_ListTargetsByRule.html
1337
1368
  #
1338
1369
  # @option params [required, String] :name
1339
1370
  # The name of the rule.
@@ -1659,8 +1690,12 @@ module Aws::EventBridge
1659
1690
  end
1660
1691
 
1661
1692
  # You can use this to see all the partner event sources that have been
1662
- # shared with your AWS account. For more information about partner event
1663
- # sources, see CreateEventBus.
1693
+ # shared with your Amazon Web Services account. For more information
1694
+ # about partner event sources, see [CreateEventBus][1].
1695
+ #
1696
+ #
1697
+ #
1698
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateEventBus.html
1664
1699
  #
1665
1700
  # @option params [String] :name_prefix
1666
1701
  # Specifying this limits the results to only those partner event sources
@@ -1708,9 +1743,10 @@ module Aws::EventBridge
1708
1743
  req.send_request(options)
1709
1744
  end
1710
1745
 
1711
- # An SaaS partner can use this operation to display the AWS account ID
1712
- # that a particular partner event source name is associated with. This
1713
- # operation is not used by AWS customers.
1746
+ # An SaaS partner can use this operation to display the Amazon Web
1747
+ # Services account ID that a particular partner event source name is
1748
+ # associated with. This operation is not used by Amazon Web Services
1749
+ # customers.
1714
1750
  #
1715
1751
  # @option params [required, String] :event_source_name
1716
1752
  # The name of the partner event source to display account information
@@ -1757,8 +1793,8 @@ module Aws::EventBridge
1757
1793
  end
1758
1794
 
1759
1795
  # An SaaS partner can use this operation to list all the partner event
1760
- # source names that they have created. This operation is not used by AWS
1761
- # customers.
1796
+ # source names that they have created. This operation is not used by
1797
+ # Amazon Web Services customers.
1762
1798
  #
1763
1799
  # @option params [required, String] :name_prefix
1764
1800
  # If you specify this, the results are limited to only those partner
@@ -1814,7 +1850,7 @@ module Aws::EventBridge
1814
1850
  # The state of the replay.
1815
1851
  #
1816
1852
  # @option params [String] :event_source_arn
1817
- # The ARN of the event source associated with the replay.
1853
+ # The ARN of the archive from which the events are replayed.
1818
1854
  #
1819
1855
  # @option params [String] :next_token
1820
1856
  # The token returned by a previous call to retrieve the next set of
@@ -1912,7 +1948,11 @@ module Aws::EventBridge
1912
1948
  # or you can provide a prefix to match to the rule names.
1913
1949
  #
1914
1950
  # ListRules does not list the targets of a rule. To see the targets
1915
- # associated with a rule, use ListTargetsByRule.
1951
+ # associated with a rule, use [ListTargetsByRule][1].
1952
+ #
1953
+ #
1954
+ #
1955
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_ListTargetsByRule.html
1916
1956
  #
1917
1957
  # @option params [String] :name_prefix
1918
1958
  # The prefix matching the rule name.
@@ -2052,6 +2092,23 @@ module Aws::EventBridge
2052
2092
  # resp.targets[0].ecs_parameters.network_configuration.awsvpc_configuration.assign_public_ip #=> String, one of "ENABLED", "DISABLED"
2053
2093
  # resp.targets[0].ecs_parameters.platform_version #=> String
2054
2094
  # resp.targets[0].ecs_parameters.group #=> String
2095
+ # resp.targets[0].ecs_parameters.capacity_provider_strategy #=> Array
2096
+ # resp.targets[0].ecs_parameters.capacity_provider_strategy[0].capacity_provider #=> String
2097
+ # resp.targets[0].ecs_parameters.capacity_provider_strategy[0].weight #=> Integer
2098
+ # resp.targets[0].ecs_parameters.capacity_provider_strategy[0].base #=> Integer
2099
+ # resp.targets[0].ecs_parameters.enable_ecs_managed_tags #=> Boolean
2100
+ # resp.targets[0].ecs_parameters.enable_execute_command #=> Boolean
2101
+ # resp.targets[0].ecs_parameters.placement_constraints #=> Array
2102
+ # resp.targets[0].ecs_parameters.placement_constraints[0].type #=> String, one of "distinctInstance", "memberOf"
2103
+ # resp.targets[0].ecs_parameters.placement_constraints[0].expression #=> String
2104
+ # resp.targets[0].ecs_parameters.placement_strategy #=> Array
2105
+ # resp.targets[0].ecs_parameters.placement_strategy[0].type #=> String, one of "random", "spread", "binpack"
2106
+ # resp.targets[0].ecs_parameters.placement_strategy[0].field #=> String
2107
+ # resp.targets[0].ecs_parameters.propagate_tags #=> String, one of "TASK_DEFINITION"
2108
+ # resp.targets[0].ecs_parameters.reference_id #=> String
2109
+ # resp.targets[0].ecs_parameters.tags #=> Array
2110
+ # resp.targets[0].ecs_parameters.tags[0].key #=> String
2111
+ # resp.targets[0].ecs_parameters.tags[0].value #=> String
2055
2112
  # resp.targets[0].batch_parameters.job_definition #=> String
2056
2113
  # resp.targets[0].batch_parameters.job_name #=> String
2057
2114
  # resp.targets[0].batch_parameters.array_properties.size #=> Integer
@@ -2097,7 +2154,7 @@ module Aws::EventBridge
2097
2154
  # @return [Types::PutEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2098
2155
  #
2099
2156
  # * {Types::PutEventsResponse#failed_entry_count #failed_entry_count} => Integer
2100
- # * {Types::PutEventsResponse#entries #entries} => Array<Types::PutEventsResultEntry>
2157
+ # * {Types::PutEventsResponse#entries #data.entries} => Array<Types::PutEventsResultEntry> (This method conflicts with a method on Response, call it through the data member)
2101
2158
  #
2102
2159
  # @example Request syntax with placeholder values
2103
2160
  #
@@ -2118,10 +2175,10 @@ module Aws::EventBridge
2118
2175
  # @example Response structure
2119
2176
  #
2120
2177
  # resp.failed_entry_count #=> Integer
2121
- # resp.entries #=> Array
2122
- # resp.entries[0].event_id #=> String
2123
- # resp.entries[0].error_code #=> String
2124
- # resp.entries[0].error_message #=> String
2178
+ # resp.data.entries #=> Array
2179
+ # resp.data.entries[0].event_id #=> String
2180
+ # resp.data.entries[0].error_code #=> String
2181
+ # resp.data.entries[0].error_message #=> String
2125
2182
  #
2126
2183
  # @see http://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/PutEvents AWS API Documentation
2127
2184
  #
@@ -2133,7 +2190,7 @@ module Aws::EventBridge
2133
2190
  end
2134
2191
 
2135
2192
  # This is used by SaaS partners to write events to a customer's partner
2136
- # event bus. AWS customers do not use this operation.
2193
+ # event bus. Amazon Web Services customers do not use this operation.
2137
2194
  #
2138
2195
  # @option params [required, Array<Types::PutPartnerEventsRequestEntry>] :entries
2139
2196
  # The list of events to write to the event bus.
@@ -2141,7 +2198,7 @@ module Aws::EventBridge
2141
2198
  # @return [Types::PutPartnerEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2142
2199
  #
2143
2200
  # * {Types::PutPartnerEventsResponse#failed_entry_count #failed_entry_count} => Integer
2144
- # * {Types::PutPartnerEventsResponse#entries #entries} => Array&lt;Types::PutPartnerEventsResultEntry&gt;
2201
+ # * {Types::PutPartnerEventsResponse#entries #data.entries} => Array&lt;Types::PutPartnerEventsResultEntry&gt; (This method conflicts with a method on Response, call it through the data member)
2145
2202
  #
2146
2203
  # @example Request syntax with placeholder values
2147
2204
  #
@@ -2160,10 +2217,10 @@ module Aws::EventBridge
2160
2217
  # @example Response structure
2161
2218
  #
2162
2219
  # resp.failed_entry_count #=> Integer
2163
- # resp.entries #=> Array
2164
- # resp.entries[0].event_id #=> String
2165
- # resp.entries[0].error_code #=> String
2166
- # resp.entries[0].error_message #=> String
2220
+ # resp.data.entries #=> Array
2221
+ # resp.data.entries[0].event_id #=> String
2222
+ # resp.data.entries[0].error_code #=> String
2223
+ # resp.data.entries[0].error_message #=> String
2167
2224
  #
2168
2225
  # @see http://docs.aws.amazon.com/goto/WebAPI/eventbridge-2015-10-07/PutPartnerEvents AWS API Documentation
2169
2226
  #
@@ -2174,30 +2231,31 @@ module Aws::EventBridge
2174
2231
  req.send_request(options)
2175
2232
  end
2176
2233
 
2177
- # Running `PutPermission` permits the specified AWS account or AWS
2178
- # organization to put events to the specified *event bus*. Amazon
2179
- # EventBridge (CloudWatch Events) rules in your account are triggered by
2180
- # these events arriving to an event bus in your account.
2234
+ # Running `PutPermission` permits the specified Amazon Web Services
2235
+ # account or Amazon Web Services organization to put events to the
2236
+ # specified *event bus*. Amazon EventBridge (CloudWatch Events) rules in
2237
+ # your account are triggered by these events arriving to an event bus in
2238
+ # your account.
2181
2239
  #
2182
2240
  # For another account to send events to your account, that external
2183
2241
  # account must have an EventBridge rule with your account's event bus
2184
2242
  # as a target.
2185
2243
  #
2186
- # To enable multiple AWS accounts to put events to your event bus, run
2187
- # `PutPermission` once for each of these accounts. Or, if all the
2188
- # accounts are members of the same AWS organization, you can run
2189
- # `PutPermission` once specifying `Principal` as "*" and specifying
2190
- # the AWS organization ID in `Condition`, to grant permissions to all
2191
- # accounts in that organization.
2244
+ # To enable multiple Amazon Web Services accounts to put events to your
2245
+ # event bus, run `PutPermission` once for each of these accounts. Or, if
2246
+ # all the accounts are members of the same Amazon Web Services
2247
+ # organization, you can run `PutPermission` once specifying `Principal`
2248
+ # as "*" and specifying the Amazon Web Services organization ID in
2249
+ # `Condition`, to grant permissions to all accounts in that
2250
+ # organization.
2192
2251
  #
2193
2252
  # If you grant permissions using an organization, then accounts in that
2194
2253
  # organization must specify a `RoleArn` with proper permissions when
2195
2254
  # they use `PutTarget` to add your account's event bus as a target. For
2196
- # more information, see [Sending and Receiving Events Between AWS
2197
- # Accounts][1] in the *Amazon EventBridge User Guide*.
2255
+ # more information, see [Sending and Receiving Events Between Amazon Web
2256
+ # Services Accounts][1] in the *Amazon EventBridge User Guide*.
2198
2257
  #
2199
- # The permission policy on the default event bus cannot exceed 10 KB in
2200
- # size.
2258
+ # The permission policy on the event bus cannot exceed 10 KB in size.
2201
2259
  #
2202
2260
  #
2203
2261
  #
@@ -2209,12 +2267,11 @@ module Aws::EventBridge
2209
2267
  #
2210
2268
  # @option params [String] :action
2211
2269
  # The action that you are enabling the other account to perform.
2212
- # Currently, this must be `events:PutEvents`.
2213
2270
  #
2214
2271
  # @option params [String] :principal
2215
- # The 12-digit AWS account ID that you are permitting to put events to
2216
- # your default event bus. Specify "*" to permit any account to put
2217
- # events to your default event bus.
2272
+ # The 12-digit Amazon Web Services account ID that you are permitting to
2273
+ # put events to your default event bus. Specify "*" to permit any
2274
+ # account to put events to your default event bus.
2218
2275
  #
2219
2276
  # If you specify "*" without specifying `Condition`, avoid creating
2220
2277
  # rules that may match undesirable events. To create more secure rules,
@@ -2227,17 +2284,23 @@ module Aws::EventBridge
2227
2284
  # An identifier string for the external account that you are granting
2228
2285
  # permissions to. If you later want to revoke the permission for this
2229
2286
  # external account, specify this `StatementId` when you run
2230
- # RemovePermission.
2287
+ # [RemovePermission][1].
2288
+ #
2289
+ #
2290
+ #
2291
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RemovePermission.html
2231
2292
  #
2232
2293
  # @option params [Types::Condition] :condition
2233
2294
  # This parameter enables you to limit the permission to accounts that
2234
- # fulfill a certain condition, such as being a member of a certain AWS
2235
- # organization. For more information about AWS Organizations, see [What
2236
- # Is AWS Organizations][1] in the *AWS Organizations User Guide*.
2295
+ # fulfill a certain condition, such as being a member of a certain
2296
+ # Amazon Web Services organization. For more information about Amazon
2297
+ # Web Services Organizations, see [What Is Amazon Web Services
2298
+ # Organizations][1] in the *Amazon Web Services Organizations User
2299
+ # Guide*.
2237
2300
  #
2238
- # If you specify `Condition` with an AWS organization ID, and specify
2239
- # "*" as the value for `Principal`, you grant permission to all the
2240
- # accounts in the named organization.
2301
+ # If you specify `Condition` with an Amazon Web Services organization
2302
+ # ID, and specify "*" as the value for `Principal`, you grant
2303
+ # permission to all the accounts in the named organization.
2241
2304
  #
2242
2305
  # The `Condition` is a JSON string which must contain `Type`, `Key`, and
2243
2306
  # `Value` fields.
@@ -2279,15 +2342,15 @@ module Aws::EventBridge
2279
2342
 
2280
2343
  # Creates or updates the specified rule. Rules are enabled by default,
2281
2344
  # or based on value of the state. You can disable a rule using
2282
- # DisableRule.
2345
+ # [DisableRule][1].
2283
2346
  #
2284
2347
  # A single rule watches for events from a single event bus. Events
2285
- # generated by AWS services go to your account's default event bus.
2286
- # Events generated by SaaS partner services or applications go to the
2287
- # matching partner event bus. If you have custom applications or
2288
- # services, you can specify whether their events go to your default
2289
- # event bus or a custom event bus that you have created. For more
2290
- # information, see CreateEventBus.
2348
+ # generated by Amazon Web Services services go to your account's
2349
+ # default event bus. Events generated by SaaS partner services or
2350
+ # applications go to the matching partner event bus. If you have custom
2351
+ # applications or services, you can specify whether their events go to
2352
+ # your default event bus or a custom event bus that you have created.
2353
+ # For more information, see [CreateEventBus][2].
2291
2354
  #
2292
2355
  # If you are updating an existing rule, the rule is replaced with what
2293
2356
  # you specify in this `PutRule` command. If you omit arguments in
@@ -2314,13 +2377,13 @@ module Aws::EventBridge
2314
2377
  #
2315
2378
  # If you are updating an existing rule, any tags you specify in the
2316
2379
  # `PutRule` operation are ignored. To update the tags of an existing
2317
- # rule, use TagResource and UntagResource.
2380
+ # rule, use [TagResource][3] and [UntagResource][4].
2318
2381
  #
2319
- # Most services in AWS treat : or / as the same character in Amazon
2320
- # Resource Names (ARNs). However, EventBridge uses an exact match in
2321
- # event patterns and rules. Be sure to use the correct ARN characters
2322
- # when creating event patterns so that they match the ARN syntax in the
2323
- # event you want to match.
2382
+ # Most services in Amazon Web Services treat : or / as the same
2383
+ # character in Amazon Resource Names (ARNs). However, EventBridge uses
2384
+ # an exact match in event patterns and rules. Be sure to use the correct
2385
+ # ARN characters when creating event patterns so that they match the ARN
2386
+ # syntax in the event you want to match.
2324
2387
  #
2325
2388
  # In EventBridge, it is possible to create rules that lead to infinite
2326
2389
  # loops, where a rule is fired repeatedly. For example, a rule might
@@ -2336,11 +2399,15 @@ module Aws::EventBridge
2336
2399
  # An infinite loop can quickly cause higher than expected charges. We
2337
2400
  # recommend that you use budgeting, which alerts you when charges exceed
2338
2401
  # your specified limit. For more information, see [Managing Your Costs
2339
- # with Budgets][1].
2402
+ # with Budgets][5].
2340
2403
  #
2341
2404
  #
2342
2405
  #
2343
- # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html
2406
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DisableRule.html
2407
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateEventBus.html
2408
+ # [3]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_TagResource.html
2409
+ # [4]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UntagResource.html
2410
+ # [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/budgets-managing-costs.html
2344
2411
  #
2345
2412
  # @option params [required, String] :name
2346
2413
  # The name of the rule that you are creating or updating.
@@ -2367,6 +2434,12 @@ module Aws::EventBridge
2367
2434
  # The Amazon Resource Name (ARN) of the IAM role associated with the
2368
2435
  # rule.
2369
2436
  #
2437
+ # If you're setting an event bus in another account as the target and
2438
+ # that account granted permission to your account through an
2439
+ # organization instead of directly by the account ID, you must specify a
2440
+ # `RoleArn` with proper permissions in the `Target` structure, instead
2441
+ # of here in this parameter.
2442
+ #
2370
2443
  # @option params [Array<Types::Tag>] :tags
2371
2444
  # The list of key-value pairs to associate with the rule.
2372
2445
  #
@@ -2416,48 +2489,64 @@ module Aws::EventBridge
2416
2489
  #
2417
2490
  # You can configure the following as targets for Events:
2418
2491
  #
2419
- # * EC2 instances
2492
+ # * [API destination][1]
2420
2493
  #
2421
- # * SSM Run Command
2494
+ # * Amazon API Gateway REST API endpoints
2422
2495
  #
2423
- # * SSM Automation
2496
+ # * API Gateway
2497
+ #
2498
+ # * Batch job queue
2499
+ #
2500
+ # * CloudWatch Logs group
2501
+ #
2502
+ # * CodeBuild project
2503
+ #
2504
+ # * CodePipeline
2424
2505
  #
2425
- # * AWS Lambda functions
2506
+ # * Amazon EC2 `CreateSnapshot` API call
2426
2507
  #
2427
- # * Data streams in Amazon Kinesis Data Streams
2508
+ # * EC2 Image Builder
2428
2509
  #
2429
- # * Data delivery streams in Amazon Kinesis Data Firehose
2510
+ # * Amazon EC2 `RebootInstances` API call
2511
+ #
2512
+ # * Amazon EC2 `StopInstances` API call
2513
+ #
2514
+ # * Amazon EC2 `TerminateInstances` API call
2430
2515
  #
2431
2516
  # * Amazon ECS tasks
2432
2517
  #
2433
- # * AWS Step Functions state machines
2518
+ # * Event bus in a different Amazon Web Services account or Region.
2434
2519
  #
2435
- # * AWS Batch jobs
2520
+ # You can use an event bus in the US East (N. Virginia) us-east-1, US
2521
+ # West (Oregon) us-west-2, or Europe (Ireland) eu-west-1 Regions as a
2522
+ # target for a rule.
2436
2523
  #
2437
- # * AWS CodeBuild projects
2524
+ # * Firehose delivery stream (Kinesis Data Firehose)
2438
2525
  #
2439
- # * Pipelines in AWS CodePipeline
2526
+ # * Inspector assessment template (Amazon Inspector)
2440
2527
  #
2441
- # * Amazon Inspector assessment templates
2528
+ # * Kinesis stream (Kinesis Data Stream)
2442
2529
  #
2443
- # * Amazon SNS topics
2530
+ # * Lambda function
2444
2531
  #
2445
- # * Amazon SQS queues, including FIFO queues
2532
+ # * Redshift clusters (Data API statement execution)
2446
2533
  #
2447
- # * The default event bus of another AWS account
2534
+ # * Amazon SNS topic
2448
2535
  #
2449
- # * Amazon API Gateway REST APIs
2536
+ # * Amazon SQS queues (includes FIFO queues
2450
2537
  #
2451
- # * Redshift Clusters to invoke Data API ExecuteStatement on
2538
+ # * SSM Automation
2452
2539
  #
2453
- # * Custom/SaaS HTTPS APIs via EventBridge API Destinations
2540
+ # * SSM OpsItem
2454
2541
  #
2455
- # * Amazon SageMaker Model Building Pipelines
2542
+ # * SSM Run Command
2456
2543
  #
2457
- # Creating rules with built-in targets is supported only in the AWS
2458
- # Management Console. The built-in targets are `EC2 CreateSnapshot API
2459
- # call`, `EC2 RebootInstances API call`, `EC2 StopInstances API call`,
2460
- # and `EC2 TerminateInstances API call`.
2544
+ # * Step Functions state machines
2545
+ #
2546
+ # Creating rules with built-in targets is supported only in the Amazon
2547
+ # Web Services Management Console. The built-in targets are `EC2
2548
+ # CreateSnapshot API call`, `EC2 RebootInstances API call`, `EC2
2549
+ # StopInstances API call`, and `EC2 TerminateInstances API call`.
2461
2550
  #
2462
2551
  # For some target types, `PutTargets` provides target-specific
2463
2552
  # parameters. If the target is a Kinesis data stream, you can optionally
@@ -2466,27 +2555,28 @@ module Aws::EventBridge
2466
2555
  # you can use the `RunCommandParameters` field.
2467
2556
  #
2468
2557
  # To be able to make API calls against the resources that you own,
2469
- # Amazon EventBridge (CloudWatch Events) needs the appropriate
2470
- # permissions. For AWS Lambda and Amazon SNS resources, EventBridge
2471
- # relies on resource-based policies. For EC2 instances, Kinesis data
2472
- # streams, AWS Step Functions state machines and API Gateway REST APIs,
2473
- # EventBridge relies on IAM roles that you specify in the `RoleARN`
2474
- # argument in `PutTargets`. For more information, see [Authentication
2475
- # and Access Control][1] in the *Amazon EventBridge User Guide*.
2476
- #
2477
- # If another AWS account is in the same region and has granted you
2478
- # permission (using `PutPermission`), you can send events to that
2479
- # account. Set that account's event bus as a target of the rules in
2480
- # your account. To send the matched events to the other account, specify
2481
- # that account's event bus as the `Arn` value when you run
2558
+ # Amazon EventBridge needs the appropriate permissions. For Lambda and
2559
+ # Amazon SNS resources, EventBridge relies on resource-based policies.
2560
+ # For EC2 instances, Kinesis Data Streams, Step Functions state machines
2561
+ # and API Gateway REST APIs, EventBridge relies on IAM roles that you
2562
+ # specify in the `RoleARN` argument in `PutTargets`. For more
2563
+ # information, see [Authentication and Access Control][2] in the *Amazon
2564
+ # EventBridge User Guide*.
2565
+ #
2566
+ # If another Amazon Web Services account is in the same region and has
2567
+ # granted you permission (using `PutPermission`), you can send events to
2568
+ # that account. Set that account's event bus as a target of the rules
2569
+ # in your account. To send the matched events to the other account,
2570
+ # specify that account's event bus as the `Arn` value when you run
2482
2571
  # `PutTargets`. If your account sends events to another account, your
2483
2572
  # account is charged for each sent event. Each event sent to another
2484
2573
  # account is charged as a custom event. The account receiving the event
2485
2574
  # is not charged. For more information, see [Amazon EventBridge
2486
- # (CloudWatch Events) Pricing][2].
2575
+ # Pricing][3].
2487
2576
  #
2488
2577
  # <note markdown="1"> `Input`, `InputPath`, and `InputTransformer` are not available with
2489
- # `PutTarget` if the target is an event bus of a different AWS account.
2578
+ # `PutTarget` if the target is an event bus of a different Amazon Web
2579
+ # Services account.
2490
2580
  #
2491
2581
  # </note>
2492
2582
  #
@@ -2494,11 +2584,11 @@ module Aws::EventBridge
2494
2584
  # that account granted permission to your account through an
2495
2585
  # organization instead of directly by the account ID, then you must
2496
2586
  # specify a `RoleArn` with proper permissions in the `Target` structure.
2497
- # For more information, see [Sending and Receiving Events Between AWS
2498
- # Accounts][3] in the *Amazon EventBridge User Guide*.
2587
+ # For more information, see [Sending and Receiving Events Between Amazon
2588
+ # Web Services Accounts][4] in the *Amazon EventBridge User Guide*.
2499
2589
  #
2500
2590
  # For more information about enabling cross-account events, see
2501
- # PutPermission.
2591
+ # [PutPermission][5].
2502
2592
  #
2503
2593
  # **Input**, **InputPath**, and **InputTransformer** are mutually
2504
2594
  # exclusive and optional parameters of a target. When a rule is
@@ -2535,9 +2625,11 @@ module Aws::EventBridge
2535
2625
  #
2536
2626
  #
2537
2627
  #
2538
- # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/auth-and-access-control-eventbridge.html
2539
- # [2]: https://aws.amazon.com/eventbridge/pricing/
2540
- # [3]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html
2628
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html
2629
+ # [2]: https://docs.aws.amazon.com/eventbridge/latest/userguide/auth-and-access-control-eventbridge.html
2630
+ # [3]: http://aws.amazon.com/eventbridge/pricing/
2631
+ # [4]: https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-cross-account-event-delivery.html
2632
+ # [5]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutPermission.html
2541
2633
  #
2542
2634
  # @option params [required, String] :rule
2543
2635
  # The name of the rule.
@@ -2596,6 +2688,35 @@ module Aws::EventBridge
2596
2688
  # },
2597
2689
  # platform_version: "String",
2598
2690
  # group: "String",
2691
+ # capacity_provider_strategy: [
2692
+ # {
2693
+ # capacity_provider: "CapacityProvider", # required
2694
+ # weight: 1,
2695
+ # base: 1,
2696
+ # },
2697
+ # ],
2698
+ # enable_ecs_managed_tags: false,
2699
+ # enable_execute_command: false,
2700
+ # placement_constraints: [
2701
+ # {
2702
+ # type: "distinctInstance", # accepts distinctInstance, memberOf
2703
+ # expression: "PlacementConstraintExpression",
2704
+ # },
2705
+ # ],
2706
+ # placement_strategy: [
2707
+ # {
2708
+ # type: "random", # accepts random, spread, binpack
2709
+ # field: "PlacementStrategyField",
2710
+ # },
2711
+ # ],
2712
+ # propagate_tags: "TASK_DEFINITION", # accepts TASK_DEFINITION
2713
+ # reference_id: "ReferenceId",
2714
+ # tags: [
2715
+ # {
2716
+ # key: "TagKey", # required
2717
+ # value: "TagValue", # required
2718
+ # },
2719
+ # ],
2599
2720
  # },
2600
2721
  # batch_parameters: {
2601
2722
  # job_definition: "String", # required
@@ -2663,11 +2784,15 @@ module Aws::EventBridge
2663
2784
  req.send_request(options)
2664
2785
  end
2665
2786
 
2666
- # Revokes the permission of another AWS account to be able to put events
2667
- # to the specified event bus. Specify the account to revoke by the
2668
- # `StatementId` value that you associated with the account when you
2669
- # granted it permission with `PutPermission`. You can find the
2670
- # `StatementId` by using DescribeEventBus.
2787
+ # Revokes the permission of another Amazon Web Services account to be
2788
+ # able to put events to the specified event bus. Specify the account to
2789
+ # revoke by the `StatementId` value that you associated with the account
2790
+ # when you granted it permission with `PutPermission`. You can find the
2791
+ # `StatementId` by using [DescribeEventBus][1].
2792
+ #
2793
+ #
2794
+ #
2795
+ # [1]: https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeEventBus.html
2671
2796
  #
2672
2797
  # @option params [String] :statement_id
2673
2798
  # The statement ID corresponding to the account that is no longer
@@ -2722,11 +2847,11 @@ module Aws::EventBridge
2722
2847
  # The IDs of the targets to remove from the rule.
2723
2848
  #
2724
2849
  # @option params [Boolean] :force
2725
- # If this is a managed rule, created by an AWS service on your behalf,
2726
- # you must specify `Force` as `True` to remove targets. This parameter
2727
- # is ignored for rules that are not managed rules. You can check whether
2728
- # a rule is a managed rule by using `DescribeRule` or `ListRules` and
2729
- # checking the `ManagedBy` field of the response.
2850
+ # If this is a managed rule, created by an Amazon Web Services service
2851
+ # on your behalf, you must specify `Force` as `True` to remove targets.
2852
+ # This parameter is ignored for rules that are not managed rules. You
2853
+ # can check whether a rule is a managed rule by using `DescribeRule` or
2854
+ # `ListRules` and checking the `ManagedBy` field of the response.
2730
2855
  #
2731
2856
  # @return [Types::RemoveTargetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2732
2857
  #
@@ -2834,8 +2959,8 @@ module Aws::EventBridge
2834
2959
  # a user permission to access or change only resources with certain tag
2835
2960
  # values. In EventBridge, rules and event buses can be tagged.
2836
2961
  #
2837
- # Tags don't have any semantic meaning to AWS and are interpreted
2838
- # strictly as strings of characters.
2962
+ # Tags don't have any semantic meaning to Amazon Web Services and are
2963
+ # interpreted strictly as strings of characters.
2839
2964
  #
2840
2965
  # You can use the `TagResource` action with a resource that already has
2841
2966
  # tags. If you specify a new tag key, this tag is appended to the list
@@ -2876,11 +3001,11 @@ module Aws::EventBridge
2876
3001
 
2877
3002
  # Tests whether the specified event pattern matches the provided event.
2878
3003
  #
2879
- # Most services in AWS treat : or / as the same character in Amazon
2880
- # Resource Names (ARNs). However, EventBridge uses an exact match in
2881
- # event patterns and rules. Be sure to use the correct ARN characters
2882
- # when creating event patterns so that they match the ARN syntax in the
2883
- # event you want to match.
3004
+ # Most services in Amazon Web Services treat : or / as the same
3005
+ # character in Amazon Resource Names (ARNs). However, EventBridge uses
3006
+ # an exact match in event patterns and rules. Be sure to use the correct
3007
+ # ARN characters when creating event patterns so that they match the ARN
3008
+ # syntax in the event you want to match.
2884
3009
  #
2885
3010
  # @option params [required, String] :event_pattern
2886
3011
  # The event pattern. For more information, see [Events and Event
@@ -2892,8 +3017,8 @@ module Aws::EventBridge
2892
3017
  #
2893
3018
  # @option params [required, String] :event
2894
3019
  # The event, in JSON format, to test against the event pattern. The JSON
2895
- # must follow the format specified in [AWS Events][1], and the following
2896
- # fields are mandatory:
3020
+ # must follow the format specified in [Amazon Web Services Events][1],
3021
+ # and the following fields are mandatory:
2897
3022
  #
2898
3023
  # * `id`
2899
3024
  #
@@ -2938,7 +3063,7 @@ module Aws::EventBridge
2938
3063
  end
2939
3064
 
2940
3065
  # Removes one or more tags from the specified EventBridge resource. In
2941
- # Amazon EventBridge (CloudWatch Events, rules and event buses can be
3066
+ # Amazon EventBridge (CloudWatch Events), rules and event buses can be
2942
3067
  # tagged.
2943
3068
  #
2944
3069
  # @option params [required, String] :resource_arn
@@ -3190,7 +3315,7 @@ module Aws::EventBridge
3190
3315
  params: params,
3191
3316
  config: config)
3192
3317
  context[:gem_name] = 'aws-sdk-eventbridge'
3193
- context[:gem_version] = '1.24.0'
3318
+ context[:gem_version] = '1.28.0'
3194
3319
  Seahorse::Client::Request.new(handlers, context)
3195
3320
  end
3196
3321