Server Automatic Tuning - Update

Tjänst:: SQL Database

API-version:: 2025-01-01

Uppdatera automatiska justeringsalternativ på servern.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties.desiredState	AutomaticTuningServerMode	Automatiskt justera önskat tillstånd.
properties.options	<string, AutomaticTuningServerOptions>	Definition av automatiska justeringsalternativ.

Svar

Name	Typ	Description
200 OK	ServerAutomaticTuning	Azure-operationen slutfördes framgångsrikt.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Updates server automatic tuning settings with all properties

Updates server automatic tuning settings with minimal properties

Updates server automatic tuning settings with all properties

Exempelbegäran

HTTP

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

{
  "properties": {
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Off"
      },
      "dropIndex": {
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default"
      }
    }
  }
}

Exempelsvar

Statuskod:: 200

{
  "name": "current",
  "type": "Microsoft.Sql/servers/automaticTuning",
  "id": "/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current",
  "properties": {
    "actualState": "Auto",
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "actualState": "Off",
        "desiredState": "Off"
      },
      "dropIndex": {
        "actualState": "On",
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "actualState": "On",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "actualState": "Off",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Updates server automatic tuning settings with minimal properties

Exempelbegäran

HTTP

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

{
  "properties": {
    "desiredState": "Auto"
  }
}

Exempelsvar

Statuskod:: 200

{
  "name": "current",
  "type": "Microsoft.Sql/servers/automaticTuning",
  "id": "/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current",
  "properties": {
    "actualState": "Auto",
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "actualState": "On",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "dropIndex": {
        "actualState": "Off",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "forceLastGoodPlan": {
        "actualState": "On",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "actualState": "Off",
        "desiredState": "Default",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Definitioner

Name	Description
AutomaticTuningOptionModeActual	Verkligt tillstånd för automatisk justeringsalternativ.
AutomaticTuningOptionModeDesired	Önskat tillstånd för alternativ för automatisk justering.
AutomaticTuningServerMode	Automatiskt justera önskat tillstånd.
AutomaticTuningServerOptions	Egenskaper för automatisk justering för enskilda rådgivare.
AutomaticTuningServerReason	Orsaksbeskrivning om önskat och faktiskt tillstånd skiljer sig.
createdByType	Den typ av identitet som skapade resursen.
ErrorAdditionalInfo	Resurshanteringsfelet ytterligare information.
ErrorDetail	Detaljerna om felet.
ErrorResponse	Felsvar
ServerAutomaticTuning	Automatisk justering på servernivå.
systemData	Metadata som rör skapande och senaste ändring av resursen.

AutomaticTuningOptionModeActual

Uppräkning

Verkligt tillstånd för automatisk justeringsalternativ.

Värde	Description
Off	Av
On	På

AutomaticTuningOptionModeDesired

Uppräkning

Önskat tillstånd för alternativ för automatisk justering.

Värde	Description
Off	Av
On	På
Default	Standardinställning

AutomaticTuningServerMode

Uppräkning

Automatiskt justera önskat tillstånd.

Värde	Description
Custom	Skräddarsydd
Auto	Automatisk
Unspecified	Ospecificerad

AutomaticTuningServerOptions

Objekt

Egenskaper för automatisk justering för enskilda rådgivare.

Name	Typ	Description
actualState	AutomaticTuningOptionModeActual	Verkligt tillstånd för automatisk justeringsalternativ.
desiredState	AutomaticTuningOptionModeDesired	Önskat tillstånd för alternativ för automatisk justering.
reasonCode	integer (int32)	Orsakskod om önskat och faktiskt tillstånd skiljer sig.
reasonDesc	AutomaticTuningServerReason	Orsaksbeskrivning om önskat och faktiskt tillstånd skiljer sig.

AutomaticTuningServerReason

Uppräkning

Orsaksbeskrivning om önskat och faktiskt tillstånd skiljer sig.

Värde	Description
Default	Standardinställning
Disabled	Inaktiverad
AutoConfigured	AutoConfigured

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Resurshanteringsfelet ytterligare information.

Name	Typ	Description
info	object	Den ytterligare informationen.
type	string	Typen av ytterligare information.

ErrorDetail

Objekt

Detaljerna om felet.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Felet ytterligare information.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felet objektet.