aws_sdk_ec2/client/
describe_availability_zones.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 [`DescribeAvailabilityZones`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder) operation.
4    ///
5    /// - The fluent builder is configurable:
6    ///   - [`zone_names(impl Into<String>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::zone_names) / [`set_zone_names(Option<Vec::<String>>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::set_zone_names):<br>required: **false**<br><p>The names of the Availability Zones, Local Zones, and Wavelength Zones.</p><br>
7    ///   - [`zone_ids(impl Into<String>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::zone_ids) / [`set_zone_ids(Option<Vec::<String>>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::set_zone_ids):<br>required: **false**<br><p>The IDs of the Availability Zones, Local Zones, and Wavelength Zones.</p><br>
8    ///   - [`all_availability_zones(bool)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::all_availability_zones) / [`set_all_availability_zones(Option<bool>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::set_all_availability_zones):<br>required: **false**<br><p>Include all Availability Zones, Local Zones, and Wavelength Zones regardless of your opt-in status.</p> <p>If you do not use this parameter, the results include only the zones for the Regions where you have chosen the option to opt in.</p><br>
9    ///   - [`dry_run(bool)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::dry_run) / [`set_dry_run(Option<bool>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::set_dry_run):<br>required: **false**<br><p>Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p><br>
10    ///   - [`filters(Filter)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::filters) / [`set_filters(Option<Vec::<Filter>>)`](crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::set_filters):<br>required: **false**<br><p>The filters.</p> <ul>  <li>   <p><code>group-long-name</code> - The long name of the zone group for the Availability Zone (for example, <code>US West (Oregon) 1</code>), the Local Zone (for example, for Zone group <code>us-west-2-lax-1</code>, it is <code>US West (Los Angeles)</code>, or the Wavelength Zone (for example, for Zone group <code>us-east-1-wl1</code>, it is <code>US East (Verizon)</code>.</p></li>  <li>   <p><code>group-name</code> - The name of the zone group for the Availability Zone (for example, <code>us-east-1-zg-1</code>), the Local Zone (for example, <code>us-west-2-lax-1</code>), or the Wavelength Zone (for example, <code>us-east-1-wl1</code>).</p></li>  <li>   <p><code>message</code> - The Zone message.</p></li>  <li>   <p><code>opt-in-status</code> - The opt-in status (<code>opted-in</code> | <code>not-opted-in</code> | <code>opt-in-not-required</code>).</p></li>  <li>   <p><code>parent-zone-id</code> - The ID of the zone that handles some of the Local Zone and Wavelength Zone control plane operations, such as API calls.</p></li>  <li>   <p><code>parent-zone-name</code> - The ID of the zone that handles some of the Local Zone and Wavelength Zone control plane operations, such as API calls.</p></li>  <li>   <p><code>region-name</code> - The name of the Region for the Zone (for example, <code>us-east-1</code>).</p></li>  <li>   <p><code>state</code> - The state of the Availability Zone, the Local Zone, or the Wavelength Zone (<code>available</code> | <code>unavailable</code> | <code>constrained</code>).</p></li>  <li>   <p><code>zone-id</code> - The ID of the Availability Zone (for example, <code>use1-az1</code>), the Local Zone (for example, <code>usw2-lax1-az1</code>), or the Wavelength Zone (for example, <code>us-east-1-wl1-bos-wlz-1</code>).</p></li>  <li>   <p><code>zone-name</code> - The name of the Availability Zone (for example, <code>us-east-1a</code>), the Local Zone (for example, <code>us-west-2-lax-1a</code>), or the Wavelength Zone (for example, <code>us-east-1-wl1-bos-wlz-1</code>).</p></li>  <li>   <p><code>zone-type</code> - The type of zone (<code>availability-zone</code> | <code>local-zone</code> | <code>wavelength-zone</code>).</p></li> </ul><br>
11    /// - On success, responds with [`DescribeAvailabilityZonesOutput`](crate::operation::describe_availability_zones::DescribeAvailabilityZonesOutput) with field(s):
12    ///   - [`availability_zones(Option<Vec::<AvailabilityZone>>)`](crate::operation::describe_availability_zones::DescribeAvailabilityZonesOutput::availability_zones): <p>Information about the Availability Zones, Local Zones, and Wavelength Zones.</p>
13    /// - On failure, responds with [`SdkError<DescribeAvailabilityZonesError>`](crate::operation::describe_availability_zones::DescribeAvailabilityZonesError)
14    pub fn describe_availability_zones(&self) -> crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder {
15        crate::operation::describe_availability_zones::builders::DescribeAvailabilityZonesFluentBuilder::new(self.handle.clone())
16    }
17}