Package software.amazon.awssdk.services.iotdataplane

Interface IoTDataPlaneAsyncClient

All Superinterfaces:

AutoCloseable

@Generated("software.amazon.awssdk:codegen")
public interface IoTDataPlaneAsyncClient
extends AutoCloseable

Service client for accessing null asynchronously. This can be created using the static builder() method. AWS IoT

AWS IoT-Data enables secure, bi-directional communication between Internet-connected things (such as sensors, actuators, embedded devices, or smart appliances) and the AWS cloud. It implements a broker for applications and things to publish messages over HTTP (Publish) and retrieve, update, and delete thing shadows. A thing shadow is a persistent representation of your things and their state in the AWS cloud.

Method Summary

Modifier and Type	Method	Description
static IoTDataPlaneAsyncClientBuilder	builder()	Create a builder that can be used to configure and create a IoTDataPlaneAsyncClient.
static IoTDataPlaneAsyncClient	create()	Create a IoTDataPlaneAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CompletableFuture<DeleteThingShadowResponse>	deleteThingShadow(DeleteThingShadowRequest deleteThingShadowRequest)	Deletes the thing shadow for the specified thing.
default CompletableFuture<GetThingShadowResponse>	getThingShadow(GetThingShadowRequest getThingShadowRequest)	Gets the thing shadow for the specified thing.
default CompletableFuture<PublishResponse>	publish(PublishRequest publishRequest)	Publishes state information.
default CompletableFuture<UpdateThingShadowResponse>	updateThingShadow(UpdateThingShadowRequest updateThingShadowRequest)	Updates the thing shadow for the specified thing.

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

create

static IoTDataPlaneAsyncClient create()

Create a IoTDataPlaneAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static IoTDataPlaneAsyncClientBuilder builder()

Create a builder that can be used to configure and create a IoTDataPlaneAsyncClient.

deleteThingShadow

default CompletableFuture<DeleteThingShadowResponse> deleteThingShadow(DeleteThingShadowRequest deleteThingShadowRequest)

Deletes the thing shadow for the specified thing.

For more information, see DeleteThingShadow in the AWS IoT Developer Guide.

Parameters:

deleteThingShadowRequest - The input for the DeleteThingShadow operation.

Returns:

A Java Future containing the result of the DeleteThingShadow operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• ResourceNotFoundException The specified resource does not exist.
• InvalidRequestException The request is not valid.
• ThrottlingException The rate exceeds the limit.
• UnauthorizedException You are not authorized to perform this operation.
• ServiceUnavailableException The service is temporarily unavailable.
• InternalFailureException An unexpected error has occurred.
• MethodNotAllowedException The specified combination of HTTP verb and URI is not supported.
• UnsupportedDocumentEncodingException The document encoding is not supported.
• SdkBaseException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc
• IoTDataPlaneException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this

getThingShadow

default CompletableFuture<GetThingShadowResponse> getThingShadow(GetThingShadowRequest getThingShadowRequest)

Gets the thing shadow for the specified thing.

For more information, see GetThingShadow in the AWS IoT Developer Guide.

Parameters:

getThingShadowRequest - The input for the GetThingShadow operation.

Returns:

A Java Future containing the result of the GetThingShadow operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• InvalidRequestException The request is not valid.
• ResourceNotFoundException The specified resource does not exist.
• ThrottlingException The rate exceeds the limit.
• UnauthorizedException You are not authorized to perform this operation.
• ServiceUnavailableException The service is temporarily unavailable.
• InternalFailureException An unexpected error has occurred.
• MethodNotAllowedException The specified combination of HTTP verb and URI is not supported.
• UnsupportedDocumentEncodingException The document encoding is not supported.
• SdkBaseException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc
• IoTDataPlaneException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this

publish

default CompletableFuture<PublishResponse> publish(PublishRequest publishRequest)

Publishes state information.

For more information, see HTTP Protocol in the AWS IoT Developer Guide.

Parameters:

publishRequest - The input for the Publish operation.

Returns:

A Java Future containing the result of the Publish operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• InternalFailureException An unexpected error has occurred.
• InvalidRequestException The request is not valid.
• UnauthorizedException You are not authorized to perform this operation.
• MethodNotAllowedException The specified combination of HTTP verb and URI is not supported.
• SdkBaseException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc
• IoTDataPlaneException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this

updateThingShadow

default CompletableFuture<UpdateThingShadowResponse> updateThingShadow(UpdateThingShadowRequest updateThingShadowRequest)

Updates the thing shadow for the specified thing.

For more information, see UpdateThingShadow in the AWS IoT Developer Guide.

Parameters:

updateThingShadowRequest - The input for the UpdateThingShadow operation.

Returns:

A Java Future containing the result of the UpdateThingShadow operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• ConflictException The specified version does not match the version of the document.
• RequestEntityTooLargeException The payload exceeds the maximum size allowed.
• InvalidRequestException The request is not valid.
• ThrottlingException The rate exceeds the limit.
• UnauthorizedException You are not authorized to perform this operation.
• ServiceUnavailableException The service is temporarily unavailable.
• InternalFailureException An unexpected error has occurred.
• MethodNotAllowedException The specified combination of HTTP verb and URI is not supported.
• UnsupportedDocumentEncodingException The document encoding is not supported.
• SdkBaseException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
• SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc
• IoTDataPlaneException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this