Server Automatic Tuning - Update

Service:: SQL Database

API-versie:: 2025-01-01

Opties voor automatisch afstemmen op de server bijwerken.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
properties.desiredState	AutomaticTuningServerMode	Automatische afstemmingsstatus.
properties.options	<string, AutomaticTuningServerOptions>	Definitie van opties voor automatisch afstemmen.

Antwoorden

Name	Type	Description
200 OK	ServerAutomaticTuning	Azure-operatie succesvol voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Updates server automatic tuning settings with all properties

Updates server automatic tuning settings with minimal properties

Updates server automatic tuning settings with all properties

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
AutomaticTuningOptionModeActual	Automatische afstemmingsoptie werkelijke status.
AutomaticTuningOptionModeDesired	Automatische afstemmingsoptie gewenste status.
AutomaticTuningServerMode	Automatische afstemmingsstatus.
AutomaticTuningServerOptions	Eigenschappen voor automatisch afstemmen voor individuele adviseurs.
AutomaticTuningServerReason	Redenbeschrijving indien gewenst en werkelijke status verschillen.
createdByType	Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
ServerAutomaticTuning	Automatisch afstemmen op serverniveau.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

AutomaticTuningOptionModeActual

Opsomming

Automatische afstemmingsoptie werkelijke status.

Waarde	Description
Off	Uit
On	On

AutomaticTuningOptionModeDesired

Opsomming

Automatische afstemmingsoptie gewenste status.

Waarde	Description
Off	Uit
On	On
Default	Verstek

AutomaticTuningServerMode

Opsomming

Automatische afstemmingsstatus.

Waarde	Description
Custom	Op maat gemaakt
Auto	Auto
Unspecified	Onbepaald

AutomaticTuningServerOptions

Object

Eigenschappen voor automatisch afstemmen voor individuele adviseurs.

Name	Type	Description
actualState	AutomaticTuningOptionModeActual	Automatische afstemmingsoptie werkelijke status.
desiredState	AutomaticTuningOptionModeDesired	Automatische afstemmingsoptie gewenste status.
reasonCode	integer (int32)	Redencode is indien gewenst en de werkelijke status anders.
reasonDesc	AutomaticTuningServerReason	Redenbeschrijving indien gewenst en werkelijke status verschillen.

AutomaticTuningServerReason

Opsomming

Redenbeschrijving indien gewenst en werkelijke status verschillen.

Waarde	Description
Default	Verstek
Disabled	Disabled
AutoConfigured	AutoConfigured

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.