aws_sdk_rds/client/
describe_reserved_db_instances.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`DescribeReservedDBInstances`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder) operation.
    /// This operation supports pagination; See [`into_paginator()`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::into_paginator).
    ///
    /// - The fluent builder is configurable:
    ///   - [`reserved_db_instance_id(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::reserved_db_instance_id) / [`set_reserved_db_instance_id(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_reserved_db_instance_id):<br>required: **false**<br><p>The reserved DB instance identifier filter value. Specify this parameter to show only the reservation that matches the specified reservation ID.</p><br>
    ///   - [`reserved_db_instances_offering_id(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::reserved_db_instances_offering_id) / [`set_reserved_db_instances_offering_id(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_reserved_db_instances_offering_id):<br>required: **false**<br><p>The offering identifier filter value. Specify this parameter to show only purchased reservations matching the specified offering identifier.</p><br>
    ///   - [`db_instance_class(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::db_instance_class) / [`set_db_instance_class(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_db_instance_class):<br>required: **false**<br><p>The DB instance class filter value. Specify this parameter to show only those reservations matching the specified DB instances class.</p><br>
    ///   - [`duration(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::duration) / [`set_duration(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_duration):<br>required: **false**<br><p>The duration filter value, specified in years or seconds. Specify this parameter to show only reservations for this duration.</p> <p>Valid Values: <code>1 | 3 | 31536000 | 94608000</code></p><br>
    ///   - [`product_description(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::product_description) / [`set_product_description(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_product_description):<br>required: **false**<br><p>The product description filter value. Specify this parameter to show only those reservations matching the specified product description.</p><br>
    ///   - [`offering_type(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::offering_type) / [`set_offering_type(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_offering_type):<br>required: **false**<br><p>The offering type filter value. Specify this parameter to show only the available offerings matching the specified offering type.</p> <p>Valid Values: <code>"Partial Upfront" | "All Upfront" | "No Upfront" </code></p><br>
    ///   - [`multi_az(bool)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::multi_az) / [`set_multi_az(Option<bool>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_multi_az):<br>required: **false**<br><p>Specifies whether to show only those reservations that support Multi-AZ.</p><br>
    ///   - [`lease_id(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::lease_id) / [`set_lease_id(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_lease_id):<br>required: **false**<br><p>The lease identifier filter value. Specify this parameter to show only the reservation that matches the specified lease ID.</p><note>  <p>Amazon Web Services Support might request the lease ID for an issue related to a reserved DB instance.</p> </note><br>
    ///   - [`filters(Filter)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::filters) / [`set_filters(Option<Vec::<Filter>>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_filters):<br>required: **false**<br><p>This parameter isn't currently supported.</p><br>
    ///   - [`max_records(i32)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::max_records) / [`set_max_records(Option<i32>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_max_records):<br>required: **false**<br><p>The maximum number of records to include in the response. If more than the <code>MaxRecords</code> value is available, a pagination token called a marker is included in the response so you can retrieve the remaining results.</p> <p>Default: 100</p> <p>Constraints: Minimum 20, maximum 100.</p><br>
    ///   - [`marker(impl Into<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::marker) / [`set_marker(Option<String>)`](crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::set_marker):<br>required: **false**<br><p>An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by <code>MaxRecords</code>.</p><br>
    /// - On success, responds with [`DescribeReservedDbInstancesOutput`](crate::operation::describe_reserved_db_instances::DescribeReservedDbInstancesOutput) with field(s):
    ///   - [`marker(Option<String>)`](crate::operation::describe_reserved_db_instances::DescribeReservedDbInstancesOutput::marker): <p>An optional pagination token provided by a previous request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by <code>MaxRecords</code>.</p>
    ///   - [`reserved_db_instances(Option<Vec::<ReservedDbInstance>>)`](crate::operation::describe_reserved_db_instances::DescribeReservedDbInstancesOutput::reserved_db_instances): <p>A list of reserved DB instances.</p>
    /// - On failure, responds with [`SdkError<DescribeReservedDBInstancesError>`](crate::operation::describe_reserved_db_instances::DescribeReservedDBInstancesError)
    pub fn describe_reserved_db_instances(
        &self,
    ) -> crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder {
        crate::operation::describe_reserved_db_instances::builders::DescribeReservedDBInstancesFluentBuilder::new(self.handle.clone())
    }
}