Compartir a través de

Workload Groups - Create Or Update

  • Referencia
Servicio:
SQL Database
Versión de la API:
2021-11-01

Crea o actualiza un grupo de cargas de trabajo.

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 identificador URI

Nombre En Requerido Tipo Description
databaseName
 path True

string

El nombre de la base de datos.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName
 path True

string

El nombre del servidor.
subscriptionId
 path True

string

El id. de suscripción que identifica una suscripción de Azure.
workloadGroupName
 path True

string

Nombre del grupo de cargas de trabajo.
api-version
 query True

string

La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties.maxResourcePercent True

integer

Recurso de porcentaje de límite de grupo de cargas de trabajo.
properties.minResourcePercent True

integer

Recurso de porcentaje mínimo del grupo de cargas de trabajo.
properties.minResourcePercentPerRequest True

number

Porcentaje mínimo de concesión de la solicitud del grupo de cargas de trabajo.
properties.importance

string

Nivel de importancia del grupo de cargas de trabajo.
properties.maxResourcePercentPerRequest

number

Porcentaje máximo de concesión de solicitud del grupo de cargas de trabajo.
properties.queryExecutionTimeout

integer

Tiempo de espera de ejecución de consultas del grupo de cargas de trabajo.

Respuestas

Nombre Tipo Description
200 OK

WorkloadGroup

Se actualizó correctamente el grupo de cargas de trabajo.
201 Created

WorkloadGroup

Se ha creado correctamente el grupo de cargas de trabajo.
202 Accepted

Cree o actualice para el grupo de cargas de trabajo aceptado.
Other Status Codes

Respuestas de error: ***

  • 400 OperationNotAllowedOnPausedDatabase: no se permite la operación en una base de datos en pausa.

  • 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.

  • 400 InvalidWorkloadGroupNameParameter: nombre del grupo de cargas de trabajo no válido

  • 400 InvalidMinResourcePercentParameter: porcentaje mínimo de recursos no válido para este grupo de cargas de trabajo.

  • 400 InvalidMinResourcePercentPerRequestParameter: porcentaje mínimo de recursos no válido por consulta para este grupo de cargas de trabajo.

  • 400 InvalidMaxResourcePercentParameter: porcentaje máximo de recursos no válido para asignarlo a este grupo de cargas de trabajo.

  • 400 InvalidMaxResourcePerRequestParameter: porcentaje máximo de recursos no válido por consulta para este grupo de cargas de trabajo.

  • 400 InvalidImportanceParameter: importance debe ser una de las siguientes cadenas: Low, Below_Normal, Normal, Above_Normal, High.

  • 400 InvalidQueryExecutionTimeoutParameter: valor de tiempo de espera de ejecución de consultas no válido para este grupo de cargas de trabajo.

  • 400 InvalidResourceRequestBody: las propiedades de recurso o recurso del cuerpo de la solicitud están vacías o no son válidas.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 409 ConflictingDatabaseOperation: ya hay alguna operación en la base de datos y la operación actual debe esperar hasta que se realice.

  • 409 ConflictingSystemOperationInProgress: una operación de mantenimiento del sistema está en curso en la base de datos y es necesario esperar hasta que se complete.

  • 409 OperationCancelled: el usuario ha cancelado la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y,

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 503 DatabaseUnavailable: error en la operación porque la base de datos no está disponible.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

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.

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}
status code:
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"
}
status code:
202

Create a workload group with the required properties specified.

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}
status code:
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"
}
status code:
202

Definiciones

WorkloadGroup

Object

Operaciones de grupo de cargas de trabajo para un almacenamiento de datos

Nombre Tipo Description
id

string

Identificador del recurso.
name

string

Nombre del recurso.
properties.importance

string

Nivel de importancia del grupo de cargas de trabajo.
properties.maxResourcePercent

integer

Recurso de porcentaje de límite de grupo de cargas de trabajo.
properties.maxResourcePercentPerRequest

number

Porcentaje máximo de concesión de solicitud del grupo de cargas de trabajo.
properties.minResourcePercent

integer

Recurso de porcentaje mínimo del grupo de cargas de trabajo.
properties.minResourcePercentPerRequest

number

Porcentaje mínimo de concesión de la solicitud del grupo de cargas de trabajo.
properties.queryExecutionTimeout

integer

Tiempo de espera de ejecución de consultas del grupo de cargas de trabajo.
type

string

Tipo de recurso.