Cara membuat dan menggunakan style - Object Storage Service

Anda dapat mengelompokkan beberapa parameter pemrosesan ke dalam satu style untuk memproses media, dokumen, atau gambar secara kompleks dengan cepat.

Catatan

API dan SDK untuk fitur pemrosesan data tersedia di wilayah yang memiliki titik akhir Intelligent Media Management (IMM).

Gunakan style kustom

Buat style

Catatan

Anda dapat membuat maksimal 50 style untuk satu bucket. Style ini hanya berlaku untuk file dalam bucket yang sama. Jika bisnis Anda memerlukan lebih banyak style, hubungi technical support.

Masuk ke Konsol OSS.
Pada panel navigasi kiri, klik Buckets, lalu klik nama bucket tujuan.
Pada panel navigasi kiri, pilih Data Processing.
Berdasarkan jenis file yang ingin Anda proses, pilih IMG, Document Processing, atau Media Processing.
Pilih tab Style Management, lalu klik Create Style.
Pada panel Create Style, konfigurasikan style tersebut.
Klik OK.

Gunakan style

Setelah membuat style, Anda dapat menggunakannya untuk memproses file melalui URL objek atau permintaan asinkron.

Pemrosesan sinkron dengan URL objek

Untuk memproses objek secara sinkron, tambahkan style ke URL-nya dengan format berikut: http(s)://BucketName.Endpoint/ObjectName?x-oss-process=style/StyleName. Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi	Contoh
`http(s)://BucketName.Endpoint/ObjectName`	URL objek. Untuk informasi selengkapnya tentang cara mendapatkan URL objek, lihat Dapatkan URL untuk satu atau beberapa file.	https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/small
`x-oss-process=style/`	Parameter tetap yang menentukan pemrosesan dengan style.
`StyleName`	Nama style kustom.

Anda dapat menyederhanakan URL pemrosesan dengan menentukan pemisah kustom dan memetakan nama domain kustom. Contoh:

Gunakan pemisah ! untuk menggantikan x-oss-process=style/.
Petakan nama domain kustom ke bucket untuk lebih menyederhanakan URL. Untuk informasi selengkapnya, lihat Map a custom domain name.

Misalnya, jika Anda memetakan nama domain kustom example.com ke bucket, Anda dapat menggunakan https://example.com/example.jpg!small untuk memproses gambar tersebut.

Catatan

Nama domain kustom diperlukan untuk pratinjau online. Mulai pukul 00.00.00 pada 9 Oktober 2022 (UTC+8), pratinjau online dinonaktifkan untuk bucket yang baru dibuat kecuali jika nama domain kustom telah dipetakan. Untuk informasi selengkapnya, lihat pengumuman resmi.

Pemrosesan asinkron dengan gaya

Anda dapat menggunakan x-oss-async-process=style/StyleName untuk memproses file secara asinkron. Berikut contohnya:

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
 
 // Proses file example.avi secara asinkron dengan style StyleName dan simpan output ke oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/StyleName|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
`ObjectName`	Nama objek.
`x-oss-async-process=style/`	Parameter tetap yang menentukan pemrosesan dengan style.
`StyleName`	Nama style kustom.

Gunakan style bawaan

Selain style kustom, Anda juga dapat menggunakan style bawaan untuk memproses file.

Pemrosesan asinkron bergaya

Anda dapat menggunakan x-oss-async-process=style/::systemStyleName untuk memproses file secara asinkron dengan style bawaan. Contoh permintaan berikut menunjukkan cara penggunaannya:

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
 
// Proses file example.avi secara asinkron dengan style bawaan h264-mp4-1080p dan simpan output ke oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

Tabel berikut menjelaskan parameter-parameter tersebut.

Parameter	Deskripsi
`ObjectName`	Nama objek.
`x-oss-async-process=style/`	Parameter tetap yang menentukan pemrosesan dengan style.
`::`	Menunjukkan style bawaan.
`systemStyleName`	Nama style bawaan. Catatan Anda dapat melihat semua parameter style bawaan yang didukung pada halaman Data Processing>Media Processing.

Impor style antar bucket

Catatan

Fitur ini hanya mendukung style IMG.

Anda dapat mengekspor style dari bucket sumber, lalu mengimpornya ke bucket tujuan. Hal ini memungkinkan Anda menerapkan style yang sama untuk memproses file gambar di bucket tujuan secara cepat.

Ekspor style dari bucket sumber.
1. Pada halaman manajemen bucket sumber, pilih Data Processing>IMG.
2. Pada halaman IMG, klik Export Style.
3. Pada kotak dialog yang muncul, pilih lokasi untuk menyimpan file style, lalu klik Save.
Impor style ke bucket tujuan.
1. Pada halaman manajemen bucket tujuan, pilih Data Processing>IMG.
2. Pada halaman IMG, klik Import Style.
3. Pada kotak dialog yang muncul, pilih file style yang telah diekspor, lalu klik Open.
  Setelah mengimpor style, Anda dapat menggunakannya untuk memproses file gambar di bucket tujuan.

Referensi

Untuk informasi selengkapnya tentang penggunaan parameter pemrosesan, lihat Synchronous processing.
Untuk informasi selengkapnya tentang penyimpanan file yang telah diproses ke OSS, lihat saveas.