创建StarRocks实例 - CreateStarrocksInstance
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
URI
POST /v3/{project_id}/instances/{instance_id}/starrocks
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| project_id | 是 | String | 参数解释: 租户在某一Region下的project ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 | 
| instance_id | 是 | String | 参数解释: TaurusDB数据库实例ID,严格匹配UUID规则。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,后缀为in07,长度为36个字符。 默认取值: 不涉及。 | 
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 | 
| Content-Type | 是 | String | 参数解释: 内容类型。 约束限制: 不涉及。 取值范围: application/json。 默认取值: application/json。 | 
| X-Language | 否 | String | 参数解释: 请求语言类型。 约束限制: 不涉及。 取值范围: 默认取值: en-us。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| name | 是 | String | 参数解释: 实例名称。同一租户下,同类型的实例名可重名。 约束限制: 不涉及。 取值范围: 最小为4个字符,最大为64个字符且不超过64个字节,必须以字母开头,区分大小写,可以包含字母、数字、中划线、下划线,不能包含其他特殊字符。不支持中文名。 默认取值: 不涉及。 | 
| engine | 是 | engine object | 参数解释: 引擎信息。 约束限制: 不涉及。 | 
| ha | 是 | ha object | 参数解释: 部署信息。 约束限制: 不涉及。 | 
| fe_flavor_id | 是 | String | 参数解释: FE节点规格ID。可通过调用HTAP查询规格信息 - ListHtapFlavor接口,获取响应消息中的“id”。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 | 
| be_flavor_id | 是 | String | 参数解释: BE节点规格ID。可通过调用HTAP查询规格信息 - ListHtapFlavor接口,获取响应消息中的“id”。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 | 
| db_root_pwd | 是 | String | 参数解释: 数据库密码。 约束限制: 不涉及。 取值范围: 至少包含以下字符的三种:大小写字母、数字和特殊符号~!@#$%^*-_=+?,()&|.,长度8~32个字符。 建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。如果您输入弱密码,系统会自动判定密码非法。 默认取值: 不涉及。 | 
| fe_count | 是 | Integer | 参数解释: FE节点数。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 | 
| be_count | 是 | Integer | 参数解释: BE节点数。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 | 
| az_mode | 是 | String | 参数解释: 可用区类型。 取值范围: 当前仅支持single。 | 
| fe_volume | 是 | fe_volume object | 参数解释: FE节点存储规格。 约束限制: 不涉及。 | 
| be_volume | 是 | be_volume object | 参数解释: BE节点存储规格。 约束限制: 不涉及。 | 
| az_code | 是 | String | 参数解释: 可用区代码。 约束限制: 不涉及。 | 
| time_zone | 否 | String | 参数解释: 时区。 取值范围: 默认时区为UTC+08:00。 | 
| tags_info | 是 | tags_info object | 参数解释: 标签信息。 约束限制: 不涉及。 | 
| security_group_id | 否 | String | 参数解释: 实例安全组ID。默认与TaurusDB实例的安全组ID一致。 取值范围: 不涉及。 | 
| pay_info | 否 | pay_info object | 参数解释: 支付信息。 约束限制: 包周期场景必填。 | 
| region_code | 否 | String | 参数解释: 可用区。 约束限制: 包周期场景必填。 取值范围: 不涉及。 默认取值: 不涉及。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| type | 是 | String | 参数解释: 引擎类型。 约束限制: 不涉及。 取值范围: 仅支持star-rocks。 默认取值: 不涉及。 | 
| version | 是 | String | 参数解释: 引擎大版本号,可通过调用HTAP引擎资源查询 - ListHtapDataStore接口获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| io_type | 是 | String | 参数解释: 磁盘类型。通过HTAP引擎资源查询 - ListHtapDataStore返回消息获取。 约束限制: 不涉及。 | 
| capacity_in_gb | 是 | Integer | 参数解释: 磁盘容量,单位GB。 约束限制: 增长的步长:10GB。 取值范围: 50 - 1000。 默认取值: 不涉及。 | 
| 参数 | 是否必选 | 参数类型 | 描述 | 
|---|---|---|---|
| io_type | 是 | String | 参数解释: 磁盘类型。通过HTAP引擎资源查询 - ListHtapDataStore返回消息获取。 约束限制: 不涉及。 | 
| capacity_in_gb | 是 | Integer | 参数解释: 磁盘容量,单位GB。 约束限制: 增长的步长:10GB。 取值范围: 50 - 1000。 默认取值: 不涉及。 | 
响应参数
状态码: 201
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| instance | instance object | 实例信息。 | 
| job_id | String | 工作流ID。 | 
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| id | String | StarRocks实例ID,严格匹配UUID规则。 | 
| az_code | String | 可用区码。 | 
| az_mode | String | 参数解释: 可用区模式。 取值范围: single:单可用区。 multi:多可用区。 | 
| name | String | 实例名称。 | 
| engine | engine object | 引擎信息。 | 
| vpc_id | String | 虚拟私有云ID。 | 
| security_group_id | String | 安全组ID。 | 
| sub_net_id | String | 子网ID。 | 
| db_user | String | 数据库用户,默认root。 | 
| port | Integer | 数据库端口号,默认3306。 | 
| ha_mode | String | 部署模式。 | 
| pay_info | pay_info object | 计费信息。 | 
| enable_ssl | Boolean | SSL开关。 | 
| status | String | 实例状态。 | 
| region | String | 实例所在区域。 | 
| tags_info | tags_info object | 实例标签。 | 
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| pay_model | String | 参数解释: 计费模式。 取值范围: 默认取值: StarRocks实例当前只支持按需计费,默认值为0 | 
| order_id | String | 包周期计费ID。 | 
| period | String | 包周期周期。 | 
| period_type | String | 包周期周期类型。 | 
| is_auto_renew | String | 包周期是否自动续费。 | 
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| tags | Array of tags objects | 用户标签,默认为空。 | 
| sys_tags | Array of sys_tags objects | 系统标签。 | 
状态码: 400
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| error_code | String | 错误码。 | 
| error_msg | String | 错误消息。 | 
状态码: 500
| 参数 | 参数类型 | 描述 | 
|---|---|---|
| error_code | String | 错误码。 | 
| error_msg | String | 错误消息。 | 
请求示例
创建数据库实例。
POST https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/instances/40dc4c5729f14aad893e2dcd5baf6a15in07/starrocks
{
  "name" : "htap-ff64",
  "engine" : {
    "type" : "star-rocks",
    "version" : "3.1"
  },
  "ha" : {
    "mode" : "Single"
  },
  "fe_flavor_id" : "afef3bfd-ac7c-32e1-ba44-c388acbb196a",
  "be_flavor_id" : "de565db8-0a96-37ea-9388-61167624712c",
  "db_root_pwd" : "Test@123!",
  "fe_count" : 1,
  "be_count" : 1,
  "az_mode" : "single",
  "fe_volume" : {
    "io_type" : "SSD",
    "capacity_in_gb" : 50
  },
  "be_volume" : {
    "io_type" : "SSD",
    "capacity_in_gb" : 50
  },
  "az_code" : "az",
  "time_zone" : "UTC+08:00",
  "tags_info" : {
    "sys_tags" : [ {
      "key" : "_sys_enterprise_project_id",
      "value" : "0"
    } ]
  }
}
  响应示例
