aws-sdk 2.1618.0 → 2.1619.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.
package/README.md CHANGED
@@ -64,7 +64,7 @@ require('aws-sdk/lib/maintenance_mode_message').suppress = true;
64
64
  To use the SDK in the browser, simply add the following script tag to your
65
65
  HTML pages:
66
66
 
67
- <script src="https://sdk.amazonaws.com/js/aws-sdk-2.1618.0.min.js"></script>
67
+ <script src="https://sdk.amazonaws.com/js/aws-sdk-2.1619.0.min.js"></script>
68
68
 
69
69
  You can also build a custom browser SDK with your specified set of AWS services.
70
70
  This can allow you to reduce the SDK's size, specify different API versions of
@@ -5,6 +5,9 @@
5
5
  "endpointPrefix": "events",
6
6
  "jsonVersion": "1.1",
7
7
  "protocol": "json",
8
+ "protocols": [
9
+ "json"
10
+ ],
8
11
  "serviceFullName": "Amazon EventBridge",
9
12
  "serviceId": "EventBridge",
10
13
  "signatureVersion": "v4",
@@ -246,15 +249,25 @@
246
249
  "members": {
247
250
  "Name": {},
248
251
  "EventSourceName": {},
252
+ "Description": {},
253
+ "KmsKeyIdentifier": {},
254
+ "DeadLetterConfig": {
255
+ "shape": "S28"
256
+ },
249
257
  "Tags": {
250
- "shape": "S26"
258
+ "shape": "S2a"
251
259
  }
252
260
  }
253
261
  },
254
262
  "output": {
255
263
  "type": "structure",
256
264
  "members": {
257
- "EventBusArn": {}
265
+ "EventBusArn": {},
266
+ "Description": {},
267
+ "KmsKeyIdentifier": {},
268
+ "DeadLetterConfig": {
269
+ "shape": "S28"
270
+ }
258
271
  }
259
272
  }
260
273
  },
@@ -613,7 +626,18 @@
613
626
  "members": {
614
627
  "Name": {},
615
628
  "Arn": {},
616
- "Policy": {}
629
+ "Description": {},
630
+ "KmsKeyIdentifier": {},
631
+ "DeadLetterConfig": {
632
+ "shape": "S28"
633
+ },
634
+ "Policy": {},
635
+ "CreationTime": {
636
+ "type": "timestamp"
637
+ },
638
+ "LastModifiedTime": {
639
+ "type": "timestamp"
640
+ }
617
641
  }
618
642
  }
619
643
  },
@@ -681,7 +705,7 @@
681
705
  "StateReason": {},
682
706
  "EventSourceArn": {},
683
707
  "Destination": {
684
- "shape": "S3o"
708
+ "shape": "S3s"
685
709
  },
686
710
  "EventStartTime": {
687
711
  "type": "timestamp"
@@ -950,7 +974,14 @@
950
974
  "members": {
951
975
  "Name": {},
952
976
  "Arn": {},
953
- "Policy": {}
977
+ "Description": {},
978
+ "Policy": {},
979
+ "CreationTime": {
980
+ "type": "timestamp"
981
+ },
982
+ "LastModifiedTime": {
983
+ "type": "timestamp"
984
+ }
954
985
  }
955
986
  }
956
987
  },
@@ -1185,7 +1216,7 @@
1185
1216
  "type": "structure",
1186
1217
  "members": {
1187
1218
  "Tags": {
1188
- "shape": "S26"
1219
+ "shape": "S2a"
1189
1220
  }
1190
1221
  }
1191
1222
  }
@@ -1209,7 +1240,7 @@
1209
1240
  "type": "structure",
1210
1241
  "members": {
1211
1242
  "Targets": {
1212
- "shape": "S5h"
1243
+ "shape": "S5l"
1213
1244
  },
1214
1245
  "NextToken": {}
1215
1246
  }
@@ -1232,7 +1263,7 @@
1232
1263
  },
1233
1264
  "Source": {},
1234
1265
  "Resources": {
1235
- "shape": "S7k"
1266
+ "shape": "S7m"
1236
1267
  },
1237
1268
  "DetailType": {},
1238
1269
  "Detail": {},
@@ -1285,7 +1316,7 @@
1285
1316
  },
1286
1317
  "Source": {},
1287
1318
  "Resources": {
1288
- "shape": "S7k"
1319
+ "shape": "S7m"
1289
1320
  },
1290
1321
  "DetailType": {},
1291
1322
  "Detail": {}
@@ -1353,7 +1384,7 @@
1353
1384
  "Description": {},
1354
1385
  "RoleArn": {},
1355
1386
  "Tags": {
1356
- "shape": "S26"
1387
+ "shape": "S2a"
1357
1388
  },
