详情页标题前

腾讯云对象存储多文件打包压缩

• 腾讯云
详情页1

简介

本文档提供关于多文件打包压缩接口的 API 概览和 SDK 示例代码。

API 操作描述
提交多文件打包压缩任务 多文件打包压缩功能可以将您的多个文件，打包为 zip 等压缩包格式，以提交任务的方式进行多文件打包压缩，异步返回打包后的文件，该接口属于 POST 请求。
查询多文件打包压缩结果 本接口用于主动查询指定的多文件打包压缩任务结果。

提交多文件打包压缩任务

功能说明

多文件打包压缩功能可以将您的多个文件，打包为 zip 等压缩包格式，以提交任务的方式进行多文件打包压缩，异步返回打包后的文件，该接口属于 POST 请求。

方法原型

public Guzzle\Service\Resource\Model createFileCompressJobs(array $args = array());

请求示例

<?php
require dirname(__FILE__, 2) . '/vendor/autoload.php';
$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket$cosClient = new Qcloud\Cos\Client(    array(        'region' => $region,        'scheme' => 'https', //协议头部，默认为 http        'credentials'=> array(            'secretId'  => $secretId ,            'secretKey' => $secretKey)));try {    // https://cloud.tencent.com/document/product/436/83112 提交多文件打包压缩任务-异步    $result = $cosClient->createFileCompressJobs(array(        'Bucket' => 'examplebucket-1250000000', //存储桶名称，由 BucketName-Appid 组成，可以在 COS 控制台查看 https://console.cloud.tencent.com/cos5/bucket        'Tag' => 'FileCompress',//        'QueueId' => 'pcc3ae89sa9d807fs89dg789sdg',        'Operation' => array(            'UserData' => 'xxx',            'FileCompressConfig' => array(                'Flatten' => '0',                'Format' => 'zip',//                'UrlList' => 'test/index.csv',//                'Prefix' => 'test/',                'Keys' => array(                    'object1', // 待压缩桶文件                    'object2', // 待压缩桶文件                    'object3', // 待压缩桶文件                ),            ),            'Output' => array(                'Region' => $region,                'Bucket' => 'examplebucket-1250000000', //存储桶名称，由 BucketName-Appid 组成，可以在 COS 控制台查看 https://console.cloud.tencent.com/cos5/bucket                'Object' => 'output/test.zip',            ),        ),//        'CallBackFormat' => '',//        'CallBackType' => '',//        'CallBack' => '',//        'CallBackMqConfig' => array(//            'MqRegion' => '',//            'MqMode' => '',//            'MqName' => '',//        ),    ));    // 请求成功    print_r($result);} catch (\Exception $e) {    // 请求失败    echo($e);}

参数说明

Request 中的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Tag Request 表示任务的类型，多文件打包压缩默认为：FileCompress。 String 是
Operation Request 包含文件打包压缩的处理规则。 Container 是
QueueId Request 任务所在的 队列 ID。 String 否
CallBackFormat Request 任务回调格式，JSON 或 XML，默认 XML，优先级高于队列的回调格式。 String 否
CallBackType Request 任务回调类型，Url 或 TDMQ，默认 Url，优先级高于队列的回调类型。 String 否
CallBack Request 任务回调的地址，优先级高于队列的回调地址。 String 否
CallBackMqConfig Request 任务回调 TDMQ 配置，当 CallBackType 为 TDMQ 时必填。详情请参见 CallBackMqConfig。 Container 否

Container 类型 Operation 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
FileCompressConfig Request.Operation 指定文件打包压缩的处理规则。 Container 是
UserData Request.Operation 透传用户信息，可打印的 ASCII 码，长度不超过1024 String 否
Output Request.Operation 指定打包压缩后的文件保存的地址信息。 Container 是

Container 类型 FileCompressConfig 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Flatten Request.Operation.FileCompressConfig 文件打包时，是否需要去除源文件已有的目录结构，有效值： 0：不需要去除目录结构，打包后压缩包中的文件会保留原有的目录结构； 1：需要，打包后压缩包内的文件会去除原有的目录结构，所有文件都在同一层级。 例如：源文件 URL 为 https://domain/source/test.mp4, 则源文件路径为 source/test.mp4，如果为 1，则 ZIP 包中该文件路径为 test.mp4；如果为0， ZIP 包中该文件路径为 source/test.mp4。 String 是
Format Request.Operation.FileCompressConfig 打包压缩的类型，有效值：zip、tar、tar.gz。 String 是
UrlList Request.Operation.FileCompressConfig 支持将需要打包的文件整理成索引文件，后台将根据索引文件内提供的文件url，打包为一个压缩包文件。索引文件需要保存在当前存储桶中，本字段需要提供索引文件的对象地址，例如：/test/index.csv。索引文件格式：仅支持 CSV文件，一行一条URL（仅支持本存储桶文件），如有多列字段，默认取第一列作为URL。最多不超过10000个文件, 总大小不超过50G, 否则会导致任务失败。 String 否
Prefix Request.Operation.FileCompressConfig 支持对存储桶中的某个前缀进行打包，如果需要对某个目录进行打包，需要加/，例如test目录打包，则值为：test/。最多不超过10000个文件，总大小不超过50G，否则会导致任务失败。 String 否
Key Request.Operation.FileCompressConfig 支持对存储桶中的多个文件进行打包，个数不能超过 1000, 总大小不超过50G，否则会导致任务失败。 String 数组 否

注意:UrlList、Prefix、Key 三者仅能选择一个，不能都为空，也不会同时生效。如果填了多个，会按优先级 UrlList > Prefix > Key 取最高优先级执行。Container 类型 Output 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Region Request.Operation.Output 存储桶的地域。 String 是
Bucket Request.Operation.Output 保存压缩后文件的存储桶。 String 是
Object Request.Operation.Output 压缩后文件的文件名。 String 是

返回结果示例

GuzzleHttp\Command\Result Object(    [RequestId] => NjNkOGM2NmVfZTYxNmY5MSAASJPOJCIANSIDNAI=    [ContentType] => application/xml    [ContentLength] => 827    [JobsDetail] => Array        (            [Progress] => 0            [Code] => Success            [Message] =>             [JobId] => fcd32dbdaa13b11esa9ds8g0d98gd0h85            [Tag] => FileCompress            [State] => Submitted            [CreationTime] => 2023-01-31T16:17:21+0800            [StartTime] => -            [EndTime] => -            [QueueId] => pcc3ae89sa9d807fs89dg789sdg            [Operation] => Array                (                    [JobLevel] => 0                    [UserData] => xxx                    [Output] => Array                        (                            [Region] => ap-guangzhou                            [Bucket] => examplebucket-1250000000                            [Object] => tmp/test.zip                        )
                    [FileCompressConfig] => Array                        (                            [Flatten] => 0                            [Format] => zip                            [UrlList] =>                             [Prefix] =>                             [Key] => Array                                (                                    [0] => test1.png                                    [1] => test2.jpeg                                )
                        )
                )
        )
    [Bucket] => examplebucket-1250000000    [Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/file_jobs)

查询多文件打包压缩结果

功能说明

本接口用于主动查询指定的多文件打包压缩任务结果。

方法原型

public Guzzle\Service\Resource\Model getFileCompressResult(array $args = array());

请求示例

<?php
require dirname(__FILE__, 2) . '/vendor/autoload.php';
$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket$cosClient = new Qcloud\Cos\Client(    array(        'region' => $region,        'scheme' => 'https', //协议头部，默认为http        'credentials'=> array(            'secretId'  => $secretId ,            'secretKey' => $secretKey)));try {    // https://cloud.tencent.com/document/product/436/83113 查询多文件打包压缩结果    $result = $cosClient->getFileCompressResult(array(        'Bucket' => 'examplebucket-1250000000', //存储桶名称，由 BucketName-Appid 组成，可以在 COS 控制台查看 https://console.cloud.tencent.com/cos5/bucket        'Key' => '', // jobId    ));    // 请求成功    print_r($result);} catch (\Exception $e) {    // 请求失败    echo($e);}

参数说明

Request 中的具体数据描述如下：

参数名称 类型 描述 是否必填
Bucket String 存储桶名称，格式：BucketName-APPID 是
Key String jobId 是

返回结果示例

GuzzleHttp\Command\Result Object(    [RequestId] => NjNkOGM2NmVfZTYxNmY5MSAASJPOJCIANSIDNAI=    [ContentType] => application/xml    [ContentLength] => 1093    [JobsDetail] => Array        (            [Progress] => 100            [Code] => Success            [Message] => success            [JobId] => fcd32dbdaa13b11esa9ds8g0d98gd0h85            [Tag] => FileCompress            [State] => Success            [CreationTime] => 2023-01-31T16:17:21+0800            [StartTime] => 2023-01-31T16:17:21+0800            [EndTime] => 2023-01-31T16:17:22+0800            [QueueId] => pcc3ae89sa9d807fs89dg789sdg            [Operation] => Array                (                    [JobLevel] => 0                    [UserData] => xxx                    [Output] => Array                        (                            [Region] => ap-guangzhou                            [Bucket] => examplebucket-1250000000                            [Object] => tmp/test.zip                        )
                    [FileCompressConfig] => Array                        (                            [Flatten] => 0                            [Format] => zip                            [UrlList] =>                             [Prefix] =>                             [Key] => Array                                (                                    [0] => test1.png                                    [1] => test2.jpeg                                )
                        )
                    [FileCompressResult] => Array                        (                            [CompressFileCount] => 2                            [Region] => ap-guangzhou                            [Bucket] => examplebucket-1250000000                            [Object] => tmp/test.zip                        )
                )
        )
    [Key] => fcd32dbdaa13b11esa9ds8g0d98gd0h85    [Bucket] => examplebucket-1250000000    [Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/file_jobs/fcd32dbdaa13b11esa9ds8g0d98gd0h85)



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠

转转请注明出处：https://www.yunxiaoer.com/145960.html

赞 (0)
0
上一篇 2023年12月9日
下一篇 2023年12月9日
详情页2

相关推荐

  • 腾讯云云点播功能概览

    分类 功能 说明 媒体上传 多端上传 提供客户端上传（移动端、Web 端、微信小程序）、服务端上传（提供多语言 SDK）、控制台上传、URL 拉取上传、直播录制等多种上传方式。  客户端上传加速 利用腾讯云全球部署的加速网络，智能选择最优接入点和最优链路，显著提升媒体的上传速度和成功率。同时启用 QUIC 传输后，可大大减少网络拥塞，降低延时，改善…

    腾讯云 2023年12月9日
  • 腾讯云容器镜像服务使用交付流水线实现容器 DevOps同尘 腾讯云

    腾讯云容器镜像服务使用交付流水线实现容器 DevOps同尘

    操作场景 在云原生时代，DevOps 理念已被广泛接受，而容器技术的兴起和普及加速了 DevOps 的落地。基于容器 DevOps 实现持续集成和持续部署，可显著提升企业的业务应用创建和交付速度，提升企业的竞争力。本文将介绍如何通过使用 TCR 交付流水线功能，与容器服务 TKE、CODING DevOps 服务联合为用户提供简单易上手的容器 DevOps …

    2023年12月9日
  • 信息流广告，信息流部分建议宽度830px，只针对默认列表样式，顺序随机

  • 阿里云容器服务ACKALB Ingress服务高级用法-云淘科技

    在Kubernetes集群中，ALB Ingress对集群服务（Service）中外部可访问的API对象进行管理，提供七层负载均衡能力。本文介绍如何使用ALB Ingress将来自不同域名或URL路径的请求转发给不同的后端服务器组、将HTTP访问重定向至HTTPS及实现灰度发布等功能。 索引 前提条件 基于域名转发请求 基于URL路径转发请求 配置健康检查 …

    阿里云容器服务 2023年12月10日
  • 腾讯云云函数(SCF)在云函数中使用自定义字体-云淘科技 腾讯云

    腾讯云云函数(SCF)在云函数中使用自定义字体-云淘科技

    应用场景 通过在云函数中使用 Puppeteer，可按需完成针对特定网页的截图、保存、录屏、生成 PDF 等操作。该功能延续了云函数按需拉起的特性，在需要时才去实际启动实例执行，无需使用虚拟机或容器去持续运行服务，方便封装为通用能力。云函数的运行环境目前仅内置了单一字体，本文提供在云函数中使用自定义字体的最佳实践来解决单一字体不能满足定制化需求的问题。本文以…

    2023年12月9日

  • 腾讯云专用宿主机宿主机相关

    专用宿主机与裸金属云服务器的区别？ 裸金属云服务器属于裸金属架构，提供的是可以按需购买、按量付费的物理服务器租赁服务。专用宿主机则是搭载了腾讯云虚拟化系统的宿主机，购买之后，通过其上创建云服务器实例进行使用。 专用宿主机与普通云服务器的区别？ 专用宿主机是部署了虚拟化环境的专属物理服务器，用户独享整台物理服务器资源，与其他租户的服务器物理隔离。用户购买之后通…

    腾讯云 2023年12月9日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

工作时间：周一至周五，9:30-18:30，节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买，续费优惠，保证底价，买贵退差。