Job Step Executions - List By Job Execution

Enumera las ejecuciones de pasos de una ejecución de trabajo.

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

Parámetros de identificador URI

Name In Required Type Description
jobAgentName
path True
  • string

Nombre del agente de trabajo.

jobExecutionId
path True
  • string
uuid

Identificador de la ejecución del trabajo

jobName
path True
  • string

Nombre del trabajo que se va a obtener.

resourceGroupName
path True
  • string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.

serverName
path True
  • string

El nombre del servidor.

subscriptionId
path True
  • string

El id. de suscripción que identifica una suscripción de Azure.

api-version
query True
  • string

La versión de API que se usará para la solicitud.

$skip
query
  • integer
int64

Número de elementos de la colección que se van a omitir.

$top
query
  • integer
int64

Número de elementos que se van a devolver de la colección.

createTimeMax
query
  • string
date-time

Si se especifica, solo se incluyen las ejecuciones de trabajo creadas antes de la hora especificada.

createTimeMin
query
  • string
date-time

Si se especifica, solo se incluyen las ejecuciones de trabajo creadas en o después de la hora especificada.

endTimeMax
query
  • string
date-time

Si se especifica, solo se incluyen las ejecuciones de trabajo completadas antes de la hora especificada.

endTimeMin
query
  • string
date-time

Si se especifica, solo se incluyen las ejecuciones de trabajo completadas en o después de la hora especificada.

isActive
query
  • boolean

Si se especifica, solo se incluyen las ejecuciones de trabajos activas o completadas.

Respuestas

Name Type Description
200 OK

Recuperó correctamente las ejecuciones de pasos.

Other Status Codes

Respuestas de error: ***

  • 404 JobAgentNotFound: el agente de trabajo especificado no existe en el servidor lógico especificado.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

Ejemplos

List job step 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/5A86BF65-43AC-F258-2524-9E92992F97CA/steps?api-version=2022-02-01-preview

Sample Response

{
  "value": [
    {
      "properties": {
        "jobVersion": 1,
        "stepName": "step1",
        "stepId": 1,
        "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
        "lifecycle": "Succeeded",
        "provisioningState": "Succeeded",
        "createTime": "2017-12-03T04:33:15.7189151Z",
        "startTime": "2017-12-03T04:33:16.176937Z",
        "endTime": "2017-12-03T04:33:19.0600862Z",
        "currentAttempts": 1,
        "currentAttemptStartTime": "2017-12-03T04:33:17.4840068Z",
        "lastMessage": "Step 1 succeeded."
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999/steps/step1",
      "name": "step1",
      "type": "Microsoft.Sql/servers/jobAgents/jobs/executions/steps"
    }
  ]
}

Definiciones

JobExecution

Ejecución de un trabajo

JobExecutionLifecycle

Estado detallado de la ejecución del trabajo.

JobExecutionListResult

Lista de ejecuciones de trabajos.

JobExecutionTarget

Destino en el que se ejecuta una ejecución de trabajo.

JobTargetType

Tipo del destino.

ProvisioningState

Estado de aprovisionamiento de ARM de la ejecución del trabajo.

JobExecution

Ejecución de un trabajo

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.createTime
  • string

Hora en que se creó la ejecución del trabajo.

properties.currentAttemptStartTime
  • string

Hora de inicio del intento actual.

properties.currentAttempts
  • integer

Número de veces que se ha intentado la ejecución del trabajo.

properties.endTime
  • string

Hora a la que se completó la ejecución del trabajo.

properties.jobExecutionId
  • string

Identificador único de la ejecución del trabajo.

properties.jobVersion
  • integer

Número de versión del trabajo.

properties.lastMessage
  • string

Último estado o mensaje de error.

properties.lifecycle

Estado detallado de la ejecución del trabajo.

properties.provisioningState

Estado de aprovisionamiento de ARM de la ejecución del trabajo.

properties.startTime
  • string

Hora a la que se inició la ejecución del trabajo.

properties.stepId
  • integer

Identificador del paso de trabajo.

properties.stepName
  • string

Nombre del paso de trabajo.

properties.target

Destino en el que se ejecuta esta ejecución.

type
  • string

Tipo de recurso.

JobExecutionLifecycle

Estado detallado de la ejecución del trabajo.

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

JobExecutionListResult

Lista de ejecuciones de trabajos.

Name Type Description
nextLink
  • string

Vínculo para recuperar la página siguiente de resultados.

value

Matriz de resultados.

JobExecutionTarget

Destino en el que se ejecuta una ejecución de trabajo.

Name Type Description
databaseName
  • string

Nombre de la base de datos.

serverName
  • string

Nombre del servidor.

type

Tipo del destino.

JobTargetType

Tipo del destino.

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

ProvisioningState

Estado de aprovisionamiento de ARM de la ejecución del trabajo.

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