Struct aws_sdk_keyspaces::Client

pub struct Client { /* private fields */ }

Client for Amazon Keyspaces

Client for invoking operations on Amazon Keyspaces. Each operation on Amazon Keyspaces is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Examples

Constructing a client and invoking an operation

    // create a shared configuration. This can be used & shared between multiple service clients.
    let shared_config = aws_config::load_from_env().await;
    let client = aws_sdk_keyspaces::Client::new(&shared_config);
    // invoke an operation
    /* let rsp = client
        .<operation_name>().
        .<param>("some value")
        .send().await; */

Constructing a client with custom configuration

use aws_config::retry::RetryConfig;
let shared_config = aws_config::load_from_env().await;
let config = aws_sdk_keyspaces::config::Builder::from(&shared_config)
  .retry_config(RetryConfig::disabled())
  .build();
let client = aws_sdk_keyspaces::Client::from_conf(config);

Implementations

impl Client

pub fn with_config(
    client: Client<DynConnector, DynMiddleware<DynConnector>>,
    conf: Config
) -> Self

Creates a client with the given service configuration.

pub fn conf(&self) -> &Config

Returns the client’s configuration.

impl Client

pub fn create_keyspace(&self) -> CreateKeyspace

Constructs a fluent builder for the CreateKeyspace operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace to be created.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

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

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

• On success, responds with CreateKeyspaceOutput with field(s):
  • resource_arn(Option<String>):

    The unique identifier of the keyspace in the format of an Amazon Resource Name (ARN).

• On failure, responds with SdkError<CreateKeyspaceError>

pub fn create_table(&self) -> CreateTable

Constructs a fluent builder for the CreateTable operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace that the table is going to be created in.

  • table_name(impl Into<String>) / set_table_name(Option<String>):

    The name of the table.

  • schema_definition(SchemaDefinition) / set_schema_definition(Option<SchemaDefinition>):

    The schemaDefinition consists of the following parameters.

    For each column to be created:

    • name - The name of the column.

    • type - An Amazon Keyspaces data type. For more information, see Data types in the Amazon Keyspaces Developer Guide.

    The primary key of the table consists of the following columns:

    • partitionKeys - The partition key can be a single column, or it can be a compound value composed of two or more columns. The partition key portion of the primary key is required and determines how Amazon Keyspaces stores your data.

    • name - The name of each partition key column.

    • clusteringKeys - The optional clustering column portion of your primary key determines how the data is clustered and sorted within each partition.

    • name - The name of the clustering column.

    • orderBy - Sets the ascendant (ASC) or descendant (DESC) order modifier.

    To define a column as static use staticColumns - Static columns store values that are shared by all rows in the same partition:

    • name - The name of the column.

    • type - An Amazon Keyspaces data type.

  • comment(Comment) / set_comment(Option<Comment>):

    This parameter allows to enter a description of the table.

  • capacity_specification(CapacitySpecification) / set_capacity_specification(Option<CapacitySpecification>):

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

    • throughputMode:PAY_PER_REQUEST and

    • 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.

  • encryption_specification(EncryptionSpecification) / set_encryption_specification(Option<EncryptionSpecification>):

    Specifies how the encryption key for encryption at rest is managed for the 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.

  • point_in_time_recovery(PointInTimeRecovery) / set_point_in_time_recovery(Option<PointInTimeRecovery>):

    Specifies if pointInTimeRecovery is enabled or disabled for the 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.

  • ttl(TimeToLive) / set_ttl(Option<TimeToLive>):

    Enables Time to Live custom settings for the table. The options are:

    • status:enabled

    • status:disabled

    The default is status:disabled. After ttl is enabled, you can’t disable it for the table.

    For more information, see Expiring data by using Amazon Keyspaces Time to Live (TTL) in the Amazon Keyspaces Developer Guide.

  • default_time_to_live(i32) / set_default_time_to_live(Option<i32>):

    The default Time to Live setting in seconds for the table.

    For more information, see Setting the default TTL value for a table in the Amazon Keyspaces Developer Guide.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

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

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

• On success, responds with CreateTableOutput with field(s):
  • resource_arn(Option<String>):

    The unique identifier of the table in the format of an Amazon Resource Name (ARN).

• On failure, responds with SdkError<CreateTableError>

pub fn delete_keyspace(&self) -> DeleteKeyspace

Constructs a fluent builder for the DeleteKeyspace operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace to be deleted.

