Compartilhar via


Workload Groups - Create Or Update

Cria ou atualiza um grupo de carga de trabalho.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/workloadGroups/{workloadGroupName}?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.

workloadGroupName
path True

string

O nome do grupo de carga de trabalho.

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.maxResourcePercent True

integer

O recurso percentual de limite do grupo de carga de trabalho.

properties.minResourcePercent True

integer

O recurso percentual mínimo do grupo de carga de trabalho.

properties.minResourcePercentPerRequest True

number

O grupo de carga de trabalho solicita o percentual mínimo de concessão.

properties.importance

string

O nível de importância do grupo de carga de trabalho.

properties.maxResourcePercentPerRequest

number

O grupo de carga de trabalho solicita o percentual máximo de concessão.

properties.queryExecutionTimeout

integer

O tempo limite de execução da consulta do grupo de carga de trabalho.

Respostas

Nome Tipo Description
200 OK

WorkloadGroup

Atualizou com êxito o grupo de carga de trabalho.

201 Created

WorkloadGroup

O grupo de carga de trabalho foi criado com êxito.

202 Accepted

Criar ou atualizar para o grupo de carga de trabalho aceito.

Other Status Codes

Respostas de erro: ***

  • 400 OperationNotAllowedOnPausedDatabase – A operação não é permitida em um banco de dados pausado.

  • 400 FeatureDisabledOnSelectedEdition – o usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados.

  • 400 InvalidWorkloadGroupNameParameter - Nome do grupo de carga de trabalho inválido

  • 400 InvalidMinResourcePercentParameter – percentual mínimo de recursos inválido para esse grupo de carga de trabalho.

  • 400 InvalidMinResourcePercentPerRequestParameter – percentual de recurso mínimo inválido por consulta para esse grupo de carga de trabalho.

  • 400 InvalidMaxResourcePercentParameter - Percentual máximo de recursos inválido para alocar para esse grupo de carga de trabalho.

  • 400 InvalidMaxResourcePercentPerRequestParameter – percentual máximo de recursos inválido por consulta para esse grupo 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 InvalidQueryExecutionTimeoutParameter – valor de tempo limite de execução de consulta inválido para esse grupo de carga de trabalho.

  • 400 InvalidResourceRequestBody - O recurso ou as propriedades do 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 do 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 seja feita.

  • 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 das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas 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 das solicitações máximas 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 das solicitações máximas 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.

Solicitação de exemplo

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

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  }
}

Resposta de exemplo

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}
{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}

Create a workload group with the required properties specified.

Solicitação de exemplo

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

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3
  }
}

Resposta de exemplo

{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}
{
  "properties": {
    "minResourcePercent": 0,
    "maxResourcePercent": 100,
    "minResourcePercentPerRequest": 3,
    "maxResourcePercentPerRequest": 3,
    "importance": "normal",
    "queryExecutionTimeout": 0
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/workloadGroups/smallrc",
  "name": "smallrc",
  "type": "Microsoft.Sql/servers/databases/workloadGroups"
}

Definições

WorkloadGroup

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

Nome Tipo Description
id

string

ID do recurso.

name

string

Nome do recurso.

properties.importance

string

O nível de importância do grupo de carga de trabalho.

properties.maxResourcePercent

integer

O recurso percentual de limite do grupo de carga de trabalho.

properties.maxResourcePercentPerRequest

number

O grupo de carga de trabalho solicita o percentual máximo de concessão.

properties.minResourcePercent

integer

O recurso percentual mínimo do grupo de carga de trabalho.

properties.minResourcePercentPerRequest

number

O grupo de carga de trabalho solicita o percentual mínimo de concessão.

properties.queryExecutionTimeout

integer

O tempo limite de execução da consulta do grupo de carga de trabalho.

type

string

Tipo de recurso.