IotHubServiceErrorCode Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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:
Azure SDK for .NET