API-Fehlercode-Referenz

Die Smart Device Management API verwendet standardmäßige gRPC-Fehlercodes. Weitere Informationen zu diesen Codes finden Sie unter Fehlerbehandlung.

Eine Fehlerantwort in der API wird im folgenden Format angezeigt:

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

Verwenden Sie das Suchfeld in der Tabelle mit Fehlercodes, um API-Fehler sowie Tipps zur Fehlerbehebung und zugehörige Eigenschaften und Anleitungen zu finden. Sie können in jedem Feld der Tabelle nach Inhalten suchen.

Fehlermeldung HTTP RPC Fehlerbehebung
Das Kamerabild kann nicht mehr heruntergeladen werden. 504 DEADLINE_EXCEEDED Veranstaltungsbilder laufen 30 Sekunden nach der Veröffentlichung der Veranstaltung ab. Lade das Bild vor Ablauf herunter.

Siehe auch:
  Aufgabe Kamerabild herunterladen
  Display-Gerät
  Türklingel-Gerät
  Ereignisse-Leitfaden
  GenerateImage-Befehl
  CameraMotion Trait
  CameraPerson Trait
  CameraSound Trait
  DoorbellChime Trait
Der Befehl wird für die Türklingel nicht unterstützt. 400 FAILED_PRECONDITION Ein WebRTC-Stream kann bei akkubetriebenen Türklingeln nicht verlängert werden. Wenn ein Stream auf einer Türklingel über die ursprüngliche Sitzungslänge hinaus angesehen werden soll, beenden Sie den vorhandenen Stream und generieren Sie einen neuen.

Siehe auch:
  Aufgabe Livestream verlängern
  Befehl ExtendWebRtcStream
Der Befehl ist im aktuellen Thermostatmodus nicht zulässig. 400 FAILED_PRECONDITION Bei einigen Thermostatmodellen kann der Eco-Modus nicht geändert werden, wenn der Thermostatmodus gemäß dem ThermostatMode -Trait auf „Aus“ eingestellt ist. Der Thermostatmodus muss in HEAT, COOL oder HEATCOOL geändert werden, bevor der Eco-Modus geändert werden kann.

Siehe auch:
  Aufgabe Modus ändern
  Befehl SetMode
  ThermostatMode -Trait
  ThermostatTemperatureSetpoint -Trait
Befehl nicht zulässig, wenn sich der Thermostat im Modus MANUAL_ECO befindet. 400 FAILED_PRECONDITION Der Sollwert für die Temperatur kann nicht eingestellt werden, wenn sich der Thermostat im manuellen Eco-Modus befindet.

Siehe auch:
  Aufgabe Sollwerte für die Temperatur ändern
  ThermostatEco -Attribut
  ThermostatTemperatureSetpoint -Attribut
Befehl nicht angegeben. 404 NOT_FOUND Ein Befehl wurde ohne einen gültigen Befehlsnamen im Anfragetext ausgeführt. Geben Sie einen gültigen Befehl ein.
Der Befehl wird nicht unterstützt. 400 INVALID_ARGUMENT Sie haben einen RTSP-Livestream-Befehl für eine Kamera verwendet, die WebRTC unterstützt, oder einen WebRTC-Livestream-Befehl für eine Kamera, die RTSP unterstützt.

Siehe auch:
  Aufgabe Kamerabild herunterladen
Enthält einen ungültigen Wert. 400 INVALID_ARGUMENT Ein Befehl wurde mit einem ungültigen Wert in den Argumenten eingereicht. Achten Sie darauf, einen gültigen Wert zu senden.
Der Wert für „Kühlen“ muss größer sein als der Wert für „Heizen“. 400 INVALID_ARGUMENT Achte darauf, dass das Feld heatCelsius in deinem Befehl kleiner als das Feld coolCelsius ist.

Weitere Informationen:
  Aufgabe Sollwerte für die Temperatur ändern
  ThermostatTemperatureSetpoint -Trait
Gerät nicht gefunden. 404 NOT_FOUND Es wurde ein ungültiger oder fehlender Gerätename angegeben. Geben Sie ein gültiges Gerät an.

Siehe auch:
  Connectivity trait
