调用CreateDBResourceGroup接口创建资源组-云原生数据仓库AnalyticDB-阿里云

调用CreateDBResourceGroup接口为集群创建资源组。

接口说明

适用的产品系列：

企业版。
基础版。
湖仓版。
数仓版弹性模式：规格需为 32 核 128GB 及以上。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

adb:CreateDBResourceGroup

create

DBCluster

acs:adb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

无

请求参数

名称	类型	必填	描述	示例值
DBClusterId	string	是	集群 ID。说明您可以调用 DescribeDBClusters 接口查询目标地域中所有数仓版集群的集群 ID。	am-bp1ub9grke1****
GroupName	string	是	资源组名称。长度不超过 255 个字符。必须以数字或大写字母开头。可包含数字、大写字母、中划线（-）和下划线（_）。	TEST_GROUP
GroupType	string	否	查询类型，取值说明： interactive（默认值）：交互查询模式。 batch：分批查询模式。 Job：离线查询模式。	interactive
MinComputeResource	string	否	最小计算预留资源，单位为 ACU。当资源组类型为 Interactive 时，计算预留资源最小为 16 ACU。当资源组类型为 Job 时，计算预留资源最小为 0 ACU。	0ACU
MaxComputeResource	string	否	最大计算预留资源，单位为 ACU。当资源组类型为 Interactive 时，计算预留资源最大为集群当前未分配资源，步长为 16 ACU。当资源组类型为 Job 时，计算预留资源最大为集群当前未分配资源，步长为 8 ACU。	32ACU
ClusterSizeResource	string	否	单个 Cluster 资源规格，单位为 ACU。	16ACU
MinClusterCount	integer	否	资源组内至少需要运行的 Cluster 个数，最小为 1。	1
MaxClusterCount	integer	否	资源组内最多可以运行的 Cluster 个数，最大为 10。	2
ClusterMode	string	否	资源组模式，取值： Disable（默认）：常规模式。 AutoScale：自动弹性模式。	AutoScale
Engine	string	否	资源组引擎，取值： AnalyticDB（默认）：AnalyticDB for MySQL 引擎。 SparkWarehouse：SparkWarehouse 引擎。	AnalyticDB
EngineParams	object	否	Spark 应用配置参数，应用于该资源组执行的所有 Spark 作业。如需为某个 Spark 作业单独配置参数，可以在提交作业时通过代码设置。	{\"spark.adb.version\":\"3.5\"}
NodeNum	integer	否	节点数量，默认值为 0。 1 个节点的资源量为 16 核 64 GB。节点数量不能过大，需满足节点数量*16 核 64 GB 小于等于集群剩余可用资源。	2
ClientToken	string	否	用于保证请求的幂等性。由客户端生成该参数值，保证在不同请求间唯一。大小写敏感、不超过 64 个 ASCII 字符。	123e4567-e89b-12d3-a456-t7241****

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8

示例

正常返回示例

JSON格式

{
  "RequestId": "3A8F6106-6AFD-5A34-9C80-8DE2C42D06E8"
}

错误码

HTTP status code	错误码	错误信息	描述
403	OperationDenied.DBClusterStatus	The operation is not permitted due to cluster status.	当前集群状态禁止该操作。
404	InvalidDBCluster.NotFound	The DBClusterId provided does not exist in our records.	您指定的 DBClusterId 不存在，请确认 DBClusterId 值是否正确。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。