Freigeben über


IotHubServiceErrorCode Enumeration

Definition

Fehlercodes für häufige IoT Hub-Antwortfehler.

public enum IotHubServiceErrorCode
type IotHubServiceErrorCode = 
Public Enum IotHubServiceErrorCode
Vererbung
IotHubServiceErrorCode

Felder

ArgumentInvalid 400004

Etwas in der Anforderungsnutzlast ist ungültig. Überprüfen Sie die Fehlermeldung, um weitere Informationen darüber zu finden, was ungültig ist.

ArgumentNull 400005

Etwas in der Nutzlast ist unerwartet NULL. Überprüfen Sie die Fehlermeldung, um weitere Informationen darüber zu finden, was ungültig ist.

BulkRegistryOperationFailure 400013

Bei der Verarbeitung von Massenregistrierungsvorgängen ist ein Fehler aufgetreten.

Da sich dieser Fehler im 4xx HTTP-status Codebereich befindet, hätte der Dienst ein Problem mit der Auftragsanforderung oder Benutzereingabe erkannt.

DeviceAlreadyExists 409001

Es gibt bereits ein Gerät mit derselben Geräte-ID im IoT Hub.

Dies kann beim Aufrufen CreateAsync(Device, CancellationToken) mit einem Gerät zurückgegeben werden, das bereits im IoT Hub vorhanden ist.

DeviceDefinedMultipleTimes 400011

Geräte mit derselben ID waren mehrmals in der Eingabeanforderung für Massenregistrierungsvorgänge für Geräte vorhanden.

Weitere Informationen zu Massenregistrierungsvorgängen finden Sie unter https://docs.microsoft.com/rest/api/iothub/service/bulk-registry/update-registry.

DeviceMaximumQueueDepthExceeded 403004

Die zugrunde liegende Ursache ist, dass die Anzahl von Cloud-zu-Gerät-Nachrichten, die für das Gerät in die Warteschlange eingereiht werden, das Warteschlangenlimit überschreitet.

Sie müssen die Nachrichten von der Geräteseite empfangen und abschließen/ablehnen, bevor Sie zusätzliche Nachrichten in die Warteschlange stellen können. Wenn Sie die aktuell in die Warteschlange gestellten Nachrichten verwerfen möchten, können Sie Ihre Gerätenachrichtenwarteschlange bereinigen. Weitere Informationen zu Cloud-to-Device-Nachrichtenvorgängen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-messages-c2d.

DeviceNotFound 404001

Der Vorgang ist fehlgeschlagen, da das Gerät nicht von IoT Hub gefunden werden kann.

Das Gerät ist entweder nicht registriert oder deaktiviert. Kann durch Vorgänge wie GetAsync(String, CancellationToken)ausgelöst werden.

DeviceNotOnline 404103

Der Vorgang ist fehlgeschlagen, weil das angeforderte Gerät nicht online ist oder den Rückruf der direkten Methode nicht registriert hat.

InvalidOperation 400003

Der Client hat einen Vorgang angefordert, den der Hub als ungültig erkennt. Überprüfen Sie die Fehlermeldung, um weitere Informationen darüber zu finden, was ungültig ist.

InvalidProtocolVersion 400001

Die vom SDK verwendete API-Version wird vom IoT Hub-Endpunkt, der in dieser Verbindung verwendet wird, nicht unterstützt.

Normalerweise bedeutet dies, dass die Region des Hubs die API-Version noch nicht unterstützt. Es empfiehlt sich, ein Downgrade auf eine frühere Version des SDK zu erwägen, die eine ältere API-Version verwendet, oder einen Hub in einer Region zu verwenden, die dies unterstützt.

IotHubFormatError 400006

Wird vom Dienst zurückgegeben, wenn ein von dieser Bibliothek bereitgestelltes JSON-Objekt für instance nicht analysiert werden kann, wenn das für UpdateAsync(String, ClientTwin, Boolean, CancellationToken) bereitgestellte JSON-Objekt ungültig ist.

IotHubQuotaExceeded 403002

