All Products
Search
Document Center

ApsaraVideo Live:AddLiveAppRecordConfig

Last Updated:Oct 27, 2026

Mengonfigurasi Catatan aplikasi dan menyimpan output ke OSS.

Deskripsi operasi

  • Pastikan Anda sepenuhnya memahami metode penagihan dan harga Catatan siaran langsung sebelum memanggil operasi ini. Untuk detail penagihan, lihat Biaya Catatan siaran langsung.

  • Jika Anda ingin menyimpan Catatan di OSS, Anda harus mengaktifkan OSS dan membuat bucket. Untuk informasi lebih lanjut, lihat Mengonfigurasi OSS.

  • Catatan yang disimpan di OSS dikenakan biaya penyimpanan. Untuk detail penagihan di OSS, lihat Biaya penyimpanan.

  • Bucket OSS harus berada di wilayah yang sama dengan Pusat Siaran Langsung domain streaming. Catatan lintas wilayah tidak didukung.

  • Fitur Catatan siaran langsung memungkinkan Anda merekam aliran siaran langsung dan menyimpan Catatan ke lokasi tertentu untuk pemutaran. Catatan yang disimpan di OSS mendukung beberapa format (TS, MP4, FLV, dan CMAF) serta kebijakan Catatan kustom (Catatan otomatis, sesuai permintaan, dan manual). Anda dapat memanggil operasi ini untuk mengonfigurasi Templat Catatan. Untuk informasi lebih lanjut, lihat Catatan siaran langsung.

  • Satu Tupel (DomainName, AppName, NamaStream) hanya dapat sesuai dengan satu konfigurasi. Jika konfigurasi sudah ada untuk Tupel tersebut, memanggil operasi ini untuk menambahkan konfigurasi akan mengembalikan error yang menunjukkan bahwa konfigurasi sudah ada.

  • Konfigurasi yang ditetapkan oleh operasi ini hanya berlaku setelah aliran siaran langsung di-ingest kembali dan tetap berlaku secara permanen.

Batas QPS

Batas QPS untuk satu pengguna yang memanggil operasi ini adalah 30 permintaan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Lakukan panggilan API pada laju yang wajar.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

live:AddLiveAppRecordConfig

create

*Domain.

acs:cdn:*:{#accountId}:domain/{#DomainName}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DomainName

string

Yes

Nama domain streaming utama.

example.com

AppName

string

Yes

Nama aplikasi tempat aliran berada. AppName harus cocok dengan AppName di URL ingest agar template berlaku. Jika Anda tidak ingin membatasi AppName, Anda dapat memasukkan tanda bintang (*) untuk mencocokkan semua AppName.

liveApp****

OssEndpoint

string

Yes

Titik akhir OSS.

Untuk menyimpan Catatan siaran langsung di OSS, Anda harus membuat Bucket OSS terlebih dahulu. Untuk informasi lebih lanjut, lihat Mengonfigurasi OSS.

oss-cn-beijing.aliyuncs.com

OssBucket

string

Yes

Nama Bucket OSS.

Untuk menyimpan Catatan siaran langsung di OSS, Anda harus membuat Bucket OSS terlebih dahulu. Untuk informasi lebih lanjut, lihat Mengonfigurasi OSS.

liveBucket****

StreamName

string

No

Nama aliran. NamaStream harus cocok dengan NamaStream di URL ingest agar Templat berlaku. Jika Anda tidak ingin membatasi NamaStream, Anda dapat memasukkan tanda bintang (*) untuk mencocokkan semua NamaStream di bawah AppName.

teststream

StartTime

string

No

Waktu mulai Catatan. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

Catatan

Waktu yang ditentukan harus berada dalam 7 hari setelah waktu mulai pengambilan aliran aktual. Parameter ini hanya berlaku untuk Catatan tingkat aliran, di mana NamaStream tidak kosong.

2018-04-10T09:57:21Z

EndTime

string

No

Waktu akhir Catatan. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.

Catatan

Selisih antara EndTime dan StartTime tidak boleh melebihi 7 hari. Jika selisih melebihi 7 hari, akan dihitung sebagai 7 hari. Parameter ini hanya berlaku untuk Catatan tingkat aliran, di mana NamaStream tidak kosong.

2018-04-16T09:57:21Z

OnDemand

integer

No

Apakah akan mengaktifkan Catatan sesuai permintaan atau manual. Nilai valid:

  • 0 (default): Dinonaktifkan. Catatan otomatis digunakan.

  • 1: Catatan sesuai permintaan menggunakan callback HTTP. Anda harus terlebih dahulu memanggil operasi AddLiveRecordNotifyConfig untuk mengonfigurasi OnDemandUrl. Jika tidak, Catatan dinonaktifkan secara default.

  • 2: Catatan sesuai permintaan dengan Penguraian parameter ingest.

  • 7: Catatan manual. Catatan dinonaktifkan secara default. Anda dapat memanggil operasi RealTimeRecordCommand untuk memulai atau menghentikan Catatan secara manual.

1

DelayTime

integer

No

Durasi penyambungan saat aliran terputus. Jika durasi pemutusan aliran melebihi durasi penyambungan yang ditentukan, file baru akan dibuat. Durasi penyambungan saat aliran terputus berkisar dari 15 hingga 21.600 detik.

180

RecordFormat

array<object>

No

Detail format Catatan.

object

No

SliceDuration

integer

No

Panjang segmen. Unit: seconds.

Penting Parameter ini hanya berlaku ketika RecordFormat.N.Format diatur ke m3u8 atau cmaf.

Jika Anda tidak menentukan parameter ini, nilai default adalah 30. Nilai valid: 5 hingga 30.

30

SliceOssObjectPrefix

string

No

Nama segmen.

Penting Anda hanya perlu mengonfigurasi parameter ini ketika RecordFormat.N.Format diatur ke m3u8 atau cmaf.
  • Secara default, segmen dibuat setiap 30 detik. Nama berukuran kurang dari 256 byte dan mendukung pencocokan variabel, termasuk {AppName}, {NamaStream}, {UnixTimestamp}, dan {Sequence}.

  • Nilai parameter harus berisi variabel {UnixTimestamp} dan {Sequence}.

record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}

