Server Automatic Tuning - Get

Servicio:

SQL Database

Versión de la API:

2021-11-01

Recupera las opciones de ajuste automático del servidor.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Respuestas

Nombre	Tipo	Description
200 OK	ServerAutomaticTuning	Se recuperaron correctamente las propiedades de ajuste automático del servidor.
Other Status Codes		Respuestas de error: *** 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos. 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido. 404 DatabaseDoesNotExist: no se encontró la base de datos solicitada. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 SubscriptionDoesNotHaveElasticPool: no se encontró el grupo elástico solicitado. 404 OperationIdNotFound: la operación con id. no existe. 405 NotSupported: esta funcionalidad no se admite. 409 Conflicto: no se pudo procesar la solicitud debido a un conflicto en la solicitud. 409 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y, 503 ServiceTemporarilyUnavailable: característica no disponible temporalmente. 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

Get a server's automatic tuning settings

Solicitud de ejemplo

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

/**
 * 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", com.azure.core.util.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

Respuesta de muestra

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

Definiciones

Nombre	Description
AutomaticTuningOptionModeActual	Estado real de la opción de ajuste automático.
AutomaticTuningOptionModeDesired	Estado deseado de la opción de ajuste automático.
AutomaticTuningServerMode	Ajuste automático del estado deseado.
AutomaticTuningServerOptions	Propiedades de ajuste automático para asesores individuales.
AutomaticTuningServerReason	Descripción del motivo si el estado deseado y real son diferentes.
ServerAutomaticTuning	Ajuste automático de nivel de servidor.

AutomaticTuningOptionModeActual

Estado real de la opción de ajuste automático.

Nombre	Tipo	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

Estado deseado de la opción de ajuste automático.

Nombre	Tipo	Description
Default	string
Off	string
On	string

AutomaticTuningServerMode

Ajuste automático del estado deseado.

Nombre	Tipo	Description
Auto	string
Custom	string
Unspecified	string

AutomaticTuningServerOptions

Propiedades de ajuste automático para asesores individuales.

Nombre	Tipo	Description
actualState	AutomaticTuningOptionModeActual	Estado real de la opción de ajuste automático.
desiredState	AutomaticTuningOptionModeDesired	Estado deseado de la opción de ajuste automático.
reasonCode	integer	Código de motivo si el estado deseado y real son diferentes.
reasonDesc	AutomaticTuningServerReason	Descripción del motivo si el estado deseado y real son diferentes.

AutomaticTuningServerReason

Descripción del motivo si el estado deseado y real son diferentes.

Nombre	Tipo	Description
AutoConfigured	string
Default	string
Disabled	string

ServerAutomaticTuning

Ajuste automático de nivel de servidor.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.actualState	AutomaticTuningServerMode	Estado real del ajuste automático.
properties.desiredState	AutomaticTuningServerMode	Ajuste automático del estado deseado.
properties.options	<string,  AutomaticTuningServerOptions>	Definición de opciones de ajuste automático.
type	string	Tipo de recurso.