Server Automatic Tuning - Get

Служба:

SQL Database

Версия API:

2021-11-01

Извлекает параметры автоматической настройки сервера.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/automaticTuning/current?api-version=2021-11-01

Параметры URI

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

Ответы

Имя	Тип	Описание
200 OK	ServerAutomaticTuning	Свойства автоматической настройки сервера успешно получены.
Other Status Codes		Ответы об ошибках: *** 400 FeatureDisabledOnSelectedEdition — пользователь попытался использовать функцию, которая отключена в текущем выпуске базы данных. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода. 404 DatabaseDoesNotExist — запрошенная база данных не найдена 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден. 404 SubscriptionDoesNotHaveElasticPool — запрошенный эластичный пул не найден 404 OperationIdNotFound — операция с идентификатором не существует. 405 NotSupported — эта функция не поддерживается. 409 Conflict — не удалось обработать запрос из-за конфликта в запросе. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 503 ServiceTemporarilyUnavailable — компонент временно недоступен. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами.

Примеры

Get a server's automatic tuning settings

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

HTTP

GET https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2021-11-01

Java

/**
 * Samples for ServerAutomaticTuning Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerAutomaticTuningGet.json
     */
    /**
     * Sample code: Get a server's automatic tuning settings.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAServerSAutomaticTuningSettings(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerAutomaticTunings().getWithResponse("default-sql-onebox",
            "testsvr11", 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/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current",
  "name": "current",
  "type": "Microsoft.Sql/servers/automaticTuning",
  "properties": {
    "desiredState": "Auto",
    "actualState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "dropIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Определения

Имя	Описание
AutomaticTuningOptionModeActual	Фактическое состояние параметра автоматической настройки.
AutomaticTuningOptionModeDesired	Требуемое состояние параметра автоматической настройки.
AutomaticTuningServerMode	Автоматическая настройка требуемого состояния.
AutomaticTuningServerOptions	Свойства автоматической настройки для отдельных помощников.
AutomaticTuningServerReason	При необходимости описание причины и фактическое состояние отличаются.
ServerAutomaticTuning	Автоматическая настройка на уровне сервера.

AutomaticTuningOptionModeActual

Фактическое состояние параметра автоматической настройки.

Имя	Тип	Описание
Off	string
On	string

AutomaticTuningOptionModeDesired

Требуемое состояние параметра автоматической настройки.

Имя	Тип	Описание
Default	string
Off	string
On	string

AutomaticTuningServerMode

Автоматическая настройка требуемого состояния.

Имя	Тип	Описание
Auto	string
Custom	string
Unspecified	string

AutomaticTuningServerOptions

Свойства автоматической настройки для отдельных помощников.

Имя	Тип	Описание
actualState	AutomaticTuningOptionModeActual	Фактическое состояние параметра автоматической настройки.
desiredState	AutomaticTuningOptionModeDesired	Требуемое состояние параметра автоматической настройки.
reasonCode	integer	При необходимости код причины и фактическое состояние отличаются.
reasonDesc	AutomaticTuningServerReason	При необходимости описание причины и фактическое состояние отличаются.

AutomaticTuningServerReason

При необходимости описание причины и фактическое состояние отличаются.

Имя	Тип	Описание
AutoConfigured	string
Default	string
Disabled	string

ServerAutomaticTuning

Автоматическая настройка на уровне сервера.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.actualState	AutomaticTuningServerMode	Автоматическая настройка фактического состояния.
properties.desiredState	AutomaticTuningServerMode	Автоматическая настройка требуемого состояния.
properties.options	<string,  AutomaticTuningServerOptions>	Определение параметров автоматической настройки.
type	string	Тип ресурса.