Job Step Executions - Get

Service:

SQL Database

API-versie:

2023-08-01

Hiermee wordt een stap uitgevoerd van een taakuitvoering.

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

Name	In	Vereist	Type	Description
jobAgentName	path	True	string	De naam van de taakagent.
jobExecutionId	path	True	string (uuid)	De unieke id van de taakuitvoering
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.
stepName	path	True	string	De naam van de stap.
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.

Antwoorden

Name	Type	Description
200 OK	JobExecution	De uitvoering van de stap is opgehaald.
Other Status Codes	ErrorResponse	Foutreacties: *** 400 ManagedInstanceStoppingOrStopped - Conflicterende bewerking verzonden terwijl het exemplaar de status gestopt/gestopt heeft 400 ManagedInstanceStarting - Conflicterende bewerking verzonden terwijl het exemplaar de beginstatus heeft 404 JobAgentNotFound - opgegeven taakagent bestaat niet op de opgegeven logische server. 404 ResourceNotFound : de aangevraagde resource is niet gevonden. 404 ServerNotInSubscriptionResourceGroup - Opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ResourceNotFound : de aangevraagde resource is niet gevonden.

Voorbeelden

Get a job step execution

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

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

Definities

Name	Description
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
JobExecution	Een uitvoering van een taak
JobExecutionLifecycle	De gedetailleerde status van de taakuitvoering.
JobExecutionTarget	Het doel waarop een taakuitvoering wordt uitgevoerd.
JobTargetType	Het type doel.
ProvisioningState	De ARM-inrichtingsstatus van de taakuitvoering.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

JobExecution

Object

Een uitvoering van een taak

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.createTime	string (date-time)	Het tijdstip waarop de taak is uitgevoerd, is gemaakt.
properties.currentAttemptStartTime	string (date-time)	Begintijd van de huidige poging.
properties.currentAttempts	integer (int32)	Aantal keren dat de taak is uitgevoerd.
properties.endTime	string (date-time)	Het tijdstip waarop de uitvoering van de taak is voltooid.
properties.jobExecutionId	string (uuid)	De unieke id van de taakuitvoering.
properties.jobVersion	integer (int32)	Het versienummer van de taak.
properties.lastMessage	string	De laatste status of het laatste foutbericht.
properties.lifecycle	JobExecutionLifecycle	De gedetailleerde status van de taakuitvoering.
properties.provisioningState	ProvisioningState	De ARM-inrichtingsstatus van de taakuitvoering.
properties.startTime	string (date-time)	Het tijdstip waarop de taakuitvoering is gestart.
properties.stepId	integer (int32)	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

Inventarisatie

De gedetailleerde status van de taakuitvoering.

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

JobExecutionTarget

Object

Het doel waarop een taakuitvoering wordt uitgevoerd.

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

JobTargetType

Inventarisatie

Het type doel.

Waarde	Description
SqlDatabase
SqlElasticPool
SqlServer
SqlShardMap
TargetGroup

ProvisioningState

Inventarisatie

De ARM-inrichtingsstatus van de taakuitvoering.

Waarde	Description
Canceled
Created
Failed
InProgress
Succeeded