全部产品
Search
文档中心

Object Storage Service:Kelola tautan simbolik (C# SDK V2)

更新时间:Nov 09, 2025

Fitur tautan simbolik memungkinkan Anda mengakses objek yang sering digunakan dalam sebuah bucket dengan lebih mudah. Setelah membuat tautan simbolik, Anda dapat menggunakannya untuk mengakses objek seperti menggunakan pintasan di Windows. Topik ini menjelaskan cara menggunakan OSS C# SDK untuk membuat dan mendapatkan tautan simbolik.

Catatan

  • Kode contoh dalam topik ini menggunakan Wilayah China (Hangzhou) sebagai contoh, dengan ID wilayah cn-hangzhou. Secara default, titik akhir publik digunakan. Jika Anda mengakses OSS dari produk Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang pemetaan antara wilayah OSS dan titik akhir, lihat Wilayah dan titik akhir OSS.

  • Untuk membuat tautan simbolik, Anda harus memiliki izin oss:PutObject. Untuk mendapatkan tautan simbolik, Anda harus memiliki izin oss:GetObject. Untuk informasi lebih lanjut, lihat Berikan kebijakan akses kustom kepada Pengguna RAM.

Kode contoh

Buat tautan simbolik

Gunakan kode berikut untuk membuat tautan simbolik:

using OSS = AlibabaCloud.OSS.V2;  // Buat alias untuk Alibaba Cloud OSS SDK untuk menyederhanakan penggunaan selanjutnya.

var region = "cn-hangzhou";  // Diperlukan. Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
var endpoint = null as string;  // Opsional. Tentukan nama domain yang digunakan untuk mengakses OSS. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur titik akhir menjadi https://oss-cn-hangzhou.aliyuncs.com.
var bucket = "nama bucket Anda";  // Diperlukan. Nama bucket.
var key = "nama objek Anda";  // Diperlukan. Nama objek.
var target = "nama tautan simbolik Anda";  // Diperlukan. Nama tautan simbolik.

// Muat konfigurasi default dari OSS SDK. Konfigurasi secara otomatis membaca informasi kredensial (seperti AccessKey) dari variabel lingkungan.
var cfg = OSS.Configuration.LoadDefault();
// Secara eksplisit atur penggunaan variabel lingkungan untuk mendapatkan kredensial untuk verifikasi identitas (format: OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET).
cfg.CredentialsProvider = new OSS.Credentials.EnvironmentVariableCredentialsProvider();
// Atur wilayah bucket dalam konfigurasi.
cfg.Region = region;   
// Jika titik akhir ditentukan, itu akan menimpa titik akhir default. 
if(endpoint != null) 
{
    cfg.Endpoint = endpoint;
} 

// Buat instans klien OSS menggunakan informasi konfigurasi.
using var client = new OSS.Client(cfg); 

// Panggil metode PutSymlinkAsync untuk membuat tautan simbolik yang menunjuk ke objek di bucket.
var result = await client.PutSymlinkAsync(new()
{
    Bucket = bucket,
    Key = key,
    SymlinkTarget = target,
});

// Cetak hasilnya.
Console.WriteLine("PutSymlink selesai");  // Menunjukkan bahwa operasi telah selesai.
Console.WriteLine($"Kode Status: {result.StatusCode}");  // Kode status HTTP.
Console.WriteLine($"ID Permintaan: {result.RequestId}");  // ID permintaan, yang digunakan untuk pemecahan masalah di Alibaba Cloud.
Console.WriteLine("Header Respons:");  // Header respons.
result.Headers.ToList().ForEach(x => Console.WriteLine(x.Key + " : " + x.Value));  // Telusuri dan cetak semua header respons.

Dapatkan tautan simbolik

Gunakan kode berikut untuk mendapatkan tautan simbolik:

using OSS = AlibabaCloud.OSS.V2;  // Buat alias untuk Alibaba Cloud OSS SDK untuk menyederhanakan penggunaan selanjutnya.

var region = "cn-hangzhou";  // Diperlukan. Tentukan wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur wilayah menjadi cn-hangzhou.
var endpoint = null as string;  // Opsional. Tentukan nama domain yang digunakan untuk mengakses OSS. Misalnya, jika bucket berada di wilayah China (Hangzhou), atur titik akhir menjadi https://oss-cn-hangzhou.aliyuncs.com.
var bucket = "nama bucket Anda";  // Diperlukan. Nama bucket.
var key = "nama objek Anda";  // Diperlukan. Nama objek.

// Muat konfigurasi default dari OSS SDK. Konfigurasi secara otomatis membaca informasi kredensial (seperti AccessKey) dari variabel lingkungan.
var cfg = OSS.Configuration.LoadDefault();
// Secara eksplisit atur penggunaan variabel lingkungan untuk mendapatkan kredensial untuk verifikasi identitas (format: OSS_ACCESS_KEY_ID, OSS_ACCESS_KEY_SECRET).
cfg.CredentialsProvider = new OSS.Credentials.EnvironmentVariableCredentialsProvider();
// Atur wilayah bucket dalam konfigurasi.
cfg.Region = region;   
// Jika titik akhir ditentukan, itu akan menimpa titik akhir default. 
if(endpoint != null) 
{
    cfg.Endpoint = endpoint;
} 

// Buat instans klien OSS menggunakan informasi konfigurasi.
using var client = new OSS.Client(cfg); 

// Panggil metode GetSymlinkAsync untuk mendapatkan informasi tautan simbolik dari objek target.
var result = await client.GetSymlinkAsync(new()
{
    Bucket = bucket,
    Key = key
});

// Cetak hasilnya.
Console.WriteLine("GetSymlink selesai");  // Menunjukkan bahwa operasi telah selesai.
Console.WriteLine($"Kode Status: {result.StatusCode}");  // Kode status HTTP.
Console.WriteLine($"ID Permintaan: {result.RequestId}");  // ID permintaan, yang digunakan untuk pemecahan masalah di Alibaba Cloud.
Console.WriteLine("Header Respons:");  // Header respons.
result.Headers.ToList().ForEach(x => Console.WriteLine(x.Key + " : " + x.Value));  // Telusuri dan cetak semua header respons.
Console.WriteLine($"SymlinkTarget: {result.SymlinkTarget}");  // Keluarkan informasi tautan simbolik dari objek target.

Referensi

  • Untuk kode contoh lengkap tentang cara membuat tautan simbolik, lihat PutSymlink.cs.

  • Untuk kode contoh lengkap tentang cara mendapatkan tautan simbolik, lihat GetSymlink.cs.