Todos los productos
Search
Centro de documentos

Object Storage Service:Eliminación de etiquetas de objetos (OSS SDK for PHP V2)

Última actualización: Sep 24, 2026

Este tema describe cómo usar OSS SDK for PHP 2.0 para eliminar las etiquetas de un objeto.

Notas

  • El código de ejemplo de este tema usa el ID de región cn-hangzhou, correspondiente a la región China (Hangzhou). De forma predeterminada, se usa un endpoint público para acceder a los recursos de un bucket. Si accede a los recursos desde otro servicio de Alibaba Cloud ubicado en la misma región que el bucket, use un endpoint interno. Para obtener más información sobre las regiones y los endpoints compatibles con OSS, consulte Regions and endpoints.

  • Para eliminar las etiquetas de un objeto, necesita el permiso oss:DeleteObjectTagging. Para obtener más información, consulte Attach a custom policy to a RAM user.

Nota
  • Los objetos se identifican mediante un par clave-valor. Para obtener más información, consulte Object tagging.

  • Para conocer más detalles sobre cómo eliminar etiquetas, consulte DeleteObjectTagging.

Código de ejemplo

A continuación se muestra el código de ejemplo para eliminar las etiquetas de un objeto específico dentro de un bucket:

<?php

// Introduce autoload files to load dependent libraries.
require_once __DIR__ . '/../../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

// Specify descriptions for command line arguments.
$optsdesc = [
    "region" => ['help' => The region in which the bucket is located.', 'required' => True], // (Required) Specify the region in which the bucket is located.
    "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 for accessing OSS.
    "bucket" => ['help' => The name of the bucket, 'required' => True], // (Required) Specify the name of the bucket.
    "key" => ['help' => The name of the object, 'required' => True], // (Required) Specify the name of the object.
];

// Convert the descriptions to a list of long options required by getopt.
// Add a colon (:) to the end of each parameter to indicate that a value is required.
$longopts = \array_map(function ($key) {
    return "$key:";
}, array_keys($optsdesc));

// Parse the command line arguments.
$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']; // Obtain help information for the parameters.
        echo "Error: the following arguments are required: --$key, $help" . PHP_EOL;
        exit(1); // Exit the program if the required parameters are not configured.
    }
}

// Obtain values from the parsed parameters.
$region = $options["region"]; // The region in which the bucket is located.
$bucket = $options["bucket"]; // The name of the bucket.
$key = $options["key"]; // The name of the object.

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

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

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

// Create a PutObjectTaggingRequest object to delete the tags configured for the object.
$request = new Oss\Models\DeleteObjectTaggingRequest(
            bucket: $bucket,
            key: $key
);

// Delete the tags of the object.
$result = $client->deleteObjectTagging($request);

// Display the result of deletion.
printf(
    'status code:' . $result->statusCode . PHP_EOL . // The HTTP status code. For example, HTTP status code 204 indicates that the tags are deleted.
    'request id:' . $result-> requestId. PHP_EOL // The request ID, which is used to debug or trace a request.
);