详情页标题前

腾讯云对象存储文件解压

• 腾讯云
详情页1

简介

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

API 操作描述
提交文件解压任务 以提交任务的方式进行文件解压缩，异步返回压缩包内被解压出来的文件，该接口属于 POST 请求。
查询文件解压结果 本接口用于主动查询指定的文件解压任务结果。

提交文件解压任务

功能说明

以提交任务的方式进行文件解压缩，异步返回压缩包内被解压出来的文件，该接口属于 POST 请求。

方法原型

public Guzzle\Service\Resource\Model createFileUncompressJobs(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/83110 提交文件解压任务-异步    $result = $cosClient->createFileUncompressJobs(array(        'Bucket' => 'examplebucket-1250000000', //存储桶名称，由 BucketName-Appid 组成，可以在 COS 控制台查看 https://console.cloud.tencent.com/cos5/bucket        'Tag' => 'FileUncompress',//        'QueueId' => 'pcc3ae89sa9d807fs89dg789sdg',        'Input' => array(            'Object' => 'test.zip',        ),        'Operation' => array(            'UserData' => 'xxx',            'FileUncompressConfig' => array(                'Prefix' => 'prefix',                'PrefixReplaced' => '1',            ),            'Output' => array(                'Region' => $region,                'Bucket' => 'examplebucket-1250000000', //存储桶名称，由 BucketName-Appid 组成，可以在 COS 控制台查看 https://console.cloud.tencent.com/cos5/bucket            ),        ),//        'CallBackFormat' => '',//        'CallBackType' => '',//        'CallBack' => '',//        'CallBackMqConfig' => array(//            'MqRegion' => '',//            'MqMode' => '',//            'MqName' => '',//        ),    ));    // 请求成功    print_r($result);} catch (\Exception $e) {    // 请求失败    echo($e);}

参数说明

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

节点名称（关键字） 父节点 描述 类型 是否必选
Tag Request 表示任务的类型，文件解压默认为：FileUncompress。 String 是
Input Request 包含待操作的文件信息。 Container 是
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 类型 Input 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Object Request.Input 文件名，取值为文件在当前存储桶中的完整名称。 String 是

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

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

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

节点名称（关键字） 父节点 描述 类型 是否必选
Prefix Request.Operation.FileUncompressConfig 指定解压后输出文件的前缀，不填则默认保存在存储桶根路径。 String 否
PrefixReplaced Request.Operation.FileUncompressConfig 指定解压后的文件路径是否需要替换前缀，默认值为0。有效值：0：不添加额外的前缀，解压缩将保存在 Prefix 指定的路径下（不会保留压缩包的名称，仅将压缩包内的文件保存至指定的路径）。1：以压缩包本身的名称作为前缀，解压缩将保存在 Prefix 指定的路径下。2：以压缩包完整路径作为前缀，此时如果不指定 Prefix，就是解压到压缩包所在的当前路径（包含压缩包本身名称）。
 String 否

说明：假设压缩包名为 test.zip，压缩包内的文件为“图片.jpg”，存储在了存储桶 A 的 123 目录下，则压缩包的完整路径为：123/test.zip。
对该压缩包进行解压缩，指定解压缩到存储桶A，并指定 Prefix 为 456，则不同的PrefixReplaced值对应解压后的文件保存情况如下：0：“图片.jpg”会保存在 456 目录下，“图片.jpg”的完整路径为 456/图片.jpg。1：“图片.jpg”会以 test 为前缀保存在 456 目录下，“图片.jpg”的完整路径为 456/test/图片.jpg。2：“图片.jpg”会以 123/test 为前缀保存在 456 目录下，“图片.jpg”的完整路径为 456/123/test/图片.jpg。Container 类型 Output 的具体数据描述如下：

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

返回结果示例

GuzzleHttp\Command\Result Object(    [RequestId] => NjNkOGM2NmVfZTYxNmY5MSAASJPOJCIANSIDNAI=    [ContentType] => application/xml    [ContentLength] => 872    [JobsDetail] => Array        (            [Progress] => 0            [Code] => Success            [Message] =>             [JobId] => fcd32dbdaa13b11esa9ds8g0d98gd0h85            [Tag] => FileUncompress            [State] => Submitted            [CreationTime] => 2023-01-31T16:05:31+0800            [StartTime] => -            [EndTime] => -            [QueueId] => pcc3ae89sa9d807fs89dg789sdg            [Input] => Array                (                    [BucketId] => examplebucket-1250000000                    [Region] => ap-guangzhou                    [Object] => test.zip                )
            [Operation] => Array                (                    [JobLevel] => 0                    [UserData] => xxx                    [Output] => Array                        (                            [Region] => ap-guangzhou                            [Bucket] => examplebucket-1250000000                        )
                    [FileUncompressConfig] => Array                        (                            [Prefix] => prefix                            [PrefixReplaced] => 1                        )
                )
        )
    [Bucket] => examplebucket-1250000000    [Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/file_jobs)

查询文件解压结果

功能说明

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

方法原型

public Guzzle\Service\Resource\Model getFileUncompressResult(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/83111 查询文件解压结果    $result = $cosClient->getFileUncompressResult(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] => 1092    [JobsDetail] => Array        (            [Progress] => 100            [Code] => Success            [Message] => success            [JobId] => fcd32dbdaa13b11esa9ds8g0d98gd0h85            [Tag] => FileUncompress            [State] => Success            [CreationTime] => 2023-01-31T16:05:31+0800            [StartTime] => 2023-01-31T16:05:31+0800            [EndTime] => 2023-01-31T16:05:31+0800            [QueueId] => pcc3ae89sa9d807fs89dg789sdg            [Input] => Array                (                    [BucketId] => examplebucket-1250000000                    [Region] => ap-guangzhou                    [Object] => test.zip                )
            [Operation] => Array                (                    [JobLevel] => 0                    [UserData] => xxx                    [Output] => Array                        (                            [Region] => ap-guangzhou                            [Bucket] => examplebucket-1250000000                        )
                    [FileUncompressConfig] => Array                        (                            [Prefix] => prefix                            [PrefixReplaced] => 1                        )
                    [FileUncompressResult] => Array                        (                            [Region] => ap-guangzhou                            [Bucket] => examplebucket-1250000000                            [FileCount] => 6                        )
                )
        )
    [Key] => fcd32dbdaa13b11esa9ds8g0d98gd0h85    [Bucket] => examplebucket-1250000000    [Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/file_jobs/fcd32dbdaa13b11esa9ds8g0d98gd0h85)



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

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

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

相关推荐

  • 腾讯云内容分发网络CDN步骤二：上传文件到 COS 存储桶 腾讯云

    腾讯云内容分发网络CDN步骤二：上传文件到 COS 存储桶

    在创建的存储桶页面，单击上传文件，会出现弹窗，在弹窗中单击选择文件。 文件上传完成后会展示在存储桶文件列表中。  内容分发网络CDN官网1折活动，限时活动，即将结束，速速收藏同尘科技为腾讯云授权服务中心。购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠

    2023年12月9日

  • 腾讯云计算加速套件TACO Kit产品动态

    2022年05月 动态名称 动态描述 相关文档 计算加速套件TACO Kit 上线 计算加速套件 TACO Kit（TencentCloud Accelerated Computing Optimization Kit）是一种异构计算加速软件服务，具备领先的 GPU 共享技术和业界唯一的 GPU 在离线混部能力，搭配腾讯自研的软硬件协同优化组件和硬件厂商特有…

    腾讯云 2023年12月9日
  • 腾讯云内容分发网络CDN访问监控 腾讯云

    腾讯云内容分发网络CDN访问监控

    指标说明 概览页指标说明 登录 CDN 控制台，在左侧目录中，选择统计分析 > 实时监控，进入管理页面后，默认显示访问监控子页面。返回全部域名近6小时1分钟粒度监控曲线，包含指标如下：带宽：根据1分钟总流量除以时间（60秒）折算而来。流量命中率：1分钟内（总下行流量 – 回源流量） / 总下行流量计算而来。请求数状态码占比：所选时间区间 2…

    2023年12月9日
  • 腾讯云容器服务实现独立集群的 Master 容灾同尘科技 腾讯云

    腾讯云容器服务实现独立集群的 Master 容灾同尘科技

    概述 容器服务 TKE 包含托管集群及独立部署集群。若使用托管集群，则无需关注容灾，托管集群的 Master 由容器服务 TKE 内部维护。若使用独立集群，则 Master 节点由用户自行管理维护。独立集群如需实现容灾，则首先应根据需求规划容灾方案，在创建集群时进行相应配置即可。本文介绍如何实现 TKE 独立集群 Master 的容灾，您可参考本文进行操作。…

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

  • 阿里云ECS云服务器管理ECS实例自建数据库-云淘科技

    ECS实例自建数据库，是指在ECS实例上安装并配置的数据库。您可以使用数据管理服务DMS来管理ECS实例自建数据库。本文以MySQL为例，介绍如何使用DMS添加并管理ECS实例自建数据库。 前提条件 开通数据管理服务，详情请参见DMS。 已创建实例规格选用内存型r系列规格族ECS实例。具体步骤，请参见自定义购买实例。 在ECS实例安全组的入方向放行MySQL…

    阿里云服务器 2023年12月9日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

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

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