ModifyDBInstanceMinorVersion--缓存数据库 Redis 版-火山引擎

文档中心

缓存数据库 Redis 版

实例管理

ModifyDBInstanceMinorVersion

调用 ModifyDBInstanceMinorVersion 接口将目标 Redis 实例升级到指定小版本。

请求类型

异步请求。

注意事项

发起升级小版本操作后，系统会先准备对应版本的节点资源，并在您选择的切换时间内触发主从切换，将新节点提升为主节点。切换期间，数据库可能会短暂断连 1 次 ~ 3 次或处于秒级只读状态，请谨慎操作。更多详情，请参见升级小版本。
建议在业务低峰期执行切换操作，并确保应用具备自动重连机制，来减少相关操作对业务的影响。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
InstanceId	String	是	redis-cnlfkmh6uiii8****	实例 ID。说明您可以调用 DescribeDBInstances 接口查询目标地域下所有 Redis 实例的基本信息，包括实例 ID。
SwitchoverImmediately	Boolean	是	true	是否立即执行切换操作。取值范围如下： `true`：立即切换。 `false`：维护时间段切换。说明发起升级小版本操作后，系统会先准备对应版本的节点资源，并在您选择的切换时间内触发主从切换，将新节点提升为主节点。关于可维护时间段的更多信息，请参见设置可维护时间段。
ServerVersion	String	否	7.602.0	需要升级到的目标 Server 版本。说明若该参数留空，默认不会修改实例当前的 Server 版本。 `ServerVersion` 和 `ProxyVersion` 不可同时为空。您可以调用 DescribeDBEngineVersions 接口查询 Redis 数据库大版本所支持的小版本列表，包括各 Server 版本号信息。关于各 Server 版本的更多信息，请参见 Server 版本发布日志。
ProxyVersion	String	否	1.602.0	需要升级到的目标 Proxy 版本。说明若该参数留空，默认不会修改实例当前的 Proxy 版本。 `ServerVersion` 和 `ProxyVersion` 不可同时为空。您可以调用 DescribeDBEngineVersions 接口查询 Redis 数据库大版本所支持的小版本列表，包括各 Proxy 版本号信息。关于各 Proxy 版本的更多信息，请参见 Proxy 版本发布日志。

返回参数

参数	类型	示例值	描述
DBEngineVersion	Object		数据库版本信息列表。

示例

请求示例

POST https://redis.cn-beijing.volcengineapi.com/?Action=ModifyDBInstanceMinorVersion&Version=2020-12-07 HTTP/1.1
Host: redis.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=****
{
    "InstanceId": "redis-cnlfkmh6uiii8****",
    "SwitchoverImmediately": true,
    "ServerVersion": "7.602.0",
    "ProxyVersion": "1.602.0"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420322810023228002****",
        "Action": "ModifyDBInstanceMinorVersion",
        "Version": "2020-12-07",
        "Service": "Redis",
        "Region": "cn-beijing"
    },
    "Result": {
        "DBEngineVersion": {
            "Engine": "Redis",
            "EngineVersion": "7.0",
            "ProxyVersion": {
                "Version": "1.512.0"
            },
            "ServerVersion": {
                "Version": "7.512.0"
            }
        }
    }
}

错误码

更多详情，请参见错误码。

最近更新时间：2026.04.14 11:04:01

这个页面对您有帮助吗？

有用

无用

缓存数据库 Redis 版

请求类型 #

注意事项 #

调试 #

请求参数 #

返回参数 #

示例 #

请求示例 #

返回示例 #

错误码 #