All Products
Search
Document Center

AnalyticDB for MySQL:CreateDBResourceGroup

Last Updated:Apr 24, 2024

Creates a resource group for an AnalyticDB for MySQL Data Lakehouse Edition (V3.0) cluster.

Operation description

For information about the endpoints of the current service, see Endpoints .

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DBClusterIdstringYes

The ID of the AnalyticDB for MySQL Data Lakehouse Edition (V3.0) cluster.

amv-bp11q28kvl688****
GroupNamestringYes

The name of the resource group.

  • The name can be up to 255 characters in length.
  • The name must start with a letter or a digit.
  • The name can contain letters, digits, hyphens (_), and underscores (_).
test_group
GroupTypestringYes

The type of the resource group. Valid values:

  • Interactive
  • Job
Note For information about resource groups of Data Lakehouse Edition, see Resource groups.
Job
MinComputeResourcestringNo

The minimum reserved computing resources. Unit: AnalyticDB Compute Units (ACUs).

  • When GroupType is set to Interactive, set this parameter to 16 ACUs.
  • When GroupType is set to Job, set this parameter to 0 ACUs.
0
MaxComputeResourcestringNo

The maximum reserved computing resources. Unit: ACU.

  • If GroupType is set to Interactive, the maximum amount of reserved computing resources refers to the amount of resources that are not allocated in the cluster. Set this parameter to a value in increments of 16 ACUs.
  • If GroupType is set to Job, the maximum amount of reserved computing resources refers to the amount of resources that are not allocated in the cluster. Set this parameter to a value in increments of 8 ACUs.
48
ClusterSizeResourcestringNo

A reserved parameter.

N/A
MinClusterCountintegerNo

A reserved parameter.

N/A
MaxClusterCountintegerNo

A reserved parameter.

N/A
ClusterModestringNo

A reserved parameter.

N/A
EnableSpotbooleanNo

Specifies whether to enable the preemptible instance feature for the resource group. After you enable the preemptible instance feature, you are charged for resources at a lower unit price but the resources are probably released. You can enable the preemptible instance feature only for job resource groups. Valid values:

  • True
  • False
True
RegionIdstringNo

The region ID of the cluster.

Note You can call the DescribeRegions operation to query the most recent region list.
cn-hangzhou
Rulesobject []No

The job resubmission rules.

GroupNamestringNo

The name of the resource group.

  • The name can be up to 255 characters in length.
  • The name must start with a letter or digit.
  • The name can contain letters, digits, hyphens (_), and underscores (_).
QueryTimestringNo

The execution duration of the query. Unit: milliseconds.

TargetGroupNamestringNo

The name of the destination resource group.

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The request ID.

A94B6C02-7BD4-5D67-9776-3AC8317E8DD5

Examples

Sample success responses

JSONformat

{
  "RequestId": "A94B6C02-7BD4-5D67-9776-3AC8317E8DD5"
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidPoolName.MalformedThe specified parameter PoolName is not valid.The PoolName parameter is invalid. Check the parameter.
400InvalidPoolUser.MalformedThe specified parameter PoolUser is not valid.The PoolUser parameter is invalid. Check the parameter.
400InvalidDBClusterId.NotFoundThe DBClusterId provided does not exist in our records.The specified DBClusterId parameter does not exist. Make sure that the DBClusterId value is valid.
400InvalidDBClusterId.MalformedThe specified parameter DBClusterId is not valid.The DBClusterId parameter is invalid. Check the parameter.
400InvalidPoolType.MalformedThe specified parameter PoolType is not valid.The PoolType parameter is invalid. Check the parameter.
400InvalidMinComputeResource.MalformedThe specified parameter MinComputeResource is not valid.The MinComputeResource parameter is invalid. Check the parameter.
400InvalidMaxComputeResource.MalformedThe specified parameter MaxComputeResource is not valid.The MaxComputeResource parameter is invalid. Check the parameter.
400ACS.ResourceGroup.InvalidResourceGroupStateThe state of this resource group does not support this operation.This operation is not supported due to the current state of the resource group.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-03-25The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: Rules
2024-01-26The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: EnableSpot
2023-12-19The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: RegionId
2023-09-25The Error code has changed. The request parameters of the API has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
Input ParametersThe request parameters of the API has changed.
    Added Input Parameters: ClusterSizeResource
    Added Input Parameters: MinClusterCount
    Added Input Parameters: MaxClusterCount
    Added Input Parameters: ClusterMode
2023-04-13The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
2023-03-31The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Added Error Codes: 400