Jobs - Create Or Update

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Создает или обновляет задание.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
jobAgentName	path	True	string	Имя агента задания.
jobName	path	True	string	Имя задания, который требуется получить.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Текст запроса

Имя	Тип	Описание
properties.description	string	Пользовательское описание задания.
properties.schedule	JobSchedule	Планирование свойств задания.

Ответы

Имя	Тип	Описание
200 OK	Job	Задание успешно обновлено.
201 Created	Job	Задание успешно создано.
Other Status Codes		Ответы на ошибки: *** 400 ElasticJobsOperationFailed — сбой операции управления заданиями обработки эластичных баз данных. 400 ElasticJobsOperationFailed — сбой операции управления заданиями обработки эластичных баз данных. 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 400 InvalidDuration — недопустимая длительность. 404 JobAgentNotFound — указанный агент задания не существует на указанном логическом сервере. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

Имя

Тип

Описание

200 OK

Job

Задание успешно обновлено.

201 Created

Job

Задание успешно создано.

Other Status Codes

Ответы на ошибки: ***

400 ElasticJobsOperationFailed — сбой операции управления заданиями обработки эластичных баз данных.
400 ElasticJobsOperationFailed — сбой операции управления заданиями обработки эластичных баз данных.
400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы.
400 InvalidDuration — недопустимая длительность.
404 JobAgentNotFound — указанный агент задания не существует на указанном логическом сервере.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

Примеры

Create a job with all properties specified

Create a job with default properties

Create a job with all properties specified

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-11-01

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


import com.azure.resourcemanager.sql.fluent.models.JobInner;
import com.azure.resourcemanager.sql.models.JobSchedule;
import com.azure.resourcemanager.sql.models.JobScheduleType;
import java.time.OffsetDateTime;

/**
 * Samples for Jobs CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobMax.json
     */
    /**
     * Sample code: Create a job with all properties specified.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAJobWithAllPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobs().createOrUpdateWithResponse("group1", "server1", "agent1",
            "job1",
            new JobInner().withDescription("my favourite job")
                .withSchedule(new JobSchedule().withStartTime(OffsetDateTime.parse("2015-09-24T18:30:01Z"))
                    .withEndTime(OffsetDateTime.parse("2015-09-24T23:59:59Z")).withType(JobScheduleType.RECURRING)
                    .withEnabled(true).withInterval("PT5M")),
            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

Пример ответа

Код состояния:: 200

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

Код состояния:: 201

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

Образец запроса

HTTP
Java

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-11-01

{}


import com.azure.resourcemanager.sql.fluent.models.JobInner;

/**
 * Samples for Jobs CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobMin.json
     */
    /**
     * Sample code: Create a job with default properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAJobWithDefaultProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobs().createOrUpdateWithResponse("group1", "server1", "agent1",
            "job1", new JobInner(), 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

Пример ответа

Код состояния:: 200

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

Код состояния:: 201

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

Определения

Имя	Описание
Job	Задание.
JobSchedule	Свойства планирования задания.
JobScheduleType	Тип интервала расписания

Job

Задание.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.description	string	Пользовательское описание задания.
properties.schedule	JobSchedule	Планирование свойств задания.
properties.version	integer	Номер версии задания.
type	string	Тип ресурса.

JobSchedule

Свойства планирования задания.

Имя	Тип	Default value	Описание
enabled	boolean		Указывает, включено ли расписание.
endTime	string	9999-12-31T11:59:59+00:00	Запланируйте время окончания.
interval	string		Значение повторяющегося интервала расписания, если ScheduleType является повторяющимся. ISO8601 формат длительности.
startTime	string	0001-01-01T00:00:00+00:00	Запланируйте время начала.
type	JobScheduleType	Once	Тип интервала расписания

JobScheduleType

Тип интервала расписания

Имя	Тип	Описание
Once	string
Recurring	string

Поделиться через

Jobs - Create Or Update

Параметры URI

Текст запроса

Ответы

Примеры

Create a job with all properties specified

Образец запроса

Пример ответа

Create a job with default properties

Образец запроса

Пример ответа

Определения

Job

JobSchedule

JobScheduleType

Дополнительные ресурсы