设置对象标签

功能介绍

用户可以通过本接口设置或更新对象（Object）的标签信息。对象标签使用一组键值对（Key-Value）标记对象。

不携带版本号时需要 PutObjectTagging 权限；携带版本号时需要 PutObjectTagging 和 PutObjectVersionTagging 权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。

默认设置Object当前版本的标签信息。可以通过指定versionId参数来设置指定Object版本的标签信息。如果对应版本为删除标记（Delete Marker），则OBS将返回404 Not Found。

• 文件桶不支持该功能
• 每个对象最多能设置10个标签。
• 标签的键名（Key）的最大长度为36个字符，不能包含以下字符：=、*、<、>、\、，、|、/，且首尾字符不能为空格，区分大小写，不可重复，不能为空。
• 标签的键值（Value）的最大长度为43个字符，不能包含以下字符：=、*、<、>、\、，、|、/，且首尾字符不能为空格，区分大小写，可以为空。

示例代码

以下代码展示了如何设置对象标签：

<?php

// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
use Obs\ObsException;
// 创建ObsClient实例
$obsClient = new ObsClient([ 
    //推荐通过环境变量获取访问密钥AK/SK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
    'key' => getenv('ACCESS_KEY_ID'),
    'secret' => getenv('SECRET_ACCESS_KEY'),
    'endpoint' => 'https://your-endpoint',
]);

try {
    $resp = $obsClient->setObjectTagging([
        'Bucket' => 'bucketname',
        'Key' => 'objectname',
        'Tags' => [
            ['Key' => 'tag1', 'Value' => 'value1'],
            ['Key' => 'tag2', 'Value' => 'value2']
        ],
        'VersionId' => 'versionid'
    ]);
    printf( "RequestId:%s\n", $resp['RequestId']);
} catch (ObsException $e) {
    // 操作失败，获取详细异常信息
    printf("SetObjectTaggingFailed: Status:%d, Code:%s, Message:%s\n", $e->getStatusCode(), $e->getExceptionCode(), $e->getExceptionMessage());
} finally {
    $obsClient->close();
}