Partilhar via

Job Executions - Create

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Inicia uma execução de tarefa elástica.

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

Parâmetros do URI

Name Em Necessário Tipo Description
jobAgentName
 path True

string

O nome do agente de tarefas.
jobName
 path True

string

O nome da tarefa a obter.
resourceGroupName
 path True

string

O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName
 path True

string

O nome do servidor.
subscriptionId
 path True

string

O ID da subscrição que identifica uma subscrição do Azure.
api-version
 query True

string

A versão da API a utilizar para o pedido.

Respostas

Name Tipo Description
200 OK

JobExecution

Iniciou com êxito uma execução para a tarefa.
202 Accepted

Aceite
Other Status Codes

Respostas de Erro: ***

  • 400 ElasticJobsOperationFailed – Falha na operação de gestão de tarefas elásticas.

  • 400 ElasticJobsOperationFailed – Falha na operação de gestão de tarefas elásticas.

  • 404 JobAgentNotFound - O agente de tarefas especificado não existe no servidor lógico especificado.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 OperationIdNotFound - A operação com o ID não existe.

  • 409 OperationCancelled - A operação foi cancelada pelo utilizador.

  • 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

Start a job execution.

Pedido de amostra

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=2021-11-01

Resposta da amostra

Código de estado:
200 
{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2016-09-23T01:00:00Z",
    "currentAttempts": 0,
    "lastMessage": "Job execution created."
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999",
  "name": "5555-6666-7777-8888-999999999999",
  "type": "Microsoft.Sql/servers/jobAgents/executions"
}
Código de estado:
202

Definições

Name Description
JobExecution

Uma execução de uma tarefa
JobExecutionLifecycle

O estado detalhado da execução da tarefa.
JobExecutionTarget

O destino em que uma execução de trabalho é executada.
JobTargetType

O tipo de destino.
ProvisioningState

O estado de aprovisionamento do ARM da execução da tarefa.

JobExecution

Uma execução de uma tarefa

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.createTime

string

A hora em que a execução da tarefa foi criada.
properties.currentAttemptStartTime

string

Hora de início da tentativa atual.
properties.currentAttempts

integer

Número de vezes que a execução da tarefa foi tentada.
properties.endTime

string

A hora em que a execução da tarefa foi concluída.
properties.jobExecutionId

string

O identificador exclusivo da execução da tarefa.
properties.jobVersion

integer

O número da versão da tarefa.
properties.lastMessage

string

O último estado ou mensagem de erro.
properties.lifecycle

JobExecutionLifecycle

O estado detalhado da execução da tarefa.
properties.provisioningState

ProvisioningState

O estado de aprovisionamento do ARM da execução da tarefa.
properties.startTime

string

A hora em que a execução da tarefa foi iniciada.
properties.stepId

integer

O ID do passo do trabalho.
properties.stepName

string

O nome do passo da tarefa.
properties.target

JobExecutionTarget

O destino em que esta execução é executada.
type

string

Tipo de recurso.

JobExecutionLifecycle

O estado detalhado da execução da tarefa.

Name Tipo Description
Canceled

string

Created

string

Failed

string

InProgress

string

Skipped

string

Succeeded

string

SucceededWithSkipped

string

TimedOut

string

WaitingForChildJobExecutions

string

WaitingForRetry

string

JobExecutionTarget

O destino em que uma execução de trabalho é executada.

Name Tipo Description
databaseName

string

O nome da base de dados.
serverName

string

O nome do servidor.
type

JobTargetType

O tipo de destino.

JobTargetType

O tipo de destino.

Name Tipo Description
SqlDatabase

string

SqlElasticPool

string

SqlServer

string

SqlShardMap

string

TargetGroup

string

ProvisioningState

O estado de aprovisionamento do ARM da execução da tarefa.

Name Tipo Description
Canceled

string

Created

string

Failed

string

InProgress

string

Succeeded

string