All Products
Search

This Product

    ApsaraVideo Live:ModifyCasterProgram

    Document Center

    ApsaraVideo Live:ModifyCasterProgram

    Last Updated:Jun 10, 2026

    Mengubah daftar program studio produksi.

    Deskripsi operasi

    You can call the AddCasterProgram operation to add a program list for a production studio. Then, you can call this operation to modify the program list. This operation supports programs of the video source and component types.

    QPS limit

    The queries per second (QPS) limit for a single user is 4 calls per second. If you exceed this limit, API calls are throttled, which may affect your business. Plan your calls accordingly.

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

    update

    *Domain

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-shanghai
    Episode

    array<object>

    Yes

    Informasi program dalam format tertentu.

    object

    No

    The program information.

    ComponentId

    array

    No

    The list of component IDs. The components are layered from bottom to top in the order they are listed. The components are switched in sync with the video source.

    • This parameter is required and takes effect only when the node type is Component.

    • If the node type is Resource, the components are attached to the video source and switched in sync.

    ["a2b8e671-2fe5-4642-a2ec-bf93888****" ]

    string

    No

    The list of component IDs. The components are layered from bottom to top in the order they are listed. The components are switched in sync with the video source.

    • This parameter is required and takes effect only when the node type is Component.

    • If the node type is Resource, the components are attached to the video source and switched in sync.

    ["a2b8e671-2fe5-4642-a2ec-bf93888****" ]
    EndTime

    string

    No

    The end time. The time is in UTC. The format is yyyy-MM-ddTHH:mm:ssZ.

    2016-06-29T10:04:00Z
    EpisodeId

    string

    No

    The program ID. If you add a program for the production studio by calling the AddCasterEpisode operation, use the value of the EpisodeId parameter that is returned in the response.

    a2b8e671-2fe5-4642-a2ec-bf938887****
    EpisodeName

    string

    No

    The program name.

    program_name_2
    EpisodeType

    string

    No

    The program type. Valid values:

    • Resource: video source.

    • Component: component.

    Resource
    ResourceId

    string

    No

    The ID of the video source. If you add a video source for the production studio by calling the AddCasterVideoResource operation, use the value of the ResourceId parameter that is returned in the response.

    a2b8e671-2fe5-4642-a2ec-bf938887****
    StartTime

    string

    No

    The start time. The time is in UTC. The format is yyyy-MM-ddTHH:mm:ssZ.

    2016-06-29T09:02:00Z
    SwitchType

    string

    No

    The switch policy. This parameter is valid only when the node type is Resource.

    • TimeFirst: time-first. This is the only valid policy for live stream video sources.

    • ContentFirst: content-first.

    TimeFirst
    CasterId

    string

    Yes

    ID studio produksi.

    • Jika Anda membuat studio produksi dengan memanggil operasi CreateCaster, gunakan nilai parameter CasterId yang dikembalikan dalam tanggapan.

    • Jika Anda membuat studio produksi di konsol ApsaraVideo Live, buka halaman Studio Produksi > Studio Produksi Cloud untuk Tampilan ID.

    Catatan

    Nama studio produksi pada daftar di halaman Studio Produksi Cloud adalah ID studio produksi.

    a2b8e671-2fe5-4642-a2ec-bf93880e****

    Permintaan harus menyertakan setidaknya satu properti Episode untuk menentukan konten program yang akan diubah.

    Catatan

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

    Elemen respons

    Element

    Type

    Description

    Example

    object

    CasterId

    string

    The ID of the production studio.

    a2b8e671-2fe5-4642-a2ec-bf93880e****
    RequestId

    string

    The request ID.

    16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

    Contoh

    Respons sukses

    JSONformat

    {
  "CasterId": "a2b8e671-2fe5-4642-a2ec-bf93880e****",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 MissingParameter %s.
    400 InvalidParameter.Malformed There are invalid parameters: %s.
    400 SwitchTypeInvalid.Malformed %s, please check and try again later.
    400 IncorrectStartTime %s, please check and try again later.
    400 IncorrectEndTime %s, please check and try again later.
    400 IncorrectEpisodeStatus %s, please check and try again later.
    400 EpisodeConflict.Malformed %s, please check and try again later.
    400 InvalidCasterId.Malformed %s, please check and try again later.
    401 IllegalOperation %s, please check and try again later.
    500 InternalError %s, please try again later.
    404 InvalidCaster.NotFound %s, please check and try again later.
    404 InvalidResource.NotFound %s, please check and try again later.
    404 InvalidEpisode.NotFound %s, please check and try again later.
    404 InvalidComponent.NotFound %s, please check and try again later.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.