更新时间:2025-09-09 GMT+08:00
分享

查询GeminiDB Redis实例的大key

功能介绍

支持查询Redis实例的Key。

接口约束

该接口支持如下数据库实例:

  • GeminiDB Redis

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v3/{project_id}/instances/{instance_id}/big-keys

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户在某一region下的project ID。获取方法请参见获取项目ID

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

instance_id

String

参数解释:

实例ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释:

索引位置偏移量,表示从查询到的大key列表偏移offset条数据后查询对应的大key信息。

约束限制:

不涉及。

取值范围:

大于或等于0。

默认取值:

不传该参数时,查询偏移量默认为0,表示从第一条大key开始查询。

limit

Integer

参数解释:

查询个数上限值。

约束限制:

不涉及。

取值范围:

1~100。

默认取值:

不传该参数时,默认查询前100条大key。

key_types

Array of strings

参数解释:

大key的类型,一个字符串列表。

约束限制:

不涉及。

取值范围:

支持"string"、"hash"、"zset"、"set"、"list"、"stream"六种类型。

默认取值:

不涉及。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

keys

Array of 表5 objects

参数解释:

查询到的大Key列表。

取值范围:

不涉及。

count

Integer

参数解释:

大Key的总数。

取值范围:

不涉及。

表5 BigKeysInfoResponseBody

参数

参数类型

描述

db_id

Integer

参数解释:

大Key所在的DB。

取值范围:

不涉及。

key_type

String

参数解释:

大Key类型。

取值范围:

  • key_types的取值范围里也要加exhash。
  • string:表示String类型。
  • hash:表示Hash类型。
  • list:表示List类型。
  • zset:表示ZSet类型。
  • set:表示Set类型。
  • exhash:表示ExHash类型。
  • stream:表示Stream类型。

key_name

String

参数解释:

大Key名。

取值范围:

不涉及。

key_size

Integer

参数解释:

大Key的长度。

取值范围:

不涉及。

请求示例

POST https://{endpoint}/v3/instances/91b5c48e11bf4913b35814f28b8f79f2in12/big-keys 
  
 { 
   "key_types" : [ "string", "hash", "zset", "set", "list", "stream" ] 
 }

响应示例

状态码: 200

Success.

{ 
   "keys" : [ { 
     "db_id" : 0, 
     "key_type" : "String", 
     "key_name" : "a", 
     "key_size" : 12 
   } ], 
   "count" : 1 
 }

状态码

请参见状态码

错误码

请参见错误码

相关文档