Help Center/Object Storage Service/PHP SDK Developer Guide (Ally Region)/Bucket Management/Identifying Whether a Bucket Exists
Updated on 2026-01-16 GMT+08:00
Identifying Whether a Bucket Exists
You can call ObsClient->headBucket to identify whether a bucket exists.
This example checks whether bucket bucketname exists.
The example 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' ] ); try{ $resp = $obsClient->headBucket([ 'Bucket' => 'bucketname' ]); printf("Bucket exists"); }catch (\Obs\Common\ObsException $obsException){ if($obsException->getStatusCode() === 404){ printf("Bucket does not exist"); }else{ printf("ExceptionCode:%s\n", $obsException->getExceptionCode()); printf("getExceptionMessage:%s\n", $obsException->getExceptionMessage()); } }

- If an exception is thrown and the returned HTTP status code is 404, the bucket does not exist.
Parent topic:Bucket Management
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
The system is busy. Please try again later.
For any further questions, feel free to contact us through the chatbot.
Chatbot
