Exemplos do AWS IoT data usando oAWS CLI - AWS Command Line Interface
Ações

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.

Exemplos do AWS IoT data usando oAWS CLI

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 chamado MyRPi.

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 arquivo output.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.