Locator
Locator는 Asset에 포함된 파일에 액세스할 수 있는 진입점을 제공합니다. AccessPolicy는 지정된 Asset에 대한 클라이언트의 권한과 액세스 기간을 정의하는 데 사용됩니다. Locator와 AccessPolicy는 다대일 관계로, 동일한 권한과 액세스 기간이 설정된 여러 개의 Locator를 통해 다양한 시작 시간과 연결 유형을 여러 클라이언트에 제공할 수 있습니다. 하지만 Azure 저장소 서비스에 의해 설정된 공유 액세스 정책 제한으로 인해, 지정된 Asset과 연관된 고유 Locator는 한 번에 6개 이상 사용할 수 없습니다. 자세한 내용은 공유 액세스 서명 사용(REST API)을 참조하세요.
다양한 파일 형식에 액세스하기 위해 Locator URI를 변환해야 할 경우가 있습니다. 예를 들어 SAS Locator의 Path 속성을 통해 컨테이너에 액세스할 수 있습니다. 파일에 액세스하려면 호스트와 SAS 서명 사이에 파일 이름을 삽입해야 합니다. OnDemandOrigin 로케이터 Path 로 작업할 때는 프로토콜 관련 부분이 추가될 때까지 속성이 유용하지 않습니다.
다음 규칙에 따라 Locator를 만들고 업데이트할 수 있습니다.
읽기 권한이 지정된 AccessPolicy와 함께 사용되는 SAS(액세스 서명) URL Locator와 Origin Locator는 파일이 Asset에 업로드된 이후에만 만들 수 있습니다. 파일 다운로드 또는 업로드에 사용되는 SAS URL Locator는 쓰기 권한이 지정된 AccessPolicy와 함께 사용되는 경우에만 파일 업로드 이전에 만들 수 있습니다.
SAS URL Locator는 작성된 다음에는 업데이트할 수 없습니다. 하지만 Origin Locator와 같은 다른 Locator는 새로운 StartTime 값으로 업데이트할 수 있습니다.
SAS 로케이터의 URL은 연결된 스토리지 계정의 스토리지 키가 업데이트될 때마다 변경됩니다. 자세한 내용은 방법: 롤링 스토리지 액세스 키 후 Media Services 업데이트를 참조하세요.
로케이터를 만든 후 사용할 수 있을 때까지 30-40초의 지연이 있을 수 있습니다. 이 문제는 SAS URL Locator 및 OnDemandOrigin Locator 둘 다에 적용됩니다.
참고
Locator는 사용자별 액세스 제어를 관리하는 데 사용할 수 없습니다. 개별 사용자에게 서로 다른 액세스 권한을 부여하려면 DRM(Digital Rights Management)솔루션을 사용 합니다.
이 문서에서는 엔터티에 Locator 대한 개요를 제공하고 Media Services REST API를 사용하여 다양한 작업을 실행하는 방법을 보여 줍니다.
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
Locator 엔터티 속성
| 속성 | 형식 | 설명 |
|---|---|---|
Id선택 사항입니다. 엔터티가 만들어진 후에는 업데이트할 수 없습니다. |
Edm.String | Media Services에 의해 설정된 고유 식별자입니다. |
Name선택 사항입니다. |
Edm.String | Locator의 이름입니다. 최대 길이는 4000입니다. |
ExpirationDateTime쓰기 전용입니다. MERGE HTTP 요청을 사용하여 ExpirationDateTime 값을 업데이트합니다. |
Edm.DateTime | 지정된 자산에 액세스하는 데 Locator를 사용할 수 없게 되는 시점을 나타내는 값입니다(1970년 1월 1일 자정 이후의 시간을 밀리초 단위로 표시). ExpirationDateTime은 DateTime 형식이어야 합니다(예: YYYY-MM-DDTHH:mm:ssZ "2014-05-23T17:53:50Z"). |
Type필수 요소. 엔터티가 만들어진 후에는 업데이트할 수 없습니다. |
Edm.Int32 | Locator의 유형을 나타내는 열거 값입니다. 유효한 값은 다음과 같습니다. - 없음 = 0: 기본 열거형 값입니다. 올바른 Locator가 없는 경우 이 유형으로 설정됩니다. - SAS = 1: Sas(공유 액세스 서명) 로케이터 유형을 지정합니다. - OnDemandOrigin = 2: Azure Media Service 주문형 원본 스트리밍 엔드포인트를 참조하는 로케이터 형식을 지정합니다. |
Path읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | Asset 파일에 액세스하는 데 사용되는 URL입니다. |
BaseUri읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 자산에 대한 저장소/서비스/컨테이너 정보를 제공하는 Locator 부분입니다(예: (예: Dns 호스트 이름 http://someservice.cloudapp.net) |
ContentAccessComponent읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 콘텐츠에 액세스하는 데 필요한 URI 부분입니다. 최종 미디어 URL에서 이 토큰의 위치는 로케이터 유형, 미디어 유형 및 스트리밍 서비스에 따라 달라집니다. |
AccessPolicyId읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 로케이터 URL에 대한 사용 권한 및 기간을 정의하는 AccessPolicy의 ID입니다. OnDemandOrigin 로케이터를 만들 때 목록 권한을 사용하면 안 됩니다. |
AssetId읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 액세스를 제공하려는 콘텐츠가 포함된 자산의 ID입니다. |
StartTime선택 사항입니다. |
Edm.DateTime | 클라이언트에서 Locator를 사용할 수 있는 날짜와 시간입니다. 팁: 파일을 즉시 업로드해야 하는 경우 StartTime 값을 현재 시간 5분 전에 설정해야 합니다. 클라이언트 컴퓨터와 Media Services 사이에 시간차가 있을 수 있기 때문입니다. 또한 StartTime 값은 DateTime 형식(예: YYYY-MM-DDTHH:mm:ssZ "2014-05-23T17:53:50Z")이어야 합니다. |
AssetPolicy읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
AssetPolicy 엔터티 집합 |
AccessPolicy 인스턴스에 대한 탐색 속성입니다. |
Asset읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Asset 엔터티 집합 |
Asset 인스턴스에 대한 탐색 속성입니다. |
Locator 만들기
Locator는 POST HTTP 요청을 사용하여 만들 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/Locators> | HTTP/1.1 |
참고
SAS 로케이터의 URL은 연결된 스토리지 계정의 스토리지 키가 업데이트될 때마다 변경됩니다. 자세한 내용은 방법: 스토리지 액세스 키를 롤링한 후 Media Services 업데이트를 참조하세요.
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
POST https://<accountname>.restv2.<location>.media.azure.net/api/Locators 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: 182
Expect: 100-continue
{"AccessPolicyId": "nb:pid:UUID:25544a8f-8ccf-43b1-a188-2a860b35bffa", "AssetId" : "nb:cid:UUID:d062e5ef-e496-4f21-87e7-17d210628b7c", "StartTime" : "2014-05-17T16:45:53", "Type":1}
자세한 내용은 Media Services REST API를 사용하여 자산 제공을 참조하세요.
Locator 나열
Locator는 GET HTTP 요청을 사용하여 검색할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | GET https://< accountname.restv2>.<location.media.azure.net/api/Locators> | HTTP/1.1 |
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | <https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetid')/Locators | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
GET https://<accountname>.restv2.<location>.media.azure.net/api/Locators('nb:lid:UUID:627cbafb-3d81-4623-97c2-2194282b6d16') 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
Locator 업데이트
Origin Locator는 MERGE HTTP 요청을 사용하여 업데이트할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| MERGE | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
MERGE https://<accountname>.restv2.<location>.media.azure.net/api/Locators('nb:lid:UUID:5bfcb65d-843d-4d5e-bf71-9306ecb08203') 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: 38
Expect: 100-continue
{"StartTime" : "2014-05-17T16:45:53"}
Locator 삭제
Locator는 DELETE HTTP 요청을 사용하여 삭제할 수 있습니다.
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/Locators>('locatorid') | HTTP/1.1 |
샘플 요청
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Locators('nb:lid:UUID:9f0e0cee-8ea5-46c4-b985-5a7cd30e7623') 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
Connection: Keep-Alive
참고 항목
미디어 서비스 REST API를 사용하여 자산 제공
ContentKey
자산
AccessPolicy
AssetFile
JobTemplate
작업
MediaProcessor
Task
TaskTemplate
할당량 및 제한 사항