IngestManifest
IngestManifest는 연결된 자산 파일과 함께 대량 수집을 통해 생성되는 자산 집합을 나타냅니다. 대량 수집을 사용하면 파일 업로드 프로세스를 자산 생성과 분리할 수 있습니다. 따라서 자산을 만드는 동안 대용량 파일 집합에 고성능 파일 업로드 메서드를 사용할 수 있습니다. IngestManifestAssets가 만들어지면 연결된 IngestManifestFiles와 함께 Microsoft Azure Media Services BlobStorageUriForUpload 속성을 통해 IngestManifest와 연결된 Blob Storage 컨테이너를 감시합니다. Blob Storage 컨테이너에 대한 각 파일 업로드가 완료되면 Microsoft Azure Media Services 해당 파일이 포함된 각 IngestManifestAsset에 대한 새 자산을 완료합니다.
이 문서에서는 엔터티에 IngestManifest 대한 개요를 제공하고 Media Services REST API를 사용하여 다양한 작업을 실행하는 방법을 보여 줍니다.
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
참고
IngestManifest와 연결된 각 IngestManifestAssetFile에는 매니페스트에 고유한 파일 이름이 있어야 합니다.
IngestManifest 엔터티 속성
| 속성 | 형식 | 설명 |
|---|---|---|
Id읽기 전용입니다. 만들 때 Media Services에서 설정합니다. |
Edm.String | 고유 식별자입니다. |
Created읽기 전용입니다. 만들 때 Media Services에서 설정합니다. |
Edm.DateTime | 1970년 1월 1일 자정 이후의 시간을 밀리초 단위로 표시합니다. |
LastModified읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.DateTime | 이 값은 속성이 변경된 후 Media Services에 의해 업데이트됩니다. 1970년 1월 1일 자정 이후의 시간(밀리초)을 나타냅니다. |
Name선택 사항입니다. |
Edm.String | IngestManifest의 이름입니다. |
State읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.Int32 | 매니페스트의 현재 상태입니다. 이 값은 다음 중 하나일 수 있습니다. - 비활성 = 0: 보류 중인 자산 생성이 남아 있지 않습니다. 모두 완료되었거나 오류가 발생했습니다. - 활성화 = 1: 매니페스트가 아직 Blob 컨테이너에 업로드된 파일을 받을 준비가 되지 않았습니다. - 활성 = 2: 생성 보류 중인 IngestManifestAssets가 있으며 Blob 컨테이너가 모니터링되고 있습니다. |
BlobStorageUriForUpload읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 이 값은 미디어 서비스에 의해 설정됩니다. 이 값은 IngestManifestAssets를 완료하는 데 필요한 파일 업로드를 수신하는 Blob Storage 컨테이너의 URI를 지정합니다. |
Statistics읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
IngestManifestStatistics | 이 복합 형식에는 통계 정보가 들어 있어 매니페스트와 관련된 모든 자산 파일을 기반으로 IngestManifestAssets 생성의 현재 진행률을 결정하는 데 도움이 됩니다. |
IngestManifestAssets읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
IngestManifestAsset 엔터티 집합 | ID 값으로 특정 IngestManifestAsset을 참조하여 액세스할 수 있는 탐색 속성입니다. 반환되는 엔터티 집합에는 IngestManifest에 포함된 모든 IngestManifestAssets가 포함되어 있습니다. |
PendingIngestManifestAssets읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
IngestManifestAsset 엔터티 집합 | ID 값으로 특정 IngestManifestAsset을 참조하여 액세스할 수 있는 탐색 속성입니다. 반환되는 엔터티 집합에는 파일 업로드 또는 자산 생성이 보류 중인 모든 IngestManifestAsset이 포함되어 있습니다. |
StorageAccountName선택 사항입니다. 엔터티가 만들어진 후에는 업데이트할 수 없습니다. |
Edm.String | 파일이 업로드된 Blob 컨테이너가 포함된 저장소 계정 이름입니다. 만들 때 지정하지 않으면 Media Services에서 기본 스토리지 계정 이름을 설정합니다. IngestManifestAsset.Asset은 IngestManifest에서 지정된 것과 동일한 저장소 계정을 사용해야 합니다. |
StorageAccount읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
StorageAccount 엔터티 집합입니다. | 반환된 엔터티 집합에는 지정된 자산에 연결된 모든 StorageAccount 엔터티가 포함됩니다. |
IngestManifest 만들기
IngestManifests는 HTTP POST 요청을 사용하고 새 IngestManifest 이름이 포함된 요청 본문을 전달하여 만들 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests> | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 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" }
IngestManifest 나열
IngestManifests는 HTTP GET 요청을 사용하여 검색할 수 있습니다. ID별로 IngestManifest를 요청하거나 모든 매니페스트를 요청할 수 있습니다.
| 메서드 | 요청 URI | 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 |
샘플 요청
최신 x-ms-version:을 얻으려면 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
IngestManifest 업데이트
IngestManifest는 HTTP MERGE 요청으로 IngestManifest ID를 참조하여 업데이트할 수 있습니다. 요청 본문에는 업데이트할 속성이 포함되어 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| MERGE | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest ID') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 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" }
IngestManifest 삭제
HTTP DELETE 요청으로 IngestManifest ID 값을 참조하여 IngestManifests를 삭제할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifests>('IngestManifest ID') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 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
참고 항목
AccessPolicy
AssetFile
자산
ContentKey
IngestManifestAsset
IngestManifestFile
IngestManifestStatistics
작업
JobTemplate
로케이터
MediaProcessor
Task
TaskTemplate
할당량 및 제한 사항