Workload Groups - Create Or Update

Ссылка

Служба:: SQL Database

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

Создает или обновляет группу рабочей нагрузки.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/workloadGroups/{workloadGroupName}?api-version=2021-11-01

Параметры URI

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

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

Имя	Обязательно	Тип	Описание
properties.maxResourcePercent	True	integer	Ресурс ограничения группы рабочей нагрузки в процентах.
properties.minResourcePercent	True	integer	Минимальный процент ресурсов группы рабочей нагрузки.
properties.minResourcePercentPerRequest	True	number	Группа рабочей нагрузки запрашивает минимальный процент предоставления.
properties.importance		string	Уровень важности группы рабочей нагрузки.
properties.maxResourcePercentPerRequest		number	Группа рабочей нагрузки запрашивает максимальный процент предоставления.
properties.queryExecutionTimeout		integer	Время ожидания выполнения запроса группы рабочей нагрузки.

Ответы

Имя	Тип	Описание
200 OK	WorkloadGroup	Группа рабочей нагрузки успешно обновлена.
201 Created	WorkloadGroup	Группа рабочей нагрузки успешно создана.
202 Accepted		Создайте или обновите принятую группу рабочей нагрузки.
Other Status Codes		Ответы об ошибках: *** 400 OperationNotAllowedOnPausedDatabase — операция не разрешена в приостановленной базе данных. 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 InvalidWorkloadGroupNameParameter — недопустимое имя группы рабочей нагрузки 400 InvalidMinResourcePercentParameter — недопустимый минимальный процент ресурсов для этой группы рабочей нагрузки. 400 InvalidMinResourcePercentPerRequestParameter — недопустимый минимальный процент ресурсов на запрос для этой группы рабочей нагрузки. 400 InvalidMaxResourcePercentParameter — недопустимый максимальный процент ресурсов, выделяемых для этой группы рабочей нагрузки. 400 InvalidMaxResourcePercentPerRequestParameter — недопустимый максимальный процент ресурсов на запрос для этой группы рабочей нагрузки. 400 InvalidImportanceParameter — важность должна иметь одну из следующих строк: Low, Below_Normal, Normal, Above_Normal, High. 400 InvalidQueryExecutionTimeoutParameter — недопустимое значение времени ожидания выполнения запроса для этой группы рабочей нагрузки. 400 InvalidResourceRequestBody — свойства ресурса или ресурса в тексте запроса пусты или недопустимы. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 DatabaseDoesNotExist — пользователь указал имя базы данных, которое не существует в этом экземпляре сервера. 404 ResourceNotFound — запрошенный ресурс не найден. 404 OperationIdNotFound — операция с идентификатором не существует. 409 ConflictingDatabaseOperation — в базе данных уже существует определенная операция, и текущая операция должна подождать, пока она будет выполнена. 409 ConflictingSystemOperationInProgress — в базе данных выполняется операция обслуживания системы, и для дальнейших операций необходимо дождаться ее завершения. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 503 DatabaseUnavailable — операция завершилась сбоем, так как база данных недоступна. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Create a workload group with all properties specified.

Create a workload group with the required properties specified.

Create a workload group with all properties specified.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc?api-version=2021-11-01

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  }
}


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

/**
 * Samples for WorkloadGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateWorkloadGroupMax.json
     */
    /**
     * Sample code: Create a workload group with all properties specified.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createAWorkloadGroupWithAllPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getWorkloadGroups().createOrUpdate("Default-SQL-SouthEastAsia",
            "testsvr", "testdb", "smallrc",
            new WorkloadGroupInner().withMinResourcePercent(0).withMaxResourcePercent(100)
                .withMinResourcePercentPerRequest(3.0).withMaxResourcePercentPerRequest(3.0D).withImportance("normal")
                .withQueryExecutionTimeout(0),
            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

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}

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

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}

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

Create a workload group with the required properties specified.

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

HTTP
Java

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc?api-version=2021-11-01

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3
  }
}


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

/**
 * Samples for WorkloadGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateWorkloadGroupMin.json
     */
    /**
     * Sample code: Create a workload group with the required properties specified.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createAWorkloadGroupWithTheRequiredPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getWorkloadGroups().createOrUpdate(
            "Default-SQL-SouthEastAsia", "testsvr", "testdb", "smallrc", new WorkloadGroupInner()
                .withMinResourcePercent(0).withMaxResourcePercent(100).withMinResourcePercentPerRequest(3.0),
            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

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}

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

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}

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

Определения

WorkloadGroup

Операции группы рабочей нагрузки для хранилища данных

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.importance	string	Уровень важности группы рабочей нагрузки.
properties.maxResourcePercent	integer	Ресурс ограничения группы рабочей нагрузки в процентах.
properties.maxResourcePercentPerRequest	number	Группа рабочей нагрузки запрашивает максимальный процент предоставления.
properties.minResourcePercent	integer	Минимальный процент ресурсов группы рабочей нагрузки.
properties.minResourcePercentPerRequest	number	Группа рабочей нагрузки запрашивает минимальный процент предоставления.
properties.queryExecutionTimeout	integer	Время ожидания выполнения запроса группы рабочей нагрузки.
type	string	Тип ресурса.

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

Workload Groups - Create Or Update

Параметры URI

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

Ответы

Примеры

Create a workload group with all properties specified.

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

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

Create a workload group with the required properties specified.

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

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

Определения

WorkloadGroup

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