全部产品
Search
文档中心

云原生数据仓库AnalyticDB MySQL版:CreateDBCluster - 创建集群

更新时间:Apr 13, 2023

创建一个AnalyticDB MySQL集群。

接口说明

注意事项

集群创建成功后,将按照您选的集群规格计费。数仓版(3.0)集群的计费项与定价,详情请参见数仓版(3.0)计费项数仓版(3.0)产品定价

调试

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

调试

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
adb:CreateDBClusterWrite
  • ADB
    acs:adb:{#regionId}:{#accountId}:dbcluster/*

请求参数

名称类型必填描述示例值
RegionIdstring

地域ID。

说明您可以调用DescribeRegions接口查看地域ID。
cn-hangzhou
ZoneIdstring

可用区ID。

说明您可以调用DescribeRegions接口查看可用区ID。
cn-hangzhou-h
DBClusterVersionstring

AnalyticDB MySQL数仓版集群版本。取值:3.0

3.0
DBClusterCategorystring

系列。取值说明:

  • Cluster:预留模式集群版。

  • MixedStorage:弹性模式集群版(新版)。

说明当DBClusterCategory为Cluster时,Mode参数必须填写Reserver;当DBClusterCategory为MixedStorage时,Mode参数必须填写Flexible,否则会导致创建集群失败。
Cluster
DBClusterClassstring

集群规格,取值:

  • C8
  • C32
说明Mode取值为Reserver(即预留模式)时,本参数必填。
C8
DBNodeGroupCountstring

节点组数量,取值范围为:1~200(整数)。

说明Mode取值为Reserver(即预留模式)时,本参数必填。
2
DBNodeStoragestring

节点存储空间,单位:GB。取值说明:

  • 规格为C8时,取值范围为:100~1000。
  • 规格为C32时,取值范围为:100~8000。
说明
  • Mode取值为Reserver(即预留模式)时,本参数必填。
  • 1000 GB以下步长为100 GB,1000 GB以上步长为1000 GB。
  • 200
    DBClusterNetworkTypestring

    网络类型:VPC

    VPC
    DBClusterDescriptionstring

    集群描述。

    • 不能以http://或者https开头。
    • 长度为2~256个字符。
    test
    PayTypestring

    付费类型。取值说明:

    • Postpaid:按量付费。
    • Prepaid:预付费(包年包月)。
    Postpaid
    Periodstring

    指定预付费集群为包年或包月类型。取值说明:

    • Year:包年类型。
    • Month:包月类型。
    说明PayType为Prepaid(即预付费(包年包月))时,本参数为必填参数。
    Year
    UsedTimestring

    预付费集群的购买时长。取值说明:

    • 当Period为Year时,UsedTime取值范围为:1、2、3、5(整数)。
    • 当Period为Month时,UsedTime取值范围为:1~11(整数)。
    说明
  • PayType为Prepaid(即预付费(包年包月))时,本参数为必填参数。
  • 购买的时间越长价格越优惠,购买1年的实际价格会比购买10个月或11个月更划算。
  • 1
    VPCIdstring

    专有网络ID。

    vpc-bp1at5ze0t5u3xtqn****
    VSwitchIdstring

    虚拟交换机ID。

    vsw-bp1aadw9k19x6cis9****
    ClientTokenstring

    用于保证请求的幂等性。由客户端生成该参数值,保证在不同请求间唯一。大小写敏感、不超过64个ASCII 字符。

    123e4567-e89b-12d3-a456-t7241****
    ExecutorCountstring

    预留参数,不涉及。

    ResourceGroupIdstring

    资源组ID。

    rg-4690g37929****
    Modestring

    模式。取值说明:

    • Reserver:预留模式。
    • Flexible:弹性模式。
    说明本参数不填写时,默认为预留模式。
    Reserver
    StorageResourcestring

    预留参数,不涉及。

    StorageTypestring

    预留参数,不涉及。

    ComputeResourcestring

    计算资源。Mode取值为Flexible(即弹性模式)时,本参数必填。

    说明您可以调用DescribeAvailableResource接口查询指定地域中可用的计算资源。
    32Core128GB
    RestoreTypestring

    预留参数,不涉及。

    SourceDBInstanceNamestring

    预留参数,不涉及。

    BackupSetIDstring

    预留参数,不涉及。

    RestoreTimestring

    预留参数,不涉及。

    ElasticIOResourcestring

    弹性IO资源(Elastic IO Unit,简称EIU),更多详情,请参见EIU详解

    0

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求ID。

    1AD222E9-E606-4A42-BF6D-8A4442913CEF
    ResourceGroupIdstring

    资源组ID。

    rg-4690g37929****
    DBClusterIdstring

    AnalyticDB MySQL数仓版(3.0)集群ID。

    am-bp1r053byu48p****
    OrderIdstring

    订单ID。

    202353278****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
      "ResourceGroupId": "rg-4690g37929****",
      "DBClusterId": "am-bp1r053byu48p****",
      "OrderId": "202353278****"
    }

    错误码

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史