从对象存储或下载链接推送文件到一个或多个云手机实例（异步任务）。调用说明如下：

• 当前仅支持火山引擎对象存储。访问火山引擎对象存储中的文件，需要为接口开通访问权限。详细信息，参考 附件 中的说明。

• 文件推送结果通过回调返回，详细信息，参考 回调服务接入指南。

• 如果当前文件推送任务尚未完成，继续调用该接口时，会在文件上传完成后开始第二个文件推送任务（最多支持100个文件推送任务排队）。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表，参考 公共请求参数。

Body 参数

返回结果

通用返回参数，请参考 ResponseMetadata 结构说明。

Result 字段包含以下参数：

示例

请求示例

POST https://open.volcengineapi.com?Action=PushFile
&Version=2022-08-01
&<通过header传入的公共请求参数>

{
    "product_id":"1608456935646xxxxxx",
    "pod_id_list":["7299381659819xxxxxx"],
    "tos_bucket":"my-bucket",
    "tos_file_path":"files/file01.pdf",
    "endpoint":"tos-cn-beijing.volces.com",
    "region":"cn-beijing",
    "target_directory":"/data/local/"
}

返回示例

{
    "ResponseMetadata": {
        "Action": "PushFile",
        "Region": "cn-north-1",
        "RequestId": "202311141756018419E1DC3097D06C0ACC",
        "Service": "ACEP",
        "Version": "2022-08-01"
    },
    "Result": {
        "task_id": "7301253504004xxxxxx",
        "task_action": "PushFile"
    }
}

错误码