Object Storage Service：列舉儲存空間（Python SDK V1）

注意事項

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

• 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見配置訪問憑證（Python SDK V1）。

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

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

列舉所有儲存空間

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

# -*- 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）。