Expand description


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 shadows. A shadow is a persistent representation of your things and their state in the AWS cloud.

Find the endpoint address for actions in the AWS IoT data plane by running this CLI command:

aws iot describe-endpoint --endpoint-type iot:Data-ATS

The service name used by AWS Signature Version 4 to sign requests is: iotdevicegateway.

If you’re using the service, you’re probably looking for IotDataClient and IotData.


The input for the DeleteThingShadow operation.

The output from the DeleteThingShadow operation.

The input for the GetThingShadow operation.

The output from the GetThingShadow operation.

A client for the AWS IoT Data Plane API.

The input for the Publish operation.

The input for the UpdateThingShadow operation.

The output from the UpdateThingShadow operation.


Errors returned by DeleteThingShadow

Errors returned by GetThingShadow

Errors returned by ListNamedShadowsForThing

Errors returned by Publish

Errors returned by UpdateThingShadow


Trait representing the capabilities of the AWS IoT Data Plane API. AWS IoT Data Plane clients implement this trait.