Job Executions - Get

Gets a job execution.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions/{jobExecutionId}?api-version=2021-11-01

URI Parameters

Name In Required Type Description
jobAgentName
path True

string

The name of the job agent.

jobExecutionId
path True

string

uuid

The id of the job execution

jobName
path True

string

The name of the job.

resourceGroupName
path True

string

The name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal.

serverName
path True

string

The name of the server.

subscriptionId
path True

string

The subscription ID that identifies an Azure subscription.

api-version
query True

string

The API version to use for the request.

Responses

Name Type Description
200 OK

JobExecution

Successfully retrieved the job.

Other Status Codes

*** Error Responses: ***

  • 404 JobAgentNotFound - Specified job agent does not exist in the specified logical server.

  • 404 ResourceNotFound - The requested resource was not found.

  • 404 SubscriptionDoesNotHaveServer - The requested server was not found

  • 404 ServerNotInSubscriptionResourceGroup - Specified server does not exist in the specified resource group and subscription.

Examples

Get a job execution.

Sample request

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5A86BF65-43AC-F258-2524-9E92992F97CA?api-version=2021-11-01

Sample response

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2017-12-21T19:02:00.8707045Z",
    "startTime": "2017-12-21T19:12:00.8707045Z",
    "endTime": "2017-12-21T19:22:00.8707045Z",
    "currentAttempts": 0,
    "currentAttemptStartTime": "2017-11-13T19:12:00.8707045Z",
    "lastMessage": "Job execution created."
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999",
  "name": "5555-6666-7777-8888-999999999999",
  "type": "Microsoft.Sql/servers/jobAgents/executions"
}

Definitions

Name Description
JobExecution

An execution of a job

JobExecutionLifecycle

The detailed state of the job execution.

JobExecutionTarget

The target that a job execution is executed on.

JobTargetType

The type of the target.

ProvisioningState

The ARM provisioning state of the job execution.

JobExecution

An execution of a job

Name Type Description
id

string

Resource ID.

name

string

Resource name.

properties.createTime

string

The time that the job execution was created.

properties.currentAttemptStartTime

string

Start time of the current attempt.

properties.currentAttempts

integer

Number of times the job execution has been attempted.

properties.endTime

string

The time that the job execution completed.

properties.jobExecutionId

string

The unique identifier of the job execution.

properties.jobVersion

integer

The job version number.

properties.lastMessage

string

The last status or error message.

properties.lifecycle

JobExecutionLifecycle

The detailed state of the job execution.

properties.provisioningState

ProvisioningState

The ARM provisioning state of the job execution.

properties.startTime

string

The time that the job execution started.

properties.stepId

integer

The job step id.

properties.stepName

string

The job step name.

properties.target

JobExecutionTarget

The target that this execution is executed on.

type

string

Resource type.

JobExecutionLifecycle

The detailed state of the job execution.

Name Type Description
Canceled

string

Created

string

Failed

string

InProgress

string

Skipped

string

Succeeded

string

SucceededWithSkipped

string

TimedOut

string

WaitingForChildJobExecutions

string

WaitingForRetry

string

JobExecutionTarget

The target that a job execution is executed on.

Name Type Description
databaseName

string

The database name.

serverName

string

The server name.

type

JobTargetType

The type of the target.

JobTargetType

The type of the target.

Name Type Description
SqlDatabase

string

SqlElasticPool

string

SqlServer

string

SqlShardMap

string

TargetGroup

string

ProvisioningState

The ARM provisioning state of the job execution.

Name Type Description
Canceled

string

Created

string

Failed

string

InProgress

string

Succeeded

string