云服务器内容精选

  • URI GET /v2/{project_id}/statistics/metrics/trend 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 开始时间。 end_time 是 String 结束时间。 dim 否 String 指标维度 | 目前最大支持3个维度,必须从0开始;维度格式为dim.{i}=key,value,key的最大长度32,value的最大长度为256。 单维度:dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d 多维度:dim.0=key,value&dim.1=key,value。 metric_names 是 Array of strings 指标名称列表,支持的指标名称参考Workspace运维监控指标。 period 否 String 数据周期 | MIN - 分钟级 5MIN - 5分钟级 DAY - 天级数据 HOUR - 小时级数据。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of MetricsWithTime objects 查询指标趋势响应。 表5 MetricsWithTime 参数 参数类型 描述 time String 时间。 metrics Array of Metric objects 指标值。 表6 Metric 参数 参数类型 描述 metric_name String 指标名称。 metric_value Double 指标值。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码: 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 功能介绍 查询桌面使用统计信息; 云服务每天凌晨02:00进行聚合运算前一天00:00:00~23:59:59的使用时长,并将周期范围内的数据聚合到周期边界上 跨天的记录会按照统计周期进行计算 假设一天内桌面登录多次,09:00~12:00,13:00~21:00,22:00~01:00(次日): 则当天的累计使用时长数据会被汇聚到23:59:59这个点;总使用时长为 3hours(09:00~12:00)+8hours(13:00~21:00)+2hours(22:00~00:00) 仅能查询最近180天已进行汇聚计算的数据
  • 响应示例 状态码: 200 响应成功。 { "count" : 0, "items" : [ { "resource_id" : "xxx-xxx-xxx", "resource_pool_id" : "xxx-xxx-xxx", "resource_name" : "xxxx", "metric" : [ { "metric_name" : "desktop_state", "metric_value" : 10 } ] } ] }
  • URI GET /v2/{project_id}/statistics/metrics/desktops 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 start_time 是 String 查询起始时间(0时区) 云服务每天凌晨02:00进行聚合运算前一天00:00:00~23:59:59的使用时长,并将周期范围内的数据聚合到周期边界上 跨天的记录会按照统计周期进行计算 假设一天内桌面登录多次,09:00~12:00,13:00~21:00,22:00~01:00(次日): 则当天的累计使用时长数据会被汇聚到23:59:59这个点;总使用时长为 3hours(09:00~12:00)+8hours(13:00~21:00)+2hours(22:00~00:00) 如果查询的from-to不足一个周期内,可能造成查询到数据为空; end_time 是 String 查询截至时间(0时区)。 resource_name 否 String 资源名称(模糊匹配)。 min_idle_days 否 Integer 最小空闲天数。 max_idle_days 否 Integer 最大空闲天数 min_idle_days、max_idle_days都非空时,max_idle_days必须大于等于min_idle_days否则可能查询不到数据 usage_min_hours 否 Integer 使用时长(hour)最小值。 usage_max_hours 否 Integer 使用时长(hour)最大值(必须大于等于usage_min_hours)。 sort_field 否 String 按照指标进行排序 desktop_usage - 按照桌面使用时长排序 desktop_idle_duration - 按照桌面空闲周期排序 sort_type 否 String 按照指标进行排序的方向;需配合sort_field一起使用 DESC - 降序返回数据 ASC - 升序返回数据 offset 否 Integer 查询的偏移量,默认值0。 limit 否 Integer limit范围[1-100],默认值0。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 count Integer 总数。 items Array of DesktopMetric objects 桌面统计指标。 表5 DesktopMetric 参数 参数类型 描述 resource_id String 桌面ID。 resource_pool_id String 桌面池ID(仅桌面池中的桌面存在该字段)。 resource_name String 桌面名称。 metric Array of Metric objects 统计信息 desktop_usage - 桌面使用时长(单位:秒) desktop_idle_duration - 桌面空闲时长(单位:秒) 表6 Metric 参数 参数类型 描述 metric_name String 指标名称。 metric_value Double 指标值。 状态码: 400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码: 401 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。 状态码: 500 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 响应示例 状态码: 200 响应成功。 { "rule_id" : "xxxx-xxxx-xxxx", "metric_name" : "desktop_idle_duration", "threshold" : 30, "comparison_operator" : "", "interval" : 1, "enable" : true, "notify_object" : "urn:smn:REGION_ID:XXX-XXX-XXX:topicName" }
  • 响应示例 状态码: 200 状态统计响应。 { "total_num" : 0, "attach_statistics" : { "attached_num" : 0, "unattached_num" : 0, "attaching_num" : 0, "attach_error_num" : 0 }, "run_state_statistics" : { "stop_num" : 0, "active_num" : 5, "error_num" : 0, "hibernated_num" : 0 }, "login_state_statistics" : { "in_use_num" : 0, "stop_num" : 0, "unregistered_num" : 0, "unable_to_connect_num" : 0, "ready_num" : 0, "disconnected_num" : 0 }, "desktop_pool_statistics" : [ { "desktop_pool_id" : 0, "desktop_pool_name" : 0, "total_num" : 0, "attach_statistics" : { "attached_num" : 0, "unattached_num" : 0, "attaching_num" : 0, "attach_error_num" : 0 }, "run_state_statistics" : { "stop_num" : 0, "active_num" : 5, "error_num" : 0, "hibernated_num" : 0 }, "login_state_statistics" : { "in_use_num" : 0, "stop_num" : 0, "unregistered_num" : 0, "unable_to_connect_num" : 0, "ready_num" : 0, "disconnected_num" : 0 } } ] }
  • URI GET /v2/{project_id}/statistics 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 desktop_type 否 Array of strings 桌面类型。 statistics_type 否 Array of strings 统计类型,为空时仅统计桌面总数 |- - attach-state 按照分配状态统计 - login-state 按照登录状态统计 - run-state 按照运行状态统计。
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 total_num Integer 桌面总数。 attach_statistics AttachStatistics object 分配情况统计。 run_state_statistics DesktopRunStatisticsRsp object 运行情况统计。 login_state_statistics DesktopLoginStatisticsRsp object 登录情况统计。 desktop_pool_statistics Array of DesktopPoolStatistics objects 每个桌面池的情况统计,当desktop_type指定为POOL时返回。 表5 DesktopPoolStatistics 参数 参数类型 描述 desktop_pool_id String 桌面池id。 desktop_pool_name String 桌面池名称。 total_num Integer 桌面总数。 attach_statistics AttachStatistics object 分配情况统计。 run_state_statistics DesktopRunStatisticsRsp object 运行情况统计。 login_state_statistics DesktopLoginStatisticsRsp object 登录情况统计。 表6 AttachStatistics 参数 参数类型 描述 attached_num Integer 已分配个数。 unattached_num Integer 未分配个数。 attaching_num Integer 分配中个数。 attach_error_num Integer 分配失败的个数。 表7 DesktopRunStatisticsRsp 参数 参数类型 描述 stop_num Integer 停止个数。 active_num Integer 运行中个数。 error_num Integer 故障个数。 hibernated_num Integer 休眠个数。 表8 DesktopLoginStatisticsRsp 参数 参数类型 描述 in_use_num Integer 使用中。 unregistered_num Integer 未注册数目。 unable_to_connect_num Integer 未注册数目。 ready_num Integer 空闲数目。 disconnected_num Integer 断开连接数目。 状态码: default 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码,失败时返回。 error_msg String 错误描述。 encoded_authorization_message String 加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。
  • 运营报表 运营报表提供当天之前的数据统计结果,即当天上传的行为数据需要到次日才会生成统计结果。可以查询近7天、近15天、近30天以及自定义时间的数据统计结果。包含PV-CTR、条目点击率。 PV-CTR 计算方式为:当天搜索结果页面被点击次数除以当天搜索接口成功调用次数(重复点击不去重)。 展示为PV-CTR、Top3 PV-CTR、Top5 PV-CTR、Top10 PV-CTR四张表。 条目点击率 计算方式为:当天搜索结果页面中条目被点击的次数除以当天条目被曝光次数(重复曝光不去重)。 父主题: 报表统计