pub struct Client { /* private fields */ }
Expand description
Client for Amazon DynamoDB Accelerator (DAX)
Client for invoking operations on Amazon DynamoDB Accelerator (DAX). Each operation on Amazon DynamoDB Accelerator (DAX) 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_dax::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_dax::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 CreateCluster
operation has
a Client::create_cluster
, 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.create_cluster()
.cluster_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 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 cluster identifier. This parameter is stored as a lowercase string.
Constraints:
-
A name must contain from 1 to 20 alphanumeric characters or hyphens.
-
The first character must be a letter.
-
A name cannot end with a hyphen or contain two consecutive hyphens.
-
node_type(impl Into<String>)
/set_node_type(Option<String>)
:
required: trueThe compute and memory capacity of the nodes in the cluster.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description of the cluster.
replication_factor(i32)
/set_replication_factor(Option<i32>)
:
required: trueThe number of nodes in the DAX cluster. A replication factor of 1 will create a single-node cluster, without any read replicas. For additional fault tolerance, you can create a multiple node cluster with one or more read replicas. To do this, set
ReplicationFactor
to a number between 3 (one primary and two read replicas) and 10 (one primary and nine read replicas).If the AvailabilityZones
parameter is provided, its length must equal theReplicationFactor
.AWS recommends that you have at least two read replicas per cluster.
availability_zones(impl Into<String>)
/set_availability_zones(Option<Vec::<String>>)
:
required: falseThe Availability Zones (AZs) in which the cluster nodes will reside after the cluster has been created or updated. If provided, the length of this list must equal the
ReplicationFactor
parameter. If you omit this parameter, DAX will spread the nodes across Availability Zones for the highest availability.subnet_group_name(impl Into<String>)
/set_subnet_group_name(Option<String>)
:
required: falseThe name of the subnet group to be used for the replication group.
DAX clusters can only run in an Amazon VPC environment. All of the subnets that you specify in a subnet group must exist in the same VPC.
security_group_ids(impl Into<String>)
/set_security_group_ids(Option<Vec::<String>>)
:
required: falseA list of security group IDs to be assigned to each node in the DAX cluster. (Each of the security group ID is system-generated.)
If this parameter is not specified, DAX assigns the default VPC security group to each node.
preferred_maintenance_window(impl Into<String>)
/set_preferred_maintenance_window(Option<String>)
:
required: falseSpecifies the weekly time range during which maintenance on the DAX 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:05:00-sun:09:00
If you don’t specify a preferred maintenance window when you create or modify a cache cluster, DAX assigns a 60-minute maintenance window on a randomly selected day of the week.
-
notification_topic_arn(impl Into<String>)
/set_notification_topic_arn(Option<String>)
:
required: falseThe Amazon Resource Name (ARN) of the Amazon SNS topic to which notifications will be sent.
The Amazon SNS topic owner must be same as the DAX cluster owner.
iam_role_arn(impl Into<String>)
/set_iam_role_arn(Option<String>)
:
required: trueA valid Amazon Resource Name (ARN) that identifies an IAM role. At runtime, DAX will assume this role and use the role’s permissions to access DynamoDB on your behalf.
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: falseThe parameter group to be associated with the DAX cluster.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: falseA set of tags to associate with the DAX cluster.
sse_specification(SseSpecification)
/set_sse_specification(Option<SseSpecification>)
:
required: falseRepresents the settings used to enable server-side encryption on the cluster.
cluster_endpoint_encryption_type(ClusterEndpointEncryptionType)
/set_cluster_endpoint_encryption_type(Option<ClusterEndpointEncryptionType>)
:
required: falseThe type of encryption the cluster’s endpoint should support. Values are:
-
NONE
for no encryption -
TLS
for Transport Layer Security
-
- On success, responds with
CreateClusterOutput
with field(s):cluster(Option<Cluster>)
:A description of the DAX cluster that you have created.
- On failure, responds with
SdkError<CreateClusterError>
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 to apply to all of the clusters in this replication group.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description of the parameter group.
- On success, responds with
CreateParameterGroupOutput
with field(s):parameter_group(Option<ParameterGroup>)
:Represents the output of a CreateParameterGroup action.
- On failure, responds with
SdkError<CreateParameterGroupError>
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: trueA name for the subnet group. This value is stored as a lowercase string.
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.
- On success, responds with
CreateSubnetGroupOutput
with field(s):subnet_group(Option<SubnetGroup>)
:Represents the output of a CreateSubnetGroup operation.
- On failure, responds with
SdkError<CreateSubnetGroupError>
Source§impl Client
impl Client
Sourcepub fn decrease_replication_factor(
&self,
) -> DecreaseReplicationFactorFluentBuilder
pub fn decrease_replication_factor( &self, ) -> DecreaseReplicationFactorFluentBuilder
Constructs a fluent builder for the DecreaseReplicationFactor
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the DAX cluster from which you want to remove nodes.
new_replication_factor(i32)
/set_new_replication_factor(Option<i32>)
:
required: trueThe new number of nodes for the DAX cluster.
availability_zones(impl Into<String>)
/set_availability_zones(Option<Vec::<String>>)
:
required: falseThe Availability Zone(s) from which to remove nodes.
node_ids_to_remove(impl Into<String>)
/set_node_ids_to_remove(Option<Vec::<String>>)
:
required: falseThe unique identifiers of the nodes to be removed from the cluster.
- On success, responds with
DecreaseReplicationFactorOutput
with field(s):cluster(Option<Cluster>)
:A description of the DAX cluster, after you have decreased its replication factor.
- On failure, responds with
SdkError<DecreaseReplicationFactorError>
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.
- On success, responds with
DeleteClusterOutput
with field(s):cluster(Option<Cluster>)
:A description of the DAX cluster that is being deleted.
- On failure, responds with
SdkError<DeleteClusterError>
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):deletion_message(Option<String>)
:A user-specified message for this action (i.e., a reason for deleting the parameter group).
- On failure, responds with
SdkError<DeleteParameterGroupError>
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):deletion_message(Option<String>)
:A user-specified message for this action (i.e., a reason for deleting the subnet group).
- On failure, responds with
SdkError<DeleteSubnetGroupError>
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.
- The fluent builder is configurable:
cluster_names(impl Into<String>)
/set_cluster_names(Option<Vec::<String>>)
:
required: falseThe names of the DAX clusters being described.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of results to include in the response. If more results exist than the specified
MaxResults
value, a token is included in the response so that the remaining results can be retrieved.The value for
MaxResults
must be between 20 and 100.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by
MaxResults
.
- On success, responds with
DescribeClustersOutput
with field(s):next_token(Option<String>)
:Provides an identifier to allow retrieval of paginated results.
clusters(Option<Vec::<Cluster>>)
:The descriptions of your DAX clusters, in response to a DescribeClusters request.
- On failure, responds with
SdkError<DescribeClustersError>
Source§impl Client
impl Client
Sourcepub fn describe_default_parameters(
&self,
) -> DescribeDefaultParametersFluentBuilder
pub fn describe_default_parameters( &self, ) -> DescribeDefaultParametersFluentBuilder
Constructs a fluent builder for the DescribeDefaultParameters
operation.
- The fluent builder is configurable:
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of results to include in the response. If more results exist than the specified
MaxResults
value, a token is included in the response so that the remaining results can be retrieved.The value for
MaxResults
must be between 20 and 100.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by
MaxResults
.
- On success, responds with
DescribeDefaultParametersOutput
with field(s):next_token(Option<String>)
:Provides an identifier to allow retrieval of paginated results.
parameters(Option<Vec::<Parameter>>)
:A list of parameters. Each element in the list represents one parameter.
- On failure, responds with
SdkError<DescribeDefaultParametersError>
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.
- 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 will be returned. If not specified, then 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.
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.
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 results to include in the response. If more results exist than the specified
MaxResults
value, a token is included in the response so that the remaining results can be retrieved.The value for
MaxResults
must be between 20 and 100.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by
MaxResults
.
- On success, responds with
DescribeEventsOutput
with field(s):next_token(Option<String>)
:Provides an identifier to allow retrieval of paginated results.
events(Option<Vec::<Event>>)
:An array of events. Each element in the array represents one event.
- On failure, responds with
SdkError<DescribeEventsError>
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.
- The fluent builder is configurable:
parameter_group_names(impl Into<String>)
/set_parameter_group_names(Option<Vec::<String>>)
:
required: falseThe names of the parameter groups.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of results to include in the response. If more results exist than the specified
MaxResults
value, a token is included in the response so that the remaining results can be retrieved.The value for
MaxResults
must be between 20 and 100.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by
MaxResults
.
- On success, responds with
DescribeParameterGroupsOutput
with field(s):next_token(Option<String>)
:Provides an identifier to allow retrieval of paginated results.
parameter_groups(Option<Vec::<ParameterGroup>>)
:An array of parameter groups. Each element in the array represents 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.
- The fluent builder is configurable:
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: trueThe name of the parameter group.
source(impl Into<String>)
/set_source(Option<String>)
:
required: falseHow the parameter is defined. For example,
system
denotes a system-defined parameter.max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of results to include in the response. If more results exist than the specified
MaxResults
value, a token is included in the response so that the remaining results can be retrieved.The value for
MaxResults
must be between 20 and 100.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by
MaxResults
.
- On success, responds with
DescribeParametersOutput
with field(s):next_token(Option<String>)
:Provides an identifier to allow retrieval of paginated results.
parameters(Option<Vec::<Parameter>>)
:A list of parameters within a parameter group. Each element in the list represents one parameter.
- On failure, responds with
SdkError<DescribeParametersError>
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.
- The fluent builder is configurable:
subnet_group_names(impl Into<String>)
/set_subnet_group_names(Option<Vec::<String>>)
:
required: falseThe name of the subnet group.
max_results(i32)
/set_max_results(Option<i32>)
:
required: falseThe maximum number of results to include in the response. If more results exist than the specified
MaxResults
value, a token is included in the response so that the remaining results can be retrieved.The value for
MaxResults
must be between 20 and 100.next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by
MaxResults
.
- On success, responds with
DescribeSubnetGroupsOutput
with field(s):next_token(Option<String>)
:Provides an identifier to allow retrieval of paginated results.
subnet_groups(Option<Vec::<SubnetGroup>>)
:An array of subnet groups. Each element in the array represents a single subnet group.
- On failure, responds with
SdkError<DescribeSubnetGroupsError>
Source§impl Client
impl Client
Sourcepub fn increase_replication_factor(
&self,
) -> IncreaseReplicationFactorFluentBuilder
pub fn increase_replication_factor( &self, ) -> IncreaseReplicationFactorFluentBuilder
Constructs a fluent builder for the IncreaseReplicationFactor
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the DAX cluster that will receive additional nodes.
new_replication_factor(i32)
/set_new_replication_factor(Option<i32>)
:
required: trueThe new number of nodes for the DAX cluster.
availability_zones(impl Into<String>)
/set_availability_zones(Option<Vec::<String>>)
:
required: falseThe Availability Zones (AZs) in which the cluster nodes will be created. All nodes belonging to the cluster are placed in these Availability Zones. Use this parameter if you want to distribute the nodes across multiple AZs.
- On success, responds with
IncreaseReplicationFactorOutput
with field(s):cluster(Option<Cluster>)
:A description of the DAX cluster. with its new replication factor.
- On failure, responds with
SdkError<IncreaseReplicationFactorError>
Source§impl Client
impl Client
Constructs a fluent builder for the ListTags
operation.
- The fluent builder is configurable:
resource_name(impl Into<String>)
/set_resource_name(Option<String>)
:
required: trueThe name of the DAX resource to which the tags belong.
next_token(impl Into<String>)
/set_next_token(Option<String>)
:
required: falseAn optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token.
- On success, responds with
ListTagsOutput
with field(s):tags(Option<Vec::<Tag>>)
:A list of tags currently associated with the DAX cluster.
next_token(Option<String>)
:If this value is present, there are additional results to be displayed. To retrieve them, call
ListTags
again, withNextToken
set to this value.
- On failure, responds with
SdkError<ListTagsError>
Source§impl Client
impl Client
Sourcepub fn reboot_node(&self) -> RebootNodeFluentBuilder
pub fn reboot_node(&self) -> RebootNodeFluentBuilder
Constructs a fluent builder for the RebootNode
operation.
- The fluent builder is configurable:
cluster_name(impl Into<String>)
/set_cluster_name(Option<String>)
:
required: trueThe name of the DAX cluster containing the node to be rebooted.
node_id(impl Into<String>)
/set_node_id(Option<String>)
:
required: trueThe system-assigned ID of the node to be rebooted.
- On success, responds with
RebootNodeOutput
with field(s):cluster(Option<Cluster>)
:A description of the DAX cluster after a node has been rebooted.
- On failure, responds with
SdkError<RebootNodeError>
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_name(impl Into<String>)
/set_resource_name(Option<String>)
:
required: trueThe name of the DAX resource to which tags should be added.
tags(Tag)
/set_tags(Option<Vec::<Tag>>)
:
required: trueThe tags to be assigned to the DAX resource.
- On success, responds with
TagResourceOutput
with field(s):tags(Option<Vec::<Tag>>)
:The list of tags that are associated with the DAX resource.
- 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_name(impl Into<String>)
/set_resource_name(Option<String>)
:
required: trueThe name of the DAX resource from which the tags should be removed.
tag_keys(impl Into<String>)
/set_tag_keys(Option<Vec::<String>>)
:
required: trueA list of tag keys. If the DAX cluster has any tags with these keys, then the tags are removed from the cluster.
- On success, responds with
UntagResourceOutput
with field(s):tags(Option<Vec::<Tag>>)
:The tag keys that have been removed from the cluster.
- On failure, responds with
SdkError<UntagResourceError>
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 DAX cluster to be modified.
description(impl Into<String>)
/set_description(Option<String>)
:
required: falseA description of the changes being made to the cluster.
preferred_maintenance_window(impl Into<String>)
/set_preferred_maintenance_window(Option<String>)
:
required: falseA range of time when maintenance of DAX cluster software will be performed. For example:
sun:01:00-sun:09:00
. Cluster maintenance normally takes less than 30 minutes, and is performed automatically within the maintenance window.notification_topic_arn(impl Into<String>)
/set_notification_topic_arn(Option<String>)
:
required: falseThe Amazon Resource Name (ARN) that identifies the topic.
notification_topic_status(impl Into<String>)
/set_notification_topic_status(Option<String>)
:
required: falseThe current state of the topic. A value of “active” means that notifications will be sent to the topic. A value of “inactive” means that notifications will not be sent to the topic.
parameter_group_name(impl Into<String>)
/set_parameter_group_name(Option<String>)
:
required: falseThe name of a parameter group for this cluster.
security_group_ids(impl Into<String>)
/set_security_group_ids(Option<Vec::<String>>)
:
required: falseA list of user-specified security group IDs to be assigned to each node in the DAX cluster. If this parameter is not specified, DAX assigns the default VPC security group to each node.
- On success, responds with
UpdateClusterOutput
with field(s):cluster(Option<Cluster>)
:A description of the DAX cluster, after it has been modified.
- On failure, responds with
SdkError<UpdateClusterError>
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.
parameter_name_values(ParameterNameValue)
/set_parameter_name_values(Option<Vec::<ParameterNameValue>>)
:
required: trueAn array of name-value pairs for the parameters in the group. Each element in the array represents a single parameter.
record-ttl-millis
andquery-ttl-millis
are the only supported parameter names. For more details, see Configuring TTL Settings.
- On success, responds with
UpdateParameterGroupOutput
with field(s):parameter_group(Option<ParameterGroup>)
:The parameter group that has been modified.
- 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: falseA list of subnet IDs in the subnet group.
- On success, responds with
UpdateSubnetGroupOutput
with field(s):subnet_group(Option<SubnetGroup>)
:The subnet group that has been modified.
- On failure, responds with
SdkError<UpdateSubnetGroupError>
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>
Returns self
with the
fg()
set to
Color::BrightBlack
.
§Example
println!("{}", value.bright_black());
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>
Returns self
with the
fg()
set to
Color::BrightGreen
.
§Example
println!("{}", value.bright_green());
Source§fn bright_yellow(&self) -> Painted<&T>
fn bright_yellow(&self) -> Painted<&T>
Returns self
with the
fg()
set to
Color::BrightYellow
.
§Example
println!("{}", value.bright_yellow());
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>
Returns self
with the
fg()
set to
Color::BrightMagenta
.
§Example
println!("{}", value.bright_magenta());
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>
Returns self
with the
fg()
set to
Color::BrightWhite
.
§Example
println!("{}", value.bright_white());
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>
Returns self
with the
bg()
set to
Color::BrightBlack
.
§Example
println!("{}", value.on_bright_black());
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>
Returns self
with the
bg()
set to
Color::BrightGreen
.
§Example
println!("{}", value.on_bright_green());
Source§fn on_bright_yellow(&self) -> Painted<&T>
fn on_bright_yellow(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightYellow
.
§Example
println!("{}", value.on_bright_yellow());
Source§fn on_bright_blue(&self) -> Painted<&T>
fn on_bright_blue(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightBlue
.
§Example
println!("{}", value.on_bright_blue());
Source§fn on_bright_magenta(&self) -> Painted<&T>
fn on_bright_magenta(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightMagenta
.
§Example
println!("{}", value.on_bright_magenta());
Source§fn on_bright_cyan(&self) -> Painted<&T>
fn on_bright_cyan(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightCyan
.
§Example
println!("{}", value.on_bright_cyan());
Source§fn on_bright_white(&self) -> Painted<&T>
fn on_bright_white(&self) -> Painted<&T>
Returns self
with the
bg()
set to
Color::BrightWhite
.
§Example
println!("{}", value.on_bright_white());
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 underline(&self) -> Painted<&T>
fn underline(&self) -> Painted<&T>
Returns self
with the
attr()
set to
Attribute::Underline
.
§Example
println!("{}", value.underline());
Source§fn rapid_blink(&self) -> Painted<&T>
fn rapid_blink(&self) -> Painted<&T>
Returns self
with the
attr()
set to
Attribute::RapidBlink
.
§Example
println!("{}", value.rapid_blink());
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);