Kelola tautan simbolik menggunakan OSS SDK untuk Python 2.0 - Object Storage Service

Tautan simbolik di Object Storage Service (OSS) berfungsi seperti pintasan file di Windows dan memungkinkan Anda mengakses objek terkait dengan cepat. Topik ini menjelaskan cara menggunakan OSS SDK untuk Python untuk membuat dan mendapatkan tautan simbolik.

Catatan penggunaan

Contoh kode dalam topik ini menggunakan ID Wilayah cn-hangzhou dari Wilayah Hangzhou, Tiongkok. Secara default, titik akhir publik digunakan untuk mengakses sumber daya dalam bucket. Jika Anda ingin mengakses sumber daya dalam bucket dari layanan Alibaba Cloud lainnya di wilayah yang sama dengan bucket tersebut, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang wilayah dan titik akhir yang didukung oleh OSS, lihat Wilayah dan Titik Akhir.
Untuk membuat tautan simbolik, Anda harus memiliki izin oss:PutObject. Untuk menanyakan tautan simbolik, Anda harus memiliki izin oss:GetObject. Untuk informasi lebih lanjut, lihat Berikan Izin Kustom kepada Pengguna RAM.

Metode

Buat tautan simbolik

put_symlink(request: PutSymlinkRequest, **kwargs) → PutSymlinkResult

Dapatkan tautan simbolik

get_symlink(request: GetSymlinkRequest, **kwargs) → GetSymlinkResult

Parameter permintaan

Parameter	Tipe	Deskripsi
request	PutSymlinkRequest	Parameter permintaan untuk membuat tautan simbolik. Untuk informasi lebih lanjut, lihat PutSymlinkRequest
request	GetSymlinkRequest	Parameter permintaan untuk mendapatkan tautan simbolik. Untuk informasi lebih lanjut, lihat GetSymlinkRequest

Parameter respons

Tipe	Deskripsi
PutSymlinkResult	Nilai kembali. Untuk informasi lebih lanjut, lihat PutSymlinkResult
GetSymlinkResult	Nilai kembali. Untuk informasi lebih lanjut, lihat GetSymlinkResult

Untuk definisi lengkap metode pembuatan tautan simbolik, lihat put_symlink.

Untuk definisi lengkap metode mendapatkan tautan simbolik, lihat get_symlink.

Contoh kode

Buat tautan simbolik

Berikut adalah contoh kode untuk membuat tautan simbolik.

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser argumen baris perintah
parser = argparse.ArgumentParser(description="put symlink sample")
# Tambahkan argumen baris perintah
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')
parser.add_argument('--key', help='Nama objek.', required=True)
parser.add_argument('--target', help='Objek tujuan ke mana tautan simbolik menunjuk.', required=True)

def main():
    # Parse argumen baris perintah
    args = parser.parse_args()

    # Muat kredensial dari variabel lingkungan
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Gunakan konfigurasi default dari SDK
    cfg = oss.config.load_default()
    # Set penyedia kredensial
    cfg.credentials_provider = credentials_provider
    # Set wilayah
    cfg.region = args.region
    # Jika titik akhir diberikan, set titik akhir
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Buat klien OSS
    client = oss.Client(cfg)

    # Buat permintaan untuk membuat tautan simbolik
    result = client.put_symlink(oss.PutSymlinkRequest(
        bucket=args.bucket,  # Tentukan nama bucket
        key=args.key,        # Tentukan nama objek
        target=args.target,  # Tentukan objek target
    ))

    # Cetak hasil
    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id},'
          f' ID versi: {result.version_id},'
    )

# Jika skrip dijalankan langsung, panggil fungsi utama
if __name__ == "__main__":
    main()

Dapatkan tautan simbolik

Berikut adalah contoh kode untuk mendapatkan tautan simbolik dan nama objek tujuannya.

import argparse
import alibabacloud_oss_v2 as oss

# Buat objek ArgumentParser untuk parse argumen baris perintah
parser = argparse.ArgumentParser(description="get symlink sample")
# Tambahkan argumen baris perintah
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')
parser.add_argument('--key', help='Nama objek.', required=True)

def main():
    # Parse argumen baris perintah
    args = parser.parse_args()

    # Muat kredensial dari variabel lingkungan
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Gunakan konfigurasi default dari SDK
    cfg = oss.config.load_default()
    # Set penyedia kredensial
    cfg.credentials_provider = credentials_provider
    # Set wilayah
    cfg.region = args.region
    # Jika titik akhir diberikan, set titik akhir
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Buat klien OSS
    client = oss.Client(cfg)

    # Kirim permintaan untuk mendapatkan tautan simbolik
    result = client.get_symlink(oss.GetSymlinkRequest(
        bucket=args.bucket,
        key=args.key,
    ))

    # Cetak hasil
    print(f'kode status: {result.status_code},'
          f' ID permintaan: {result.request_id},'
          f' ID versi: {result.version_id},'
          f' target: {result.target},'
          f' etag: {result.etag},'
    )

# Jika skrip dijalankan langsung, panggil fungsi utama
if __name__ == "__main__":
    main()

Referensi

Untuk contoh kode lengkap untuk membuat tautan simbolik, lihat put_symlink.py.
Untuk contoh kode lengkap untuk mendapatkan tautan simbolik, lihat get_symlink.py.