全部产品
Search

搜索本产品

    Object Storage Service：Setel tag objek (Python SDK V1)

    文档中心

    Object Storage Service：Setel tag objek (Python SDK V1)

    更新时间：Nov 27, 2025

    OSS mendukung penandaan objek untuk mengklasifikasikan objek dalam bucket. Anda dapat menetapkan aturan siklus hidup dan izin akses untuk objek yang memiliki tag yang sama.

    Catatan penggunaan

    • Sebelum mengonfigurasi tag objek, pastikan Anda memahami fitur tersebut. Untuk informasi selengkapnya, lihat Object tagging.

    • Pada topik ini, titik akhir publik wilayah China (Hangzhou) digunakan. Jika Anda ingin mengakses OSS dari layanan Alibaba Cloud lainnya di wilayah yang sama dengan OSS, gunakan titik akhir internal. Untuk informasi selengkapnya tentang 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 menggunakan nama domain kustom atau Security Token Service (STS), lihat Initialization.

    • Untuk menyetel tag objek, Anda harus memiliki izin oss:PutObjectTagging. Untuk informasi selengkapnya, lihat Grant custom access policies to RAM users.

    Tambahkan tag saat mengunggah objek

    • Tambahkan tag selama unggah simple

      Kode berikut menunjukkan cara menambahkan tag ke objek selama unggah simple.

      # -*- coding: utf-8 -*-

import oss2
from oss2.headers import OSS_OBJECT_TAGGING
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel informasi tag di Header HTTP.
headers = dict()
headers[OSS_OBJECT_TAGGING] = tagging

# Tentukan header saat memanggil operasi put_object untuk menambahkan tag ke objek yang diunggah.
result = bucket.put_object(object_name, 'content', headers=headers)
print('http response status: ', result.status)

