注意事項(xiàng)

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

• 本文以O(shè)SS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請參見初始化。

• 要限定條件下載，您必須有oss:GetObject權(quán)限。具體操作，請參見為RAM用戶授權(quán)自定義的權(quán)限策略。

示例代碼

以下代碼用于限定條件下載：

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 從環(huán)境變量中獲取訪問憑證。運(yùn)行本代碼示例之前，請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# yourEndpoint填寫B(tài)ucket所在地域?qū)?yīng)的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
# 填寫B(tài)ucket名稱，例如examplebucket。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')
# 填寫不包含Bucket名稱在內(nèi)的Object完整路徑，例如exampledir/exampleobject.txt。關(guān)于Object名稱命名規(guī)范的更多信息，請參見Object。
object_name = 'exampledir/exampleobject.txt'

headers = dict()
# 如果指定的時(shí)間早于Object實(shí)際修改時(shí)間，則正常下載Object，否則返回錯(cuò)誤304 Not modified。
headers['If-Modified-Since'] = 'Mon, 13 Dec 2021 14:47:53 GMT'
# 如果指定的時(shí)間等于或者晚于Object實(shí)際修改時(shí)間，則正常下載Object，否則返回錯(cuò)誤412 Precondition failed。
# headers['If-Unmodified-Since'] = 'Mon, 13 Dec 2021 14:47:53 GMT'
# 如果傳入的ETag和Object的ETag匹配，則正常下載Object，否則返回錯(cuò)誤412 Precondition failed。
# headers['If-Match'] = 'DC21493F505BA3739562D8CC452C****'
# 如果傳入的ETag值和Object的ETag不匹配，則正常下載Object，否則返回錯(cuò)誤304 Not modified。
# headers['If-None-Match'] = 'DC21493F505BA3739562D8CC452C****'
object_stream = bucket.get_object(object_name, headers=headers)
print(object_stream.read())

相關(guān)文檔

關(guān)于限定條件下載的API接口說明，請參見GetObject。