AssetFile
AssetFile 엔터티는 Blob 컨테이너에 저장된 실제 비디오 또는 오디오 파일을 나타냅니다. 자산 파일은 항상 자산과 연결되며 자산에는 하나 이상의 파일이 포함될 수 있습니다. 자산 파일 개체가 blob 컨테이너의 디지털 파일과 연결되지 않은 경우 Media Services 인코더 작업을 하지 못합니다.
이 항목에서는 AssetFile 엔터티에 대해 간략하게 설명하는 동시에 미디어 서비스 REST API를 사용하여 다양한 작업을 실행하는 방법도 보여 줍니다.
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
AssetFile 엔터티 속성
| 속성 | 형식 | 설명 |
|---|---|---|
Id읽기 전용입니다. 만들 때 Media Services에서 설정합니다. |
Edm.String | 고유 식별자입니다. |
Name필수 사항입니다. |
Edm.String | AssetFile의 이름입니다. 기본값은 파일 업로드 중 사용한 파일 이름입니다. 최대 길이는 260입니다.
참고: Media Services는 스트리밍 콘텐츠에 대한 URL을 빌드할 때 속성 값을 Name 사용합니다(예: http://{AMSAccount}.origin.mediaservices.windows.net/{GUID}/{IAssetFile.Name}/streamingParameters). 이러한 이유로 백분율 인코딩은 허용되지 않습니다. Name 속성 값에는 !* '();:@&=+$,/?%#[]"와 같은 퍼센트 인코딩 예약 문자를 사용할 수 없습니다. 또한 ‘.’ 하나만 사용할 수 있습니다. 또한 파일 이름 확장명에는 ‘.’ 하나만 사용할 수 있습니다. |
ContentFileSize선택 사항입니다. |
Edm.Int64 | 콘텐츠의 AssetFile 크기(바이트)입니다. |
ParentAssetId필수 사항입니다. 엔터티가 만들어진 후에는 업데이트할 수 없습니다. |
Edm.String | 이 파일이 연결된 자산의 자산 ID입니다. |
EncryptionVersion선택 사항입니다. |
Edm.String | 현재 StorageEncryption 및 CommonEncryption 모두에 지원되는 버전은 "1.0"입니다. |
EncryptionScheme선택 사항입니다. |
Edm.String | 이 파일에 사용되는 암호화 체계입니다. 유효한 값은 "StorageEncryption" 또는 "CommonEncryption"입니다. |
IsEncrypted선택 사항입니다. |
Edm.Boolean | 이 파일을 암호화하여 저장하려면 이 값을 true로 설정해야 합니다. |
EncryptionKeyId선택 사항입니다. |
Edm.String | 암호화된 ContentKey ID입니다. |
InitializationVector선택 사항입니다. |
Edm.String | 저장소 암호화에 사용되는 초기화 벡터입니다. |
IsPrimary선택 사항입니다. |
Edm.Boolean | 이 파일이 다중 파일 자산의 주 파일인지 여부를 확인합니다. |
LastModified읽기 전용입니다. 만들 때 Media Services에서 설정합니다. |
Edm.DateTime | 이 값은 속성이 변경된 후 Media Services에 의해 업데이트됩니다. 1970년 1월 1일 자정 이후의 시간(밀리초)을 나타냅니다. |
Created읽기 전용입니다. 만들 때 Media Services에서 설정합니다. |
Edm.DateTime | 1970년 1월 1일 자정 이후의 시간을 밀리초 단위로 표시합니다. |
MimeType선택 사항입니다. |
Edm.String | 미디어 서비스는 업로드한 어떤 Blob도 검사하지 않으므로 mime 형식은 수동으로 설정해야 합니다. 예를 들어, "text/plain" 또는 "video/x-ms-wmv"가 사용하기에 유효한 값입니다. 최대 길이는 4000입니다. |
ContentChecksum선택 사항입니다. |
Edm.String | 16진수는 MD5(RFC 1321) 메시지 다이제스트 값을 나타냅니다. 이 값은 콘텐츠의 업로드 완료 확인을 위해 클라이언트 또는 클라이언트 라이브러리에서 설정합니다. 최대 길이는 4000입니다. |
AssetFile 만들기
CreateFileInfos 함수는 새 AssetFile 엔터티를 만드는 데 사용됩니다. 자세한 내용은 REST API 함수를 참조하세요.
AssetFile 나열
AssetFile은 GET HTTP 요청을 사용하여 검색됩니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Files> | HTTP/1.1 |
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') | HTTP/1.1 |
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Files | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:d0214595-fff0-164e-9c67-d576eba09605') 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
AssetFile 업데이트
AssetFile은 MERGE HTTP 요청을 사용하여 업데이트됩니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| MERGE | <https:// accountname.restv2>.<location.media.azure.net/api/Files>('fileid') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Files('nb:cid:UUID:2710e174-3165-a34c-96ad-618714b0d504') 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>
Content-Length: 27
Expect: 100-continue
{"MimeType" : "video/mp4" }
AssetFile 삭제
AssetFile은 연결된 자산이 삭제되면 삭제됩니다. 예를 들어 자산 삭제를 참조하세요.
참고 항목
ContentKey
자산
AccessPolicy
작업
JobTemplate
로케이터
MediaProcessor
Task
TaskTemplate
할당량 및 제한 사항