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}