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 |
|---|---|---|---|---|
|
job
|
path | True |
string |
Namnet på den jobbagent som ska hämtas. |
|
job
|
path | True |
string |
Namnet på jobbet som ska hämtas. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
server
|
path | True |
string |
Namnet på servern. |
|
subscription
|
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 |
Azure-operationen slutfördes framgångsrikt. |
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
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 |
|---|---|
|
created |
Den typ av identitet som skapade resursen. |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
|
Job |
En körning av ett jobb |
|
Job |
Det detaljerade tillståndet för jobbkörningen. |
|
Job |
Målet som en jobbkörning körs på. |
|
Job |
Typ av mål. |
|
Provisioning |
ARM-etableringstillståndet för jobbkörningen. |
|
system |
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 |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
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 |
Det detaljerade tillståndet för jobbkörningen. |
|
| properties.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 |
Målet som den här körningen körs på. |
|
| 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 |
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 |
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 |
Den typ av identitet som senast ändrade resursen. |