Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurazione semplice per l'installazione e il funzionamento dei dispositivi
<a name="managedintegrations-sdk-v2-cookbook-ss"></a>

Configura i tuoi dispositivi per l'onboarding nel tuo hub di integrazioni gestite creando un oggetto gestito e collegandolo al tuo hub. Questa sezione descrive i passaggi per completare il processo di onboarding del dispositivo utilizzando una configurazione semplice.

## Prerequisiti
<a name="managedintegrations-sdk-v2-cookbook-ss-prereq"></a>

Completa questi passaggi prima di tentare di effettuare l'onboard di un dispositivo:
+ Effettua l'onboarding di un dispositivo hub nell'hub di integrazioni gestite.
+ Installa la versione più recente di AWS CLI dal [Managed AWS CLI Integrations](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/) Command Reference
+ Iscriviti alle notifiche degli [eventi DEVICE\_LIFE\_CYCLE](managedintegrations-notifications.md#managedintegrations-notification-setup).

**Topics**
+ [Prerequisiti](#managedintegrations-sdk-v2-cookbook-ss-prereq)
+ [Passaggio 1: creare un armadietto per le credenziali](#managedintegrations-sdk-v2-cookbook-credential-locker)
+ [Passaggio 2: aggiungi l'armadietto delle credenziali al tuo hub](#managedintegrations-sdk-v2-cookbook-add-to-hub)
+ [Fase 3: Creare un oggetto gestito con credenziali.](#managedintegrations-sdk-v2-cookbook-ss-create-managed-thing)
+ [Passaggio 4: Collega il dispositivo e verificane lo stato.](#managedintegrations-sdk-v2-cookbook-ss-check-device-status)
+ [Passaggio 5: Ottieni le funzionalità del dispositivo](#managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities)
+ [Passaggio 6: inviare un comando all'oggetto gestito](#managedintegrations-sdk-v2-cookbook-ss-control-device)
+ [Passaggio 7: rimuovi l'elemento gestito dal tuo hub](#managedintegrations-sdk-v2-cookbook-clean-up)

## Passaggio 1: creare un armadietto per le credenziali
<a name="managedintegrations-sdk-v2-cookbook-credential-locker"></a>

Crea un blocco delle credenziali per il tuo dispositivo. 

**Per creare un armadietto per le credenziali**
+ Utilizza il comando `create-credential-locker`. L'esecuzione di questo comando attiverà la creazione di tutte le risorse di produzione, tra cui la key pair di configurazione Wi-Fi e il certificato del dispositivo.

  **Esempio create-credential-locker**

  ```
  aws iot-managed-integrations create-credential-locker \
    --name {{"DEVICE_NAME"}}
  ```

  **Risposta:**

  ```
  {    
    "Id": {{"LOCKER_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:credential-locker/{{LOCKER_ID}}
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  Per ulteriori informazioni, consulta il [create-credential-locker](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-credential-locker.html)comando nel Command *Reference* delle integrazioni AWS CLI gestite.

## Passaggio 2: aggiungi l'armadietto delle credenziali al tuo hub
<a name="managedintegrations-sdk-v2-cookbook-add-to-hub"></a>

Aggiungi l'armadietto delle credenziali al tuo hub.

**Per aggiungere un armadietto per le credenziali al tuo hub**
+ Usa il seguente comando per aggiungere un armadietto per le credenziali al tuo hub.

  ```
  aws iotmi --region {{AWS_REGION}} --endpoint {{AWS_ENDPOINT}} update-managed-thing \
  --identifier {{"HUB_MANAGED_THING_ID"}} --credential-locker-id {{"LOCKER_ID"}}
  ```

## Fase 3: Creare un oggetto gestito con credenziali.
<a name="managedintegrations-sdk-v2-cookbook-ss-create-managed-thing"></a>

Crea un oggetto gestito con credenziali per il tuo dispositivo. Ogni dispositivo richiede la propria funzionalità gestita.

**Per creare un oggetto gestito**
+ Usa il `create-managed-thing` comando per creare un oggetto gestito per il tuo dispositivo.

  **Esempio create-managed-thing**

  ```
  #ZWAVE: 
  aws iot-managed-integrations create-managed-thing --role DEVICE \
  --authentication-material '900137947003133...' \ #auth material from zwave qr code
  --authentication-material-type ZWAVE_QR_BAR_CODE \
  --credential-locker-id ${locker_id}
  
  #ZIGBEE:
  aws iot-managed-integrations create-managed-thing --role DEVICE \
  --authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
  --authentication-material-type ZIGBEE_QR_BAR_CODE \
  --credential-locker-id ${locker_id}
  ```
**Nota**  
Esistono comandi separati per i dispositivi Z-wave e Zigbee.

  **Risposta:**

  ```
  {    
    "Id": {{"DEVICE_MANAGED_THING_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:managed-thing/{{DEVICE_MANAGED_THING_ID}}"
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  *Per ulteriori informazioni, consulta il [create-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html)comando nel Command Reference delle integrazioni AWS CLI gestite.*

## Passaggio 4: Collega il dispositivo e verificane lo stato.
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-status"></a>

**Collega il dispositivo e controllane lo stato.**
+ Usa il `get-managed-thing` comando per controllare lo stato del tuo dispositivo. La ProvisioningStatus parte della cosa gestita deve essere ATTIVATA. Per ulteriori informazioni su ProvisioningStatus, vedere [Device Provisioning](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html).

  **Esempio get-managed-thing**

  ```
  #KINESIS NOTIFICATION:
  {
      "version": "1.0.0",
      "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
      "messageType": "DEVICE_LIFE_CYCLE",
      "source": "aws.iotmanagedintegrations",
      "customerAccountId": "12345678901",
      "timestamp": "2025-06-10T05:30:59.852659650Z",
      "region": "us-east-1",
      "resources": ["XXX"],
      "payload": {
          "deviceDetails": {
              "id": "1e84f61fa79a41219534b6fd57052XXX",
              "arn": "XXX",
              "createdAt": "2025-06-09T06:24:34.336120179Z",
              "updatedAt": "2025-06-10T05:30:59.784157019Z"
          },
          "status": "ACTIVATED"
      }
  }
  aws iot-managed-integrations get-managed-thing \
  --identifier {{:"DEVICE_MANAGED_THING_ID"}}
  ```

  **Risposta:**

  ```
  {    
    "Id": {{"DEVICE_MANAGED_THING_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:managed-thing/{{MANAGED_THING_ID}}"
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  *Per ulteriori informazioni, consulta il [get-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html)comando nella Guida ai comandi delle integrazioni AWS CLI gestite.*

## Passaggio 5: Ottieni le funzionalità del dispositivo
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities"></a>

Utilizza il `get-managed-thing-capabilities` comando per ottenere l'ID dell'endpoint e visualizzare un elenco di azioni possibili per il tuo dispositivo.

**Per ottenere le funzionalità di un dispositivo**
+ Usa il `get-managed-thing-capabilities` comando e annota l'ID dell'endpoint.

  **Esempio get-managed-thing-capabilties**

  ```
  aws iotmi get-managed-thing-capabilities \
  --identifier {{"DEVICE_MANAGED_THING_ID"}}
  ```

  **Risposta:**

  ```
  {    
      "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
      "CapabilityReport": {
          "version": "1.0.0",
          "nodeId": "zw.FCB10009+06",
          "endpoints": [
              {
                  "id": {{"ENDPOINT_ID"}}
                  "deviceTypes": [
                      "On/Off Switch"
                  ],
                  "capabilities": [
                      {
                          "id": "matter.OnOff@1.4",
                          "name": "On/Off",
                          "version": "6",
                          "properties": [
                              "OnOff"
                          ],
                          "actions": [
                              "Off",
                              "On"
                          ],
                          "events": []
                      }
                      ...
  }
  ```

  *Per ulteriori informazioni, consulta il [get-managed-thing-capabilities](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html)comando nella Guida ai comandi delle integrazioni AWS CLI gestite.*

## Passaggio 6: inviare un comando all'oggetto gestito
<a name="managedintegrations-sdk-v2-cookbook-ss-control-device"></a>

Usa il `send-managed-thing-command` comando per inviare un comando di attivazione/disattivazione all'oggetto gestito.

**Per inviare un comando alla cosa gestita**
+ Usa il `send-managed-thing-command` comando per inviare un comando alla tua cosa gestita.

  **Esempio send-managed-thing-command**

  ```
  json=$(jq -cr '.|@json') <<EOF
  [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff@1.4",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "Toggle",
              "parameters": {}
            }
          ]
        }
      ]
    }
  ]
  EOF
  aws iot-managed-integrations send-managed-thing-command \
  --managed-thing-id {{"DEVICE_MANAGED_THING_ID"}} --endpoints {{"ENDPOINT_ID"}}
  ```
**Nota**  
Questo esempio usa jq cli to ma puoi anche passare l'intera stringa `endpointId`

  **Risposta:**

  ```
  {    
  "TraceId": {{"TRACE_ID"}}
  }
  ```

  *Per ulteriori informazioni, consulta il [send-managed-thing-command](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/send-managed-thing-command.html)comando nel Command Reference delle integrazioni AWS CLI gestite.*

## Passaggio 7: rimuovi l'elemento gestito dal tuo hub
<a name="managedintegrations-sdk-v2-cookbook-clean-up"></a>

Pulisci l'hub rimuovendo l'elemento gestito.

**Per eliminare un oggetto gestito**
+ Usa il `delete-managed-thing` comando per rimuovere un elemento gestito dall'hub del dispositivo.

  **Esempio delete-managed-thing**

  ```
  aws iot-managed-integrations delete-managed-thing \
  --identifier {{"DEVICE_MANAGED_THING_ID"}}
  ```

  Per ulteriori informazioni, consulta il [delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html)comando nel Command *Reference* delle integrazioni AWS CLI gestite.
**Nota**  
Se il dispositivo è bloccato in uno `DELETE_IN_PROGRESS` stato, aggiungi la `--force` bandiera al. `delete-managed-thing command`
**Nota**  
Per i dispositivi Z-wave, è necessario mettere il dispositivo in modalità di associazione dopo aver eseguito il comando.