---
title: "POST /buildJob"
method: POST
path: "/buildJob"
tags: ["Job"]
---

# POST /buildJob

`POST /buildJob`

Builds (compiles) the specified job in the specified Data Lake Analytics account for job correctness and validation.

## Query parameters

- `api-version` string, required

## Request body

- BuildJobParameters — Data Lake Analytics Job Parameters base class for build and submit.
  - `type` 'USql' | 'Hive' | 'Scope', required — The job type of the current job (Hive, USql, or Scope (for internal use only)).
  - `properties` CreateJobProperties, required — The common Data Lake Analytics job properties for job submission.
    - `runtimeVersion` string — The runtime version of the Data Lake Analytics engine to use for the specific type of job being run.
    - `script` string, required — The script to run. Please note that the maximum script size is 3 MB.
    - `type` string, required — The job type of the current job (Hive, USql, or Scope (for internal use only)).

## Response `200`

Successfully built the job script.

- JobInformation — The common Data Lake Analytics job information properties.
  - `jobId` string, uuid — The job's unique identifier (a GUID).
  - `name` string, required — The friendly name of the job.
  - `type` 'USql' | 'Hive' | 'Scope', required — The job type of the current job (Hive, USql, or Scope (for internal use only)).
  - `submitter` string — The user or account that submitted the job.
  - `degreeOfParallelism` integer — The degree of parallelism used for this job.
  - `degreeOfParallelismPercent` number, double — the degree of parallelism in percentage used for this job.
  - `priority` integer — The priority value for the current job. Lower numbers have a higher priority. By default, a job has a priority of 1000. This must be greater than 0.
  - `submitTime` string, date-time — The time the job was submitted to the service.
  - `startTime` string, date-time — The start time of the job.
  - `endTime` string, date-time — The completion time of the job.
  - `state` 'Accepted' | 'Compiling' | 'Ended' | 'New' | 'Queued' | 'Running' | 'Scheduling' | 'Starting' | 'Paused' | 'WaitingForCapacity' | 'Yielded' | 'Finalizing' — The job state. When the job is in the Ended state, refer to Result and ErrorMessage for details.
  - `result` 'None' | 'Succeeded' | 'Cancelled' | 'Failed' — The result of job execution or the current result of the running job.
  - `logFolder` string — The log folder path to use in the following format: adl://<accountName>.azuredatalakestore.net/system/jobservice/jobs/Usql/2016/03/13/17/18/5fe51957-93bc-4de0-8ddc-c5a4753b068b/logs/.
  - `logFilePatterns` string[] — The list of log file name patterns to find in the logFolder. '*' is the only matching character allowed. Example format: jobExecution*.log or *mylog*.txt
  - `related` JobRelationshipProperties — Job relationship information properties including pipeline information, correlation information, etc.
    - `pipelineId` string, uuid — The job relationship pipeline identifier (a GUID).
    - `pipelineName` string — The friendly name of the job relationship pipeline, which does not need to be unique.
    - `pipelineUri` string — The pipeline uri, unique, links to the originating service for this pipeline.
    - `runId` string, uuid — The run identifier (a GUID), unique identifier of the iteration of this pipeline.
    - `recurrenceId` string, uuid, required — The recurrence identifier (a GUID), unique per activity/script, regardless of iterations. This is something to link different occurrences of the same job together.
    - `recurrenceName` string — The recurrence name, user friendly name for the correlation between jobs.
  - `tags` object — The key-value pairs used to add additional metadata to the job information. (Only for use internally with Scope job type.)
  - `hierarchyQueueNode` string — the name of hierarchy queue node this job is assigned to, Null if job has not been assigned yet or the account doesn't have hierarchy queue.

---

[API](https://skmtc.net/azure/apis/datalakeanalyticsjobmanagementclient.md) · [All operations](https://skmtc.net/azure/apis/datalakeanalyticsjobmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/datalakeanalyticsjobmanagementclient/versions/ef0aef450b34/schema)