移动资源

最近更新时间:2024-04-03 11:14:23

我的收藏

1. 接口描述

接口请求域名: cme.tencentcloudapi.com 。

移动资源,支持跨个人或团队移动媒体以及分类。如果填写了Operator,则需要校验用户对媒体和分类资源的访问以及写权限。

  • 当原始资源为媒体时,该接口效果为将该媒体移动到目标分类下面;
  • 当原始资源为分类时,该接口效果为将原始分类移动到目标分类或者是重命名。
  • 如果 SourceResource.Resource.Id = /素材/视频/NBA,DestinationResource.Resource.Id= /素材/视频/篮球
  • 当 DestinationResource.Resource.Id 不存在时候且原始资源与目标资源归属相同,操作结果为重命名原始分类;
  • 当 DestinationResource.Resource.Id 存在时候,操作结果为产生新目录 /素材/视频/篮球/NBA
  • 默认接口请求频率限制:20次/秒。

    推荐使用 API Explorer
    点击调试
    API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

    2. 输入参数

    以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

    参数名称 必选 类型 描述
    Action String 公共参数,本接口取值:MoveResource。
    Version String 公共参数,本接口取值:2019-10-29。
    Region String 公共参数,本接口不需要传递此参数。
    Platform String 平台 Id,指定访问的平台。关于平台概念,请参见文档 平台
    示例值:your_platform
    SourceResource ResourceInfo 待移动的原始资源信息,包含原始媒体或分类资源,以及资源归属。
    DestinationResource ResourceInfo 目标信息,包含分类及归属,仅支持移动资源到分类。
    Operator String 操作者。如不填,默认为 cmeid_system,表示平台管理员操作,可以移动任务资源。如果指定操作者,则操作者必须对源及目标资源有写权限。
    示例值:user_id

    3. 输出参数

    参数名称 类型 描述
    RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 跨归属移动媒体

    将归属于个人的媒体文件移动到团队

    输入示例

    https://cme.tencentcloudapi.com/?Action=MoveResource
    &Platform=test
    &SourceResource.Resource.Id=123245678
    &SourceResource.Resource.Type=MATERIAL
    &SourceResource.Owner.Id=6b6ef043-85f3-4614-b735-xxx
    &SourceResource.Owner.Type=PERSON
    &DestinationResource.Resource.Id=/个人/视频
    &DestinationResource.Resource.Type=CLASS
    &DestinationResource.Owner.Id=cmetid_5fa4f63306e69dxx
    &DestinationResource.Owner.Type=TEAM
    &<公共请求参数>

    输出示例

    {
        "Response": {
            "RequestId": "d1c5eb0e-e499-4419-b465-60c097fbb65b"
        }
    }

    示例2 移动媒体到某分类下面

    输入示例

    https://cme.tencentcloudapi.com/?Action=MoveResource
    &Platform=test
    &SourceResource.Resource.Id=123245678
    &SourceResource.Resource.Type=MATERIAL
    &SourceResource.Owner.Id=6b6ef043-85f3-4614-b735-768bb466ae5b
    &SourceResource.Owner.Type=PERSON
    &DestinationResource.Resource.Id=/个人/视频
    &DestinationResource.Resource.Type=CLASS
    &DestinationResource.Owner.Id=6b6ef043-85f3-4614-b735-768bb466ae5b
    &DestinationResource.Owner.Type=PERSON
    &<公共请求参数>

    输出示例

    {
        "Response": {
            "RequestId": "d1c5eb0e-e499-4419-b465-60c0973b3d2"
        }
    }

    示例3 移动分类到已经存在的分类下

    目标分类已经存在,操作结果为将原始分类的资源移到新分类 /个人/娱乐/综艺

    输入示例

    https://cme.tencentcloudapi.com/?Action=MoveResource
    &Platform=test
    &SourceResource.Resource.Id=/个人/综艺
    &SourceResource.Resource.Type=CLASS
    &SourceResource.Owner.Id=6b6ef043-85f3-4614-b735-768bb466ae5b
    &SourceResource.Owner.Type=PERSON
    &DestinationResource.Resource.Id=/个人/娱乐
    &DestinationResource.Resource.Type=CLASS
    &DestinationResource.Owner.Id=6b6ef043-85f3-4614-b735-768bb466ae5b
    &DestinationResource.Owner.Type=PERSON
    &<公共请求参数>

    输出示例

    {
        "Response": {
            "RequestId": "d1c5eb0e-e499-4419-b465-60c097fbb65b"
        }
    }

    示例4 移动分类到不存在的分类下,资源归属相同

    目标分类不存在,操作结果为将原始分类重命名为 /个人/娱乐

    输入示例

    https://cme.tencentcloudapi.com/?Action=MoveResource
    &Platform=test
    &SourceResource.Resource.Id=/个人/综艺
    &SourceResource.Resource.Type=CLASS
    &SourceResource.Owner.Id=6b6ef043-85f3-4614-b735-768bb466ae5b
    &SourceResource.Owner.Type=PERSON
    &DestinationResource.Resource.Id=/个人/娱乐
    &DestinationResource.Resource.Type=CLASS
    &DestinationResource.Owner.Id=6b6ef043-85f3-4614-b735-768bb466ae5b
    &DestinationResource.Owner.Type=PERSON
    &<公共请求参数>

    输出示例

    {
        "Response": {
            "RequestId": "d1c5eb0e-e499-4419-b465-60c097fbb65b"
        }
    }

    5. 开发者资源

    腾讯云 API 平台

    腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

    API Inspector

    用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

    SDK

    云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

    命令行工具

    6. 错误码

    以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

    错误码 描述
    FailedOperation 操作失败。
    InternalError 内部错误。
    InvalidParameter.Platform 平台参数非法。
    InvalidParameterValue.ClassPath 分类路径不合法。
    InvalidParameterValue.MaterialId 媒体 ID 无效。
    OperationDenied.PermissionDeny 权限不足,请检查对应操作者的权限。
    ResourceNotFound.Platform 平台不存在。