注意事項(xiàng)

• 本文以華東1（杭州）外網(wǎng)Endpoint為例。如果您希望通過(guò)與OSS同地域的其他阿里云產(chǎn)品訪問(wèn)OSS，請(qǐng)使用內(nèi)網(wǎng)Endpoint。關(guān)于OSS支持的Region與Endpoint的對(duì)應(yīng)關(guān)系，請(qǐng)參見(jiàn)OSS地域和訪問(wèn)域名。

• 本文以從環(huán)境變量讀取訪問(wèn)憑證為例。如何配置訪問(wèn)憑證，請(qǐng)參見(jiàn)配置訪問(wèn)憑證。

• 本文以OSS域名新建OSSClient為例。如果您希望通過(guò)自定義域名、STS等方式新建OSSClient，請(qǐng)參見(jiàn)初始化。

• 要獲取存儲(chǔ)空間的信息，您必須具有oss:GetBucketInfo權(quán)限。具體操作，請(qǐng)參見(jiàn)為RAM用戶授權(quán)自定義的權(quán)限策略。

示例代碼

以下代碼用于獲取存儲(chǔ)空間的信息（Info），包括存儲(chǔ)空間所在地域、創(chuàng)建日期等。

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

# 從環(huán)境變量中獲取訪問(wèn)憑證。運(yùn)行本代碼示例之前，請(qǐng)先配置環(huán)境變量。
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())

# 填寫B(tài)ucket所在地域?qū)?yīng)的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"

# 填寫Endpoint對(duì)應(yīng)的Region信息，例如cn-hangzhou。注意，v4簽名下，必須填寫該參數(shù)
region = "cn-hangzhou"

# yourBucketName填寫存儲(chǔ)空間名稱。
bucket = oss2.Bucket(auth, endpoint, "yourBucketName", region=region)

# 獲取Bucket相關(guān)信息。
bucket_info = bucket.get_bucket_info()
# 獲取Bucket名稱。
print("name: " + bucket_info.name)
# 獲取Bucket存儲(chǔ)類型。
print("storage class: " + bucket_info.storage_class)
# 獲取Bucket創(chuàng)建時(shí)間。
print("creation date: " + bucket_info.creation_date)
# 獲取Bucket內(nèi)網(wǎng)Endpoint。
print("intranet_endpoint: " + bucket_info.intranet_endpoint)
# 獲取Bucket外網(wǎng)Endpoint。
print("extranet_endpoint " + bucket_info.extranet_endpoint)
# 獲取擁有者信息。
print("owner: " + bucket_info.owner.id)
# 獲取Bucket讀寫權(quán)限ACL。
print("grant: " + bucket_info.acl.grant)
# 獲取容災(zāi)類型。
print("data_redundancy_type:" + bucket_info.data_redundancy_type)
# 獲取Bucket的訪問(wèn)跟蹤狀態(tài)。僅Python SDK 2.16.1及以上版本支持獲取訪問(wèn)跟蹤狀態(tài)。
print("access_monitor:" + bucket_info.access_monitor)

相關(guān)文檔

• 關(guān)于獲取存儲(chǔ)空間信息的完整示例代碼，請(qǐng)參見(jiàn)GitHub示例。

• 關(guān)于獲取存儲(chǔ)空間信息的API接口說(shuō)明，請(qǐng)參見(jiàn)GetBucketInfo。