tencent cloud

简介

本文档提供关于列出对象操作相关的 API 概览以及 SDK 示例代码。

查询对象列表

功能说明

查询指定存储桶中所有的对象（List Objects）。

方法原型

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

请求示例

示例一：查询指定前缀、指定开始对象的对象列表

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的region可以在控制台查看，https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', //协议头部，默认为http
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->listObjects(array(
      'Bucket' => 'examplebucket-125000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.intl.cloud.tencent.com/cos5/bucket
      'Delimiter' => '/', //Delimiter表示分隔符, 设置为/表示列出当前目录下的object, 设置为空表示列出所有的object
      'EncodingType' => 'url',//编码格式，对应请求中的 encoding-type 参数
      'Marker' => 'prefix/picture.jpg',//起始对象键标记
      'Prefix' => 'prfix/', //Prefix表示列出的object的key以prefix开始
      'MaxKeys' => 1000, // 设置最大遍历出多少个对象, 一次listObjects最大支持1000
  ));
  // 请求成功
  print_r($result);
} catch (\Exception $e) {
  // 请求失败
  echo($e);
}

参数说明

返回结果示例

Guzzle\Service\Resource\Model Object
(
  [structure:protected] => 
  [data:protected] => Array
      (
          [Name] => examplebucket-1250000000
          [Prefix] => doc
          [Marker] => doc/picture.jpg
          [MaxKeys] => 10
          [IsTruncated] => 1
          [NextMarker] => doc/exampleobject
          [Contents] => Array
              (
                  [0] => Array
                      (
                          [Key] => doc/exampleobject
                          [LastModified] => 2019-02-14T12:20:40.000Z
                          [ETag] => "e37b429559d82e852af0b2f5b4d078ab72b90208"
                          [Size] => 6532594
                          [Owner] => Array
                              (
                                  [ID] => 100000000001
                                  [DisplayName] => 100000000001
                              )
                           [StorageClass] => STANDARD
                      )
                   [1] => Array
                      (
                          [Key] => doc/exampleobject2
                          [LastModified] => 2019-03-04T06:34:43.000Z
                          [ETag] => "988f9f28e68eba9b8c1f5f98ccce0a3c"
                          [Size] => 28
                          [Owner] => Array
                              (
                                  [ID] => 100000000001
                                  [DisplayName] => 100000000001
                              )
                           [StorageClass] => STANDARD
                      )
              )
          [RequestId] => NWNhMzM0MmZfOWUxYzBiMDlfOTk2YV83ZWE3ODE=
      )
)

返回结果说明

查询对象及其历史版本列表

功能说明

查询存储桶下的部分或者全部对象及其历史版本信息。

方法原型

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

请求示例

示例一：查询历史对象列表

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的region可以在控制台查看，https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', //协议头部，默认为http
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->listObjectVersions(array(
      'Bucket' => 'examplebucket-1250000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.intl.cloud.tencent.com/cos5/bucket
      'Delimiter' => '',
      'EncodingType' => 'url',
      'KeyMarker' => 'doc/picture.jpg',
      'VersionIdMarker' => 'MTg0NDUxODMyMTE2ODY0OTExOTk3W',
      'Prefix' => 'doc',
      'MaxKeys' => 1000,
  )); 
  print_r($result);
} catch (\Exception $e) {
  echo($e);
}

参数说明

返回结果示例

Guzzle\Service\Resource\Model Object
(
  [structure:protected] => 
  [data:protected] => Array
      (
          [Name] => examplebucket-1250000000
          [Prefix] => doc
          [KeyMarker] => string
          [VersionIdMarker] => string
          [MaxKeys] => 10
          [IsTruncated] => 1
          [NextKeyMarker] => string
          [NextVersionIdMarker] => string
          [Versions] => Array
              (
                  [0] => Array
                      (
                          [Key] => doc/exampleobject1
                          [VersionId] => null
                          [IsLatest] => 1
                          [LastModified] => 2019-06-13T09:24:52.000Z
                          [ETag] => "96e79218965eb72c92a549dd5a330112"
                          [Size] => 6
                          [StorageClass] => STANDARD
                          [Owner] => Array
                              (
                                  [UID] => 1250000000
                              )
                      )
                   [1] => Array
                      (
                          [Key] => doc/exampleobject2
                          [VersionId] => MTg0NDUxODMyMTE2ODY0OTExOTk
                          [IsLatest] => 1
                          [LastModified] => 2019-06-18T12:47:03.000Z
                          [ETag] => "698d51a19d8a121ce581499d7b701668"
                          [Size] => 3
                          [StorageClass] => STANDARD
                          [Owner] => Array
                              (
                                  [UID] => 1250000000
                              )
                      )
                  )
          [RequestId] => NWQwOGVkZGRfMjViMjU4NjRfODNjN18xMTE5YWI4
      )
)

返回结果说明