查询热key分析详情
功能介绍
查询热key分析详情。
URI
GET /v2/{project_id}/instances/{instance_id}/hotkey-task/{hotkey_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID。 |
hotkey_id |
是 |
String |
热key分析任务ID。 |
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
热key分析记录ID。 |
instance_id |
String |
实例ID。 |
status |
String |
分析任务状态。 枚举值:
|
scan_type |
String |
分析方式。 枚举值:
|
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,不返回)。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
Key名称。 |
type |
String |
Key类型。 枚举值:
|
shard |
String |
热key所在的分片,仅在实例类型为集群时支持,格式为ip:port。 |
db |
Integer |
热key所在的DB。 |
size |
Long |
Key的value大小。 |
unit |
String |
表示key的单位。count:key的数量,byte:key的大小。 |
freq |
Integer |
表示某个key在一段时间的访问频度,会随着访问的频率而变化。 该值并不是简单的访问频率值,而是一个基于概率的对数计数器结果,最大为255(可表示100万次访问),超过255后如果继续频繁访问该值并不会继续增大,同时默认如果每过一分钟没有访问,该值会衰减1。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信(暂未使用,赋值为null)。 最大长度:1024 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_msg |
String |
错误信息。 最大长度:1024 |
error_code |
String |
错误码。 最大长度:9 |
error_ext_msg |
String |
扩展错误信(暂未使用,赋值为null)。 最大长度:1024 |
请求示例
GET https://{dcs_endpoint}/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 |
内部服务错误。 |
错误码
请参见错误码。