云服务器内容精选

  • URI GET /v2/{project_id}/stats/user 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 play_domain 是 String 播放 域名 。 app 否 String app名。 stream 否 String 流名。 isp 否 Array of strings 运营商列表,取值如下: CMCC :移动 CTCC : 电信 CUCC :联通 OTHER :其他 不填写查询所有运营商。 country 否 Array of strings 国家列表。具体取值请参考国家名称缩写,不填写查询所有国家。 region 否 Array of strings 区域列表。具体取值请参考省份名称缩写,不填写查询所有区域。 protocol 否 String 请求协议 interval 否 Integer 查询数据的时间粒度。单位:秒。 支持60秒(默认值)、300秒。不传值时,使用默认值60秒。 start_time 否 String 起始时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。最大查询跨度31天,最大查询周期一年。 若参数为空,默认查询7天数据。 end_time 否 String 结束时间。日期格式按照ISO8601表示法,并使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ。 若参数为空,默认为当前时间。结束时间需大于起始时间。 service_type 否 String 服务类型,取值如下: Live :标准直播 LLL :低时延直播 ALL :所有服务类型 不填写默认查询所有服务类型的数据。
  • 响应示例 状态码: 200 处理成功返回。 { "data_list" : [ { "value" : 50, "time" : "2020-06-04T07:00:00Z" }, { "value" : 60, "time" : "2020-06-04T07:01:00Z" } ] } 状态码: 400 处理失败返回。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: play_domain" }
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。
  • 响应参数 状态码: 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 data_list Array of V2UserData objects 观众趋势列表。 表6 V2UserData 参数 参数类型 描述 value Long 采样点观众数。 time String 采样时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 状态码: 400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • URI GET /v2/{project_id}/stats/httpcodes 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 play_domains 是 Array of strings 播放域名列表,最多支持查询100个域名, 多个域名 以逗号分隔。 code 否 Array of strings 状态码。 region 否 Array of strings 区域列表。具体取值请参考省份名称缩写,不填写查询所有区域。 isp 否 Array of strings 运营商列表,取值如下: CMCC :移动 CTCC : 电信 CUCC :联通 OTHER :其他 不填写查询所有运营商。 start_time 否 String 起始时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。若参数为空,默认查询最近1小时数据。 最大查询跨度1天,最大查询周期7天。 end_time 否 String 结束时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 若参数为空,默认为当前时间。结束时间需大于起始时间。 最大查询跨度1天,最大查询周期7天。
  • 响应参数 状态码: 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 data_series Array of HttpCodeSummary objects 基于时间轴的状态码 表6 HttpCodeSummary 参数 参数类型 描述 http_codes Array of HttpCode objects 状态码信息 time String 采样时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ 。 表7 HttpCode 参数 参数类型 描述 code Integer 状态码 count Integer 状态码出现次数 proportion Double 状态码在对应时间点中的占比,保留4位小数。 状态码: 400 表8 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。
  • 响应示例 状态码: 200 处理成功返回。 { "data_series" : [ { "time" : "2020-06-04T07:00:00Z", "http_codes" : [ { "code" : 200, "count" : 750, "proportion" : 0.5211 }, { "code" : 400, "count" : 650, "proportion" : 0.4789 } ] }, { "time" : "2020-06-04T07:01:00Z", "http_codes" : [ { "code" : 200, "count" : 1000, "proportion" : 1 }, { "code" : 400, "count" : 0, "proportion" : 0 } ] } ] } 状态码: 400 参数错误。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: play_domains" }
  • 响应示例 状态码: 200 处理成功返回。 { "publish_domain" : "livepull-test.huaweicloud.com", "app" : "app", "stream" : "pull_stream", "video_framerate" : [ { "start_time" : "2022-02-04T07:00:00Z", "end_time" : "2022-02-04T07:00:02Z", "data_list" : [ 21, 22 ] }, { "start_time" : "2022-02-04T07:00:05Z", "end_time" : "2022-02-04T07:00:07Z", "data_list" : [ 13, 34, 21 ] } ], "video_bitrate" : [ { "start_time" : "2022-02-04T07:00:00Z", "end_time" : "2022-02-04T07:00:02Z", "data_list" : [ 1326, 1268, 775 ] }, { "start_time" : "2022-02-04T07:00:05Z", "end_time" : "2022-02-04T07:00:07Z", "data_list" : [ 1021, 2022 ] } ] } 状态码: 400 处理失败返回。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: publish_domain" }
  • URI GET /v2/{project_id}/stats/stream-detail 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 publish_domain 是 String 推流域名。 app 是 String 应用名。 stream 是 String 流名。 start_time 否 String 起始时间。日期格式按照ISO8601表示法,并使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ。 最大查询跨度1天,最大查询周期7天。 若参数为空,默认查询最近1小时数据。 end_time 否 String 结束时间。日期格式按照ISO8601表示法,并使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ。 最大查询跨度1天,最大查询周期7天。 若参数为空,默认为当前时间。结束时间需大于起始时间。
  • 响应参数 状态码: 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 publish_domain String 推流域名 app String 应用名 stream String 流名 video_framerate Array of StreamDetail objects 展示流视频帧率情况,帧率单位为fps。 如果出现断流则会出现多个时间段流信息,如: "video_framerate": [ { "start_time": "2022-02-04T07:00:00Z", "end_time": "2022-02-04T07:00:02Z", "data_list": [ 21, 22 ] }, { "start_time": "2022-02-04T07:00:05Z", "end_time": "2022-02-04T07:00:07Z", "data_list": [ 13, 34, 21 ] } ] video_bitrate Array of StreamDetail objects 展示流视频码率情况,码率单位为Kbps。 如果出现断流则会出现多个时间段流信息,如: "video_bitrate": [ { "start_time": "2022-02-04T07:00:00Z", "end_time": "2022-02-04T07:00:02Z", "data_list": [ 1326, 1268, 775 ] }, { "start_time": "2022-02-04T07:00:05Z", "end_time": "2022-02-04T07:00:07Z", "data_list": [ 1021, 2022 ] } ] 表6 StreamDetail 参数 参数类型 描述 start_time String 采样开始时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 end_time String 采样结束时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 data_list Array of longs 流监控数据列表。 状态码: 400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息,与路径参数中的项目ID相同。
  • 响应示例 状态码: 200 处理成功返回。 { "framerate_info_list" : [ { "publish_domain" : "livepush-test.huaweicloud.com", "app" : "live", "stream" : "pull", "start_time" : "2020-06-04T07:00:00Z", "end_time" : "2020-06-05T07:00:00Z", "data_list" : [ 10, 20 ] } ] } 状态码: 400 处理失败返回。 { "error_code" : "LIVE.100011001", "error_msg" : "Invalid request parameter: domain" }
  • 响应参数 状态码: 200 表4 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表5 响应Body参数 参数 参数类型 描述 framerate_info_list Array of V2FramerateInfo objects 用量详情。 表6 V2FramerateInfo 参数 参数类型 描述 publish_domain String 推流域名。 app String 应用名称。 stream String 流名。 start_time String 采样开始时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 end_time String 采样结束时间。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:YYYY-MM-DDThh:mm:ssZ。 data_list Array of longs 帧率信息列表,单位为fps。 状态码: 400 表7 响应Header参数 参数 参数类型 描述 X-Request-Id String 请求的唯一标识。 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。使用Token鉴权方式时必选。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。 X-Project-Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息,与路径参数中的项目ID相同。