Jobs - Create Or Update

Cria ou atualiza um trabalho.

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

Parâmetros de URI

Name In Required Type Description
jobAgentName
path True
  • string

O nome do agente de 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.

Corpo da solicitação

Name Type Description
properties.description
  • string

Descrição definida pelo usuário do trabalho.

properties.schedule

Agende propriedades do trabalho.

Respostas

Name Type Description
200 OK

Atualizou o trabalho com êxito.

201 Created

Criou o trabalho com êxito.

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.

  • 400 InvalidResourceRequestBody - As propriedades de recurso ou recurso no corpo da solicitação estão vazias ou inválidas.

  • 400 InvalidDuration – Duração inválida.

  • 404 JobAgentNotFound – O agente de trabalho especificado não existe no servidor lógico especificado.

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

Exemplos

Create a job with all properties specified
Create a job with default properties

Create a job with all properties specified

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1?api-version=2021-02-01-preview

{
  "properties": {
    "description": "my favourite job",
    "schedule": {
      "startTime": "2015-09-24T18:30:01Z",
      "endTime": "2015-09-24T23:59:59Z",
      "type": "Recurring",
      "interval": "PT5M",
      "enabled": true
    }
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "my favourite job",
    "version": 0,
    "schedule": {
      "startTime": "2015-09-24T18:30:01Z",
      "endTime": "2015-09-24T23:59:59Z",
      "type": "Recurring",
      "interval": "PT5M",
      "enabled": true
    }
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "my favourite job",
    "version": 0,
    "schedule": {
      "startTime": "2015-09-24T18:30:01Z",
      "endTime": "2015-09-24T23:59:59Z",
      "type": "Recurring",
      "interval": "PT5M",
      "enabled": true
    }
  }
}

Create a job with default properties

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1?api-version=2021-02-01-preview

{}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "",
    "version": 0,
    "schedule": {
      "startTime": "0001-01-01T00:00:00Z",
      "endTime": "9999-12-31T11:59:59Z",
      "type": "Once",
      "enabled": false
    }
  }
}
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "",
    "version": 0,
    "schedule": {
      "startTime": "0001-01-01T00:00:00Z",
      "endTime": "9999-12-31T11:59:59Z",
      "type": "Once",
      "enabled": false
    }
  }
}

Definições

Job

Um trabalho.

JobSchedule

Agendando propriedades de um trabalho.

JobScheduleType

Tipo de intervalo de agendamento

Job

Um trabalho.

Name Type Description
id
  • string

ID do recurso.

name
  • string

Nome do recurso.

properties.description
  • string

Descrição definida pelo usuário do trabalho.

properties.schedule

Agende propriedades do trabalho.

properties.version
  • integer

O número da versão do trabalho.

type
  • string

Tipo de recurso.

JobSchedule

Agendando propriedades de um trabalho.

Name Type Default Value Description
enabled
  • boolean

Se a agenda está habilitada ou não.

endTime
  • string
9999-12-31T11:59:59+00:00

Hora de término da agenda.

interval
  • string

Valor do intervalo recorrente do agendamento, se o ScheduleType for recorrente. Formato de duração ISO8601.

startTime
  • string
0001-01-01T00:00:00+00:00

Hora de início da agenda.

type Once

Tipo de intervalo de agendamento

JobScheduleType

Tipo de intervalo de agendamento

Name Type Description
Once
  • string
Recurring
  • string