1358
1389
  "EventBusName": {}
1359
1390
  }
@@ -1376,7 +1407,7 @@
1376
1407
  "Rule": {},
1377
1408
  "EventBusName": {},
1378
1409
  "Targets": {
1379
- "shape": "S5h"
1410
+ "shape": "S5l"
1380
1411
  }
1381
1412
  }
1382
1413
  },
@@ -1472,7 +1503,7 @@
1472
1503
  "type": "timestamp"
1473
1504
  },
1474
1505
  "Destination": {
1475
- "shape": "S3o"
1506
+ "shape": "S3s"
1476
1507
  }
1477
1508
  }
1478
1509
  },
@@ -1498,7 +1529,7 @@
1498
1529
  "members": {
1499
1530
  "ResourceARN": {},
1500
1531
  "Tags": {
1501
- "shape": "S26"
1532
+ "shape": "S2a"
1502
1533
  }
1503
1534
  }
1504
1535
  },
@@ -1721,6 +1752,31 @@
1721
1752
  "State": {}
1722
1753
  }
1723
1754
  }
1755
+ },
1756
+ "UpdateEventBus": {
1757
+ "input": {
1758
+ "type": "structure",
1759
+ "members": {
1760
+ "Name": {},
1761
+ "KmsKeyIdentifier": {},
1762
+ "Description": {},
1763
+ "DeadLetterConfig": {
1764
+ "shape": "S28"
1765
+ }
1766
+ }
1767
+ },
1768
+ "output": {
1769
+ "type": "structure",
1770
+ "members": {
1771
+ "Arn": {},
1772
+ "Name": {},
1773
+ "KmsKeyIdentifier": {},
1774
+ "Description": {},
1775
+ "DeadLetterConfig": {
1776
+ "shape": "S28"
1777
+ }
1778
+ }
1779
+ }
1724
1780
  }
1725
1781
  },
1726
1782
  "shapes": {
@@ -1834,7 +1890,13 @@
1834
1890
  }
1835
1891
  }
1836
1892
  },
1837
- "S26": {
1893
+ "S28": {
1894
+ "type": "structure",
1895
+ "members": {
1896
+ "Arn": {}
1897
+ }
1898
+ },
1899
+ "S2a": {
1838
1900
  "type": "list",
1839
1901
  "member": {
1840
1902
  "type": "structure",
@@ -1848,7 +1910,7 @@
1848
1910
  }
1849
1911
  }
1850
1912
  },
1851
- "S3o": {
1913
+ "S3s": {
1852
1914
  "type": "structure",
1853
1915
  "required": [
1854
1916
  "Arn"
@@ -1861,7 +1923,7 @@
1861
1923
  }
1862
1924
  }
1863
1925
  },
1864
- "S5h": {
1926
+ "S5l": {
1865
1927
  "type": "list",
1866
1928
  "member": {
1867
1929
  "type": "structure",
@@ -1944,10 +2006,10 @@
1944
2006
  ],
1945
2007
  "members": {
1946
2008
  "Subnets": {
1947
- "shape": "S63"
2009
+ "shape": "S67"
1948
2010
  },
1949
2011
  "SecurityGroups": {
1950
- "shape": "S63"
2012
+ "shape": "S67"
1951
2013
  },
1952
2014
  "AssignPublicIp": {}
1953
2015
  }
@@ -2003,7 +2065,7 @@
2003
2065
  "PropagateTags": {},
2004
2066
  "ReferenceId": {},
2005
2067
  "Tags": {
2006
- "shape": "S26"
2068
+ "shape": "S2a"
2007
2069
  }
2008
2070
  }
2009
2071
  },
@@ -2069,7 +2131,7 @@
2069
2131
  "Database": {},
2070
2132
  "DbUser": {},
2071
2133
  "Sql": {
2072
- "shape": "S71"
2134
+ "shape": "S75"
2073
2135
  },
2074
2136
  "StatementName": {},
2075
2137
  "WithEvent": {
@@ -2078,7 +2140,7 @@
2078
2140
  "Sqls": {
2079
2141
  "type": "list",
2080
2142
  "member": {
2081
- "shape": "S71"
2143
+ "shape": "S75"
2082
2144
  },
2083
2145
  "sensitive": true
2084
2146
  }
@@ -2104,10 +2166,7 @@
2104
2166
  }
2105
2167
  },
2106
2168
  "DeadLetterConfig": {
2107
- "type": "structure",
2108
- "members": {
2109
- "Arn": {}
2110
- }
2169
+ "shape": "S28"
2111
2170
  },
2112
2171
  "RetryPolicy": {
2113
2172
  "type": "structure",
@@ -2132,15 +2191,15 @@
2132
2191
  }
