# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Microsoft Azure Job API version: 1.0.0 extends: openapi/microsoft-azure-job-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 25 - target: $.paths['/jobs'].get update: x-apievangelist-phrasing: intent: List Data Lake Analytics jobs in an account effect: read questions: - Which Data Lake Analytics jobs have been submitted in my account? - Can I sort or filter my Data Lake Analytics job list with OData? instructions: - text: List every job in my Data Lake Analytics account. - text: List Data Lake Analytics jobs matching {filter}, top {top}, ordered by {orderby}. slots: filter: query.$filter top: query.$top orderby: query.$orderby method: generated generated: '2026-10-01' - target: $.paths['/jobs/{jobIdentity}'].get update: x-apievangelist-phrasing: intent: Get details of a Data Lake Analytics job effect: read questions: - 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? instructions: - text: Get the job information for Data Lake Analytics job {job_id}. slots: job_id: path.jobIdentity - text: Show me whether analytics job {job_id} succeeded or failed. slots: job_id: path.jobIdentity method: generated generated: '2026-09-26' - target: $.paths['/jobs/{jobIdentity}'].put update: x-apievangelist-phrasing: intent: Submit a Data Lake Analytics job effect: write questions: - 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? - What does a job submission need besides a name, a type and its properties? instructions: - text: Submit Data Lake Analytics job {job_id} named {name} of type {type}. slots: job_id: path.jobIdentity name: requestBody.name type: requestBody.type - text: Submit job {job_id} called {name} with priority {priority} and parallelism {parallelism}. slots: job_id: path.jobIdentity name: requestBody.name priority: requestBody.priority parallelism: requestBody.degreeOfParallelism method: generated generated: '2026-09-26' - target: $.paths['/jobs/{jobIdentity}'].patch update: x-apievangelist-phrasing: intent: Change a running Scope job's priority or parallelism effect: write questions: - 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? instructions: - text: Update the priority of existing job {job_id} to {priority}. slots: job_id: path.jobIdentity priority: requestBody.priority - text: Change the degree of parallelism on already-submitted job {job_id} to {parallelism}. slots: job_id: path.jobIdentity parallelism: requestBody.degreeOfParallelism method: generated generated: '2026-09-26' - target: $.paths['/jobs/{jobIdentity}/GetStatistics'].get update: x-apievangelist-phrasing: intent: Get statistics for a Data Lake Analytics job effect: read questions: - Where can I see the execution statistics of a finished analytics job? - What stage-level stats does Data Lake Analytics keep for a job? instructions: - text: Get the statistics for analytics job {job_id}. slots: job_id: path.jobIdentity - text: Pull the performance stats of job {job_id} so I can see where time went. slots: job_id: path.jobIdentity method: generated generated: '2026-09-26' - target: $.paths['/jobs/{jobIdentity}/GetDebugDataPath'].get update: x-apievangelist-phrasing: intent: Get the debug data location for a job effect: read questions: - 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? instructions: - text: Get the debug data path for job {job_id}. slots: job_id: path.jobIdentity - text: Tell me where the debugging output for analytics job {job_id} lives. slots: job_id: path.jobIdentity method: generated generated: '2026-09-26' - target: $.paths['/jobs/{jobIdentity}/CancelJob'].post update: x-apievangelist-phrasing: intent: Cancel a running Data Lake Analytics job effect: destructive questions: - How do I stop a Data Lake Analytics job that is still running? - Can I cancel an analytics job that is taking too long? instructions: - text: Cancel running Data Lake Analytics job {job_id}. slots: job_id: path.jobIdentity - text: Kill analytics job {job_id} now. slots: job_id: path.jobIdentity method: generated generated: '2026-09-26' - target: $.paths['/jobs/{jobIdentity}/YieldJob'].post update: x-apievangelist-phrasing: intent: Pause a Scope job and requeue it effect: write questions: - 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? instructions: - text: Yield job {job_id} back to the job queue. slots: job_id: path.jobIdentity - text: Pause Scope job {job_id} and let equal or higher priority jobs run first. slots: job_id: path.jobIdentity method: generated generated: '2026-09-26' - target: $.paths['/buildJob'].post update: x-apievangelist-phrasing: intent: Compile a job to validate it before submitting effect: read questions: - 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? instructions: - text: Build (compile only) a {type} job with properties {properties} to check for errors. slots: type: requestBody.type properties: requestBody.properties - text: Validate job {name} by compiling it without running. slots: name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/livy/batches'].get update: x-apievangelist-phrasing: intent: List Spark batch jobs effect: read questions: - Which Spark batch jobs are submitted through Livy right now? - Can I page through Spark batches starting from a given offset? instructions: - text: List all Spark batch jobs. - text: List {size} Spark batches starting at index {from}. slots: size: query.size from: query.from method: generated generated: '2026-09-26' - target: $.paths['/livy/batches'].post update: x-apievangelist-phrasing: intent: Submit a Spark batch job effect: write questions: - 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? instructions: - text: Submit a Spark batch running {file} with main class {class_name}. slots: file: requestBody.file class_name: requestBody.className - text: Start Spark batch {name} from {file} with {executors} executors. slots: name: requestBody.name file: requestBody.file executors: requestBody.numExecutors method: generated generated: '2026-09-26' - target: $.paths['/livy/batches/{batchId}'].get update: x-apievangelist-phrasing: intent: Get a Spark batch job effect: read questions: - What are the details of one Spark batch job I submitted? - Can I look up a single Livy batch by its id? instructions: - text: Get Spark batch job {batch_id}. slots: batch_id: path.batchId - text: Show me the details of Livy batch {batch_id}. slots: batch_id: path.batchId method: generated generated: '2026-09-26' - target: $.paths['/livy/batches/{batchId}'].delete update: x-apievangelist-phrasing: intent: Cancel a running Spark batch job effect: destructive questions: - How do I cancel a Spark batch job that is still running? - Can I kill a Livy batch before it finishes? instructions: - text: Cancel Spark batch {batch_id}. slots: batch_id: path.batchId - text: Stop the running Livy batch job {batch_id}. slots: batch_id: path.batchId method: generated generated: '2026-09-26' - target: $.paths['/livy/batches/{batchId}/log'].get update: x-apievangelist-phrasing: intent: Read the logs of a Spark batch job effect: read questions: - 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? instructions: - text: Get the logs for Spark batch {batch_id}. slots: batch_id: path.batchId - text: Show {size} log lines of batch {batch_id} starting at line {from}. slots: size: query.size batch_id: path.batchId from: query.from method: generated generated: '2026-09-26' - target: $.paths['/livy/batches/{batchId}/state'].get update: x-apievangelist-phrasing: intent: Check the state of a Spark batch job effect: read questions: - Is my Spark batch job still running, or did it finish? - What state is a given Livy batch in right now? instructions: - text: Check the state of Spark batch {batch_id}. slots: batch_id: path.batchId - text: Tell me whether batch {batch_id} is running, dead or successful. slots: batch_id: path.batchId method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions'].get update: x-apievangelist-phrasing: intent: List Spark sessions effect: read questions: - Which interactive Spark sessions are open through Livy? - Can I page through Spark sessions a few at a time? instructions: - text: List all interactive Spark sessions. - text: List {size} Spark sessions starting from index {from}. slots: size: query.size from: query.from method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions'].post update: x-apievangelist-phrasing: intent: Start an interactive Spark session effect: write questions: - 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? instructions: - text: Start a new {kind} Spark session. slots: kind: requestBody.kind - text: Create Spark session {name} with {executors} executors and a {timeout} second heartbeat timeout. slots: name: requestBody.name executors: requestBody.numExecutors timeout: requestBody.heartbeatTimeoutInSecond method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}'].get update: x-apievangelist-phrasing: intent: Get a Spark session effect: read questions: - What are the details of one interactive Spark session? - Can I look up a Livy session by its id? instructions: - text: Get Spark session {session_id}. slots: session_id: path.sessionId - text: Show the configuration of interactive session {session_id}. slots: session_id: path.sessionId method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}'].delete update: x-apievangelist-phrasing: intent: Close a Spark session effect: destructive questions: - How do I shut down an interactive Spark session I no longer need? - Can I cancel a Spark session that is still running? instructions: - text: Close Spark session {session_id}. slots: session_id: path.sessionId - text: Cancel the running interactive session {session_id}. slots: session_id: path.sessionId method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}/log'].get update: x-apievangelist-phrasing: intent: Read the logs of a Spark session effect: read questions: - 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? instructions: - text: Get the logs for Spark session {session_id}. slots: session_id: path.sessionId - text: Show {size} log lines of session {session_id} from line {from}. slots: size: query.size session_id: path.sessionId from: query.from method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}/state'].get update: x-apievangelist-phrasing: intent: Check the state of a Spark session effect: read questions: - Is my interactive Spark session idle, busy or dead? - What state is a given Livy session in? instructions: - text: Check the state of Spark session {session_id}. slots: session_id: path.sessionId - text: Tell me whether session {session_id} is ready for statements. slots: session_id: path.sessionId method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}/statements'].get update: x-apievangelist-phrasing: intent: List statements run in a Spark session effect: read questions: - Which code statements have been run inside a Spark session? - Can I see the history of statements for one interactive session? instructions: - text: List the statements in Spark session {session_id}. slots: session_id: path.sessionId - text: Show every code snippet executed in session {session_id}. slots: session_id: path.sessionId method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}/statements'].post update: x-apievangelist-phrasing: intent: Run code as a statement in a Spark session effect: write questions: - 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? instructions: - text: Run {code} in Spark session {session_id}. slots: code: requestBody.code session_id: path.sessionId - text: 'Submit this {kind} statement to session {session_id}: {code}' slots: kind: requestBody.kind session_id: path.sessionId code: requestBody.code method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}/statements/{statementId}'].get update: x-apievangelist-phrasing: intent: Get a statement's result in a Spark session effect: read questions: - What was the output of a statement I ran in a Spark session? - Has a particular Spark statement finished executing? instructions: - text: Get statement {statement_id} in Spark session {session_id}. slots: statement_id: path.statementId session_id: path.sessionId - text: Show the output of statement {statement_id} from session {session_id}. slots: statement_id: path.statementId session_id: path.sessionId method: generated generated: '2026-09-26' - target: $.paths['/livy/sessions/{sessionId}/statements/{statementId}/cancel'].post update: x-apievangelist-phrasing: intent: Kill a statement in a Spark session effect: destructive questions: - How do I stop a long-running statement without closing the whole Spark session? - Can I cancel just one statement inside an interactive session? instructions: - text: Cancel statement {statement_id} in Spark session {session_id}. slots: statement_id: path.statementId session_id: path.sessionId - text: Kill the running statement {statement_id} but keep session {session_id} open. slots: statement_id: path.statementId session_id: path.sessionId method: generated generated: '2026-09-26'