Job Step Executions - List By Job Execution

Lista as execuções de etapas de uma execução de emprego.

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 do URI

Name In Required Type Description
jobAgentName
path True
  • string

O nome do agente de trabalho.

jobExecutionId
path True
  • string
uuid

O id da execução do trabalho

jobName
path True
  • string

O nome do trabalho para conseguir.

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir do Azure Resource Manager API ou do portal.

serverName
path True
  • string

O nome do servidor.

subscriptionId
path True
  • string

O ID de subscrição que identifica uma subscrição do Azure.

api-version
query True
  • string

A versão API a utilizar para o pedido.

$skip
query
  • integer
int64

O número de elementos na coleção a saltar.

$top
query
  • integer
int64

O número de elementos para regressar da coleção.

createTimeMax
query
  • string
date-time

Se especificado, apenas as execuções de emprego criadas antes do tempo especificado são incluídas.

createTimeMin
query
  • string
date-time

Se especificado, apenas são incluídas execuções de emprego criadas no momento ou após a hora especificada.

endTimeMax
query
  • string
date-time

Se especificado, apenas as execuções de trabalho concluídas antes da hora especificada são incluídas.

endTimeMin
query
  • string
date-time

Se especificado, apenas as execuções de trabalho concluídas no momento ou após a hora especificada são incluídas.

isActive
query
  • boolean

Se especificado, apenas estão incluídas execuções de emprego ativas ou apenas concluídas.

Respostas

Name Type Description
200 OK

Recuperou com sucesso as execuções de passos.

Other Status Codes

Respostas de erro: ***

  • 404 JobAgentNotFound - Agente de trabalho especificado não existe no servidor lógico especificado.

  • 404 ResourceNotFound - O recurso solicitado não foi encontrado.

  • 404 SubscriçãoDoesNotHaveServer - O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos especificado e na subscrição.

Exemplos

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"
    }
  ]
}

Definições

JobExecution

Uma execução de um trabalho

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

JobExecutionListResult

Uma lista de execuções de emprego.

JobExecutionTarget

O alvo em que uma execução de emprego é executada.

JobTargetType

O tipo de alvo.

ProvisioningState

O estado de provisão da ARM para a execução do trabalho.

JobExecution

Uma execução de um trabalho

Name Type Description
id
  • string

Identificação de recursos.

name
  • string

Nome de recurso.

properties.createTime
  • string

O tempo que a execução do trabalho foi criado.

properties.currentAttemptStartTime
  • string

Hora de início da tentativa atual.

properties.currentAttempts
  • integer

O número de vezes que a execução do trabalho foi tentada.

properties.endTime
  • string

O tempo que a execução do trabalho terminou.

properties.jobExecutionId
  • string

O único identificador da execução do trabalho.

properties.jobVersion
  • integer

O número da versão do trabalho.

properties.lastMessage
  • string

O último estado ou mensagem de erro.

properties.lifecycle

O estado detalhado da execução do trabalho.

properties.provisioningState

O estado de provisão da ARM para a execução do trabalho.

properties.startTime
  • string

O tempo que a execução do trabalho começou.

properties.stepId
  • integer

A identificação do passo de trabalho.

properties.stepName
  • string

O nome do passo do trabalho.

properties.target

O alvo em que esta execução é executada.

type
  • string

Tipo de recurso.

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

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

JobExecutionListResult

Uma lista de execuções de emprego.

Name Type Description
nextLink
  • string

Ligue para recuperar a próxima página de resultados.

value

Conjunto de resultados.

JobExecutionTarget

O alvo em que uma execução de emprego é executada.

Name Type Description
databaseName
  • string

O nome da base de dados.

serverName
  • string

O nome do servidor.

type

O tipo de alvo.

JobTargetType

O tipo de alvo.

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

ProvisioningState

O estado de provisão da ARM para a execução do trabalho.

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