AI 助理
备案控制台
官方文档
输入文档关键字查找
首页 云原生多模数据库 Lindorm 开发参考 API参考 API目录 实例 CreateLindormInstance - 创建Lindorm实例

CreateLindormInstance - 创建Lindorm实例

更新时间：
产品详情
我的收藏

创建Lindorm实例。

接口说明

创建实例时至少需选择一种数据引擎。 例如，想创建宽表引擎，则必须同时填写 LindormNum（宽表引擎节点数量）和 LindormSpec（宽表引擎节点规格）参数。关于数据引擎和存储规格请参见如何选择数据引擎和如何选择存储规格。

重要 创建实例时如果未填写数据引擎参数，则会导致 API 调用失败。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

实例的地域 ID，可调用 DescribeRegions 查询，使用此参数指定要创建实例的地域。

cn-shanghai
ZoneId

string

是

实例的可用区 ID。

cn-shanghai-f
InstanceAlias

string

否

实例的名称。

lindorm_test
InstanceStorage

string

否

实例的存储容量，单位为 GB。

480
PayType

string

是

实例的付费类型，取值：

  • PREPAY：包年包月（预付费）。

  • POSTPAY：按量付费（后付费）。

POSTPAY
VPCId

string

是

实例的专有网络 ID。

vpc-bp1nme44gek34slfc****
VSwitchId

string

是

虚拟交换机的 ID。

vsw-bp1e7clcw529l773d****
PricingCycle

string

否

实例购买的付费周期，取值：

  • Month：单位为月。

  • Year：单位为年。

说明

PayType 取值为 PREPAY 时，本参数可用且必须传入。

Month
Duration

string

否

实例包年包月的时间，取值：

  • PricingCycle 为 Month，表示按月付费，取值范围为 1~9。

  • PricingCycle 为 Year，表示按年付费，取值范围为 1~3。

说明

PayType 取值为 PREPAY 时，本参数可用且必须传入。

1
DiskCategory

string

是

实例的存储类型，取值：

  • cloud_efficiency：标准型云存储。

  • cloud_ssd：性能型云存储。

  • cloud_essd：性能增强型云存储。

  • cloud_essd_pl0：性能型云存储 pl0。

  • capacity_cloud_storage：容量型云存储（多可用区实例不支持）。

  • local_ssd_pro：本地 SSD 盘（多可用区实例不支持）。

  • local_hdd_pro：本地 HDD 盘（多可用区实例不支持）。

cloud_efficiency
CoreSpec

string

否

实例的本地盘类型节点规格。

本地存储类型为 local_ssd_pro 时，本参数取值为，其中 I3 机型当前仅支持包年包月商品：

  • lindorm.i4.xlarge：表示 4 核 32GB（I4）。

  • lindorm.i4.2xlarge：表示 8 核 64GB（I4）。

  • lindorm.i4.4xlarge：表示 16 核 128GB（I4）。

  • lindorm.i4.8xlarge：表示 32 核 256GB（I4）。

  • lindorm.i3.xlarge：表示 4 核 32GB（I3）。

  • lindorm.i3.2xlarge：表示 8 核 64GB（I3）。

  • lindorm.i3.4xlarge：表示 16 核 128GB（I3）。

  • lindorm.i3.8xlarge：表示 32 核 256GB（I3）。

  • lindorm.i2.xlarge：表示 4 核 32GB（I2）。

  • lindorm.i2.2xlarge：表示 8 核 64GB（I2）。

  • lindorm.i2.4xlarge：表示 16 核 128GB（I2）。

  • lindorm.i2.8xlarge：表示 32 核 256GB（I2）。

