Obtaining Object Tags

Function

This API is used to obtain the tags for an object.

If there is no object version ID (indicated by versionId) contained in the request, you must have the GetObjectTagging permission. If there is an object version ID (indicated by versionId) contained in the request, you must have both the GetObjectTagging and GetObjectVersionTagging permissions. By default, only an object owner can perform this operation. The object owner can use bucket or user policies to grant others permissions to perform this operation.

By default, tags are obtained for the current object version. You can specify the versionId parameter to obtain tags for a specific object version. If you request tags for a delete marker, 404 Not Found is returned.

This API is not available for parallel file systems.

Code Examples

The following example shows how to obtain the tags for an object.

// Import a dependency library.
require 'vendor/autoload.php';
// Use the source code to import the SDK code library.
// require 'obs-autoloader.php';
// Declare the namespace.
use Obs\ObsClient;
// Create an ObsClient instance.
$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. For details, see https://support.huaweicloud.com/intl/en-us/usermanual-ca/ca_01_0003.html.
      'key' => getenv('ACCESS_KEY_ID'),
      'secret' => getenv('SECRET_ACCESS_KEY'),
      'endpoint' => 'https://your-endpoint',
] );

$resp = $obsClient -> getObjectTagging([
      'Bucket' => 'bucketname',
      'Key' => 'objectname',
]);

printf("RequestId:%s\n", $resp ['RequestId'] );
printf("Tags:%s\n", $resp["Tags"]);