Object Storage Service (OSS) バケットに保存されているメディア、ドキュメント、またはイメージに対して複雑な操作を実行するために、スタイルに複数の処理パラメーターを追加できます。
API 操作を呼び出すか、SDK を使用することにより、Intelligent Media Management (IMM) エンドポイントでサポートされているリージョンで OSS のデータ処理機能を使用できます。
カスタムスタイルの使用
スタイルの作成
バケットには最大 50 個のスタイルを作成できます。 スタイルは、バケットに保存されているオブジェクトに対してのみ使用できます。 ビジネスでさらに多くのスタイルが必要な場合は、OSS テクニカルサポートまでお問い合わせください。
左側のナビゲーションツリーで、処理するオブジェクトのタイプに基づいて、画像処理、ドキュメント処理、[メディア処理]、またはその他のデータ処理機能をクリックします。
スタイル管理 タブをクリックし、スタイルを作成 をクリックします。
スタイルを作成 パネルで、パラメーターを設定してスタイルを作成します。
OK をクリックします。
スタイルの使用
バケットのスタイルを作成した後、オブジェクト URL または非同期リクエストを使用してバケット内のオブジェクトを処理するときに、スタイルを使用できます。
オブジェクト URL を使用した同期処理
同期処理のためにオブジェクトの URL にスタイルを追加できます。 スタイルを追加した後、オブジェクト URL は http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName 形式になります。 次の表に、この形式のパラメーターを示します。
パラメーター | 説明 | 例 |
| オブジェクトの URL。 詳細については、「署名付き URL を使用してオブジェクトをダウンロードする」をご参照ください。 | |
| オブジェクトがスタイルパラメーターを使用して処理されることを指定します。 このパラメーターは固定パラメーターです。 | |
| スタイルの名前。 |
カスタムデリミタを指定し、カスタムドメイン名をバケットにマッピングして、オブジェクト URL を簡略化することもできます。 例：
感嘆符 (
!) を使用して、x-oss-process=style/を置き換えます。カスタムドメイン名をバケットにマッピングして、オブジェクト URL をさらに簡略化します。 詳細については、「バケットのデフォルトドメイン名にカスタムドメイン名をマッピングする」をご参照ください。
たとえば、カスタムドメイン名 example.com をバケットにマッピングする場合、https://example.com/example.jpg!small を使用してオブジェクトを処理できます。
2022 年 10 月 9 日 00:00:00 以降、OSS コンソールまたは API 操作の呼び出しで、作成されたバケット内のオブジェクトをプレビューできなくなりました。 オンラインプレビュー機能を使用するには、カスタムドメイン名をバケットにマッピングする必要があります。 そうしないと、オンラインプレビュー機能は使用できません。 詳細については、「Alibaba Cloud OSS の更新 - バケットに保存されているオブジェクトへのアクセス時のレスポンスヘッダーのアップグレード」をご参照ください。
非同期処理でのスタイルの使用
以下は、x-oss-async-process=style/StyleName を使用してオブジェクトを非同期に処理するサンプルコードです。
POST /ObjectName?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// StyleName スタイルを使用して example.avi オブジェクトを非同期に処理し、処理されたオブジェクトを oss://outbucket/outobjprefix.mp4 として保存します。
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ次の表に、上記のサンプルコードのパラメーターを示します。
パラメーター | 説明 |
| オブジェクトの名前。 |
| オブジェクトがスタイルパラメーターを使用して処理されることを指定します。 このパラメーターは固定パラメーターです。 |
| スタイルの名前。 |
組み込みスタイルの使用
カスタムスタイルに加えて、組み込みスタイルを処理に使用することもできます。
非同期処理でのスタイルの使用
以下は、x-oss-async-process=style/::systemStyleName を使用してオブジェクトを非同期に処理するサンプルコードです。
POST /ObjectName?x-oss-async-process HTTP/1.1
Host: video-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 28 Oct 2022 06:40:10 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
// h264-mp4-1080p という名前の組み込みスタイルを使用して example.avi を非同期に処理し、処理されたオブジェクトを oss://outbucket/outobjprefix.mp4 として保存します。
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ次の表に、上記のサンプルコードのパラメーターを示します。
パラメーター | 説明 |
| オブジェクトの名前。 |
| オブジェクトがスタイルパラメーターを使用して処理されることを指定します。 このパラメーターは固定パラメーターです。 |
| 組み込みスタイルが使用されることを指定します。 |
| 組み込みスタイルの名前。 説明 インテリジェントデータ処理 > ApsaraVideo Media Processing ページで、サポートされているすべての組み込みスタイルパラメーターを表示できます。 |
ソースバケットからデスティネーションバケットへのスタイルのインポート
イメージ処理 (IMG) のみ、ソースバケットからデスティネーションバケットへのスタイルのインポートが可能です。
ソースバケットで作成されたスタイルをデスティネーションバケットにインポートできます。 この方法で、スタイルを使用してデスティネーションバケット内のイメージオブジェクトを処理できます。
ソースバケットからスタイルをエクスポートします。
ソースバケットの左側のナビゲーションツリーで、インテリジェントデータ処理 > 画像処理 を選択します。
画像処理 ページで、スタイルをエクスポート をクリックします。
[名前を付けて保存] ダイアログボックスで、スタイルを保存するパスを選択し、設定 をクリックします。
デスティネーションバケットにスタイルをインポートします。