2133
2192
  }
2134
2193
  },
2135
- "S63": {
2194
+ "S67": {
2136
2195
  "type": "list",
2137
2196
  "member": {}
2138
2197
  },
2139
- "S71": {
2198
+ "S75": {
2140
2199
  "type": "string",
2141
2200
  "sensitive": true
2142
2201
  },
2143
- "S7k": {
2202
+ "S7m": {
2144
2203
  "type": "list",
2145
2204
  "member": {}
2146
2205
  }
@@ -36,11 +36,11 @@ declare class EventBridge extends Service {
36
36
  */
37
37
  createApiDestination(callback?: (err: AWSError, data: EventBridge.Types.CreateApiDestinationResponse) => void): Request<EventBridge.Types.CreateApiDestinationResponse, AWSError>;
38
38
  /**
39
- * Creates an archive of events with the specified settings. When you create an archive, incoming events might not immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed events. Replayed events are not sent to an archive.
39
+ * Creates an archive of events with the specified settings. When you create an archive, incoming events might not immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed events. Replayed events are not sent to an archive. Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if: You call CreateArchive on an event bus set to use a customer managed key for encryption. You call CreateDiscoverer on an event bus set to use a customer managed key for encryption. You call UpdatedEventBus to set a customer managed key on an event bus with an archives or schema discovery enabled. To enable archives or schema discovery on an event bus, choose to use an Amazon Web Services owned key. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
40
40
  */
41
41
  createArchive(params: EventBridge.Types.CreateArchiveRequest, callback?: (err: AWSError, data: EventBridge.Types.CreateArchiveResponse) => void): Request<EventBridge.Types.CreateArchiveResponse, AWSError>;
42
42
  /**
43
- * Creates an archive of events with the specified settings. When you create an archive, incoming events might not immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed events. Replayed events are not sent to an archive.
43
+ * Creates an archive of events with the specified settings. When you create an archive, incoming events might not immediately start being sent to the archive. Allow a short period of time for changes to take effect. If you do not specify a pattern to filter events sent to the archive, all events are sent to the archive except replayed events. Replayed events are not sent to an archive. Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if: You call CreateArchive on an event bus set to use a customer managed key for encryption. You call CreateDiscoverer on an event bus set to use a customer managed key for encryption. You call UpdatedEventBus to set a customer managed key on an event bus with an archives or schema discovery enabled. To enable archives or schema discovery on an event bus, choose to use an Amazon Web Services owned key. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
44
44
  */
45
45
  createArchive(callback?: (err: AWSError, data: EventBridge.Types.CreateArchiveResponse) => void): Request<EventBridge.Types.CreateArchiveResponse, AWSError>;
46
46
  /**
@@ -116,11 +116,11 @@ declare class EventBridge extends Service {
116
116
  */
117
117
  deleteConnection(callback?: (err: AWSError, data: EventBridge.Types.DeleteConnectionResponse) => void): Request<EventBridge.Types.DeleteConnectionResponse, AWSError>;
118
118
  /**
119
- * Delete an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
119
+ * Delete an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
120
120
  */
121
121
  deleteEndpoint(params: EventBridge.Types.DeleteEndpointRequest, callback?: (err: AWSError, data: EventBridge.Types.DeleteEndpointResponse) => void): Request<EventBridge.Types.DeleteEndpointResponse, AWSError>;
122
122
  /**
123
- * Delete an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
123
+ * Delete an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
124
124
  */
125
125
  deleteEndpoint(callback?: (err: AWSError, data: EventBridge.Types.DeleteEndpointResponse) => void): Request<EventBridge.Types.DeleteEndpointResponse, AWSError>;
126
126
  /**
@@ -172,11 +172,11 @@ declare class EventBridge extends Service {
172
172
  */
173
173
  describeConnection(callback?: (err: AWSError, data: EventBridge.Types.DescribeConnectionResponse) => void): Request<EventBridge.Types.DescribeConnectionResponse, AWSError>;
174
174
  /**
175
- * Get the information about an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
175
+ * Get the information about an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
176
176
  */
177
177
  describeEndpoint(params: EventBridge.Types.DescribeEndpointRequest, callback?: (err: AWSError, data: EventBridge.Types.DescribeEndpointResponse) => void): Request<EventBridge.Types.DescribeEndpointResponse, AWSError>;
178
178
  /**
179
- * Get the information about an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
179
+ * Get the information about an existing global endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
180
180
  */
181
181
  describeEndpoint(callback?: (err: AWSError, data: EventBridge.Types.DescribeEndpointResponse) => void): Request<EventBridge.Types.DescribeEndpointResponse, AWSError>;
182
182
  /**
@@ -260,11 +260,11 @@ declare class EventBridge extends Service {
260
260
  */
261
261
  listConnections(callback?: (err: AWSError, data: EventBridge.Types.ListConnectionsResponse) => void): Request<EventBridge.Types.ListConnectionsResponse, AWSError>;
262
262
  /**
263
- * List the global endpoints associated with this account. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
263
+ * List the global endpoints associated with this account. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
264
264
  */
265
265
  listEndpoints(params: EventBridge.Types.ListEndpointsRequest, callback?: (err: AWSError, data: EventBridge.Types.ListEndpointsResponse) => void): Request<EventBridge.Types.ListEndpointsResponse, AWSError>;
266
266
  /**
267
- * List the global endpoints associated with this account. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
267
+ * List the global endpoints associated with this account. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
268
268
  */
269
269
  listEndpoints(callback?: (err: AWSError, data: EventBridge.Types.ListEndpointsResponse) => void): Request<EventBridge.Types.ListEndpointsResponse, AWSError>;
270
270
  /**
@@ -340,11 +340,11 @@ declare class EventBridge extends Service {
340
340
  */
341
341
  listTargetsByRule(callback?: (err: AWSError, data: EventBridge.Types.ListTargetsByRuleResponse) => void): Request<EventBridge.Types.ListTargetsByRuleResponse, AWSError>;
342
342
  /**
343
- * Sends custom events to Amazon EventBridge so that they can be matched to rules. The maximum size for a PutEvents event entry is 256 KB. Entry size is calculated including the event and any necessary characters and keys of the JSON representation of the event. To learn more, see Calculating PutEvents event entry size in the Amazon EventBridge User Guide PutEvents accepts the data in JSON format. For the JSON number (integer) data type, the constraints are: a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807. PutEvents will only process nested JSON up to 1100 levels deep.
343
+ * Sends custom events to Amazon EventBridge so that they can be matched to rules. The maximum size for a PutEvents event entry is 256 KB. Entry size is calculated including the event and any necessary characters and keys of the JSON representation of the event. To learn more, see Calculating PutEvents event entry size in the Amazon EventBridge User Guide PutEvents accepts the data in JSON format. For the JSON number (integer) data type, the constraints are: a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807. PutEvents will only process nested JSON up to 1100 levels deep.
344
344
  */
345
345
  putEvents(params: EventBridge.Types.PutEventsRequest, callback?: (err: AWSError, data: EventBridge.Types.PutEventsResponse) => void): Request<EventBridge.Types.PutEventsResponse, AWSError>;
346
346
  /**
347
- * Sends custom events to Amazon EventBridge so that they can be matched to rules. The maximum size for a PutEvents event entry is 256 KB. Entry size is calculated including the event and any necessary characters and keys of the JSON representation of the event. To learn more, see Calculating PutEvents event entry size in the Amazon EventBridge User Guide PutEvents accepts the data in JSON format. For the JSON number (integer) data type, the constraints are: a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807. PutEvents will only process nested JSON up to 1100 levels deep.
347
+ * Sends custom events to Amazon EventBridge so that they can be matched to rules. The maximum size for a PutEvents event entry is 256 KB. Entry size is calculated including the event and any necessary characters and keys of the JSON representation of the event. To learn more, see Calculating PutEvents event entry size in the Amazon EventBridge User Guide PutEvents accepts the data in JSON format. For the JSON number (integer) data type, the constraints are: a minimum value of -9,223,372,036,854,775,808 and a maximum value of 9,223,372,036,854,775,807. PutEvents will only process nested JSON up to 1100 levels deep.
348
348
  */
349
349
  putEvents(callback?: (err: AWSError, data: EventBridge.Types.PutEventsResponse) => void): Request<EventBridge.Types.PutEventsResponse, AWSError>;
350
350
  /**
@@ -372,11 +372,11 @@ declare class EventBridge extends Service {
372
372
  */
373
373
  putRule(callback?: (err: AWSError, data: EventBridge.Types.PutRuleResponse) => void): Request<EventBridge.Types.PutRuleResponse, AWSError>;
374
374
  /**
375
- * Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered. The maximum number of entries per request is 10. Each rule can have up to five (5) targets associated with it at one time. For a list of services you can configure as targets for events, see EventBridge targets in the Amazon EventBridge User Guide. Creating rules with built-in targets is supported only in the Amazon Web Services Management Console. The built-in targets are: Amazon EBS CreateSnapshot API call Amazon EC2 RebootInstances API call Amazon EC2 StopInstances API call Amazon EC2 TerminateInstances API call For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis data stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field. To be able to make API calls against the resources that you own, Amazon EventBridge needs the appropriate permissions: For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis Data Streams, Step Functions state machines and API Gateway APIs, EventBridge relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User Guide. If another Amazon Web Services account is in the same region and has granted you permission (using PutPermission), you can send events to that account. Set that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn value when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to another account is charged as a custom event. The account receiving the event is not charged. For more information, see Amazon EventBridge Pricing. Input, InputPath, and InputTransformer are not available with PutTarget if the target is an event bus of a different Amazon Web Services account. If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide. If you have an IAM role on a cross-account event bus target, a PutTargets call without a role on the same target (same Id and Arn) will not remove the role. For more information about enabling cross-account events, see PutPermission. Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event: If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON format (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target). If Input is specified in the form of valid JSON, then the matched event is overridden with this constant. If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed). If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target. When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation. When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Allow a short period of time for changes to take effect. This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.
375
+ * Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered. The maximum number of entries per request is 10. Each rule can have up to five (5) targets associated with it at one time. For a list of services you can configure as targets for events, see EventBridge targets in the Amazon EventBridge User Guide . Creating rules with built-in targets is supported only in the Amazon Web Services Management Console. The built-in targets are: Amazon EBS CreateSnapshot API call Amazon EC2 RebootInstances API call Amazon EC2 StopInstances API call Amazon EC2 TerminateInstances API call For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis data stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field. To be able to make API calls against the resources that you own, Amazon EventBridge needs the appropriate permissions: For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis Data Streams, Step Functions state machines and API Gateway APIs, EventBridge relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User Guide . If another Amazon Web Services account is in the same region and has granted you permission (using PutPermission), you can send events to that account. Set that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn value when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to another account is charged as a custom event. The account receiving the event is not charged. For more information, see Amazon EventBridge Pricing. Input, InputPath, and InputTransformer are not available with PutTarget if the target is an event bus of a different Amazon Web Services account. If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide. If you have an IAM role on a cross-account event bus target, a PutTargets call without a role on the same target (same Id and Arn) will not remove the role. For more information about enabling cross-account events, see PutPermission. Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event: If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON format (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target). If Input is specified in the form of valid JSON, then the matched event is overridden with this constant. If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed). If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target. When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation. When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Allow a short period of time for changes to take effect. This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.
376
376
  */
377
377
  putTargets(params: EventBridge.Types.PutTargetsRequest, callback?: (err: AWSError, data: EventBridge.Types.PutTargetsResponse) => void): Request<EventBridge.Types.PutTargetsResponse, AWSError>;
378
378
  /**
379
- * Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered. The maximum number of entries per request is 10. Each rule can have up to five (5) targets associated with it at one time. For a list of services you can configure as targets for events, see EventBridge targets in the Amazon EventBridge User Guide. Creating rules with built-in targets is supported only in the Amazon Web Services Management Console. The built-in targets are: Amazon EBS CreateSnapshot API call Amazon EC2 RebootInstances API call Amazon EC2 StopInstances API call Amazon EC2 TerminateInstances API call For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis data stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field. To be able to make API calls against the resources that you own, Amazon EventBridge needs the appropriate permissions: For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis Data Streams, Step Functions state machines and API Gateway APIs, EventBridge relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User Guide. If another Amazon Web Services account is in the same region and has granted you permission (using PutPermission), you can send events to that account. Set that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn value when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to another account is charged as a custom event. The account receiving the event is not charged. For more information, see Amazon EventBridge Pricing. Input, InputPath, and InputTransformer are not available with PutTarget if the target is an event bus of a different Amazon Web Services account. If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide. If you have an IAM role on a cross-account event bus target, a PutTargets call without a role on the same target (same Id and Arn) will not remove the role. For more information about enabling cross-account events, see PutPermission. Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event: If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON format (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target). If Input is specified in the form of valid JSON, then the matched event is overridden with this constant. If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed). If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target. When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation. When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Allow a short period of time for changes to take effect. This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.
379
+ * Adds the specified targets to the specified rule, or updates the targets if they are already associated with the rule. Targets are the resources that are invoked when a rule is triggered. The maximum number of entries per request is 10. Each rule can have up to five (5) targets associated with it at one time. For a list of services you can configure as targets for events, see EventBridge targets in the Amazon EventBridge User Guide . Creating rules with built-in targets is supported only in the Amazon Web Services Management Console. The built-in targets are: Amazon EBS CreateSnapshot API call Amazon EC2 RebootInstances API call Amazon EC2 StopInstances API call Amazon EC2 TerminateInstances API call For some target types, PutTargets provides target-specific parameters. If the target is a Kinesis data stream, you can optionally specify which shard the event goes to by using the KinesisParameters argument. To invoke a command on multiple EC2 instances with one rule, you can use the RunCommandParameters field. To be able to make API calls against the resources that you own, Amazon EventBridge needs the appropriate permissions: For Lambda and Amazon SNS resources, EventBridge relies on resource-based policies. For EC2 instances, Kinesis Data Streams, Step Functions state machines and API Gateway APIs, EventBridge relies on IAM roles that you specify in the RoleARN argument in PutTargets. For more information, see Authentication and Access Control in the Amazon EventBridge User Guide . If another Amazon Web Services account is in the same region and has granted you permission (using PutPermission), you can send events to that account. Set that account's event bus as a target of the rules in your account. To send the matched events to the other account, specify that account's event bus as the Arn value when you run PutTargets. If your account sends events to another account, your account is charged for each sent event. Each event sent to another account is charged as a custom event. The account receiving the event is not charged. For more information, see Amazon EventBridge Pricing. Input, InputPath, and InputTransformer are not available with PutTarget if the target is an event bus of a different Amazon Web Services account. If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide. If you have an IAM role on a cross-account event bus target, a PutTargets call without a role on the same target (same Id and Arn) will not remove the role. For more information about enabling cross-account events, see PutPermission. Input, InputPath, and InputTransformer are mutually exclusive and optional parameters of a target. When a rule is triggered due to a matched event: If none of the following arguments are specified for a target, then the entire event is passed to the target in JSON format (unless the target is Amazon EC2 Run Command or Amazon ECS task, in which case nothing from the event is passed to the target). If Input is specified in the form of valid JSON, then the matched event is overridden with this constant. If InputPath is specified in the form of JSONPath (for example, $.detail), then only the part of the event specified in the path is passed to the target (for example, only the detail part of the event is passed). If InputTransformer is specified, then one or more specified JSONPaths are extracted from the event and used as values in a template that you specify as the input to the target. When you specify InputPath or InputTransformer, you must use JSON dot notation, not bracket notation. When you add targets to a rule and the associated rule triggers soon after, new or updated targets might not be immediately invoked. Allow a short period of time for changes to take effect. This action can partially fail if too many requests are made at the same time. If that happens, FailedEntryCount is non-zero in the response and each entry in FailedEntries provides the ID of the failed target and the error code.
380
380
  */
381
381
  putTargets(callback?: (err: AWSError, data: EventBridge.Types.PutTargetsResponse) => void): Request<EventBridge.Types.PutTargetsResponse, AWSError>;
382
382
  /**
@@ -452,13 +452,21 @@ declare class EventBridge extends Service {
452
452
  */
453
453
  updateConnection(callback?: (err: AWSError, data: EventBridge.Types.UpdateConnectionResponse) => void): Request<EventBridge.Types.UpdateConnectionResponse, AWSError>;
454
454
  /**
455
- * Update an existing endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
455
+ * Update an existing endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
456
456
  */
457
457
  updateEndpoint(params: EventBridge.Types.UpdateEndpointRequest, callback?: (err: AWSError, data: EventBridge.Types.UpdateEndpointResponse) => void): Request<EventBridge.Types.UpdateEndpointResponse, AWSError>;
458
458
  /**
459
- * Update an existing endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide.
459
+ * Update an existing endpoint. For more information about global endpoints, see Making applications Regional-fault tolerant with global endpoints and event replication in the Amazon EventBridge User Guide .
460
460
  */
461
461
  updateEndpoint(callback?: (err: AWSError, data: EventBridge.Types.UpdateEndpointResponse) => void): Request<EventBridge.Types.UpdateEndpointResponse, AWSError>;
462
+ /**
463
+ * Updates the specified event bus.
464
+ */
465
+ updateEventBus(params: EventBridge.Types.UpdateEventBusRequest, callback?: (err: AWSError, data: EventBridge.Types.UpdateEventBusResponse) => void): Request<EventBridge.Types.UpdateEventBusResponse, AWSError>;
466
+ /**
467
+ * Updates the specified event bus.
468
+ */
469
+ updateEventBus(callback?: (err: AWSError, data: EventBridge.Types.UpdateEventBusResponse) => void): Request<EventBridge.Types.UpdateEventBusResponse, AWSError>;
462
470
  }
463
471
  declare namespace EventBridge {
464
472
  export type AccountId = string;
@@ -1067,6 +1075,15 @@ declare namespace EventBridge {
1067
1075
  * If you are creating a partner event bus, this specifies the partner event source that the new event bus will be matched with.
1068
1076
  */
1069
1077
  EventSourceName?: EventSourceName;
1078
+ /**
1079
+ * The event bus description.
1080
+ */
1081
+ Description?: EventBusDescription;
1082
+ /**
1083
+ * The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN. If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt events on the event bus. For more information, see Managing keys in the Key Management Service Developer Guide. Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if: You call CreateArchive on an event bus set to use a customer managed key for encryption. You call CreateDiscoverer on an event bus set to use a customer managed key for encryption. You call UpdatedEventBus to set a customer managed key on an event bus with an archives or schema discovery enabled. To enable archives or schema discovery on an event bus, choose to use an Amazon Web Services owned key. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
1084
+ */
1085
+ KmsKeyIdentifier?: KmsKeyIdentifier;
1086
+ DeadLetterConfig?: DeadLetterConfig;
1070
1087
  /**
1071
1088
  * Tags to associate with the event bus.
1072
1089
  */
@@ -1077,6 +1094,15 @@ declare namespace EventBridge {
1077
1094
  * The ARN of the new event bus.
1078
1095
  */
1079
1096
  EventBusArn?: String;
1097
+ /**
1098
+ * The event bus description.
1099
+ */
1100
+ Description?: EventBusDescription;
1101
+ /**
1102
+ * The identifier of the KMS customer managed key for EventBridge to use to encrypt events on this event bus, if one has been specified. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
1103
+ */
1104
+ KmsKeyIdentifier?: KmsKeyIdentifier;
1105
+ DeadLetterConfig?: DeadLetterConfig;
1080
1106
  }
1081
1107
  export interface CreatePartnerEventSourceRequest {
1082
1108
  /**
@@ -1450,10 +1476,27 @@ declare namespace EventBridge {
1450
1476
  * The Amazon Resource Name (ARN) of the account permitted to write events to the current account.
1451
1477
  */
1452
1478
  Arn?: String;
1479
+ /**
1480
+ * The event bus description.
1481
+ */
1482
+ Description?: EventBusDescription;
1483
+ /**
1484
+ * The identifier of the KMS customer managed key for EventBridge to use to encrypt events on this event bus, if one has been specified. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
1485
+ */
1486
+ KmsKeyIdentifier?: KmsKeyIdentifier;
1487
+ DeadLetterConfig?: DeadLetterConfig;
1453
1488
  /**
1454
1489
  * The policy that enables the external account to send events to your account.
1455
1490
  */
1456
1491
  Policy?: String;
1492
+ /**
1493
+ * The time the event bus was created.
1494
+ */
1495
+ CreationTime?: Timestamp;
1496
+ /**
1497
+ * The time the event bus was last modified.
1498
+ */
1499
+ LastModifiedTime?: Timestamp;
1457
1500
  }
1458
1501
  export interface DescribeEventSourceRequest {
1459
1502
  /**
@@ -1579,7 +1622,7 @@ declare namespace EventBridge {
1579
1622
  */
1580
1623
  Arn?: RuleArn;
1581
1624
  /**
1582
- * The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
1625
+ * The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide .
1583
1626
  */
1584
1627
  EventPattern?: EventPattern;
1585
1628
  /**
@@ -1769,11 +1812,24 @@ declare namespace EventBridge {
1769
1812
  * The ARN of the event bus.
1770
1813
  */
1771
1814
  Arn?: String;
1815
+ /**
1816
+ * The event bus description.
1817
+ */
1818
+ Description?: EventBusDescription;
1772
1819
  /**
1773
1820
  * The permissions policy of the event bus, describing which other Amazon Web Services accounts can write events to this event bus.
1774
1821
  */
1775
1822
  Policy?: String;
1823
+ /**
1824
+ * The time the event bus was created.
1825
+ */
1826
+ CreationTime?: Timestamp;
1827
+ /**
1828
+ * The time the event bus was last modified.
1829
+ */
1830
+ LastModifiedTime?: Timestamp;
1776
1831
  }
1832
+ export type EventBusDescription = string;
1777
1833
  export type EventBusList = EventBus[];
1778
1834
  export type EventBusName = string;
1779
1835
  export type EventBusNameOrArn = string;
@@ -1863,6 +1919,7 @@ declare namespace EventBridge {
1863
1919
  */
1864
1920
  PartitionKeyPath: TargetPartitionKeyPath;
1865
1921
  }
1922
+ export type KmsKeyIdentifier = string;
1866
1923
  export type LaunchType = "EC2"|"FARGATE"|"EXTERNAL"|string;
1867
1924
  export type LimitMax100 = number;
1868
1925
  export type LimitMin1 = number;
@@ -2444,11 +2501,11 @@ declare namespace EventBridge {
2444
2501
  */
2445
2502
  ScheduleExpression?: ScheduleExpression;
2446
2503
  /**
2447
- * The event pattern. For more information, see Amazon EventBridge event patterns in the Amazon EventBridge User Guide.
2504
+ * The event pattern. For more information, see Amazon EventBridge event patterns in the Amazon EventBridge User Guide .
2448
2505
  */
2449
2506
  EventPattern?: EventPattern;
2450
2507
  /**
2451
- * Indicates whether the rule is enabled or disabled.
2508
+ * The state of the rule. Valid values include: DISABLED: The rule is disabled. EventBridge does not match any events against the rule. ENABLED: The rule is enabled. EventBridge matches events against the rule, except for Amazon Web Services management events delivered through CloudTrail. ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS: The rule is enabled for all events, including Amazon Web Services management events delivered through CloudTrail. Management events provide visibility into management operations that are performed on resources in your Amazon Web Services account. These are also known as control plane operations. For more information, see Logging management events in the CloudTrail User Guide, and Filtering management events from Amazon Web Services services in the Amazon EventBridge User Guide . This value is only valid for rules on the default event bus or custom event buses. It does not apply to partner event buses.
2452
2509
  */
2453
2510
  State?: RuleState;
2454
2511
  /**
@@ -2698,11 +2755,11 @@ declare namespace EventBridge {
2698
2755
  */
2699
2756
  Arn?: RuleArn;
2700
2757
  /**
2701
- * The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
2758
+ * The event pattern of the rule. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide .
2702
2759
  */
2703
2760
  EventPattern?: EventPattern;
2704
2761
  /**
2705
- * The state of the rule.
2762
+ * The state of the rule. Valid values include: DISABLED: The rule is disabled. EventBridge does not match any events against the rule. ENABLED: The rule is enabled. EventBridge matches events against the rule, except for Amazon Web Services management events delivered through CloudTrail. ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS: The rule is enabled for all events, including Amazon Web Services management events delivered through CloudTrail. Management events provide visibility into management operations that are performed on resources in your Amazon Web Services account. These are also known as control plane operations. For more information, see Logging management events in the CloudTrail User Guide, and Filtering management events from Amazon Web Services services in the Amazon EventBridge User Guide . This value is only valid for rules on the default event bus or custom event buses. It does not apply to partner event buses.
2706
2763
  */
2707
2764
  State?: RuleState;
2708
2765
  /**
@@ -2941,7 +2998,7 @@ declare namespace EventBridge {
2941
2998
  export type TargetPartitionKeyPath = string;
2942
2999
  export interface TestEventPatternRequest {
2943
3000
  /**
2944
- * The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide.
3001
+ * The event pattern. For more information, see Events and Event Patterns in the Amazon EventBridge User Guide .
2945
3002
  */
2946
3003
  EventPattern: EventPattern;
2947
3004
  /**
@@ -3221,6 +3278,40 @@ declare namespace EventBridge {
3221
3278
  */
3222
3279
  State?: EndpointState;
3223
3280
  }
3281
+ export interface UpdateEventBusRequest {
3282
+ /**
3283
+ * The name of the event bus.
3284
+ */
3285
+ Name?: EventBusName;
3286
+ /**
3287
+ * The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN. If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt events on the event bus. For more information, see Managing keys in the Key Management Service Developer Guide. Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if: You call CreateArchive on an event bus set to use a customer managed key for encryption. You call CreateDiscoverer on an event bus set to use a customer managed key for encryption. You call UpdatedEventBus to set a customer managed key on an event bus with an archives or schema discovery enabled. To enable archives or schema discovery on an event bus, choose to use an Amazon Web Services owned key. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
3288
+ */
3289
+ KmsKeyIdentifier?: KmsKeyIdentifier;
3290
+ /**
3291
+ * The event bus description.
3292
+ */
3293
+ Description?: EventBusDescription;
3294
+ DeadLetterConfig?: DeadLetterConfig;
3295
+ }
3296
+ export interface UpdateEventBusResponse {
3297
+ /**
3298
+ * The event bus Amazon Resource Name (ARN).
3299
+ */
3300
+ Arn?: String;
3301
+ /**
3302
+ * The event bus name.
3303
+ */
3304
+ Name?: EventBusName;
3305
+ /**
3306
+ * The identifier of the KMS customer managed key for EventBridge to use to encrypt events on this event bus, if one has been specified. For more information, see Data encryption in EventBridge in the Amazon EventBridge User Guide.
3307
+ */
3308
+ KmsKeyIdentifier?: KmsKeyIdentifier;
3309
+ /**
3310
+ * The event bus description.
3311
+ */
3312
+ Description?: EventBusDescription;
3313
+ DeadLetterConfig?: DeadLetterConfig;
3314
+ }
3224
3315
  /**
3225
3316
  * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
3226
3317
  */