阿里雲團隊努力不懈,力求將最新的技術內容更快地以您最熟悉的語言呈現。本文由簡體中文內容自動轉碼而成,過程無人工干預。阿里雲不保證此自動轉碼的準確性、完整性及時效性。因轉碼造成的任何內容錯誤及因此可能帶來的損失,阿里雲概不負責,敬請見諒。本文内容請以簡體中文版本為準。
全部產品
Search
文件中心

初始化

更新時間: Oct 19, 2018

Python SDK中的大部分操作都是通過oss2.Service和oss2.Bucket這兩個類進行的。

  • oss2.Service類用於列舉儲存空間。
  • oss2.Bucket類用於上傳、下載、刪除檔案以及對儲存空間進行各種配置。

初始化這兩個類時,需要指定Endpoint。其中oss2.Service類不支援自訂網域名訪問。有關Endpoint的更多資訊,請參見開發人員指南中訪問網域名稱和資料中心自訂網域名

初始化oss2.Service類

詳情請參見管理儲存空間中的列舉儲存空間。

初始化oss2.Bucket類

使用OSS網域名稱初始化

下面的代碼用於使用OSS網域名稱初始化:

  1. # -*- coding: utf-8 -*-
  2. import oss2
  3. # 阿里雲主帳號AccessKey擁有所有API的存取權限,風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維,請登入 https://ram.console.aliyun.com 建立RAM帳號。
  4. auth = oss2.Auth('<yourAccessKeyId>', '<yourAccessKeySecret>')
  5. # Endpoint以杭州為例,其它Region請按實際情況填寫。
  6. endpoint = 'http://oss-cn-hangzhou.aliyuncs.com'
  7. bucket = oss2.Bucket(auth, endpoint, '<yourBucketName>')

使用自訂網域名初始化

下面的代碼用於使用自訂網域名初始化:

  1. # -*- coding: utf-8 -*-
  2. import oss2
  3. # 阿里雲主帳號AccessKey擁有所有API的存取權限,風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維,請登入 https://ram.console.aliyun.com 建立RAM帳號。
  4. auth = oss2.Auth('<yourAccessKeyId>', '<yourAccessKeySecret>')
  5. # 自訂網域名以my-domain.com為例。is_cname=True為開啟CNAME。CNAME是指將自訂網域名綁定到儲存空間上。
  6. cname = 'http://my-domain.com'
  7. bucket = oss2.Bucket(auth, cname, '<yourBucketName>', is_cname=True)

設定連接逾時時間

以下代碼用於設定連接逾時時間:

  1. # -*- coding: utf-8 -*-
  2. import oss2
  3. # 阿里雲主帳號AccessKey擁有所有API的存取權限,風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維,請登入 https://ram.console.aliyun.com 建立RAM帳號。
  4. auth = oss2.Auth('<yourAccessKeyId>', '<yourAccessKeySecret>')
  5. # Endpoint以杭州為例,其它Region請按實際情況填寫。
  6. endpoint = 'http://oss-cn-hangzhou.aliyuncs.com'
  7. # 設定連接逾時時間設為30秒。
  8. bucket = oss2.Bucket(auth, endpoint, '<yourBucketName>', connect_timeout=30)

關閉CRC資料校驗

上傳、下載檔案時預設開啟CRC資料校驗,確保上傳、下載過程的資料完整性。以下代碼用於關閉CRC資料校驗:

警告:強烈建議您不要關閉CRC資料校驗功能。如果您關閉此功能,則阿里雲不保證上傳、下載過程資料的完整性。

  1. # -*- coding: utf-8 -*-
  2. import oss2
  3. # 阿里雲主帳號AccessKey擁有所有API的存取權限,風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維,請登入 https://ram.console.aliyun.com 建立RAM帳號。
  4. auth = oss2.Auth('<yourAccessKeyId>', '<yourAccessKeySecret>')
  5. # Endpoint以杭州為例,其它Region請按實際情況填寫。
  6. endpoint = 'http://oss-cn-hangzhou.aliyuncs.com'
  7. bucket = oss2.Bucket(auth, endpoint, '<yourBucketName>', enable_crc=False)