本地存储类型为 local_hdd_pro 时，本参数取值为：

  • lindorm.sd3c.3xlarge：表示 14 核 56GB（D3C PRO）。

  • lindorm.sd3c.7xlarge：表示 28 核 112GB（D3C PRO）。

  • lindorm.sd3c.14xlarge：表示 56 核 224GB（D3C PRO）。

  • lindorm.d2c.6xlarge：表示 24 核 88GB（D2C）。

  • lindorm.d2c.12xlarge：表示 48 核 176GB（D2C）。

  • lindorm.d2c.24xlarge：表示 96 核 352GB（D2C）。

  • lindorm.d2s.5xlarge：表示 20 核 88GB（D2S）。

  • lindorm.d2s.10xlarge：表示 40 核 176GB（D2S）。

  • lindorm.d1.2xlarge：表示 8 核 32GB（D1NE）。

  • lindorm.d1.4xlarge：表示 16 核 64GB（D1NE）。

  • lindorm.d1.6xlarge：表示 24 核 96GB（D1NE）。

lindorm.i2.xlarge
LindormNum

integer

否

实例的宽表引擎节点数量。

如果需要创建单可用区实例，取值范围为：0~90。

如果需要创建多可用区实例，该参数必填。非本地盘存储类型的实例，取值范围为：4~400。本地盘存储类型的实例，取值范围为：6~400。

2
SolrSpec

string

否

实例的搜索引擎节点规格，取值：

  • lindorm.g.xlarge：表示 4 核 16GB（独享规格）。

  • lindorm.c.2xlarge：表示 8 核 16GB（独享规格）。

  • lindorm.g.2xlarge：表示 8 核 32GB（独享规格）。

  • lindorm.c.4xlarge：表示 16 核 32GB（独享规格）。

  • lindorm.g.4xlarge：表示 16 核 64GB（独享规格）。

  • lindorm.c.8xlarge：表示 32 核 64GB（独享规格）。

  • lindorm.g.8xlarge：表示 32 核 128GB（独享规格）。

lindorm.g.xlarge
SolrNum

integer

否

实例的搜索引擎节点数量，取值：0~60。

2
ColdStorage

integer

否

实例的容量型云存储容量，单位为 GB，不填默认不开通容量型云存储。取值范围：800~1000000。

800
TsdbSpec

string

否

实例的时序引擎节点规格，取值：

  • lindorm.g.xlarge：表示 4 核 16GB（独享规格）。

  • lindorm.g.2xlarge：表示 8 核 32GB（独享规格）。

  • lindorm.g.4xlarge：表示 16 核 64GB（独享规格）。

  • lindorm.g.8xlarge：表示 32 核 128GB（独享规格）。

lindorm.g.xlarge
TsdbNum

integer

否

实例的时序引擎节点数量，取值如下：

  • 如果实例的付费类型为 PREPAY，取值范围为：0~24。

  • 如果实例的付费类型为 POSTPAY，取值范围为：0~32。

2
LindormSpec

string

否

实例的宽表引擎节点规格，取值：

  • lindorm.g.xlarge：表示 4 核 16GB（独享规格）。

  • lindorm.c.2xlarge：表示 8 核 16GB（独享规格）。

  • lindorm.g.2xlarge：表示 8 核 32GB（独享规格）。

  • lindorm.c.4xlarge：表示 16 核 32GB（独享规格）。

  • lindorm.g.4xlarge：表示 16 核 64GB（独享规格）。

  • lindorm.c.8xlarge：表示 32 核 64GB（独享规格）。

  • lindorm.g.8xlarge：表示 32 核 128GB（独享规格）。

lindorm.c.xlarge
FilestoreNum

integer

否

实例的文件引擎节点数量，取值如下：

  • 如果实例的付费类型为 PREPAY，取值范围为：0~60。

  • 如果实例的付费类型为 POSTPAY，取值范围为：0~8。

2
FilestoreSpec

string

否

实例的文件引擎节点规格，取值：

  • lindorm.c.xlarge：表示 4 核 8GB（标准规格）。

lindorm.c.xlarge
StreamNum

integer

否

实例的流引擎节点数量，取值：0~60。

2
StreamSpec

string

否

