Job Executions - Create

Startar en elastisk jobbkörning.

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

URI-parametrar

Name I Obligatorisk Typ Description
jobAgentName
path True

string

Namnet på den jobbagent som ska hämtas.

jobName
path True

string

Namnet på jobbet som ska hämtas.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string (uuid)

ID för målprenumerationen. Värdet måste vara ett UUID.

api-version
query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Svar

Name Typ Description
200 OK

JobExecution

Azure-operationen slutfördes framgångsrikt.

202 Accepted

Resursåtgärden har godkänts.

Sidhuvuden

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Start a job execution.

Exempelbegäran

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=2025-01-01

Exempelsvar

{
  "name": "5555-6666-7777-8888-999999999999",
  "type": "Microsoft.Sql/servers/jobAgents/executions",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999",
  "properties": {
    "createTime": "2016-09-23T01:00:00Z",
    "currentAttempts": 0,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "jobVersion": 1,
    "lastMessage": "Job execution created.",
    "lifecycle": "Created",
    "provisioningState": "Created"
  }
}
Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/locations/westus/jobAgentOperationResults/5555-6666-7777-8888-999999999999?api-version=2017-03-01-preview

Definitioner

Name Description
createdByType

Den typ av identitet som skapade resursen.

ErrorAdditionalInfo

Resurshanteringsfelet ytterligare information.

ErrorDetail

Detaljerna om felet.

ErrorResponse

Felsvar

JobExecution

En körning av ett jobb

JobExecutionLifecycle

Det detaljerade tillståndet för jobbkörningen.

JobExecutionTarget

Målet som en jobbkörning körs på.

JobTargetType

Typ av mål.

ProvisioningState

ARM-etableringstillståndet för jobbkörningen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

createdByType

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Resurshanteringsfelet ytterligare information.

Name Typ Description
info

object

Den ytterligare informationen.

type

string

Typen av ytterligare information.

ErrorDetail

Detaljerna om felet.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Felet ytterligare information.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felet objektet.

JobExecution

En körning av ett jobb

Name Typ Description
id

string (arm-id)

Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties.createTime

string (date-time)

Den tid då jobbkörningen skapades.

properties.currentAttemptStartTime

string (date-time)

Starttid för det aktuella försöket.

properties.currentAttempts

integer (int32)

Antal gånger som jobbkörningen har försökts.

properties.endTime

string (date-time)

Den tid då jobbkörningen slutfördes.

properties.jobExecutionId

string (uuid)

Den unika identifieraren för jobbkörningen.

properties.jobVersion

integer (int32)

Jobbversionsnumret.

properties.lastMessage

string

Senaste status eller felmeddelande.

properties.lifecycle

JobExecutionLifecycle

Det detaljerade tillståndet för jobbkörningen.

properties.provisioningState

ProvisioningState

ARM-etableringstillståndet för jobbkörningen.

properties.startTime

string (date-time)

Den tid då jobbkörningen startade.

properties.stepId

integer (int32)

Jobbets steg-ID.

properties.stepName

string

Namnet på jobbsteget.

properties.target

JobExecutionTarget

Målet som den här körningen körs på.

systemData

systemData

Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information.

type

string

Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts"

JobExecutionLifecycle

Det detaljerade tillståndet för jobbkörningen.

Värde Description
Created

Skapades

InProgress

InProgress

WaitingForChildJobExecutions

Väntar på barnjobb

WaitingForRetry

Väntar på Omprövning

Succeeded

lyckades

SucceededWithSkipped

LyckadesMedHoppade över

Failed

Misslyckades

TimedOut

TimedOut (på engelska)

Canceled

Annullerad

Skipped

Hoppades över

JobExecutionTarget

Målet som en jobbkörning körs på.

Name Typ Description
databaseName

string

Databasnamnet

serverName

string

Servernamnet.

type

JobTargetType

Typ av mål.

JobTargetType

Typ av mål.

Värde Description
TargetGroup

Målgrupp

SqlDatabase

SqlDatabase

SqlElasticPool

SqlElasticPool

SqlShardMap

SqlShardMap

SqlServer

SqlServer

ProvisioningState

ARM-etableringstillståndet för jobbkörningen.

Värde Description
Created

Skapades

InProgress

InProgress

Succeeded

lyckades

Failed

Misslyckades

Canceled

Annullerad

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för senaste ändring av resurs (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.