调用CreateInstances批量创建Redis实例。

请确保在使用该接口前,已充分了解云数据库Redis产品的收费方式和价格

说明 该API对应的控制台操作方法和选型建议,请参见创建Redis实例

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateInstances

系统规定参数,取值:CreateInstances

Instances String [{ "RegionId": "cn-hangzhou", "izNo": "cn-hangzhou-b", "quantity": 2, "instanceType": "Redis", "instanceClass": "redis.master.small.default", "EngineVersion": "5.0", "ChargeType": "PostPaid"}]

新实例的配置信息,格式为JSON,详细说明请参见Instances参数补充说明

RegionId String cn-hangzhou

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

Token String ETnLKlblzczshOTUbOCz****

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,大小写敏感、不超过64个ASCII字符。

AutoPay Boolean true

是否自动付费,取值:

  • true:自动付费,默认值。
  • false:手动付费。您需要在控制台的顶部菜单栏,单击费用 > 续费管理,然后单击左侧导航栏的订单管理 > 我的订单,找到目标订单进行支付。
说明 Instances参数中,ChargeType取值为PrePaid时,本参数才可用。
BusinessInfo String 000000000

活动ID、业务信息。

CouponNo String youhuiquan_promotion_option_id_for_blank

优惠码,默认值为:youhuiquan_promotion_option_id_for_blank

EngineVersion String 5.0

Redis实例的大版本,取值:2.84.05.0

说明 默认值为5.0
RebuildInstance Boolean false

是否需要从回收站中重建恢复源实例,取值:

  • true:需要。
  • false:不需要,默认值。
说明 Instances参数中设置了SrcDBInstanceId参数时,本参数才可用。
AutoRenew String false

是否开启自动续费,取值:

  • true:开启。
  • false:不开启,默认值。
说明 Instances参数中,ChargeType取值为PrePaid时,本参数才可用。

返回数据

名称 类型 示例值 描述
InstanceIds List { "InstanceId": [ "r-bp16e70a4338****", "r-bp178c19293a****" ] }

本次创建的实例ID的列表。

OrderId String 20905403119****

订单ID。

RequestId String 561AFBF1-BE20-44DB-9BD1-6988B53E****

请求ID。

示例

请求示例

http(s)://r-kvstore.aliyuncs.com/?Action=CreateInstances
&Instances=[{	"RegionId": "cn-hangzhou",	"izNo": "cn-hangzhou-b",	"quantity": 2,	"instanceType": "Redis",	"instanceClass": "redis.master.small.default",	"EngineVersion": "5.0",	"ChargeType": "PostPaid"}]
&<公共请求参数>

正常返回示例

XML格式

<CreateInstancesResponse>
      <RequestId>561AFBF1-BE20-44DB-9BD1-6988B53E****</RequestId>
      <OrderId>20905403119****</OrderId>
      <InstanceIds>
            <InstanceId>r-bp16e70a4338****</InstanceId>
            <InstanceId>r-bp178c19293a****</InstanceId>
      </InstanceIds>
</CreateInstancesResponse>

JSON格式

{
  "RequestId": "561AFBF1-BE20-44DB-9BD1-6988B53E****",
  "OrderId": "20905403119****",
  "InstanceIds": {
    "InstanceId": [
      "r-bp16e70a4338****",
      "r-bp178c19293a****"
    ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidToken.Malformed The Specified parameter "Token" is not valid. Token验证失败
400 InvalidInstanceName.Malformed The Specified parameter "InstanceName" is not valid. InstanceName验证失败
400 InvalidPassword.Malformed The Specified parameter "Password" is not valid. 密码验证无效
400 InvalidInstances.Malformed The Specified parameter "Instances" is not valid. Instances验证失败
400 InsufficientBalance Your account does not have enough balance. 账户余额不足,请先充值再操作。
403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. 您的帐户还没有通过实名认证。
400 QuotaExceed.AfterpayInstance Living afterpay instances quota exceeded. 超过了支付实例配额。
400 InvalidCapacity.NotFound The Capacity provided does not exist in our records. Capacity 容量非法。
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 IzNotSupportVpcError Specify iz not support vpc. 指定 iz不支持Vpc。

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