Share via

IngestManifest

  • Artikel

IngestManifest mewakili sekumpulan aset yang akan dibuat melalui penyerapan massal bersama dengan file aset terkait. Penyerapan massal memungkinkan Anda memisahkan proses pengunggahan file dari pembuatan aset. Akibatnya, metode unggah file berkinerja tinggi dapat digunakan untuk set file besar selama pembuatan aset. Setelah IngestManifestAssets dibuat, bersama dengan IngestManifestFiles terkait, Microsoft Azure Media Services mengawasi kontainer penyimpanan Blob yang terkait dengan IngestManifest melalui properti BlobStorageUriForUpload. Saat setiap unggahan file ke kontainer penyimpanan Blob selesai, Microsoft Azure Media Services menyelesaikan aset baru untuk masing-masing IngestManifestAsset yang berisi file tersebut.

Artikel ini memberikan gambaran IngestManifest umum tentang entitas dan juga menunjukkan cara menjalankan berbagai operasi dengan REST API Media Services.

Penting

Saat mengakses entitas di Media Services, Anda harus menetapkan bidang dan nilai header tertentu dalam permintaan HTTP Anda.
Untuk informasi selengkapnya, lihat Penyiapan untuk Pengembangan REST API Media Services dan Menyambungkan ke Media Services dengan MEDIA Services REST API.

Catatan

Setiap IngestManifestAssetFile yang terkait dengan IngestManifest harus memiliki nama file unik dalam manifes.

Properti Entitas IngestManifest

Properti Jenis Deskripsi
Id

Baca-saja. Diatur oleh Media Services pada waktu pembuatan.		 Edm.String Pengidentifikasi unik.
Created

Baca-saja. Diatur oleh Media Services pada waktu pembuatan.		 Edm.DateTime Mewakili jumlah milidetik sejak tengah malam 1 Jan 1970.
LastModified

Baca-saja. Diatur oleh Media Services.		 Edm.DateTime Nilai ini diperbarui oleh Media Services setelah perubahan properti dibuat. Ini menunjukkan jumlah milidetik sejak tengah malam 1 Jan 1970.
Name

Pilihan.		 Edm.String Nama yang mudah diingat untuk IngestManifest Anda.
State

Baca-saja. Diatur oleh Media Services.		 Edm.Int32 Status manifes saat ini. Nilai ini bisa menjadi salah satu dari yang berikut ini:

- Tidak aktif = 0: Tidak ada pembuatan aset yang tertunda yang tersisa. Semua telah selesai atau mengalami kesalahan.
- Mengaktifkan = 1: Manifes belum siap untuk menerima file yang diunggah ke kontainer Blob.
- Aktif = 2: Ada pembuatan IngestManifestAssets yang tertunda dan kontainer Blob sedang dipantau.
BlobStorageUriForUpload

Baca-saja. Diatur oleh Media Services.		 Edm.String Nilai ini ditetapkan oleh Media Services. Nilai ini menentukan Uri kontainer penyimpanan Blob, yang menerima unggahan file yang diperlukan untuk menyelesaikan IngestManifestAssets.
Statistics

Baca-saja. Diatur oleh Media Services.		 IngestManifestStatistics Jenis kompleks ini berisi informasi statistik untuk membantu menentukan kemajuan pembuatan IngestManifestAssets saat ini berdasarkan semua file aset yang terkait dengan manifes.
IngestManifestAssets

Baca-saja. Diatur oleh Media Services.		 Set entitas IngestManifestAsset Properti navigasi yang dapat diakses dengan mereferensikan nilai IngestManifestAsset by Id tertentu. Kumpulan entitas yang dikembalikan berisi semua IngestManifestAssets yang terkandung dalam IngestManifest.
PendingIngestManifestAssets

Baca-saja. Diatur oleh Media Services.		 Set entitas IngestManifestAsset Properti navigasi yang dapat diakses dengan mereferensikan nilai IngestManifestAsset by Id tertentu. Kumpulan entitas yang dikembalikan berisi semua unggahan file atau pembuatan aset yang tertunda IngestManifestAssets.
StorageAccountName

Pilihan. Tidak dapat diperbarui setelah entitas dibuat.		 Edm.String Nama akun penyimpanan yang berisi kontainer blob tempat file diunggah.

Jika tidak ditentukan pada waktu pembuatan, Media Services menetapkan nama akun penyimpanan default.

IngestManifestAsset.Asset harus menggunakan akun penyimpanan yang sama seperti yang ditentukan dalam IngestManifest.
StorageAccount

Baca-saja. Diatur oleh Media Services.		 Kumpulan entitas StorageAccount. Kumpulan entitas yang dikembalikan berisi semua entitas StorageAccount yang ditautkan ke Aset yang ditentukan.

Membuat IngestManifest

IngestManifests dapat dibuat dengan menggunakan permintaan HTTP POST dan meneruskan isi permintaan yang berisi nama IngestManifest baru.

Metode Meminta URI Versi HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> HTTP/1.1

Permintaan Sampel

Untuk mendapatkan yang terbaru x-ms-version:, lihat Media Services REST.

POST https:// media.windows.net/API/IngestManifests HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>   
Host: media.windows.net  
Content-Length: 36  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestREST" }

Mencantumkan IngestManifest

IngestManifests dapat diambil menggunakan permintaan HTTP GET. Anda dapat meminta manifes penyerapan dengan Id-nya atau meminta semua manifes.

Metode Meminta URI Versi HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> HTTP/1.1
GET <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Permintaan Sampel

Untuk mendapatkan yang terbaru x-ms-version:, lihat Media Services REST.

GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifests('nb:mid:UUID:a2f9a230-831e-5e40-bafa-fbf8decbee26') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Memperbarui IngestManifest

IngestManifests dapat diperbarui dengan mereferensikan Id IngestManifest dengan permintaan HTTP MERGE. Isi permintaan berisi properti yang akan diperbarui.

Metode Meminta URI Versi HTTP
MERGE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Permintaan Sampel

Untuk mendapatkan yang terbaru x-ms-version:, lihat Media Services REST.

MERGE https:// media.windows.net /API/IngestManifests('nb:mid:UUID:076faa09-8f5d-ce41-9de3-32ba66190271') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 43  
Expect: 100-continue  
  
{ "Name" : "ExampleManifestUpdated" }

Menghapus Manifes Penyerapan

IngestManifests dapat dihapus dengan mereferensikan nilai Id IngestManifest dengan permintaan HTTP DELETE.

Metode Meminta URI Versi HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest Id') HTTP/1.1

Permintaan Sampel

Untuk mendapatkan yang terbaru x-ms-version:, lihat Media Services REST.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifests('nb:mid:UUID:45ea3cd0-b3cf-994b-8e4d-03c9620c22da') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Lihat juga

AccessPolicy
AssetFile
Aset
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
Tugas
JobTemplate
Locator
MediaProcessor
Tugas
TaskTemplate
Kuota dan Keterbatasan