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

Nome	Em	Obrigató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 na qual criar a execução do trabalho.
jobName	path	True	string	O nome do trabalho a ser obtido.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio 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

Nome	Tipo	Description
200 OK	JobExecution	Uma execução de trabalho para o trabalho com a ID fornecida já existia.
201 Created	JobExecution	Iniciou com êxito 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 por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por 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 de exemplo

Código de status:: 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 status:: 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 status:: 202

Definições

Nome	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 destino.
ProvisioningState	O estado de provisionamento do ARM da execução do trabalho.

JobExecution

Uma execução de um trabalho

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.createTime	string	A hora em que a execução do trabalho foi criada.
properties.currentAttemptStartTime	string	Hora de início da tentativa atual.
properties.currentAttempts	integer	Número de vezes que a execução do trabalho foi tentada.
properties.endTime	string	A hora em que a execução do trabalho foi concluída.
properties.jobExecutionId	string	O identificador exclusivo da execução do trabalho.
properties.jobVersion	integer	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	A hora em que a execução do trabalho foi iniciada.
properties.stepId	integer	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.
type	string	Tipo de recurso.

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

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

Nome	Tipo	Description
SqlDatabase	string
SqlElasticPool	string
SqlServer	string
SqlShardMap	string
TargetGroup	string

ProvisioningState

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

Nome	Tipo	Description
Canceled	string
Created	string
Failed	string
InProgress	string
Succeeded	string

Compartilhar via