全部产品
Search

搜索本产品

    智能媒体服务：CreateUploadStream - 获取媒体流上传地址和凭证

    文档中心

    智能媒体服务：CreateUploadStream - 获取媒体流上传地址和凭证

    更新时间：Dec 16, 2024

    获取媒体流上传地址和凭证，并将上传完成的媒体流挂载到指定的MediaId下。

    接口说明

    适用场景

    本接口用于本地上传媒体流

    使用限制

    • 本接口仅支持上传至 VOD 点播存储，不支持上传至用户自有 OSS 存储。使用自有 OSS 存储的用户，可以先通过OSS SDK上传文件至 OSS，再调用 RegisterMediaStream 接口将媒体流挂载到指定媒资。
    • 本接口目前仅支持华东 2（上海）、华北 2（北京）、华南 1（深圳）地域。

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    MediaIdstring否

    媒资 ID。

    		****20b48fb04483915d4f2cd8ac****
    Definitionstring否

    视频流清晰度定义。取值：

    • FD：流畅。
    • LD：标清。
    • SD：高清。
    • HD：超清
    • OD：原画。
    • 2K：2K。
    • 4K：4K。
    • SQ：普通音质。
    • HQ：高音质。
    		HD
    FileExtensionstring否

    媒体文件扩展名。

    		MP4
    HDRTypestring否

    转码流 HDR 类型。取值：

    • HDR
    • HDR10
    • HLG
    • DolbyVision
    • HDRVivid
    • SDR+
    说明
  • 大小写不敏感。
  • 非 HDR 视频该参数为空即可。
    •
    		HDR10
    UserDatastring否

    用户自定义参数。

    		{"MessageCallback":{"CallbackURL":"http://aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

    返回参数

    名称类型描述示例值
    object

    返回结果。

    RequestIdstring

    请求 ID。

    		******11-DB8D-4A9A-875B-275798******
    MediaIdstring

    媒资 ID。

    		****c469e944b5a856828dc2****
    FileURLstring

    文件 OSS 地址（不带鉴权）。

    		http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4
    UploadAddressstring

    上传地址。

    说明 接口返回的上传地址是 Base64 加密后的值。调用 SDK 或 API 完成媒资上传时需要对其进行 Base64 解码后再使用。仅 OSS 原生 SDK 或 OSS API 方式上传需要自行解析 UploadAddress。
    		eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
    UploadAuthstring

    上传凭证。

    说明 接口返回的上传凭证是 Base64 加密后的值。调用 SDK 或 API 完成媒资上传时需要对其进行 Base64 解码后再使用。仅 OSS 原生 SDK 或 OSS API 方式上传需要自行解析 UploadAuth。
    		eyJFbmRwb2ludCI6Imm****

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaId": "****c469e944b5a856828dc2****",
  "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

    错误码

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史