儲存空間(Bucket)是用來儲存物件(Object)的容器。對象都隸屬於儲存空間。儲存空間按照字母順序排列。您可以列舉當前帳號所有地區下符合指定條件的儲存空間。
注意事項
本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS地區和訪問網域名稱。
本文以從環境變數讀取存取憑證為例。如何配置訪問憑證,請參見配置訪問憑證。
本文以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.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊,例如cn-hangzhou。注意,v4簽名下,必須填寫該參數
region = "cn-hangzhou"
service = oss2.Service(auth, endpoint, region=region)
# 列舉當前帳號所有地區下的儲存空間。
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.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊,例如cn-hangzhou。注意,v4簽名下,必須填寫該參數
region = "cn-hangzhou"
service = oss2.Service(auth, endpoint, region=region)
# 列舉當前帳號所有地區下首碼為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.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# 填寫Bucket所在地區對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 填寫Endpoint對應的Region資訊,例如cn-hangzhou。注意,v4簽名下,必須填寫該參數
region = "cn-hangzhou"
service = oss2.Service(auth, endpoint, region=region)
# 列舉當前帳號所有地區下名稱的字母序排在examplebucket之後的儲存空間。列舉結果中不包含名為examplebucket的儲存空間。
for b in oss2.BucketIterator(service, marker='examplebucket'):
print(b.name)
相關文檔
關於列舉儲存空間的完整範例程式碼,請參見GitHub樣本。
關於列舉儲存空間的API介面說明,請參見ListBuckets(GetService)。