CycleDuration

integer

No

Panjang Catatan periodik. Unit: seconds.

Catatan
  • Jika Anda tidak menentukan parameter ini, nilai default akan digunakan. Nilai default bervariasi berdasarkan format Catatan: 6 jam untuk m3u8 dan cmaf, serta 1 jam untuk flv dan mp4.

  • Jika pemutusan aliran terjadi dalam satu siklus Catatan tetapi aliran di-ingest kembali secara normal dalam durasi penyambungan pemutusan aliran, Catatan akan berlanjut di file Catatan yang sama.

  • File Catatan hanya dibuat ketika aliran siaran langsung terputus selama durasi yang melebihi durasi penyambungan pemutusan aliran.

1

OssObjectPrefix

string

No

Nama file Catatan yang disimpan di OSS.

  • Nama file berukuran kurang dari 256 byte dan mendukung pencocokan variabel, termasuk {AppName}, {NamaStream}, {Sequence}, {StartTime}, {EndTime}, {EscapedStartTime}, dan {EscapedEndTime}.

  • Nilai parameter harus berisi {StartTime} atau {EscapedStartTime}, serta {EndTime} atau {EscapedEndTime}.

record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}

Format

string

No

Format. M3U8, FLV, MP4, dan CMAF didukung. Nilai valid:

Penting Anda harus menentukan setidaknya satu dari RecordFormat dan TranscodeRecordFormat. Jika Anda memilih format m3u8 atau cmaf, Anda juga harus mengatur parameter permintaan RecordFormat.N.SliceOssObjectPrefix dan RecordFormat.N.SliceDuration.
  • m3u8

  • flv

  • mp4

  • cmaf

m3u8

TranscodeRecordFormat

array<object>

No

Detail format Catatan untuk aliran yang telah dikodekan ulang.

object

No

SliceDuration

integer

No

Panjang segmen untuk Catatan aliran yang telah dikodekan ulang. Unit: seconds.

Penting Parameter ini hanya berlaku ketika TranscodeRecordFormat.N.Format diatur ke m3u8 atau cmaf.

Jika Anda tidak menentukan parameter ini, nilai default adalah 30. Nilai valid: 5 hingga 30.

30

SliceOssObjectPrefix

string

No

Nama segmen untuk Catatan aliran yang telah dikodekan ulang.

Penting Anda hanya perlu mengonfigurasi parameter ini ketika TranscodeRecordFormat.N.Format diatur ke m3u8 atau cmaf.
  • Secara default, segmen dibuat setiap 30 detik. Nama berukuran kurang dari 256 byte dan mendukung pencocokan variabel, termasuk {AppName}, {NamaStream}, {UnixTimestamp}, dan {Sequence}.

  • Nilai parameter harus berisi variabel {UnixTimestamp} dan {Sequence}.

record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}

CycleDuration

integer

No

Panjang Catatan periodik untuk Catatan aliran yang telah dikodekan ulang. Unit: seconds.

