Microsoft Azure Job API

The Job API from Microsoft Azure — 18 operation(s) for job.

Documentation GitHub OpenAPI

Operations 25

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /jobs List Data Lake Analytics jobs in an account · Microsoft Azure Get Jobs #

Ask an LLM

“Which Data Lake Analytics jobs have been submitted in my account?”

“Can I sort or filter my Data Lake Analytics job list with OData?”

Tell an agent

List every job in my Data Lake Analytics account.

List Data Lake Analytics jobs matching {filter}, top {top}, ordered by {orderby}.

PUT /jobs/{jobIdentity} Submit a Data Lake Analytics job · Microsoft Azure Put Jobs Jobidentity #

Ask an LLM

“How do I submit a U-SQL script as a new Data Lake Analytics job?”

“Can I set the priority and degree of parallelism when submitting an analytics job?”

Tell an agent

Submit Data Lake Analytics job {job_id} named {name} of type {type}.

Submit job {job_id} called {name} with priority {priority} and parallelism {parallelism}.

GET /jobs/{jobIdentity} Get details of a Data Lake Analytics job · Microsoft Azure Get Jobs Jobidentity #

Ask an LLM

“What is the current state and result of a specific Data Lake Analytics job?”

“Can I look up who submitted a given analytics job and when?”

Tell an agent

Get the job information for Data Lake Analytics job {job_id}.

Show me whether analytics job {job_id} succeeded or failed.

PATCH /jobs/{jobIdentity} Change a running Scope job's priority or parallelism · Microsoft Azure Patch Jobs Jobidentity #

Ask an LLM

“Can I change the priority of a job that is already submitted to Data Lake Analytics?”

“Is it possible to raise the parallelism of an existing Scope job?”

Tell an agent

Update the priority of existing job {job_id} to {priority}.

Change the degree of parallelism on already-submitted job {job_id} to {parallelism}.

GET /jobs/{jobIdentity}/GetStatistics Get statistics for a Data Lake Analytics job · Microsoft Azure Get Jobs Jobidentity Getstatistics #

Ask an LLM

“Where can I see the execution statistics of a finished analytics job?”

“What stage-level stats does Data Lake Analytics keep for a job?”

Tell an agent

Get the statistics for analytics job {job_id}.

Pull the performance stats of job {job_id} so I can see where time went.

GET /jobs/{jobIdentity}/GetDebugDataPath Get the debug data location for a job · Microsoft Azure Get Jobs Jobidentity Getdebugdatapath #

Ask an LLM

“Where is the debug data stored for a failed Data Lake Analytics job?”

“Can I find the path to a job's debug files so I can download them?”

Tell an agent

Get the debug data path for job {job_id}.

Tell me where the debugging output for analytics job {job_id} lives.

POST /jobs/{jobIdentity}/CancelJob Cancel a running Data Lake Analytics job · Microsoft Azure Post Jobs Jobidentity Canceljob #

Ask an LLM

“How do I stop a Data Lake Analytics job that is still running?”

“Can I cancel an analytics job that is taking too long?”

Tell an agent destructive · confirm first

Cancel running Data Lake Analytics job {job_id}.

Kill analytics job {job_id} now.

POST /jobs/{jobIdentity}/YieldJob Pause a Scope job and requeue it · Microsoft Azure Post Jobs Jobidentity Yieldjob #

Ask an LLM

“Can I pause a Scope job and put it back in the queue behind higher-priority work?”

“What happens when a Data Lake Analytics job yields?”

Tell an agent

Yield job {job_id} back to the job queue.

Pause Scope job {job_id} and let equal or higher priority jobs run first.

POST /buildJob Compile a job to validate it before submitting · Microsoft Azure Post Buildjob #

Ask an LLM

“Can I check a U-SQL script compiles before I actually submit the job?”

“Is there a way to validate a Data Lake Analytics job for correctness without running it?”

Tell an agent

Build (compile only) a {type} job with properties {properties} to check for errors.

Validate job {name} by compiling it without running.

GET /livy/batches List Spark batch jobs · Microsoft Azure Get Livy Batches #

Ask an LLM

“Which Spark batch jobs are submitted through Livy right now?”

“Can I page through Spark batches starting from a given offset?”

Tell an agent

List all Spark batch jobs.

List {size} Spark batches starting at index {from}.

POST /livy/batches Submit a Spark batch job · Microsoft Azure Post Livy Batches #

Ask an LLM

“How do I submit a jar or Python file as a Spark batch job through Livy?”

“Can I set executor memory and number of executors on a Spark batch?”

Tell an agent

Submit a Spark batch running {file} with main class {class_name}.

Start Spark batch {name} from {file} with {executors} executors.

GET /livy/batches/{batchId} Get a Spark batch job · Microsoft Azure Get Livy Batches Batchid #

Ask an LLM

“What are the details of one Spark batch job I submitted?”

“Can I look up a single Livy batch by its id?”

Tell an agent

Get Spark batch job {batch_id}.

Show me the details of Livy batch {batch_id}.

