All Products
Search

This Product

    ApsaraVideo Live:CreateCaster

    Document Center

    ApsaraVideo Live:CreateCaster

    Last Updated:Jun 10, 2026

    Memanggil operasi CreateCaster untuk membuat studio produksi.

    Deskripsi operasi

    You must activate ApsaraVideo Live before you call this operation. For more information, see Activate ApsaraVideo Live. This operation supports the following types of production studios: Standard and New Playlist (Carousel).

    QPS limit

    The queries per second (QPS) limit for this operation is 10 calls per second per user. If you exceed this limit, API calls are throttled, which may affect your business. We recommend that you call this operation at a reasonable rate.

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

    create

    *Caster

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-beijing
    CasterName

    string

    No

    Nama studio produksi.

    liveCaster****
    ClientToken

    string

    Yes

    Token Klien yang digunakan untuk memastikan idempotensi permintaan.

    Buat token di Klien Anda dan pastikan token unik di antara permintaan yang berbeda. Token dapat memiliki panjang hingga 64 karakter ASCII.

    53200b81-b761-4c10-842a-a0726d97****
    NormType

    integer

    Yes

    Tipe studio produksi. Nilai valid:

    • 1: Jenis Penyimpanan Standar.

    • 6: Carousel (New Playlist).

    .

    1
    ChargeType

    string

    Yes

    Metode penagihan. Hanya PostPaid yang didukung. Nilai valid:

    • PrePaid: langganan (tidak didukung).

    • PostPaid: pay-as-you-go.

    PostPaid
    PurchaseTime

    string

    No

    Pengatur waktu pembelian studio produksi. Pengatur waktu dalam format `yyyy-MM-ddTHH:mm:ssZ` dan ditampilkan dalam UTC.

    Catatan

    Parameter ini tersedia hanya jika Anda mengatur ChargeType ke PrePaid.

    2017-08-20T12:10:10Z
    ExpireTime

    string

    No

    Pengatur waktu kedaluwarsa studio produksi. Pengatur waktu dalam format `yyyy-MM-ddTHH:mm:ssZ` dan ditampilkan dalam UTC.

    Catatan

    Parameter ini tersedia hanya jika Anda mengatur ChargeType ke PrePaid.

    2017-08-22T12:10:10Z
    CasterTemplate

    string

    No

    Resolusi prasetel studio produksi. Parameter ini tersedia hanya untuk metode penagihan langganan. Nilai valid:

    • lp_ld: definisi rendah.

    • lp_sd: definisi standar.

    • lp_hd: definisi tinggi.

    • lp_ud: definisi ultra-tinggi.

    • lp_ld_v: definisi rendah vertikal.

    • lp_sd_v: definisi standar vertikal.

    • lp_hd_v: definisi tinggi vertikal.

    • lp_ud_v: definisi ultra-tinggi vertikal.

    Catatan

    Jika Anda menggunakan metode penagihan pay-as-you-go, panggil operasi SetCasterConfig untuk mengatur resolusi.

    lp_sd
    ResourceGroupId

    string

    No

    ID kelompok sumber daya. Untuk informasi selengkapnya, lihat Apa itu kelompok sumber daya?.

    rg-aekzw******
    Tag

    array<object>

    No

    Tag.

    object

    No

    The tags.

    Key

    string

    No

    The tag key.

    TestKey
    Value

    string

    No

    The tag value.

    TestValue

    Elemen respons

    Element

    Type

    Description

    Example

    object

    CasterId

    string

    The ID of the production studio. You can use this ID as a request parameter to query stream URLs, start the production studio, add video resources, add layouts, query the layout list, add components, and add playlists.

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

    string

    The request ID.

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

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter.PurchaseTime %s, please check and try again later.
    400 InvalidParameter.ExpireTime %s, please check and try again later.
    400 MissingParameter %s.
    400 InvalidChargeType.Malformed %s, please check and try again later.
    400 InvalidChargeType.PostSupport %s, please check and try again later.
    400 InvalidCasterTemplate.Malformed %s, please check and try again later.
    400 InvalidParameter.Malformed There are invalid parameters: %s.
    400 InvalidParameter.ChargeType %s, please check and try again later.
    400 InvalidPeriod.Malformed %s, please check and try again later.
    400 InvalidUserId.Malformed %s, please check userId.
    400 InvalidClientToken.Malformed %s, please check and try again later.
    400 IncorrectCasterStatus %s, please check and try again later.
    401 CasterNumberExceed %s, please check and try again later.
    403 PermissionDenied %s, please check and try again later.
    404 InvalidParameter.NormType %s, please check and try again later.
    404 InvalidConfiguration.NotFound %s, please check and try again later.
    408 CreateCaster.Timeout %s, please try again later.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.