Catatan

Jika Anda tidak menentukan parameter ini, nilai default akan digunakan. Nilai default bervariasi berdasarkan format Catatan: 6 jam untuk m3u8 dan cmaf, serta 1 jam untuk flv dan mp4.

21600

OssObjectPrefix

string

No

Nama file Catatan untuk Catatan aliran yang telah dikodekan ulang yang disimpan di OSS.

  • Nama file berukuran kurang dari 256 byte dan mendukung pencocokan variabel, termasuk {AppName}, {NamaStream}, {Sequence}, {StartTime}, {EndTime}, {EscapedStartTime}, dan {EscapedEndTime}.

  • Nilai parameter harus berisi {StartTime} atau {EscapedStartTime}, serta {EndTime} atau {EscapedEndTime}.

record/{AppName}/{StreamName}/{Sequence}_{EscapedStartTime}_{EscapedEndTime}

Format

string

No

Format Catatan untuk aliran yang telah dikodekan ulang. M3U8, FLV, MP4, dan CMAF didukung. Nilai valid:

Penting Jika Anda memilih format m3u8 atau cmaf, Anda juga harus mengatur parameter permintaan TranscodeRecordFormat.N.SliceOssObjectPrefix dan TranscodeRecordFormat.N.SliceDuration.

  • m3u8

  • flv

  • mp4

  • cmaf

m3u8

TranscodeTemplates

array

No

kelompok Templat Transkoding untuk Catatan aliran yang telah dikodekan ulang.

sd

string

No

  • Templat Transkoding untuk Catatan aliran yang telah dikodekan ulang. Anda dapat menentukan beberapa Templat, hingga 10.

  • Saat mengonfigurasi TranscodeRecordFormat.N.xxx, Anda harus menentukan setidaknya satu parameter TranscodeTemplates.

  • Untuk merekam beberapa atau semua aliran yang telah dikodekan ulang, Anda dapat mengatur TranscodeTemplates.1 hingga *****.

Catatan

Anda tidak dapat menentukan raw untuk TranscodeTemplates karena merupakan pengenal yang dicadangkan.
RepeatList merujuk ke N dalam TranscodeTemplates.N, yang dapat dipahami sebagai urutan bertambah untuk beberapa pengaturan. Contoh: TranscodeTemplates.1=sd dan TranscodeTemplates.2=hd.

sd

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

16A96B9A-F203-4EC5-8E43-CB92E68F****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidOssEndpoint.Malformed %s
400 InvalidOssBucket.Malformed Specified parameter OssBucket is not valid. Parameter OSSBucket tidak valid. Periksa apakah parameter Bucket OSS benar.
400 InvalidOssBucket.NotFound The parameter OssBucket does not exist.
400 InvalidFormat.Malformed Specified parameter Format is not valid. Parameter Format tidak valid. Periksa apakah parameter Format benar.
400 InvalidCycleDuration.Malformed Specified CycleDuration Format is not valid. Format parameter CycleDuration tidak valid. Periksa apakah format parameter CycleDuration benar.
400 InvalidSliceDuration.Malformed Specified SliceDuration Format is not valid. Parameter SliceDuration yang ditentukan tidak valid.
400 InvalidTemplateLength.Malformed Specified record template length is not valid.
400 InvalidTemplate.ForbidRaw Template named raw is Forbidden.
400 MissingTemplate Template is mandatory for this action. Pengaturan parameter template transkoding tidak ada.
400 MissingOssObjectPrefix OssObjectPrefix is mandatory for this action.
400 MissingSliceOssObjectPrefix SliceOssObjectPrefix is mandatory for this action.
400 InvalidOssObjectPrefix.Malformed Specified parameter OssObjectPrefix is not valid.
400 InvalidSliceOssObjectPrefix.Malformed Specified parameter SliceOssObjectPrefix is not valid. Parameter SliceOssObjectPrefix tidak valid. Periksa apakah parameter SliceOssObjectPrefix benar.
400 ConfigAlreadyExists Config has already exist.
400 InvalidFormat.IllegalOperation Specified parameter Format can not be multiple.
400 InvalidDelayTime Specified Delaytime is invalid.
400 Live2Vod.ConfigAlreadyExists Had live2vod record config already.
400 InvalidStartTime.Malformed Specified StartTime is malformed.
400 InvalidEndTime.Malformed Specified EndTime is malformed.
400 InvalidEndTime.Mismatch Specified EndTime does not math the specified StartTime or current time.
400 InvalidStartTime.Mismatch Specified StartTime does not math the current time.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.