feat(client-eventbridge): Amazon EventBridge adds support for customer-managed keys on Archives and validations for two fields: eventSourceArn and kmsKeyIdentifier.

Author: awstools

clients/client-eventbridge/src/commands/CreateArchiveCommand.ts

@@ -33,29 +33,11 @@ export interface CreateArchiveCommandOutput extends CreateArchiveResponse, __Met
  *       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.</p>
- *          <note>
- *             <p>Archives and schema discovery are not supported for event buses encrypted using a
- *         customer managed key. EventBridge returns an error if:</p>
- *             <ul>
- *                <li>
- *                   <p>You call <code>
- *                         <a href="https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateArchive.html">CreateArchive</a>
- *                      </code> on an event bus set to use a customer managed key for encryption.</p>
- *                </li>
- *                <li>
- *                   <p>You call <code>
- *                         <a href="https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html#CreateDiscoverer">CreateDiscoverer</a>
- *                      </code> on an event bus set to use a customer managed key for encryption.</p>
- *                </li>
- *                <li>
- *                   <p>You call <code>
- *                         <a href="https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UpdatedEventBus.html">UpdatedEventBus</a>
- *                      </code> to set a customer managed key on an event bus with an archives or schema discovery enabled.</p>
- *                </li>
- *             </ul>
- *             <p>To enable archives or schema discovery on an event bus, choose to
- *         use an Amazon Web Services owned key. For more information, see <a href="https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-encryption.html">Data encryption in EventBridge</a> in the <i>Amazon EventBridge User Guide</i>.</p>
- *          </note>
+ *          <important>
+ *             <p>If you have specified that EventBridge use a customer managed key for encrypting the source event bus, we strongly recommend you also specify a
+ *         customer managed key for any archives for the event bus as well. </p>
+ *             <p>For more information, see <a href="https://docs.aws.amazon.com/eventbridge/latest/userguide/encryption-archives.html">Encrypting archives</a> in the <i>Amazon EventBridge User Guide</i>.</p>
+ *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -68,6 +50,7 @@ export interface CreateArchiveCommandOutput extends CreateArchiveResponse, __Met
  *   Description: "STRING_VALUE",
  *   EventPattern: "STRING_VALUE",
  *   RetentionDays: Number("int"),
+ *   KmsKeyIdentifier: "STRING_VALUE",
  * };
  * const command = new CreateArchiveCommand(input);
  * const response = await client.send(command);

clients/client-eventbridge/src/commands/CreateConnectionCommand.ts

@@ -138,7 +138,7 @@ export interface CreateConnectionCommandOutput extends CreateConnectionResponse,
  * @see {@link EventBridgeClientResolvedConfig | config} for EventBridgeClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  <p>You do not have the necessary permissons for this action.</p>
+ *  <p>You do not have the necessary permissions for this action.</p>
  *
  * @throws {@link InternalException} (server fault)
  *  <p>This exception occurs due to unexpected causes.</p>

clients/client-eventbridge/src/commands/DescribeArchiveCommand.ts

@@ -48,6 +48,7 @@ export interface DescribeArchiveCommandOutput extends DescribeArchiveResponse, _
  * //   EventPattern: "STRING_VALUE",
  * //   State: "ENABLED" || "DISABLED" || "CREATING" || "UPDATING" || "CREATE_FAILED" || "UPDATE_FAILED",
  * //   StateReason: "STRING_VALUE",
+ * //   KmsKeyIdentifier: "STRING_VALUE",
  * //   RetentionDays: Number("int"),
  * //   SizeBytes: Number("long"),
  * //   EventCount: Number("long"),

clients/client-eventbridge/src/commands/PutEventsCommand.ts

@@ -29,13 +29,12 @@ export interface PutEventsCommandOutput extends PutEventsResponse, __MetadataBea
 
 /**
  * <p>Sends custom events to Amazon EventBridge so that they can be matched to rules.</p>
- *          <p>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 <a href="https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevent-size.html">Calculating PutEvents event entry
+ *          <p>You can batch multiple event entries into one request for efficiency.
+ *       However, the total entry size must be less than 256KB. You can calculate the entry size before you send the events.
+ *       For more information, see <a href="https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevents.html#eb-putevent-size">Calculating PutEvents event entry
  *         size</a> in the <i>
  *                <i>Amazon EventBridge User Guide</i>
- *             </i>
- *          </p>
+ *             </i>.</p>
  *          <p>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.</p>

clients/client-eventbridge/src/commands/UpdateArchiveCommand.ts

@@ -40,6 +40,7 @@ export interface UpdateArchiveCommandOutput extends UpdateArchiveResponse, __Met
  *   Description: "STRING_VALUE",
  *   EventPattern: "STRING_VALUE",
  *   RetentionDays: Number("int"),
+ *   KmsKeyIdentifier: "STRING_VALUE",
  * };
  * const command = new UpdateArchiveCommand(input);
  * const response = await client.send(command);

clients/client-eventbridge/src/commands/UpdateConnectionCommand.ts

@@ -137,7 +137,7 @@ export interface UpdateConnectionCommandOutput extends UpdateConnectionResponse,
  * @see {@link EventBridgeClientResolvedConfig | config} for EventBridgeClient's `config` shape.
  *
  * @throws {@link AccessDeniedException} (client fault)
- *  <p>You do not have the necessary permissons for this action.</p>
+ *  <p>You do not have the necessary permissions for this action.</p>
  *
  * @throws {@link ConcurrentModificationException} (client fault)
  *  <p>There is concurrent modification on a rule, target, archive, or replay.</p>