状态码: 201
Success.
{
  "instance" : {
    "id" : "590031445ef845bb912d7fc8243db80cin17",
    "az_code" : "az1",
    "az_mode" : "single",
    "name" : "htap-ff64",
    "engine" : {
      "type" : "star-rocks",
      "version" : "3.1"
    },
    "vpc_id" : "d5a1a29b-1476-490f-9682-c1a59593e7b0",
    "security_group_id" : "967a0ac2-3cae-4e57-a49a-d0f6ff07dcc1",
    "sub_net_id" : "2ce0bc80-bfc5-4d5e-9b78-a7f91572e03b",
    "db_user" : "root",
    "port" : 3306,
    "ha_mode" : "Single",
    "pay_info" : {
      "pay_model" : "0",
      "order_id" : null,
      "period" : null,
      "period_type" : null,
      "is_auto_renew" : null
    },
    "enable_ssl" : false,
    "status" : "creating",
    "region" : "az",
    "tags_info" : {
      "tags" : [ ],
      "sys_tags" : [ {
        "key" : "_sys_enterprise_project_id",
        "value" : "0"
      } ]
    }
  },
  "job_id" : "cf0b7506-1505-450f-9d95-ce9d93b6b5c3"
}
  状态码
请参见状态码。
错误码
请参见错误码。
 
    