全部产品
Search
文档中心

Object Storage Service:Menentukan apakah sebuah objek ada menggunakan OSS SDK untuk Java

更新时间:Aug 02, 2025

Topik ini menjelaskan cara menentukan apakah sebuah objek ada menggunakan OSS SDK for Python.

Catatan

  • Kode contoh 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 dengan menggunakan layanan Alibaba Cloud lainnya di wilayah yang sama dengan bucket tersebut, gunakan Titik akhir internal. Untuk informasi lebih lanjut tentang Wilayah dan titik akhir OSS.

  • Izin oss:GetObject diperlukan untuk menentukan apakah objek ada. Untuk informasi lebih lanjut, lihat Melampirkan kebijakan kustom ke Pengguna RAM.

Metode

is_object_exist(bucket: str, key: str, version_id: str | None = None, request_payer: str | None = None, **kwargs) → bool

Parameter permintaan

Parameter

Tipe

Deskripsi

bucket

str

Nama bucket.

key

str

Nama objek.

version_id

str

ID versi objek (opsional).

Parameter respons

Tipe

Deskripsi

bool

Menentukan apakah sebuah objek ada.

Untuk detail tentang metode ini, lihat is_object_exist.

Contoh kode

Berikut adalah contoh kode untuk menentukan apakah sebuah objek ada:

import argparse
import alibabacloud_oss_v2 as oss

# Buat parser parameter baris perintah.
parser = argparse.ArgumentParser(description="Periksa apakah sebuah objek ada di bucket OSS tertentu")
# Tentukan parameter baris perintah.
parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--bucket', help='Nama bucket yang akan diperiksa.', required=True)
parser.add_argument('--endpoint', help='Opsional: URL titik akhir untuk layanan OSS. Jika tidak disediakan, titik akhir default akan digunakan.')
parser.add_argument('--key', help='Kunci (atau nama) objek yang akan diperiksa keberadaannya.', 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 dan tentukan penyedia kredensial.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Perbarui parameter wilayah berdasarkan input.
    cfg.region = args.region

    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

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

    # Panggil metode is_object_exist untuk memeriksa apakah objek yang ditentukan ada di bucket.
    result = client.is_object_exist(
        bucket=args.bucket,
        key=args.key,
    )

    # Keluarkan hasilnya.
    print(f'Objek ada: {result}')

# Titik masuk skrip. Fungsi utama dipanggil ketika file dijalankan langsung.
if __name__ == "__main__":
    main()

Referensi

  • Untuk kode contoh lengkap yang digunakan untuk menentukan apakah sebuah objek ada, kunjungi is_object_exist.py.