OSS支持使用对象标签(Object Tagging)对存储的Object进行分类,您可以针对同标签的Object设置生命周期规则、访问权限等。
注意事项
对象标签使用一组键值对(Key-Value)标记对象。使用对象标签时,有如下注意事项:
- 只有Bucket拥有者和授权的RAM用户拥有读写对象标签的权限,该权限不受对象ACL控制。
- 您可以在上传Object时添加对象标签,也可以对已上传Object添加或更改对象标签。
有关设置对象标签的详情,请参见PutObjectTagging。
- 单个Object最多可设置10个标签,Key不可重复。
- 每个Key长度不超过128字节,每个Value长度不超过256字节。
- Key和Value区分大小写。
- 标签合法字符集包括大小写字母、数字、空格和以下符号:
+‑=._:/
- 更改标签时不会更新Object的Last‑Modified时间。
有关对象标签的详情,请参见对象标签。
上传Object时添加对象标签
以下分别介绍如何在简单上传、分片上传以及追加上传场景中添加对象标签的示例。
- 简单上传时添加对象标签
以下代码用于简单上传时添加对象标签:
<?php if (is_file(__DIR__ . '/../autoload.php')) { require_once __DIR__ . '/../autoload.php'; } if (is_file(__DIR__ . '/../vendor/autoload.php')) { require_once __DIR__ . '/../vendor/autoload.php'; } use OSS\OssClient; use OSS\Core\OssException; // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。 $accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "https://oss-cn-hangzhou.aliyuncs.com"; $bucket= "<yourBucketName>"; // yourObjectName表示即将上传的Object所在存储空间的完整名称,即包含文件后缀在内的完整路径,如填写为example/test.jpg。 $object= "<yourObjectName>"; $content= "hello world"; $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false); // 设置对象标签。 $options = array( OssClient::OSS_HEADERS => array( 'x-oss-tagging' => 'key1=value1&key2=value2&key3=value3', )); try { // 通过简单上传的方式上传Object。 $ossClient->putObject($bucket, $object, $content, $options); } catch (OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");
- 分片上传时添加对象标签
以下代码用于分片上传时添加对象标签:
<?php if (is_file(__DIR__ . '/../autoload.php')) { require_once __DIR__ . '/../autoload.php'; } if (is_file(__DIR__ . '/../vendor/autoload.php')) { require_once __DIR__ . '/../vendor/autoload.php'; } use OSS\OssClient; use OSS\Core\OssException; // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。 $accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "https://oss-cn-hangzhou.aliyuncs.com"; $bucket= "<yourBucketName>"; $object= "<yourObjectName>"; $file = "<yourFilePath>"; $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false); // 设置对象标签。 $options = array( OssClient::OSS_CHECK_MD5 => true, OssClient::OSS_PART_SIZE => 1, OssClient::OSS_HEADERS => array( 'x-oss-tagging' => 'key1=value1&key2=value2&key3=value3', ), ); try { // 通过分片上传的方式上传Object。 $ossClient->multiuploadFile($bucket, $object, $file, $options); } catch (OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");
- 追加上传时添加对象标签
以下代码用于追加上传时添加对象标签:
<?php if (is_file(__DIR__ . '/../autoload.php')) { require_once __DIR__ . '/../autoload.php'; } if (is_file(__DIR__ . '/../vendor/autoload.php')) { require_once __DIR__ . '/../vendor/autoload.php'; } use OSS\OssClient; use OSS\Core\OssException; // 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。 $accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "https://oss-cn-hangzhou.aliyuncs.com"; $bucket= "<yourBucketName>"; $object= "<yourObjectName>"; $content_array = array('Hello OSS', 'Hi OSS'); $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false); // 设置对象标签。 $options = array( OssClient::OSS_HEADERS => array( 'x-oss-tagging' => 'key1=value1&key2=value2', )); try { // 通过追加上传的方式上传Object。 $position = $ossClient->appendObject($bucket, $object, $content_array[0], 0, $options); $position = $ossClient->appendObject($bucket, $object, $content_array[1], $position); } catch (OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");
对已上传Object添加或更改对象标签
以下代码用于对已上传Object添加或更改对象标签:
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\OssClient;
use OSS\Core\OssException;
use OSS\Model\TaggingConfig;
use OSS\Model\Tag;
// 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM账号进行API访问或日常运维,请登录RAM控制台创建RAM账号。
$accessKeyId = "<yourAccessKeyId>";
$accessKeySecret = "<yourAccessKeySecret>";
// Endpoint以杭州为例,其它Region请按实际情况填写。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
$bucket= "<yourBucketName>";
// yourObjectName表示已上传Object所在存储空间的完整名称,即包含文件后缀在内的完整路径,如填写为example/test.jpg。
$object= "<yourObjectName>";
$ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint, false);
// 设置对象标签。
$config = new TaggingConfig();
$config->addTag(new Tag("key1", "value1"));
$config->addTag(new Tag("key2", "value2"));
try {
$ossClient->putObjectTagging($bucket, $object, $config);
} catch (OssException $e) {
printf(__FUNCTION__ . ": FAILED\n");
printf($e->getMessage() . "\n");
return;
}
print(__FUNCTION__ . ": OK" . "\n");
在文档使用中是否遇到以下问题
更多建议
匿名提交