|
3 | 3 | - Actors/Last run object and its storages |
4 | 4 | summary: Get last run |
5 | 5 | description: | |
6 | | - This is not a single endpoint, but an entire group of endpoints that lets |
7 | | - you to |
8 | | -
|
9 | | - retrieve and manage the last run of given Actor or any of its default |
10 | | - storages. |
11 | | -
|
| 6 | + This is not a single endpoint, but an entire group of endpoints that lets you to |
| 7 | + retrieve and manage the last run of given Actor or any of its default storages. |
12 | 8 | All the endpoints require an authentication token. |
13 | 9 |
|
14 | | -
|
15 | 10 | The endpoints accept the same HTTP methods and query parameters as |
16 | | -
|
17 | 11 | the respective storage endpoints. |
18 | | -
|
19 | 12 | The base path represents the last Actor run object is: |
20 | 13 |
|
21 | | -
|
22 | 14 | `/v2/acts/{actorId}/runs/last{?token,status}` |
23 | 15 |
|
24 | | -
|
25 | | - Using the `status` query parameter you can ensure to only get a run with a |
26 | | - certain status |
27 | | -
|
28 | | - (e.g. `status=SUCCEEDED`). The output of this endpoint and other query |
29 | | - parameters |
30 | | -
|
| 16 | + Using the `status` query parameter you can ensure to only get a run with a certain status |
| 17 | + (e.g. `status=SUCCEEDED`). The output of this endpoint and other query parameters |
31 | 18 | are the same as in the [Run object](#/reference/actors/run-object) endpoint. |
32 | 19 |
|
33 | | -
|
34 | | - In order to access the default storages of the last Actor run, i.e. log, |
35 | | - key-value store, dataset and request queue, |
36 | | -
|
| 20 | + In order to access the default storages of the last Actor run, i.e. log, key-value store, dataset and request queue, |
37 | 21 | use the following endpoints: |
38 | 22 |
|
39 | | -
|
40 | 23 | * `/v2/acts/{actorId}/runs/last/log{?token,status}` |
41 | | -
|
42 | | -
|
43 | 24 | * `/v2/acts/{actorId}/runs/last/key-value-store{?token,status}` |
44 | | -
|
45 | | -
|
46 | 25 | * `/v2/acts/{actorId}/runs/last/dataset{?token,status}` |
47 | | -
|
48 | | -
|
49 | 26 | * `/v2/acts/{actorId}/runs/last/request-queue{?token,status}` |
50 | 27 |
|
51 | | -
|
52 | 28 | These API endpoints have the same usage as the equivalent storage endpoints. |
53 | | -
|
54 | 29 | For example, |
55 | | -
|
56 | | - `/v2/acts/{actorId}/runs/last/key-value-store` has the same HTTP method and |
57 | | - parameters as the |
58 | | -
|
| 30 | + `/v2/acts/{actorId}/runs/last/key-value-store` has the same HTTP method and parameters as the |
59 | 31 | [Key-value store object](#/reference/key-value-stores/store-object) endpoint. |
60 | 32 |
|
61 | | -
|
62 | 33 | Additionally, each of the above API endpoints supports all sub-endpoints |
63 | | -
|
64 | 34 | of the original one: |
65 | 35 |
|
66 | | -
|
67 | 36 | #### Key-value store |
68 | 37 |
|
69 | | -
|
70 | | - * `/v2/acts/{actorId}/runs/last/key-value-store/keys{?token,status}` [Key |
71 | | - collection](#/reference/key-value-stores/key-collection) |
72 | | -
|
73 | | -
|
74 | | - * |
75 | | - `/v2/acts/{actorId}/runs/last/key-value-store/records/{recordKey}{?token,status}` |
76 | | - [Record](#/reference/key-value-stores/record) |
77 | | -
|
| 38 | + * `/v2/acts/{actorId}/runs/last/key-value-store/keys{?token,status}` [Key collection](#/reference/key-value-stores/key-collection) |
| 39 | + * `/v2/acts/{actorId}/runs/last/key-value-store/records/{recordKey}{?token,status}` [Record](#/reference/key-value-stores/record) |
78 | 40 |
|
79 | 41 | #### Dataset |
80 | 42 |
|
81 | | -
|
82 | | - * `/v2/acts/{actorId}/runs/last/dataset/items{?token,status}` [Item |
83 | | - collection](#/reference/datasets/item-collection) |
84 | | -
|
| 43 | + * `/v2/acts/{actorId}/runs/last/dataset/items{?token,status}` [Item collection](#/reference/datasets/item-collection) |
85 | 44 |
|
86 | 45 | #### Request queue |
87 | 46 |
|
| 47 | + * `/v2/acts/{actorId}/runs/last/request-queue/requests{?token,status}` [Request collection](#/reference/request-queues/request-collection) |
| 48 | + * `/v2/acts/{actorId}/runs/last/request-queue/requests/{requestId}{?token,status}` [Request collection](#/reference/request-queues/request) |
| 49 | + * `/v2/acts/{actorId}/runs/last/request-queue/head{?token,status}` [Queue head](#/reference/request-queues/queue-head) |
88 | 50 |
|
89 | | - * `/v2/acts/{actorId}/runs/last/request-queue/requests{?token,status}` |
90 | | - [Request collection](#/reference/request-queues/request-collection) |
91 | | -
|
92 | | -
|
93 | | - * |
94 | | - `/v2/acts/{actorId}/runs/last/request-queue/requests/{requestId}{?token,status}` |
95 | | - [Request collection](#/reference/request-queues/request) |
96 | | -
|
97 | | -
|
98 | | - * `/v2/acts/{actorId}/runs/last/request-queue/head{?token,status}` [Queue |
99 | | - head](#/reference/request-queues/queue-head) |
100 | | -
|
101 | | -
|
102 | | - For example, to download data from a dataset of the last succeeded Actor run |
103 | | - in XML format, |
104 | | -
|
| 51 | + For example, to download data from a dataset of the last succeeded Actor run in XML format, |
105 | 52 | send HTTP GET request to the following URL: |
106 | 53 |
|
107 | | -
|
108 | 54 | ``` |
109 | | -
|
110 | 55 | https://api.apify.com/v2/acts/{actorId}/runs/last/dataset/items?token={yourApiToken}&format=xml&status=SUCCEEDED |
111 | | -
|
112 | 56 | ``` |
113 | 57 |
|
114 | | -
|
115 | | - In order to save new items to the dataset, send HTTP POST request with JSON |
116 | | - payload to the same URL. |
| 58 | + In order to save new items to the dataset, send HTTP POST request with JSON payload to the same URL. |
117 | 59 | operationId: act_runs_last_get |
118 | 60 | parameters: |
119 | 61 | - name: actorId |
|
215 | 157 | deprecated: false |
216 | 158 | x-legacy-doc-urls: |
217 | 159 | - https://docs.apify.com/api/v2#/reference/actors/last-run-object-and-its-storages/get-last-run |
218 | | - - https://docs.apify.com/api/v2#/reference/actors/get-last-run |
0 commit comments