全部產品
Search

搜尋本產品

    Object Storage Service：圖片樣式（Python SDK V1）

    文件中心

    Object Storage Service：圖片樣式（Python SDK V1）

    更新時間：Nov 28, 2025

    如果您希望對儲存在OSS中的圖片進行一系列的操作，例如圖片縮放、裁剪、旋轉、添加浮水印等。您可以通過OSS建立圖片樣式，然後在圖片樣式中定義多個圖片處理相關操作。通過OSS圖片樣式，您可以對Bucket下的所有圖片執行圖片樣式中定義的所有操作，實現Bucket中圖片的快速處理和轉換操作。

    注意事項

    • 關於圖片樣式支援的圖片處理參數，請參見圖片處理。

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

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

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

    • 許可權說明

      阿里雲帳號預設擁有圖片樣式的相關許可權。如果您希望通過RAM使用者或者STS的方式執行圖片樣式相關操作，例如：

      • 建立圖片樣式，您必須擁有oss:PutStyle許可權。

      • 查詢某個Bucket下指定的圖片樣式資訊，您必須擁有oss:GetStyle許可權。

      • 查詢某個Bucket下已建立的所有圖片樣式，您必須擁有oss:ListStyle許可權。

      • 刪除某個Bucket下指定的圖片樣式，您必須擁有oss:DeleteStyle許可權。

      具體操作，請參見為RAM使用者授予自訂的權限原則。

    建立圖片樣式

    一個Bucket最多支援建立50個圖片樣式。以下代碼用於建立圖片樣式。

    # -*- 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"

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

# 設定圖片樣式名稱，例如imagestyle。
style = 'imagestyle'
# 設定圖片樣式指向的圖片操作，例如將原圖縮放為固定寬度200 px。
content = 'image/resize,w_200'

# 新增圖片樣式。
result = bucket.put_bucket_style(style, content)
print('設定樣式成功，返回狀態為：' + str(result.status))

    建立圖片樣式後，您可以使用圖片樣式處理圖片。更多資訊，請參見使用圖片樣式處理圖片。

    查詢指定的圖片樣式

    以下代碼用於查詢某個Bucket下指定的圖片樣式資訊。

    # -*- 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"

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

# 指定圖片樣式名稱，例如imagestyle。
style = 'imagestyle'

# 查詢examplebucket下指定的圖片樣式資訊。
result = bucket.get_bucket_style(style)
print('name：' + result.name)
print('content：' + result.content)

    查詢所有圖片樣式

    以下代碼用於查詢某個Bucket下已建立的所有圖片樣式。

    # -*- 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"

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

# 查詢examplebucket下已建立的所有圖片樣式。
result = bucket.list_bucket_style()
for sty in result.styles:
    print('name：' + sty.name)
    print('content：' + sty.content)

    刪除指定的圖片樣式

    以下代碼用於刪除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"

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

# 指定圖片樣式名稱，例如imagestyle。
style = 'imagestyle'

# 刪除指定的圖片樣式。
result = bucket.delete_bucket_style(style)
print('刪除樣式成功，返回狀態為：' + str(result.status))

    相關文檔

    • 關於建立圖片樣式的API介面說明，請參見PutStyle。

    • 關於查詢某個Bucket下指定的圖片樣式的API介面說明，請參見GetStyle。

    • 關於查詢某個Bucket下已建立的所有圖片樣式的API介面說明，請參見ListStyle。

    • 關於刪除某個Bucket下指定的圖片樣式的API介面說明，請參見DeleteStyle。