Job Executions - Create Or Update

Tworzy lub aktualizuje wykonywanie zadania.

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

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
jobAgentName
path True

string

Nazwa agenta zadania.

jobExecutionId
path True

string (uuid)

Identyfikator wykonania zadania

jobName
path True

string

Nazwa zadania.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwisko Typ Opis
200 OK

JobExecution

Operacja aktualizacji zasobu 'JobExecution' zakończyła się sukcesem

201 Created

JobExecution

Operacja tworzenia zasobu 'JobExecution' zakończyła się sukcesem

Nagłówki

  • Location: string
  • Retry-After: integer
202 Accepted

Zaakceptowano operację zasobu.

Nagłówki

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

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Create job execution.

Przykładowe żądanie

PUT 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?api-version=2025-01-01

Przykładowa odpowiedź

{
  "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": "2017-12-18T19:02:00.8707045Z",
    "currentAttempts": 0,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "jobVersion": 1,
    "lastMessage": "Job execution created.",
    "lifecycle": "Created",
    "provisioningState": "Created"
  }
}
{
  "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": "2017-05-04T19:02:00.8707045Z",
    "currentAttempts": 0,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "jobVersion": 1,
    "lastMessage": "Job execution created.",
    "lifecycle": "Created",
    "provisioningState": "Created"
  }
}

Definicje

Nazwisko Opis
createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

JobExecution

Wykonywanie zadania

JobExecutionLifecycle

Szczegółowy stan wykonywania zadania.

JobExecutionTarget

Obiekt docelowy, na który jest wykonywane wykonanie zadania.

JobTargetType

Typ obiektu docelowego.

ProvisioningState

Stan aprowizacji zadania w usłudze ARM.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwisko Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwisko Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Błąd dodatkowe informacje.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.

JobExecution

Wykonywanie zadania

Nazwisko Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties.createTime

string (date-time)

Czas utworzenia zadania.

properties.currentAttemptStartTime

string (date-time)

Godzina rozpoczęcia bieżącej próby.

properties.currentAttempts

integer (int32)

Liczba prób wykonania zadania.

properties.endTime

string (date-time)

Czas ukończenia wykonywania zadania.

properties.jobExecutionId

string (uuid)

Unikatowy identyfikator wykonania zadania.

properties.jobVersion

integer (int32)

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 (date-time)

Czas rozpoczęcia wykonywania zadania.

properties.stepId

integer (int32)

Identyfikator kroku zadania.

properties.stepName

string

Nazwa kroku zadania.

properties.target

JobExecutionTarget

Obiekt docelowy wykonywany przez to wykonanie.

systemData

systemData

Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

JobExecutionLifecycle

Szczegółowy stan wykonywania zadania.

Wartość Opis
Created

Created

InProgress

W toku

WaitingForChildJobExecutions

Czekanie na egzekucje w pracy dziecka

WaitingForRetry

Czekanie na powtórkę

Succeeded

Powodzenie

SucceededWithSkipped

SucceededWithSkippped

Failed

Niepowodzenie

TimedOut

Przekroczono limit czasu

Canceled

Anulowane

Skipped

Skipped

JobExecutionTarget

Obiekt docelowy, na który jest wykonywane wykonanie zadania.

Nazwisko Typ Opis
databaseName

string

Nazwa bazy danych.

serverName

string

Nazwa serwera.

type

JobTargetType

Typ obiektu docelowego.

JobTargetType

Typ obiektu docelowego.

Wartość Opis
TargetGroup

TargetGroup

SqlDatabase

SqlDatabase

SqlElasticPool

SqlElasticPool

SqlShardMap

SqlShardMap

SqlServer

SqlServer

ProvisioningState

Stan aprowizacji zadania w usłudze ARM.

Wartość Opis
Created

Created

InProgress

W toku

Succeeded

Powodzenie

Failed

Niepowodzenie

Canceled

Anulowane

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.