Server Automatic Tuning - Get

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém as opções de otimização automática do servidor.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	ServerAutomaticTuning	As propriedades de otimização automática do servidor foram obtidas com êxito.
Other Status Codes		Respostas de Erro: *** 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados. 400 InvalidIdentifier – o identificador contém NULL ou um caráter unicode inválido. 404 DatabaseDoesNotExist – A base de dados pedida não foi encontrada 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 SubscriptionDoesNotHaveElasticPool – O conjunto elástico pedido não foi encontrado 404 OperationIdNotFound – a operação com o ID não existe. 405 NotSupported – esta funcionalidade não é suportada. 409 Conflito – não foi possível processar o pedido devido a um conflito no pedido. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 ServiceTemporarilyUnavailable - Funcionalidade temporariamente indisponível. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Get a server's automatic tuning settings

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Definições

Name	Description
AutomaticTuningOptionModeActual	Estado real da opção de otimização automática.
AutomaticTuningOptionModeDesired	Estado pretendido da opção de otimização automática.
AutomaticTuningServerMode	Estado pretendido da otimização automática.
AutomaticTuningServerOptions	Propriedades de otimização automática para consultores individuais.
AutomaticTuningServerReason	Descrição do motivo se o estado pretendido e real forem diferentes.
ServerAutomaticTuning	Otimização Automática ao nível do servidor.

AutomaticTuningOptionModeActual

Estado real da opção de otimização automática.

Name	Tipo	Description
Off	string
On	string

AutomaticTuningOptionModeDesired

Estado pretendido da opção de otimização automática.

Name	Tipo	Description
Default	string
Off	string
On	string

AutomaticTuningServerMode

Estado pretendido da otimização automática.

Name	Tipo	Description
Auto	string
Custom	string
Unspecified	string

AutomaticTuningServerOptions

Propriedades de otimização automática para consultores individuais.

Name	Tipo	Description
actualState	AutomaticTuningOptionModeActual	Estado real da opção de otimização automática.
desiredState	AutomaticTuningOptionModeDesired	Estado pretendido da opção de otimização automática.
reasonCode	integer	O código do motivo, se pretendido e o estado real, são diferentes.
reasonDesc	AutomaticTuningServerReason	Descrição do motivo se o estado pretendido e real forem diferentes.

AutomaticTuningServerReason

Descrição do motivo se o estado pretendido e real forem diferentes.

Name	Tipo	Description
AutoConfigured	string
Default	string
Disabled	string

ServerAutomaticTuning

Otimização Automática ao nível do servidor.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.actualState	AutomaticTuningServerMode	Otimização automática do estado real.
properties.desiredState	AutomaticTuningServerMode	Estado pretendido da otimização automática.
properties.options	<string,  AutomaticTuningServerOptions>	Definição de opções de otimização automática.
type	string	Tipo de recurso.