Job Executions - Create

Démarre une exécution de travail élastique.

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

Paramètres URI

Nom Dans Obligatoire Type Description
jobAgentName
path True

string

Nom de l’agent de travail à récupérer.

jobName
path True

string

Nom du travail à obtenir.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

serverName
path True

string

Le nom du serveur

subscriptionId
path True

string (uuid)

ID de l’abonnement cible. La valeur doit être un UUID.

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Réponses

Nom Type Description
200 OK

JobExecution

Opération Azure terminée avec succès.

202 Accepted

Exploitation des ressources acceptée.

En-têtes

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

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Start a job execution.

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

JobExecution

Exécution d’un travail

JobExecutionLifecycle

État détaillé de l’exécution du travail.

JobExecutionTarget

Cible sur laquelle une exécution de travail est exécutée.

JobTargetType

Type de la cible.

ProvisioningState

État d’approvisionnement ARM de l’exécution du travail.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

JobExecution

Exécution d’un travail

Nom Type Description
id

string (arm-id)

ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »

name

string

Nom de la ressource

properties.createTime

string (date-time)

Heure à laquelle l’exécution du travail a été créée.

properties.currentAttemptStartTime

string (date-time)

Heure de début de la tentative actuelle.

properties.currentAttempts

integer (int32)

Nombre de tentatives d’exécution du travail.

properties.endTime

string (date-time)

Heure à laquelle l’exécution du travail s’est terminée.

properties.jobExecutionId

string (uuid)

Identificateur unique de l’exécution du travail.

properties.jobVersion

integer (int32)

Numéro de version du travail.

properties.lastMessage

string

Dernier état ou message d’erreur.

properties.lifecycle

JobExecutionLifecycle

État détaillé de l’exécution du travail.

properties.provisioningState

ProvisioningState

État d’approvisionnement ARM de l’exécution du travail.

properties.startTime

string (date-time)

Heure à laquelle l’exécution du travail a démarré.

properties.stepId

integer (int32)

ID de l’étape de travail.

properties.stepName

string

Nom de l’étape de travail.

properties.target

JobExecutionTarget

Cible sur laquelle cette exécution est exécutée.

systemData

systemData

Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy.

type

string

Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts"

JobExecutionLifecycle

État détaillé de l’exécution du travail.

Valeur Description
Created

Créé

InProgress

En cours

WaitingForChildJobExecutions

En attendantUn EmploiExécutions

WaitingForRetry

En attenteForRetry

Succeeded

Réussi

SucceededWithSkipped

RéussiAvecSkippé

Failed

Échec

TimedOut

TimedOut

Canceled

Opération annulée

Skipped

Ignorée

JobExecutionTarget

Cible sur laquelle une exécution de travail est exécutée.

Nom Type Description
databaseName

string

Nom de la base de données.

serverName

string

Nom du serveur.

type

JobTargetType

Type de la cible.

JobTargetType

Type de la cible.

Valeur Description
TargetGroup

Groupe cible

SqlDatabase

SqlDatabase

SqlElasticPool

SqlElasticPool

SqlShardMap

SqlShardMap

SqlServer

SqlServer

ProvisioningState

État d’approvisionnement ARM de l’exécution du travail.

Valeur Description
Created

Créé

InProgress

En cours

Succeeded

Réussi

Failed

Échec

Canceled

Opération annulée

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.