阿里云對象存儲OSS與智能媒體管理(IMM)深度結合,支持媒體處理、文檔處理等豐富的數據分析處理操作。本文介紹如何通過OSS使用IMM的相關功能。
前提條件
僅支持使用IMM的地域可以使用IMM相關功能。更多信息,請參見服務接入點。
已開通IMM服務并完成授權。關于開通服務及授權的具體操作,請參見開通產品。
如果您通過RAM用戶使用IMM相關功能,需確保RAM用戶擁有以下權限。
系統權限:訪問OSS的權限
AliyunOSSFullAccess
和訪問IMM的權限AliyunIMMFullAccess
。關于為RAM用戶授權的具體操作,請參見為RAM用戶授權。自定義權限:
oss:ProcessImm
和ram:GetRole
。為RAM用戶授予自定義權限時,您需要先創建對應的自定義權限,然后為RAM用戶授權。具體操作,請參見為RAM用戶授權自定義的權限策略。
費用說明
使用IMM功能會產生一定的費用。詳細費用,請參見計費概述。
步驟一:綁定IMM
登錄OSS管理控制臺。
在左側導航欄,單擊Bucket列表,然后單擊目標Bucket名稱。
在左側導航欄,選擇數據處理。
單擊文檔處理或媒體處理,然后在彈出綁定頁面單擊Bucket綁定IMM project按鈕。
說明圖片處理操作無需綁定IMM。
在綁定智能媒體管理項目對話框的IMM配置區域,根據需要選擇以下兩種綁定方式中的一種:
創建新的Project:輸入Project的名稱,系統會自動在存儲空間所在的地域創建對應的IMM項目,并將其與當前存儲空間綁定。
綁定已有Project:在下拉列表中選擇需要綁定至存儲空間的IMM項目。
重要僅在存儲空間所在的地域創建了對應功能的IMM Project的情況下,才能看到綁定已有Project的選項。關于創建IMM Project的具體操作,請參見創建項目。
單擊確認。
步驟二:使用IMM
通過OSS控制臺使用IMM
單擊Bucket列表,然后單擊目標Bucket名稱。
在左側導航欄,選擇數據處理。
單擊文檔處理、媒體處理等菜單,直接使用IMM的相關功能(例如創建樣式、創建任務等)。
通過SDK使用IMM
以下代碼使用OSS Python SDK通過x-oss-process
的處理方式觸發使用IMM。
# -*- coding: utf-8 -*-
import os
import oss2
# 填寫Bucket所在地域對應的Endpoint。以華東1(杭州)為例,Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'
# 阿里云賬號AccessKey擁有所有API的訪問權限,風險很高。強烈建議您創建并使用RAM用戶進行API訪問或日常運維,請登錄RAM控制臺創建RAM用戶。
access_key_id = 'yourAccessKeyId'
access_key_secret = 'yourAccessKeySecret'
# 指定文件所在的Bucket名稱,例如examplebucket。
bucket_name = 'examplebucket'
# Object完整路徑,完整路徑中不能包含Bucket名稱。
key = 'exampledir/example.docx'
# 指定Bucket實例,所有文件相關的方法都需要通過Bucket實例來調用。
bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
style = 'doc/preview,copy_1,export_1,print_1,pages_3'
# 生成帶簽名的URL,并指定過期時間為10分鐘。過期時間單位為秒。
url = bucket.sign_url('GET', key, 10 * 60, params={'x-oss-process': style})
print(url)