Microsoft Azure Media Services v3 API로 개발

개발자인 경우 REST API와 상호 작용할 수 있도록 하는 클라이언트 라이브러리(.NET, Python, Node.js, Java 및 Go)를 사용하여 사용자 지정 미디어 워크플로를 손쉽게 만들고, 관리하고, 유지할 수 있습니다. Media Services v3 API는 OpenAPI 사양(이전 명칭 Swagger)에 기반을 두고 있습니다.

이 문서에서는 Microsoft Azure Media Services v3로 개발할 때 엔터티와 API에 적용되는 규칙에 대해 설명합니다.

Azure Microsoft Azure Media Services API에 액세스

Media Services 리소스 및 Media Services API에 액세스할 수 있는 권한을 부여하려면 먼저 인증을 거쳐야 합니다. Microsoft Azure Media Services는 Microsoft Azure AD(Azure Active Directory) 기반 인증을 지원합니다. 다음은 두 가지 일반적인 인증 옵션입니다.

• 서비스 주체 인증: 서비스를 인증하는 데 사용됩니다 (예: 웹앱, 함수 앱, 논리 앱, API 및 마이크로서비스). 이 인증 방법을 일반적으로 사용하는 애플리케이션은 디먼 서비스, 중간 계층 서비스 또는 예약된 작업을 실행하는 앱입니다. 예를 들어 웹앱의 경우 서비스 주체로 Microsoft Azure Media Services에 연결하는 중간 계층이 항상 있어야 합니다.
• 사용자 인증: 앱을 사용하여 Microsoft Azure Media Services 리소스와 상호 작용하는 사용자를 인증하는 데 사용됩니다. 대화형 앱은 먼저 사용자에게 사용자의 자격 증명을 묻는 메시지를 표시합니다. 예제는 권한 있는 사용자가 인코딩 작업 또는 라이브 스트리밍을 모니터링하기 위해 사용한 관리 콘솔 앱입니다.

Microsoft Azure Media Services API를 사용하려면 REST API 요청을 하는 사용자 또는 앱이 Microsoft Azure Media Services 계정 리소스에 액세스할 수 있고 기여자 또는 소유자 역할을 사용해야 합니다. 읽기 권한자 역할로 API에 액세스할 수 있지만 가져오기 또는 나열 작업만 사용할 수 있습니다. 자세한 내용은 Media Services 계정에 대한 Azure RBAC(Azure 역할 기반 액세스 제어)를 참조하세요.

서비스 주체를 만드는 대신 Azure Resource Manager를 통해 Azure 리소스에 대한 관리 ID를 사용하여 Microsoft Azure Media Services API에 액세스하는 것이 좋습니다. Azure 리소스에 대한 관리 ID에 대한 자세한 내용은 Azure 리소스에 대한 관리 ID란?을 참조하세요.

Microsoft Azure Active Directory 서비스 주체

Azure AD 앱과 서비스 주체는 동일한 테넌트에 있어야 합니다. 앱을 만든 후 앱 기여자 또는 소유자 역할에 Microsoft Azure Media Services 계정에 대한 액세스 권한을 제공합니다.

Microsoft Azure Active Directory 앱을 만들 수 있는 권한이 있는지 확실하지 않은 경우 필요한 권한을 참조하세요.

다음 그림에서 숫자는 요청 흐름을 시간순으로 보여줍니다.

1. 중간 계층 앱은 다음 매개 변수가 있는 Microsoft Azure Active Directory 액세스 토큰을 요청합니다.

   • Azure AD 테넌트 엔드포인트.
   • Media Services 리소스 URI.
   • REST Media Services의 리소스 URI.
   • Microsoft Azure Active Directory 앱 값: 클라이언트 ID 및 클라이언트 암호.

   필요한 값을 모두 가져오려면 Azure Microsoft Azure Media Services API에 액세스를 참조하세요.

2. Azure AD 액세스 토큰이 중간 계층으로 전송됩니다.

3. 중간 계층은 Azure AD 토큰과 함께 Azure Media REST API로 요청을 보냅니다.

4. 중간 계층은 Media Services에서 데이터를 다시 가져옵니다.

샘플

Microsoft Azure Active Directory 서비스 주체와 연결하는 방법을 보여주는 다음 샘플을 참조하세요.

• .NET으로 연결
• Node.js로 연결
• Python으로 연결
• Java로 연결

명명 규칙

Azure Media Services v3 리소스 이름(예: 자산, 작업, 변환)은 Azure Resource Manager 명명 제약 조건에 따라 달라집니다. Azure Resource Manager에 따라 리소스 이름은 항상 고유합니다. 따라서 리소스 이름에 대해 고유 식별자 문자열(예: GUID)을 사용할 수 있습니다.

