Server Automatic Tuning - Get

Service:

SQL Database

API Version:

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	リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

応答

名前	型	説明
200 OK	ServerAutomaticTuning	サーバーの自動チューニング プロパティが正常に取得されました。
Other Status Codes		エラー応答: *** 400 FeatureDisabledOnSelectedEdition - ユーザーが現在のデータベース エディションで無効になっている機能を使用しようとしました。 400 InvalidIdentifier - 識別子に NULL または無効な Unicode 文字が含まれています。 404 DatabaseDoesNotExist - 要求されたデータベースが見つかりませんでした 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 SubscriptionDoesNotHaveElasticPool - 要求されたエラスティック プールが見つかりませんでした 404 OperationIdNotFound - Id を持つ操作が存在しません。 405 NotSupported - この機能はサポートされていません。 409 競合 - 要求の競合が原因で要求を処理できませんでした。 409 OperationCancelled - 操作がユーザーによって取り消されました。 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。 操作をやり直してください。 503 ServiceTemporarilyUnavailable - 機能は一時的に使用できません。 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求数を超える要求。

例

Get a server's automatic tuning settings

Sample Request

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

import com.azure.core.util.Context;

/** 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", 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

Sample Response

Status code:

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	リソースの ID
name	string	リソース名。
properties.actualState	AutomaticTuningServerMode	自動チューニングの実際の状態。
properties.desiredState	AutomaticTuningServerMode	目的の状態を自動チューニングします。
properties.options	<string,  AutomaticTuningServerOptions>	自動チューニング オプションの定義。
type	string	リソースの種類。