Job Executions - List By Job

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Lijsten uitvoeringen van een taak.

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

Met optionele 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-parameters

Name	In	Vereist	Type	Description
jobAgentName	path	True	string	De naam van de taakagent.
jobName	path	True	string	De naam van de taak die u wilt ophalen.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.
$skip	query		integer int64	Het aantal elementen in de verzameling dat moet worden overgeslagen.
$top	query		integer int64	Het aantal elementen dat uit de verzameling moet worden geretourneerd.
createTimeMax	query		string date-time	Indien opgegeven, worden alleen taakuitvoeringen opgenomen die vóór de opgegeven tijd zijn gemaakt.
createTimeMin	query		string date-time	Indien opgegeven, worden alleen taakuitvoeringen opgenomen die op of na de opgegeven tijd zijn gemaakt.
endTimeMax	query		string date-time	Als dit is opgegeven, worden alleen taakuitvoeringen opgenomen die vóór de opgegeven tijd zijn voltooid.
endTimeMin	query		string date-time	Indien opgegeven, worden alleen taakuitvoeringen die zijn voltooid op of na de opgegeven tijd opgenomen.
isActive	query		boolean	Indien opgegeven, worden alleen actieve of alleen voltooide taakuitvoeringen opgenomen.

Antwoorden

Name	Type	Description
200 OK	JobExecutionListResult	Taakuitvoeringen zijn opgehaald.
Other Status Codes		Foutreacties: *** 404 JobAgentNotFound - De opgegeven taakagent bestaat niet op de opgegeven logische server. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

Name

Type

Description

200 OK

JobExecutionListResult

Taakuitvoeringen zijn opgehaald.

Other Status Codes

Foutreacties: ***

404 JobAgentNotFound - De opgegeven taakagent bestaat niet op de opgegeven logische server.
404 ResourceNotFound - De aangevraagde resource is niet gevonden.
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

Voorbeelden

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


/**
 * 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, 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

Voorbeeldrespons

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

Definities

Name	Description
JobExecution	Een uitvoering van een taak
JobExecutionLifecycle	De gedetailleerde status van de taakuitvoering.
JobExecutionListResult	Een lijst met taakuitvoeringen.
JobExecutionTarget	Het doel waarop een taak wordt uitgevoerd.
JobTargetType	Het type doel.
ProvisioningState	De ARM-inrichtingsstatus van de taakuitvoering.

JobExecution

Object

Een uitvoering van een taak

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.createTime	string	Het tijdstip waarop de taakuitvoering is gemaakt.
properties.currentAttemptStartTime	string	Begintijd van de huidige poging.
properties.currentAttempts	integer	Het aantal keren dat de taak is uitgevoerd.
properties.endTime	string	Het tijdstip waarop de uitvoering van de taak is voltooid.
properties.jobExecutionId	string	De unieke id van de taakuitvoering.
properties.jobVersion	integer	Het versienummer van de taak.
properties.lastMessage	string	Het laatste status- of foutbericht.
properties.lifecycle	JobExecutionLifecycle	De gedetailleerde status van de taakuitvoering.
properties.provisioningState	ProvisioningState	De ARM-inrichtingsstatus van de taakuitvoering.
properties.startTime	string	Het tijdstip waarop de taakuitvoering is gestart.
properties.stepId	integer	De taakstap-id.
properties.stepName	string	De naam van de taakstap.
properties.target	JobExecutionTarget	Het doel waarop deze uitvoering wordt uitgevoerd.
type	string	Resourcetype.

JobExecutionLifecycle

Enumeration

De gedetailleerde status van de taakuitvoering.

Waarde	Description
Canceled
Created
Failed
InProgress
Skipped
Succeeded
SucceededWithSkipped
TimedOut
WaitingForChildJobExecutions
WaitingForRetry

JobExecutionListResult

Object

Een lijst met taakuitvoeringen.

Name	Type	Description
nextLink	string	Koppeling om de volgende pagina met resultaten op te halen.
value	JobExecution[]	Matrix met resultaten.

JobExecutionTarget

Object

Het doel waarop een taak wordt uitgevoerd.

Name	Type	Description
databaseName	string	De naam van de database.
serverName	string	De servernaam.
type	JobTargetType	Het type doel.

JobTargetType

Enumeration

Het type doel.

Waarde	Description
SqlDatabase
SqlElasticPool
SqlServer
SqlShardMap
TargetGroup

ProvisioningState

Enumeration

De ARM-inrichtingsstatus van de taakuitvoering.

Waarde	Description
Canceled
Created
Failed
InProgress
Succeeded

Delen via

Job Executions - List By Job

URI-parameters

Antwoorden

Voorbeelden

List a job's executions.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

JobExecution

JobExecutionLifecycle

JobExecutionListResult

JobExecutionTarget

JobTargetType

ProvisioningState

Aanvullende resources