Tambahkan Daftar Program ke Studio Produksi dengan AddCasterProgram - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Menambahkan daftar program ke studio produksi.

Deskripsi operasi

Buat studio produksi dan tambahkan Sumber daya video ke dalamnya sebelum memanggil operasi ini untuk menambahkan daftar program. Operasi ini saat ini hanya mendukung dua tipe node: Sumber video dan Komponen. Untuk membuat studio produksi menggunakan Operasi API, lihat CreateCaster.

Batas QPS

Batas QPS per pengguna tunggal untuk operasi ini adalah 10 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

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:AddCasterProgram

create

*Caster.

acs:live:*:{#accountId}:caster/{#CasterId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
Episode	array<object>	Yes	Informasi daftar program.
	object	No	Informasi daftar program.
ComponentId	array	No	Daftar komponen. Elemen disusun dari bawah ke atas secara berurutan. Penting Parameter ini valid dan diperlukan ketika Episode.N.EpisodeType diatur ke Component. Ketika tipe node adalah Sumber daya, ini menunjukkan bahwa komponen terikat pada sumber video dan beralih secara sinkron.	[ "a2b8e671-2fe5-4642-a2ec-bf931826**", "a2b8e671-2fe5-4642-a2ec-28374657**"]
	string	No	ID komponen.	a2b8e671-2fe5-4642-a2ec-bf931826****
EndTime	string	No	Waktu selesai. Format: yyyy-MM-ddTHH:mm:ssZ (UTC). Parameter ini diperlukan. Jika tidak ditentukan, MissingParameter akan dikembalikan.	2016-06-29T10:02:00Z
EpisodeName	string	No	Nama program.	program_name_1
EpisodeType	string	No	Tipe node. Nilai valid: Sumber daya: sumber video. Jika Anda memilih Sumber daya, Anda juga harus mengatur parameter permintaan Episode.N.ResourceId dan Episode.N.SwitchType. Komponen: komponen. Jika Anda memilih Komponen, Anda juga harus mengatur parameter permintaan Episode.N.ComponentId.N. Catatan Ketika Sumber daya dipilih dan resource yang direferensikan berisi VodUrl (file video on-demand), EndTime - StartTime tidak boleh melebihi durasi pemutaran aktual (dalam detik) dari file VOD. Jika tidak, InvalidParameter.EndTime akan dikembalikan.	Resource
ResourceId	string	No	ID sumber video. Penting Parameter ini valid dan diperlukan ketika Episode.N.EpisodeType diatur ke Resource. Parameter ini tidak berlaku ketika Episode.N.EpisodeType diatur ke Component. Jika Anda menambahkan sumber video dengan memanggil operasi AddCasterVideoResource, periksa nilai ResourceId yang dikembalikan oleh operasi AddCasterVideoResource.	a2b8e671-2fe5-4642-a2ec-bf93880e****
StartTime	string	No	Waktu mulai. Format: yyyy-MM-ddTHH:mm:ssZ (UTC). Parameter ini diperlukan. Jika tidak ditentukan, MissingParameter akan dikembalikan.	2016-06-29T09:00:00Z
SwitchType	string	No	Kebijakan pengalihan. Nilai valid: Penting Parameter ini hanya valid ketika Episode.N.EpisodeType diatur ke Sumber daya. TimeFirst: pengatur waktu diutamakan. Sumber video live hanya dapat menggunakan kebijakan pengatur waktu diutamakan. ContentFirst: konten diutamakan.	TimeFirst
CasterId	string	Yes	ID studio produksi. Jika Anda membuat studio produksi dengan memanggil operasi CreateCaster, periksa nilai CasterId yang dikembalikan oleh operasi CreateCaster. Jika Anda membuat studio produksi di Konsol ApsaraVideo Live, navigasikan ke Konsol ApsaraVideo Live > Studio Produksi > Cloud Production Studio untuk Tampilan nama studio produksi. Catatan Nama studio produksi dalam daftar studio produksi pada halaman Cloud Production Studio adalah ID studio produksi.	LIVEPRODUCER_POST-cn-0pp1czt****

Catatan

N dalam parameter permintaan menunjukkan nomor urut. Misalnya:
Episode.N.EpisodeName menunjukkan nama program ke-N. Episode.1.EpisodeName menunjukkan nama program pertama, dan Episode.2.EpisodeName menunjukkan nama program kedua.

Elemen respons

Element	Type	Description	Example
	object
EpisodeIds	object
EpisodeId	array<object>	Daftar ID program. Urutan elemen dalam daftar konsisten dengan urutan program yang dimasukkan.
	object
EpisodeId	string	The program group ID. You can use this ID as a request parameter to modify the program list, query the program list, delete a program, or modify a program.	16A96B9A-F203-4EC5-8E43-CB92E68F****
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68F****

Contoh

Respons sukses

JSONformat

{
  "EpisodeIds": {
    "EpisodeId": [
      {
        "EpisodeId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
      }
    ]
  },
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s.	Parameter yang diperlukan hilang.
400	InvalidParameter.Malformed	There are invalid parameters: %s.	Parameter berikut tidak valid: %s.
400	SwitchTypeInvalid.Malformed	%s, please check and try again later.	Parameter SwitchType tidak valid. Periksa dan coba lagi.
400	IncorrectStartTime	%s, please check and try again later.	Parameter StartTime tidak valid. Periksa dan coba lagi.
400	IncorrectEndTime	%s, please check and try again later.	Parameter EndTime tidak valid. Periksa dan coba lagi.
400	EpisodeConflict.Malformed	%s, please check and try again later.	Terdapat konflik penjadwalan untuk show. Periksa dan coba lagi.
400	InvalidCasterId.Malformed	%s, please check and try again later.	Parameter CasterId tidak valid. Periksa parameter dan coba lagi.
400	InvalidParameter.EndTime	%s, please check and try again later.	Parameter EndTime tidak valid. Periksa dan coba lagi.
401	IllegalOperation	%s, please check and try again later.	Operasi tidak valid. Periksa permintaan dan coba lagi.
500	InternalError	%s, please try again later.	Terjadi error internal. Coba lagi nanti.
404	InvalidCaster.NotFound	%s, please check and try again later.	Studio produksi tidak ada. Periksa konfigurasi dan coba lagi.
404	InvalidResource.NotFound	%s, please check and try again later.	Sumber daya tidak ada. Periksa dan coba lagi.
404	InvalidComponent.NotFound	%s, please check and try again later.	Komponen yang akan dioperasikan tidak ada. Periksa dan coba lagi.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.