傳輸加速可提升全球各地使用者對OSS的訪問速度,適用於遠距離資料轉送、GB或TB級大檔案上傳和下載的情境。
注意事項
本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS訪問網域名稱、資料中心、開放連接埠。
本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見初始化。
開啟傳輸加速
以下代碼用於開啟目標儲存空間examplebucket的傳輸加速功能。
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"
# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 設定Bucket的傳輸加速狀態。
# 當設定enabled為true時,表示開啟傳輸加速;當設定enabled為false時,表示關閉傳輸加速。
enabled = 'true'
bucket.put_bucket_transfer_acceleration(enabled)
查詢傳輸加速狀態
以下代碼用於查詢目標儲存空間examplebucket的傳輸加速狀態。
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"
# examplebucket填寫儲存空間名稱。
bucket = oss2.Bucket(auth, endpoint, "examplebucket", region=region)
# 查詢Bucket的傳輸加速狀態。
# 如果傳回值為true,則Bucket已開啟傳輸加速功能;如果傳回值為false,則Bucket的傳輸加速功能為關閉狀態。
result = bucket.get_bucket_transfer_acceleration()
enabled_text = result.enabled
print("Returns whether to enable transfer acceleration: ", enabled_text)
相關文檔
關於傳輸加速的完整範例程式碼,請參見GitHub樣本
關於開啟傳輸加速的API介面資訊,請參見PutBucketTransferAcceleration。
關於查詢傳輸加速狀態的API介面資訊,請參見GetBucketTransferAcceleration。