CreateInstances_云数据库 Tair（兼容 Redis®）_API调试-阿里云OpenAPI开发者门户

接口说明

请确保在使用该接口前，已充分了解云数据库 Tair（兼容 Redis）产品的收费方式和价格。

说明本接口仅支持创建经典版实例。推荐您使用创建单个实例的 API 接口：

CreateInstance ：创建 Redis 开源版实例、Tair 内存型经典版实例。

CreateTairInstance ：创建 Tair 云原生版实例（含内存型、持久内存、磁盘型）。

请求参数

字段名称	字段详情
Instancesstring	新实例的配置信息，格式为 JSON，详细说明请参见 Instances 参数补充说明。示例值:[{ "RegionId": "cn-hangzhou", "izNo": "cn-hangzhou-b", "quantity": 1, "instanceType": "Redis", "instanceClass": "redis.logic.sharding.1g.2db.0rodb.4proxy.default", "EngineVersion": "5.0", "ChargeType":"PrePaid", "Period":"1", "networkType": "VPC" , "vpcId": "vpc-2zex6u1nu32k3ux35oxxx", "vSwitchId": "vsw-2zesk464e647104kw3xxx" }]参考取值来源: DescribeInstances
Tokenstring	用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感、不超过 64 个 ASCII 字符。示例值:ETnLKlblzczshOTUbOCz****
AutoPayboolean	是否自动付费，取值：展开详情示例值:true
BusinessInfostring	业务扩展信息。示例值:000000000
CouponNostring	优惠码，默认值为：`youhuiquan_promotion_option_id_for_blank`。示例值:youhuiquan_promotion_option_id_for_blank
EngineVersionstring	实例兼容 Redis 的版本，取值：4.0、5.0。展开详情示例值:5.0枚举值:2.84.05.0
RebuildInstanceboolean	是否需要从回收站中重建恢复源实例，取值：展开详情示例值:false
AutoRenewstring	是否开启自动续费，取值：展开详情示例值:false
ResourceGroupIdstring	资源组 ID。示例值:rg-resourcegroupid1

请求说明

Instances 参数补充说明

名称	类型	是否必选	示例值	描述
RegionId	String	是	cn-hangzhou	地域 ID，可调用DescribeRegions查询，使用此参数指定要创建实例的地域。
IzNo	String	是	cn-hangzhou-b	主可用区 ID，可调用DescribeRegions查询，使用此参数指定要创建实例的可用区。
Quantity	Integer	否	1	要创建的实例数量，取值范围：1~300，默认值为1。
InstanceType	String	否	Redis	实例类型，取值： Redis（默认）：云数据库 Tair（兼容 Redis）实例。 Memcache：Memcache 实例。
InstanceClass	String	否	redis.master.small.default	实例的规格，例如 redis.master.small.default 为社区版（经典版）标准架构双副本 1 GB 实例，详细信息请参见规格查询导航。说明本参数和Capacity两者中必须传入一项。
Capacity	Long	否	16384	实例的存储容量，单位为 MB，详细信息请参见规格查询导航。说明本参数和InstanceClass两者中必须传入一项。
EngineVersion	String	否	5.0	实例兼容 Redis 的版本，取值： 5.0（默认） 4.0
ChargeType	String	否	PrePaid	付费类型，取值： PrePaid：包年包月（预付费）。 PostPaid（默认）：按量付费（后付费）。
Period	Long	否	12	付费周期，单位为月，取值：1~9、12、24、36、60。说明当ChargeType参数取值为PrePaid时，本参数才可用且必须传入。
AutoRenew	String	否	true	是否开启自动续费，取值： true：开启。 false（默认）：不开启。说明当ChargeType参数取值为PrePaid时，本参数才可用。
InstanceName	String	否	apitest	实例的名称，需满足下述要求：以大小写字母或中文开头，长度为 2~80 个字符。不支持空格和特殊字符：@/:=”<>{[]}
Password	String	否	Pass!123456	实例的密码，需满足下述要求：长度为 8~32 位。需包含大写字母、小写字母、特殊字符和数字中的至少三种。支持的特殊字符为：!@#$%^&*()_+-=
NetworkType	String	否	VPC	网络类型，取值：VPC（当前仅支持创建 VPC 网络实例）：专有网络 VPC。
VpcId	String	否	vpc-bp1nme44gek34slfc****	专有网络 ID，可调用专有网络 VPC 的DescribeVpcs获取。
VSwitchId	String	否	vsw-bp1e7clcw529l773d****	该专有网络下的虚拟交换机 ID，可调用专有网络 VPC 的DescribeVpcs获取。
NodeType	String	否	MASTER_SLAVE	节点类型，取值： STAND_ALONE：单副本。 MASTER_SLAVE（默认）：高可用（双副本）。
SrcDBInstanceId	String	否	r-bp1zxszhcgatnx****	源实例 ID，可调用DescribeInstances获取。说明当您需要基于该实例的备份数据创建新实例时，您才需要传入本参数。
BackupId	String	否	111111111	备份集 ID，可通过调用DescribeBackups查询。说明如需基于某个实例的备份数据创建新实例，在传入SrcDBInstanceId参数指定了源实例后，您还需要在本参数中指定源实例的备份集 ID，系统将基于该备份集的数据创建新的实例。
RebuildInstance	String	否	false	是否需要从回收站中重建恢复源实例，取值： true：需要。 false（默认）：不需要。说明如果传入了本参数，则必须传入SrcDBInstanceId参数。

Instances 参数请求示例

[{
    "RegionId": "cn-hangzhou",
    "izNo": "cn-hangzhou-b",
    "quantity": 1,
    "instanceType": "Redis",
    "instanceClass": "redis.logic.sharding.1g.2db.0rodb.4proxy.default",
    "EngineVersion": "5.0",
    "ChargeType": "PrePaid",
    "Period":"1",
    "networkType": "VPC" , 
    "vpcId": "vpc-2zex6u1nu32k3ux35xxxx", 
    "vSwitchId": "vsw-2zesk464e647104kwxxxx"
}]

返回参数

字段名称	字段详情
OrderIdstring	订单 ID。示例值:20905403119****
RequestIdstring	请求 ID。示例值:561AFBF1-BE20-44DB-9BD1-6988B53E****
InstanceIdsobject

变更历史

	变更时间	变更内容概要	操作
	2022-02-22	变更错误码400