• On success, responds with DeleteKeyspaceOutput
• On failure, responds with SdkError<DeleteKeyspaceError>

pub fn delete_table(&self) -> DeleteTable

Constructs a fluent builder for the DeleteTable operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace of the to be deleted table.

  • table_name(impl Into<String>) / set_table_name(Option<String>):

    The name of the table to be deleted.

• On success, responds with DeleteTableOutput
• On failure, responds with SdkError<DeleteTableError>

pub fn get_keyspace(&self) -> GetKeyspace

Constructs a fluent builder for the GetKeyspace operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace.

• On success, responds with GetKeyspaceOutput with field(s):
  • keyspace_name(Option<String>):

    The name of the keyspace.

  • resource_arn(Option<String>):

    The ARN of the keyspace.

• On failure, responds with SdkError<GetKeyspaceError>

pub fn get_table(&self) -> GetTable

Constructs a fluent builder for the GetTable operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace that the table is stored in.

  • table_name(impl Into<String>) / set_table_name(Option<String>):

    The name of the table.

• On success, responds with GetTableOutput with field(s):
  • keyspace_name(Option<String>):

    The name of the keyspace that the specified table is stored in.

  • table_name(Option<String>):

    The name of the specified table.

  • resource_arn(Option<String>):

    The Amazon Resource Name (ARN) of the specified table.

  • creation_timestamp(Option<DateTime>):

    The creation timestamp of the specified table.

  • status(Option<TableStatus>):

    The current status of the specified table.

  • schema_definition(Option<SchemaDefinition>):

    The schema definition of the specified table.

  • capacity_specification(Option<CapacitySpecificationSummary>):

    The read/write throughput capacity mode for a table. The options are:

    • throughputMode:PAY_PER_REQUEST

    • throughputMode:PROVISIONED

  • encryption_specification(Option<EncryptionSpecification>):

    The encryption settings of the specified table.

  • point_in_time_recovery(Option<PointInTimeRecoverySummary>):

    The point-in-time recovery status of the specified table.

  • ttl(Option<TimeToLive>):

    The custom Time to Live settings of the specified table.

  • default_time_to_live(Option<i32>):

    The default Time to Live settings of the specified table.

  • comment(Option<Comment>):

    The the description of the specified table.

• On failure, responds with SdkError<GetTableError>

pub fn list_keyspaces(&self) -> ListKeyspaces

Constructs a fluent builder for the ListKeyspaces operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • next_token(impl Into<String>) / set_next_token(Option<String>):

    The pagination token. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.

  • max_results(i32) / set_max_results(Option<i32>):

    The total number of keyspaces to return in the output. If the total number of keyspaces available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.

• On success, responds with ListKeyspacesOutput with field(s):
  • next_token(Option<String>):

    A token to specify where to start paginating. This is the NextToken from a previously truncated response.

  • keyspaces(Option<Vec<KeyspaceSummary>>):

    A list of keyspaces.

• On failure, responds with SdkError<ListKeyspacesError>

pub fn list_tables(&self) -> ListTables

Constructs a fluent builder for the ListTables operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • next_token(impl Into<String>) / set_next_token(Option<String>):

    The pagination token. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.

  • max_results(i32) / set_max_results(Option<i32>):

    The total number of tables to return in the output. If the total number of tables available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.

  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace.

• On success, responds with ListTablesOutput with field(s):
  • next_token(Option<String>):

    A token to specify where to start paginating. This is the NextToken from a previously truncated response.

  • tables(Option<Vec<TableSummary>>):

    A list of tables.

• On failure, responds with SdkError<ListTablesError>

pub fn list_tags_for_resource(&self) -> ListTagsForResource

Constructs a fluent builder for the ListTagsForResource operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Amazon Keyspaces resource.

  • next_token(impl Into<String>) / set_next_token(Option<String>):

    The pagination token. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.

  • max_results(i32) / set_max_results(Option<i32>):

    The total number of tags to return in the output. If the total number of tags available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.

• On success, responds with ListTagsForResourceOutput with field(s):
  • next_token(Option<String>):

    A token to specify where to start paginating. This is the NextToken from a previously truncated response.

  • tags(Option<Vec<Tag>>):

    A list of tags.

• On failure, responds with SdkError<ListTagsForResourceError>

pub fn restore_table(&self) -> RestoreTable

Constructs a fluent builder for the RestoreTable operation.

