이 항목은 아직 평가되지 않았습니다.- 이 항목 평가

Asset

Asset은 미디어에 대한 메타데이터가 들어 있는 가상 엔터티입니다. Asset에는 비디오, 오디오, 이미지, 미리 보기 컬렉션, 텍스트 트랙, 선택 캡션 파일 및 서식 있는 미디어 플레이어 등의 파일이 하나 이상 포함되어 있을 수 있습니다. Asset 엔터티는 Windows Azure Media Services 시스템의 Asset에 대한 추상적인 개념을 정의합니다.

다음과 같은 특징이 Media Services의 Asset에 적용됩니다.

Asset은 하나의 시청각 프레젠테이션을 나타내는 논리 단위입니다.

자산에는 하나 이상의 미디어 파일로 구성된 컬렉션이 포함됩니다.

자산의 파일은 단일 blob 저장소 컨테이너에 있습니다.

Asset의 예로는 무삭제 영화, TV 쇼, 특정 편집본(영화, TV 쇼, 애니메이션, 카메라 ISO 파일, 이벤트 등의 클립, 영화 예고편이나 홍보 비디오, 광고), 오디오 파일, 라디오 쇼, 팟캐스트, 음향 파일 등이 있습니다.

다음과 같은 특징은 Media Services의 Asset에 적용되지 않습니다.

단순한 저장소 컨테이너

동일한 프레젠테이션에 대한 여러 버전을 구성하여 저장할 폴더

여러 시청각 프레젠테이션에 대한 일괄 처리를 Azure Media Encoder에 제출하기 위한 폴더

예를 들어 한 편의 영화와 해당 영화의 예고편, 광고 및 해외용 편집 버전을 하나의 Asset에 저장하면 안됩니다.

중요
Media Services의 엔터티에 액세스하려는 경우 HTTP 요청에 구체적인 헤더 필드와 값을 설정해야 합니다. 자세한 내용은 Setup for Media Services REST API Development을 참조하십시오.

Asset 엔터티 속성
Asset 만들기
Asset 나열
Asset 업데이트
자산 삭제
Asset 게시
컨텐츠 키를 자산에 연결
ContentKey 연결 제거

중요
https://media.windows.net/API에 연결하고 나면 다른 Media Services URI를 지정하는 301 리디렉션을 받게 됩니다. 새 URI에 대한 후속 호출을 수행해야 합니다.

Asset 엔터티 속성

속성

형식

설명

문자열

Media Services에서 설정된 고유한 ID입니다.

State

Edm.Int32

자산의 상태를 나타내는 열거 값입니다. 올바른 값은 다음과 같습니다.

초기화됨 = 0

게시됨 = 1

경고
Publish 작업은 현재 지원되지 않습니다. 최신 Media Services 릴리스를 처음 사용하는 경우, 자산이 Published 상태인지 확인하는 코드를 제거해야 합니다.

삭제됨 = 2

Created

Edm.DateTime

이 값은 작성된 시간에 Media Services에 의해 설정됩니다.

LastModified

Edm.DateTime

이 값은 속성이 변경된 이후에 Media Services에 의해 업데이트됩니다.

AlternateId

Edm.String

선택 사항입니다. 다른 콘텐츠 관리 시스템의 ID에 해당하는 대체 ID 값입니다.

Name

Edm.String

선택 사항입니다. Asset의 이름입니다.

Options

Edm.Int32

선택 사항입니다. Asset을 만들 수 있는 암호화 방식을 나타내는 열거 값입니다. 아래 목록의 값을 혼합하여 사용할 수 없으며 그 중 하나만 설정할 수 있습니다.

없음 = 0 : 자산 작성 방식이 없음을 지정합니다.
StorageEncrypted = 1: 자산이 만들어질 때 자산의 파일이 업로드 및 저장을 위해 암호화되도록 지정합니다.
CommonEncryptionProtected = 2: 자산의 파일이 일반적인 암호화 방식(예: PlayReady)을 사용하여 보호되도록 지정합니다.

