Struct aws_sdk_rds::client::fluent_builders::CopyDBClusterSnapshot

source · [−]

pub struct CopyDBClusterSnapshot { /* private fields */ }

Expand description

Fluent builder constructing a request to CopyDBClusterSnapshot.

Copies a snapshot of a DB cluster.

To copy a DB cluster snapshot from a shared manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.

You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case, the Amazon Web Services Region where you call the CopyDBClusterSnapshot action is the destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another Amazon Web Services Region, you must provide the following values:

KmsKeyId - The Amazon Web Services Key Management System (Amazon Web Services KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot in the destination Amazon Web Services Region.
PreSignedUrl - A URL that contains a Signature Version 4 signed request for the CopyDBClusterSnapshot action to be called in the source Amazon Web Services Region where the DB cluster snapshot is copied from. The pre-signed URL must be a valid request for the CopyDBClusterSnapshot API action that can be executed in the source Amazon Web Services Region that contains the encrypted DB cluster snapshot to be copied.

The pre-signed URL request must contain the following parameter values:
- KmsKeyId - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of the DB cluster snapshot in the destination Amazon Web Services Region. This is the same identifier for both the CopyDBClusterSnapshot action that is called in the destination Amazon Web Services Region, and the action contained in the pre-signed URL.
- DestinationRegion - The name of the Amazon Web Services Region that the DB cluster snapshot is to be created in.
- SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example, if you are copying an encrypted DB cluster snapshot from the us-west-2 Amazon Web Services Region, then your SourceDBClusterSnapshotIdentifier looks like the following example: arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115.
To learn how to generate a Signature Version 4 signed request, see Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4) and Signature Version 4 Signing Process.

If you are using an Amazon Web Services SDK tool or the CLI, you can specify SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid request for the operation that can be executed in the source Amazon Web Services Region.
TargetDBClusterSnapshotIdentifier - The identifier for the new copy of the DB cluster snapshot in the destination Amazon Web Services Region.
SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. This identifier must be in the ARN format for the source Amazon Web Services Region and is the same value as the SourceDBClusterSnapshotIdentifier in the pre-signed URL.

To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified by TargetDBClusterSnapshotIdentifier while that DB cluster snapshot is in "copying" status.

For more information on copying encrypted Amazon Aurora DB cluster snapshots from one Amazon Web Services Region to another, see Copying a Snapshot in the Amazon Aurora User Guide.

For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.

For more information on Multi-AZ DB clusters, see Multi-AZ deployments with two readable standby DB instances in the Amazon RDS User Guide.

The Multi-AZ DB clusters feature is in preview and is subject to change.

Struct aws_sdk_rds::client::fluent_builders::CopyDBClusterSnapshot

Implementations

impl CopyDBClusterSnapshot

pub async fn send( self) -> Result<CopyDbClusterSnapshotOutput, SdkError<CopyDBClusterSnapshotError>>

pub fn source_db_cluster_snapshot_identifier( self, input: impl Into<String>) -> Self

pub fn set_source_db_cluster_snapshot_identifier( self, input: Option<String>) -> Self

pub fn target_db_cluster_snapshot_identifier( self, input: impl Into<String>) -> Self

pub fn set_target_db_cluster_snapshot_identifier( self, input: Option<String>) -> Self

pub fn kms_key_id(self, input: impl Into<String>) -> Self

pub fn set_kms_key_id(self, input: Option<String>) -> Self

pub fn pre_signed_url(self, input: impl Into<String>) -> Self

pub fn set_pre_signed_url(self, input: Option<String>) -> Self

pub fn copy_tags(self, input: bool) -> Self

pub fn set_copy_tags(self, input: Option<bool>) -> Self

pub fn tags(self, input: Tag) -> Self

pub fn set_tags(self, input: Option<Vec<Tag>>) -> Self

Trait Implementations

impl Clone for CopyDBClusterSnapshot

fn clone(&self) -> CopyDBClusterSnapshot

fn clone_from(&mut self, source: &Self)

impl Debug for CopyDBClusterSnapshot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Auto Trait Implementations

impl !RefUnwindSafe for CopyDBClusterSnapshot

impl Send for CopyDBClusterSnapshot

impl Sync for CopyDBClusterSnapshot

impl Unpin for CopyDBClusterSnapshot

impl !UnwindSafe for CopyDBClusterSnapshot

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

fn in_current_span(self) -> Instrumented<Self>

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T> ToOwned for T where T: Clone,

type Owned = T

pub fn to_owned(&self) -> T

pub fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self>

pub async fn send(
self
) -> Result<CopyDbClusterSnapshotOutput, SdkError<CopyDBClusterSnapshotError>>

pub fn source_db_cluster_snapshot_identifier(
self,
input: impl Into<String>
) -> Self

pub fn set_source_db_cluster_snapshot_identifier(
self,
input: Option<String>
) -> Self

pub fn target_db_cluster_snapshot_identifier(
self,
input: impl Into<String>
) -> Self

pub fn set_target_db_cluster_snapshot_identifier(
self,
input: Option<String>
) -> Self

impl<T> Any for T where
T: 'static + ?Sized,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<T, U> Into<U> for T where
U: From<T>,

impl<T> ToOwned for T where
T: Clone,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> where
S: Into<Dispatch>,