Job Executions - List By Job

Referenz

Service:: SQL Database

API Version:: 2021-11-01

Listen die Ausführungen eines Auftrags.

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

With optional parameters:

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-11-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
jobAgentName	path	True	string	Der Name des Auftrags-Agents.
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
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 zu überspringenden Elemente in der Auflistung.
$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 eingeschlossen, die vor der angegebenen Zeit erstellt wurden.
createTimeMin	query		string date-time	Wenn angegeben, werden nur Auftragsausführungen eingeschlossen, die zu oder nach dem angegebenen Zeitpunkt erstellt wurden.
endTimeMax	query		string date-time	Wenn angegeben, werden nur Auftragsausführungen eingeschlossen, die vor dem angegebenen Zeitpunkt abgeschlossen wurden.
endTimeMin	query		string date-time	Wenn angegeben, werden nur Auftragsausführungen eingeschlossen, die zu oder nach dem angegebenen Zeitpunkt abgeschlossen werden.
isActive	query		boolean	Wenn angegeben, werden nur aktive oder nur abgeschlossene Auftragsausführungen eingeschlossen.

Antworten

Name	Typ	Beschreibung
200 OK	JobExecutionListResult	Auftragsausführungen wurden erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 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.

Name

Typ

Beschreibung

200 OK

JobExecutionListResult

Auftragsausführungen wurden erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

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.

Beispiele

List a job's executions.

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-11-01


import com.azure.core.util.Context;

/** Samples for JobExecutions ListByJob. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ListJobExecutionsByJob.json
     */
    /**
     * Sample code: List a job's executions.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listAJobSExecutions(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobExecutions().listByJob("group1", "server1", "agent1", "job1",
            null, null, null, null, null, null, null, Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

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

Name	Beschreibung
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	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

JobExecutionListResult

Eine Liste der Auftragsausführungen.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	JobExecution[]	Array von Ergebnissen.

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

Job Executions - List By Job

URI-Parameter

Antworten

Beispiele

List a job's executions.

Sample Request

Sample Response

Definitionen

JobExecution

JobExecutionLifecycle

JobExecutionListResult

JobExecutionTarget

JobTargetType

ProvisioningState

Zusätzliche Ressourcen