Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS IoT data.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
Tópicos
Ações
O código de exemplo a seguir mostra como usar delete-thing-shadow
.
- AWS CLI
-
Para excluir um documento de sombra do dispositivo
O exemplo
delete-thing-shadow
a seguir exclui todo o documento de sombra do dispositivo chamadoMyRPi
.aws iot-data delete-thing-shadow \ --thing-name
MyRPi
\"output.txt"
O comando não produz saída na tela, mas
output.txt
contém informações que confirmam a versão e a data e hora da do documento de sombra excluído.{"version":2,"timestamp":1560270384}
Para obter mais informações, consulte Usar sombras no Guia do desenvolvedor da AWS IoT.
-
Para ver detalhes da API, consulte DeleteThingShadow
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-thing-shadow
.
- AWS CLI
-
Para obter um documento de sombra de item
O exemplo
get-thing-shadow
a seguir obtém o documento de sombra do item para o item IoT especificado.aws iot-data get-thing-shadow \ --thing-name
MyRPi
\output.txt
O comando não produz nenhuma saída na tela, mas o seguinte mostra o conteúdo de
output.txt
:{ "state":{ "reported":{ "moisture":"low" } }, "metadata":{ "reported":{ "moisture":{ "timestamp":1560269319 } } }, "version":1,"timestamp":1560269405 }
Para obter mais informações, consulte Fluxo de dados da sombra do dispositivo no Guia do desenvolvedor da AWS IoT.
-
Para ver detalhes da API, consulte GetThingShadow
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar update-thing-shadow
.
- AWS CLI
-
Para atualizar uma sombra de item
O exemplo
update-thing-shadow
a seguir modifica o estado atual da sombra do dispositivo para o item especificado e o salva no arquivooutput.txt
.aws iot-data update-thing-shadow \ --thing-name
MyRPi
\ --payload "{"state":{"reported":{"moisture":"okay"}}}" \"output.txt"
O comando não produz nenhuma saída na tela, mas o seguinte mostra o conteúdo de
output.txt
:{ "state": { "reported": { "moisture": "okay" } }, "metadata": { "reported": { "moisture": { "timestamp": 1560270036 } } }, "version": 2, "timestamp": 1560270036 }
Para obter mais informações, consulte Fluxo de dados da sombra do dispositivo no Guia do desenvolvedor da AWS IoT.
-
Para ver detalhes da API, consulte UpdateThingShadow
na Referência de comandos da AWS CLI.
-