Creación de un destino para el dispositivo de Sidewalk - AWS IoT Wireless
Creación de un destino (consola)Creación de un destino (CLI)

Creación de un destino para el dispositivo de Sidewalk

Puede añadir un destino a la cuenta de AWS IoT Core para Amazon Sidewalk mediante el Centro de destinos o utilizando CreateDestination. Al crear el destino, especifique:

  • Un nombre único para el destino que se utilizará en el dispositivo final de Sidewalk.

    nota

    Si ya agregó el dispositivo con un nombre de destino, debe usar ese nombre al crear el destino. Para obtener más información, consulte Paso 2: Agregación del dispositivo de Sidewalk.

  • El nombre de la regla de AWS IoT que procesará los datos del dispositivo y el tema en el que se publicarán los mensajes.

  • Un rol de IAM que concede a los datos del dispositivo el permiso para acceder a la regla.

A continuación, se muestra cómo crear la regla de AWS IoT y el rol de IAM para el destino.

Creación de un destino (consola)

Para crear un destino mediante la consola de AWS IoT, vaya al Centro de destinos y elija Agregar destino.

Para procesar los datos de un dispositivo, especifique los siguientes campos al crear un destino y, a continuación, elija Agregar destino.

  • Detalles de destino

    Introduzca un Nombre de destino y una descripción opcional para su destino.

  • Nombre de la regla

    La regla de AWS IoT que se configura para evaluar los mensajes enviados por el dispositivo y procesar los datos del dispositivo. El nombre de la regla se asignará a su destino. El destino requiere que la regla procese los mensajes que recibe. Puede elegir que los mensajes se procesen invocando una regla de AWS IoT o publicándolos en el agente de mensajes de AWS IoT.

    • Si selecciona Introducir un nombre de regla, introduzca un nombre y, a continuación, elija Copiar para copiar el nombre de la regla que introducirá al crear la regla de AWS IoT. Puede elegir Crear regla para crear la regla ahora o ir al Centro de reglas de la consola de AWS IoT y crear una regla con ese nombre.

      También puede introducir una regla y usar la configuración Avanzada para especificar el nombre de un tema. El nombre del tema se proporciona durante la invocación de la regla y se accede a él mediante la expresión topic incluida en la regla. Para obtener más información sobre las reglas de AWS IoT, consulte Reglas de AWS IoT.

    • Si elige Publicar en el agente de mensajes de AWS IoT, introduzca el nombre del tema. A continuación, puede copiar el nombre del tema de MQTT y varios suscriptores podrán suscribirse a este tema para recibir los mensajes publicados sobre ese tema. Para obtener más información, consulte Temas de MQTT.

    Para obtener más información sobre las reglas de AWS IoT para los destinos, consulte Creación de reglas para procesar mensajes de dispositivos LoRaWAN.

  • Nombre de rol

    El rol de IAM que concede a los datos del dispositivo el permiso para acceder a la regla nombrada Nombre de regla. En la consola, elija un rol de servicio existente o cree uno nuevo. Si va a crear un nuevo rol de servicio, puede introducir un nombre de rol (por ejemplo, SidewalkDestinationRole) o dejarlo en blanco para que AWS IoT Core para LoRaWAN genere un nuevo nombre de rol. AWS IoT Core para LoRaWAN creará automáticamente el rol de IAM con los permisos adecuados en su nombre.

Creación de un destino (CLI)

Para crear un destino, utilice la operación CreateDestination de la API o el comando create-destination de la CLI. Por ejemplo, el comando siguiente crea un destino para su dispositivo final de Sidewalk:

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

La ejecución de este comando devuelve los detalles del destino, que incluyen el nombre de recurso de Amazon (ARN) y el nombre del destino.

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

Para obtener más información sobre crear un destino, consulte Creación de reglas para procesar mensajes de dispositivos LoRaWAN.