从指定云手机实例下载文件或文件夹到对象存储（异步任务）。调用说明如下：

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

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

请求方式

使用 POST 方式发起请求。

请求参数

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

Body 参数

返回结果

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

Result 字段包含以下参数：

示例

请求示例

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

{
    "product_id":"1608456935646xxxxxx",
    "pod_id":"7299381659819xxxxxx",
    "file_path":"/data/misc/logd",
    "tos_bucket":"my-bucket",
    "tos_file_path":"files/download.zip",
    "endpoint":"tos-cn-beijing.volces.com",
    "region":"cn-beijing"
}

返回示例

{
    "ResponseMetadata": {
        "Action": "PullFile",
        "Region": "cn-north-1",
        "RequestId": "20231114180546026C4EEFB0108B23F48B",
        "Service": "ACEP",
        "Version": "2022-08-01"
    },
    "Result": {
        "task_id": "7301255941591xxxxxx",
        "task_action": "PullFile"
    }
}

错误码