Unternehmen nicht gefunden. 404 NOT_FOUND Es wurde eine ungültige oder fehlende Project ID angegeben. Geben Sie eine gültige Project ID an.
Die Ereignis-ID gehört nicht zur Kamera. 400 FAILED_PRECONDITION Verwende die richtige eventID, die vom Kameraereignis zurückgegeben wird.

Siehe auch:
  Aufgabe Kameraereignisse verarbeiten
  Display-Gerät
  Aufgabe Türklingel- und Kameraereignisse verarbeiten
  Leitfaden zu Ereignissen
  CameraEventImage -Trait
  CameraMotion -Trait
  CameraPerson -Trait
  CameraSound -Trait
  DoorbellChime -Trait
Das Antwort-SDP konnte aufgrund eines Zeitüberschreitungsfehlers nicht abgerufen werden. 504 DEADLINE_EXCEEDED Versuchen Sie, den WebRTC-Livestream noch einmal zu generieren.

Weitere Informationen:
Das Feld ist in den Attributen nicht vorhanden. 400 INVALID_ARGUMENT Für ein Merkmal wurde ein nicht unterstützter Befehl gesendet.
Ungültiges Angebots-SDP: CRLF fehlt. 400 INVALID_ARGUMENT Das Zeilenumbruchzeichen fehlt am Ende des offerSdp-Strings beim Versuch, einen WebRTC-Stream zu generieren. Achten Sie darauf, dass der String offerSdp mit \r\n oder \n endet, und versuchen Sie, den Stream noch einmal zu generieren.

Weitere Informationen:
Ungültige SDP-m-Zeilen im Angebot. 400 INVALID_ARGUMENT Das SDP-Angebot muss alle drei m-Zeilen für Audio, Video und Anwendung in dieser Reihenfolge enthalten.

Siehe auch:
Ungültiges SDP für das Angebot. 400 INVALID_ARGUMENT Das Audio-SDP des Angebots muss auf a=recvonly (nur empfangen) festgelegt sein.

Siehe auch:
Berechtigung verweigert. 403 PERMISSION_DENIED Der user hat dem developernicht die entsprechenden Berechtigungen auf Geräteebene im Partner Connections Manager (PCM) erteilt, die zum Ausführen eines Befehls erforderlich sind.

Beim Generieren eines WebRTC-Livestreams kann dieser Fehler auch bedeuten, dass die Audioeinstellung imofferSdpfalsch ist.

Siehe auch:
  Aufgabe Konto verknüpfen
  Befehl GenerateWebRtcStream
Limit erreicht. 429 RESOURCE_EXHAUSTED Für jeden Entwickler gilt ein Kontingent, das die Anzahl der Aufrufe begrenzt, die er ausführen kann. Wenn Sie mehr Anrufe tätigen, als in Ihrem Kontingent enthalten sind, erhalten Sie die Meldung „Ratenbegrenzung“. Reichen Sie den Aufruf noch einmal ein, wenn das Kontingent abgelaufen ist.

Weitere Informationen:
  Konzept für Ratenbeschränkungen für die Sandbox
Raum nicht gefunden. 404 NOT_FOUND Der Raum ist in der Struktur nicht vorhanden. Führen Sie einen Listenaufruf für die Ressource „rooms“ aus, um die Raum-ID zu bestätigen.
Struktur nicht gefunden. 404 NOT_FOUND Die Struktur ist in der Projectnicht vorhanden. Rufen Sie die Strukturressource auf, um die Struktur-ID zu bestätigen.
Die Kamera ist nicht für das Streaming verfügbar. 400 FAILED_PRECONDITION Die Kamera ist entweder offline oder aufgrund eines technischen Problems nicht für das Streaming verfügbar.

Siehe auch:
  Kamera
  Kamera (mit Akku)
  Kamera (mit Kabel)
  Türklingel (mit Akku)
  Türklingel (mit Kabel)
  GenerateWebRtcStream
Der Thermostatlüfter ist nicht verfügbar. 400 FAILED_PRECONDITION Der Thermostat hat keine Lüfterfunktion. Lüfterbezogene Attribute und Befehle können für dieses Gerät nicht verwendet werden.

Siehe auch:
  Aufgabe Lüfter ein- oder ausschalten
  Lüfter -Attribut