aws_sdk_elasticache/client/
describe_cache_engine_versions.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`DescribeCacheEngineVersions`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder) operation.
4    /// This operation supports pagination; See [`into_paginator()`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::into_paginator).
5    ///
6    /// - The fluent builder is configurable:
7    ///   - [`engine(impl Into<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::engine) / [`set_engine(Option<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::set_engine):<br>required: **false**<br><p>The cache engine to return. Valid values: <code>memcached</code> | <code>redis</code></p><br>
8    ///   - [`engine_version(impl Into<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::engine_version) / [`set_engine_version(Option<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::set_engine_version):<br>required: **false**<br><p>The cache engine version to return.</p> <p>Example: <code>1.4.14</code></p><br>
9    ///   - [`cache_parameter_group_family(impl Into<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::cache_parameter_group_family) / [`set_cache_parameter_group_family(Option<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::set_cache_parameter_group_family):<br>required: **false**<br><p>The name of a specific cache parameter group family to return details for.</p> <p>Valid values are: <code>memcached1.4</code> | <code>memcached1.5</code> | <code>memcached1.6</code> | <code>redis2.6</code> | <code>redis2.8</code> | <code>redis3.2</code> | <code>redis4.0</code> | <code>redis5.0</code> | <code>redis6.x</code> | <code>redis6.2</code> | <code>redis7</code> | <code>valkey7</code></p> <p>Constraints:</p> <ul>  <li>   <p>Must be 1 to 255 alphanumeric characters</p></li>  <li>   <p>First character must be a letter</p></li>  <li>   <p>Cannot end with a hyphen or contain two consecutive hyphens</p></li> </ul><br>
10    ///   - [`max_records(i32)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::max_records) / [`set_max_records(Option<i32>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::set_max_records):<br>required: **false**<br><p>The maximum number of records to include in the response. If more records exist than the specified <code>MaxRecords</code> value, a marker is included in the response so that the remaining results can be retrieved.</p> <p>Default: 100</p> <p>Constraints: minimum 20; maximum 100.</p><br>
11    ///   - [`marker(impl Into<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::marker) / [`set_marker(Option<String>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::set_marker):<br>required: **false**<br><p>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 <code>MaxRecords</code>.</p><br>
12    ///   - [`default_only(bool)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::default_only) / [`set_default_only(Option<bool>)`](crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::set_default_only):<br>required: **false**<br><p>If <code>true</code>, specifies that only the default version of the specified engine or engine and major version combination is to be returned.</p><br>
13    /// - On success, responds with [`DescribeCacheEngineVersionsOutput`](crate::operation::describe_cache_engine_versions::DescribeCacheEngineVersionsOutput) with field(s):
14    ///   - [`marker(Option<String>)`](crate::operation::describe_cache_engine_versions::DescribeCacheEngineVersionsOutput::marker): <p>Provides an identifier to allow retrieval of paginated results.</p>
15    ///   - [`cache_engine_versions(Option<Vec::<CacheEngineVersion>>)`](crate::operation::describe_cache_engine_versions::DescribeCacheEngineVersionsOutput::cache_engine_versions): <p>A list of cache engine version details. Each element in the list contains detailed information about one cache engine version.</p>
16    /// - On failure, responds with [`SdkError<DescribeCacheEngineVersionsError>`](crate::operation::describe_cache_engine_versions::DescribeCacheEngineVersionsError)
17    pub fn describe_cache_engine_versions(
18        &self,
19    ) -> crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder {
20        crate::operation::describe_cache_engine_versions::builders::DescribeCacheEngineVersionsFluentBuilder::new(self.handle.clone())
21    }
22}