pub struct CreateBackupFluentBuilder { /* private fields */ }
Expand description
Fluent builder constructing a request to CreateBackup
.
Creates a backup of an existing Amazon FSx for Windows File Server file system, Amazon FSx for Lustre file system, Amazon FSx for NetApp ONTAP volume, or Amazon FSx for OpenZFS file system. We recommend creating regular backups so that you can restore a file system or volume from a backup if an issue arises with the original file system or volume.
For Amazon FSx for Lustre file systems, you can create a backup only for file systems that have the following configuration:
-
A Persistent deployment type
-
Are not linked to a data repository
For more information about backups, see the following:
-
For Amazon FSx for Lustre, see Working with FSx for Lustre backups.
-
For Amazon FSx for Windows, see Working with FSx for Windows backups.
-
For Amazon FSx for NetApp ONTAP, see Working with FSx for NetApp ONTAP backups.
-
For Amazon FSx for OpenZFS, see Working with FSx for OpenZFS backups.
If a backup with the specified client request token exists and the parameters match, this operation returns the description of the existing backup. If a backup with the specified client request token exists and the parameters don't match, this operation returns IncompatibleParameterError
. If a backup with the specified client request token doesn't exist, CreateBackup
does the following:
-
Creates a new Amazon FSx backup with an assigned ID, and an initial lifecycle state of
CREATING
. -
Returns the description of the backup.
By using the idempotent operation, you can retry a CreateBackup
operation without the risk of creating an extra backup. This approach can be useful when an initial call fails in a way that makes it unclear whether a backup was created. If you use the same client request token and the initial call created a backup, the operation returns a successful result because all the parameters are the same.
The CreateBackup
operation returns while the backup's lifecycle state is still CREATING
. You can check the backup creation status by calling the DescribeBackups operation, which returns the backup state along with other information.
Implementations§
source§impl CreateBackupFluentBuilder
impl CreateBackupFluentBuilder
sourcepub fn as_input(&self) -> &CreateBackupInputBuilder
pub fn as_input(&self) -> &CreateBackupInputBuilder
Access the CreateBackup as a reference.
sourcepub async fn send(
self
) -> Result<CreateBackupOutput, SdkError<CreateBackupError, HttpResponse>>
pub async fn send( self ) -> Result<CreateBackupOutput, SdkError<CreateBackupError, HttpResponse>>
Sends the request and returns the response.
If an error occurs, an SdkError
will be returned with additional details that
can be matched against.
By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.
sourcepub fn customize(
self
) -> CustomizableOperation<CreateBackupOutput, CreateBackupError, Self>
pub fn customize( self ) -> CustomizableOperation<CreateBackupOutput, CreateBackupError, Self>
Consumes this builder, creating a customizable operation that can be modified before being sent.
sourcepub fn file_system_id(self, input: impl Into<String>) -> Self
pub fn file_system_id(self, input: impl Into<String>) -> Self
The ID of the file system to back up.
sourcepub fn set_file_system_id(self, input: Option<String>) -> Self
pub fn set_file_system_id(self, input: Option<String>) -> Self
The ID of the file system to back up.
sourcepub fn get_file_system_id(&self) -> &Option<String>
pub fn get_file_system_id(&self) -> &Option<String>
The ID of the file system to back up.
sourcepub fn client_request_token(self, input: impl Into<String>) -> Self
pub fn client_request_token(self, input: impl Into<String>) -> Self
(Optional) A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent creation. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.
sourcepub fn set_client_request_token(self, input: Option<String>) -> Self
pub fn set_client_request_token(self, input: Option<String>) -> Self
(Optional) A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent creation. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.
sourcepub fn get_client_request_token(&self) -> &Option<String>
pub fn get_client_request_token(&self) -> &Option<String>
(Optional) A string of up to 63 ASCII characters that Amazon FSx uses to ensure idempotent creation. This string is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.
Appends an item to Tags
.
To override the contents of this collection use set_tags
.
(Optional) The tags to apply to the backup at backup creation. The key value of the Name
tag appears in the console as the backup name. If you have set CopyTagsToBackups
to true
, and you specify one or more tags using the CreateBackup
operation, no existing file system tags are copied from the file system to the backup.
(Optional) The tags to apply to the backup at backup creation. The key value of the Name
tag appears in the console as the backup name. If you have set CopyTagsToBackups
to true
, and you specify one or more tags using the CreateBackup
operation, no existing file system tags are copied from the file system to the backup.
(Optional) The tags to apply to the backup at backup creation. The key value of the Name
tag appears in the console as the backup name. If you have set CopyTagsToBackups
to true
, and you specify one or more tags using the CreateBackup
operation, no existing file system tags are copied from the file system to the backup.
sourcepub fn volume_id(self, input: impl Into<String>) -> Self
pub fn volume_id(self, input: impl Into<String>) -> Self
(Optional) The ID of the FSx for ONTAP volume to back up.
sourcepub fn set_volume_id(self, input: Option<String>) -> Self
pub fn set_volume_id(self, input: Option<String>) -> Self
(Optional) The ID of the FSx for ONTAP volume to back up.
sourcepub fn get_volume_id(&self) -> &Option<String>
pub fn get_volume_id(&self) -> &Option<String>
(Optional) The ID of the FSx for ONTAP volume to back up.
Trait Implementations§
source§impl Clone for CreateBackupFluentBuilder
impl Clone for CreateBackupFluentBuilder
source§fn clone(&self) -> CreateBackupFluentBuilder
fn clone(&self) -> CreateBackupFluentBuilder
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreAuto Trait Implementations§
impl Freeze for CreateBackupFluentBuilder
impl !RefUnwindSafe for CreateBackupFluentBuilder
impl Send for CreateBackupFluentBuilder
impl Sync for CreateBackupFluentBuilder
impl Unpin for CreateBackupFluentBuilder
impl !UnwindSafe for CreateBackupFluentBuilder
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more