Media Services 리소스 이름에는 '', '<', '>%', '&', ':', '\', '?', '/', '*', '+', '.', 작은따옴표 문자 또는 컨트롤 문자가 포함될 수 없습니다. 다른 문자를 모두 허용합니다. 리소스 이름의 최대 길이는 260자입니다.

Azure Resource Manager의 이름을 지정하는 방법에 대한 자세한 내용은 명명 요구 사항 및 명명 규칙을 참조하세요.

자산 내의 파일/BLOB 이름

자산 내의 파일/BLOB 이름은 BLOB 이름 요구 사항과 NTFS 이름 요구 사항을 따라야 합니다. 이러한 요구 사항을 따라야 하는 이유는 파일이 처리를 위해 BLOB 스토리지에서 로컬 NTFS 디스크로 복사될 수 있기 때문입니다.

장기 실행 작업

Azure Microsoft Azure Media Services Swagger 파일에 x-ms-long-running-operation으로 표시되는 작업은 장기 실행 작업입니다.

비동기 Azure 작업을 추적하는 방법에 대한 자세한 내용은 비동기 작업을 참조하세요.

Microsoft Azure Media Services에는 다음과 같은 장기 실행 작업이 있습니다.

• 라이브 이벤트 만들기

• 라이브 이벤트 업데이트

• 라이브 이벤트 삭제

• 라이브 이벤트 시작

• LiveEvent 중지

  이벤트를 중지할 때 연결된 모든 라이브 출력을 삭제하려면 removeOutputsOnStop 매개 변수를 사용합니다.

• LiveEvent 초기화

• LiveOutput 만들기

• LiveOutput 삭제

• StreamingEndpoint 만들기

• StreamingEndpoint 업데이트

• StreamingEndpoint 삭제

• StreamingEndpoint 시작

• StreamingEndpoint 중지

• StreamingEndpoint 스케일링

장기 실행 작업 제출에 성공하면 '201 생성됨'이 수신되며 반환된 작업 ID를 사용하여 작업 완료를 폴링해야 합니다.

비동기 Azure 작업 추적 문서에서는 응답에서 반환된 값을 통해 비동기 Azure 작업의 상태를 추적하는 방법에 대해 자세히 설명합니다.

지정된 라이브 이벤트 또는 이와 연결된 라이브 출력에는 하나의 장기 실행 작업만 지원됩니다. 일단 시작되면 동일한 LiveEvent 또는 연결된 라이브 출력에서 후속 장기 실행 작업을 시작하기 전에 먼저 시작된 장기 실행 작업을 완료해야 합니다. 라이브 출력이 여러 개 있는 라이브 이벤트의 경우 한 라이브 출력에서 장기 실행 작업이 완료될 때까지 기다렸다가 다른 라이브 출력에서 장기 실행 작업을 트리거해야 합니다.

SDK

참고 항목

• 미디어 서비스 이벤트를 포함하는 EventGrid .NET SDK
• Media Services 이벤트의 정의

Azure Media Services 탐색기

Azure Media Services 탐색기(AMSE)는 Media Services에 대해 알아보고자 하는 Windows 고객이 사용할 수 있는 도구입니다. AMSE는 Media Services에서 VOD 및 실시간 콘텐츠의 업로드, 다운로드, 인코딩, 스트리밍을 수행하는 Winforms/C# 애플리케이션입니다. AMSE 도구는 코드를 작성하지 않고 Media Services를 테스트하려는 고객을 위한 도구입니다. AMSE 코드는 Media Services를 사용하여 개발하려는 고객을 위한 리소스로 제공됩니다.

AMSE는 오픈 소스 프로젝트이며, 커뮤니티에서 지원을 제공합니다(문제는 https://github.com/Azure/Azure-Media-Services-Explorer/issues에 보고할 수 있음). 이 프로젝트는 Microsoft 오픈 소스 준수 사항을 채택했습니다. 자세한 내용은 준수 사항 FAQ를 참조하고, 추가 질문이나 의견이 있는 경우에는 opencode@microsoft.com으로 문의하세요.

Media Services 엔터티 필터링, 순서 지정, 페이징

Azure Microsoft Azure Media Services 엔터티 필터링, 순서 지정, 페이징을 참조하세요.

도움말 및 지원 보기

다음 방법 중 하나로 Media Services에 질문하거나 업데이트를 따를 수 있습니다.

• 질문과 대답
• Stack Overflow. 를 사용하여 질문에 태그를 지정 azure-media-services합니다.
• @MSFTAzureMedia 또는 @AzureSupport 사용하여 지원을 요청합니다.
• Azure Portal 통해 지원 티켓을 엽니다.