你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Job Executions - List By Job

列出作业的执行。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions?api-version=2020-08-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions?createTimeMin={createTimeMin}&createTimeMax={createTimeMax}&endTimeMin={endTimeMin}&endTimeMax={endTimeMax}&isActive={isActive}&$skip={$skip}&$top={$top}&api-version=2020-08-01-preview

URI 参数

Name In Required Type Description
jobAgentName
path True
  • string

作业代理的名称。

jobName
path True
  • string

要获取的作业的名称。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

$skip
query
  • integer

要跳过的集合中的元素数。

$top
query
  • integer

要从集合返回的元素数。

createTimeMax
query
  • string
date-time

如果指定,则仅包含指定时间之前创建的作业执行。

createTimeMin
query
  • string
date-time

如果指定,则仅包含指定时间或之后创建的作业执行。

endTimeMax
query
  • string
date-time

如果指定,则仅包含指定时间之前完成的作业执行。

endTimeMin
query
  • string
date-time

如果指定,则仅包含指定时间或之后完成的作业执行。

isActive
query
  • boolean

如果指定,则仅包含活动或仅已完成的作业执行。

响应

Name Type Description
200 OK

已成功检索到作业执行。

Other Status Codes

错误响应: ***

  • 404 JobAgentNotFound - 指定的作业代理在指定的逻辑服务器中不存在。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器在指定的资源组和订阅中不存在。

示例

List a job's executions.

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?api-version=2020-08-01-preview

Sample Response

{
  "value": [
    {
      "properties": {
        "jobVersion": 1,
        "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
        "lifecycle": "Created",
        "provisioningState": "Created",
        "createTime": "2017-03-21T19:02:00.8707045Z",
        "startTime": "2017-03-21T19:12:00.8707045Z",
        "endTime": "2017-03-21T19:22:00.8707045Z",
        "currentAttempts": 0,
        "currentAttemptStartTime": "2017-03-21T19: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/jobs/executions"
    },
    {
      "properties": {
        "jobVersion": 1,
        "jobExecutionId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "lifecycle": "Succeeded",
        "provisioningState": "Succeeded",
        "createTime": "2017-12-15T19:02:00.8707045Z",
        "startTime": "2017-12-15T19:12:00.8707045Z",
        "endTime": "2017-12-15T19:22:00.8707045Z",
        "currentAttempts": 1,
        "lastMessage": "Job execution succeeded."
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "name": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "type": "Microsoft.Sql/servers/jobAgents/jobs/executions"
    }
  ],
  "nextLink": "https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions?api-version=2017-03-01-preview&%24skip=2"
}

定义

JobExecution

作业的执行

JobExecutionLifecycle

作业执行的详细状态。

JobExecutionListResult

作业执行列表。

JobExecutionTarget

执行作业的目标。

JobTargetType

目标的类型。

ProvisioningState

作业执行的 ARM 预配状态。

JobExecution

作业的执行

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.createTime
  • string

创建作业执行的时间。

properties.currentAttemptStartTime
  • string

当前尝试的"开始"菜单时间。

properties.currentAttempts
  • integer

尝试执行作业的次数。

properties.endTime
  • string

作业执行完成的时间。

properties.jobExecutionId
  • string

作业执行的唯一标识符。

properties.jobVersion
  • integer

作业版本号。

properties.lastMessage
  • string

最后一条状态或错误消息。

properties.lifecycle

作业执行的详细状态。

properties.provisioningState

作业执行的 ARM 预配状态。

properties.startTime
  • string

作业执行开始的时间。

properties.stepId
  • integer

作业步骤 ID。

properties.stepName
  • string

作业步骤名称。

properties.target

执行此执行的目标。

type
  • string

资源类型。

JobExecutionLifecycle

作业执行的详细状态。

Name Type Description
Canceled
  • string
Created
  • string
Failed
  • string
InProgress
  • string
Skipped
  • string
Succeeded
  • string
SucceededWithSkipped
  • string
TimedOut
  • string
WaitingForChildJobExecutions
  • string
WaitingForRetry
  • string

JobExecutionListResult

作业执行列表。

Name Type Description
nextLink
  • string

用于检索下一页结果的链接。

value

结果数组。

JobExecutionTarget

执行作业的目标。

Name Type Description
databaseName
  • string

数据库名称。

serverName
  • string

服务器名称。

type

目标的类型。

JobTargetType

目标的类型。

Name Type Description
SqlDatabase
  • string
SqlElasticPool
  • string
SqlServer
  • string
SqlShardMap
  • string
TargetGroup
  • string

ProvisioningState

作业执行的 ARM 预配状态。

Name Type Description
Canceled
  • string
Created
  • string
Failed
  • string
InProgress
  • string
Succeeded
  • string