全部产品
Search
文档中心

Object Storage Service:Konfigurasikan tag untuk objek menggunakan OSS SDK untuk Python 2.0

更新时间:Aug 05, 2025

Object Storage Service (OSS) memungkinkan Anda mengonfigurasi tag untuk klasifikasi objek. Topik ini menjelaskan cara mengonfigurasi tag untuk objek menggunakan OSS SDK untuk Python 2.0.

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 di bucket. Jika Anda ingin mengakses sumber daya di bucket dari layanan Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang wilayah dan titik akhir yang didukung, lihat Wilayah dan Titik Akhir.

  • Izin oss:PutObjectTagging diperlukan untuk mengonfigurasi tag. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.

Sintaksis

put_object_tagging(request: PutObjectTaggingRequest, **kwargs) → PutObjectTaggingResult

Parameter permintaan

Parameter

Tipe

Deskripsi

request

PutObjectTaggingRequest

Permintaan untuk operasi PutObjectTagging. Untuk parameter dalam permintaan, lihat PutObjectTaggingRequest.

Parameter respons

Tipe

Deskripsi

PutObjectTaggingResult

Nilai balik. Untuk detailnya, lihat PutObjectTaggingResult.

Lihat put_object_tagging untuk definisi lengkap tentang cara mengonfigurasi tag.

Contoh

Berikut adalah contoh kode untuk mengonfigurasi tag pada objek tertentu dalam bucket:

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser parameter baris perintah dan tentukan parameter.
parser = argparse.ArgumentParser(description="put object tagging sample")
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('--tag_key', help='Nama kunci tag.', required=True)
parser.add_argument('--tag_value', help='Nama nilai tag.', required=True)

def main():
    # Parsing parameter baris perintah.
    args = parser.parse_args()

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

    # Gunakan konfigurasi default dari SDK.
    cfg = oss.config.load_default()
    # Tentukan penyedia kredensial.
    cfg.credentials_provider = credentials_provider
    # Tentukan wilayah.
    cfg.region = args.region
    # Tentukan titik akhir jika ada yang disediakan.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

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

    # Tentukan tag.
    # Tambahkan objek oss.Tag lebih banyak dalam format berikut jika Anda perlu mengonfigurasi beberapa tag.
    # tags = [oss.Tag(key=args.tag_key, value=args.tag_value), oss.Tag(key=args.tag_key2, value=args.tag_value2)]

    tags = [oss.Tag(
        key=args.tag_key,
        value=args.tag_value,
    )]

    # Konfigurasikan tag untuk objek.
    result = client.put_object_tagging(oss.PutObjectTaggingRequest(
        bucket=args.bucket,
        key=args.key,
        tagging=oss.Tagging(
            tag_set=oss.TagSet(
                tags=tags,
            ),
        ),
    ))

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

if __name__ == "__main__":
    main()

Referensi