调用ModifyInstanceSpec变更Redis实例的规格。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
InstanceId String 是 r-j6cxxxxxxxxxxxxx

目标实例的ID。
Action String 否 ModifyInstanceSpec

系统规定参数，取值：ModifyInstanceSpec。
RegionId String 否 cn-hangzhou

地域ID。
InstanceClass String 否 redis.master.small.default

变更后的实例规格，各规格的InstanceClass值请参见实例规格表。

说明 包年包月实例降级配置时必须将OrderType参数的值设置为DOWNGRADE。
BusinessInfo String 否 000000000

活动ID、业务信息。
CouponNo String 否 youhuiquan_promotion_option_id_for_blank

优惠码，默认值：youhuiquan_promotion_option_id_for_blank。

ForceUpgrade Boolean 否 true

是否强制变配，可选值：

  • false（否）；
  • true（是）。
说明 默认值：true。
AutoPay Boolean 否 true

是否自动付款，可选值：

  • true（是）
  • false（否）

默认值：false。

说明 当值为false时，请在实例即将到期时到控制台手动续费。
AccessKeyId String 否 Lxxxxxxxxxxxxxxw

阿里云颁发给用户的访问服务所用的密钥ID。
EffectiveTime String 否 Immediately

变更执行时间，可选值：

  • Immediately（立即执行）
  • MaintainTime（运维时间执行）

默认值：Immediately。
OrderType String 否 DOWNGRADE

包年包月实例变配时需要设置该参数指定变更类型，可选值：

  • UPGRADE，表示升级配置，默认值。
  • DOWNGRADE，表示降级配置。
说明
  • 按量付费实例变配无需设置该参数。
  • 包年包月实例降级配置时必须将该参数的值设置为DOWNGRADE。
  • 如果变配的目标规格比现有规格的价格高，则为升级配置，反之为降级配置。例如，读写分离8G版（5只读节点）的价格比16G集群版的价格高，从后者变配到前者为升级配置。

返回数据

名称 类型 示例值 描述
OrderId String 111111111111111

订单ID。
RequestId String 0DA1D7EF-C80D-432C-8758-7D225182626B

请求ID。

示例

请求示例


https://r-kvstore.aliyuncs.com/
?Action=ModifyInstanceSpec
&InstanceId=r-j6cxxxxxxxxxx3d4
&InstanceClass=redis.master.small.default
&<公共请求参数>

正常返回示例

XML 格式 

<ModifyInstanceSpecResponse>
      <OrderId>111111111111111</OrderId>
      <RequestId>0DA1D7EF-C80D-432C-8758-7D225182626B</RequestId>
</ModifyInstanceSpecResponse>

JSON 格式 

{
	"RequestId":"0DA1D7EF-C80D-432C-8758-7D225182626B",
	"OrderId":"111111111111111"
}

错误码

HttpCode 错误码 错误信息 描述
400 PaymentMethodNotFound No payment method has been registered on the account. 帐户上没有登记付款方法。
400 HasRenewChangeOrder This instance has a renewChange order. 实例还有续费变配订单。

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