全部产品
Search
文档中心

Object Storage Service:Cara membuat dan menggunakan gaya

更新时间:Jul 06, 2025

Anda dapat menambahkan beberapa parameter pemrosesan ke dalam gaya untuk melakukan operasi kompleks pada media, dokumen, atau gambar yang disimpan di bucket Object Storage Service (OSS).

Catatan

Anda dapat menggunakan fitur pemrosesan data OSS di wilayah yang didukung oleh Titik akhir Intelligent Media Management (IMM) dengan memanggil Operasi API atau menggunakan SDK.

Menggunakan gaya kustom

Buat gaya

Catatan

Anda dapat membuat hingga 50 gaya untuk sebuah bucket. Gaya tersebut hanya berlaku untuk objek yang disimpan di dalam bucket. Jika bisnis Anda memerlukan lebih banyak gaya, hubungi dukungan teknis.

  1. Masuk ke Konsol OSS.

  2. Di panel navigasi sebelah kiri, klik Buckets. Pada halaman Buckets, klik nama bucket tempat Anda ingin membuat gaya.

  3. Di pohon navigasi sebelah kiri, klik Data Processing.

  4. Di pohon navigasi sebelah kiri, klik IMG, Document Processing, Media Processing, atau fitur pemrosesan data lainnya sesuai jenis objek yang ingin diproses.

  5. Klik tab Style Management, lalu klik Create Style.

  6. Di panel Create Style, konfigurasikan parameter untuk membuat gaya.

  7. Klik OK.

Menggunakan gaya

Setelah membuat gaya untuk sebuah bucket, Anda dapat menggunakannya saat memproses objek di dalam bucket melalui URL objek atau permintaan asinkron.

Gunakan URL objek untuk pemrosesan sinkron

Anda dapat menambahkan gaya ke URL objek untuk pemrosesan sinkron. Setelah menambahkan gaya, URL objek akan memiliki format http(s)://NamaBucket.TitikAkhir/NamaObjek?x-oss-process=style/NamaGaya. Tabel berikut menjelaskan parameter dalam format ini.

Parameter

Deskripsi

Contoh

http(s)://NamaBucket.TitikAkhir/NamaObjek

URL objek. Untuk informasi lebih lanjut, lihat Unduh objek menggunakan URL presigned.

https://oss-console-img-demo-cn-hangzhou-3az.oss-cn-hangzhou.aliyuncs.com/example.jpg?x-oss-process=style/small

x-oss-process=style/

Menentukan bahwa objek diproses menggunakan parameter gaya. Parameter ini adalah parameter tetap.

NamaGaya

Nama gaya.

Anda juga dapat menentukan pembatas kustom dan memetakan nama domain kustom ke bucket untuk menyederhanakan URL objek. Contoh:

Sebagai contoh, jika Anda memetakan nama domain kustom example.com ke bucket, Anda dapat menggunakan https://example.com/example.jpg!small untuk memproses objek.

Catatan

Mulai dari 00:00:00 pada tanggal 9 Oktober 2022, Anda tidak lagi dapat melihat pratinjau objek di bucket yang telah dibuat di Konsol OSS atau dengan memanggil Operasi API. Untuk menggunakan fitur pratinjau online, Anda harus memetakan nama domain kustom ke bucket. Jika tidak, fitur pratinjau online tidak dapat digunakan. Untuk informasi lebih lanjut, lihat Alibaba Cloud OSS Update - Response Header upgrade when objects stored in buckets are accessed.

Gunakan gaya untuk pemrosesan asinkron

Berikut adalah kode contoh untuk memproses objek secara asinkron menggunakan x-oss-async-process=style/NamaGaya:

POST /NamaObjek?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
 
 // Gunakan gaya NamaGaya untuk memproses objek example.avi secara asinkron dan simpan objek yang diproses sebagai oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/NamaGaya|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

Tabel berikut menjelaskan parameter dalam kode contoh di atas.

Parameter

Deskripsi

/NamaObjek

Nama objek.

x-oss-async-process=style/

Menentukan bahwa objek diproses menggunakan parameter gaya. Parameter ini adalah parameter tetap.

NamaGaya

Nama gaya.

Menggunakan gaya bawaan

Selain gaya kustom, Anda juga dapat menggunakan gaya bawaan untuk pemrosesan.

Gunakan gaya untuk pemrosesan asinkron

Berikut adalah kode contoh untuk memproses objek secara asinkron menggunakan x-oss-async-process=style/::namaGayaSistem:

POST /NamaObjek?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 example.avi secara asinkron menggunakan gaya bawaan bernama h264-mp4-1080p, dan simpan objek yang diproses sebagai oss://outbucket/outobjprefix.mp4.
x-oss-async-process=style/::h264-mp4-1080p|sys/saveas,b_b3V0YnVja2V0,o_b3V0b2JqcHJlZml4LnthdXRvZXh0fQ

Tabel berikut menjelaskan parameter dalam kode contoh di atas.

Parameter

Deskripsi

NamaObjek

Nama objek.

x-oss-async-process=style/

Menentukan bahwa objek diproses menggunakan parameter gaya. Parameter ini adalah parameter tetap.

:: 

Menentukan bahwa gaya bawaan digunakan.

namaGayaSistem

Nama gaya bawaan.

Catatan

Anda dapat melihat semua parameter gaya bawaan yang didukung di halaman Data ProcessingMedia Processing.

Impor gaya dari bucket sumber ke bucket tujuan

Catatan

Hanya pemrosesan gambar (IMG) yang memungkinkan Anda mengimpor gaya dari bucket sumber ke bucket tujuan.

Anda dapat mengimpor gaya yang dibuat di bucket sumber ke bucket tujuan. Dengan cara ini, Anda dapat menggunakan gaya tersebut untuk memproses objek gambar di bucket tujuan.

  1. Ekspor gaya dari bucket sumber.

    1. Di pohon navigasi sebelah kiri bucket sumber, pilih Data Processing > IMG.

    2. Di halaman IMG, klik Export Style.

    3. Di kotak dialog Simpan Sebagai, pilih jalur tempat Anda ingin menyimpan gaya dan klik Save.

  2. Impor gaya ke bucket tujuan.

    1. Di pohon navigasi sebelah kiri bucket tujuan, pilih Data Processing > IMG.

    2. Di halaman IMG, klik Import Style.

    3. Di kotak dialog Buka, pilih gaya yang diekspor dan klik Open.

      Setelah mengimpor gaya ke bucket tujuan, Anda dapat menggunakannya untuk memproses gambar di bucket tujuan.

Referensi

  • Untuk informasi tentang cara menggunakan parameter untuk memproses objek, lihat Pemrosesan Sinkron.

  • Untuk informasi tentang cara menyimpan objek yang diproses di OSS, lihat sys/saveas.