idempotencyKey ist ein optionaler String, den Sie bei einer Einreichung setzen. Senden Sie denselben Schlüssel erneut, erhalten Sie den Task, den die erste Einreichung erstellt hat; es wird keine neue Arbeit eingereiht und keine neue Credit-Reservierung angelegt.
Wie jeder Endpunkt einen wiederholten Schlüssel behandelt
Der Einzel-Endpunkt behält die Semantik der expliziten Erstellung: Sie wollten einen Task erstellen, der bereits existiert, also erhalten Sie einen Konflikt. Die Fehlerantwort trägt die id des bestehenden Tasks in
error.details.taskId, sodass ein Einreichen ohne Antwort über diese id abgefragt werden kann.
Standort-Raster
DeridempotencyKey des Rasters wird zu seiner id (fehlt er, wird eine UUID erzeugt). Der Task-Schlüssel jedes Punkts ist <grid id>:r<row>c<col>. Senden Sie dasselbe Raster erneut unter dieser id, werden die bestehenden Punkte zurückgegeben und nur die fehlenden angenommen. Senden Sie ein Raster mit anderem Mittelpunkt, anderer Größe oder anderem Radius unter derselben id, scheitern die Punkte mit abweichenden Koordinaten mit RESOURCE_ALREADY_EXISTS; verwenden Sie für ein neues Raster einen neuen Schlüssel.
Geltungsbereich und Länge
Schlüssel gelten pro Konto: Ein anderes Konto kann denselben String verwenden, ohne mit Ihrem zu kollidieren.
Ein UUID-Format ist nicht erforderlich.
Ergebnisse den Einreichungen zuordnen
Wenn Sie keinen Schlüssel gesendet haben, wird
idempotencyKey im Task-Objekt weggelassen statt als null zurückgegeben.
Lebensdauer des Schlüssels
Ein Schlüssel bleibt mindestens 30 Tage nach der Anfrage reserviert, auch nachdem der Task abgeschlossen oder fehlgeschlagen ist und nachdem das 24-stündige Polling-Fenster abgelaufen ist. Ein404 beim Polling gibt den Schlüssel nicht frei. Verwenden Sie für Übertragungswiederholungen einer Einreichung denselben Schlüssel und für einen separaten Lauf derselben Arbeit einen neuen Schlüssel (zum Beispiel mit dem Suffix :r1).
Nächste Schritte
Batches und Raster
Die drei Massen-Endpunkte im Vergleich.
Fehler
Alle Fehlercodes für Anfragen.