IngestManifestFile
IngestManifestFile은 대량 수집의 일환으로 업로드할 실제 비디오 또는 오디오 Blob 개체를 나타냅니다. 대량 수집에 대한 자세한 내용은 REST API를 사용하여 대량으로 자산 수집을 참조하세요. IngestManifestFile은 항상 IngestManifest 및 IngestManifestAsset과 연결됩니다.
이 항목에서는 IngestManifestFile 엔터티에 대해 간략하게 설명하는 동시에 미디어 서비스 REST API를 사용하여 다양한 작업을 실행하는 방법도 보여 줍니다.
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
IngestManifestFile 엔터티 속성
| 속성 | 형식 | 설명 |
|---|---|---|
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의 BlobStorageUriForUpload 속성에서 참조하는 Blob 컨테이너에 업로드될 실제 파일 이름입니다. Media Services는 해당 컨테이너의 파일 업로드를 이름으로 감시합니다. 파일 이름을 비워 두거나 공백으로 지정하면 안 됩니다. IngestManifest 내에서 고유합니다. 최대 길이는 4000입니다. |
State읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.Int32 | IngestManifestFile의 현재 상태입니다. 이 값은 다음 중 하나일 수 있습니다. - 보류 중 = 0: 자산 만들기를 완료하기 위해 파일이 아직 업로드되지 않았습니다. Media Services가 파일 업로드를 대기 중입니다. - 완료 됨 = 1: 파일 업로드가 검색되고 연결된 자산이 업데이트되었습니다. - 오류 = 2: 이 파일을 처리하는 동안 오류가 발생했습니다. 오류 정보는 ErrorDetails 속성을 참조하세요. |
ParentIngestManifestId필수 요소. |
Edm.String | 이 파일이 포함된 매니페스트의 IngestManifest ID입니다. |
ParentIngestManifestAssetId필수 요소. |
Edm.String | 이 파일이 연결된 IngestManifestAsset의 IngestManifestAsset ID입니다. |
ErrorDetail읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 이 파일을 처리하는 도중 발생한 오류에 대한 세부 정보입니다. |
MimeType선택 사항입니다. |
Edm.String | 미디어 서비스는 업로드한 어떤 Blob도 검사하지 않으므로 mime 형식은 수동으로 설정해야 합니다. 예를 들어, "text/plain" 또는 "video/x-ms-wmv"가 사용하기에 유효한 값입니다. |
IsPrimary선택 사항입니다. |
Edm.Boolean | 이 IngestManifestFile이 다중 파일 Asset의 주 파일에 해당하는지 결정합니다. |
EncryptionVersion선택 사항입니다. |
Edm.String | 현재 지원되는 StorageEncryption, CommonEncryption 및 EnvelopeEncryption의 버전은 "1.0"입니다. |
EncryptionScheme선택 사항입니다. |
Edm.String | 이 파일에 사용되는 암호화 체계입니다. 유효한 값은 "StorageEncryption", "CommonEncryption" 또는 "EnvelopeEncryption"입니다. |
IsEncrypted선택 사항입니다. |
Edm.Boolean | 이 파일을 암호화하여 저장하려면 이 값을 true로 설정해야 합니다. |
EncryptionKeyId선택 사항입니다. |
Edm.String | 암호화된 ContentKey ID입니다. |
InitializationVector선택 사항입니다. |
Edm.String | 저장소 암호화에 사용되는 초기화 벡터입니다. |
IngestManifestFile 만들기
IngestManifestFile은 HTTP POST 요청을 사용하여 만들 수 있습니다. 새 IngestManifestFile의 Name 속성 이름과 함께 ParentIngestManifestId 및 ParentIngestManifestAssetId가 포함된 요청 본문을 전달해야 합니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
POST https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles 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: 200
Expect: 100-continue
{ "Name" : "REST_Example_File.wmv", "ParentIngestManifestId" : "nb:mid:UUID:bfe2d76c-17bd-884a-b9be-21bdfda65984", "ParentIngestManifestAssetId" : "nb:maid:UUID:9c6e7256-fefd-c541-aa69-fd04cf1cc1a6" }
IngestManifestFile 나열
IngestManifestFile은 HTTP GET 요청을 사용하여 검색할 수 있습니다. ID를 지정하여 해당 IngestManifestFile을 요청하거나 ID를 지정하지 않고 모든 IngestManifestFile을 요청할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles> | HTTP/1.1 |
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile Id') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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
IngestManifestFile 삭제
HTTP DELETE 요청으로 IngestManifestFile ID를 참조하여 IngestManifestFile을 삭제할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/IngestManifestFiles>('IngestManifestFile Id') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
DELETE https://<accountname>.restv2.<location>.media.azure.net/api/IngestManifestFiles('nb:mfid:UUID:030ef5ef-c5b3-2c4a-86da-217d4d2170de') 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
참고 항목
AssetFile
IngestManifest
IngestManifestAsset
IngestManifestStatistics
할당량 및 제한 사항