云服务器内容精选

  • 请求示例 设置热key自动分析任务,每日缓存分析时间为21:00。 PUT https://{dcs_endpoint}/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/hotkey/autoscan { "enable_auto_scan" : true, "schedule_at" : [ "21:00" ] }
  • 响应示例 状态码: 200 设置热key自动分析配置成功。 { "instance_id" : "5f9057b5-c330-4ee2-8138-7e69896eeec3", "enable_auto_scan" : true, "schedule_at" : [ "21:00" ], "updated_at" : "2020-06-17T02:42:40.793Z" } 状态码: 400 非法请求。 { "error_code" : "DCS.4922", "error_msg" : "Does not support hotkey analyze." }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 instance_id String 所属实例ID。 enable_auto_scan Boolean 是否开启缓存分析定时任务。 schedule_at Array of strings 每日分析时间,时间格式为21:00,时间为UTC时间。 updated_at String 配置更新时间,时间格式为2020-06-15T02:21:18.669Z。 状态码: 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
  • 响应示例 状态码: 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 表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 Long Key的value大小。 unit String 表示key的单位。count:key的数量,byte:key的大小。 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