Tüm Ürünler
Search

Bu Ürün

    :CreateLivePullToPush

    Belge Merkezi

    :CreateLivePullToPush

    Son Güncelleme:Sep 29, 2026

    CreateLivePullToPush çağrısı yaparak bir akış çekme ve gönderme görevi oluşturur.

    Operation description

    Önemli Akış çekme ve gönderme ücretli bir özelliktir. Faturalandırma resmi olarak 5 Aralık 2025 tarihinde saat 00:00'da başlayacaktır.

    • Faturalandırma ayrıntıları için Akış çekme ve gönderme ücretleri sayfasına bakın.

    • Bir akış çekme ve gönderme görevi oluşturmak için bu işlemi çağırın.

    • Canlı akış çekme görevi veya isteğe bağlı video akış çekme görevi oluşturabilirsiniz.

    • Görev oluşturulduktan sonra, belirtilen başlangıç zamanında çalışmaya başlar ve belirtilen bitiş zamanında otomatik olarak durur ve silinir.

    • Görevde belirtilen hedef akış alma URL'sinin diğer görevler tarafından kullanılmadığından emin olun. Aksi takdirde, birden fazla görev aynı anda aynı URL'ye akış gönderdiği için akış alma işlemi başarısız olur.

    • Akış çekme ve gönderme olaylarına ilişkin geri çağırmalar, görev çalıştırma durumu değişikliği geri çağırmalarını ve görev çıkış geri çağırmalarını içerir. Daha fazla bilgi için Akış çekme ve gönderme olay geri çağırmaları sayfasına bakın.

    QPS limiti

    Bu işlem için tek kullanıcılık QPS limiti saniyede 10 çağrıdır. Limit aşılırsa API çağrıları kısıtlanır ve bu durum işinizi etkileyebilir. Bu işlemi uygun şekilde çağırı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:CreateLivePullToPush

    create

    *All Resource

    *

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    Bölge kimliği.

    cn-beijing
    Region

    string

    Yes

    Görevin başlatıldığı bölge. Geçerli değerler:

    • ap-southeast-1 (Singapur)

    • ap-southeast-5 (Endonezya)

    • cn-beijing (Pekin)

    • cn-shanghai (Şanghay)

    • cn-shenzhen (Shenzhen)

    Valid values:

    • cn-shenzhen :

      Shenzhen.

    • cn-qingdao :

      Qingdao.

    • preregion :

      Ön sürüm.

    • cn-beijing :

      Pekin.

    • cn-shanghai :

      Şanghay.

    • ap-southeast-1 :

      Singapur.

    • eu-central-1 :

      Almanya (Frankfurt)

    • ap-northeast-1 :

      Japonya (Tokyo)

    • ap-southeast-5 :

      Endonezya.

    • me-central-1 :

      Suudi Arabistan (Riyad)

    cn-shanghai
    TaskName

    string

    No

    Bulanık eşleştirmeyi destekleyen görev adı. Varsayılan değer: "".

    test
    StartTime

    string

    Yes

    Görevin başlangıç zamanı.

    Not

    • Biçim: yyyy-MM-ddTHH:mm:ssZ (UTC).

    2024-08-26T10:30:00Z
    EndTime

    string

    Yes

    Görevin bitiş zamanı.

    Not

    • Biçim: yyyy-MM-ddTHH:mm:ssZ (UTC).

    • EndTime, StartTime değerinden sonra olmalıdır.

    • EndTime, geçerli zamandan sonra olmalıdır.

    2024-08-27T14:30:00Z
    SourceType

    string

    Yes

    Kaynak akış türü. Geçerli değerler:

    • live: canlı akış.

    • vod: ApsaraVideo VOD kaynağı.

    • url: üçüncü taraf video dosyası kaynağı.

    Valid values:

    • vod :

      ApsaraVideo VOD kaynağı.

    • live :

      Canlı akış.

    • url :

      Üçüncü taraf video dosyası kaynağı.

    live
    SourceProtocol

    string

    No

    Kaynak akış protokolü.

    Geçerli değerler:

    • rtmp

    • srt

    • http-flv

    • hls

    Not

    Bu parametre yalnızca SourceType live olarak ayarlandığında gereklidir. SourceType vod veya url olarak ayarlandığında bu parametre etkili olmaz.

    rtmp
    SourceUrls

    array

    Yes

    Kaynak akış URL'lerinin listesi.

    Not

    • live türü için yalnızca bir eksiksiz canlı akış URL'si desteklenir.

    • vod ve url türleri için en fazla 30 URL desteklenir.

    • live türü rtmp, srt ve http-flv protokollerini destekler.

    • vod türü için ApsaraVideo VOD medya varlığı kimliklerini belirtin.

    • url türü mp4 ve http-flv protokollerini destekler.

    string

    No

    Kaynak akış URL'si.

    Not

    • live türü için yalnızca bir eksiksiz canlı akış URL'si desteklenir.

    • vod ve url türleri için en fazla 30 URL desteklenir.

    • live türü rtmp, srt ve http-flv protokollerini destekler.

    • vod türü için ApsaraVideo VOD medya varlığı kimliklerini belirtin.

    • url türü mp4 ve http-flv protokollerini destekler.

    rtmp://pulltest.****.aliyunlive.com/pulltest493/pulltest-w434
    DstUrl

    string

    Yes

    Hedef akış alma URL'si.

    Not

    • rtmp protokolü desteklenir.

    • Maksimum uzunluk 2000 karakterdir.

    rtmp://pushtest.********.aliyunlive.com/pulltest493/pulltest-w434
    RepeatNumber

    integer

    No

    Oynatma listesi bittikten sonra oynatmanın tekrarlanma sayısı. Geçerli değerler:

    • 0 (varsayılan): tekrar yok.

    • -1: süresiz döngü.

    • Diğer pozitif tam sayılar: oynatmanın tekrarlanma sayısı.

    Not

    Bu parametre yalnızca isteğe bağlı video veya üçüncü taraf video akışları için geçerlidir.

    0
    FileIndex

    integer

    No

    Dosya indeksi. Oynatma n'inci dosyadan başlar.

    0
    Offset

    integer

    No

    Video dosyasının başlangıcından itibaren başlangıç ofseti. Birim: saniye. Değer 0'dan büyük olmalıdır.

    Not

    • Okumaya başlama konumu olarak ilk kareden itibaren olan ofseti belirtir (ilk video için).

    • Bu parametre yalnızca isteğe bağlı video veya üçüncü taraf video akışları için geçerlidir.

    2
    CallbackUrl

    string

    No

    HTTP geri çağırma URL'si. Varsayılan değer: boş.

    Not

    • Görevle ilgili geri çağırmaları alan URL.

    • Maksimum uzunluk 2000 karakterdir.

    • Bu parametre belirtilmezse, görev olayları geri çağırmalar aracılığıyla gönderilmez.

    https://callback*****.com
    RetryInterval

    integer

    No

    Yeniden deneme aralığı. Birim: saniye. Geçerli değerler: 60 ile 300 arası. Varsayılan değer: 60.

    60
    RetryCount

    integer

    No

    Yeniden deneme sayısı. Varsayılan değer: 3.

    3
    ReqAuth

    string

    No

    Geri çağırmalara kimlik doğrulamasının eklenip eklenmeyeceğini belirtir.

    no
    AuthKey

    string

    No

    Kimlik doğrulama anahtarı. Anahtar 16 ila 64 karakter uzunluğunda olmalı ve yalnızca yazdırılabilir ASCII karakterleri (0x21-0x7e) içerebilir. Anahtar, geri çağırmalar alınırken geri çağırma kaynağını doğrulamak için kullanılabilir.

    abcd
    NotifyItemSwitch

    string

    No

    Canlı olmayan akış çekme ve gönderme görevleri sırasında oynatma listesi değiştiğinde geri çağırma alınıp alınmayacağını belirtir.

    off

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt şeması.

    RequestId

    string

    İstek kimliği.

    16A96B9A-F203-4EC5-8E43-CB92E68*****
    RetCode

    integer

    Dönüş kodu.

    Not

    • Çağrı başarılıysa "0" değeri döndürülür.

    • İstisnalar için aşağıda listelenen hata kodlarına bakın.

    0
    Description

    string

    Hata açıklaması.

    OK
    TaskId

    string

    Görev kimliği.

    fd245384-4067-4f91-9d75-9666a6bc9****

    Examples

    Success response

    JSON format

    {
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK",
  "TaskId": "fd245384-4067-4f91-9d75-9666a6bc9****"
}

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidParameter %s.
    400 InvalidParam.CodeIllegalDuration %s.
    400 CodeInvalidAliUid This aliuid does not have a live domain name.
    400 CodeNotEnoughResource Exceeded configuration limits or insufficient resources.
    400 CodeConfigAlreadyExists Code Config Already Exists
    500 InternalError %s.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.