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

Nome Em Obrigatório Tipo Description
jobAgentName
path True

string

O nome do agente de trabalho a ser recuperado.

jobName
path True

string

O nome do trabalho a ser obtido.

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 uma UUID.

api-version
query True

string

minLength: 1

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

Respostas

Nome Tipo Description
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
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Start a job execution.

Solicitação de exemplo

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 de exemplo

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

Nome Description
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

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 destino.

ProvisioningState

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

systemData

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

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

JobExecution

Uma execução de um trabalho

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada 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)

A hora em 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 do ARM da execução do trabalho.

properties.startTime

string (date-time)

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

properties.stepId

integer (int32)

A ID da etapa de trabalho.

properties.stepName

string

O nome da etapa de 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. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

Valor Description
Created

Criado

InProgress

InProgress

WaitingForChildJobExecutions

Esperando por Emprego Infantil

WaitingForRetry

EsperandoParaRetenta

Succeeded

Succeeded

SucceededWithSkipped

ConseguidoCom Pulado

Failed

Falha

TimedOut

Tempo Esgotado

Canceled

Cancelado

Skipped

Ignorado

JobExecutionTarget

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

Nome Tipo Description
databaseName

string

Nome do banco de dados.

serverName

string

O nome do servidor.

type

JobTargetType

O tipo do destino.

JobTargetType

O tipo do destino.

Valor Description
TargetGroup

Grupo-Alvo

SqlDatabase

SqlDatabase

SqlElasticPool

SqlElasticPool

SqlShardMap

SqlShardMap

SqlServer

SqlServer

ProvisioningState

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

Valor Description
Created

Criado

InProgress

InProgress

Succeeded

Succeeded

Failed

Falha

Canceled

Cancelado

systemData

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

Nome Tipo Description
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.