Workload Classifiers - Create Or Update

Serviço:

SQL Database

Versão API:

2023-08-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=2023-08-01

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
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 da API do Azure Resource Manager ou 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.

Órgão do Pedido

Nome	Necessário	Tipo	Descrição
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	Descrição
200 OK	WorkloadClassifier	Atualizado com êxito o classificador de carga de trabalho.
201 Created	WorkloadClassifier	Criado com êxito o classificador de carga de trabalho.
202 Accepted		Criar ou atualizar para o classificador de carga de trabalho está em andamento. Cabeçalhos Location: string
Other Status Codes	ErrorResponse	Respostas de erro: *** 400 ManagedInstanceStoppingOrStopped - Operação conflitante enviada enquanto a instância está no estado de parada/parada 400 ManagedInstanceStarting - Operação conflitante enviada enquanto a instância está no estado inicial 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados. 400 OperationNotAllowedOnPausedDatabase - A operação não é permitida em um banco de dados pausado. 400 InvalidMemberNameParameter - Parâmetro de nome de membro inválido para este classificador de carga de trabalho. 400 InvalidStartTimeAndEndTimeParameters - Parâmetros de hora de início e hora de término inválidos para o classificador de carga de trabalho. 400 InvalidImportanceParameter - A importância deve ser uma das seguintes strings: Low, Below_Normal, Normal, Above_Normal, High. 400 InvalidResourceRequestBody - As propriedades do recurso ou do recurso no corpo da solicitação estão vazias ou são inválidas. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância do servidor. 404 ResourceNotFound - O recurso solicitado não foi encontrado. 404 OperationIdNotFound - A operação com Id não existe. 409 ConflictingSystemOperationInProgress - Uma operação de manutenção do sistema está em andamento no banco de dados e outras operações precisam esperar até que sejam concluídas. 409 ConflictingDatabaseOperation - Já existe alguma operação no banco de dados e a operação atual deve esperar até que seja feita. 409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado. 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 pelos recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação. 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 pelos recursos disponíveis. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos 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.

Pedido de exemplo

HTTP

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=2023-08-01

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

Resposta de exemplo

Código de estado:

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

Código de estado:

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

Código de estado:

202

Create a workload group with the required properties specified.

Pedido de exemplo

HTTP

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=2023-08-01

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

Resposta de exemplo

Código de estado:

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

Código de estado:

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

Código de estado:

202

Definições

Nome	Descrição
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
WorkloadClassifier	Operações do classificador de carga de trabalho para um data warehouse

ErrorAdditionalInfo

Objetivo

O erro de gerenciamento de recursos informações adicionais.

Nome	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objetivo

O detalhe do erro.

Nome	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objetivo

Resposta de erro

Nome	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

WorkloadClassifier

Objetivo

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

Nome	Tipo	Descrição
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.