Struct aws_sdk_iot::client::fluent_builders::ListThings

pub struct ListThings<C = DynConnector, M = DefaultMiddleware, R = Standard> { /* fields omitted */ }

Fluent builder constructing a request to ListThings.

Lists your things. Use the attributeName and attributeValue parameters to filter your things. For example, calling ListThings with attributeName=Color and attributeValue=Red retrieves all things in the registry that contain an attribute Color with the value Red.

Requires permission to access the ListThings action.

You will not be charged for calling this API if an Access denied error is returned. You will also not be charged if no attributes or pagination token was provided in request and no pagination token and no results were returned.

Implementations

impl<C, M, R> ListThings<C, M, R> where
    C: SmithyConnector,
    M: SmithyMiddleware<C>,
    R: NewRequestPolicy, 

pub async fn send(self) -> Result<ListThingsOutput, SdkError<ListThingsError>> where
    R::Policy: SmithyRetryPolicy<ListThingsInputOperationOutputAlias, ListThingsOutput, ListThingsError, ListThingsInputOperationRetryAlias>, 

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn next_token(self, inp: impl Into<String>) -> Self

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

pub fn set_next_token(self, input: Option<String>) -> Self

To retrieve the next set of results, the nextToken value from a previous response; otherwise null to receive the first set of results.

pub fn max_results(self, inp: i32) -> Self

The maximum number of results to return in this operation.

pub fn set_max_results(self, input: Option<i32>) -> Self

The maximum number of results to return in this operation.

pub fn attribute_name(self, inp: impl Into<String>) -> Self

The attribute name used to search for things.

pub fn set_attribute_name(self, input: Option<String>) -> Self

The attribute name used to search for things.

pub fn attribute_value(self, inp: impl Into<String>) -> Self

The attribute value used to search for things.

pub fn set_attribute_value(self, input: Option<String>) -> Self

The attribute value used to search for things.

pub fn thing_type_name(self, inp: impl Into<String>) -> Self

The name of the thing type used to search for things.

pub fn set_thing_type_name(self, input: Option<String>) -> Self

The name of the thing type used to search for things.

pub fn use_prefix_attribute_value(self, inp: bool) -> Self

When true, the action returns the thing resources with attribute values that start with the attributeValue provided.

When false, or not present, the action returns only the thing resources with attribute values that match the entire attributeValue provided.

pub fn set_use_prefix_attribute_value(self, input: Option<bool>) -> Self

When true, the action returns the thing resources with attribute values that start with the attributeValue provided.

When false, or not present, the action returns only the thing resources with attribute values that match the entire attributeValue provided.

Trait Implementations

impl<C: Debug, M: Debug, R: Debug> Debug for ListThings<C, M, R>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.