Workload Classifiers - Create Or Update

Referência

Service:: SQL Database

API Version:: 2021-11-01

Cria ou atualiza um classificador de carga de trabalho.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/workloadGroups/{workloadGroupName}/workloadClassifiers/{workloadClassifierName}?api-version=2021-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
workloadClassifierName	path	True	string	O nome do classificador de carga de trabalho a ser criado/atualizado.
workloadGroupName	path	True	string	O nome do grupo de carga de trabalho do qual receber o classificador.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
properties.memberName	True	string	O nome do membro do classificador de carga de trabalho.
properties.context		string	O contexto do classificador de carga de trabalho.
properties.endTime		string	A hora de término do classificador de carga de trabalho para classificação.
properties.importance		string	A importância do classificador de carga de trabalho.
properties.label		string	O rótulo do classificador de carga de trabalho.
properties.startTime		string	A hora de início do classificador de carga de trabalho para classificação.

Respostas

Nome	Tipo	Description
200 OK	WorkloadClassifier	O classificador de carga de trabalho foi atualizado com êxito.
201 Created	WorkloadClassifier	O classificador de carga de trabalho foi criado com êxito.
202 Accepted		Criar ou atualizar para o classificador de carga de trabalho está em andamento.
Other Status Codes		Respostas de erro: *** 400 OperationNotAllowedOnPausedDatabase - A operação não é permitida em um banco de dados em pausa. 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados. 400 InvalidMemberNameParameter - Parâmetro de nome de membro inválido para esse classificador de carga de trabalho. 400 InvalidStartTimeAndEndTimeParameters - Parâmetros inválidos de hora de início e hora de término para o classificador de carga de trabalho. 400 InvalidImportanceParameter - A importância deve ser uma das seguintes cadeias de caracteres: Baixa, Below_Normal, Normal, Above_Normal, Alta. 400 InvalidResourceRequestBody - O recurso ou as propriedades de recurso no corpo da solicitação são vazios ou inválidos. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância de servidor. 404 ResourceNotFound - O recurso solicitado não foi encontrado. 404 OperationIdNotFound - A operação com Id não existe. 409 ConflictingDatabaseOperation - Já existe alguma operação no banco de dados e a operação atual deve aguardar até que ela seja concluída. 409 ConflictingSystemOperationInProgress - Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam aguardar até que ele seja concluído. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 503 DatabaseUnavailable - A operação falhou porque o banco de dados não está disponível. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Create a workload group with all properties specified.

Create a workload group with the required properties specified.

Create a workload group with all properties specified.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/wlm_workloadgroup/workloadClassifiers/wlm_workloadclassifier?api-version=2021-11-01

{
  "properties": {
    "memberName": "dbo",
    "label": "test_label",
    "context": "test_context",
    "startTime": "12:00",
    "endTime": "14:00",
    "importance": "high"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.WorkloadClassifierInner;

/** Samples for WorkloadClassifiers CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateWorkloadClassifierMax.
     * json
     */
    /**
     * Sample code: Create a workload group with all properties specified.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createAWorkloadGroupWithAllPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getWorkloadClassifiers()
            .createOrUpdate("Default-SQL-SouthEastAsia", "testsvr", "testdb", "wlm_workloadgroup",
                "wlm_workloadclassifier", new WorkloadClassifierInner().withMemberName("dbo").withLabel("test_label")
                    .withContext("test_context").withStartTime("12:00").withEndTime("14:00").withImportance("high"),
                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

{
  "properties": {
    "memberName": "dbo",
    "label": "test_label",
    "context": "test_context",
    "startTime": "12:00",
    "endTime": "14:00",
    "importance": "high"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/wlm_workloadgroup/workloadClassifiers/wlm_workloadclassifier",
  "name": "wlm_workloadclassifier",
  "type": "Microsoft.Sql/servers/databases/workloadGroups/workloadClassifiers"
}

Status code:: 201

{
  "properties": {
    "memberName": "dbo",
    "label": "test_label",
    "context": "test_context",
    "startTime": "12:00",
    "endTime": "14:00",
    "importance": "high"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/wlm_workloadgroup/workloadClassifiers/wlm_workloadclassifier",
  "name": "wlm_workloadclassifier",
  "type": "Microsoft.Sql/servers/databases/workloadGroups/workloadClassifiers"
}

Status code:: 202

Create a workload group with the required properties specified.

Sample Request

HTTP
Java

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/wlm_workloadgroup/workloadClassifiers/wlm_workloadclassifier?api-version=2021-11-01

{
  "properties": {
    "memberName": "dbo"
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.WorkloadClassifierInner;

/** Samples for WorkloadClassifiers CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateWorkloadClassifierMin.
     * json
     */
    /**
     * Sample code: Create a workload group with the required properties specified.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createAWorkloadGroupWithTheRequiredPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getWorkloadClassifiers().createOrUpdate(
            "Default-SQL-SouthEastAsia", "testsvr", "testdb", "wlm_workloadgroup", "wlm_workloadclassifier",
            new WorkloadClassifierInner().withMemberName("dbo"), 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

{
  "properties": {
    "memberName": "dbo",
    "label": "",
    "context": "",
    "startTime": "",
    "endTime": "",
    "importance": ""
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/wlm_workloadgroup/workloadClassifiers/wlm_workloadclassifier",
  "name": "wlm_workloadclassifier",
  "type": "Microsoft.Sql/servers/databases/workloadGroups/workloadClassifiers"
}

Status code:: 201

{
  "properties": {
    "memberName": "dbo",
    "label": "",
    "context": "",
    "startTime": "",
    "endTime": "",
    "importance": ""
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/wlm_workloadgroup/workloadClassifiers/wlm_workloadclassifier",
  "name": "wlm_workloadclassifier",
  "type": "Microsoft.Sql/servers/databases/workloadGroups/workloadClassifiers"
}

Status code:: 202

Definições

WorkloadClassifier

Operações de classificador de carga de trabalho para um data warehouse

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.context	string	O contexto do classificador de carga de trabalho.
properties.endTime	string	A hora de término do classificador de carga de trabalho para classificação.
properties.importance	string	A importância do classificador de carga de trabalho.
properties.label	string	O rótulo do classificador de carga de trabalho.
properties.memberName	string	O nome do membro do classificador de carga de trabalho.
properties.startTime	string	A hora de início do classificador de carga de trabalho para classificação.
type	string	Tipo de recurso.

Share via

Workload Classifiers - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Exemplos

Create a workload group with all properties specified.

Sample Request

Sample Response

Create a workload group with the required properties specified.

Sample Request

Sample Response

Definições

WorkloadClassifier

Recursos adicionais