Workload Groups - Create Or Update

참조

서비스:: SQL Database

API 버전:: 2021-11-01

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	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	필수	형식	Description
properties.maxResourcePercent	True	integer	워크로드 그룹 상한 백분율 리소스입니다.
properties.minResourcePercent	True	integer	워크로드 그룹 최소 백분율 리소스입니다.
properties.minResourcePercentPerRequest	True	number	워크로드 그룹은 최소 허용 비율을 요청합니다.
properties.importance		string	워크로드 그룹 중요도 수준입니다.
properties.maxResourcePercentPerRequest		number	워크로드 그룹은 최대 허용 비율을 요청합니다.
properties.queryExecutionTimeout		integer	워크로드 그룹 쿼리 실행 시간 제한입니다.

응답

Name	형식	Description
200 OK	WorkloadGroup	워크로드 그룹을 업데이트했습니다.
201 Created	WorkloadGroup	워크로드 그룹을 만들었습니다.
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 - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 ConflictingDatabaseOperation - 데이터베이스에 대한 일부 작업이 이미 있으며 현재 작업이 완료될 때까지 기다려야 합니다. 409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다. 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.

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


import com.azure.resourcemanager.sql.fluent.models.WorkloadGroupInner;

/**
 * Samples for WorkloadGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateWorkloadGroupMax.json
     */
    /**
     * Sample code: Create a workload group with all properties specified.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createAWorkloadGroupWithAllPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getWorkloadGroups().createOrUpdate("Default-SQL-SouthEastAsia",
            "testsvr", "testdb", "smallrc",
            new WorkloadGroupInner().withMinResourcePercent(0).withMaxResourcePercent(100)
                .withMinResourcePercentPerRequest(3.0).withMaxResourcePercentPerRequest(3.0D).withImportance("normal")
                .withQueryExecutionTimeout(0),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

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

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


import com.azure.resourcemanager.sql.fluent.models.WorkloadGroupInner;

/**
 * Samples for WorkloadGroups CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateWorkloadGroupMin.json
     */
    /**
     * Sample code: Create a workload group with the required properties specified.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createAWorkloadGroupWithTheRequiredPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getWorkloadGroups().createOrUpdate(
            "Default-SQL-SouthEastAsia", "testsvr", "testdb", "smallrc", new WorkloadGroupInner()
                .withMinResourcePercent(0).withMaxResourcePercent(100).withMinResourcePercentPerRequest(3.0),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

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

정의

WorkloadGroup

Object

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

Name	형식	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	리소스 종류.

다음을 통해 공유

Workload Groups - Create Or Update

URI 매개 변수

요청 본문

응답

예제

Create a workload group with all properties specified.

샘플 요청

샘플 응답

Create a workload group with the required properties specified.

샘플 요청

샘플 응답

정의

WorkloadGroup

추가 리소스