Tous les produits
Search
Centre de documentation

Object Storage Service:Interroger les informations d'un bucket à l'aide du SDK OSS pour PHP 2.0

Dernière mise à jour :Aug 18, 2026

Cette rubrique explique comment utiliser le SDK Object Storage Service (OSS) pour PHP afin d'interroger les informations relatives à un bucket, telles que l'état du suivi d'accès, la région, la date de création, la liste de contrôle d'accès (ACL), le nom et l'ID du propriétaire, la classe de stockage, le type de redondance, le point de terminaison public, le point de terminaison interne, l'état de la réplication inter-régions (CRR), l'état du versioning et la méthode de chiffrement. Ces informations vous permettent d'effectuer les opérations ultérieures.

Notes d'utilisation

  • L'exemple de code de cette rubrique utilise l'ID de région cn-hangzhou de la région Chine (Hangzhou). Par défaut, un point de terminaison public permet d'accéder aux ressources d'un bucket. Pour accéder aux ressources du bucket via d'autres services Alibaba Cloud situés dans la même région, utilisez un point de terminaison interne. Pour plus d'informations sur les régions et les points de terminaison OSS, consultez Régions et points de terminaison.

  • Pour interroger les informations d'un bucket, vous devez disposer de l'autorisation oss:GetBucketInfo. Pour plus d'informations, consultez Accorder une stratégie personnalisée.

Exemples

L'exemple de code suivant montre comment interroger les informations d'un bucket :

<?php

require_once __DIR__ . '/../vendor/autoload.php'; // Automatically load objects and dependency libraries.

use AlibabaCloud\Oss\V2 as Oss;

// Specify command line parameters.
$optsdesc = [
    "region" => ['help' => The region in which the bucket is located.', 'required' => True], // (Required) Specify the region in which the bucket is located. Example: oss-cn-hangzhou. 
    "endpoint" => ['help' => The domain names that other services can use to access OSS.', 'required' => False], // (Optional) Specify the endpoint that can be used by other services to access OSS. 
    "bucket" => ['help' => The name of the bucket, 'required' => True], // (Required) Specify the name of the bucket. 
];
$longopts = \array_map(function ($key) {
    return "$key:"; // Add a colon (:) to the end of each parameter to indicate that a value is required.
}, array_keys($optsdesc));

// Parse the command line parameters.
$options = getopt("", $longopts); 

// Check whether the required parameters are configured.
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help'];
        echo "Error: the following arguments are required: --$key, $help"; // Specifies that the required parameters are not configured.
        exit(1); 
    }
}

// Obtain the values of the command line parameters.
$region = $options["region"]; // The region in which the bucket is located. 
$bucket = $options["bucket"]; // The name of the bucket. 

// Use environment variables to load the credential information (AccessKey ID and AccessKey secret).
$credentialsProvider=new Oss\Credentials\EnvironmentVariableCredentialsProvider(); // Obtain the credential information from the environment variables. 

// Use the default configurations of the SDK.
$cfg=Oss\Config::loadDefault(); // Load the default configurations of the SDK. 
$cfg->setCredentialsProvider($credentialsProvider); // Specify the credential provider. 
$cfg->setRegion($region); // Specify the region. 
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // Specify the endpoint if an endpoint is provided. 
}

// Create an OSSClient instance.
$client = new Oss\Client($cfg); // Create an OSSClient instance. 

// Create a request to query information about the bucket.
$request = new Oss\Models\GetBucketInfoRequest($bucket); // Create a request to query information about the bucket. 

// Use the getBucketInfo method to query information about the bucket.
$result = $client->getBucketInfo($request); // Use the getBucketInfo method to query information about the bucket. 

// Display the returned result.
printf(
    'status code:' . $result-> statusCode. PHP_EOL . // The HTTP response status code. 
    'request id:' . $result-> requestId. PHP_EOL . // The unique identifier of the request. 
    'bucket info:' . var_export($result->bucketInfo, true) // The detailed information about the bucket. 
);

Références

  • Pour plus d'informations sur les buckets, consultez Présentation des buckets.

  • Pour obtenir l'exemple de code complet utilisé pour interroger les informations d'un bucket, visitez GitHub.

  • Pour plus d'informations sur l'opération API permettant d'interroger les informations d'un bucket, consultez GetBucketInfo.