Condividi tramite

Risoluzione dei problemi con Servizio di Provisioning dei Dispositivi di Azure IoT Hub

I problemi di provisioning per i dispositivi IoT possono essere difficili da risolvere perché ci sono molti possibili punti di errore, come errori di attestazione, errori di registrazione, e così via. Per ulteriori informazioni sull'utilizzo di Azure Monitor con DPS, vedere Monitorare il servizio di provisioning dei dispositivi di Azure IoT Hub.

Codici errore comuni

Usare questa tabella per comprendere e risolvere gli errori comuni.

Codice di errore Descrizione Codice di stato HTTP
400 Il corpo della richiesta non è valido; Ad esempio, non può essere analizzato o l'oggetto non può essere convalidato. 400 Formato non valido
401 Il token di autorizzazione non può essere convalidato; ad esempio, è scaduto o non si applica all'URI della richiesta. Questo codice di errore viene restituito anche ai dispositivi come parte del flusso di attestazione TPM. 401 - Non autorizzato
404 L'istanza del servizio Device Provisioning o una risorsa (ad esempio, una registrazione) non esiste. 404 Non trovato
405 Il servizio client conosce il metodo di richiesta, ma il servizio di destinazione non riconosce questo metodo; ad esempio, un'operazione REST manca dei parametri di iscrizione o dell'ID di registrazione. 405 - Metodo non consentito
409 Impossibile completare la richiesta a causa di un conflitto con lo stato corrente dell'istanza del servizio Device Provisioning di destinazione; Ad esempio, il cliente ha già creato il punto dati e sta tentando di ricreare nuovamente lo stesso punto dati. 409 - Conflitto
412 L'ETag nella richiesta non corrisponde all'ETag della risorsa esistente, in base RFC7232. 412 - Precondizione non riuscita
415 Il server rifiuta di accettare la richiesta perché il formato del payload è in un formato non supportato. Per i formati supportati, vedere API REST del servizio di provisioning dei dispositivi di IoT Hub 415 Tipo di supporto non supportato
429 Le operazioni vengono limitate dal servizio. Per i limiti specifici del servizio, consultare i limiti del servizio di provisioning dei dispositivi di IoT Hub. 429 Numero eccessivo di richieste
500 Si è verificato un errore interno. 500 Errore interno del server

Azioni consigliate

  • Se un dispositivo IoT Edge non riesce a iniziare con il messaggio failed to provision with IoT Hub, and no valid device backup was found dps client errordi errore , vedere Errore del client DPS nella documentazione di IoT Edge (1.1).

  • Per gli errori 401 Non Autorizzato, 403 Non Consentito o 404 Non Trovato, eseguire una nuova registrazione completa chiamando l'API di registrazione DPS.

  • Per un errore 429, seguire il modello di ripetizione dei tentativi dell'hub IoT con backoff esponenziale con un jitter casuale. È possibile seguire l'intestazione retry-after fornita dall'SDK.

  • Per gli errori del server serie 500, ripetere la connessione usando le credenziali memorizzate nella cache o una chiamata APIdi ricerca di stato della registrazione del dispositivo.

Per le procedure consigliate correlate, ad esempio per le operazioni di ripetizione dei tentativi, vedere Procedure consigliate per distribuzioni di dispositivi IoT su larga scala.

Passaggi successivi