내보내기(0) 인쇄
모두 확장

Asset

업데이트 날짜: 2014년 2월

Asset 엔터티에는 디지털 파일(비디오, 오디오, 이미지, 미리 보기 컬렉션, 텍스트 트랙 및 선택 캡션 파일)과 이러한 파일에 대한 메타데이터가 포함되어 있습니다. 디지털 파일을 자산에 업로드한 후에는 Media Services 인코딩 및 스트리밍 워크플로에서 이를 사용할 수 있습니다.

다음과 같은 특징이 미디어 서비스의 Asset에 적용됩니다.
Asset은 하나의 시청각 프레젠테이션을 나타내는 논리 단위입니다.

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

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

Asset의 예로는 전체 동영상, TV 쇼, 특정 편집이나 동영상, TV 쇼, 애니메이션, 카메라 ISO 파일 또는 이벤트의 클립, 동영상 트레일러나 홍보 비디오, 광고, 오디오 파일, 라디오 쇼, 팟캐스트 또는 사운드 파일이 있습니다.

다음과 같은 특징은 미디어 서비스의 Asset에 적용되지 않습니다.
단순한 저장소 컨테이너

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

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

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

이 항목에서는 Asset 엔터티에 대해 간략하게 설명하는 동시에 Media Services REST API를 사용하여 다양한 작업을 실행하는 방법도 보여줍니다.

Important중요
Media Services REST API를 사용할 때는 다음 사항을 고려해야 합니다.

Asset 엔터티 속성

 

속성 형식 설명

Id

읽기 전용이며 만들 때 미디어 서비스에 의해 설정됩니다.

문자열

고유 식별자

State

읽기 전용이며 미디어 서비스에 의해 설정됩니다.

Edm.Int32

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

  • 초기화됨 = 0

  • 게시됨 = 1

    Warning경고
    Publish 작업은 현재 지원되지 않습니다. 자산이 Published 상태인지 확인하는 코드를 제거하십시오.

  • 삭제됨 = 2

자산은 삭제될 때까지 항상 초기화된 상태입니다.

Crated

읽기 전용이며 만들 때 미디어 서비스에 의해 설정됩니다.

Edm.DateTime

이 값은 작성된 시간에 미디어 서비스에 의해 설정됩니다.

LastModified

읽기 전용이며 미디어 서비스에 의해 설정됩니다.

Edm.DateTime

이 값은 속성이 변경된 이후에 미디어 서비스에 의해 업데이트됩니다.

AlternateId

선택 사항입니다.

Edm.String

다른 콘텐츠 관리 시스템의 ID에 해당하는 대체 ID 값입니다. 최대 길이는 4000입니다.

Name

선택 사항입니다.

Edm.String

자산의 이름입니다. 최대 길이는 4000입니다.

Options

필수 사항입니다. 엔터티가 만들어진 후에는 업데이트할 수 없습니다.

Edm.Int32

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

  • 없음 = 0 : 자산 작성 방식이 없음을 지정합니다.

  • StorageEncrypted = 1: 자산이 만들어질 때 자산의 파일이 업로드 및 저장을 위해 암호화되도록 지정합니다.

  • CommonEncryptionProtected = 2: 자산의 파일이 일반적인 암호화 방식(예: PlayReady)을 사용하여 보호되도록 지정합니다.

  • EnvelopeEncryptionProtected = 4

Uri

읽기 전용이며 미디어 서비스에 의해 설정됩니다.

Edm.String

지정된 Asset의 Blob 저장소 컨테이너의 URI입니다.

Locators

읽기 전용이며 미디어 서비스에 의해 설정됩니다.

Locator 엔터티 집합

반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 Locator 엔터티가 포함됩니다.

ContentKeys

선택 사항입니다.

ContentKey 엔터티 집합

반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 ContentKey 엔터티가 포함됩니다.

Files

읽기 전용이며 미디어 서비스에 의해 설정됩니다.

File 엔터티 집합

반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 File 엔터티가 포함됩니다.

ParentAssets

선택 사항입니다.

상위 Asset 엔터티 집합

반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 상위 Asset 엔터티가 포함됩니다.

StorageAccountName

선택 사항입니다. 엔터티가 만들어진 후에는 업데이트할 수 없습니다.

Edm.String

자산의 Blob 컨테이너가 포함된 저장소 계정의 이름입니다.

만들 때 지정하지 않으면 미디어 서비스에서 기본 저장소 계정 이름을 설정합니다.

StorageAccount

읽기 전용이며 미디어 서비스에 의해 설정됩니다.

StorageAccount 엔터티 집합

반환되는 엔터티 집합에는 지정된 Asset에 연결되어 있는 모든 StorageAccount 엔터티가 포함됩니다.

Asset 만들기

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

 

메서드 요청 URI HTTP 버전

POST

https://media.windows.net/API/Assets

HTTP/1.1

샘플 요청

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

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.6
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

샘플 요청

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

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.6
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

샘플 요청

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

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.6
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 값을 참조하여 삭제할 수 있습니다. 자산이 삭제되면 해당 로케이터도 모두 Microsoft Azure 미디어 서비스에 의해 삭제됩니다. 자산에 원본 로케이터가 연결된 경우 이러한 로케이터도 해지되고 삭제됩니다. ContentKey에 대한 모든 연결이 삭제되며 다른 자산에 연결되지 않은 ContentKey가 삭제됩니다.

 

메서드 요청 URI HTTP 버전

DELETE

https://media.windows.net/API/Assets('assetid')

HTTP/1.1

샘플 요청

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

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.6
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 게시

note참고
Publish 작업은 현재 지원되지 않습니다. 최신 미디어 서비스 릴리스를 처음 사용하는 경우, Publish는 사용되면 안됩니다.

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

  1. Publish 작업으로 자산과 연관된 로케이터가 삭제되지 않습니다. Publish 호출 이후 코드에서 로케이터를 명시적으로 삭제해야 합니다.

  2. 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(멇sset Id')/$links/ContentKeys

HTTP/1.1

샘플 요청

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

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.6
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(멇sset Id')/$links/ContentKeys('ContentKey Id')

HTTP/1.1

샘플 요청

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

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.6
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

참고 항목


빌드 날짜:

2014-06-20

커뮤니티 추가 항목

표시:
© 2014 Microsoft