Job Executions - List By Job

Odwołanie

Service:: SQL Database

API Version:: 2021-11-01

Listy wykonania zadania.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
jobAgentName	path	True	string	Nazwa agenta zadania.
jobName	path	True	string	Nazwa zadania do pobrania.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.
$skip	query		integer int64	Liczba elementów w kolekcji do pominięcia.
$top	query		integer int64	Liczba elementów do zwrócenia z kolekcji.
createTimeMax	query		string date-time	Jeśli zostanie określony, zostaną uwzględnione tylko wykonania zadań utworzonych przed określonym czasem.
createTimeMin	query		string date-time	W przypadku określenia zostaną uwzględnione tylko wykonania zadań utworzonych o określonej godzinie lub po określonej godzinie.
endTimeMax	query		string date-time	Jeśli zostanie określony, zostaną uwzględnione tylko wykonania zadań przed upływem określonego czasu.
endTimeMin	query		string date-time	Jeśli zostanie określony, uwzględniane są tylko wykonania zadań zakończonych o określonej godzinie lub po określonej godzinie.
isActive	query		boolean	W przypadku określenia uwzględniane są tylko aktywne lub tylko ukończone wykonania zadania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	JobExecutionListResult	Pomyślnie pobrano wykonania zadań.
Other Status Codes		Odpowiedzi na błędy: *** 404 JobAgentNotFound — określony agent zadania nie istnieje na określonym serwerze logicznym. 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

Nazwa

Typ

Opis

200 OK

JobExecutionListResult

Pomyślnie pobrano wykonania zadań.

Other Status Codes

Odpowiedzi na błędy: ***

404 JobAgentNotFound — określony agent zadania nie istnieje na określonym serwerze logicznym.
404 ResourceNotFound — żądany zasób nie został znaleziony.
404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera
404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

Przykłady

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

Definicje

Nazwa	Opis
JobExecution	Wykonywanie zadania
JobExecutionLifecycle	Szczegółowy stan wykonywania zadania.
JobExecutionListResult	Lista wykonań zadań.
JobExecutionTarget	Obiekt docelowy wykonywany przez zadanie.
JobTargetType	Typ obiektu docelowego.
ProvisioningState	Stan aprowizacji zadania w usłudze ARM.

JobExecution

Wykonywanie zadania

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.createTime	string	Czas utworzenia zadania.
properties.currentAttemptStartTime	string	Godzina rozpoczęcia bieżącej próby.
properties.currentAttempts	integer	Liczba prób wykonania zadania.
properties.endTime	string	Czas ukończenia zadania.
properties.jobExecutionId	string	Unikatowy identyfikator wykonania zadania.
properties.jobVersion	integer	Numer wersji zadania.
properties.lastMessage	string	Ostatni stan lub komunikat o błędzie.
properties.lifecycle	JobExecutionLifecycle	Szczegółowy stan wykonywania zadania.
properties.provisioningState	ProvisioningState	Stan aprowizacji zadania w usłudze ARM.
properties.startTime	string	Czas rozpoczęcia wykonywania zadania.
properties.stepId	integer	Identyfikator kroku zadania.
properties.stepName	string	Nazwa kroku zadania.
properties.target	JobExecutionTarget	Obiekt docelowy, na który jest wykonywane to wykonanie.
type	string	Typ zasobu.

JobExecutionLifecycle

Szczegółowy stan wykonywania zadania.

Nazwa	Typ	Opis
Canceled	string
Created	string
Failed	string
InProgress	string
Skipped	string
Succeeded	string
SucceededWithSkipped	string
TimedOut	string
WaitingForChildJobExecutions	string
WaitingForRetry	string

JobExecutionListResult

Lista wykonań zadań.

Nazwa	Typ	Opis
nextLink	string	Link, aby pobrać następną stronę wyników.
value	JobExecution[]	Tablica wyników.

JobExecutionTarget

Obiekt docelowy wykonywany przez zadanie.

Nazwa	Typ	Opis
databaseName	string	Nazwa bazy danych.
serverName	string	Nazwa serwera.
type	JobTargetType	Typ obiektu docelowego.

JobTargetType

Typ obiektu docelowego.

Nazwa	Typ	Opis
SqlDatabase	string
SqlElasticPool	string
SqlServer	string
SqlShardMap	string
TargetGroup	string

ProvisioningState

Stan aprowizacji zadania w usłudze ARM.

Nazwa	Typ	Opis
Canceled	string
Created	string
Failed	string
InProgress	string
Succeeded	string

Job Executions - List By Job

Parametry identyfikatora URI

Odpowiedzi

Przykłady

List a job's executions.

Sample Request

Sample Response

Definicje

JobExecution

JobExecutionLifecycle

JobExecutionListResult

JobExecutionTarget

JobTargetType

ProvisioningState

Dodatkowe zasoby