Job Executions - Create

Inicia uma execução de trabalho elástico.

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 do URI

Name Em Obrigatório Tipo Descrição
jobAgentName
path True

string

O nome do agente de trabalho a ser recuperado.

jobName
path True

string

O nome do trabalho a obter.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Descrição
200 OK

JobExecution

Operação do Azure concluída com sucesso.

202 Accepted

Operação de recurso aceita.

Cabeçalhos

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

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Descrição
user_impersonation personificar a sua conta de utilizador

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=2025-01-01

Resposta da amostra

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

Definições

Name Descrição
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

JobExecution

Uma execução de um trabalho

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

JobExecutionTarget

O destino no qual uma execução de trabalho é executada.

JobTargetType

O tipo do alvo.

ProvisioningState

O estado de provisionamento ARM da execução do trabalho.

systemData

Metadados referentes à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Descrição
error

ErrorDetail

O objeto de erro.

JobExecution

Uma execução de um trabalho

Name Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.createTime

string (date-time)

A hora em que a execução do trabalho foi criada.

properties.currentAttemptStartTime

string (date-time)

Hora de início da tentativa atual.

properties.currentAttempts

integer (int32)

Número de vezes que a execução do trabalho foi tentada.

properties.endTime

string (date-time)

O tempo que a execução do trabalho foi concluída.

properties.jobExecutionId

string (uuid)

O identificador exclusivo da execução do trabalho.

properties.jobVersion

integer (int32)

O número da versão do trabalho.

properties.lastMessage

string

O último status ou mensagem de erro.

properties.lifecycle

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

properties.provisioningState

ProvisioningState

O estado de provisionamento ARM da execução do trabalho.

properties.startTime

string (date-time)

A hora em que a execução do trabalho começou.

properties.stepId

integer (int32)

O ID da etapa do trabalho.

properties.stepName

string

O nome da etapa do trabalho.

properties.target

JobExecutionTarget

O destino no qual essa execução é executada.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

Valor Descrição
Created

Criado

InProgress

Em curso

WaitingForChildJobExecutions

À Espera DeEmpregoCriançaExecuções

WaitingForRetry

À EsperaParaTentativa

Succeeded

Succeeded

SucceededWithSkipped

ConseguidoComSkipped

Failed

Falha

TimedOut

Tempo Limite Excedido

Canceled

Cancelado

Skipped

Omitida

JobExecutionTarget

O destino no qual uma execução de trabalho é executada.

Name Tipo Descrição
databaseName

string

O nome do banco de dados.

serverName

string

O nome do servidor.

type

JobTargetType

O tipo do alvo.

JobTargetType

O tipo do alvo.

Valor Descrição
TargetGroup

Grupo-Alvo

SqlDatabase

SqlDatabase

SqlElasticPool

SqlElasticPool

SqlShardMap

SqlShardMap

SqlServer

SqlServer

ProvisioningState

O estado de provisionamento ARM da execução do trabalho.

Valor Descrição
Created

Criado

InProgress

Em curso

Succeeded

Succeeded

Failed

Falha

Canceled

Cancelado

systemData

Metadados referentes à criação e última modificação do recurso.

Name Tipo Descrição
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.