Job Agents - 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}?api-version=2021-11-01

Параметры URI

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

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

Имя	Обязательно	Тип	Описание
location	True	string	Расположение ресурса.
properties.databaseId	True	string (arm-id)	Идентификатор ресурса базы данных для хранения метаданных задания.
sku		Sku	Имя и уровень номера SKU.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	JobAgent	Успешно обновлен агент задания.
201 Created	JobAgent	Успешно создан агент задания.
202 Accepted		Принято
Other Status Codes		Ответы на ошибки: *** 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 400 MissingSkuName — имя Sku является обязательным. 400 InvalidDatabaseResourceId — недопустимый идентификатор ресурса базы данных. 400 НесоответствиеSubscriptionWithUrl — указанная подписка не соответствует подписке в URL-адресе. 400 MismatchingResourceGroupNameWithUrl — предоставленное имя группы ресурсов не совпадает с именем в URL-адресе. 400 MismatchingServerNameWithUrl — предоставленное имя сервера не совпадает с именем в URL-адресе. 400 JobAgentDatabaseEditionUnsupported — цель уровня обслуживания указанной базы данных не поддерживается для использования в качестве базы данных агента заданий. 400 JobAgentDatabaseSecondary — агент задания не может быть связан с гео-вторичной базой данных. 400 JobAgentDatabaseAlreadyLinked — указанная база данных уже связана с другим агентом задания. 400 DatabaseDoesNotExist — запрошенная база данных не найдена 400 CannotUseReservedDatabaseName— не удается использовать зарезервированное имя базы данных в этой операции. 400 JobAgentExceededQuota — не удалось создать агент задания, так как он превысит квоту. 400 JobAgentAlreadyExists — агент задания уже существует на сервере. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 PropertyChangeUnsupported — свойство нельзя изменить. 404 SubscriptionNotFound — запрошенная подписка не найдена. 404 OperationIdNotFound — операция с идентификатором не существует. 409 ServerDisabled — сервер отключен. 409 OperationCancelled — операция отменена пользователем. 409 Operation Прервана — операция с ресурсом не удалось завершить, так как она была прервана другой операцией в том же ресурсе. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатился. Повторите операцию. 503 TooManyRequests — запросы, превышающие максимальные запросы, которые могут обрабатываться доступными ресурсами.

Примеры

Create or update a job agent

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

{
  "location": "southeastasia",
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}


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

/**
 * Samples for JobAgents CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobAgent.json
     */
    /**
     * Sample code: Create or update a job agent.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateAJobAgent(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobAgents().createOrUpdate("group1", "server1", "agent1",
            new JobAgentInner().withLocation("southeastasia").withDatabaseId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"),
            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",
  "name": "agent1",
  "type": "Microsoft.Sql/servers/jobAgents",
  "location": "southeastasia",
  "sku": {
    "name": "Agent",
    "capacity": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1",
  "name": "agent1",
  "type": "Microsoft.Sql/servers/jobAgents",
  "location": "southeastasia",
  "sku": {
    "name": "Agent",
    "capacity": 100
  },
  "properties": {
    "databaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/databases/db1"
  }
}

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

Определения

Имя	Описание
JobAgent	Агент задания SQL Azure.
JobAgentState	Состояние агента задания.
Sku	SKU ресурса ARM.

JobAgent

Object

Агент задания SQL Azure.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
location	string	Расположение ресурса.
name	string	Имя ресурса.
properties.databaseId	string (arm-id)	Идентификатор ресурса базы данных для хранения метаданных задания.
properties.state	JobAgentState	Состояние агента задания.
sku	Sku	Имя и уровень номера SKU.
tags	object	Теги ресурсов.
type	string	Тип ресурса.

JobAgentState

Перечисление

Состояние агента задания.

Значение	Описание
Creating
Deleting
Disabled
Ready
Updating

Sku