全部產品
Search
文件中心

Object Storage Service:Python列舉儲存空間

更新時間:Jun 19, 2024

儲存空間(Bucket)是用來儲存物件(Object)的容器。對象都隸屬於儲存空間。儲存空間按照字母順序排列。您可以列舉當前帳號所有地區下符合指定條件的儲存空間。

注意事項

  • 本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見訪問網域名稱和資料中心

  • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證,請參見配置訪問憑證

  • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見初始化

  • 要列舉儲存空間,您必須具有oss:ListBuckets許可權。具體操作,請參見為RAM使用者授權自訂的權限原則

列舉所有儲存空間

以下代碼用於列舉當前帳號所有地區下的儲存空間。

說明

以下代碼不支援列舉指定地區的儲存空間。例如,您在代碼中填寫的Bucket所在地區為華東1(杭州),則依然會列舉您的阿里雲帳號下所有地區的儲存空間。

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
service = oss2.Service(auth, 'https://oss-cn-hangzhou.aliyuncs.com')

# 列舉當前帳號所有地區下的儲存空間。
for b in oss2.BucketIterator(service):
    print(b.name)

列舉指定首碼的儲存空間

以下代碼用於列舉當前帳號所有地區下以example為首碼(prefix)的儲存空間。

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
service = oss2.Service(auth, 'https://oss-cn-hangzhou.aliyuncs.com')

# 列舉當前帳號所有地區下首碼為example的儲存空間。
for b in oss2.BucketIterator(service, prefix='example'):
    print(b.name)

列舉指定marker之後的儲存空間

以下代碼用於列舉當前帳號所有地區下名稱的字母序排在examplebucket之後的儲存空間。

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
service = oss2.Service(auth, 'https://oss-cn-hangzhou.aliyuncs.com')

# 列舉當前帳號所有地區下名稱的字母序排在examplebucket之後的儲存空間。列舉結果中不包含名為examplebucket的儲存空間。
for b in oss2.BucketIterator(service, marker='examplebucket'):
    print(b.name)

相關文檔