/db2whrest/v1/task_status/<task_id>: GET und < Task-ID> /peek

Ruft den Status der angegebenen asynchronen Task ab.

Die folgende Tabelle zeigt, welche Rollen auf diese zwei REST-API-Endpunkte zugreifen können:

Tabelle 1. Zugriff nach Rolle
Endpunkt	Datenverwaltung	Datenbenutzer	Administrator von Sammlung	Administrator	Service
/db2whrest/v1/task_status/<task_id>: GET	✓	✓	✓	Χ	Χ
/db2whrest/v1/task_status/<task_id>/peek: GET	✓	✓	✓	Χ	Χ

Die Variante peek dieses Endpunkts gibt den Status der asynchronen Operation zurück. Die Nicht-peek -Version gibt sowohl den Status der Operation als auch einen Antwortheader mit weiteren Informationen zurück. Weitere Informationen zur Verwendung dieser Endpunkte finden Sie in den folgenden Beispielen und im Abschnitt Asynchrone Endpunkte.

Überblick über den Antrag URL

curl -k -H 'Authorization: Bearer <token>' https://<data_cataloging_host>/db2whrest/v1/task_status/ <task_id> -X GET

oder

curl -k -H 'Authorization: Bearer <token>' https://<data_cataloging_host>/db2whrest/v1/task_status/ <task_id>/peek -X GET

Unterstützte Anforderungstypen und Antwortformate

Unterstützte Anforderungstypen:

ERLANGEN

Unterstützte Antwortformate:

CSV
JSON

Beispiele

In diesem Beispiel erkennt der Benutzer, ob die asynchrone Operation abgeschlossen ist, und sucht die Positions-URI der Ergebnisse der Operation. Weitere Informationen zu diesen Schritten finden Sie im Abschnitt Asynchrone Endpunkte. Der Benutzer führt den Endpunkt /db2whrest/v1/task_status/<task_id>: GET für den Positions-URI aus, um die Ergebnisse der Operation abzurufen:

curl -k -H 'Authorization: Bearer <token>' https://<data_cataloging_host>/db2whrest/v1/ task_status/9c0db090-bd33-41c5-969f-a1603ddf49ab

Die Ergebnisse werden in der Antwort zurückgegeben. In diesem Beispiel werden nur die ersten beiden Zeilen der Ergebnisse angezeigt:

0,reflib,INDEX,SCAN,MO1,,Spectrum Scale,reflib.university.edu,3067343,root,root,
-rw-r--r--,root,9,10,/reflib/cellranger-2.0.0/refdata-cellranger-ercc92-1.2.0/star/,
sjdbList.out.tab,tab,resdnt,NA,2016-11-14 19:40:10,2017-06-02 21:30:26,2017-06-02 
21:30:26,2018-07-24 16:32:47,system,0,1,reflib.university.edureflib3067343,
,,,,,,,,,,,,,,,
1,reflib,INDEX,SCAN,MO1,,Spectrum Scale,reflib.university.edu,3067333,root,root,
-rw-r--r--,root,9,10,/reflib/cellranger-2.0.0/refdata-cellranger-ercc92-1.2.0/star/,
chrLength.txt,txt,resdnt,NA,2016-11-14 19:40:10,2017-06-02 23:28:21,2017-06-02 21:30:26,
2018-07-24 16:32:47,system,412,1,reflib.university.edureflib3067333,
,,,,,,,,,,,,,,,
...

In diesem Beispiel erfährt der Benutzer, dass die asynchrone Operation in Bearbeitung ist, und findet den Positions-URI der asynchronen Operation. Weitere Informationen zu diesen Tasks enthält der Abschnitt Asynchrone Endpunkte. Der Benutzer kann die folgenden Schritte ausführen:
1. Überwachen Sie den Status der asynchronen Operation, indem Sie den Endpunkt /db2whrest/v1/task_status/<task_id>/peek: GET mehrmals für den Positions-URI der asynchronen Operation ausführen:
```
curl -k -H 'Authorization: Bearer <token>' https://<data_cataloging_host>/db2whrest/v1/ task_status/9c0db090-bd33-41c5-969f-a1603ddf8888/peek
```
  In den ersten Versuchen gibt die Antwort an den Endpunkt peek an, dass die asynchrone Operation noch ausgeführt wird:
```
{"status":work scheduled}
```
  Beim letzten Versuch gibt die Antwort an den Endpunkt peek an, dass die asynchrone Operation abgeschlossen wird:
```
{"status":work scheduled}
```
2. Suchen Sie den Positions-URI der asynchronen Operation. Dieser Positions-URI ist bereits in Schritt 2 (a) verfügbar, in dem der Endpunkt peek ausgeführt wird.
3. Rufen Sie den Positions-URI der Ergebnisse der Operation ab. Um diese Task auszuführen, führen Sie den Endpunkt /db2whrest/v1/task_status/<task_id>: GET für den Positions-URI der asynchronen Operation aus, die Sie in Schritt 2 (b) abgerufen haben. Die Antwort enthält den Positions-URI der Ergebnisse der Operation.
4. Rufen Sie die Ergebnisse der asynchronen Operation ab. Führen Sie dazu den Endpunkt /db2whrest/v1/task_status/<task_id>: GET für die Positions-URI der Ergebnisse der Operation aus, die Sie in Schritt 2 (c) abgerufen haben:
```
curl -k -H 'Authorization: Bearer <token>' https://<data_cataloging_host>/db2whrest/v1/task_status/9c0db090-bd33- 41c5-969f-a1603ddf8888
```
  Die Ergebnisse der asynchronen Operation werden in der Antwort zurückgegeben. In diesem Beispiel werden nur die ersten beiden Zeilen der Ergebnisse angezeigt:
```
0,reflib,INDEX,SCAN,MO1,,Spectrum Scale,reflib.university.edu,3067343,root,root,
-rw-r--r--,root,9,10,/reflib/cellranger-2.0.0/refdata-cellranger-ercc92-1.2.0/star/,
sjdbList.out.tab,tab,resdnt,NA,2016-11-14 19:40:10,2017-06-02 21:30:26,2017-06-02 
21:30:26,2018-07-24 16:32:47,system,0,1,reflib.university.edureflib3067343,
,,,,,,,,,,,,,,,
1,reflib,INDEX,SCAN,MO1,,Spectrum Scale,reflib.university.edu,3067333,root,root,
-rw-r--r--,root,9,10,/reflib/cellranger-2.0.0/refdata-cellranger-ercc92-1.2.0/star/,
chrLength.txt,txt,resdnt,NA,2016-11-14 19:40:10,2017-06-02 23:28:21,2017-06-02 21:30:26,
2018-07-24 16:32:47,system,412,1,reflib.university.edureflib3067333,
,,,,,,,,,,,,,,,
...
```
Weitere Informationen finden Sie im Abschnitt Asynchrone Endpunkte.