Criar um destino para seu dispositivo do Sidewalk - AWS IoT Wireless
Criar um destino (console)Criar um destino (CLI)

Criar um destino para seu dispositivo do Sidewalk

É possível adicionar um destino à sua conta para o AWS IoT Core para Amazon Sidewalk utilizando o Hub de destinos ou CreateDestination. Ao criar seu destino, especifique:

  • Um nome exclusivo para o destino a ser usado no dispositivo final do Sidewalk.

    nota

    Se você já adicionou o dispositivo usando um nome de destino, será preciso usar esse nome ao criar seu destino. Para ter mais informações, consulte Etapa 2: Adicionar o dispositivo do Sidewalk.

  • O nome da regra de AWS IoT que processará os dados do dispositivo e o tópico no qual as mensagens serão publicadas.

  • Um perfil do IAM que conceda permissões de dados do dispositivo para o acesso à regra.

As seções a seguir descrevem como criar a regra de AWS IoT e um perfil do IAM para o destino.

Criar um destino (console)

Para criar um destino usando o console de AWS IoT, acesse o Hub de destinos e escolha Adicionar destino.

Para processar os dados de um dispositivo, especifique os seguintes campos ao criar um destino e escolha Adicionar destino.

  • Detalhes do destino

    Insira um Nome de destino e uma descrição opcional para o destino.

  • Nome da regra

    A regra de AWS IoT configurada para avaliar as mensagens enviadas pelo seu dispositivo e processar os dados do dispositivo. O nome da regra será mapeado para o seu destino. O destino exige que a regra processe as mensagens recebidas. Você pode escolher que as mensagens sejam processadas invocando uma regra de AWS IoT ou publicando no agente de mensagens de AWS IoT.

    • Se você escolher Inserir um nome de regra, digite um nome e escolha Copiar para copiar o nome da regra que você inserirá ao criar a regra de AWS IoT. Você pode escolher Criar regra para criar a regra agora ou navegar até o Hub de regras do console de AWS IoT e criar uma regra com esse nome.

      Você também pode inserir uma regra e usar a configuração Avançada para especificar um nome de tópico. O nome do tópico é fornecido durante a invocação da regra e é acessado usando a expressão topic dentro da regra. Para obter mais informações sobre as regras de AWS IoT, consulte regras de AWS IoT.

    • Se você escolher Publicar no agente de mensagens de AWS IoT, insira um nome de tópico. Em seguida, você pode copiar o nome do tópico de MQTT e vários assinantes podem se inscrever nesse tópico para receber mensagens publicadas nesse tópico. Para ver mais informações, consulte tópicos de MQTT.

    Para obter mais informações sobre as regras de AWS IoT para destinos, consulte Criar regras para processar mensagens do dispositivo LoRaWAN.

  • Nome do perfil

    O perfil do IAM que concede permissões de dados do dispositivo para o acesso à regra, nomeada em Nome da regra. No console, é possível criar um novo perfil de serviço ou selecionar um já existente. Se você estiver criando um novo perfil de serviço, poderá inserir um nome de perfil (por exemplo, SidewalkDestinationRole) ou deixá-lo em branco para AWS IoT Core for LoRaWAN para gerar um novo nome de perfil. O AWS IoT Core for LoRaWAN, então, criará automaticamente o perfil do IAM com as devidas permissões em seu nome.

Criar um destino (CLI)

Para criar um destino, use a operação da API CreateDestination ou o comando da CLI create-destination. Por exemplo, o comando a seguir cria um destino para o dispositivo final do Sidewalk:

aws iotwireless create-destination --name SidewalkDestination \
    --expression-type RuleName --expression SidewalkRule \
    --role-arn arn:aws:iam::123456789012:role/SidewalkRole

A execução desse comando retorna os detalhes do destino, que incluem o nome do recurso da Amazon (ARN) e o nome do destino.

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:Destination/SidewalkDestination",
    "Name": "SidewalkDestination"
}

Para obter mais informações sobre a criação de um destino, consulte Criar regras para processar mensagens do dispositivo LoRaWAN.