实例的流引擎节点规格，取值：

  • lindorm.g.xlarge：表示 4 核 16GB（独享规格）。

  • lindorm.c.2xlarge：表示 8 核 16GB（独享规格）。

  • lindorm.g.2xlarge：表示 8 核 32GB（独享规格）。

  • lindorm.c.4xlarge：表示 16 核 32GB（独享规格）。

  • lindorm.g.4xlarge：表示 16 核 64GB（独享规格）。

  • lindorm.c.8xlarge：表示 32 核 64GB（独享规格）。

  • lindorm.g.8xlarge：表示 32 核 128GB（独享规格）。

lindorm.g.xlarge
ArchVersion

string

否

部署架构，取值：

  • 1.0：单可用区。

  • 2.0：多可用区。

不填写此参数时，默认为 1.0。创建多可用区实例，请填写 2.0。如果需要创建多可用区实例，该参数必填。

2.0
PrimaryZoneId

string

否

多可用区实例，主可用区的可用区 ID。如果需要创建多可用区实例，该参数必填。

cn-shanghai-e
StandbyZoneId

string

否

多可用区实例，备可用区的可用区 ID。如果需要创建多可用区实例，该参数必填。

cn-shanghai-f
ArbiterZoneId

string

否

多可用区实例，协调可用区的可用区 ID。如果需要创建多可用区实例，该参数必填。

cn-shanghai-g
MultiZoneCombination

string

否

多可用区组合。可用区组合支持情况可前往售卖页查看。

  • ap-southeast-5abc-aliyun：印度尼西亚(雅加达)A+B+C。

  • cn-hangzhou-ehi-aliyun：华东 1(杭州)E+H+I。

  • cn-beijing-acd-aliyun：华北 2(北京)A+C+D。

  • ap-southeast-1-abc-aliyun：新加坡 A+B+C。

  • cn-zhangjiakou-abc-aliyun：华北 3(张家口)A+B+C。

  • cn-shanghai-efg-aliyun：华东 2(上海)E+F+G。

  • cn-shanghai-abd-aliyun：华东 2(上海)A+B+D。

  • cn-hangzhou-bef-aliyun：华东 1(杭州)B+E+F。

  • cn-hangzhou-bce-aliyun：华东 1(杭州)B+C+E。

  • cn-beijing-fgh-aliyun：华北 2(北京)F+G+H。

  • cn-shenzhen-abc-aliyun：华南 1(深圳)A+B+C。

如果需要创建多可用区实例，该参数必填。

cn-shanghai-efg-aliyun
PrimaryVSwitchId

string

否

多可用区实例，主可用区的虚拟交换机 ID，必须在 PrimaryZoneId 对应的可用区下。如果需要创建多可用区实例，该参数必填。

vsw-uf6fdqa7c0pipnqzq****
StandbyVSwitchId

string

否

多可用区实例，备可用区的虚拟交换机 ID，必须在 StandbyZoneId 对应的可用区下。如果需要创建多可用区实例，该参数必填。

vsw-2zec0kcn08cgdtr6****
ArbiterVSwitchId

string

否

多可用区实例，协调可用区虚拟交换机 ID，交换机需位于 ArbiterZoneId 对应的可用区下。如果需要创建多可用区实例，该参数必填。

vsw-uf6664pqjawb87k36****
CoreSingleStorage

integer

否

多可用区实例，core 单节点容量。取值范围 400~64000，单位 GB。如果需要创建多可用区实例，该参数必填。

400
LogDiskCategory

string

否

多可用区实例，log 节点磁盘类型，返回：

  • cloud_efficiency：标准云存储。

  • cloud_ssd：性能云存储。

如果需要创建多可用区实例，该参数必填。

cloud_ssd
LogSpec

string

否

多可用区实例，log 节点规格。取值如下：

  • lindorm.sn1.large：表示 4 核 8GB（独享规格）。

  • lindorm.sn1.2xlarge：表示 8 核 16GB（独享规格）。

如果需要创建多可用区实例，该参数必填。

lindorm.sn1.large
LogNum

integer

否

多可用区实例，log 节点数量。取值范围 4~400。如果需要创建多可用区实例，该参数必填。

