Struct aws_sdk_iotthingsgraph::client::fluent_builders::SearchThings

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

Fluent builder constructing a request to SearchThings.

Searches for things associated with the specified entity. You can search by both device and device model.

For example, if two different devices, camera1 and camera2, implement the camera device model, the user can associate thing1 to camera1 and thing2 to camera2. SearchThings(camera2) will return only thing2, but SearchThings(camera) will return both thing1 and thing2.

This action searches for exact matches and doesn't perform partial text matching.

Implementations

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

pub async fn send(
    self
) -> Result<SearchThingsOutput, SdkError<SearchThingsError>> where
    R::Policy: SmithyRetryPolicy<SearchThingsInputOperationOutputAlias, SearchThingsOutput, SearchThingsError, SearchThingsInputOperationRetryAlias>, 

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 into_paginator(self) -> SearchThingsPaginator<C, M, R>

Create a paginator for this request

Paginators are used by calling send().await which returns a Stream.

pub fn entity_id(self, input: impl Into<String>) -> Self

The ID of the entity to which the things are associated.

The IDs should be in the following format.

urn:tdm:REGION/ACCOUNT ID/default:device:DEVICENAME

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

The ID of the entity to which the things are associated.

The IDs should be in the following format.

urn:tdm:REGION/ACCOUNT ID/default:device:DEVICENAME

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

The string that specifies the next page of results. Use this when you're paginating results.

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

The string that specifies the next page of results. Use this when you're paginating results.

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

The maximum number of results to return in the response.

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

The maximum number of results to return in the response.

pub fn namespace_version(self, input: i64) -> Self

The version of the user's namespace. Defaults to the latest version of the user's namespace.

pub fn set_namespace_version(self, input: Option<i64>) -> Self

The version of the user's namespace. Defaults to the latest version of the user's namespace.

Trait Implementations

impl<C: Clone, M: Clone, R: Clone> Clone for SearchThings<C, M, R>

fn clone(&self) -> SearchThings<C, M, R>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.