Job Executions - Create

Dienst:

SQL Database

API-Version:

2021-11-01

Startet die Ausführung eines elastischen Auftrags.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/start?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.

Antworten

Name	Typ	Beschreibung
200 OK	JobExecution	Eine Ausführung für den Auftrag wurde erfolgreich gestartet.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 ElasticJobsOperationFailed: Fehler bei der Verwaltung elastischer Aufträge. 400 ElasticJobsOperationFailed: Fehler bei der Verwaltung elastischer Aufträge. 404 JobAgentNotFound: Der angegebene Auftrags-Agent ist auf dem angegebenen logischen Server nicht vorhanden. 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. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Start a job execution.

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/start?api-version=2021-11-01

Java

/**
 * Samples for JobExecutions Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateJobExecution.json
     */
    /**
     * Sample code: Start a job execution.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void startAJobExecution(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobExecutions().create("group1", "server1", "agent1", "job1",
            com.azure.core.util.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

Beispiel für eine Antwort

Statuscode:

200

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2016-09-23T01:00:00Z",
    "currentAttempts": 0,
    "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/executions"
}

Statuscode:

202

Definitionen

Name	Beschreibung
JobExecution	Eine 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.

JobExecution

Eine Ausführung eines Auftrags

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.createTime	string	Der Zeitpunkt, zu dem die Auftragsausführung erstellt wurde.
properties.currentAttemptStartTime	string	Startzeit des aktuellen Versuchs.
properties.currentAttempts	integer	Die Anzahl der Versuche, die Auftragsausführung durchzuführen.
properties.endTime	string	Der Zeitpunkt, zu dem die Auftragsausführung abgeschlossen wurde.
properties.jobExecutionId	string	Der eindeutige Bezeichner der Auftragsausführung.
properties.jobVersion	integer	Die Auftragsversionsnummer.
properties.lastMessage	string	Die letzte status oder Fehlermeldung.
properties.lifecycle	JobExecutionLifecycle	Der detaillierte Zustand 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 Zustand 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, für das 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