Partilhar via

Workload Groups - Create Or Update

  • Referência
Serviço:
SQL Database
Versão da API:
2021-11-01

Cria ou atualiza um grupo de cargas 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 do URI

Name Em Necessário Tipo Description
databaseName
 path True

string

O nome da base de dados.
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.
workloadGroupName
 path True

string

O nome do grupo de cargas de trabalho.
api-version
 query True

string

A versão da API a utilizar para o pedido.

Corpo do Pedido

Name Necessário Tipo Description
properties.maxResourcePercent True

integer

O recurso de percentagem do limite do grupo de cargas de trabalho.
properties.minResourcePercent True

integer

O recurso de percentagem mínima do grupo de cargas de trabalho.
properties.minResourcePercentPerRequest True

number

O grupo de cargas de trabalho pede uma percentagem mínima de concessão.
properties.importance

string

O nível de importância do grupo de cargas de trabalho.
properties.maxResourcePercentPerRequest

number

O grupo de cargas de trabalho pede a percentagem máxima de concessão.
properties.queryExecutionTimeout

integer

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

Respostas

Name Tipo Description
200 OK

WorkloadGroup

O grupo de cargas de trabalho foi atualizado com êxito.
201 Created

WorkloadGroup

Criou com êxito o grupo de cargas de trabalho.
202 Accepted

Criar ou atualizar para o grupo de cargas de trabalho aceite.
Other Status Codes

Respostas de Erro: ***

  • 400 OperationNotAllowedOnPausedDatabase – a operação não é permitida numa base de dados em pausa.

  • 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados.

  • 400 InvalidWorkloadGroupNameParameter – Nome de grupo de carga de trabalho inválido

  • 400 InvalidMinResourcePercentParameter – Percentagem de recurso mínima inválida para este grupo de cargas de trabalho.

  • 400 InvalidMinResourcePercentPerRequestParameter - Percentagem de recurso mínima inválida por consulta para este grupo de cargas de trabalho.

  • 400 InvalidMaxResourcePercentParameter – Percentagem de recurso máxima inválida a alocar para este grupo de cargas de trabalho.

  • 400 InvalidMaxResourcePercentPerRequestParameter – Percentagem de recurso máxima inválida por consulta para este grupo de cargas de trabalho.

  • 400 InvalidImportanceParameter - A importância tem de ser uma das seguintes cadeias: Baixa, Below_Normal, Normal, Above_Normal, Alta.

  • 400 InvalidQueryExecutionTimeoutParameter – valor de tempo limite de execução de consultas inválido para este grupo de cargas de trabalho.

  • 400 InvalidResourceRequestBody – as propriedades do recurso ou recurso no corpo do pedido estão vazias ou são inválidas.

  • 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados.

  • 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor.

  • 404 ResourceNotFound – o recurso pedido não foi encontrado.

  • 404 OperationIdNotFound - A operação com o ID não existe.

  • 409 ConflictingDatabaseOperation – já existe alguma operação na base de dados e a operação atual deve aguardar até estar concluída.

  • 409 ConflictingSystemOperationInProgress - Está em curso uma operação de manutenção do sistema na base de dados e as operações adicionais têm de aguardar até que seja concluída.

  • 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 dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos 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 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 503 DatabaseUnavailable - A operação falhou porque a base de dados não está disponível.

  • 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

  • 504 RequestTimeout - O pedido 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 amostra

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 da amostra

Código de estado:
200 
{
  "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"
}
Código de estado:
201 
{
  "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"
}
Código de estado:
202

Create a workload group with the required properties specified.

Pedido de amostra

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 da amostra

Código de estado:
200 
{
  "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"
}
Código de estado:
201 
{
  "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"
}
Código de estado:
202

Definições

WorkloadGroup

Operações de grupo de cargas de trabalho para um armazém de dados

Name Tipo Description
id

string

ID do Recurso.
name

string

Nome do recurso.
properties.importance

string

O nível de importância do grupo de cargas de trabalho.
properties.maxResourcePercent

integer

O recurso de percentagem do limite do grupo de cargas de trabalho.
properties.maxResourcePercentPerRequest

number

O grupo de cargas de trabalho pede a percentagem máxima de concessão.
properties.minResourcePercent

integer

O recurso de percentagem mínima do grupo de cargas de trabalho.
properties.minResourcePercentPerRequest

number

O grupo de cargas de trabalho pede uma percentagem mínima de concessão.
properties.queryExecutionTimeout

integer

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

string

Tipo de recurso.