• The fluent builder is configurable:
  • source_keyspace_name(impl Into<String>) / set_source_keyspace_name(Option<String>):

    The keyspace name of the source table.

  • source_table_name(impl Into<String>) / set_source_table_name(Option<String>):

    The name of the source table.

  • target_keyspace_name(impl Into<String>) / set_target_keyspace_name(Option<String>):

    The name of the target keyspace.

  • target_table_name(impl Into<String>) / set_target_table_name(Option<String>):

    The name of the target table.

  • restore_timestamp(DateTime) / set_restore_timestamp(Option<DateTime>):

    The restore timestamp in ISO 8601 format.

  • capacity_specification_override(CapacitySpecification) / set_capacity_specification_override(Option<CapacitySpecification>):

    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.

  • encryption_specification_override(EncryptionSpecification) / set_encryption_specification_override(Option<EncryptionSpecification>):

    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.

  • point_in_time_recovery_override(PointInTimeRecovery) / set_point_in_time_recovery_override(Option<PointInTimeRecovery>):

    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.

  • tags_override(Vec<Tag>) / set_tags_override(Option<Vec<Tag>>):

    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.

• On success, responds with RestoreTableOutput with field(s):
  • restored_table_arn(Option<String>):

    The Amazon Resource Name (ARN) of the restored table.

• On failure, responds with SdkError<RestoreTableError>

pub fn tag_resource(&self) -> TagResource

Constructs a fluent builder for the TagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

    The Amazon Resource Name (ARN) of the Amazon Keyspaces resource to which to add tags.

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    The tags to be assigned to the Amazon Keyspaces resource.

• On success, responds with TagResourceOutput
• On failure, responds with SdkError<TagResourceError>

pub fn untag_resource(&self) -> UntagResource

Constructs a fluent builder for the UntagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):

    The Amazon Keyspaces resource that the tags will be removed from. This value is an Amazon Resource Name (ARN).

  • tags(Vec<Tag>) / set_tags(Option<Vec<Tag>>):

    A list of existing tags to be removed from the Amazon Keyspaces resource.

• On success, responds with UntagResourceOutput
• On failure, responds with SdkError<UntagResourceError>

pub fn update_table(&self) -> UpdateTable

Constructs a fluent builder for the UpdateTable operation.

• The fluent builder is configurable:
  • keyspace_name(impl Into<String>) / set_keyspace_name(Option<String>):

    The name of the keyspace the specified table is stored in.

  • table_name(impl Into<String>) / set_table_name(Option<String>):

    The name of the table.

  • add_columns(Vec<ColumnDefinition>) / set_add_columns(Option<Vec<ColumnDefinition>>):

    For each column to be added to the specified table:

    • name - The name of the column.

    • type - An Amazon Keyspaces data type. For more information, see Data types in the Amazon Keyspaces Developer Guide.

  • capacity_specification(CapacitySpecification) / set_capacity_specification(Option<CapacitySpecification>):

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

    • throughputMode:PAY_PER_REQUEST and

    • 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.

  • encryption_specification(EncryptionSpecification) / set_encryption_specification(Option<EncryptionSpecification>):

    Modifies the encryption settings of the 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 AWS_OWNED_KMS_KEY.

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

  • point_in_time_recovery(PointInTimeRecovery) / set_point_in_time_recovery(Option<PointInTimeRecovery>):

    Modifies the pointInTimeRecovery settings of the 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.

  • ttl(TimeToLive) / set_ttl(Option<TimeToLive>):

    Modifies Time to Live custom settings for the table. The options are:

    • status:enabled

    • status:disabled

    The default is status:disabled. After ttl is enabled, you can’t disable it for the table.

    For more information, see Expiring data by using Amazon Keyspaces Time to Live (TTL) in the Amazon Keyspaces Developer Guide.

  • default_time_to_live(i32) / set_default_time_to_live(Option<i32>):

    The default Time to Live setting in seconds for the table.

    For more information, see Setting the default TTL value for a table in the Amazon Keyspaces Developer Guide.

• On success, responds with UpdateTableOutput with field(s):
  • resource_arn(Option<String>):

    The Amazon Resource Name (ARN) of the modified table.

• On failure, responds with SdkError<UpdateTableError>

impl Client

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics

• This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

• This method will panic if the conf is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the conf is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.

impl From<Client<DynConnector, DynMiddleware<DynConnector>, Standard>> for Client

fn from(client: Client<DynConnector, DynMiddleware<DynConnector>>) -> Self

Converts to this type from the input type.