This is the latest version of the APIs.
Create a jobGroup, which launches the specified job as the authenticated user.
The request specification depends on one of the following conditions:
- Dataset has already had a job run against it and just needs to be re-run.
- Dataset has not had a job run, or the job definition needs to be re-specified.
Version: v4
Required Permissions
NOTE: Each request to the Google Cloud Platform must include authentication credentials. See API Authentication.
Request
Request Type: POST
Endpoint:
/v4/jobGroups
Request Body - Run job:
To run a job, you just specify the recipe identifier (wrangledDataset.id
). If the job is successful, all defined outputs are generated, as defined in the outputobject, publications, and writesettings objects associated with the recipe.
NOTE: For Cloud Dataprep by TRIFACTA INC., you cannot specify overrides, parameter values, or execution environments as part of the job definition. You can launch the job using the default values only.
{ "wrangledDataset": { "id": 7 } }
Response
Response Status Code - Success: 201 - Created
Response Body Example:
{ "sessionId": "79276c31-c58c-4e79-ae5e-fed1a25ebca1", "reason": "JobStarted", "jobGraph": { "vertices": [ 21, 22 ], "edges": [ { "source": 21, "target": 22 } ] }, "id": 9, "jobs": { "data": [ { "id": 21 }, { "id": 22 } ] } }
Reference
Request Reference:
Property | Description |
---|---|
wrangledDataset | (required) Internal identifier for the object whose results you wish to generate. The recipes of all preceding datasets on which this dataset depends are executed as part of the job. |
ranfrom | (optional) If this value is set to |
Response reference:
Property | Description |
---|---|
reason | Current state of the job group at time of API call. Since this call creates the job group, this value is always Job started in the response to this call. |
sessionId | Session identifier for the job group. |
id | Internal identifier of the job group. |
jobGraph | Internal identifiers of the internal objects executed for the job. |
jobs | Internal identifiers of the jobs within the job group that were executed as part of this run. Jobs are listed in order of execution. |