Locator

Locator 엔터티 집합

ID 값을 통해 특정 Asset을 참조함으로써 액세스할 수 있는 탐색 속성입니다. 반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 Locator 엔터티가 포함됩니다.

ContentKeys

ContentKey 엔터티 집합

ID 값을 통해 특정 Asset을 참조함으로써 액세스할 수 있는 탐색 속성입니다. 반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 ContentKey 엔터티가 포함됩니다.

Files

File 엔터티 집합

ID 값을 통해 특정 Asset을 참조함으로써 액세스할 수 있는 탐색 속성입니다. 반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 File 엔터티가 포함됩니다.

ParentAssets

ParentAsset 엔터티 집합

ID 값을 통해 특정 Asset을 참조함으로써 액세스할 수 있는 탐색 속성입니다. 반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 ParentAsset 엔터티가 포함됩니다.

Asset 만들기

Asset은 POST HTTP 요청을 사용하고 속성 값이 지정하여 만들 수 있습니다.

메서드	요청 URI	HTTP 버전
POST	https://media.windows.net/API/Assets	HTTP/1.1

샘플 요청

POST https://media.windows.net/API/Assets HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.0
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 27
Expect: 100-continue

{ "Name" : "NewJSONAsset" }

Asset 나열

Asset은 GET HTTP 요청을 사용하여 검색할 수 있습니다.

메서드	요청 URI	HTTP 버전
GET	https://media.windows.net/API/Assets	HTTP/1.1

메서드	요청 URI	HTTP 버전
GET	https://media.windows.net/API/Assets('assetid')	HTTP/1.1

샘플 요청

GET https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.0
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0

Asset 업데이트

Asset은 MERGE HTTP 요청과 변경하려는 특정 속성을 사용하여 업데이트할 수 있습니다.

메서드	요청 URI	HTTP 버전
MERGE	https://media.windows.net/API/Assets('assetid')	HTTP/1.1

샘플 요청

MERGE https://media.windows.net/API/Assets('nb:cid:UUID:80782407-3f87-4e60-a43e-5e4454232f60') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.0
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=youraccountname&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1337083279&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=DMLQXWah4jO0icpfwyws5k%2b1aCDfz9KDGIGao20xk6g%3d
Host: media.windows.net
Content-Length: 21
Expect: 100-continue

{"Name" : "NewName" }

자산 삭제

Asset은 Asset ID 값을 참조하여 삭제할 수 있습니다. 자산이 삭제되면 해당 로케이터도 모두 Windows Azure Media Services에 의해 삭제됩니다. 자산에 원본 로케이터가 연결된 경우 이러한 로케이터도 해지되고 삭제됩니다. ContentKey에 대한 모든 연결이 삭제되며 다른 자산에 연결되지 않은 ContentKey가 삭제됩니다.

메서드	요청 URI	HTTP 버전
DELETE	https://media.windows.net/API/Assets('assetid')	HTTP/1.1

샘플 요청

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:fccb8cd9-7afa-4365-a36e-d5d68409bb64') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.0
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=070500D0-F35C-4A5A-9249-485BBF4EC70B&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&Audience=urn%3aWindowsAzureMediaServices&ExpiresOn=1334275521&Issuer=https%3a%2f%2fwamsprodglobal001acs.accesscontrol.windows.net%2f&HMACSHA256=GxdBb%2fmEyN7iHdNxbawawHRftLhPFFqxX1JZckuv3hY%3d
Host: media.windows.net
Content-Length: 0

Asset 게시

