Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . iot-data ]



Gets the thing shadow for the specified thing.

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

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


The default endpoint data.iot.[region] is intended for testing purposes only. For production code it is strongly recommended to use the custom endpoint for your account (retrievable via the iot describe-endpoint command) to ensure best availability and reachability of the service.


--thing-name <value>
outfile <value>


--thing-name (string)

The name of the thing.

outfile (string) Filename where the content will be saved

See 'aws help' for descriptions of global parameters.


To get the current state of a device shadow

The following get-thing-shadow example gets the current state of the device shadow for the thing named MyRPi and saves it to the file output.txt.

aws iot-data get-thing-shadow \
    --thing-name MyRPi \

The command produces no output on the display, but the following shows the contents of output.txt:


For more information, see Device Shadow Service Data Flow in the AWS IoT Developers Guide.


payload -> (blob)

The state information, in JSON format.