Job Executions - Create
Inicia una ejecución de trabajos elásticos.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/start?api-version=2025-01-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
job
|
path | True |
string |
Nombre del agente de trabajo que se va a recuperar. |
|
job
|
path | True |
string |
Nombre del trabajo que se va a obtener. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
server
|
path | True |
string |
El nombre del servidor. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de API que se usará para esta operación. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
Operación de Azure completada con éxito. |
|
| 202 Accepted |
Operación de recursos aceptada. Encabezados
|
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Start a job execution.
Solicitud de ejemplo
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
Respuesta de muestra
{
"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
Definiciones
| Nombre | Description |
|---|---|
|
created |
Tipo de identidad que creó el recurso. |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
|
Job |
Ejecución de un trabajo |
|
Job |
Estado detallado de la ejecución del trabajo. |
|
Job |
Destino en el que se ejecuta una ejecución de trabajo. |
|
Job |
Tipo del destino. |
|
Provisioning |
Estado de aprovisionamiento de ARM de la ejecución del trabajo. |
|
system |
Metadatos relativos a la creación y última modificación del recurso. |
createdByType
Tipo de identidad que creó el recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
| Nombre | Tipo | Description |
|---|---|---|
| info |
object |
Información adicional. |
| type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
Objeto de error. |
JobExecution
Ejecución de un trabajo
| Nombre | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nombre del recurso |
| properties.createTime |
string (date-time) |
Hora en que se creó la ejecución del trabajo. |
| properties.currentAttemptStartTime |
string (date-time) |
Hora de inicio del intento actual. |
| properties.currentAttempts |
integer (int32) |
Número de veces que se ha intentado la ejecución del trabajo. |
| properties.endTime |
string (date-time) |
Hora en que se completó la ejecución del trabajo. |
| properties.jobExecutionId |
string (uuid) |
Identificador único de la ejecución del trabajo. |
| properties.jobVersion |
integer (int32) |
Número de versión del trabajo. |
| properties.lastMessage |
string |
Último estado o mensaje de error. |
| properties.lifecycle |
Estado detallado de la ejecución del trabajo. |
|
| properties.provisioningState |
Estado de aprovisionamiento de ARM de la ejecución del trabajo. |
|
| properties.startTime |
string (date-time) |
Hora en que se inició la ejecución del trabajo. |
| properties.stepId |
integer (int32) |
Identificador del paso de trabajo. |
| properties.stepName |
string |
Nombre del paso de trabajo. |
| properties.target |
Destino en el que se ejecuta esta ejecución. |
|
| systemData |
Azure Resource Manager metadatos que contienen información createdBy y modifiedBy. |
|
| type |
string |
Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento" |
JobExecutionLifecycle
Estado detallado de la ejecución del trabajo.
| Valor | Description |
|---|---|
| Created |
Creado |
| InProgress |
En Progreso |
| WaitingForChildJobExecutions |
EsperandoTrabajoHijo Ejecuciones |
| WaitingForRetry |
EsperandoParaRetry |
| Succeeded |
Succeeded |
| SucceededWithSkipped |
SucceededWithSkipped |
| Failed |
Fallido |
| TimedOut |
TimedOut |
| Canceled |
Cancelado |
| Skipped |
Omitida |
JobExecutionTarget
Destino en el que se ejecuta una ejecución de trabajo.
| Nombre | Tipo | Description |
|---|---|---|
| databaseName |
string |
Nombre de la base de datos. |
| serverName |
string |
Nombre del servidor. |
| type |
Tipo del destino. |
JobTargetType
Tipo del destino.
| Valor | Description |
|---|---|
| TargetGroup |
Grupo objetivo |
| SqlDatabase |
SqlDatabase |
| SqlElasticPool |
SqlElasticPool |
| SqlShardMap |
SqlShardMap |
| SqlServer |
SqlServer |
ProvisioningState
Estado de aprovisionamiento de ARM de la ejecución del trabajo.
| Valor | Description |
|---|---|
| Created |
Creado |
| InProgress |
En Progreso |
| Succeeded |
Succeeded |
| Failed |
Fallido |
| Canceled |
Cancelado |
systemData
Metadatos relativos a la creación y última modificación del recurso.
| Nombre | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
| createdBy |
string |
Identidad que creó el recurso. |
| createdByType |
Tipo de identidad que creó el recurso. |
|
| lastModifiedAt |
string (date-time) |
La marca de tiempo de la última modificación del recurso (UTC) |
| lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
| lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |