Tag objek menggunakan pasangan kunci-nilai untuk mengidentifikasi objek. Topik ini menjelaskan cara menanyakan tag suatu objek.
Catatan penggunaan
Pada topik ini, digunakan titik akhir publik wilayah China (Hangzhou). Jika Anda mengakses OSS dari layanan Alibaba Cloud lain yang berada di wilayah yang sama dengan OSS, gunakan titik akhir internal. Untuk informasi selengkapnya mengenai wilayah dan titik akhir OSS, lihat Regions and endpoints.
Pada topik ini, instans OSSClient dibuat menggunakan titik akhir OSS. Jika Anda ingin membuat instans OSSClient dengan nama domain kustom atau Security Token Service (STS), lihat Initialization (C# SDK V1).
Untuk mengambil tag objek, Anda harus memiliki izin
oss:GetObjectTagging. Untuk informasi selengkapnya, lihat Grant custom permissions to a RAM user.
Kode contoh
Kode berikut menunjukkan contoh cara menanyakan tag suatu objek:
using Aliyun.OSS;
using Aliyun.OSS.Common;
// Tentukan titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
var endpoint = "yourEndpoint";
// Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah dikonfigurasi.
var accessKeyId = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_ID");
var accessKeySecret = Environment.GetEnvironmentVariable("OSS_ACCESS_KEY_SECRET");
// Tentukan nama bucket. Contoh: examplebucket.
var bucketName = "examplebucket";
// Tentukan path lengkap objek. Jangan sertakan nama bucket dalam path lengkap tersebut. Contoh: exampledir/exampleobject.txt.
var objectName = "exampledir/exampleobject.txt";
// Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah ke cn-hangzhou.
const string region = "cn-hangzhou";
// Buat instans ClientConfiguration dan ubah parameter default sesuai kebutuhan Anda.
var conf = new ClientConfiguration();
// Gunakan algoritma signature V4.
conf.SignatureVersion = SignatureVersion.V4;
// Buat instans OssClient.
var client = new OssClient(endpoint, accessKeyId, accessKeySecret, conf);
client.SetRegion(region);
try
{
// Tanyakan tag objek.
var result = client.GetObjectTagging(bucketName,objectName);
Console.WriteLine("get objects tagging succeeded");
foreach (var tag in result.Tags)
{
Console.WriteLine("key:{0}, value:{1}", tag.Key, tag.Value);
}
}
catch (Exception ex)
{
Console.WriteLine("get objects tagging failed. {0}", ex.Message);
}Referensi
Untuk informasi selengkapnya mengenai operasi API yang dapat Anda panggil untuk menanyakan tag objek, lihat GetObjectTagging.