Struct aws_sdk_storagegateway::client::fluent_builders::CreateTapes
source · [−]pub struct CreateTapes { /* private fields */ }
Expand description
Fluent builder constructing a request to CreateTapes
.
Creates one or more virtual tapes. You write data to the virtual tapes and then archive the tapes. This operation is only supported in the tape gateway type.
Cache storage must be allocated to the gateway before you can create virtual tapes. Use the AddCache
operation to add cache storage to a gateway.
Implementations
sourceimpl CreateTapes
impl CreateTapes
sourcepub async fn send(self) -> Result<CreateTapesOutput, SdkError<CreateTapesError>>
pub async fn send(self) -> Result<CreateTapesOutput, SdkError<CreateTapesError>>
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 gateway_arn(self, input: impl Into<String>) -> Self
pub fn gateway_arn(self, input: impl Into<String>) -> Self
The unique Amazon Resource Name (ARN) that represents the gateway to associate the virtual tapes with. Use the ListGateways
operation to return a list of gateways for your account and Amazon Web Services Region.
sourcepub fn set_gateway_arn(self, input: Option<String>) -> Self
pub fn set_gateway_arn(self, input: Option<String>) -> Self
The unique Amazon Resource Name (ARN) that represents the gateway to associate the virtual tapes with. Use the ListGateways
operation to return a list of gateways for your account and Amazon Web Services Region.
sourcepub fn tape_size_in_bytes(self, input: i64) -> Self
pub fn tape_size_in_bytes(self, input: i64) -> Self
The size, in bytes, of the virtual tapes that you want to create.
The size must be aligned by gigabyte (1024*1024*1024 bytes).
sourcepub fn set_tape_size_in_bytes(self, input: Option<i64>) -> Self
pub fn set_tape_size_in_bytes(self, input: Option<i64>) -> Self
The size, in bytes, of the virtual tapes that you want to create.
The size must be aligned by gigabyte (1024*1024*1024 bytes).
sourcepub fn client_token(self, input: impl Into<String>) -> Self
pub fn client_token(self, input: impl Into<String>) -> Self
A unique identifier that you use to retry a request. If you retry a request, use the same ClientToken
you specified in the initial request.
Using the same ClientToken
prevents creating the tape multiple times.
sourcepub fn set_client_token(self, input: Option<String>) -> Self
pub fn set_client_token(self, input: Option<String>) -> Self
A unique identifier that you use to retry a request. If you retry a request, use the same ClientToken
you specified in the initial request.
Using the same ClientToken
prevents creating the tape multiple times.
sourcepub fn num_tapes_to_create(self, input: i32) -> Self
pub fn num_tapes_to_create(self, input: i32) -> Self
The number of virtual tapes that you want to create.
sourcepub fn set_num_tapes_to_create(self, input: Option<i32>) -> Self
pub fn set_num_tapes_to_create(self, input: Option<i32>) -> Self
The number of virtual tapes that you want to create.
sourcepub fn tape_barcode_prefix(self, input: impl Into<String>) -> Self
pub fn tape_barcode_prefix(self, input: impl Into<String>) -> Self
A prefix that you append to the barcode of the virtual tape you are creating. This prefix makes the barcode unique.
The prefix must be 1-4 characters in length and must be one of the uppercase letters from A to Z.
sourcepub fn set_tape_barcode_prefix(self, input: Option<String>) -> Self
pub fn set_tape_barcode_prefix(self, input: Option<String>) -> Self
A prefix that you append to the barcode of the virtual tape you are creating. This prefix makes the barcode unique.
The prefix must be 1-4 characters in length and must be one of the uppercase letters from A to Z.
sourcepub fn kms_encrypted(self, input: bool) -> Self
pub fn kms_encrypted(self, input: bool) -> Self
Set to true
to use Amazon S3 server-side encryption with your own KMS key, or false
to use a key managed by Amazon S3. Optional.
Valid Values: true
| false
sourcepub fn set_kms_encrypted(self, input: Option<bool>) -> Self
pub fn set_kms_encrypted(self, input: Option<bool>) -> Self
Set to true
to use Amazon S3 server-side encryption with your own KMS key, or false
to use a key managed by Amazon S3. Optional.
Valid Values: true
| false
sourcepub fn kms_key(self, input: impl Into<String>) -> Self
pub fn kms_key(self, input: impl Into<String>) -> Self
The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. Storage Gateway does not support asymmetric CMKs. This value can only be set when KMSEncrypted
is true
. Optional.
sourcepub fn set_kms_key(self, input: Option<String>) -> Self
pub fn set_kms_key(self, input: Option<String>) -> Self
The Amazon Resource Name (ARN) of a symmetric customer master key (CMK) used for Amazon S3 server-side encryption. Storage Gateway does not support asymmetric CMKs. This value can only be set when KMSEncrypted
is true
. Optional.
sourcepub fn pool_id(self, input: impl Into<String>) -> Self
pub fn pool_id(self, input: impl Into<String>) -> Self
The ID of the pool that you want to add your tape to for archiving. The tape in this pool is archived in the S3 storage class that is associated with the pool. When you use your backup application to eject the tape, the tape is archived directly into the storage class (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
sourcepub fn set_pool_id(self, input: Option<String>) -> Self
pub fn set_pool_id(self, input: Option<String>) -> Self
The ID of the pool that you want to add your tape to for archiving. The tape in this pool is archived in the S3 storage class that is associated with the pool. When you use your backup application to eject the tape, the tape is archived directly into the storage class (S3 Glacier or S3 Glacier Deep Archive) that corresponds to the pool.
sourcepub fn worm(self, input: bool) -> Self
pub fn worm(self, input: bool) -> Self
Set to TRUE
if the tape you are creating is to be configured as a write-once-read-many (WORM) tape.
sourcepub fn set_worm(self, input: Option<bool>) -> Self
pub fn set_worm(self, input: Option<bool>) -> Self
Set to TRUE
if the tape you are creating is to be configured as a write-once-read-many (WORM) tape.
Appends an item to Tags
.
To override the contents of this collection use set_tags
.
A list of up to 50 tags that can be assigned to a virtual tape. Each tag is a key-value pair.
Valid characters for key and value are letters, spaces, and numbers representable in UTF-8 format, and the following special characters: + - = . _ : / @. The maximum length of a tag's key is 128 characters, and the maximum length for a tag's value is 256.
A list of up to 50 tags that can be assigned to a virtual tape. Each tag is a key-value pair.
Valid characters for key and value are letters, spaces, and numbers representable in UTF-8 format, and the following special characters: + - = . _ : / @. The maximum length of a tag's key is 128 characters, and the maximum length for a tag's value is 256.
Trait Implementations
sourceimpl Clone for CreateTapes
impl Clone for CreateTapes
sourcefn clone(&self) -> CreateTapes
fn clone(&self) -> CreateTapes
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
Auto Trait Implementations
impl !RefUnwindSafe for CreateTapes
impl Send for CreateTapes
impl Sync for CreateTapes
impl Unpin for CreateTapes
impl !UnwindSafe for CreateTapes
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Instrument for T
impl<T> Instrument for T
sourcefn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
sourcefn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more
sourceimpl<T> WithSubscriber for T
impl<T> WithSubscriber for T
sourcefn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,
Attaches the provided Subscriber
to this type, returning a
WithDispatch
wrapper. Read more
sourcefn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
Attaches the current default Subscriber
to this type, returning a
WithDispatch
wrapper. Read more