Tous les produits
Search
Centre de documentation

Object Storage Service:List buckets (Ruby SDK)

Dernière mise à jour :Sep 22, 2026

Un bucket est un conteneur pour les objets stockés dans Object Storage Service (OSS). Tous les objets d'OSS résident dans des buckets. Les buckets sont répertoriés par ordre alphabétique. Vous pouvez répertorier les buckets appartenant à votre compte Alibaba Cloud actuel, dans toutes les régions et selon des conditions spécifiques.

Répertorier les buckets

Le code suivant montre comment répertorier tous les buckets de toutes les régions de votre compte.

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # The China (Hangzhou) endpoint is used as an example. Replace it with the actual endpoint.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Obtain access credentials from environment variables. Before running this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# List all buckets across all regions in your account.
buckets = client.list_buckets
buckets.each { |b| puts b.name }

Répertorier les buckets avec un préfixe spécifié

Le code suivant montre comment répertorier les buckets dont le préfixe est « example » dans toutes les régions de votre compte.

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # The China (Hangzhou) endpoint is used as an example. Replace it with the actual endpoint.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # Obtain access credentials from environment variables. Before running this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# List buckets with a specified prefix across all regions in your account.
buckets = client.list_buckets(:prefix => 'example')
buckets.each { |b| puts b.name }

Références

Pour plus d'informations sur l'opération API ListBuckets, consultez ListBuckets (GetService).