Updated on 2026-08-03 GMT+08:00

Deleting an Object Tag

If you have any questions during development, post them on the Issues page of GitHub. For details about parameters and usage of each API, see API Reference.

Function

This API is used to delete the tags of an object.

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

By default, tags of the current object version are deleted. You can specify the versionId parameter to delete the tags of a specific object version. If you try to delete the tags of 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 delete the tags of 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 -> deleteObjectTagging([
      'Bucket' => 'bucketname',
      'Key' => 'objectname',
      'Tags' => [
           ['Key' => 'tag1', 'Value' => 'value1'],
           ['Key' => 'tag2', 'Value' => 'value2']
       ]
]);

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