DescribeEngineVersion - 查询实例的大版本和小版本信息

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
kvstore:DescribeEngineVersionget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
InstanceIdstring

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

r-bp1zxszhcgatnx****

返回参数

名称类型描述示例值
object
IsLatestVersionboolean

实例的小版本是否为最新,返回值:

  • true:是。
  • false:不是。
false
RequestIdstring

请求 ID。

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

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

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

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

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

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

说明 仅集群与读写分离架构实例返回本参数。
{\"releaseInfo\":[{\"createTime\":\"2021-06-08\",\"level\":0,\"releaseVersion\":\"6.6.2\",\"releaseNote\":\"新特性:增加对部分内部命令的支持。\"}],\"versionChangesLevel\":2}
EnableUpgradeMajorVersionboolean

实例是否可升级大版本,返回值:

  • true:可升级。
  • false:不可升级,通常已经是最新版本。
说明 如需升级大版本,请调用 ModifyInstanceMajorVersion 接口。
true
EnableUpgradeMinorVersionboolean

实例是否可升级小版本,返回值:

  • true:可升级。
  • false:已经是最新版本,不可升级。
说明 如需升级小版本,请调用 ModifyInstanceMinorVersion 接口。
true
MajorVersionstring

实例的大版本。

5.0
Enginestring

数据库类型,返回值:redismemcache

redis
MinorVersionstring

实例当前的小版本。

redis-5.0_0.5.0
IsRedisCompatibleVersionstring

是否 Redis 的兼容版本。

1
IsSSLEnablestring

是否启用 SSL,取值:

  • 1: 开启
  • 0: 关闭
1
IsNewSSLModestring

是否支持新版 TLS,取值:

  • 1: 开启
  • 0: 关闭
1
IsAutoUpgradeOpenstring

是否开启了小版本自动升级,取值:

  • 0:未开启。
  • 1:开启。
0
DBLatestMinorVersionobject

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

MinorVersionstring

版本号。

7.0.1.4
Levelstring

版本变更的重要性,取值:

  • 0:一般重要
  • 1:比较重要
  • 2:非常重要
0
VersionReleaseobject

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

VersionChangesLevelstring

版本升级的重要性(推荐升级程度),取值:

  • 0:一般重要
  • 1:比较重要
  • 2:非常重要
0
ReleaseInfoarray<object>

小版本信息。

ReleaseInfoListobject

小版本信息。

ReleaseVersionstring

EMR 发行版。

EMR-5.7.0
CreateTimestring

实例的创建时间。

2022-11-21T13:28Z
ReleaseNotestring

版本发布说明

发布说明
Levelstring

重要等级。

0
ReleaseNoteEnstring

可升级的版本英文描述。

版本升级英文描述
ProxyLatestMinorVersionobject

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

MinorVersionstring

版本号。

7.0.6
Levelstring

版本变更的重要性,取值:

  • 0:一般重要
  • 1:比较重要
  • 2:非常重要
0
VersionReleaseobject

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

ReleaseInfoarray<object>

小版本信息。

ReleaseInfoListobject

小版本信息。

ReleaseVersionstring

EMR 发行版。

EMR-5.9.1
CreateTimestring

版本的发布时间

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

版本的变更说明

x x x x
Levelstring

版本变更的重要性,取值:

  • 0:一般重要
  • 1:比较重要
  • 2:非常重要
0
ReleaseNoteEnstring

可升级的版本英文描述。

版本升级英文描述
VersionChangesLevelstring

版本升级的重要性(推荐升级程度),取值:

  • 0:一般重要
  • 1:比较重要
  • 2:非常重要
0
IsOpenNGLBstring

是否开启 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"
}

错误码

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

变更历史

变更时间变更内容概要操作
2024-04-22OpenAPI 返回结构发生变更查看变更详情
2023-10-18OpenAPI 返回结构发生变更查看变更详情
2022-11-15OpenAPI 返回结构发生变更查看变更详情
2022-09-26OpenAPI 返回结构发生变更查看变更详情