All Products
Search

This Product

    ApsaraVideo VOD:GetVideoPlayAuth

    Document Center

    ApsaraVideo VOD:GetVideoPlayAuth

    Last Updated:Jun 10, 2026

    Memperoleh kredensial pemutaran (PlayAuth) untuk file audio atau video. SDK Pemutar Video Apsara menggunakan kredensial ini untuk secara otomatis mengambil URL pemutaran. Kredensial terikat pengatur waktu dan spesifik per file—jangan gunakan ulang antar file. Kredensial yang kedaluwarsa atau tidak valid menyebabkan kegagalan pemutaran. Gunakan metode ini untuk skenario pemutaran berkeamanan tinggi.

    Deskripsi operasi

    • If you use PlayAuth for playback, you must use the ApsaraVideo Player SDK. Call this operation to obtain a playback credential, which the SDK uses to automatically retrieve the playback URL. For more information, see ApsaraVideo Player SDK.

    • If a playback credential expires, you cannot retrieve the playback URL. You must obtain a new credential.

    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

    vod:GetVideoPlayAuth

    get

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    VideoId

    string

    No

    ID file audio atau video. Anda hanya dapat menentukan satu ID. Anda dapat memperoleh ID dengan salah satu cara berikut:

    • Masuk ke Konsol VOD. Di panel navigasi, pilih Media Assets > Audio/Video untuk Tampilan ID file.

    • Panggil operasi CreateUploadVideo untuk mengunggah file. Nilai parameter VideoId di tanggapan adalah ID file.

    • Setelah file diunggah, panggil operasi SearchMedia untuk mengkueri ID file. Nilai parameter VideoId di tanggapan adalah ID file.

    dfde02284a5c46622a097adaf44a****
    AuthInfoTimeout

    integer

    No

    Pengatur waktu time-to-live (TTL) kredensial pemutaran, dalam detik. Jika kredensial kedaluwarsa, Anda tidak dapat memperoleh URL pemutaran. Peroleh kredensial baru.

    • Nilai default: 100.

    • Nilai valid: [100,3000].

    100
    ApiVersion

    string

    No

    Versi API. Atur nilainya ke 1.0.0.

    1.0.0
    ReferenceId

    string

    No

    ID khusus yang terdiri dari 6 hingga 64 karakter. ID dapat berisi huruf, angka, tanda hubung (-), dan garis bawah (_). ID harus unik untuk setiap pengguna.

    123-123

    Elemen respons

    Element

    Type

    Description

    Example

    object

    The returned result.

    PlayAuth

    string

    The playback credential for the audio or video file.

    sstyYuew6789000000xtt7TYUh****
    RequestId

    string

    The request ID.

    E4EBD2BF-5EB0-4476-8829-9D94E1B1****
    VideoMeta

    object

    The metadata of the audio or video file.

    Status

    string

    The status of the audio or video file. For more information about the valid values and descriptions, see Status of an audio or video file.

    Normal
    Duration

    number

    The duration of the audio or video file, in seconds.

    120.0
    Title

    string

    The title of the audio or video file.

    Alibaba Cloud VOD Video Title
    VideoId

    string

    The ID of the audio or video file.

    dfde02284a5c46622a097adaf44a****
    CoverURL

    string

    The URL of the thumbnail of the audio or video file.

    https://example.aliyundoc.com/****.jpg

    Contoh

    Respons sukses

    JSONformat

    {
  "PlayAuth": "sstyYuew6789000000xtt7TYUh****",
  "RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B1****",
  "VideoMeta": {
    "Status": "Normal",
    "Duration": 120,
    "Title": "Alibaba Cloud VOD Video Title",
    "VideoId": "dfde02284a5c46622a097adaf44a****",
    "CoverURL": "https://example.aliyundoc.com/****.jpg"
  }
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.