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


Job Agents - Create Or Update

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

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

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

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

Определения

Имя Описание
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, например "Базовый", "Премиум".