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

接口说明

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

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

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

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

流控信息

请求速率为200/1(s)。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

kvstore:CreateInstances	Create	DBInstance acs:kvstore:{#regionId}:{#accountId}:instance/*	kvstore:InstanceClass kvstore:InstanceType kvstore:Appendonly	无

请求参数

字段名称	字段详情
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

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	Zone.Closed	Specified zone is closed.	诊断
400	MissingParameter	Period is mandatory for this action.	诊断
400	InvalidToken.Malformed	The Specified parameter "Token" is not valid.	诊断
400	InvalidInstanceName.Malformed	The Specified parameter "InstanceName" is not valid.	诊断
400	InvalidPassword.Malformed	The Specified parameter "Password" is not valid.	诊断
400	InvalidInstances.Malformed	The Specified parameter "Instances" is not valid.	诊断
400	InsufficientBalance	Your account does not have enough balance.	诊断
400	QuotaExceed.AfterpayInstance	Living afterpay instances quota exceeded.	诊断
400	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.	诊断
400	ResourceNotAvailable	Resource you requested is not available for finance user.	诊断
400	PaymentMethodNotFound	No payment method has been registered on the account.	诊断
400	IdempotentParameterMismatch	Request uses a client token in a previous request but is not identical to that request.	诊断
400	QuotaNotEnough	Quota not enough in this zone.	诊断
400	QuotaExceed	Living afterpay instances quota exceed.	诊断
400	VpcServiceError	Invoke vpc service failed.	诊断
400	IzNotSupportVpcError	Specify iz not support vpc.	诊断
400	InvalidVpcIdRegion.NotSupported	The Specified vpcId or vSwitchId not supported.	诊断
400	ResourceGroupNotExist	The Specified ResourceGroupId does not exist.	诊断
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	诊断
404	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.	诊断

变更历史

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