Tüm Ürünler
Search

Bu Ürün

    :DescribeCasterProgram

    Belge Merkezi

    :DescribeCasterProgram

    Son Güncelleme:Sep 29, 2026

    Bir yapım stüdyosunun program listesini sorgular.

    Operation description

    Bir yapım stüdyosunun program listesini sorgulamak için bu işlemi çağırabilirsiniz. Bu işlem, video kaynağı ve bileşen düğümlerini destekler.

    QPS sınırları

    Tek bir kullanıcı için saniyedeki sorgu (QPS) sınırı saniyede 4 çağrıdır. Sınır aşılırsa API çağrıları kısıtlanır. Bu durum işinizi etkileyebilir. Çağrılarınızı buna göre planlayın.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    live:DescribeCasterProgram

    get

    *Caster

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

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    Bölge kimliği.

    cn-shanghai
    CasterId

    string

    Yes

    Yapım stüdyosunun kimliği.

    • CreateCaster işlemini çağırarak bir yapım stüdyosu oluşturursanız, yanıtta döndürülen CasterId değerini kullanın.

    • LIVE konsolunda bir yapım stüdyosu oluşturursanız, kimliği Bulut Yapım Stüdyosu sayfasında bulabilirsiniz. Bu sayfaya gitmek için LIVE > Yapım Stüdyosu > Bulut Yapım Stüdyosu yolunu izleyin.

    Not

    Bulut Yapım Stüdyosu sayfasındaki listede yer alan yapım stüdyosunun adı, onun kimliğidir.

    LIVEPRODUCER_POST-cn-0pp1czt****
    EpisodeId

    string

    No

    Program kimliği.

    1872639A-F203-4EC5-8E43-CB92E68F****
    EpisodeType

    string

    No

    Düğüm türü. Geçerli değerler:

    • Resource: video kaynağı.

    • Component: bileşen.

    Resource
    StartTime

    string

    No

    Başlangıç zamanı. Zaman yyyy-MM-ddTHH:mm:ssZ biçiminde ve UTC olmalıdır.

    2016-06-29T09:00:00Z
    EndTime

    string

    No

    Bitiş zamanı. Zaman yyyy-MM-ddTHH:mm:ssZ biçiminde ve UTC olmalıdır.

    2016-06-29T10:00:00Z
    PageNum

    integer

    No

    Sayfa numarası.

    5
    PageSize

    integer

    No

    Her sayfadaki program sayısı.

    10
    Status

    integer

    No

    Programın durumu. Geçerli değerler:

    • 0: başlatılmadı

    • 1: oynatılıyor

    • 2: tamamlandı

    0

    Response elements

    Element

    Type

    Description

    Example

    object

    CasterId

    string

    Yapım stüdyosunun kimliği.

    LIVEPRODUCER_POST-cn-0pp1czt****
    Episodes

    object

    Episode

    array<object>

    Düğümler.

    array<object>

    Bir düğüm.

    ComponentIds

    object

    ComponentId

    array

    Bileşen kimlikleri.

    string

    Bir bileşen kimliği.

    ["1872639A-F203-4EC5-8E43-CB929282****" ]
    EndTime

    string

    Bitiş zamanı. Zaman yyyy-MM-ddTHH:mm:ssZ biçiminde ve UTC'dir.

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

    string

    Program kimliği.

    1872639A-F203-4EC5-8E43-CB92E68F****
    EpisodeName

    string

    Programın adı.

    program_name_1
    EpisodeType

    string

    Düğüm türü. Geçerli değerler:

    • Resource: video kaynağı.

    • Component: bileşen.

    Resource
    ResourceId

    string

    Video kaynağının kimliği.

    1872639A-F203-4EC5-8E43-CB92E837****
    StartTime

    string

    Başlangıç zamanı. Zaman yyyy-MM-ddTHH:mm:ssZ biçiminde ve UTC'dir.

    2016-06-29T09:00:00Z
    Status

    integer

    Programın durumu.

    0
    SwitchType

    string

    Geçiş politikası. Geçerli değerler:

    • TimeFirst: zaman öncelikli. Canlı programlar yalnızca bu politikayı kullanabilir.

    • ContentFirst: içerik öncelikli.

    TimeFirst
    ProgramEffect

    integer

    Program listesinin etkinleştirilip etkinleştirilmediğini gösterir.

    • 0: devre dışı

    • 1: etkin

    1
    ProgramName

    string

    Program listesinin adı.

    programs_name
    RequestId

    string

    İstek kimliği.

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

    integer

    Döndürülen toplam giriş sayısı.

    1

    Examples

    Success response

    JSON format

    {
  "CasterId": "LIVEPRODUCER_POST-cn-0pp1czt****",
  "Episodes": {
    "Episode": [
      {
        "ComponentIds": {
          "ComponentId": [
            "[\"1872639A-F203-4EC5-8E43-CB929282****\" ]"
          ]
        },
        "EndTime": "2016-06-29T10:02:00Z",
        "EpisodeId": "1872639A-F203-4EC5-8E43-CB92E68F****",
        "EpisodeName": "program_name_1",
        "EpisodeType": "Resource",
        "ResourceId": "1872639A-F203-4EC5-8E43-CB92E837****",
        "StartTime": "2016-06-29T09:00:00Z",
        "Status": 0,
        "SwitchType": "TimeFirst"
      }
    ]
  },
  "ProgramEffect": 1,
  "ProgramName": "programs_name",
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  "Total": 1
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidPageSize.Malformed %s, please check and try again later. The parameter PageSize is invalid, please check and try again.
    400 InvalidPageNum.Malformed %s, please check and try again later. The parameter PageNum is invalid, please check and try again.
    400 InvalidParameter.Malformed There are invalid parameters: %s. There are invalid parameters: %s.
    400 InvalidCasterId.Malformed %s, please check and try again later. The parameter CasterId is invalid, please check and try again.
    500 InternalError %s, please try again later. Internal error, please try again later.
    500 InvalidParameter.Status %s, please check and try again later. Parameter Status is invalid, please check and try again.
    404 InvalidCaster.NotFound %s, please check and try again later. The guide station does not exist, please check and try again.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.