Die Gesamtanzahl der Nachrichten auf dem Hub hat das zugewiesene Kontingent überschritten.

Erhöhen Sie Einheiten für diesen Hub, um das Kontingent zu erhöhen. Weitere Informationen zum Kontingent finden Sie unter https://aka.ms/iothubthrottling.

IotHubSuspended 400020

Der Vorgang ist fehlgeschlagen, weil der IoT Hub angehalten wurde.

IotHubUnauthorizedAccess 401002

Das SAS-Token ist abgelaufen, oder IoT Hub konnte den Authentifizierungsheader, die Authentifizierungsregel oder den Authentifizierungsschlüssel nicht authentifizieren. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/iot-hub/iot-hub-troubleshoot-error-401003-iothubunauthorized.

MessageTooLarge 413001

Wenn die Nachricht für IoT Hub zu groß ist, erhalten Sie diese Fehlermeldung."

Sie sollten versuchen, die Größe Ihrer Nachricht zu reduzieren und erneut zu senden. Weitere Informationen zu Nachrichtengrößen finden Sie unter IoT Hub-Kontingente und Drosselung | Andere Grenzwerte

ModuleAlreadyExistsOnDevice 409301

Fehler beim Vorgang, weil versucht wurde, einem Gerät ein Modul hinzuzufügen, wenn für dieses Gerät bereits ein Modul mit derselben ID registriert ist. Dieses Problem kann behoben werden, indem Das vorhandene Modul zuerst mit DeleteAsync(Module, Boolean, CancellationToken)vom Gerät entfernt wird. Dieser Fehlercode wird nur von Methoden wie CreateAsync(Module, CancellationToken)zurückgegeben.

ModuleNotFound 404010

Der Vorgang ist fehlgeschlagen, da das Modul von IoT Hub nicht gefunden werden kann.

Das Modul ist entweder nicht registriert oder deaktiviert. Kann durch Vorgänge wie GetAsync(String, String, CancellationToken)ausgelöst werden.

PreconditionFailed 412001

Das ETag in der Anforderung stimmt nicht mit dem ETag der vorhandenen Ressource gemäß RFC7232 überein.

Das ETag ist ein Mechanismus zum Schutz vor den Racebedingungen mehrerer Clients, die dieselbe Ressource aktualisieren und sich gegenseitig überschreiben. Informationen zum Abrufen des aktuellen ETags für einen Zwilling finden Sie unter GetAsync(String, CancellationToken) oder GetAsync(String, String, CancellationToken).

ServerError 500001

IoT Hub ist auf ein serverseitiges Problem aufgetreten.

Für eine Fehlerantwort des Typs „500xxx“ gibt es eine Reihe von Gründen. In allen Fällen ist das Problem höchstwahrscheinlich vorübergehend. Bei IoT Hub-Knoten können gelegentlich vorübergehende Fehler auftreten. Wenn Ihre Anwendung versucht, eine Verbindung mit einem Knoten herzustellen, der Probleme aufweist, erhalten Sie diese Fehlermeldung. Um 500xxx-Fehler zu minimieren, führen Sie einen Wiederholungsversuch aus Ihrer Anwendung aus.

ServiceUnavailable 503001

IoT Hub kann die Anforderung derzeit nicht verarbeiten. Dies ist ein vorübergehender, wiederholungsfähiger Fehler.

ThrottlingException 429001

IoT Hub-Einschränkungsgrenzwerte wurden für den angeforderten Vorgang überschritten. Weitere Informationen: IoT Hub-Kontingente und Drosselung.

TooManyDevices 413002

Zu viele Geräte waren im Massenvorgang enthalten.

Überprüfen Sie die Antwort auf Details. Weitere Informationen finden Sie unter https://docs.microsoft.com/rest/api/iothub/service/bulk-registry/update-registry.

Unknown 0

Wird verwendet, wenn der vom Hub zurückgegebene Fehlercode nicht erkannt wird. Falls vorhanden, melden Sie das Problem, damit es hier hinzugefügt werden kann.

Gilt für: