AI 助理
文档备案控制台
官方文档
首页 云原生多模数据库 Lindorm 开发参考 API参考 API目录 其他 CreateLindormV2Instance - 创建Lindorm V2实例

CreateLindormV2Instance - 创建Lindorm V2实例

更新时间：
复制 MD 格式
产品详情
我的收藏

创建Lindorm V2实例。

接口说明

创建实例时至少需选择一种数据引擎。 关于数据引擎和存储规格请参见如何选择数据引擎和如何选择存储规格。

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

调试

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

调试

授权信息

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

  • 操作：是指具体的权限点。

  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

    • 对于必选的资源类型，用前面加 * 表示。

    • 对于不支持资源级授权的操作，用全部资源表示。

  • 条件关键字：是指云产品自身定义的条件关键字。

  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

lindorm:CreateLindormV2Instance

create

*全部资源

*

 无 无

请求参数

名称

类型

必填

描述

示例值
RegionId

string

是

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

cn-shanghai
ZoneId

string

是

实例的可用区 ID。

cn-shanghai-f
InstanceAlias

string

否

实例的名称。

lindorm-test
CloudStorageType

string

否

存储类型，选择大数据型与本地 SSD时，该参数可以不传

  • PerformanceStorage: 性能型云存储

  • StandardStorage: 标准型云存储

  • CapacityStorage: 容量型云存储

枚举值：

  • StandardStorage :

    标准型云存储

  • CapacityStorage :

    容量型云存储

  • PerformanceStorage :

    性能型云存储

PerformanceStorage
PayType

string

是

实例的付费类型，取值：

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

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

PREPAY
VPCId

string

是

实例的专有网络 ID。

vpc-wz9ydz3vg93s1ozsd****
VSwitchId

string

否

虚拟交换机的 ID。

vsw-bp1e7clcw529l773d****
PricingCycle

string

否

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

  • Month：单位为月。

  • Year：单位为年。

说明

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

枚举值：

  • Month :

    月

  • Year :

    年

Month
Duration

integer

否

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

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

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

说明

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

1
CloudStorageSize

integer

是

云存储空间大小，单位 GB

320
ArchVersion

string

否

部署架构，取值：

  • 1.0：单可用区。

  • 2.0：多可用区基础版。

  • 3.0：多可用区高可用版。

2.0
PrimaryZoneId

string

否

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

cn-shanghai-e
StandbyZoneId

string

否

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

cn-shanghai-f
ArbiterZoneId

string

否

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

cn-shanghai-g
PrimaryVSwitchId

string

否

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

vsw-uf6fdqa7c0pipnqzq****
StandbyVSwitchId

string

否

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

vsw-2zec0kcn08cgdtr6****
ArbiterVSwitchId

string

否

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

vsw-uf6664pqjawb87k36****
ResourceGroupId

string

否

资源组 ID。

rg-aek2i6weeb4nfii
AutoRenewal

boolean

否

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

  • true：自动续费。

  • false：不自动续费。

默认值为 false

说明

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

false
AutoRenewDuration

string

否

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

取值范围：1~12。

说明

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

1
ClusterPattern

string

否

形态选择，取值：

  • basic：生产型

枚举值：

  • light :

    测试型

  • basic :

    生产型

basic
ClusterMode

string

否

实例模式，非必填

  • BASIC：通用模式

枚举值：

  • BASIC :

    通用模式

BASIC

EnableCapacityStorage

boolean

否

是否开通容量型存储

false
CapacityStorageSize

integer

否

容量型存储大小，单位 GB

10000
EngineList

array<object>

是

引擎信息列表。

array<object>

否

引擎信息列表。

EngineType

string

是

引擎类型，返回值：

  • TABLE：宽表引擎。

  • TSDB：时序引擎。

  • LSEARCH：搜索引擎。

  • LTS：LTS 引擎。

  • LVECTOR：向量引擎。

  • LCOLUMN：列存引擎。

  • LAI：AI 引擎。

枚举值：

  • TABLE :

    宽表引擎

  • LSEARCH :

    搜索引擎

  • LMESSAGE :

    消息引擎

  • LAI :

    AI 引擎

  • LCOLUMN :

    列存引擎

  • LVECTOR :

    向量引擎

  • LTS :

    LTS 引擎

  • TSDB :

    时序引擎

  • LGRAPH :

    图引擎

  • LSTREAM :

    流引擎

TABLE
NodeGroupList

array<object>

否

引擎节点列表

object

否

引擎节点列表

NodeSpec

string

是

节点规格

选择性能型云存储或标准型云存储，本参数取值为：

  • 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.r.2xlarge：表示 8 核 64GB。

  • lindorm.r.4xlarge：表示 16 核 128GB。

  • lindorm.r.8xlarge：表示 32 核 256GB。

选择本地 SSD 类型时，本参数取值为：

  • 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）。

选择大数据型时，本参数取值为：

  • 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.g.2xlarge
NodeCount

integer

是

集群节点数。

7
NodeDiskType

string

否

节点云盘类型，非必填，特殊场景下使用，白名单开放

枚举值：

  • cloud_efficiency :

    标准型云盘

  • cloud_essd :

    ESSD 云盘

cloud_essd
NodeDiskSize

integer

否

单节点磁盘大小，默认单位为 GB。

100
ResourceGroupName

string

否

节点组名称，可选。

group_name_01

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 ID。

1556DCB0-043A-4444-8BD9-CF4A68E7EE64
InstanceId

string

实例 ID。

ld-bp1mq0tdzbx1m****
OrderId

integer

订单 ID。

211110656240000
AccessDeniedDetail

string

访问被拒绝的详细原因。

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

示例

正常返回示例

JSON格式

{
  "RequestId": "1556DCB0-043A-4444-8BD9-CF4A68E7EE64",
  "InstanceId": "ld-bp1mq0tdzbx1m****",
  "OrderId": 211110656240000,
  "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. 操作失败，请先申请创建服务关联角色的权限。

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

变更历史

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

上一篇：ChangeResourceGroup - 资源转组下一篇：GetInstanceSummary - 获取账户实例概览