Job Executions - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria ou atualiza uma execução de trabalho.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
jobAgentName	path	True	string	O nome do agente de trabalho.
jobExecutionId	path	True	string (uuid)	A id de execução do trabalho para criar a execução do trabalho em.
jobName	path	True	string	O nome do trabalho a obter.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Respostas

Name	Tipo	Description
200 OK	JobExecution	Já existia uma execução de trabalho para o trabalho com o id fornecido.
201 Created	JobExecution	Iniciou com sucesso uma execução para o trabalho.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 ElasticJobsOperationFailed - Falha na operação de gerenciamento de trabalhos elásticos. 400 ElasticJobsOperationFailed - Falha na operação de gerenciamento de trabalhos elásticos. 404 JobAgentNotFound - O agente de trabalho especificado não existe no servidor lógico especificado. 404 ResourceNotFound - O recurso solicitado não foi encontrado. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 OperationIdNotFound - A operação com Id não existe. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.

Exemplos

Create job execution.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5A86BF65-43AC-F258-2524-9E92992F97CA?api-version=2021-11-01


import java.util.UUID;

/**
 * Samples for JobExecutions CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobExecution.json
     */
    /**
     * Sample code: Create job execution.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createJobExecution(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobExecutions().createOrUpdate("group1", "server1", "agent1",
            "job1", UUID.fromString("5A86BF65-43AC-F258-2524-9E92992F97CA"), com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:: 200

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2017-12-18T19:02:00.8707045Z",
    "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:: 201

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2017-05-04T19:02:00.8707045Z",
    "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 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.

JobExecution

Object

Uma execução de um trabalho

Name	Tipo	Description
id	string	ID do recurso.
name	string	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.
type	string	Tipo de recurso.

JobExecutionLifecycle

Enumeração

O estado detalhado da execução do trabalho.

Valor	Description
Canceled
Created
Failed
InProgress
Skipped
Succeeded
SucceededWithSkipped
TimedOut
WaitingForChildJobExecutions
WaitingForRetry

JobExecutionTarget

Object

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

Name	Tipo	Description
databaseName	string	O nome do banco de dados.
serverName	string	O nome do servidor.
type	JobTargetType	O tipo do alvo.

JobTargetType

Enumeração

O tipo do alvo.

Valor	Description
SqlDatabase
SqlElasticPool
SqlServer
SqlShardMap
TargetGroup

ProvisioningState

Enumeração

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

Valor	Description
Canceled
Created
Failed
InProgress
Succeeded

Partilhar via

Job Executions - Create Or Update

Parâmetros do URI

Respostas

Exemplos

Create job execution.

Pedido de amostra

Resposta da amostra

Definições

JobExecution

JobExecutionLifecycle

JobExecutionTarget

JobTargetType

ProvisioningState

Recursos adicionais