Skip to main content

job_step_executions

Creates, updates, deletes, gets or lists a job_step_executions resource.

Overview

Namejob_step_executions
TypeResource
Idazure.sql.job_step_executions

Fields

The following fields are returned by SELECT queries:

Successfully retrieved the step execution.

NameDatatypeDescription
propertiesobjectResource properties.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectresourceGroupName, serverName, jobAgentName, jobName, jobExecutionId, stepName, subscriptionIdGets a step execution of a job execution.
list_by_job_executionselectresourceGroupName, serverName, jobAgentName, jobName, jobExecutionId, subscriptionIdcreateTimeMin, createTimeMax, endTimeMin, endTimeMax, isActive, $skip, $topLists the step executions of a job execution.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
jobAgentNamestringThe name of the job agent.
jobExecutionIdstring (uuid)The id of the job execution
jobNamestringThe name of the job to get.
resourceGroupNamestringThe name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal.
serverNamestringThe name of the server.
stepNamestringThe name of the step.
subscriptionIdstringThe subscription ID that identifies an Azure subscription.
$skipintegerThe number of elements in the collection to skip.
$topintegerThe number of elements to return from the collection.
createTimeMaxstring (date-time)If specified, only job executions created before the specified time are included.
createTimeMinstring (date-time)If specified, only job executions created at or after the specified time are included.
endTimeMaxstring (date-time)If specified, only job executions completed before the specified time are included.
endTimeMinstring (date-time)If specified, only job executions completed at or after the specified time are included.
isActivebooleanIf specified, only active or only completed job executions are included.

SELECT examples

Gets a step execution of a job execution.

SELECT
properties
FROM azure.sql.job_step_executions
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND serverName = '{{ serverName }}' -- required
AND jobAgentName = '{{ jobAgentName }}' -- required
AND jobName = '{{ jobName }}' -- required
AND jobExecutionId = '{{ jobExecutionId }}' -- required
AND stepName = '{{ stepName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;