Workload Groups - Create Or Update

서비스:: SQL Database

API 버전:: 2023-08-01

워크로드 그룹을 만들거나 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	데이터베이스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
workloadGroupName	path	True	string	워크로드 그룹의 이름입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	Description
properties.maxResourcePercent	True	integer (int32)	워크로드 그룹 상한 백분율 리소스입니다.
properties.minResourcePercent	True	integer (int32)	워크로드 그룹 최소 백분율 리소스입니다.
properties.minResourcePercentPerRequest	True	number (double)	작업 그룹 요청 최소 허용 비율입니다.
properties.importance		string	워크로드 그룹 중요도 수준입니다.
properties.maxResourcePercentPerRequest		number (double)	워크로드 그룹 요청 최대 허용 비율입니다.
properties.queryExecutionTimeout		integer (int32)	워크로드 그룹 쿼리 실행 시간 제한입니다.

응답

Name	형식	Description
200 OK	WorkloadGroup	워크로드 그룹을 업데이트했습니다.
201 Created	WorkloadGroup	워크로드 그룹을 만들었습니다.
202 Accepted		허용된 워크로드 그룹을 만들거나 업데이트합니다. 헤더 Location: string
Other Status Codes	ErrorResponse	오류 응답: *** 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 OperationNotAllowedOnPausedDatabase - 일시 중지된 데이터베이스에서는 작업이 허용되지 않습니다. 400 InvalidWorkloadGroupNameParameter - 잘못된 워크로드 그룹 이름 400 InvalidMinResourcePercentParameter - 이 워크로드 그룹의 최소 리소스 백분율이 잘못되었습니다. 400 InvalidMinResourcePercentPerRequestParameter - 이 워크로드 그룹에 대한 쿼리당 최소 리소스 백분율이 잘못되었습니다. 400 InvalidMaxResourcePercentParameter - 이 워크로드 그룹에 할당할 최대 리소스 백분율이 잘못되었습니다. 400 InvalidMaxResourcePercentPerRequestParameter - 이 워크로드 그룹에 대한 쿼리당 최대 리소스 백분율이 잘못되었습니다. 400 InvalidImportanceParameter - 중요도는 낮음, Below_Normal, 보통, Above_Normal, 높음 문자열 중 하나여야 합니다. 400 InvalidQueryExecutionTimeoutParameter - 이 워크로드 그룹에 대한 쿼리 실행 시간 제한 값이 잘못되었습니다. 400 InvalidResourceRequestBody - 요청 본문의 리소스 또는 리소스 속성이 비어 있거나 잘못되었습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다. 409 ConflictingDatabaseOperation - 데이터베이스에 대한 일부 작업이 이미 있으며 현재 작업이 완료될 때까지 기다려야 합니다. 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 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.

샘플 요청

HTTP

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

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

샘플 응답

상태 코드:: 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"
}

상태 코드:: 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"
}

상태 코드:: 202

Create a workload group with the required properties specified.

샘플 요청

HTTP

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

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

샘플 응답

상태 코드:: 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"
}

상태 코드:: 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"
}

상태 코드:: 202

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
WorkloadGroup	데이터 웨어하우스에 대한 워크로드 그룹 작업

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

WorkloadGroup

Object

데이터 웨어하우스에 대한 워크로드 그룹 작업

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.importance	string	워크로드 그룹 중요도 수준입니다.
properties.maxResourcePercent	integer (int32)	워크로드 그룹 상한 백분율 리소스입니다.
properties.maxResourcePercentPerRequest	number (double)	워크로드 그룹 요청 최대 허용 비율입니다.
properties.minResourcePercent	integer (int32)	워크로드 그룹 최소 백분율 리소스입니다.
properties.minResourcePercentPerRequest	number (double)	작업 그룹 요청 최소 허용 비율입니다.
properties.queryExecutionTimeout	integer (int32)	워크로드 그룹 쿼리 실행 시간 제한입니다.
type	string	리소스 종류입니다.

다음을 통해 공유

Workload Groups - Create Or Update

URI 매개 변수

요청 본문

응답

예제

Create a workload group with all properties specified.

샘플 요청

샘플 응답

Create a workload group with the required properties specified.

샘플 요청

샘플 응답

정의

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

WorkloadGroup