Freigeben über


Job Step Executions - Get

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=2023-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
jobAgentName
path True

string

Der Name des Auftragsagenten.

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. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.

serverName
path True

string

Der Name des Servers.

stepName
path True

string

Der Name des Schritts.

subscriptionId
path True

string

Die Abonnement-ID, die ein Azure-Abonnement identifiziert.

api-version
query True

string

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

Antworten

Name Typ Beschreibung
200 OK

JobExecution

Die Ausführung des Schritts wurde erfolgreich abgerufen.

Other Status Codes

ErrorResponse

Fehlerantworten: ***

  • 400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird

  • 400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt

  • 404 JobAgentNotFound – Der angegebene Auftrags-Agent ist nicht auf dem angegebenen logischen Server vorhanden.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

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

  • 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden.

  • 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden.

Beispiele

Get a job step execution

Beispielanforderung

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=2023-08-01

Beispiel für eine Antwort

{
  "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
ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

JobExecution

Ausführung eines Auftrags

JobExecutionLifecycle

Der detaillierte Zustand der Auftragsausführung.

JobExecutionTarget

Das Ziel, für das eine Auftragsausführung ausgeführt wird.

JobTargetType

Der Typ des Ziels.

ProvisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

JobExecution

Ausführung eines Auftrags

Name Typ Beschreibung
id

string

Ressourcen-ID.

name

string

Ressourcenname.

properties.createTime

string (date-time)

Der Zeitpunkt, zu dem die Auftragsausführung erstellt wurde.

properties.currentAttemptStartTime

string (date-time)

Startzeit des aktuellen Versuchs.

properties.currentAttempts

integer (int32)

Häufigkeit, mit der die Auftragsausführung versucht wurde.

properties.endTime

string (date-time)

Der Zeitpunkt, zu dem die Auftragsausführung abgeschlossen wurde.

properties.jobExecutionId

string (uuid)

Der eindeutige Bezeichner der Auftragsausführung.

properties.jobVersion

integer (int32)

Die Auftragsversionsnummer.

properties.lastMessage

string

Der letzte Status oder die letzte Fehlermeldung.

properties.lifecycle

JobExecutionLifecycle

Der detaillierte Zustand der Auftragsausführung.

properties.provisioningState

ProvisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

properties.startTime

string (date-time)

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

properties.stepId

integer (int32)

Die Auftragsschritt-ID.

properties.stepName

string

Der Name des Auftragsschritts.

properties.target

JobExecutionTarget

Das Ziel, für das diese Ausführung ausgeführt wird.

type

string

Ressourcentyp.

JobExecutionLifecycle

Der detaillierte Zustand der Auftragsausführung.

Wert Beschreibung
Canceled
Created
Failed
InProgress
Skipped
Succeeded
SucceededWithSkipped
TimedOut
WaitingForChildJobExecutions
WaitingForRetry

JobExecutionTarget

Das Ziel, für das eine Auftragsausführung ausgeführt wird.

Name Typ Beschreibung
databaseName

string

Der Datenbankname.

serverName

string

Der Servername.

type

JobTargetType

Der Typ des Ziels.

JobTargetType

Der Typ des Ziels.

Wert Beschreibung
SqlDatabase
SqlElasticPool
SqlServer
SqlShardMap
TargetGroup

ProvisioningState

Der ARM-Bereitstellungsstatus der Auftragsausführung.

Wert Beschreibung
Canceled
Created
Failed
InProgress
Succeeded