All Products
Search
Document Center

Object Storage Service:Daftar vektor (Python SDK V2)

Last Updated:Nov 09, 2025

Gunakan operasi ListVectors dalam Python SDK V2 untuk mendaftarkan semua data vektor dalam indeks vektor yang ditentukan. Dukungan paging disediakan untuk menangani sejumlah besar data vektor.

Izin

Akun Alibaba Cloud memiliki semua izin secara default. Pengguna Manajemen Akses Sumber Daya (RAM) atau Peran RAM di bawah Akun Alibaba Cloud tidak memiliki izin secara default. Administrator harus memberikan izin melalui Kebijakan RAM atau Kebijakan bucket.

API

Aksi

Deskripsi

ListVectors

oss:ListVectors

Mendaftarkan data vektor.

Definisi metode

Python SDK V2 menyediakan dua metode untuk mendaftarkan data vektor:

  • list_vectors(): Memanggil operasi secara langsung. Anda perlu menangani paging secara manual.

  • list_vectors_paginator(): Menggunakan paginator. SDK secara otomatis menangani logika paging. Metode ini direkomendasikan.

list_vectors(request: ListVectorsRequest, **kwargs) → ListVectorsResult[source]

Parameter permintaan

Parameter

Tipe

Deskripsi

request

ListVectorsRequest

Menetapkan parameter permintaan. Untuk informasi lebih lanjut, lihat ListVectorsRequest.

Nilai kembali

Tipe

Deskripsi

ListVectorsResult

Nilai kembali. Untuk informasi lebih lanjut, lihat ListVectorsResult.

Untuk definisi lengkap metode daftar vektor, lihat list_vectors.

# Gunakan paginator
list_vectors_paginator(**kwargs) → ListVectorsPaginator[source]

Nilai kembali

Tipe

Deskripsi

ListVectorsPaginator

Nilai kembali. Untuk informasi lebih lanjut, lihat ListVectorsPaginator.

Untuk definisi lengkap metode daftar vektor menggunakan paginator, lihat list_vectors_paginator.

Kode contoh

import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors

parser = argparse.ArgumentParser(description="contoh daftar vektor")

parser.add_argument('--region', help='Wilayah tempat bucket berada.', required=True)
parser.add_argument('--endpoint', help='Nama domain yang dapat digunakan layanan lain untuk mengakses OSS')
parser.add_argument('--account_id', help='ID akun.', required=True)
parser.add_argument('--bucket', help='Nama bucket.', required=True)
parser.add_argument('--index_name', help='Nama indeks vektor.', required=True)

def main():

    args = parser.parse_args()

    # Memuat nilai kredensial dari variabel lingkungan
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Menggunakan konfigurasi default SDK
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region
    cfg.account_id = args.account_id
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    client = oss_vectors.Client(cfg)

    # Buat Paginator untuk operasi ListVectors
    paginator = client.list_vectors_paginator()

    # Buat permintaan dengan bucket dan nama indeks
    request = oss_vectors.models.ListVectorsRequest(
        bucket=args.bucket,
        index_name=args.index_name
    )

    # Iterasi melalui halaman vektor
    for page in paginator.iter_page(request):
        for o in page.vectors:
            print(f'Vektor: {o}')

if __name__ == "__main__":
    main()

Referensi

Untuk kode contoh lengkap untuk mendaftarkan vektor, lihat list_vectors.py.