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 или портала.
serverName	path	True	string	Имя сервера.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

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

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

Ответы

Имя	Тип	Описание
200 OK	JobAgent	Агент задания успешно обновлен.
201 Created	JobAgent	Агент задания успешно создан.
202 Accepted		Принято
Other Status Codes		Ответы на ошибки: *** 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 400 MissingSkuName — требуется имя SKU. 400 InvalidDatabaseResourceId — недопустимый идентификатор ресурса базы данных. 400 MismatchingSubscriptionWithUrl — указанная подписка не соответствует подписке в 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 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 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	Агент задания Azure SQL.
JobAgentState	Состояние агента задания.
Sku	SKU ресурса ARM.

JobAgent

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

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

JobAgentState

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

Имя	Тип	Описание
Creating	string
Deleting	string
Disabled	string
Ready	string
Updating	string

Sku

SKU ресурса ARM.

Имя	Тип	Описание
capacity	integer	Емкость конкретного номера SKU.
family	string	Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь.
name	string	Имя номера SKU, как правило, буква + числовой код, например P3.
size	string	Размер конкретного номера SKU
tier	string	Уровень или выпуск конкретного номера SKU, например "Базовый", "Премиум".

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