DescribeMediaDistribution - 查询媒资分布 -

查询音视频媒资数据按时间分布。起止时间跨度最大6个月。

接口说明

目前该接口服务地址仅支持：华东 2（上海）。
如果您不指定 StartTime 和 EndTime，该接口默认返回过去 7 天的数据；指定 StartTime 和 EndTime，该接口返回指定时间段的数据。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vod:DescribeMediaDistribution	list	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
StartTime	string	否	CreationTime（创建时间）的开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。起止时间跨度最大 6 个月。	2017-01-11T12:00:00Z
EndTime	string	否	CreationTime 的结束时间，需晚于开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。起止时间跨度最大 6 个月。	2017-01-11T12:59:00Z
StorageClass	string	否	分级存储类型： Standard：标准存储 IA：低频访问 Archive：归档存储 ColdArchive：冷归档存储 SourceIA：源文件低频访问 SourceArchive：源文件归档存储 SourceColdArchive：源文件冷归档存储 Changing：媒资存储类型变更中 SourceChanging：源文件存储类型变更中	Standard
Interval	string	否	统计间隔，默认值为天 day。 hour：小时，按起止时间所在自然小时统计 day：天，按起止时间所在自然天统计 week：星期，按起止时间所在自然周统计 month：月，按起止时间所在自然月统计	day

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	25818875-5F78-4AF6-D7393642CA58****
Total	long	音/视频总条数。	100
MediaDistributionList	array<object>	音/视频媒资分布列表。按照起止时间所在的自然小时、天、周、月等统计周期进行展示。
MediaDistribution	object	音/视频媒资分布。没有数据则不显示。
StartTime	string	统计起始时间（包括）。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-13T00:00:00Z
EndTime	string	统计结束时间（不包括）。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T00:00:00Z
Count	long	在统计自然周期内，输入时间范围命中的媒资数量。	12

示例

正常返回示例

JSON格式

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Total": 100,
  "MediaDistributionList": [
    {
      "StartTime": "2017-11-13T00:00:00Z",
      "EndTime": "2017-11-14T00:00:00Z",
      "Count": 12
    }
  ]
}

错误码

访问错误中心查看更多错误码。