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
jobAgentName
path True

string

Nombre del agente de trabajo que se va a recuperar.

jobName
path True

string

Nombre del trabajo que se va a obtener.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

serverName
path True

string

El nombre del servidor.

subscriptionId
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

JobExecution

Operación de Azure completada con éxito.

202 Accepted

Operación de recursos aceptada.

Encabezados

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

ErrorResponse

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
createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

JobExecution

Ejecución de un trabajo

JobExecutionLifecycle

Estado detallado de la ejecución del trabajo.

JobExecutionTarget

Destino en el que se ejecuta una ejecución de trabajo.

JobTargetType

Tipo del destino.

ProvisioningState

Estado de aprovisionamiento de ARM de la ejecución del trabajo.

systemData

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

JobExecutionLifecycle

Estado detallado de la ejecución del trabajo.

properties.provisioningState

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

JobExecutionTarget

Destino en el que se ejecuta esta ejecución.

systemData

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

JobTargetType

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

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

createdByType

Tipo de identidad que modificó por última vez el recurso.