Riferimento al codice di errore dell'API

L'API Smart Device Management utilizza codici di errore gRPC standard. Per ulteriori informazioni su questi codici, consulta l'articolo sulla gestione degli errori.

Una risposta di errore nell'API appare nel seguente formato:

{
  "error": {
    "code": 404,
    "message": "Device enterprises/project-id/devices/device-id not found.",
    "status": "NOT_FOUND"
  }
}

Utilizza la casella di ricerca nella tabella Codici di errore per trovare gli errori relativi all'API, oltre a suggerimenti per la risoluzione dei problemi, caratteristiche e guide correlate. Puoi cercare contenuti in qualsiasi campo della tabella.

Messaggio di errore HTTP RPC Risoluzione dei problemi
L'immagine della fotocamera non è più disponibile per il download. 504 DEADLINE_EXCEEDED Le immagini dell'evento scadono 30 secondi dopo la pubblicazione dell'evento. Assicurati di scaricare l'immagine prima della scadenza.

Vedi anche:
Attività Scarica un'immagine della fotocamera
Dispositivo display
Dispositivo campanello
Guida agli eventi
Comando GenerateImage
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
Il comando non è supportato per il campanello. 400 FAILED_PRECONDITION Uno stream WebRTC non può essere esteso sui campanelli alimentati a batteria. Se uno stream su un campanello deve essere visualizzato oltre la durata iniziale della sessione, interrompi lo stream esistente e generane uno nuovo.

Vedi anche:
Estendi un'attività di live streaming
Comando ExtendWebRtcStream
Comando non consentito nell'attuale modalità del termostato. 400 FAILED_PRECONDITION Alcuni modelli di termostato non supportano il cambio della modalità Eco quando questa è disattivata, in base alla modalità ThermostatMode . Prima di cambiare la modalità Eco, è necessario passare alla modalità HEATCOOL o HEATCOOL.

Vedi anche:
Attività Cambia modalità
Comando SetMode
ThermostatMode trait
ThermostatTemperatureSetpoint trait
Comando non consentito quando il termostato è in modalità MANUAL_ECO. 400 FAILED_PRECONDITION Non è possibile impostare il set-point di temperatura quando il termostato è in modalità Eco manuale.

Consulta anche:
Attività Modifica i set-point di temperatura
ThermostatEco trait
ThermostatTemperatureSetpoint trait
Comando non fornito. 404 NOT_FOUND Un comando è stato eseguito senza un nome comando valido nel corpo della richiesta. Inserisci un comando valido.
Comando non supportato. 400 INVALID_ARGUMENT È stato utilizzato un comando per live streaming RTSP per una videocamera che supporta WebRTC oppure un comando per live streaming WebRTC per una videocamera che supporta RTSP.

Vedi anche:
Attività Scarica un'immagine della fotocamera
Contiene un valore non valido. 400 INVALID_ARGUMENT È stato inviato un comando con un valore non valido negli argomenti. Assicurati di inviare un valore valido.
Il valore del raffreddamento deve essere maggiore del valore del riscaldamento. 400 INVALID_ARGUMENT Assicurati che il campo heatCelsius sia inferiore al campo coolCelsius del comando.

Vedi anche:
Attività Modifica i set-point di temperatura
ThermostatTemperatureSetpoint trait
Dispositivo non trovato. 404 NOT_FOUND È stato specificato un nome dispositivo non valido o mancante. Specifica un dispositivo valido.

Vedi anche:
Connectivity trait
Enterprise non trovata. 404 NOT_FOUND È stato specificato un ID Project non valido o mancante. Specifica un ID Project valido.
L'ID evento non appartiene alla videocamera. 400 FAILED_PRECONDITION Utilizza il valore eventID corretto restituito dall'evento della videocamera.

Vedi anche:
Gestire l'attività degli eventi della videocamera
Dispositivo display
Gestire l'attività degli eventi del campanello e della videocamera
Guida agli eventi
CameraEventImage trait
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
Impossibile recuperare la risposta SDP a causa di un timeout. 504 DEADLINE_EXCEEDED Prova a generare di nuovo il live streaming WebRTC.

Vedi anche:
Il campo non è presente nei trait. 400 INVALID_ARGUMENT È stato inviato un comando non supportato per un trait.
CRLF mancante per l'SDP offerta non valida. 400 INVALID_ARGUMENT Quando tenti di generare uno stream WebRTC, manca il carattere di nuova riga alla fine della stringa offerSdp. Assicurati che la stringa offerSdp termini con \r\n o \n e prova a generare di nuovo lo stream.

Vedi anche:
Linee guida SDP offerta non valide. 400 INVALID_ARGUMENT L'SDP dell'offerta deve contenere tutte e tre le righe audio, video e dell'applicazione in questo ordine.

Vedi anche:
SDP offerta non valida. 400 INVALID_ARGUMENT L'audio SDP dell'offerta deve essere impostato su a=recvonly (solo ricezione).

Vedi anche:
Autorizzazione negata. 403 PERMISSION_DENIED user non ha concesso alla developer le autorizzazioni a livello di dispositivo necessarie in Partner Connections Manager (PCM) per eseguire comando.

Durante la generazione di un live streaming WebRTC, questo errore può anche significa che l'impostazione audio in offerSdp non è corretta.

Consulta anche:
Attività Collega l'account
Comando GenerateWebRtcStream
Tariffa limitata. 429 RESOURCE_EXHAUSTED Ogni sviluppatore ha una quota che limita il numero di chiamate che può effettuare. Se effettui più chiamate rispetto alla tua quota, riceverai il messaggio Limitazione di frequenza. Per risolvere il problema, invia nuovamente la chiamata una volta scaduta la quota.

Vedi anche:
Concetto di limiti di frequenza della sandbox
Stanza non trovata. 404 NOT_FOUND La stanza non esiste nella struttura. Effettua una chiamata elenco alla risorsa delle stanze per verificare l'ID stanza.
Struttura non trovata. 404 NOT_FOUND La struttura non esiste in Project. Effettua una chiamata elenco alla risorsa della struttura per verificare l'ID struttura.
La videocamera non è disponibile per lo streaming. 400 FAILED_PRECONDITION La videocamera è offline o non è disponibile per lo streaming a causa di un problema tecnico.

Vedi anche:
Dispositivo fotocamera
Dispositivo Videocamera (a batteria)
Dispositivo Videocamera (con cavo)
Dispositivo Campanello (a batteria)
Dispositivo del campanello (con cavo)
GenerateWebRtcStream
Ventola del termostato non disponibile. 400 FAILED_PRECONDITION Il termostato non ha una funzionalità di ventola. Per questo dispositivo non è possibile utilizzare i tratti e i comandi relativi ai fan.

Vedi anche:
Attività Accendi o spegni la ventola
Fan trait