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 |
|---|---|---|---|---|
|
job
|
path | True |
string |
O nome do agente de trabalho a ser recuperado. |
|
job
|
path | True |
string |
O nome do trabalho a ser obtido. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
server
|
path | True |
string |
O nome do servidor. |
|
subscription
|
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 |
Operação do Azure concluída com sucesso. |
|
| 202 Accepted |
Operação de recurso aceita. Cabeçalhos
|
|
| Other Status Codes |
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 |
|---|---|
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Job |
Uma execução de um trabalho |
|
Job |
O estado detalhado da execução do trabalho. |
|
Job |
O destino no qual uma execução de trabalho é executada. |
|
Job |
O tipo do destino. |
|
Provisioning |
O estado de provisionamento do ARM da execução do trabalho. |
|
system |
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 |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
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 |
O estado detalhado da execução do trabalho. |
|
| properties.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 |
O destino no qual essa execução é executada. |
|
| 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 |
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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |