设置对象标签

功能介绍

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

如果请求中不携带版本号（versionId），需要确保执行者有PutObjectTagging权限。如果请求中携带版本号（versionId），需要确保执行者有PutObjectTagging+PutObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。

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

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

示例代码

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

// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
// 创建ObsClient实例
$obsClient = new ObsClient ( [ 
      //推荐通过环境变量获取AKSK，这里也可以使用其他外部引入方式传入，如果使用硬编码可能会存在泄露风险。
      //您可以登录访问管理控制台获取访问密钥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',
] );

$resp = $obsClient -> setObjectTagging([
      'Bucket' => 'bucketname',
      'Key' => 'objectname',
      'Tags' => [
           ['Key' => 'tag1', 'Value' => 'value1'],
           ['Key' => 'tag2', 'Value' => 'value2']
       ]
]);

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