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-hangzhoudari 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:PutObjectTaggingdiperlukan untuk mengonfigurasi tag. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.
Sintaksis
put_object_tagging(request: PutObjectTaggingRequest, **kwargs) → PutObjectTaggingResultParameter 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
Untuk kode sampel lengkap yang digunakan untuk mengonfigurasi tag objek, kunjungi put_object_tagging.py.