Struct aws_sdk_keyspaces::client::fluent_builders::RestoreTable

pub struct RestoreTable { /* private fields */ }

Fluent builder constructing a request to RestoreTable.

Restores the specified table to the specified point in time within the earliest_restorable_timestamp and the current time. For more information about restore points, see Time window for PITR continuous backups in the Amazon Keyspaces Developer Guide.

Any number of users can execute up to 4 concurrent restores (any type of restore) in a given account.

When you restore using point in time recovery, Amazon Keyspaces restores your source table's schema and data to the state based on the selected timestamp (day:hour:minute:second) to a new table. The Time to Live (TTL) settings are also restored to the state based on the selected timestamp.

In addition to the table's schema, data, and TTL settings, RestoreTable restores the capacity mode, encryption, and point-in-time recovery settings from the source table. Unlike the table's schema data and TTL settings, which are restored based on the selected timestamp, these settings are always restored based on the table's settings as of the current time or when the table was deleted.

You can also overwrite these settings during restore:

• Read/write capacity mode

• Provisioned throughput capacity settings

• Point-in-time (PITR) settings

• Tags

For more information, see PITR restore settings in the Amazon Keyspaces Developer Guide.

Note that the following settings are not restored, and you must configure them manually for the new table:

• Automatic scaling policies (for tables that use provisioned capacity mode)

• Identity and Access Management (IAM) policies

• Amazon CloudWatch metrics and alarms

Implementations

impl RestoreTable

pub async fn send(
    self
) -> Result<RestoreTableOutput, SdkError<RestoreTableError>>

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.

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

The keyspace name of the source table.

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

The keyspace name of the source table.

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

The name of the source table.

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

The name of the source table.

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

The name of the target keyspace.

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

The name of the target keyspace.

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

The name of the target table.

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

The name of the target table.

pub fn restore_timestamp(self, input: DateTime) -> Self

The restore timestamp in ISO 8601 format.

pub fn set_restore_timestamp(self, input: Option<DateTime>) -> Self

The restore timestamp in ISO 8601 format.

pub fn capacity_specification_override(
    self,
    input: CapacitySpecification
) -> Self

Specifies the read/write throughput capacity mode for the target table. The options are:

• throughputMode:PAY_PER_REQUEST

• throughputMode:PROVISIONED - Provisioned capacity mode requires readCapacityUnits and writeCapacityUnits as input.

The default is throughput_mode:PAY_PER_REQUEST.

For more information, see Read/write capacity modes in the Amazon Keyspaces Developer Guide.

pub fn set_capacity_specification_override(
    self,
    input: Option<CapacitySpecification>
) -> Self

Specifies the read/write throughput capacity mode for the target table. The options are:

• throughputMode:PAY_PER_REQUEST

• throughputMode:PROVISIONED - Provisioned capacity mode requires readCapacityUnits and writeCapacityUnits as input.

The default is throughput_mode:PAY_PER_REQUEST.

For more information, see Read/write capacity modes in the Amazon Keyspaces Developer Guide.

pub fn encryption_specification_override(
    self,
    input: EncryptionSpecification
) -> Self

Specifies the encryption settings for the target table. You can choose one of the following KMS key (KMS key):

• type:AWS_OWNED_KMS_KEY - This key is owned by Amazon Keyspaces.

• type:CUSTOMER_MANAGED_KMS_KEY - This key is stored in your account and is created, owned, and managed by you. This option requires the kms_key_identifier of the KMS key in Amazon Resource Name (ARN) format as input.

The default is type:AWS_OWNED_KMS_KEY.

For more information, see Encryption at rest in the Amazon Keyspaces Developer Guide.

pub fn set_encryption_specification_override(
    self,
    input: Option<EncryptionSpecification>
) -> Self

Specifies the encryption settings for the target table. You can choose one of the following KMS key (KMS key):

• type:AWS_OWNED_KMS_KEY - This key is owned by Amazon Keyspaces.

• type:CUSTOMER_MANAGED_KMS_KEY - This key is stored in your account and is created, owned, and managed by you. This option requires the kms_key_identifier of the KMS key in Amazon Resource Name (ARN) format as input.

The default is type:AWS_OWNED_KMS_KEY.

For more information, see Encryption at rest in the Amazon Keyspaces Developer Guide.

pub fn point_in_time_recovery_override(self, input: PointInTimeRecovery) -> Self

Specifies the pointInTimeRecovery settings for the target table. The options are:

• ENABLED

• DISABLED

If it's not specified, the default is DISABLED.

For more information, see Point-in-time recovery in the Amazon Keyspaces Developer Guide.

pub fn set_point_in_time_recovery_override(
    self,
    input: Option<PointInTimeRecovery>
) -> Self

Specifies the pointInTimeRecovery settings for the target table. The options are:

• ENABLED

• DISABLED

If it's not specified, the default is DISABLED.

For more information, see Point-in-time recovery in the Amazon Keyspaces Developer Guide.

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

Appends an item to tagsOverride.

To override the contents of this collection use set_tags_override.

A list of key-value pair tags to be attached to the restored table.

For more information, see Adding tags and labels to Amazon Keyspaces resources in the Amazon Keyspaces Developer Guide.

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

A list of key-value pair tags to be attached to the restored table.

For more information, see Adding tags and labels to Amazon Keyspaces resources in the Amazon Keyspaces Developer Guide.

Trait Implementations

impl Clone for RestoreTable

fn clone(&self) -> RestoreTable

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RestoreTable

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

Formats the value using the given formatter.