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
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
live:AddLiveAppRecordConfig |
create |
*Domain.
|
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:
|
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.
|
record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence} |
| CycleDuration |
integer |
No |
Panjang Catatan periodik. Unit: seconds. Catatan
|
1 |
| OssObjectPrefix |
string |
No |
Nama file Catatan yang disimpan di OSS.
|
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 |
| 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.
|
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.
|
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 |
| TranscodeTemplates |
array |
No |
kelompok Templat Transkoding untuk Catatan aliran yang telah dikodekan ulang. |
sd |
|
string |
No |
Catatan
Anda tidak dapat menentukan |
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.