|
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