Struct aws_sdk_iot::client::fluent_builders::CreateThing

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

Fluent builder constructing a request to CreateThing.

Creates a thing record in the registry. If this call is made multiple times using the same thing name and configuration, the call will succeed. If this call is made with the same thing name but different configuration a ResourceAlreadyExistsException is thrown.

This is a control plane operation. See Authorization for information about authorizing control plane actions.

Requires permission to access the CreateThing action.

Implementations

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

pub async fn send(self) -> Result<CreateThingOutput, SdkError<CreateThingError>> where
    R::Policy: SmithyRetryPolicy<CreateThingInputOperationOutputAlias, CreateThingOutput, CreateThingError, CreateThingInputOperationRetryAlias>, 

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 thing_name(self, inp: impl Into<String>) -> Self

The name of the thing to create.

You can't change a thing's name after you create it. To change a thing's name, you must create a new thing, give it the new name, and then delete the old thing.

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

The name of the thing to create.

You can't change a thing's name after you create it. To change a thing's name, you must create a new thing, give it the new name, and then delete the old thing.

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

The name of the thing type associated with the new thing.

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

The name of the thing type associated with the new thing.

pub fn attribute_payload(self, inp: AttributePayload) -> Self

The attribute payload, which consists of up to three name/value pairs in a JSON document. For example:

{\"attributes\":{\"string1\":\"string2\"}}

pub fn set_attribute_payload(self, input: Option<AttributePayload>) -> Self

The attribute payload, which consists of up to three name/value pairs in a JSON document. For example:

{\"attributes\":{\"string1\":\"string2\"}}

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

The name of the billing group the thing will be added to.

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

The name of the billing group the thing will be added to.

Trait Implementations

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

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

Formats the value using the given formatter.