DELETE /livy/batches/{batchId} Cancel a running Spark batch job · Microsoft Azure Delete Livy Batches Batchid #

Ask an LLM

“How do I cancel a Spark batch job that is still running?”

“Can I kill a Livy batch before it finishes?”

Tell an agent destructive · confirm first

Cancel Spark batch {batch_id}.

Stop the running Livy batch job {batch_id}.

GET /livy/batches/{batchId}/log Read the logs of a Spark batch job · Microsoft Azure Get Livy Batches Batchid Log #

Ask an LLM

“Where can I read the driver log output of a Spark batch job?”

“Can I fetch only part of a Spark batch's log lines?”

Tell an agent

Get the logs for Spark batch {batch_id}.

Show {size} log lines of batch {batch_id} starting at line {from}.

GET /livy/batches/{batchId}/state Check the state of a Spark batch job · Microsoft Azure Get Livy Batches Batchid State #

Ask an LLM

“Is my Spark batch job still running, or did it finish?”

“What state is a given Livy batch in right now?”

Tell an agent

Check the state of Spark batch {batch_id}.

Tell me whether batch {batch_id} is running, dead or successful.

GET /livy/sessions List Spark sessions · Microsoft Azure Get Livy Sessions #

Ask an LLM

“Which interactive Spark sessions are open through Livy?”

“Can I page through Spark sessions a few at a time?”

Tell an agent

List all interactive Spark sessions.

List {size} Spark sessions starting from index {from}.

POST /livy/sessions Start an interactive Spark session · Microsoft Azure Post Livy Sessions #

Ask an LLM

“How do I open a new interactive Spark session for running code?”

“Can I choose the session kind, like pyspark or scala, when starting a Spark session?”

Tell an agent

Start a new {kind} Spark session.

Create Spark session {name} with {executors} executors and a {timeout} second heartbeat timeout.

GET /livy/sessions/{sessionId} Get a Spark session · Microsoft Azure Get Livy Sessions Sessionid #

Ask an LLM

“What are the details of one interactive Spark session?”

“Can I look up a Livy session by its id?”

Tell an agent

Get Spark session {session_id}.

Show the configuration of interactive session {session_id}.

DELETE /livy/sessions/{sessionId} Close a Spark session · Microsoft Azure Delete Livy Sessions Sessionid #

Ask an LLM

“How do I shut down an interactive Spark session I no longer need?”

“Can I cancel a Spark session that is still running?”

Tell an agent destructive · confirm first

Close Spark session {session_id}.

Cancel the running interactive session {session_id}.

GET /livy/sessions/{sessionId}/log Read the logs of a Spark session · Microsoft Azure Get Livy Sessions Sessionid Log #

Ask an LLM

“Where can I see the log output of an interactive Spark session?”

“Can I fetch a window of lines from a Spark session's log?”

Tell an agent

Get the logs for Spark session {session_id}.

Show {size} log lines of session {session_id} from line {from}.

GET /livy/sessions/{sessionId}/state Check the state of a Spark session · Microsoft Azure Get Livy Sessions Sessionid State #

Ask an LLM

“Is my interactive Spark session idle, busy or dead?”

“What state is a given Livy session in?”

Tell an agent

Check the state of Spark session {session_id}.

Tell me whether session {session_id} is ready for statements.

GET /livy/sessions/{sessionId}/statements List statements run in a Spark session · Microsoft Azure Get Livy Sessions Sessionid Statements #

Ask an LLM

“Which code statements have been run inside a Spark session?”

“Can I see the history of statements for one interactive session?”

Tell an agent

List the statements in Spark session {session_id}.

Show every code snippet executed in session {session_id}.

POST /livy/sessions/{sessionId}/statements Run code as a statement in a Spark session · Microsoft Azure Post Livy Sessions Sessionid Statements #

Ask an LLM

“How do I run a snippet of code inside an open Spark session?”

“Can I send SQL or Python code to an existing interactive session?”

Tell an agent

Run {code} in Spark session {session_id}.

Submit this {kind} statement to session {session_id}: {code}

GET /livy/sessions/{sessionId}/statements/{statementId} Get a statement's result in a Spark session · Microsoft Azure Get Livy Sessions Sessionid Statements Statementid #

Ask an LLM

“What was the output of a statement I ran in a Spark session?”

“Has a particular Spark statement finished executing?”

Tell an agent

Get statement {statement_id} in Spark session {session_id}.

Show the output of statement {statement_id} from session {session_id}.

POST /livy/sessions/{sessionId}/statements/{statementId}/cancel Kill a statement in a Spark session · Microsoft Azure Post Livy Sessions Sessionid Statements Statementid Cancel #

Ask an LLM

“How do I stop a long-running statement without closing the whole Spark session?”

“Can I cancel just one statement inside an interactive session?”

Tell an agent destructive · confirm first

Cancel statement {statement_id} in Spark session {session_id}.

Kill the running statement {statement_id} but keep session {session_id} open.

Microsoft Azure Job API

Operations 25

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification