Updated on 2026-01-16 GMT+08:00

Listing Buckets

You can call ObsClient->listBuckets to list buckets. Sample code is as follows:

// Import the dependency library.
require 'vendor/autoload.php';
// Import the SDK code library during source code installation.
// require 'obs-autoloader.php';
// Declare the namespace.
use Obs\ObsClient;
// Create an instance of ObsClient.
$obsClient = new ObsClient ( [ 
      //Obtain an AK/SK pair using environment variables or import the AK/SK pair in other ways. Using hard coding may result in leakage.
      //Obtain an AK/SK pair on the management console.      'key' => getenv('ACCESS_KEY_ID'),
      'secret' => getenv('SECRET_ACCESS_KEY'),
      'endpoint' => 'https://your-endpoint'
] );

$resp = $obsClient->listBuckets([
        'QueryLocation' => true
]);

printf("RequestId:%s\n", $resp['RequestId']);
printf("Owner[ID]:%s\n", $resp['Owner']['ID']);
foreach ($resp['Buckets'] as $index => $bucket){
       printf("Buckets[%d]\n", $index + 1);
       printf("Name:%s\n", $bucket['Name']);
       printf("CreationDate:%s\n", $bucket['CreationDate']);
       printf("Location:%s\n", $bucket['Location']);
}
  • Obtained bucket names are listed in the lexicographical order.
  • Set QueryLocation to true and then you can query the bucket location when listing buckets.