Tagging Bucket - Object Storage Service

Topik ini menjelaskan cara menetapkan tag untuk sebuah bucket.

Catatan

Kode contoh dalam topik ini menggunakan ID wilayah cn-hangzhou untuk wilayah Tiongkok (Hangzhou). Secara default, titik akhir publik digunakan. Jika Anda ingin mengakses OSS dari produk Alibaba Cloud lainnya di wilayah yang sama, gunakan titik akhir internal. Untuk informasi lebih lanjut tentang pemetaan antara wilayah dan titik akhir OSS, lihat Wilayah dan titik akhir.
Kode contoh dalam topik ini membaca kredensial akses dari variabel lingkungan. Untuk informasi lebih lanjut tentang cara mengonfigurasi kredensial akses, lihat Konfigurasikan kredensial akses.

Kode contoh

Tetapkan tag bucket

Gunakan kode berikut untuk menetapkan tag pada sebuah bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser parameter baris perintah untuk mengurai parameter dari baris perintah.
parser = argparse.ArgumentParser(description="contoh menempatkan tag bucket")

# Tambahkan argumen baris perintah --region, yang menentukan wilayah tempat bucket berada. Ini adalah argumen wajib.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)

# Tambahkan argumen baris perintah --bucket, yang menentukan nama bucket. Ini adalah argumen wajib.
parser.add_argument('--bucket', help='Nama bucket.', required=True)

# Tambahkan argumen baris perintah --endpoint, yang menentukan nama domain yang digunakan layanan lain untuk mengakses OSS. Ini adalah argumen opsional.
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')

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

    # Muat kredensial (ID AccessKey dan Rahasia AccessKey) dari variabel lingkungan.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Muat konfigurasi default dari SDK.
    cfg = oss.config.load_default()

    # Tetapkan penyedia kredensial.
    cfg.credentials_provider = credentials_provider

    # Tetapkan wilayah tempat bucket berada.
    cfg.region = args.region

    # Jika titik akhir kustom diberikan oleh pengguna, tetapkan dalam konfigurasi.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Inisialisasi klien OSS menggunakan objek konfigurasi.
    client = oss.Client(cfg)

    # Panggil metode put_bucket_tags untuk menetapkan tag pada bucket.
    result = client.put_bucket_tags(
        oss.PutBucketTagsRequest(
            bucket=args.bucket,  # Tentukan nama bucket tujuan.
            tagging=oss.Tagging(  # Bangun satu set tag.
                tag_set=oss.TagSet(  # Set tag berisi beberapa tag.
                    tags=[  # Definisikan daftar tag.
                        oss.Tag(  # Tag pertama.
                            key='test_key',  # Kunci tag.
                            value='test_value',  # Nilai tag.
                        ),
                        oss.Tag(  # Tag kedua.
                            key='test_key2',  # Kunci tag.
                            value='test_value2',  # Nilai tag.
                        ),
                    ],
                ),
            ),
        )
    )

    # Cetak kode status dan ID permintaan dari hasil operasi.
    print(f'kode status: {result.status_code}, '  # Kode status HTTP, yang menunjukkan apakah permintaan berhasil.
          f'ID permintaan: {result.request_id}')    # ID permintaan, yang digunakan untuk melacak log dan debug.


if __name__ == "__main__":
    # Titik masuk program. Panggil fungsi utama untuk mengeksekusi logika.
    main()

Kueri tag bucket

Gunakan kode berikut untuk memeriksa tag pada sebuah bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser parameter baris perintah untuk mengurai parameter dari baris perintah.
parser = argparse.ArgumentParser(description="contoh mendapatkan tag bucket")

# Tambahkan argumen baris perintah --region, yang menentukan wilayah tempat bucket berada. Ini adalah argumen wajib.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)

# Tambahkan argumen baris perintah --bucket, yang menentukan nama bucket. Ini adalah argumen wajib.
parser.add_argument('--bucket', help='Nama bucket.', required=True)

