你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Workload Groups - Create Or Update

创建或更新工作负荷组。

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

URI 参数

Name In Required Type Description
databaseName
path True
  • string

数据库的名称。

resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

workloadGroupName
path True
  • string

工作负荷组的名称。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Required Type Description
properties.maxResourcePercent True
  • integer

工作负荷组上限百分比资源。

properties.minResourcePercent True
  • integer

工作负荷组最小百分比资源。

properties.minResourcePercentPerRequest True
  • number

工作负荷组请求最小授予百分比。

properties.importance
  • string

工作负荷组重要性级别。

properties.maxResourcePercentPerRequest
  • number

工作负荷组请求最大授予百分比。

properties.queryExecutionTimeout
  • integer

工作负荷组查询执行超时。

响应

Name Type Description
200 OK

已成功更新工作负荷组。

201 Created

已成功创建工作负荷组。

202 Accepted

为接受的工作负荷组创建或更新。

Other Status Codes

错误响应: ***

  • 400 OperationNotAllowedOnPausedDatabase - 不允许对暂停的数据库执行操作。

  • 400 FeatureDisabledOnSelectedEdition - 用户尝试使用当前数据库版本上禁用的功能。

  • 400 InvalidWorkloadGroupNameParameter - 工作负荷组名称无效

  • 400 InvalidMinResourcePercentParameter - 此工作负荷组的最小资源百分比无效。

  • 400 InvalidMinResourcePercentPerRequestParameter - 此工作负荷组的每个查询的最小资源百分比无效。

  • 400 InvalidMaxResourcePercentParameter - 为此工作负荷组分配的最大资源百分比无效。

  • 400 InvalidMaxResourcePercentPerRequestParameter - 此工作负荷组的每个查询的最大资源百分比无效。

  • 400 InvalidImportanceParameter - 重要性必须是以下字符串之一:低、Below_Normal、Normal、Above_Normal、High。

  • 400 InvalidQueryExecutionTimeoutParameter - 此工作负荷组的查询执行超时值无效。

  • 400 InvalidResourceRequestBody - 请求正文中的资源或资源属性为空或无效。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 404 DatabaseDoesNotExist - 用户已指定在此服务器实例上不存在的数据库名称。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 404 OperationIdNotFound - ID 的操作不存在。

  • 409 ConflictingDatabaseOperation - 数据库上已经有一些操作,当前操作应等到操作完成。

  • 409 ConflictingSystemOperationInProgress - 数据库上正在进行系统维护操作,进一步的操作需要等待,直到它完成。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 503 DatabaseUnavailable - 操作失败,因为数据库不可用。

  • 504 RequestTimeout - 服务请求超过了允许的超时。

示例

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.

Sample Request

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-08-01-preview

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

Sample Response

{
  "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.

Sample Request

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-08-01-preview

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

Sample Response

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

定义

WorkloadGroup

数据仓库的工作负荷组操作

Name Type Description
id
  • string

资源 ID。

name
  • string

资源名称。

properties.importance
  • string

工作负荷组重要性级别。

properties.maxResourcePercent
  • integer

工作负荷组上限百分比资源。

properties.maxResourcePercentPerRequest
  • number

工作负荷组请求最大授予百分比。

properties.minResourcePercent
  • integer

工作负荷组最小百分比资源。

properties.minResourcePercentPerRequest
  • number

工作负荷组请求最小授予百分比。

properties.queryExecutionTimeout
  • integer

工作负荷组查询执行超时。

type
  • string

资源类型。