Job Step Executions - List By Job Execution

Elenca le esecuzioni dei passaggi di un processo.

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

Parametri dell'URI

Name In Required Type Description
jobAgentName
path True
  • string

Nome dell'agente del processo.

jobExecutionId
path True
  • string
uuid

ID dell'esecuzione del processo

jobName
path True
  • string

Nome del processo da ottenere.

resourceGroupName
path True
  • string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

serverName
path True
  • string

Nome del server.

subscriptionId
path True
  • string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True
  • string

Versione dell'API da usare per la richiesta.

$skip
query
  • integer
int64

Numero di elementi nella raccolta da ignorare.

$top
query
  • integer
int64

Numero di elementi da restituire dalla raccolta.

createTimeMax
query
  • string
date-time

Se specificato, vengono incluse solo esecuzioni di processi create prima dell'ora specificata.

createTimeMin
query
  • string
date-time

Se specificato, vengono incluse solo esecuzioni di processi create in corrispondenza o dopo l'ora specificata.

endTimeMax
query
  • string
date-time

Se specificato, vengono incluse solo esecuzioni di processi completate prima dell'ora specificata.

endTimeMin
query
  • string
date-time

Se specificato, vengono incluse solo esecuzioni di processi completate o dopo l'ora specificata.

isActive
query
  • boolean

Se specificato, sono incluse solo esecuzioni di processi attive o completate.

Risposte

Name Type Description
200 OK

È stato recuperato correttamente le esecuzioni dei passaggi.

Other Status Codes

Risposte agli errori: **

  • 404 JobAgentNotFound : l'agente di processo specificato non esiste nel server logico specificato.

  • 404 ResourceNotFound : la risorsa richiesta non è stata trovata.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

Esempio

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

Definizioni

JobExecution

Esecuzione di un processo

JobExecutionLifecycle

Stato dettagliato dell'esecuzione del processo.

JobExecutionListResult

Elenco di esecuzioni di processi.

JobExecutionTarget

Destinazione in cui viene eseguita un'esecuzione di un processo.

JobTargetType

Tipo della destinazione.

ProvisioningState

Stato di provisioning arm dell'esecuzione del processo.

JobExecution

Esecuzione di un processo

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.createTime
  • string

Ora di creazione dell'esecuzione del processo.

properties.currentAttemptStartTime
  • string

Ora di inizio del tentativo corrente.

properties.currentAttempts
  • integer

Numero di tentativi di esecuzione del processo.

properties.endTime
  • string

Ora di completamento dell'esecuzione del processo.

properties.jobExecutionId
  • string

Identificatore univoco dell'esecuzione del processo.

properties.jobVersion
  • integer

Numero di versione del processo.

properties.lastMessage
  • string

Ultimo stato o messaggio di errore.

properties.lifecycle

Stato dettagliato dell'esecuzione del processo.

properties.provisioningState

Stato di provisioning arm dell'esecuzione del processo.

properties.startTime
  • string

Ora di avvio dell'esecuzione del processo.

properties.stepId
  • integer

ID passaggio del processo.

properties.stepName
  • string

Nome del passaggio del processo.

properties.target

Destinazione in cui viene eseguita questa esecuzione.

type
  • string

Tipo di risorsa.

JobExecutionLifecycle

Stato dettagliato dell'esecuzione del processo.

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

JobExecutionListResult

Elenco di esecuzioni di processi.

Name Type Description
nextLink
  • string

Collegamento per recuperare la pagina successiva dei risultati.

value

Matrice di risultati.

JobExecutionTarget

Destinazione in cui viene eseguita un'esecuzione di un processo.

Name Type Description
databaseName
  • string

Nome del database.

serverName
  • string

Nome del server.

type

Tipo della destinazione.

JobTargetType

Tipo della destinazione.

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

ProvisioningState

Stato di provisioning arm dell'esecuzione del processo.

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