# Lihat tag objek.
result = bucket.get_object_tagging(object_name)
for key in result.tag_set.tagging_rule:
    print('tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

    • Tambahkan tag selama unggah multi-bagian

      Kode berikut menunjukkan cara menambahkan tag ke objek selama unggah multi-bagian.

      # -*- coding: utf-8 -*-

import os
import oss2
from oss2 import SizedFileAdapter, determine_part_size
from oss2.models import PartInfo
from oss2.headers import OSS_OBJECT_TAGGING
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'
# Masukkan path lengkap file lokal. Misalnya, masukkan D:\\localpath\\examplefile.txt.
# Jika Anda hanya menentukan nama file, seperti examplefile.txt, tanpa path, file akan diunggah dari path lokal proyek tempat program contoh berada.
filename = 'D:\\localpath\\examplefile.txt'

total_size = os.path.getsize(filename)
# Metode determine_part_size menentukan ukuran bagian.
part_size = determine_part_size(total_size, preferred_size=100 * 1024)

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel informasi tag di Header HTTP.
headers = dict()
headers[OSS_OBJECT_TAGGING] = tagging

# Inisialisasi unggah multi-bagian.
# Tentukan header saat memanggil operasi init_multipart_upload untuk menambahkan tag ke objek yang diunggah.
upload_id = bucket.init_multipart_upload(object_name, headers=headers).upload_id
parts = []

# Unggah bagian satu per satu.
with open(filename, 'rb') as fileobj:
    part_number = 1
    offset = 0
    while offset < total_size:
        num_to_upload = min(part_size, total_size - offset)
        # Metode SizedFileAdapter(fileobj, size) menghasilkan objek file baru dan menghitung ulang posisi awal untuk operasi append.
        result = bucket.upload_part(object_name, upload_id, part_number,
                                    SizedFileAdapter(fileobj, num_to_upload))
        parts.append(PartInfo(part_number, result.etag))

        offset += num_to_upload
        part_number += 1

# Selesaikan unggah multi-bagian.
result = bucket.complete_multipart_upload(object_name, upload_id, parts)
print('http response status: ', result.status)

# Lihat tag objek.
result = bucket.get_object_tagging(object_name)
for key in result.tag_set.tagging_rule:
    print('tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

# Verifikasi unggah multi-bagian.
with open(filename, 'rb') as fileobj:
    assert bucket.get_object(object_name).read() == fileobj.read()

    • Tambahkan tag selama unggah append

      Kode berikut menunjukkan cara menambahkan tag ke objek selama unggah append.

      # -*- coding: utf-8 -*-

import oss2
from oss2.headers import OSS_OBJECT_TAGGING
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel informasi tag di Header HTTP.
headers = dict()
headers[OSS_OBJECT_TAGGING] = tagging

# Lakukan append objek. Tentukan header saat memanggil operasi append_object untuk menambahkan tag ke objek.
# Hanya tag yang ditetapkan pada pemanggilan pertama append_object yang berlaku. Tag yang ditambahkan pada operasi append berikutnya akan diabaikan.
result = bucket.append_object(object_name, 0, '<yourContent>', headers=headers)

# Lihat tag objek.
result = bucket.get_object_tagging(object_name)
for key in result.tag_set.tagging_rule:
    print('tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

    • Tambahkan tag selama unggah yang dapat dilanjutkan

      Kode berikut menunjukkan cara menambahkan tag ke objek selama unggah yang dapat dilanjutkan.

      # -*- coding: utf-8 -*-

import oss2
from oss2.headers import OSS_OBJECT_TAGGING
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'
# Masukkan path lengkap file lokal. Jika Anda tidak menentukan path lokal, file akan diunggah dari path lokal proyek tempat program contoh berada.
local_file = 'D:\\localpath\\examplefile.txt'

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel informasi tag di Header HTTP.
headers = dict()
headers[OSS_OBJECT_TAGGING] = tagging

# Unggah multi-bagian digunakan ketika ukuran file lebih besar dari atau sama dengan nilai parameter opsional multipart_threshold. Nilai default adalah 10 MB. Jika Anda tidak menggunakan parameter store untuk menentukan direktori, direktori .py-oss-upload akan dibuat di direktori HOME untuk menyimpan informasi checkpoint.
# Tentukan header saat memanggil operasi resumable_upload untuk menambahkan tag ke objek yang diunggah.
oss2.resumable_upload(bucket, object_name, local_file, headers=headers)

result = bucket.get_object_tagging(object_name)
for key in result.tag_set.tagging_rule:
    print('object tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

    Tambahkan atau ubah tag untuk objek yang sudah ada

    Jika Anda tidak menambahkan tag saat mengunggah objek atau tag yang ada tidak memenuhi kebutuhan Anda, Anda dapat menambahkan atau mengubah tag setelah objek diunggah.

    Kode berikut menunjukkan cara menambahkan atau mengubah tag untuk objek yang sudah ada.

    # -*- coding: utf-8 -*-

import oss2
from oss2.models import Tagging, TaggingRule
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'

# Buat aturan penandaan.
rule = TaggingRule()
rule.add('key1', 'value1')
rule.add('key2', 'value2')

# Buat tag.
tagging = Tagging(rule)

# Setel tag.
result = bucket.put_object_tagging(object_name, tagging)
# Lihat kode status HTTP.
print('http response status:', result.status)

    Tambahkan atau ubah tag untuk versi objek tertentu

    Dalam bucket yang telah mengaktifkan Pengendalian versi, Anda dapat menambahkan atau mengubah tag untuk versi objek tertentu dengan menentukan ID versinya.

    Kode berikut menunjukkan cara menambahkan atau mengubah tag untuk versi objek tertentu.

    Catatan

    Untuk informasi selengkapnya tentang cara mendapatkan ID versi, lihat List objects (Python SDK V1).

    # -*- coding: utf-8 -*-

import oss2
from oss2.models import Tagging
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'
# Masukkan ID versi objek. Misalnya, CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm****.
version_id = 'CAEQMxiBgICAof2D0BYiIDJhMGE3N2M1YTI1NDQzOGY5NTkyNTI3MGYyMzJm****'

tagging = Tagging()
# Tentukan kunci dan nilai untuk setiap tag objek. Misalnya, tetapkan kunci sebagai owner dan nilai sebagai John.
tagging.tag_set.add('owner', 'John')
tagging.tag_set.add('type', 'document')

params = dict()
params['versionId'] = version_id

bucket.put_object_tagging(object_name, tagging, params=params)

    Setel tag objek saat menyalin objek

    Saat menyalin objek, Anda dapat menentukan cara menyetel tag untuk objek tujuan. Nilai yang valid adalah:

    • Copy (default): Menyalin tag dari objek sumber ke objek tujuan.

    • Replace: Mengabaikan tag objek sumber dan menerapkan tag yang ditentukan dalam permintaan ke objek tujuan.

    Contoh berikut menunjukkan cara menyetel tag objek saat menyalin objek. Salinan simple digunakan untuk objek yang berukuran kurang dari 1 GB, sedangkan salinan multi-bagian digunakan untuk objek yang berukuran lebih dari 1 GB.

    • Setel tag selama salinan simple

      Kode berikut menunjukkan cara menyetel tag objek saat menyalin objek yang berukuran kurang dari 1 GB.

      # -*- coding: utf-8 -*-

import oss2
from oss2.headers import OSS_OBJECT_TAGGING, OSS_OBJECT_TAGGING_COPY_DIRECTIVE
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek sumber. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan srcexampledir/exampleobject.txt.
src_object_name = 'srcexampledir/exampleobject.txt'
# Masukkan path lengkap objek tujuan. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan destexampledir1/exampleobject.txt.
dest_object_name1 = 'destexampledir1/exampleobject.txt'
# Masukkan path lengkap objek tujuan. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan destexampledir2/exampleobject.txt.
dest_object_name2 = 'destexampledir2/exampleobject.txt'

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel parameter OSS_OBJECT_TAGGING_COPY_DIRECTIVE di Header HTTP ke COPY, atau biarkan tidak ditentukan. Objek tujuan dest_object_name1 kemudian akan memiliki tag yang sama dengan objek sumber.
headers=dict()
headers[OSS_OBJECT_TAGGING_COPY_DIRECTIVE] = 'COPY'
bucket.copy_object(bucket.bucket_name, src_object_name, dest_object_name1, headers=headers)

# Setel parameter OSS_OBJECT_TAGGING_COPY_DIRECTIVE di Header HTTP ke REPLACE. Tag untuk objek tujuan dest_object_name2 kemudian disetel ke tag yang ditentukan oleh headers[OSS_OBJECT_TAGGING].
headers[OSS_OBJECT_TAGGING_COPY_DIRECTIVE] = 'REPLACE'
headers[OSS_OBJECT_TAGGING] = tagging
bucket.copy_object(bucket.bucket_name, src_object_name, dest_object_name2, headers=headers)

# Lihat tag src_object_name.
result = bucket.get_object_tagging(src_object_name)
for key in result.tag_set.tagging_rule:
    print('src tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

# Lihat tag dest_object_name1. Tag dest_object_name1 sama dengan tag src_object_name.
result = bucket.get_object_tagging(dest_object_name1)
for key in result.tag_set.tagging_rule:
    print('dest1 object tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

# Lihat tag dest_object_name2. Tag dest_object_name2 adalah tag yang ditentukan oleh headers[OSS_OBJECT_TAGGING].
result = bucket.get_object_tagging(dest_object_name2)
for key in result.tag_set.tagging_rule:
    print('dest2 object tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

    • Setel tag selama salinan multi-bagian

      Kode berikut menunjukkan cara menyetel tag objek saat menyalin objek yang berukuran lebih dari 1 GB.

      # -*- coding: utf-8 -*-

import os
import oss2
from oss2 import determine_part_size
from oss2.models import PartInfo
from oss2.headers import OSS_OBJECT_TAGGING
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek sumber. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan srcexampledir/exampleobject.txt.
src_object_name = 'srcexampledir/exampleobject.txt'
# Masukkan path lengkap objek tujuan. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan destexampledir/exampleobject.txt.
dest_object_name = 'destexampledir/exampleobject.txt'

# Dapatkan ukuran objek sumber.
head_info = bucket.head_object(src_object_name)
total_size = head_info.content_length
print('src object size:', total_size)

# Metode determine_part_size menentukan ukuran bagian.
part_size = determine_part_size(total_size, preferred_size=100 * 1024)
print('part_size:', part_size)

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel informasi tag di Header HTTP.
headers = dict()
headers[OSS_OBJECT_TAGGING] = tagging

# Inisialisasi unggah multi-bagian.
# Tentukan header saat memanggil operasi init_multipart_upload untuk menambahkan tag ke objek tujuan.
upload_id = bucket.init_multipart_upload(dest_object_name, headers=headers).upload_id
parts = []

# Unggah bagian satu per satu.
part_number = 1
offset = 0
while offset < total_size:
    num_to_upload = min(part_size, total_size - offset)
    end = offset + num_to_upload - 1;
    result = bucket.upload_part_copy(bucket.bucket_name, src_object_name, (offset, end), dest_object_name, upload_id, part_number)
    #Simpan informasi bagian.
    parts.append(PartInfo(part_number, result.etag))

    offset += num_to_upload
    part_number += 1

# Selesaikan unggah multi-bagian.
result = bucket.complete_multipart_upload(dest_object_name, upload_id, parts)

# Dapatkan metadata objek.
head_info = bucket.head_object(dest_object_name)

# Lihat ukuran objek tujuan.
dest_object_size = head_info.content_length
print('dest object size:', dest_object_size)

# Bandingkan ukuran dengan objek sumber.
assert dest_object_size == total_size

# Lihat tag objek sumber.
result = bucket.get_object_tagging(src_object_name)
for key in result.tag_set.tagging_rule:
    print('src tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

# Lihat tag objek tujuan.
result = bucket.get_object_tagging(dest_object_name)
for key in result.tag_set.tagging_rule:
    print('dest tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

    Setel tag untuk tautan simbolik

    Kode berikut menunjukkan cara menyetel tag untuk tautan simbolik.

    # -*- coding: utf-8 -*-

import oss2
from oss2.headers import OSS_OBJECT_TAGGING
from oss2.credentials import EnvironmentVariableCredentialsProvider

# Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# Setel yourEndpoint ke titik akhir wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel titik akhir ke https://oss-cn-hangzhou.aliyuncs.com.
# Masukkan nama bucket.
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# Masukkan path lengkap objek tujuan. Path lengkap tidak boleh menyertakan nama bucket. Misalnya, masukkan exampledir/exampleobject.txt.
object_name = 'exampledir/exampleobject.txt'
# Masukkan path lengkap tautan simbolik. Misalnya, masukkan shortcut/myobject.txt.
symlink_name = 'shortcut/myobject.txt'

# Setel string penandaan.
tagging = "k1=v1&k2=v2&k3=v3"

# Jika tag berisi karakter khusus, lakukan URL-encode pada kunci dan nilai tag tersebut.
k4 = "k4+-="
v4 = "+-=._:/"
tagging += "&" + oss2.urlquote(k4) + "=" + oss2.urlquote(v4)

# Setel informasi tag di Header HTTP.
headers = dict()
headers[OSS_OBJECT_TAGGING] = tagging

# Buat tautan simbolik.
# Tentukan header saat memanggil operasi put_symlink untuk menambahkan tag ke tautan simbolik.
result = bucket.put_symlink(object_name, symlink_name, headers=headers)
print('http response status: ', result.status)

# Lihat tag tautan simbolik.
result = bucket.get_object_tagging(symlink_name)
for key in result.tag_set.tagging_rule:
    print('tagging key: {}, value: {}'.format(key, result.tag_set.tagging_rule[key]))

    Referensi

    • Untuk kode contoh lengkap tentang penyetelan tag objek, lihat contoh GitHub.

    • Untuk informasi selengkapnya tentang operasi API untuk menyetel tag objek, lihat PutObjectTagging.