Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
AWS IoT Jobs API können für eine der folgenden Kategorien verwendet werden:
-
Administrative Aufgaben wie die Verwaltung und Kontrolle von Aufträgen. Dies ist die Steuerebene.
-
Geräte, die diese Aufgaben ausführen. Dies ist die Datenebene, mit der Sie Daten senden und empfangen können.
Die Auftragsverwaltung und -steuerung verwendet ein HTTPS ProtokollAPI. Geräte können entweder ein MQTT oder ein HTTPS Protokoll verwendenAPI. Die Steuerungsebene API ist für ein geringes Anrufvolumen konzipiert, das typischerweise bei der Erstellung und Nachverfolgung von Aufträgen auftritt. In der Regel öffnet sie eine Verbindung für eine einzelne Anforderung und schließt diese dann nach dem Eingang der Antwort. Die Datenebene HTTPS und MQTT API ermöglichen lange Abfragen. Diese API Operationen sind für große Datenverkehrsmengen konzipiert, die auf Millionen von Geräten skaliert werden können.
Jeder AWS IoT Job HTTPS API hat einen entsprechenden Befehl, mit dem Sie den Befehl API from the AWS Command Line Interface (AWS CLI) aufrufen können. Bei den Befehlen handelt es sich um Kleinbuchstaben mit Bindestrichen zwischen den Wörtern, aus denen sich der Name des zusammensetzt. API Zum Beispiel können Sie CreateJob API on the aufrufen, indem Sie Folgendes eingeben: CLI
aws iot create-job ...
Wenn während eines Vorgangs ein Fehler auftritt, erhalten Sie eine Fehlerantwort, die Informationen über den Fehler enthält.
Enthält Informationen zu einem Fehler, der während einer Operation des AWS IoT Jobs-Service aufgetreten ist.
Das folgende Beispiel zeigt die Syntax dieser Operation:
{
"code": "ErrorCode",
"message": "string",
"clientToken": "string",
"timestamp": timestamp,
"executionState": JobExecutionState
}Im Folgenden finden Sie eine Beschreibung dieser ErrorResponse:
code-
ErrorCode kann gesetzt werden auf:
- InvalidTopic
-
Die Anfrage wurde an ein Thema im AWS IoT Jobs-Namespace gesendet, das keiner API Operation zugeordnet ist.
- InvalidJson
-
Der Inhalt der Anfrage konnte nicht als gültig UTF JSON -8-kodiert interpretiert werden.
- InvalidRequest
-
Der Inhalt der Anforderung war nicht gültig. Dieser Code wird beispielsweise ausgegeben, wenn eine
UpdateJobExecution-Anforderung ungültige Statusdetails enthält. Die Mitteilung enthält Einzelheiten zu dem Fehler. - InvalidStateTransition
-
Bei einem Update wurde versucht, die Auftragsausführung in einen Status zu ändern, der aufgrund des aktuellen Status der Auftragsausführung nicht gültig ist. Zum Beispiel ein Versuch, eine Anfrage im Status in den Status IN_ SUCCEEDED zu ändern. PROGRESS In diesem Fall enthält der Text der Fehlermeldung auch das Feld
executionState. - ResourceNotFound
-
Die von dem Anforderungsthema angegebene
JobExecutionist nicht vorhanden. - VersionMismatch
-
Die in der Anforderung angegebene erwartete Version stimmt nicht mit der Version der Jobausführung im AWS IoT Jobs-Service überein. In diesem Fall enthält der Text der Fehlermeldung auch das Feld
executionState. - InternalError
-
Bei der Verarbeitung der Anforderung ist ein interner Fehler aufgetreten.
- RequestThrottled
-
Die Anforderung wurde gedrosselt.
- TerminalStateReached
-
Tritt auf, wenn ein Befehl zum Beschreiben eines Auftrags für einen Auftrag im Status „Terminal“ durchgeführt wird.
message-
Eine Fehlermeldungszeichenfolge.
clientToken-
Eine beliebige Zeichenfolge für die Korrelierung einer Anforderung mit der jeweiligen Antwort.
timestamp-
Die seit der Epoche vergangene Zeit (in Sekunden).
executionState-
Ein
JobExecutionState-Objekt. Dieses Feld ist nur enthalten, wenn das Feldcodeden WertInvalidStateTransitionoderVersionMismatchhat. Dadurch ist es in diesen Fällen nicht erforderlich, eine separateDescribeJobExecution-Anforderung durchzuführen, um die Daten zum Status der aktuellen Auftragsausführung abzurufen.
Im Folgenden werden die API Jobs-Operationen und Datentypen aufgeführt.
