Creazione di una destinazione per il dispositivo Sidewalk

Puoi aggiungere una destinazione all'account per AWS IoT Core per Amazon Sidewalk mediante l'hub Destinazioni o CreateDestination. Durante la creazione della destinazione, specifica:

• Un nome univoco per la destinazione da utilizzare per il dispositivo finale Sidewalk.

  Nota

  Se aggiungi già il dispositivo utilizzando un nome della destinazione, devi usare tale nome quando crei la destinazione. Per ulteriori informazioni, consultare Fase 2: Aggiunta del dispositivo Sidewalk.

• Il nome della regola AWS IoT che elabora i dati del dispositivo e l'argomento in cui vengono pubblicati i messaggi.

• Il ruolo IAM che concede l'autorizzazione ai dati del dispositivo per accedere alla regola.

Nelle sezioni seguenti viene descritto come creare la regola AWS IoT e il ruolo IAM per la destinazione.

Creazione di una destinazione (console)

Per creare una destinazione utilizzando la console AWS IoT, passa all'hub Destinazioni e scegli Aggiungi destinazione.

Per elaborare i dati di un dispositivo, specifica i seguenti campi durante la creazione di una destinazione, quindi scegli Aggiungi destinazione.

• Dettagli della destinazione

  Inserisci un Nome della destinazione e una descrizione facoltativa per la destinazione.

• Nome regola

  La regola AWS IoT configurata per valutare i messaggi inviati dal tuo dispositivo ed elaborare i dati del dispositivo. Il nome della regola verrà mappato alla tua destinazione. La destinazione richiede la regola per elaborare i messaggi ricevuti. È possibile scegliere se elaborare i messaggi richiamando una regola AWS IoT o pubblicando sul broker di messaggi AWS IoT.

  • Se scegli Ente a rule name (Inserisci il nome di una regola), inserisci un nome, e quindi scegli Copy (Copia) per copiare il nome di una regola che inserirai quando crei la regola AWS IoT. Puoi scegliere Create a rule (Crea una regola) per creare la regola ora o passare all'hub Rules (Regole) della console AWS IoT e creare una regola con quel nome.

    Puoi anche inserire una regola e utilizzare impostazione Advanced (Avanzata) per specificare un nome dell'argomento. Il nome dell'argomento viene fornito durante l'invocazione della regola e si accede utilizzando l'espressione topic all'interno della regola. Per ulteriori informazioni sulle regole AWS IoT, consultare Regole AWS IoT.

  • Se scegli Publish to AWS IoT message broker (Pubblica sul broker di messaggi IoT), inserisci un nome di argomento. È quindi possibile copiare il nome dell'argomento MQTT e più sottoscriventi possono iscriversi a questo argomento per ricevere messaggi pubblicati su tale argomento. Per ulteriori informazioni, consultare Argomenti MQTT.

  Per ulteriori informazioni sulle regole AWS IoT per le destinazioni, consultare Creare regole per elaborare i messaggi del dispositivo LoRaWAN.

• Nome ruolo

  Il ruolo IAM che fornisce al dispositivo l'autorizzazione ai dati per accedere alla regola denominata in Rule name (Nome regola). Nella console puoi creare un nuovo ruolo di servizio o selezionare un ruolo di servizio già esistente. Se stai creando un nuovo ruolo di servizio, puoi inserire un nome di ruolo (ad esempio, SidewalkDestinationRole), o lasciare vuoto per consentire a AWS IoT Core per LoRaWAN di generare un nuovo nome ruolo. AWS IoT Core per LoRaWAN creerà automaticamente il ruolo IAM con le autorizzazioni appropriate per tuo conto.

Creazione di una destinazione (interfaccia a riga di comando)

Per creare una destinazione, utilizza l'operazione API CreateDestination o il comando dell'interfaccia a riga di comando create-destination. Ad esempio, il comando seguente crea una destinazione per il dispositivo finale Sidewalk:

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

L'esecuzione di questo comando restituisce i dettagli della destinazione, che includono il nome della risorsa Amazon (ARN) e il nome della destinazione.

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

Per ulteriori informazioni sulla creazione di una destinazione, consultare Creare regole per elaborare i messaggi del dispositivo LoRaWAN.