Job Step Executions - Get

Service:

SQL Database

API Version:

2022-11-01-preview

Ruft eine Schrittausführung einer Auftragsausführung ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions/{jobExecutionId}/steps/{stepName}?api-version=2022-11-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
jobAgentName	path	True	string	Der Name des Auftrags-Agents.
jobExecutionId	path	True	string uuid	Die eindeutige ID der Auftragsausführung
jobName	path	True	string	Der Name des abzurufenden Auftrags.
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
stepName	path	True	string	Der Name des Schritts.
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.

Antworten

Name	Typ	Beschreibung
200 OK	JobExecution	Die Schrittausführung wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 400 ManagedInstanceStoppingOrStopped : Konfliktierender Vorgang, der übermittelt wird, während sich instance im Status "Beenden/Beendet" befindet 400 ManagedInstanceStarting : Konfliktierender Vorgang übermittelt, während sich instance im Startzustand befindet 404 JobAgentNotFound: Der angegebene Auftrags-Agent ist auf dem angegebenen logischen Server nicht 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. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden.

Beispiele

Get a job step execution

Sample Request

HTTP

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/step1?api-version=2022-11-01-preview

Sample Response

Status code:

200

{
  "properties": {
    "jobVersion": 1,
    "stepName": "step1",
    "stepId": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Succeeded",
    "provisioningState": "Succeeded",
    "createTime": "2017-12-27T04:33:15.7189151Z",
    "startTime": "2017-12-27T04:33:16.176937Z",
    "endTime": "2017-12-27T04:33:19.0600862Z",
    "currentAttempts": 1,
    "currentAttemptStartTime": "2017-12-27T04: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"
}

Definitionen

Name	Beschreibung
JobExecution	Eine Ausführung eines Auftrags
JobExecutionLifecycle	Der detaillierte Status der Auftragsausführung.
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	Typ	Beschreibung
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 Versuchs.
properties.currentAttempts	integer	Anzahl der Versuche, die Ausführung des Auftrags durchzuführen.
properties.endTime	string	Die Zeit, zu der die Auftragsausführung abgeschlossen wurde.
properties.jobExecutionId	string	Der eindeutige Bezeichner der Auftragsausführung.
properties.jobVersion	integer	Die Versionsnummer des Auftrags.
properties.lastMessage	string	Die letzte status oder Fehlermeldung.
properties.lifecycle	JobExecutionLifecycle	Der detaillierte Status der Auftragsausführung.
properties.provisioningState	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	JobExecutionTarget	Das Ziel, auf dem diese Ausführung ausgeführt wird.
type	string	Der Ressourcentyp.

JobExecutionLifecycle

Der detaillierte Status der Auftragsausführung.

Name	Typ	Beschreibung
Canceled	string
Created	string
Failed	string
InProgress	string
Skipped	string
Succeeded	string
SucceededWithSkipped	string
TimedOut	string
WaitingForChildJobExecutions	string
WaitingForRetry	string

JobExecutionTarget

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

Name	Typ	Beschreibung
databaseName	string	Der Datenbankname.
serverName	string	Der Name des Servers.
type	JobTargetType	Der Typ des Ziels.

JobTargetType

Der Typ des Ziels.

Name	Typ	Beschreibung
SqlDatabase	string
SqlElasticPool	string
SqlServer	string
SqlShardMap	string
TargetGroup	string

ProvisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

Name	Typ	Beschreibung
Canceled	string
Created	string
Failed	string
InProgress	string
Succeeded	string