참고
Publish 작업은 현재 지원되지 않습니다. 최신 Media Services 릴리스를 처음 사용하는 경우, Publish는 사용되면 안됩니다. Publish가 코드에서 사용된 경우에는 다음을 고려해야 합니다. Publish 작업으로 자산과 연관된 로케이터가 삭제되지 않습니다. Publish 호출 이후 코드에서 로케이터를 명시적으로 삭제해야 합니다. Publish 작업으로 자산이 Published 상태로 설정되지 않습니다. 자산이 Published 상태인지 확인하는 코드를 제거하십시오. 현재, 자산에는 Initialized 또는 Deleted 상태만 가능합니다.

참고

Publish 작업은 현재 지원되지 않습니다. 최신 Media Services 릴리스를 처음 사용하는 경우, Publish는 사용되면 안됩니다.

Publish가 코드에서 사용된 경우에는 다음을 고려해야 합니다.

Publish 작업으로 자산과 연관된 로케이터가 삭제되지 않습니다. Publish 호출 이후 코드에서 로케이터를 명시적으로 삭제해야 합니다.
Publish 작업으로 자산이 Published 상태로 설정되지 않습니다. 자산이 Published 상태인지 확인하는 코드를 제거하십시오. 현재, 자산에는 Initialized 또는 Deleted 상태만 가능합니다.

컨텐츠 키를 자산에 연결

HTTP POST 요청으로 자산 ID를 참조하여 ContentKey를 자산에 연결할 수 있습니다. ContentKey의 Uri가 요청의 본문에 포함되어 있어야 합니다. 자산의 CreationOptions에 지정된 유형과 같은 ContentKey 유형만 연결할 수 있습니다. 예를 들어 Asset의 암호화 옵션이 StorageEncrypted(1)로 설정된 경우 ContentKey도 StorageEncryption(1) 유형이어야 합니다.

메서드	요청 URI	HTTP 버전
POST	https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys	HTTP/1.1

샘플 요청

POST https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.0
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 121
Expect: 100-continue

{ "uri": "https://media.windows.net/api/ContentKeys('nb%3Akid%3AUUID%3A5db89211-c9d9-404b-a6bc-3e6b91c7a214')"}

ContentKey 연결 제거

HTTP DELETE 요청에서 자산 ID와 ContentKey ID를 참조하여 자산에서 ContentKey 연결을 제거할 수 있습니다. ContentKey는 다른 자산에 연결되어 있지 않은 경우에 삭제됩니다.

메서드	요청 URI	HTTP 버전
DELETE	https://media.windows.net/API/Assets(‘Asset Id')/$links/ContentKeys('ContentKey Id')	HTTP/1.1

샘플 요청

DELETE https://media.windows.net/API/Assets('nb:cid:UUID:3ac4c50a-09c1-4ea3-b39c-c336d97f5a13')/$links/ContentKeys('nb:kid:UUID:5db89211-c9d9-404b-a6bc-3e6b91c7a214') HTTP/1.1
Content-Type: application/json;odata=verbose
Accept: application/json;odata=verbose
DataServiceVersion: 3.0
MaxDataServiceVersion: 3.0
x-ms-version: 2.0
Authorization: Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=vodbvttest01&urn%3aSubscriptionId=2f84471d-b1ae-4e75-aa09-010f0fc0cf5b&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&Audience=urn%3aNimbus&ExpiresOn=1352143039&Issuer=https%3a%2f%2fnimbustestaccounts.accesscontrol.windows.net%2f&HMACSHA256=sx%2bpdQNrEi8FoEVnwnIK1sXe3GWxXELEFbwKNMQ7BNM%3d
Host: media.windows.net
Content-Length: 0

참고 항목

개념

AccessPolicy
ContentKey
AssetFile
Job
JobTemplate
Locator
MediaProcessor
Task
TaskTemplates

기타 리소스

Ingest Assets with the Media Services REST API
Media Services Considerations

빌드 날짜:

2013-04-11

이 정보가 도움이 되었습니까? 예 아니요

정확하지 않음

내용이 심층적이지 않음

코드 예가 더 필요함

번역에 개선이 필요함

(1500자 남음)

커뮤니티 추가 항목

추가