Job Executions - List By Job

Listet die Ausführung eines Auftrags auf.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions?api-version=2021-02-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=2021-02-01-preview

URI-Parameter

Name In Required Type Description
jobAgentName
path True
  • string

Der Name des Auftragsmitarbeiters.

jobName
path True
  • string

Der Name des Auftrags, der abgerufen werden soll.

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serverName
path True
  • string

Name des Servers

subscriptionId
path True
  • string

Abonnement-ID für ein Azure-Abonnement.

api-version
query True
  • string

API-Version, die für die Anforderung verwendet werden soll.

$skip
query
  • integer
int64

Die Anzahl der Elemente in der Auflistung, die übersprungen werden sollen.

$top
query
  • integer
int64

Die Anzahl der Elemente, die aus der Auflistung zurückgegeben werden sollen.

createTimeMax
query
  • string
date-time

Wenn angegeben, werden nur Auftragsausführungen ausgeführt, die vor der angegebenen Zeit erstellt wurden.

createTimeMin
query
  • string
date-time

Wenn angegeben, werden nur Auftragsausführungen, die zu oder nach dem angegebenen Zeitpunkt erstellt wurden, eingeschlossen.

endTimeMax
query
  • string
date-time

Wenn angegeben, werden nur Auftragsausführungen abgeschlossen, bevor die angegebene Zeit eingeschlossen wird.

endTimeMin
query
  • string
date-time

Wenn angegeben, werden nur Auftragsausführungen bei oder nach dem angegebenen Zeitpunkt eingeschlossen.

isActive
query
  • boolean

Wenn angegeben, sind nur aktive oder nur abgeschlossene Auftragsausführungen enthalten.

Antworten

Name Type Description
200 OK

Erfolgreich abgerufene Auftragsausführungen.

Other Status Codes

Fehlerantworten: ***

  • 404 JobAgentNotFound – Der angegebene Auftragsagent ist nicht auf dem angegebenen logischen Server vorhanden.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

Beispiele

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=2021-02-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"
}

Definitionen

JobExecution

Eine Ausführung eines Auftrags

JobExecutionLifecycle

Der detaillierte Status der Auftragsausführung.

JobExecutionListResult

Eine Liste der Auftragsausführungen.

JobExecutionTarget

Das Ziel, auf dem eine Auftragsausführung ausgeführt wird.

JobTargetType

Der Typ des Ziels.

ProvisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

JobExecution

Eine Ausführung eines Auftrags

Name Type Description
id
  • string

Ressourcen-ID

name
  • string

Name der Ressource.

properties.createTime
  • string

Die Zeit, zu der die Auftragsausführung erstellt wurde.

properties.currentAttemptStartTime
  • string

Startzeit des aktuellen Versuches.

properties.currentAttempts
  • integer

Die Anzahl der Versuche, die Ausführung des Auftrags auszuführen.

properties.endTime
  • string

Die Zeit, zu der die Auftragsausführung abgeschlossen ist.

properties.jobExecutionId
  • string

Der eindeutige Bezeichner der Auftragsausführung.

properties.jobVersion
  • integer

Die Auftragsversionsnummer.

properties.lastMessage
  • string

Der letzte Status oder die Fehlermeldung.

properties.lifecycle

Der detaillierte Status der Auftragsausführung.

properties.provisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

properties.startTime
  • string

Die Zeit, zu der die Auftragsausführung gestartet wurde.

properties.stepId
  • integer

Die Auftragsschritt-ID.

properties.stepName
  • string

Der Name des Auftragsschritts.

properties.target

Das Ziel, an dem diese Ausführung ausgeführt wird.

type
  • string

Der Ressourcentyp.

JobExecutionLifecycle

Der detaillierte Status der Auftragsausführung.

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

JobExecutionListResult

Eine Liste der Auftragsausführungen.

Name Type Description
nextLink
  • string

Link zum Abrufen der nächsten Seite der Ergebnisse.

value

Array von Ergebnissen.

JobExecutionTarget

Das Ziel, auf dem eine Auftragsausführung ausgeführt wird.

Name Type Description
databaseName
  • string

Der Datenbankname.

serverName
  • string

Der Name des Servers.

type

Der Typ des Ziels.

JobTargetType

Der Typ des Ziels.

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

ProvisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

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