4
LogSingleStorage

integer

否

多可用区实例，log 单节点磁盘容量。取值范围 400~64000，单位 GB。如果需要创建多可用区实例，该参数必填。

400
ResourceGroupId

string

否

资源组 ID。

rg-aek2i6weeb4nfii
AutoRenewal

boolean

否

实例是否自动续费，枚举值：

  • true：自动续费。

  • false：不自动续费。

默认值为 false

说明

仅当 PayType 取值为 PREPAY（包年包月）时，此参数有效。

false
AutoRenewDuration

string

否

自动续费时长。单位：月。

取值范围：1~12。

说明

仅 AutoRenewal 为 true 时，该项才生效。

1
LtsSpec

string

否

实例的 LTS 引擎节点规格，取值：

  • lindorm.c.xlarge：表示 4 核 8GB（独享规格）。

  • lindorm.g.xlarge：表示 4 核 16GB（独享规格）。

  • lindorm.c.2xlarge：表示 8 核 16GB（独享规格）。

  • lindorm.g.2xlarge：表示 8 核 32GB（独享规格）。

  • lindorm.c.4xlarge：表示 16 核 32GB（独享规格）。

  • lindorm.g.4xlarge：表示 16 核 64GB（独享规格）。

  • lindorm.c.8xlarge：表示 32 核 64GB（独享规格）。

  • lindorm.g.8xlarge：表示 32 核 128GB（独享规格）。

lindorm.g.xlarge
LtsNum

string

否

实例的 LTS 引擎节点数量，取值：0~60。

2
Tag

array<object>

否

标签列表。

object

否

标签列表。

Key

string

否

标签的键。N 的取值范围：1~20。

说明

可以传入多个标签的键。例如：第一对中的 Key 表示传入第一个标签的键。第二对中的 Key 表示传入第二个标签的键。

test
Value

string

否

标签的值。N 的取值范围：1~20。

说明

可以传入多个标签的值。例如：第一对中的 Value 表示传入第一个标签的值。第二对中的 Value 表示传入第二个标签的值。

value

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

93BE8227-3406-4D7A-883D-9A421D42****
InstanceId

string

创建的实例 ID。

ld-bp1o3y0yme2i2****
OrderId

integer

订单 ID。

111111111111111
AccessDeniedDetail

string

访问被拒绝的详细原因。

{"AuthAction":"xxx","AuthPrincipalDisplayName":"222","AuthPrincipalOwnerId":"111","AuthPrincipalType":"SubUser",,"NoPermissionType":"ImplicitDeny","PolicyType":"AccountLevelIdentityBasedPolicy","EncodedDiagnosticMessage":"xxxxxx"}

示例

正常返回示例

JSON格式

{
  "RequestId": "93BE8227-3406-4D7A-883D-9A421D42****",
  "InstanceId": "ld-bp1o3y0yme2i2****",
  "OrderId": 111111111111111,
  "AccessDeniedDetail": "{\"AuthAction\":\"xxx\",\"AuthPrincipalDisplayName\":\"222\",\"AuthPrincipalOwnerId\":\"111\",\"AuthPrincipalType\":\"SubUser\",,\"NoPermissionType\":\"ImplicitDeny\",\"PolicyType\":\"AccountLevelIdentityBasedPolicy\",\"EncodedDiagnosticMessage\":\"xxxxxx\"}"
}

错误码

HTTP status code

错误码

错误信息

描述
400 Lindorm.Errorcode.ParameterInvaild The parameter is invalid.
400 LindormErrorCode.%s %s. %s.
403 Lindorm.Errorcode.OperationDenied You are not authorized to operate on the specified resource.
403 API.Forbidden The API operation is forbidden in this environment. 操作失败，当前环境中该API无法使用。
403 Lindorm.Errorcode.ServiceLinkedRoleNoPermission No permission to create service linked role. 操作失败，请先申请创建服务关联角色的权限。

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

变更历史

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

上一篇：实例下一篇：ReleaseLindormInstance - 释放Lindorm实例