# Tambahkan argumen baris perintah --endpoint, yang menentukan nama domain yang digunakan layanan lain untuk mengakses OSS. Ini adalah argumen opsional.
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')

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

    # Muat kredensial (ID AccessKey dan Rahasia AccessKey) dari variabel lingkungan.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Muat konfigurasi default dari SDK.
    cfg = oss.config.load_default()

    # Tetapkan penyedia kredensial.
    cfg.credentials_provider = credentials_provider

    # Tetapkan wilayah tempat bucket berada.
    cfg.region = args.region

    # Jika titik akhir kustom diberikan oleh pengguna, tetapkan dalam konfigurasi.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Inisialisasi klien OSS menggunakan objek konfigurasi.
    client = oss.Client(cfg)

    # Panggil metode get_bucket_tags untuk mendapatkan informasi tag bucket.
    result = client.get_bucket_tags(
        oss.GetBucketTagsRequest(
            bucket=args.bucket,  # Tentukan nama bucket tujuan.
        )
    )

    # Cetak kode status, ID permintaan, dan informasi tag dari hasil operasi.
    print(f'kode status: {result.status_code}, '  # Kode status HTTP, yang menunjukkan apakah permintaan berhasil.
          f'ID permintaan: {result.request_id}, '   # ID permintaan, yang digunakan untuk melacak log dan debug.
          f'tagging: {result.tagging}')         # Informasi set tag.

    # Jika set tag yang dikembalikan berisi tag, cetak pasangan kunci-nilai dari setiap tag.
    if result.tagging.tag_set.tags:  # Periksa apakah tag ada.
        for r in result.tagging.tag_set.tags:  # Lintasi set tag.
            print(f'hasil: kunci: {r.key}, nilai: {r.value}')  # Cetak kunci dan nilai dari setiap tag.


if __name__ == "__main__":
    # Titik masuk program. Panggil fungsi utama untuk mengeksekusi logika.
    main()

Hapus tag bucket

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser parameter baris perintah untuk mengurai parameter dari baris perintah.
parser = argparse.ArgumentParser(description="contoh menghapus tag bucket")

# Tambahkan argumen baris perintah --region, yang menentukan wilayah tempat bucket berada. Ini adalah argumen wajib.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)

# Tambahkan argumen baris perintah --bucket, yang menentukan nama bucket. Ini adalah argumen wajib.
parser.add_argument('--bucket', help='Nama bucket.', required=True)

# Tambahkan argumen baris perintah --endpoint, yang menentukan nama domain yang digunakan layanan lain untuk mengakses OSS. Ini adalah argumen opsional.
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')

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

    # Muat kredensial (ID AccessKey dan Rahasia AccessKey) dari variabel lingkungan.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Muat konfigurasi default dari SDK.
    cfg = oss.config.load_default()

    # Tetapkan penyedia kredensial.
    cfg.credentials_provider = credentials_provider

    # Tetapkan wilayah tempat bucket berada.
    cfg.region = args.region

    # Jika titik akhir kustom diberikan oleh pengguna, tetapkan dalam konfigurasi.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Inisialisasi klien OSS menggunakan objek konfigurasi.
    client = oss.Client(cfg)

    # Panggil metode delete_bucket_tags untuk menghapus semua tag bucket.
    result = client.delete_bucket_tags(
        oss.DeleteBucketTagsRequest(
            bucket=args.bucket,  # Tentukan nama bucket tujuan.
        )
    )

    # Cetak kode status dan ID permintaan dari hasil operasi.
    print(f'kode status: {result.status_code}, '  # Kode status HTTP, yang menunjukkan apakah permintaan berhasil.
          f'ID permintaan: {result.request_id}')    # ID permintaan, yang digunakan untuk melacak log dan debug.


if __name__ == "__main__":
    # Titik masuk program. Panggil fungsi utama untuk mengeksekusi logika.
    main()