全部产品
Search

搜索本产品

    云数据库 Tair（兼容 Redis®）：DescribeEngineVersion - 查询实例的大版本和小版本信息

    文档中心

    云数据库 Tair（兼容 Redis®）：DescribeEngineVersion - 查询实例的大版本和小版本信息

    更新时间：Aug 28, 2026

    查询云数据库 Tair（兼容 Redis）实例的大版本和小版本信息，同时可查询到小版本的发布日志信息。

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    kvstore:DescribeEngineVersion

    get

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    InstanceId

    string

    是

    实例 ID，可调用 DescribeInstances 接口获取。

    r-bp1zxszhcgatnx****

    返回参数

    名称

    类型

    描述

    示例值

    object

    IsLatestVersion

    boolean

    实例的小版本是否为最新，返回值：

    • true：是。

    • false：不是。

    false
    RequestId

    string

    请求 ID。

    A52974D1-9D57-4805-86CC-92E6EDE8****
    ProxyMinorVersion

    string

    Proxy 代理节点当前的小版本。

    说明

    仅集群与读写分离架构实例返回本参数。

    6.6.0
    DBVersionRelease

    string

    实例小版本的更新说明，包含发布时间、小版本号、类型（例如新特性）及详细说明等信息。

    {\"releaseInfo\":{\"createTime\":\"2021-07-27\",\"level\":1,\"releaseVersion\":\"0.5.4\",\"releaseNote\":\"功能更新：增强稳定性。\"}],\"versionChangesLevel\":2}
    ProxyVersionRelease

    string

    Proxy 代理节点的小版本更新说明，包含发布时间、小版本号、类型（例如新特性）及详细说明等信息。

    说明

    仅集群与读写分离架构实例返回本参数。

    {\"releaseInfo\":[{\"createTime\":\"2021-06-08\",\"level\":0,\"releaseVersion\":\"6.6.2\",\"releaseNote\":\"新特性：增加对部分内部命令的支持。\"}],\"versionChangesLevel\":2}
    EnableUpgradeMajorVersion

    boolean

    实例是否可升级大版本，返回值：

    • true：可升级。

    • false：不可升级，通常已经是最新版本。

    说明

    如需升级大版本，请调用 ModifyInstanceMajorVersion 接口。

    true
    EnableUpgradeMinorVersion

    boolean

    实例是否可升级小版本，返回值：

    • true：可升级。

    • false：已经是最新版本，不可升级。

    说明

    如需升级小版本，请调用 ModifyInstanceMinorVersion 接口。

    true
    MajorVersion

    string

    实例的大版本。

    5.0
    Engine

    string

    数据库类型，返回值：redis 或 memcache。

    redis
    MinorVersion

    string

    实例当前的小版本。

    redis-5.0_0.5.0
    IsRedisCompatibleVersion

    string

    是否 Redis 的兼容版本。

    1
    IsSSLEnable

    string

    是否启用 SSL，取值：

    • 1: 开启

    • 0: 关闭

    1
    IsNewSSLMode

    string

    是否支持新版 TLS，取值：

    • 1: 开启

    • 0: 关闭

    1
    IsAutoUpgradeOpen

    string

    是否开启了小版本自动升级，取值：

    • 0：未开启。

    • 1：开启。

    0
    DBLatestMinorVersion

    object

    该实例当前可升级至最新的小版本信息。

    MinorVersion

    string

    版本号。

    7.0.1.4
    Level

    string

    版本变更的重要性，取值：

    • 0：一般重要

    • 1：比较重要

    • 2：非常重要

    0
    VersionRelease

    object

    从实例当前小版本到最新小版本的版本演进路线，与版本文档一致，可以直接至版本说明文档查看更详细的信息。

    VersionChangesLevel

    string

    版本升级的重要性（推荐升级程度），取值：

    • 0：一般重要

    • 1：比较重要

    • 2：非常重要

    0
    ReleaseInfo

    object

    ReleaseInfoList

    array<object>

    小版本信息。

    object

    小版本信息。

    ReleaseVersion

    string

    EMR 发行版。

    EMR-5.7.0
    CreateTime

    string

    实例的创建时间。

    2022-11-21T13:28Z
    ReleaseNote

    string

    版本发布说明

    发布说明
    Level

    string

    重要等级。

    0
    ReleaseNoteEn

    string

    可升级的版本英文描述。

    版本升级英文描述
    ProxyLatestMinorVersion

    object

    该 Proxy 节点当前可升级至最新的小版本信息。

    MinorVersion

    string

    版本号。

    7.0.6
    Level

    string

    版本变更的重要性，取值：

    • 0：一般重要

    • 1：比较重要

    • 2：非常重要

    0
    VersionRelease

    object

    从实例当前小版本到最新小版本的版本演进路线，与版本文档一致，可以直接至版本说明文档查看更详细的信息。

    ReleaseInfo

    object

    ReleaseInfoList

    array<object>

    小版本信息。

    object

    小版本信息。

    ReleaseVersion

    string

    EMR 发行版。

    EMR-5.9.1
    CreateTime

    string

    版本的发布时间

    2022-08-23T14:26:20Z
    ReleaseNote

    string

    版本的变更说明

    x x x x
    Level

    string

    版本变更的重要性，取值：

    • 0：一般重要

    • 1：比较重要

    • 2：非常重要

    0
    ReleaseNoteEn

    string

    可升级的版本英文描述。

    版本升级英文描述
    VersionChangesLevel

    string

    版本升级的重要性（推荐升级程度），取值：

    • 0：一般重要

    • 1：比较重要

    • 2：非常重要

    0
    IsOpenNGLB

    string

    是否开启 NGLB 模式，取值：

    • 0：未开启。

    • 1：开启。

    1

    示例

    正常返回示例

    JSON格式

    {
  "IsLatestVersion": false,
  "RequestId": "A52974D1-9D57-4805-86CC-92E6EDE8****",
  "ProxyMinorVersion": "6.6.0",
  "DBVersionRelease": "{\\\"releaseInfo\\\":{\\\"createTime\\\":\\\"2021-07-27\\\",\\\"level\\\":1,\\\"releaseVersion\\\":\\\"0.5.4\\\",\\\"releaseNote\\\":\\\"功能更新：增强稳定性。\\\"}],\\\"versionChangesLevel\\\":2}",
  "ProxyVersionRelease": "{\\\"releaseInfo\\\":[{\\\"createTime\\\":\\\"2021-06-08\\\",\\\"level\\\":0,\\\"releaseVersion\\\":\\\"6.6.2\\\",\\\"releaseNote\\\":\\\"新特性：增加对部分内部命令的支持。\\\"}],\\\"versionChangesLevel\\\":2}",
  "EnableUpgradeMajorVersion": true,
  "EnableUpgradeMinorVersion": true,
  "MajorVersion": "5.0",
  "Engine": "redis",
  "MinorVersion": "redis-5.0_0.5.0",
  "IsRedisCompatibleVersion": "1",
  "IsSSLEnable": "1",
  "IsNewSSLMode": "1",
  "IsAutoUpgradeOpen": "0",
  "DBLatestMinorVersion": {
    "MinorVersion": "7.0.1.4",
    "Level": "0",
    "VersionRelease": {
      "VersionChangesLevel": "0",
      "ReleaseInfo": {
        "ReleaseInfoList": [
          {
            "ReleaseVersion": "EMR-5.7.0",
            "CreateTime": "2022-11-21T13:28Z",
            "ReleaseNote": "发布说明",
            "Level": "0",
            "ReleaseNoteEn": "版本升级英文描述"
          }
        ]
      }
    }
  },
  "ProxyLatestMinorVersion": {
    "MinorVersion": "7.0.6",
    "Level": "0",
    "VersionRelease": {
      "ReleaseInfo": {
        "ReleaseInfoList": [
          {
            "ReleaseVersion": "EMR-5.9.1",
            "CreateTime": "2022-08-23T14:26:20Z",
            "ReleaseNote": "x x x x",
            "Level": "0",
            "ReleaseNoteEn": "版本升级英文描述"
          }
        ]
      },
      "VersionChangesLevel": "0"
    }
  },
  "IsOpenNGLB": "1"
}

    异常返回示例

    JSON格式

    {
    "MinorVersion":"redis_0.12.4",
    "IsLatestVersion":"false",
    "MajorVersion":"2.8",
    "EnableUpgradeMajorVersion":"true",
    "RequestId":"A49A2216-F6C9-43E2-A8F0-F217E57943C4",
    "EnableUpgradeMinorVersion":"true",
    "Engine":"redis"
}

    错误码

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

    变更历史

    更多信息，参考变更详情。