pub struct Client { /* private fields */ }
Expand description
Client for Amazon MemoryDB
Client for invoking operations on Amazon MemoryDB. Each operation on Amazon MemoryDB is a method on this
this struct. .send()
MUST be invoked on the generated operations to dispatch the request to the service.
§Constructing a Client
A Config
is required to construct a client. For most use cases, the aws-config
crate should be used to automatically resolve this config using
aws_config::load_from_env()
, since this will resolve an SdkConfig
which can be shared
across multiple different AWS SDK clients. This config resolution process can be customized
by calling aws_config::from_env()
instead, which returns a ConfigLoader
that uses
the builder pattern to customize the default config.
In the simplest case, creating a client looks as follows:
let config = aws_config::load_from_env().await;
let client = aws_sdk_memorydb::Client::new(&config);
Occasionally, SDKs may have additional service-specific values that can be set on the Config
that
is absent from SdkConfig
, or slightly different settings for a specific client may be desired.
The Builder
struct implements From<&SdkConfig>
, so setting these specific settings can be
done as follows:
let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_memorydb::config::Builder::from(&sdk_config)
.some_service_specific_setting("value")
.build();
See the aws-config
docs and Config
for more information on customizing configuration.
Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.
§Using the Client
A client has a function for every operation that can be performed by the service.
For example, the CopySnapshot
operation has
a Client::copy_snapshot
, function which returns a builder for that operation.
The fluent builder ultimately has a send()
function that returns an async future that
returns a result, as illustrated below:
let result = client.copy_snapshot()
.source_snapshot_name("example")
.send()
.await;
The underlying HTTP requests that get made by this can be modified with the customize_operation
function on the fluent builder. See the customize
module for more
information.
Implementations§
Source§impl Client
impl Client
Sourcepub fn batch_update_cluster(&self) -> BatchUpdateClusterFluentBuilder
pub fn batch_update_cluster(&self) -> BatchUpdateClusterFluentBuilder
Constructs a fluent builder for the BatchUpdateCluster
operation.
- The fluent builder is configurable:
cluster_names(impl Into<String>)
/set_cluster_names(Option<Vec::<String>>)
:
required: trueThe cluster names to apply the updates.
service_update(ServiceUpdateRequest)
/set_service_update(Option<ServiceUpdateRequest>)
:
required: falseThe unique ID of the service update
- On success, responds with
BatchUpdateClusterOutput
with field(s):processed_clusters(Option<Vec::<Cluster>>)
:The list of clusters that have been updated.
unprocessed_clusters(Option<Vec::<UnprocessedCluster>>)
:The list of clusters where updates have not been applied.
- On failure, responds with
SdkError<BatchUpdateClusterError>
Source§impl Client
impl Client
Sourcepub fn copy_snapshot(&self) -> CopySnapshotFluentBuilder
pub fn copy_snapshot(&self) -> CopySnapshotFluentBuilder
Constructs a fluent builder for the CopySnapshot
operation.
- The fluent builder is configurable:
source_snapshot_name(impl Into<String>)
/set_source_snapshot_name(Option<String>)
:
required: trueThe name of an existing snapshot from which to make a copy.
target_snapshot_name(impl Into<String>)
/set_target_snapshot_name(Option<String>)
:
required: trueA name for the snapshot copy. MemoryDB does not permit overwriting a snapshot, therefore this name must be unique within its context - MemoryDB or an Amazon S3 bucket if exporting.
target_bucket(impl Into<String>)
/set_target_bucket(Option<String>)
:
required: falseThe Amazon S3 bucket to which the snapshot is exported. This parameter is used only when exporting a snapshot for external access. When using this parameter to export a snapshot, be sure MemoryDB has the needed permissions to this S3 bucket. For more information, see Step 2: Grant MemoryDB Access to Your Amazon S3 Bucket.
kms_key_id(impl Into<String>)
/set_kms_key_id(Option<String>)
:
required: falseThe ID of the KMS key used to encrypt the target snapshot.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
CopySnapshotOutput
with field(s):snapshot(Option<Snapshot>)
:Represents a copy of an entire cluster as of the time when the snapshot was taken.
- On failure, responds with
SdkError<CopySnapshotError>
Source§impl Client
impl Client
Sourcepub fn create_acl(&self) -> CreateACLFluentBuilder
pub fn create_acl(&self) -> CreateACLFluentBuilder
Constructs a fluent builder for the CreateACL
operation.
- The fluent builder is configurable:
acl_name(impl Into<String>)
/set_acl_name(Option<String>)
:
required: trueThe name of the Access Control List.
user_names(impl Into<String>)
/set_user_names(Option<Vec::<String>>)
:
required: falseThe list of users that belong to the Access Control List.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
CreateAclOutput
with field(s):acl(Option<Acl>)
:The newly-created Access Control List.
- On failure, responds with
SdkError<CreateACLError>
Source§impl Client
impl Client
Sourcepub fn create_cluster(&self) -> CreateClusterFluentBuilder
pub fn create_cluster(&self) -> CreateClusterFluentBuilder
Constructs a fluent builder for the CreateCluster
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the cluster. This value must be unique as it also serves as the cluster identifier.
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: trueThe compute and memory capacity of the nodes in the cluster.
multi_region_cluster_name(impl Into<String>)
/set_multi_region_cluster_name(Option<String>)
:
required: falseThe name of the multi-Region cluster to be created.
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: falseThe name of the parameter group associated with the cluster.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseAn optional description of the cluster.
num_shards(i32)
/set_num_shards(Option<i32>)
:
required: falseThe number of shards the cluster will contain. The default value is 1.
num_replicas_per_shard(i32)
/set_num_replicas_per_shard(Option<i32>)
:
required: falseThe number of replicas to apply to each shard. The default value is 1. The maximum is 5.
subnet_group_name(impl Into<String>)
/set_subnet_group_name(Option<String>)
:
required: falseThe name of the subnet group to be used for the cluster.
security_group_ids(impl Into<String>)
/set_security_group_ids(Option<Vec::<String>>)
:
required: falseA list of security group names to associate with this cluster.
maintenance_window(impl Into<String>)
/set_maintenance_window(Option<String>)
:
required: falseSpecifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.
Valid values for
ddd
are:-
sun
-
mon
-
tue
-
wed
-
thu
-
fri
-
sat
Example:
sun:23:00-mon:01:30
-
port(i32)
/set_port(Option<i32>)
:
required: falseThe port number on which each of the nodes accepts connections.
sns_topic_arn(impl Into<String>)
/set_sns_topic_arn(Option<String>)
:
required: falseThe Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.
tls_enabled(bool)
/set_tls_enabled(Option<bool>)
:
required: falseA flag to enable in-transit encryption on the cluster.
kms_key_id(impl Into<String>)
/set_kms_key_id(Option<String>)
:
required: falseThe ID of the KMS key used to encrypt the cluster.
snapshot_arns(impl Into<String>)
/set_snapshot_arns(Option<Vec::<String>>)
:
required: falseA list of Amazon Resource Names (ARN) that uniquely identify the RDB snapshot files stored in Amazon S3. The snapshot files are used to populate the new cluster. The Amazon S3 object name in the ARN cannot contain any commas.
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: falseThe name of a snapshot from which to restore data into the new cluster. The snapshot status changes to restoring while the new cluster is being created.
snapshot_retention_limit(i32)
/set_snapshot_retention_limit(Option<i32>)
:
required: falseThe number of days for which MemoryDB retains automatic snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. Tags are comma-separated key,value pairs (e.g. Key=myKey, Value=myKeyValue. You can include multiple tags as shown following: Key=myKey, Value=myKeyValue Key=mySecondKey, Value=mySecondKeyValue.
snapshot_window(impl Into<String>)
/set_snapshot_window(Option<String>)
:
required: falseThe daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your shard.
Example: 05:00-09:00
If you do not specify this parameter, MemoryDB automatically chooses an appropriate time range.
acl_name(impl Into<String>)
/set_acl_name(Option<String>)
:
required: trueThe name of the Access Control List to associate with the cluster.
engine(impl Into<String>)
/set_engine(Option<String>)
:
required: falseThe name of the engine to be used for the cluster.
engine_version(impl Into<String>)
/set_engine_version(Option<String>)
:
required: falseThe version number of the Redis OSS engine to be used for the cluster.
auto_minor_version_upgrade(bool)
/set_auto_minor_version_upgrade(Option<bool>)
:
required: falseWhen set to true, the cluster will automatically receive minor engine version upgrades after launch.
data_tiering(bool)
/set_data_tiering(Option<bool>)
:
required: falseEnables data tiering. Data tiering is only supported for clusters using the r6gd node type. This parameter must be set when using r6gd nodes. For more information, see Data tiering.
network_type(NetworkType)
/set_network_type(Option<NetworkType>)
:
required: falseSpecifies the IP address type for the cluster. Valid values are ‘ipv4’, ‘ipv6’, or ‘dual_stack’. When set to ‘ipv4’, the cluster will only be accessible via IPv4 addresses. When set to ‘ipv6’, the cluster will only be accessible via IPv6 addresses. When set to ‘dual_stack’, the cluster will be accessible via both IPv4 and IPv6 addresses. If not specified, the default is ‘ipv4’.
ip_discovery(IpDiscovery)
/set_ip_discovery(Option<IpDiscovery>)
:
required: falseThe mechanism for discovering IP addresses for the cluster discovery protocol. Valid values are ‘ipv4’ or ‘ipv6’. When set to ‘ipv4’, cluster discovery functions such as cluster slots, cluster shards, and cluster nodes return IPv4 addresses for cluster nodes. When set to ‘ipv6’, the cluster discovery functions return IPv6 addresses for cluster nodes. The value must be compatible with the NetworkType parameter. If not specified, the default is ‘ipv4’.
- On success, responds with
CreateClusterOutput
with field(s):cluster(Option<Cluster>)
:The newly-created cluster.
- On failure, responds with
SdkError<CreateClusterError>
Source§impl Client
impl Client
Sourcepub fn create_multi_region_cluster(
&self,
) -> CreateMultiRegionClusterFluentBuilder
pub fn create_multi_region_cluster( &self, ) -> CreateMultiRegionClusterFluentBuilder
Constructs a fluent builder for the CreateMultiRegionCluster
operation.
- The fluent builder is configurable:
multi_region_cluster_name_suffix(impl Into<String>)
/set_multi_region_cluster_name_suffix(Option<String>)
:
required: trueA suffix to be added to the Multi-Region cluster name. Amazon MemoryDB automatically applies a prefix to the Multi-Region cluster Name when it is created. Each Amazon Region has its own prefix. For instance, a Multi-Region cluster Name created in the US-West-1 region will begin with “virxk”, along with the suffix name you provide. The suffix guarantees uniqueness of the Multi-Region cluster name across multiple regions.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description for the multi-Region cluster.
engine(impl Into<String>)
/set_engine(Option<String>)
:
required: falseThe name of the engine to be used for the multi-Region cluster.
engine_version(impl Into<String>)
/set_engine_version(Option<String>)
:
required: falseThe version of the engine to be used for the multi-Region cluster.
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: trueThe node type to be used for the multi-Region cluster.
multi_region_parameter_group_name(impl Into<String>)
/set_multi_region_parameter_group_name(Option<String>)
:
required: falseThe name of the multi-Region parameter group to be associated with the cluster.
num_shards(i32)
/set_num_shards(Option<i32>)
:
required: falseThe number of shards for the multi-Region cluster.
tls_enabled(bool)
/set_tls_enabled(Option<bool>)
:
required: falseWhether to enable TLS encryption for the multi-Region cluster.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be applied to the multi-Region cluster.
- On success, responds with
CreateMultiRegionClusterOutput
with field(s):multi_region_cluster(Option<MultiRegionCluster>)
:Details about the newly created multi-Region cluster.
- On failure, responds with
SdkError<CreateMultiRegionClusterError>
Source§impl Client
impl Client
Sourcepub fn create_parameter_group(&self) -> CreateParameterGroupFluentBuilder
pub fn create_parameter_group(&self) -> CreateParameterGroupFluentBuilder
Constructs a fluent builder for the CreateParameterGroup
operation.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: trueThe name of the parameter group.
family(impl Into<String>)
/set_family(Option<String>)
:
required: trueThe name of the parameter group family that the parameter group can be used with.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseAn optional description of the parameter group.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
CreateParameterGroupOutput
with field(s):parameter_group(Option<ParameterGroup>)
:The newly-created parameter group.
- On failure, responds with
SdkError<CreateParameterGroupError>
Source§impl Client
impl Client
Sourcepub fn create_snapshot(&self) -> CreateSnapshotFluentBuilder
pub fn create_snapshot(&self) -> CreateSnapshotFluentBuilder
Constructs a fluent builder for the CreateSnapshot
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe snapshot is created from this cluster.
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: trueA name for the snapshot being created.
kms_key_id(impl Into<String>)
/set_kms_key_id(Option<String>)
:
required: falseThe ID of the KMS key used to encrypt the snapshot.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
CreateSnapshotOutput
with field(s):snapshot(Option<Snapshot>)
:The newly-created snapshot.
- On failure, responds with
SdkError<CreateSnapshotError>
Source§impl Client
impl Client
Sourcepub fn create_subnet_group(&self) -> CreateSubnetGroupFluentBuilder
pub fn create_subnet_group(&self) -> CreateSubnetGroupFluentBuilder
Constructs a fluent builder for the CreateSubnetGroup
operation.
- The fluent builder is configurable:
subnet_group_name(impl Into<String>)
/set_subnet_group_name(Option<String>)
:
required: trueThe name of the subnet group.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description for the subnet group.
subnet_ids(impl Into<String>)
/set_subnet_ids(Option<Vec::<String>>)
:
required: trueA list of VPC subnet IDs for the subnet group.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
CreateSubnetGroupOutput
with field(s):subnet_group(Option<SubnetGroup>)
:The newly-created subnet group.
- On failure, responds with
SdkError<CreateSubnetGroupError>
Source§impl Client
impl Client
Sourcepub fn create_user(&self) -> CreateUserFluentBuilder
pub fn create_user(&self) -> CreateUserFluentBuilder
Constructs a fluent builder for the CreateUser
operation.
- The fluent builder is configurable:
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: trueThe name of the user. This value must be unique as it also serves as the user identifier.
authentication_mode(AuthenticationMode)
/set_authentication_mode(Option<AuthenticationMode>)
:
required: trueDenotes the user’s authentication properties, such as whether it requires a password to authenticate.
access_string(impl Into<String>)
/set_access_string(Option<String>)
:
required: trueAccess permissions string used for this user.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
CreateUserOutput
with field(s):user(Option<User>)
:The newly-created user.
- On failure, responds with
SdkError<CreateUserError>
Source§impl Client
impl Client
Sourcepub fn delete_acl(&self) -> DeleteACLFluentBuilder
pub fn delete_acl(&self) -> DeleteACLFluentBuilder
Constructs a fluent builder for the DeleteACL
operation.
- The fluent builder is configurable:
acl_name(impl Into<String>)
/set_acl_name(Option<String>)
:
required: trueThe name of the Access Control List to delete.
- On success, responds with
DeleteAclOutput
with field(s):acl(Option<Acl>)
:The Access Control List object that has been deleted.
- On failure, responds with
SdkError<DeleteACLError>
Source§impl Client
impl Client
Sourcepub fn delete_cluster(&self) -> DeleteClusterFluentBuilder
pub fn delete_cluster(&self) -> DeleteClusterFluentBuilder
Constructs a fluent builder for the DeleteCluster
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the cluster to be deleted
multi_region_cluster_name(impl Into<String>)
/set_multi_region_cluster_name(Option<String>)
:
required: falseThe name of the multi-Region cluster to be deleted.
final_snapshot_name(impl Into<String>)
/set_final_snapshot_name(Option<String>)
:
required: falseThe user-supplied name of a final cluster snapshot. This is the unique name that identifies the snapshot. MemoryDB creates the snapshot, and then deletes the cluster immediately afterward.
- On success, responds with
DeleteClusterOutput
with field(s):cluster(Option<Cluster>)
:The cluster object that has been deleted.
- On failure, responds with
SdkError<DeleteClusterError>
Source§impl Client
impl Client
Sourcepub fn delete_multi_region_cluster(
&self,
) -> DeleteMultiRegionClusterFluentBuilder
pub fn delete_multi_region_cluster( &self, ) -> DeleteMultiRegionClusterFluentBuilder
Constructs a fluent builder for the DeleteMultiRegionCluster
operation.
- The fluent builder is configurable:
multi_region_cluster_name(impl Into<String>)
/set_multi_region_cluster_name(Option<String>)
:
required: trueThe name of the multi-Region cluster to be deleted.
- On success, responds with
DeleteMultiRegionClusterOutput
with field(s):multi_region_cluster(Option<MultiRegionCluster>)
:Details about the deleted multi-Region cluster.
- On failure, responds with
SdkError<DeleteMultiRegionClusterError>
Source§impl Client
impl Client
Sourcepub fn delete_parameter_group(&self) -> DeleteParameterGroupFluentBuilder
pub fn delete_parameter_group(&self) -> DeleteParameterGroupFluentBuilder
Constructs a fluent builder for the DeleteParameterGroup
operation.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: trueThe name of the parameter group to delete.
- On success, responds with
DeleteParameterGroupOutput
with field(s):parameter_group(Option<ParameterGroup>)
:The parameter group that has been deleted.
- On failure, responds with
SdkError<DeleteParameterGroupError>
Source§impl Client
impl Client
Sourcepub fn delete_snapshot(&self) -> DeleteSnapshotFluentBuilder
pub fn delete_snapshot(&self) -> DeleteSnapshotFluentBuilder
Constructs a fluent builder for the DeleteSnapshot
operation.
- The fluent builder is configurable:
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: trueThe name of the snapshot to delete.
- On success, responds with
DeleteSnapshotOutput
with field(s):snapshot(Option<Snapshot>)
:The snapshot object that has been deleted.
- On failure, responds with
SdkError<DeleteSnapshotError>
Source§impl Client
impl Client
Sourcepub fn delete_subnet_group(&self) -> DeleteSubnetGroupFluentBuilder
pub fn delete_subnet_group(&self) -> DeleteSubnetGroupFluentBuilder
Constructs a fluent builder for the DeleteSubnetGroup
operation.
- The fluent builder is configurable:
subnet_group_name(impl Into<String>)
/set_subnet_group_name(Option<String>)
:
required: trueThe name of the subnet group to delete.
- On success, responds with
DeleteSubnetGroupOutput
with field(s):subnet_group(Option<SubnetGroup>)
:The subnet group object that has been deleted.
- On failure, responds with
SdkError<DeleteSubnetGroupError>
Source§impl Client
impl Client
Sourcepub fn delete_user(&self) -> DeleteUserFluentBuilder
pub fn delete_user(&self) -> DeleteUserFluentBuilder
Constructs a fluent builder for the DeleteUser
operation.
- The fluent builder is configurable:
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: trueThe name of the user to delete
- On success, responds with
DeleteUserOutput
with field(s):user(Option<User>)
:The user object that has been deleted.
- On failure, responds with
SdkError<DeleteUserError>
Source§impl Client
impl Client
Sourcepub fn describe_acls(&self) -> DescribeACLsFluentBuilder
pub fn describe_acls(&self) -> DescribeACLsFluentBuilder
Constructs a fluent builder for the DescribeACLs
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
acl_name(impl Into<String>)
/set_acl_name(Option<String>)
:
required: falseThe name of the ACL.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeAcLsOutput
with field(s):acls(Option<Vec::<Acl>>)
:The list of ACLs.
next_token(Option<String>)
:If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On failure, responds with
SdkError<DescribeACLsError>
Source§impl Client
impl Client
Sourcepub fn describe_clusters(&self) -> DescribeClustersFluentBuilder
pub fn describe_clusters(&self) -> DescribeClustersFluentBuilder
Constructs a fluent builder for the DescribeClusters
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: falseThe name of the cluster.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
show_shard_details(bool)
/set_show_shard_details(Option<bool>)
:
required: falseAn optional flag that can be included in the request to retrieve information about the individual shard(s).
- On success, responds with
DescribeClustersOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
clusters(Option<Vec::<Cluster>>)
:A list of clusters
- On failure, responds with
SdkError<DescribeClustersError>
Source§impl Client
impl Client
Sourcepub fn describe_engine_versions(&self) -> DescribeEngineVersionsFluentBuilder
pub fn describe_engine_versions(&self) -> DescribeEngineVersionsFluentBuilder
Constructs a fluent builder for the DescribeEngineVersions
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
engine(impl Into<String>)
/set_engine(Option<String>)
:
required: falseThe name of the engine for which to list available versions.
engine_version(impl Into<String>)
/set_engine_version(Option<String>)
:
required: falseThe Redis OSS engine version
parameter_group_family(impl Into<String>)
/set_parameter_group_family(Option<String>)
:
required: falseThe name of a specific parameter group family to return details for.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
default_only(bool)
/set_default_only(Option<bool>)
:
required: falseIf true, specifies that only the default version of the specified engine or engine and major version combination is to be returned.
- On success, responds with
DescribeEngineVersionsOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
engine_versions(Option<Vec::<EngineVersionInfo>>)
:A list of engine version details. Each element in the list contains detailed information about one engine version.
- On failure, responds with
SdkError<DescribeEngineVersionsError>
Source§impl Client
impl Client
Sourcepub fn describe_events(&self) -> DescribeEventsFluentBuilder
pub fn describe_events(&self) -> DescribeEventsFluentBuilder
Constructs a fluent builder for the DescribeEvents
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
source_name(impl Into<String>)
/set_source_name(Option<String>)
:
required: falseThe identifier of the event source for which events are returned. If not specified, all sources are included in the response.
source_type(SourceType)
/set_source_type(Option<SourceType>)
:
required: falseThe event source to retrieve events for. If no value is specified, all events are returned.
start_time(DateTime)
/set_start_time(Option<DateTime>)
:
required: falseThe beginning of the time interval to retrieve events for, specified in ISO 8601 format. Example: 2017-03-30T07:03:49.555Z
end_time(DateTime)
/set_end_time(Option<DateTime>)
:
required: falseThe end of the time interval for which to retrieve events, specified in ISO 8601 format. Example: 2017-03-30T07:03:49.555Z
duration(i32)
/set_duration(Option<i32>)
:
required: falseThe number of minutes worth of events to retrieve.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeEventsOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
events(Option<Vec::<Event>>)
:A list of events. Each element in the list contains detailed information about one event.
- On failure, responds with
SdkError<DescribeEventsError>
Source§impl Client
impl Client
Sourcepub fn describe_multi_region_clusters(
&self,
) -> DescribeMultiRegionClustersFluentBuilder
pub fn describe_multi_region_clusters( &self, ) -> DescribeMultiRegionClustersFluentBuilder
Constructs a fluent builder for the DescribeMultiRegionClusters
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
multi_region_cluster_name(impl Into<String>)
/set_multi_region_cluster_name(Option<String>)
:
required: falseThe name of a specific multi-Region cluster to describe.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of results to return.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseA token to specify where to start paginating.
show_cluster_details(bool)
/set_show_cluster_details(Option<bool>)
:
required: falseDetails about the multi-Region cluster.
- On success, responds with
DescribeMultiRegionClustersOutput
with field(s):next_token(Option<String>)
:A token to use to retrieve the next page of results.
multi_region_clusters(Option<Vec::<MultiRegionCluster>>)
:A list of multi-Region clusters.
- On failure, responds with
SdkError<DescribeMultiRegionClustersError>
Source§impl Client
impl Client
Sourcepub fn describe_parameter_groups(&self) -> DescribeParameterGroupsFluentBuilder
pub fn describe_parameter_groups(&self) -> DescribeParameterGroupsFluentBuilder
Constructs a fluent builder for the DescribeParameterGroups
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: falseThe name of a specific parameter group to return details for.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeParameterGroupsOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
parameter_groups(Option<Vec::<ParameterGroup>>)
:A list of parameter groups. Each element in the list contains detailed information about one parameter group.
- On failure, responds with
SdkError<DescribeParameterGroupsError>
Source§impl Client
impl Client
Sourcepub fn describe_parameters(&self) -> DescribeParametersFluentBuilder
pub fn describe_parameters(&self) -> DescribeParametersFluentBuilder
Constructs a fluent builder for the DescribeParameters
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: truehe name of a specific parameter group to return details for.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeParametersOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
parameters(Option<Vec::<Parameter>>)
:A list of parameters specific to a particular parameter group. Each element in the list contains detailed information about one parameter.
- On failure, responds with
SdkError<DescribeParametersError>
Source§impl Client
impl Client
Sourcepub fn describe_reserved_nodes(&self) -> DescribeReservedNodesFluentBuilder
pub fn describe_reserved_nodes(&self) -> DescribeReservedNodesFluentBuilder
Constructs a fluent builder for the DescribeReservedNodes
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
reservation_id(impl Into<String>)
/set_reservation_id(Option<String>)
:
required: falseThe reserved node identifier filter value. Use this parameter to show only the reservation that matches the specified reservation ID.
reserved_nodes_offering_id(impl Into<String>)
/set_reserved_nodes_offering_id(Option<String>)
:
required: falseThe offering identifier filter value. Use this parameter to show only purchased reservations matching the specified offering identifier.
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: falseThe node type filter value. Use this parameter to show only those reservations matching the specified node type. For more information, see Supported node types.
duration(impl Into<String>)
/set_duration(Option<String>)
:
required: falseThe duration filter value, specified in years or seconds. Use this parameter to show only reservations for this duration.
offering_type(impl Into<String>)
/set_offering_type(Option<String>)
:
required: falseThe offering type filter value. Use this parameter to show only the available offerings matching the specified offering type. Valid values: “All Upfront”|“Partial Upfront”| “No Upfront”
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
- On success, responds with
DescribeReservedNodesOutput
with field(s):next_token(Option<String>)
:An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
reserved_nodes(Option<Vec::<ReservedNode>>)
:Returns information about reserved nodes for this account, or about a specified reserved node.
- On failure, responds with
SdkError<DescribeReservedNodesError>
Source§impl Client
impl Client
Sourcepub fn describe_reserved_nodes_offerings(
&self,
) -> DescribeReservedNodesOfferingsFluentBuilder
pub fn describe_reserved_nodes_offerings( &self, ) -> DescribeReservedNodesOfferingsFluentBuilder
Constructs a fluent builder for the DescribeReservedNodesOfferings
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
reserved_nodes_offering_id(impl Into<String>)
/set_reserved_nodes_offering_id(Option<String>)
:
required: falseThe offering identifier filter value. Use this parameter to show only the available offering that matches the specified reservation identifier.
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: falseThe node type for the reserved nodes. For more information, see Supported node types.
duration(impl Into<String>)
/set_duration(Option<String>)
:
required: falseDuration filter value, specified in years or seconds. Use this parameter to show only reservations for a given duration.
offering_type(impl Into<String>)
/set_offering_type(Option<String>)
:
required: falseThe offering type filter value. Use this parameter to show only the available offerings matching the specified offering type. Valid values: “All Upfront”|“Partial Upfront”| “No Upfront”
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxRecords value, a marker is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
- On success, responds with
DescribeReservedNodesOfferingsOutput
with field(s):next_token(Option<String>)
:An optional marker returned from a prior request. Use this marker for pagination of results from this operation. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords.
reserved_nodes_offerings(Option<Vec::<ReservedNodesOffering>>)
:Lists available reserved node offerings.
- On failure, responds with
SdkError<DescribeReservedNodesOfferingsError>
Source§impl Client
impl Client
Sourcepub fn describe_service_updates(&self) -> DescribeServiceUpdatesFluentBuilder
pub fn describe_service_updates(&self) -> DescribeServiceUpdatesFluentBuilder
Constructs a fluent builder for the DescribeServiceUpdates
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
service_update_name(impl Into<String>)
/set_service_update_name(Option<String>)
:
required: falseThe unique ID of the service update to describe.
cluster_names(impl Into<String>)
/set_cluster_names(Option<Vec::<String>>)
:
required: falseThe list of cluster names to identify service updates to apply.
status(ServiceUpdateStatus)
/set_status(Option<Vec::<ServiceUpdateStatus>>)
:
required: falseThe status(es) of the service updates to filter on.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeServiceUpdatesOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
service_updates(Option<Vec::<ServiceUpdate>>)
:A list of service updates
- On failure, responds with
SdkError<DescribeServiceUpdatesError>
Source§impl Client
impl Client
Sourcepub fn describe_snapshots(&self) -> DescribeSnapshotsFluentBuilder
pub fn describe_snapshots(&self) -> DescribeSnapshotsFluentBuilder
Constructs a fluent builder for the DescribeSnapshots
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: falseA user-supplied cluster identifier. If this parameter is specified, only snapshots associated with that specific cluster are described.
snapshot_name(impl Into<String>)
/set_snapshot_name(Option<String>)
:
required: falseA user-supplied name of the snapshot. If this parameter is specified, only this named snapshot is described.
source(impl Into<String>)
/set_source(Option<String>)
:
required: falseIf set to system, the output shows snapshots that were automatically created by MemoryDB. If set to user the output shows snapshots that were manually created. If omitted, the output shows both automatically and manually created snapshots.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
show_detail(bool)
/set_show_detail(Option<bool>)
:
required: falseA Boolean value which if true, the shard configuration is included in the snapshot description.
- On success, responds with
DescribeSnapshotsOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
snapshots(Option<Vec::<Snapshot>>)
:A list of snapshots. Each item in the list contains detailed information about one snapshot.
- On failure, responds with
SdkError<DescribeSnapshotsError>
Source§impl Client
impl Client
Sourcepub fn describe_subnet_groups(&self) -> DescribeSubnetGroupsFluentBuilder
pub fn describe_subnet_groups(&self) -> DescribeSubnetGroupsFluentBuilder
Constructs a fluent builder for the DescribeSubnetGroups
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
subnet_group_name(impl Into<String>)
/set_subnet_group_name(Option<String>)
:
required: falseThe name of the subnet group to return details for.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeSubnetGroupsOutput
with field(s):next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
subnet_groups(Option<Vec::<SubnetGroup>>)
:A list of subnet groups. Each element in the list contains detailed information about one group.
- On failure, responds with
SdkError<DescribeSubnetGroupsError>
Source§impl Client
impl Client
Sourcepub fn describe_users(&self) -> DescribeUsersFluentBuilder
pub fn describe_users(&self) -> DescribeUsersFluentBuilder
Constructs a fluent builder for the DescribeUsers
operation.
This operation supports pagination; See into_paginator()
.
- The fluent builder is configurable:
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: falseThe name of the user.
filters(Filter)
/set_filters(Option<Vec::<Filter>>)
:
required: falseFilter to determine the list of users to return.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of records to include in the response. If more records exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On success, responds with
DescribeUsersOutput
with field(s):users(Option<Vec::<User>>)
:A list of users.
next_token(Option<String>)
:An optional argument to pass in case the total number of records exceeds the value of MaxResults. If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
- On failure, responds with
SdkError<DescribeUsersError>
Source§impl Client
impl Client
Sourcepub fn failover_shard(&self) -> FailoverShardFluentBuilder
pub fn failover_shard(&self) -> FailoverShardFluentBuilder
Constructs a fluent builder for the FailoverShard
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe cluster being failed over.
shard_name(impl Into<String>)
/set_shard_name(Option<String>)
:
required: trueThe name of the shard.
- On success, responds with
FailoverShardOutput
with field(s):cluster(Option<Cluster>)
:The cluster being failed over.
- On failure, responds with
SdkError<FailoverShardError>
Source§impl Client
impl Client
Sourcepub fn list_allowed_multi_region_cluster_updates(
&self,
) -> ListAllowedMultiRegionClusterUpdatesFluentBuilder
pub fn list_allowed_multi_region_cluster_updates( &self, ) -> ListAllowedMultiRegionClusterUpdatesFluentBuilder
Constructs a fluent builder for the ListAllowedMultiRegionClusterUpdates
operation.
- The fluent builder is configurable:
multi_region_cluster_name(impl Into<String>)
/set_multi_region_cluster_name(Option<String>)
:
required: trueThe name of the multi-Region cluster.
- On success, responds with
ListAllowedMultiRegionClusterUpdatesOutput
with field(s):scale_up_node_types(Option<Vec::<String>>)
:The node types that the cluster can be scaled up to.
scale_down_node_types(Option<Vec::<String>>)
:The node types that the cluster can be scaled down to.
- On failure, responds with
SdkError<ListAllowedMultiRegionClusterUpdatesError>
Source§impl Client
impl Client
Sourcepub fn list_allowed_node_type_updates(
&self,
) -> ListAllowedNodeTypeUpdatesFluentBuilder
pub fn list_allowed_node_type_updates( &self, ) -> ListAllowedNodeTypeUpdatesFluentBuilder
Constructs a fluent builder for the ListAllowedNodeTypeUpdates
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the cluster you want to scale. MemoryDB uses the cluster name to identify the current node type being used by this cluster, and from that to create a list of node types you can scale up to.
- On success, responds with
ListAllowedNodeTypeUpdatesOutput
with field(s):scale_up_node_types(Option<Vec::<String>>)
:A list node types which you can use to scale up your cluster.
scale_down_node_types(Option<Vec::<String>>)
:A list node types which you can use to scale down your cluster.
- On failure, responds with
SdkError<ListAllowedNodeTypeUpdatesError>
Source§impl Client
impl Client
Constructs a fluent builder for the ListTags
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe Amazon Resource Name (ARN) of the resource for which you want the list of tags.
- On success, responds with
ListTagsOutput
with field(s):tag_list(Option<Vec::<Tag>>)
:A list of tags as key-value pairs.
- On failure, responds with
SdkError<ListTagsError>
Source§impl Client
impl Client
Sourcepub fn purchase_reserved_nodes_offering(
&self,
) -> PurchaseReservedNodesOfferingFluentBuilder
pub fn purchase_reserved_nodes_offering( &self, ) -> PurchaseReservedNodesOfferingFluentBuilder
Constructs a fluent builder for the PurchaseReservedNodesOffering
operation.
- The fluent builder is configurable:
reserved_nodes_offering_id(impl Into<String>)
/set_reserved_nodes_offering_id(Option<String>)
:
required: trueThe ID of the reserved node offering to purchase.
reservation_id(impl Into<String>)
/set_reservation_id(Option<String>)
:
required: falseA customer-specified identifier to track this reservation.
node_count(i32)
/set_node_count(Option<i32>)
:
required: falseThe number of node instances to reserve.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
PurchaseReservedNodesOfferingOutput
with field(s):reserved_node(Option<ReservedNode>)
:Represents the output of a
PurchaseReservedNodesOffering
operation.
- On failure, responds with
SdkError<PurchaseReservedNodesOfferingError>
Source§impl Client
impl Client
Sourcepub fn reset_parameter_group(&self) -> ResetParameterGroupFluentBuilder
pub fn reset_parameter_group(&self) -> ResetParameterGroupFluentBuilder
Constructs a fluent builder for the ResetParameterGroup
operation.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: trueThe name of the parameter group to reset.
all_parameters(bool)
/set_all_parameters(Option<bool>)
:
required: falseIf true, all parameters in the parameter group are reset to their default values. If false, only the parameters listed by ParameterNames are reset to their default values.
parameter_names(impl Into<String>)
/set_parameter_names(Option<Vec::<String>>)
:
required: falseAn array of parameter names to reset to their default values. If AllParameters is true, do not use ParameterNames. If AllParameters is false, you must specify the name of at least one parameter to reset.
- On success, responds with
ResetParameterGroupOutput
with field(s):parameter_group(Option<ParameterGroup>)
:The parameter group being reset.
- On failure, responds with
SdkError<ResetParameterGroupError>
Source§impl Client
impl Client
Sourcepub fn tag_resource(&self) -> TagResourceFluentBuilder
pub fn tag_resource(&self) -> TagResourceFluentBuilder
Constructs a fluent builder for the TagResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe Amazon Resource Name (ARN) of the resource to which the tags are to be added.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: trueA list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.
- On success, responds with
TagResourceOutput
with field(s):tag_list(Option<Vec::<Tag>>)
:A list of tags as key-value pairs.
- On failure, responds with
SdkError<TagResourceError>
Source§impl Client
impl Client
Sourcepub fn untag_resource(&self) -> UntagResourceFluentBuilder
pub fn untag_resource(&self) -> UntagResourceFluentBuilder
Constructs a fluent builder for the UntagResource
operation.
- The fluent builder is configurable:
resource_arn(impl Into<String>)
/set_resource_arn(Option<String>)
:
required: trueThe Amazon Resource Name (ARN) of the resource to which the tags are to be removed.
tag_keys(impl Into<String>)
/set_tag_keys(Option<Vec::<String>>)
:
required: trueThe list of keys of the tags that are to be removed.
- On success, responds with
UntagResourceOutput
with field(s):tag_list(Option<Vec::<Tag>>)
:The list of tags removed.
- On failure, responds with
SdkError<UntagResourceError>
Source§impl Client
impl Client
Sourcepub fn update_acl(&self) -> UpdateACLFluentBuilder
pub fn update_acl(&self) -> UpdateACLFluentBuilder
Constructs a fluent builder for the UpdateACL
operation.
- The fluent builder is configurable:
acl_name(impl Into<String>)
/set_acl_name(Option<String>)
:
required: trueThe name of the Access Control List.
user_names_to_add(impl Into<String>)
/set_user_names_to_add(Option<Vec::<String>>)
:
required: falseThe list of users to add to the Access Control List.
user_names_to_remove(impl Into<String>)
/set_user_names_to_remove(Option<Vec::<String>>)
:
required: falseThe list of users to remove from the Access Control List.
- On success, responds with
UpdateAclOutput
with field(s):acl(Option<Acl>)
:The updated Access Control List.
- On failure, responds with
SdkError<UpdateACLError>
Source§impl Client
impl Client
Sourcepub fn update_cluster(&self) -> UpdateClusterFluentBuilder
pub fn update_cluster(&self) -> UpdateClusterFluentBuilder
Constructs a fluent builder for the UpdateCluster
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the cluster to update.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseThe description of the cluster to update.
security_group_ids(impl Into<String>)
/set_security_group_ids(Option<Vec::<String>>)
:
required: falseThe SecurityGroupIds to update.
maintenance_window(impl Into<String>)
/set_maintenance_window(Option<String>)
:
required: falseSpecifies the weekly time range during which maintenance on the cluster is performed. It is specified as a range in the format ddd:hh24:mi-ddd:hh24:mi (24H Clock UTC). The minimum maintenance window is a 60 minute period.
Valid values for
ddd
are:-
sun
-
mon
-
tue
-
wed
-
thu
-
fri
-
sat
Example:
sun:23:00-mon:01:30
-
sns_topic_arn(impl Into<String>)
/set_sns_topic_arn(Option<String>)
:
required: falseThe SNS topic ARN to update.
sns_topic_status(impl Into<String>)
/set_sns_topic_status(Option<String>)
:
required: falseThe status of the Amazon SNS notification topic. Notifications are sent only if the status is active.
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: falseThe name of the parameter group to update.
snapshot_window(impl Into<String>)
/set_snapshot_window(Option<String>)
:
required: falseThe daily time range (in UTC) during which MemoryDB begins taking a daily snapshot of your cluster.
snapshot_retention_limit(i32)
/set_snapshot_retention_limit(Option<i32>)
:
required: falseThe number of days for which MemoryDB retains automatic cluster snapshots before deleting them. For example, if you set SnapshotRetentionLimit to 5, a snapshot that was taken today is retained for 5 days before being deleted.
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: falseA valid node type that you want to scale this cluster up or down to.
engine(impl Into<String>)
/set_engine(Option<String>)
:
required: falseThe name of the engine to be used for the cluster.
engine_version(impl Into<String>)
/set_engine_version(Option<String>)
:
required: falseThe upgraded version of the engine to be run on the nodes. You can upgrade to a newer engine version, but you cannot downgrade to an earlier engine version. If you want to use an earlier engine version, you must delete the existing cluster and create it anew with the earlier engine version.
replica_configuration(ReplicaConfigurationRequest)
/set_replica_configuration(Option<ReplicaConfigurationRequest>)
:
required: falseThe number of replicas that will reside in each shard.
shard_configuration(ShardConfigurationRequest)
/set_shard_configuration(Option<ShardConfigurationRequest>)
:
required: falseThe number of shards in the cluster.
acl_name(impl Into<String>)
/set_acl_name(Option<String>)
:
required: falseThe Access Control List that is associated with the cluster.
ip_discovery(IpDiscovery)
/set_ip_discovery(Option<IpDiscovery>)
:
required: falseThe mechanism for discovering IP addresses for the cluster discovery protocol. Valid values are ‘ipv4’ or ‘ipv6’. When set to ‘ipv4’, cluster discovery functions such as cluster slots, cluster shards, and cluster nodes will return IPv4 addresses for cluster nodes. When set to ‘ipv6’, the cluster discovery functions return IPv6 addresses for cluster nodes. The value must be compatible with the NetworkType parameter. If not specified, the default is ‘ipv4’.
- On success, responds with
UpdateClusterOutput
with field(s):cluster(Option<Cluster>)
:The updated cluster.
- On failure, responds with
SdkError<UpdateClusterError>
Source§impl Client
impl Client
Sourcepub fn update_multi_region_cluster(
&self,
) -> UpdateMultiRegionClusterFluentBuilder
pub fn update_multi_region_cluster( &self, ) -> UpdateMultiRegionClusterFluentBuilder
Constructs a fluent builder for the UpdateMultiRegionCluster
operation.
- The fluent builder is configurable:
multi_region_cluster_name(impl Into<String>)
/set_multi_region_cluster_name(Option<String>)
:
required: trueThe name of the multi-Region cluster to be updated.
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: falseThe new node type to be used for the multi-Region cluster.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA new description for the multi-Region cluster.
engine_version(impl Into<String>)
/set_engine_version(Option<String>)
:
required: falseThe new engine version to be used for the multi-Region cluster.
shard_configuration(ShardConfigurationRequest)
/set_shard_configuration(Option<ShardConfigurationRequest>)
:
required: falseA request to configure the sharding properties of a cluster
multi_region_parameter_group_name(impl Into<String>)
/set_multi_region_parameter_group_name(Option<String>)
:
required: falseThe new multi-Region parameter group to be associated with the cluster.
update_strategy(UpdateStrategy)
/set_update_strategy(Option<UpdateStrategy>)
:
required: falseThe strategy to use for the update operation. Supported values are “coordinated” or “uncoordinated”.
- On success, responds with
UpdateMultiRegionClusterOutput
with field(s):multi_region_cluster(Option<MultiRegionCluster>)
:The status of updating the multi-Region cluster.
- On failure, responds with
SdkError<UpdateMultiRegionClusterError>
Source§impl Client
impl Client
Sourcepub fn update_parameter_group(&self) -> UpdateParameterGroupFluentBuilder
pub fn update_parameter_group(&self) -> UpdateParameterGroupFluentBuilder
Constructs a fluent builder for the UpdateParameterGroup
operation.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: trueThe name of the parameter group to update.
parameter_name_values(ParameterNameValue)
/set_parameter_name_values(Option<Vec::<ParameterNameValue>>)
:
required: trueAn array of parameter names and values for the parameter update. You must supply at least one parameter name and value; subsequent arguments are optional. A maximum of 20 parameters may be updated per request.
- On success, responds with
UpdateParameterGroupOutput
with field(s):parameter_group(Option<ParameterGroup>)
:The updated parameter group
- On failure, responds with
SdkError<UpdateParameterGroupError>
Source§impl Client
impl Client
Sourcepub fn update_subnet_group(&self) -> UpdateSubnetGroupFluentBuilder
pub fn update_subnet_group(&self) -> UpdateSubnetGroupFluentBuilder
Constructs a fluent builder for the UpdateSubnetGroup
operation.
- The fluent builder is configurable:
subnet_group_name(impl Into<String>)
/set_subnet_group_name(Option<String>)
:
required: trueThe name of the subnet group
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description of the subnet group
subnet_ids(impl Into<String>)
/set_subnet_ids(Option<Vec::<String>>)
:
required: falseThe EC2 subnet IDs for the subnet group.
- On success, responds with
UpdateSubnetGroupOutput
with field(s):subnet_group(Option<SubnetGroup>)
:The updated subnet group
- On failure, responds with
SdkError<UpdateSubnetGroupError>
Source§impl Client
impl Client
Sourcepub fn update_user(&self) -> UpdateUserFluentBuilder
pub fn update_user(&self) -> UpdateUserFluentBuilder
Constructs a fluent builder for the UpdateUser
operation.
- The fluent builder is configurable:
user_name(impl Into<String>)
/set_user_name(Option<String>)
:
required: trueThe name of the user
authentication_mode(AuthenticationMode)
/set_authentication_mode(Option<AuthenticationMode>)
:
required: falseDenotes the user’s authentication properties, such as whether it requires a password to authenticate.
access_string(impl Into<String>)
/set_access_string(Option<String>)
:
required: falseAccess permissions string used for this user.
- On success, responds with
UpdateUserOutput
with field(s):user(Option<User>)
:The updated user
- On failure, responds with
SdkError<UpdateUserError>
Source§impl Client
impl Client
Sourcepub fn from_conf(conf: Config) -> Self
pub fn from_conf(conf: Config) -> Self
Creates a new client from the service Config
.
§Panics
This method will panic in the following cases:
- Retries or timeouts are enabled without a
sleep_impl
configured. - Identity caching is enabled without a
sleep_impl
andtime_source
configured. - No
behavior_version
is provided.
The panic message for each of these will have instructions on how to resolve them.
Source§impl Client
impl Client
Sourcepub fn new(sdk_config: &SdkConfig) -> Self
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 thesleep_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 thehttp_connector
on the Config passed into this function to fix it. - This method will panic if no
BehaviorVersion
is provided. If you experience this panic, setbehavior_version
on the Config or enable thebehavior-version-latest
Cargo feature.
Trait Implementations§
Auto Trait Implementations§
impl Freeze for Client
impl !RefUnwindSafe for Client
impl Send for Client
impl Sync for Client
impl Unpin for Client
impl !UnwindSafe for Client
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> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
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 moreSource§impl<T> Paint for Twhere
T: ?Sized,
impl<T> Paint for Twhere
T: ?Sized,
Source§fn fg(&self, value: Color) -> Painted<&T>
fn fg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the foreground set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like red()
and
green()
, which have the same functionality but are
pithier.
§Example
Set foreground color to white using fg()
:
use yansi::{Paint, Color};
painted.fg(Color::White);
Set foreground color to white using white()
.
use yansi::Paint;
painted.white();
Source§fn bright_black(&self) -> Painted<&T>
fn bright_black(&self) -> Painted<&T>
Source§fn bright_red(&self) -> Painted<&T>
fn bright_red(&self) -> Painted<&T>
Source§fn bright_green(&self) -> Painted<&T>
fn bright_green(&self) -> Painted<&T>
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Source§fn bright_blue(&self) -> Painted<&T>
fn bright_blue(&self) -> Painted<&T>
Source§fn bright_magenta(&self) -> Painted<&T>
fn bright_magenta(&self) -> Painted<&T>
Source§fn bright_cyan(&self) -> Painted<&T>
fn bright_cyan(&self) -> Painted<&T>
Source§fn bright_white(&self) -> Painted<&T>
fn bright_white(&self) -> Painted<&T>
Source§fn bg(&self, value: Color) -> Painted<&T>
fn bg(&self, value: Color) -> Painted<&T>
Returns a styled value derived from self
with the background set to
value
.
This method should be used rarely. Instead, prefer to use color-specific
builder methods like on_red()
and
on_green()
, which have the same functionality but
are pithier.
§Example
Set background color to red using fg()
:
use yansi::{Paint, Color};
painted.bg(Color::Red);
Set background color to red using on_red()
.
use yansi::Paint;
painted.on_red();
Source§fn on_primary(&self) -> Painted<&T>
fn on_primary(&self) -> Painted<&T>
Source§fn on_magenta(&self) -> Painted<&T>
fn on_magenta(&self) -> Painted<&T>
Source§fn on_bright_black(&self) -> Painted<&T>
fn on_bright_black(&self) -> Painted<&T>
Source§fn on_bright_red(&self) -> Painted<&T>
fn on_bright_red(&self) -> Painted<&T>
Source§fn on_bright_green(&self) -> Painted<&T>
fn on_bright_green(&self) -> Painted<&T>
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Source§fn attr(&self, value: Attribute) -> Painted<&T>
fn attr(&self, value: Attribute) -> Painted<&T>
Enables the styling Attribute
value
.
This method should be used rarely. Instead, prefer to use
attribute-specific builder methods like bold()
and
underline()
, which have the same functionality
but are pithier.
§Example
Make text bold using attr()
:
use yansi::{Paint, Attribute};
painted.attr(Attribute::Bold);
Make text bold using using bold()
.
use yansi::Paint;
painted.bold();
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Source§fn quirk(&self, value: Quirk) -> Painted<&T>
fn quirk(&self, value: Quirk) -> Painted<&T>
Enables the yansi
Quirk
value
.
This method should be used rarely. Instead, prefer to use quirk-specific
builder methods like mask()
and
wrap()
, which have the same functionality but are
pithier.
§Example
Enable wrapping using .quirk()
:
use yansi::{Paint, Quirk};
painted.quirk(Quirk::Wrap);
Enable wrapping using wrap()
.
use yansi::Paint;
painted.wrap();
Source§fn clear(&self) -> Painted<&T>
👎Deprecated since 1.0.1: renamed to resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.
fn clear(&self) -> Painted<&T>
resetting()
due to conflicts with Vec::clear()
.
The clear()
method will be removed in a future release.Source§fn whenever(&self, value: Condition) -> Painted<&T>
fn whenever(&self, value: Condition) -> Painted<&T>
Conditionally enable styling based on whether the Condition
value
applies. Replaces any previous condition.
See the crate level docs for more details.
§Example
Enable styling painted
only when both stdout
and stderr
are TTYs:
use yansi::{Paint, Condition};
painted.red().on_yellow().whenever(Condition::STDOUTERR_ARE_TTY);