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

查询热key分析详情

功能介绍

查询热key分析详情。

调试

您可以在API Explorer中调试该接口,并获取该接口关联的CLI示例: hcloud DCS ShowHotkeyTaskDetails

URI

GET /v2/{project_id}/instances/{instance_id}/hotkey-task/{hotkey_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

instance_id

String

实例ID。

hotkey_id

String

热key分析任务ID。

请求参数

响应参数

状态码: 200

表2 响应Body参数

参数

参数类型

描述

id

String

热key分析记录ID

instance_id

String

实例ID

status

String

分析任务状态

枚举值:

  • waiting

  • running

  • success

  • failed

scan_type

String

分析方式

枚举值:

  • manual

  • auto

created_at

String

分析任务创建时间,格式为:"2020-06-15T02:21:18.669Z"

started_at

String

分析任务开始时间,格式为:"2020-06-15T02:21:18.669Z"(创建分析任务时此值为null,不返回)

finished_at

String

分析任务结束时间,格式为:"2020-06-15T02:21:18.669Z"(创建分析任务时此值为null,不返回)

num

Integer

热key的数量

keys

Array of HotkeysBody objects

热key记录(创建分析任务时此值为null,不返回)

表3 HotkeysBody

参数

参数类型

描述

name

String

key名称

type

String

key类型

枚举值:

  • string

  • list

  • set

  • zset

  • hash

shard

String

热key所在的分片,仅在实例类型为集群时支持,格式为ip:port

db

Integer

热key所在的db

size

Integer

key的value大小。

unit

String

key大小的单位。type为string时,单位是:byte;type为list/set/zset/hash时,单位是:count

freq

Integer

表示某个key在一段时间的访问频度,会随着访问的频率而变化。

该值并不是简单的访问频率值,而是一个基于概率的对数计数器结果,最大为255(可表示100万次访问),超过255后如果继续频繁访问该值并不会继续增大,同时默认如果每过一分钟没有访问,该值会衰减1。

状态码: 400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

状态码: 401

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

状态码: 403

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

状态码: 404

表7 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

请求示例

GET https://dcs.cn-south-1.myhuaweicloud.com/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/hotkey-task/0ccb25d5-27cf-4188-b5ea-987730a85371

响应示例

状态码: 200

查询热key分析详情成功。

{
  "id" : "858ee14c-2271-4489-8b82-7bda7459ae3e",
  "instance_id" : "5f9057b5-c330-4ee2-8138-7e69896eeec3",
  "status" : "success",
  "scan_type" : "manual",
  "created_at" : "2020-06-15T02:21:18.669Z",
  "started_at" : "2020-06-15T02:21:23.534Z",
  "finished_at" : "2020-06-15T02:21:25.588Z",
  "keys" : [ {
    "name" : "dcs-hotkey-test",
    "type" : "string",
    "shard" : "192.168.1.134:6379",
    "db" : 0,
    "size" : 3000,
    "unit" : "byte",
    "freq" : 4
  } ]
}

状态码: 400

非法请求。

{
  "error_code" : "DCS.4922",
  "error_msg" : "Does not support hotkey analyze."
}

状态码

状态码

描述

200

查询热key分析详情成功。

400

非法请求。

401

认证信息非法。

403

请求被拒绝访问。

404

所请求的资源不存在。

500

内部服务错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品

close