Server Automatic Tuning - Update

Automatische afstemmingsopties op de server bijwerken.

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

URI-parameters

Name In Required Type Description
resourceGroupName
path True
  • string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via Azure Resource Manager API of de portal.

serverName
path True
  • string

De naam van de server.

subscriptionId
path True
  • string

De abonnements-id die een Azure-abonnement identificeert.

api-version
query True
  • string

De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name Type Description
properties.desiredState

Automatisch afstemmen van de gewenste status.

properties.options

Definitie van opties voor automatisch afstemmen.

Antwoorden

Name Type Description
200 OK

De opties voor automatisch afstemmen op serverniveau zijn bijgewerkt.

Other Status Codes

Foutreacties: ***

  • 400 FeatureDisabledOnSelectedEdition: de gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld in de huidige database-editie.

  • 400 InvalidIdentifier: de id bevat NULL of een ongeldig unicode-teken.

  • 400 InvalidAutomaticTuningUpsertRequest: de aanvraag voor automatische afstemming van de update bestaat niet of heeft geen eigenschappenobject.

  • 400 Invalid AdvisorAutoExecuteStatus: de opgegeven status voor automatisch uitvoeren voor de advisor is niet toegestaan.

  • 404 DatabaseDoesNotExist - De aangevraagde database is niet gevonden

  • 404 SubscriptionDoesNotHostServer - De aangevraagde server is niet gevonden

  • 404 SubscriptionDoesNotAsticPool - De aangevraagde elastische pool is niet gevonden

  • 404 OperationIdNotFound: de bewerking met Id bestaat niet.

  • 404 AutomaticTuningOptionNotFound: de aangevraagde optie voor automatisch afstemmen is niet gevonden.

  • 405 Niet ondersteund: deze functionaliteit wordt niet ondersteund.

  • 409 Conflict: de aanvraag kan niet worden verwerkt vanwege een conflict in de aanvraag.

  • 409 OperationCancelled: de bewerking is geannuleerd door de gebruiker.

  • 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource.

  • 409 Default AdvisorStateNotAllowedInCustomServerMode - STANDAARD advisor status niet toegestaan in aangepaste modus

  • 409 UpdateNotAllowedIfServerAutotuningUpdateOperationInProgress: instellingen voor automatisch afstemmen uit een vorige aanvraag zijn niet doorgegeven aan alle gebruikersdatabases.

  • 500 OperationTimedOut: er is een time-out voor de bewerking en deze wordt automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.

  • 503 ServiceTijdgeschikt Niet beschikbaar: functie tijdelijk niet beschikbaar.

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

Sample Request

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2021-02-01-preview
{
  "properties": {
    "desiredState": "Auto",
    "options": {
      "createIndex": {
        "desiredState": "Off"
      },
      "dropIndex": {
        "desiredState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default"
      }
    }
  }
}

Sample Response

{
  "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": "Off",
        "actualState": "Off"
      },
      "dropIndex": {
        "desiredState": "On",
        "actualState": "On"
      },
      "forceLastGoodPlan": {
        "desiredState": "Default",
        "actualState": "On",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      },
      "maintainIndex": {
        "desiredState": "Default",
        "actualState": "Off",
        "reasonCode": 2,
        "reasonDesc": "AutoConfigured"
      }
    }
  }
}

Updates server automatic tuning settings with minimal properties

Sample Request

PATCH https://management.azure.com/subscriptions/c3aa9078-0000-0000-0000-e36f151182d7/resourceGroups/default-sql-onebox/providers/Microsoft.Sql/servers/testsvr11/automaticTuning/current?api-version=2021-02-01-preview
{
  "properties": {
    "desiredState": "Auto"
  }
}

Sample Response

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

Definities

AutomaticTuningOptionModeActual

Werkelijke status van automatische afstemmingsoptie.

AutomaticTuningOptionModeDesired

Automatische afstemming optie gewenste status.

AutomaticTuningServerMode

Automatisch afstemmen van de gewenste status.

AutomaticTuningServerOptions

Eigenschappen automatisch afstemmen voor afzonderlijke adviseurs.

AutomaticTuningServerReason

Beschrijving van de reden, indien gewenst, en de werkelijke status is anders.

ServerAutomaticTuning

Automatisch afstemmen op serverniveau.

AutomaticTuningOptionModeActual

Werkelijke status van automatische afstemmingsoptie.

Name Type Description
Off
  • string
On
  • string

AutomaticTuningOptionModeDesired

Automatische afstemming optie gewenste status.

Name Type Description
Default
  • string
Off
  • string
On
  • string

AutomaticTuningServerMode

Automatisch afstemmen van de gewenste status.

Name Type Description
Auto
  • string
Custom
  • string
Unspecified
  • string

AutomaticTuningServerOptions

Eigenschappen automatisch afstemmen voor afzonderlijke adviseurs.

Name Type Description
actualState

Werkelijke status van automatische afstemmingsoptie.

desiredState

Automatische afstemming optie gewenste status.

reasonCode
  • integer

Redencode indien gewenst en de werkelijke status verschillen.

reasonDesc

Beschrijving van de reden, indien gewenst, en de werkelijke status is anders.

AutomaticTuningServerReason

Beschrijving van de reden, indien gewenst, en de werkelijke status is anders.

Name Type Description
AutoConfigured
  • string
Default
  • string
Disabled
  • string

ServerAutomaticTuning

Automatisch afstemmen op serverniveau.

Name Type Description
id
  • string

Resource-id.

name
  • string

Resourcenaam.

properties.actualState

Automatische afstemming van de werkelijke status.

properties.desiredState

Automatisch afstemmen van de gewenste status.

properties.options

Definitie van opties voor automatisch afstemmen.

type
  • string

Resourcetype.