Server Automatic Tuning - Get

Referentie

Service:: SQL Database

API Version:: 2021-11-01

Hiermee worden opties voor automatisch afstemmen van de server opgehaald.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	ServerAutomaticTuning	De eigenschappen voor automatisch afstemmen van de server zijn opgehaald.
Other Status Codes		Foutreacties: *** 400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie. 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken. 404 DatabaseDoesNotExist - De aangevraagde database is niet gevonden 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 SubscriptionDoesNotHaveElasticPool - De aangevraagde elastische pool is niet gevonden 404 OperationIdNotFound - De bewerking met id bestaat niet. 405 Niet ondersteund : deze functionaliteit wordt niet ondersteund. 409 Conflict - 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. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Name

Type

Description

200 OK

ServerAutomaticTuning

De eigenschappen voor automatisch afstemmen van de server zijn opgehaald.

Other Status Codes

Foutreacties: ***

400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie.
400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken.
404 DatabaseDoesNotExist - De aangevraagde database is niet gevonden
404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 SubscriptionDoesNotHaveElasticPool - De aangevraagde elastische pool is niet gevonden
404 OperationIdNotFound - De bewerking met id bestaat niet.
405 Niet ondersteund : deze functionaliteit wordt niet ondersteund.
409 Conflict - 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.
429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.
429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources.
500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren.
503 ServiceTemporarilyUnavailable - Functie tijdelijk niet beschikbaar.
503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Get a server's automatic tuning settings

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


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

Definities

Name	Description
AutomaticTuningOptionModeActual	Automatische afstemmingsoptie werkelijke status.
AutomaticTuningOptionModeDesired	De gewenste status van de optie Automatisch afstemmen.
AutomaticTuningServerMode	Automatische afstemming van de gewenste status.
AutomaticTuningServerOptions	Automatische afstemming van eigenschappen voor individuele adviseurs.
AutomaticTuningServerReason	Redenbeschrijving indien gewenst en werkelijke status verschillen.
ServerAutomaticTuning	Automatisch afstemmen op serverniveau.

AutomaticTuningOptionModeActual

Automatische afstemmingsoptie werkelijke status.

Name	Type	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

De gewenste status van de optie Automatisch afstemmen.

Name	Type	Description
Default	string
Off	string
On	string

AutomaticTuningServerMode

Automatische afstemming van de gewenste status.

Name	Type	Description
Auto	string
Custom	string
Unspecified	string

AutomaticTuningServerOptions

Automatische afstemming van eigenschappen voor individuele adviseurs.

Name	Type	Description
actualState	AutomaticTuningOptionModeActual	Automatische afstemmingsoptie werkelijke status.
desiredState	AutomaticTuningOptionModeDesired	De gewenste status van de optie Automatisch afstemmen.
reasonCode	integer	Redencode indien gewenst en werkelijke status verschillen.
reasonDesc	AutomaticTuningServerReason	Redenbeschrijving indien gewenst en werkelijke status verschillen.

AutomaticTuningServerReason

Redenbeschrijving indien gewenst en werkelijke status verschillen.

Name	Type	Description
AutoConfigured	string
Default	string
Disabled	string