aws_sdk_eventbridge/client/update_archive.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3 /// Constructs a fluent builder for the [`UpdateArchive`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder) operation.
4 ///
5 /// - The fluent builder is configurable:
6 /// - [`archive_name(impl Into<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::archive_name) / [`set_archive_name(Option<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::set_archive_name):<br>required: **true**<br><p>The name of the archive to update.</p><br>
7 /// - [`description(impl Into<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::description) / [`set_description(Option<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::set_description):<br>required: **false**<br><p>The description for the archive.</p><br>
8 /// - [`event_pattern(impl Into<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::event_pattern) / [`set_event_pattern(Option<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::set_event_pattern):<br>required: **false**<br><p>The event pattern to use to filter events sent to the archive.</p><br>
9 /// - [`retention_days(i32)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::retention_days) / [`set_retention_days(Option<i32>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::set_retention_days):<br>required: **false**<br><p>The number of days to retain events in the archive.</p><br>
10 /// - [`kms_key_identifier(impl Into<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::kms_key_identifier) / [`set_kms_key_identifier(Option<String>)`](crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::set_kms_key_identifier):<br>required: **false**<br><p>The identifier of the KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt this archive. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.</p> <p>If you do not specify a customer managed key identifier, EventBridge uses an Amazon Web Services owned key to encrypt the archive.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/kms/latest/developerguide/viewing-keys.html">Identify and view keys</a> in the <i>Key Management Service Developer Guide</i>.</p><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><br>
11 /// - On success, responds with [`UpdateArchiveOutput`](crate::operation::update_archive::UpdateArchiveOutput) with field(s):
12 /// - [`archive_arn(Option<String>)`](crate::operation::update_archive::UpdateArchiveOutput::archive_arn): <p>The ARN of the archive.</p>
13 /// - [`state(Option<ArchiveState>)`](crate::operation::update_archive::UpdateArchiveOutput::state): <p>The state of the archive.</p>
14 /// - [`state_reason(Option<String>)`](crate::operation::update_archive::UpdateArchiveOutput::state_reason): <p>The reason that the archive is in the current state.</p>
15 /// - [`creation_time(Option<DateTime>)`](crate::operation::update_archive::UpdateArchiveOutput::creation_time): <p>The time at which the archive was updated.</p>
16 /// - On failure, responds with [`SdkError<UpdateArchiveError>`](crate::operation::update_archive::UpdateArchiveError)
17 pub fn update_archive(&self) -> crate::operation::update_archive::builders::UpdateArchiveFluentBuilder {
18 crate::operation::update_archive::builders::UpdateArchiveFluentBuilder::new(self.handle.clone())
19 }
20}