aws_sdk_wickr/client/
list_bots.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 [`ListBots`](crate::operation::list_bots::builders::ListBotsFluentBuilder) operation.
4    /// This operation supports pagination; See [`into_paginator()`](crate::operation::list_bots::builders::ListBotsFluentBuilder::into_paginator).
5    ///
6    /// - The fluent builder is configurable:
7    ///   - [`network_id(impl Into<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::network_id) / [`set_network_id(Option<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_network_id):<br>required: **true**<br><p>The ID of the Wickr network from which to list bots.</p><br>
8    ///   - [`next_token(impl Into<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::next_token) / [`set_next_token(Option<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_next_token):<br>required: **false**<br><p>The token for retrieving the next page of results. This is returned from a previous request when there are more results available.</p><br>
9    ///   - [`max_results(i32)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::max_results) / [`set_max_results(Option<i32>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_max_results):<br>required: **false**<br><p>The maximum number of bots to return in a single page. Valid range is 1-100. Default is 10.</p><br>
10    ///   - [`sort_fields(impl Into<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::sort_fields) / [`set_sort_fields(Option<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_sort_fields):<br>required: **false**<br><p>The fields to sort bots by. Multiple fields can be specified by separating them with '+'. Accepted values include 'username', 'firstName', 'displayName', 'status', and 'groupId'.</p><br>
11    ///   - [`sort_direction(SortDirection)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::sort_direction) / [`set_sort_direction(Option<SortDirection>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_sort_direction):<br>required: **false**<br><p>The direction to sort results. Valid values are 'ASC' (ascending) or 'DESC' (descending). Default is 'DESC'.</p><br>
12    ///   - [`display_name(impl Into<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::display_name) / [`set_display_name(Option<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_display_name):<br>required: **false**<br><p>Filter results to only include bots with display names matching this value.</p><br>
13    ///   - [`username(impl Into<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::username) / [`set_username(Option<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_username):<br>required: **false**<br><p>Filter results to only include bots with usernames matching this value.</p><br>
14    ///   - [`status(i32)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::status) / [`set_status(Option<i32>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_status):<br>required: **false**<br><p>Filter results to only include bots with this status (1 for pending, 2 for active).</p><br>
15    ///   - [`group_id(impl Into<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::group_id) / [`set_group_id(Option<String>)`](crate::operation::list_bots::builders::ListBotsFluentBuilder::set_group_id):<br>required: **false**<br><p>Filter results to only include bots belonging to this security group.</p><br>
16    /// - On success, responds with [`ListBotsOutput`](crate::operation::list_bots::ListBotsOutput) with field(s):
17    ///   - [`bots(Vec::<Bot>)`](crate::operation::list_bots::ListBotsOutput::bots): <p>A list of bot objects matching the specified filters and within the current page.</p>
18    ///   - [`next_token(Option<String>)`](crate::operation::list_bots::ListBotsOutput::next_token): <p>The token to use for retrieving the next page of results. If this is not present, there are no more results.</p>
19    /// - On failure, responds with [`SdkError<ListBotsError>`](crate::operation::list_bots::ListBotsError)
20    pub fn list_bots(&self) -> crate::operation::list_bots::builders::ListBotsFluentBuilder {
21        crate::operation::list_bots::builders::ListBotsFluentBuilder::new(self.handle.clone())
22    }
23}