StreamingEndpoint
중요
미디어 서비스 2.7부터 Origin 엔터티의 이름이 StreamingEndpoint로 바뀌었습니다.
StreamingEndpoint 엔터티는 향후 배포를 위해 CDN(콘텐츠 배달 네트워크) 또는 클라이언트 플레이어 응용 프로그램에 직접 콘텐츠를 배달할 수 있는 스트리밍 서비스를 나타냅니다. 버전 2.9부터 Microsoft Azure Media Services Azure CDN 통합을 제공합니다(자세한 내용은 아래에 설명된 속성을 참조 CdnEnabled 하세요). StreamingEndpoint 서비스의 아웃바운드 스트림은 Media Services 계정의 라이브 스트림 또는 주문형 비디오 자산일 수 있습니다.
각 AMS(Azure Media Services) 계정에는 기본 StreamingEndpoint가 포함됩니다. 계정에서 추가 StreamingEndpoints를 만들 수 있습니다. Media Services 2.15(2017년 1월 10일에 릴리스됨)부터 1.0 및 2.0이라는 두 가지 StreamingEndpoint 버전이 있습니다. 또한 StreamingEndpoints에는 클래식, **표준 또는 프리미엄의 세 가지 유형이 있습니다.
AMS REST 2.15 업데이트 전에 만든 Media Services 계정에는 기본적으로 클래식 스트리밍 엔드포인트 버전 1.0이 포함됩니다. 버전 2.0으로 업그레이드할 수 있으며 1.0으로 다운그레이드할 수 없습니다. 2.15 업데이트 후에 만든 AMS 계정에는 기본적으로 표준 스트리밍 엔드포인트 버전 2.0이 포함됩니다. 버전 2.0 스트리밍 엔드포인트에는 청구 및 기능 변경이 있습니다. 자세한 내용은 아래에 설명된 속성을 참조 StreamingEndpointVersion 하세요.
자동으로 프로비전된 StreamingEndpoint의 이름은 "기본값"이며 삭제할 수 없습니다. StreamingEndpoint의 상태가 중지됨입니다. 스트리밍을 시작하려면 스트리밍 엔드포인트를 시작해야 합니다.
Azure 클래식 포털을 통해 계정을 만들고 Azure CDN을 지역에서 사용할 수 있는 경우 계정은 기본적으로 CDN 통합을 갖습니다("CdnEnabled":true, "CdnProvider":StandardVerizon 및 "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
대부분의 경우 CDN을 사용하도록 설정해야 합니다. 그러나 최대 동시성이 500명보다 적은 수의 독자로 예상될 경우 CDN이 동시성에 따라 가장 잘 확장되므로 CDN을 사용하지 않도록 설정하는 것이 좋습니다.
클래식, 표준, 프리미엄 스트리밍 엔드포인트 개요
이 섹션에서 설명하는 고급 기능에는 동적 패키징 및 동적 암호화가 포함됩니다.
다음 표에는 동작이 요약되어 있습니다.
| Type | 버전 | ScaleUnits | 고급 기능 | CDN | 결제 |
|---|---|---|---|---|---|
| 클래식 | 1.0 | 0 | 해당 없음 | 해당 없음 | 무료 |
| 표준 스트리밍 엔드포인트(권장) | 2.0 | 0 | 예 | 예 | 유료 |
| 프리미엄 스트리밍 엔드포인트 | 1.0 | >0 | 예 | 예 | 유료 |
| 프리미엄 스트리밍 엔드포인트 | 2.0 | >0 | 예 | 예 | 유료 |
더 나은 환경과 고급 기능을 얻으려면 클래식 스트리밍 엔드포인트를 표준 스트리밍 엔드포인트로 업그레이드하는 것이 좋습니다. 또한 표준 스트리밍은 아웃바운드 대역폭을 자동으로 확장합니다.
표준 유형은 거의 모든 스트리밍 시나리오 및 대상 사용자 크기에 권장되는 옵션입니다. 요구 사항이 매우 까다로운 고객의 경우 AMS는 최대 인터넷 대상 그룹을 위한 용량을 확장하는 데 사용할 수 있는 프리미엄 스트리밍 엔드포인트도 제공합니다. 많은 시청자와 동시 시청자가 필요한 경우 프리미엄 유형으로 전환해야 하는지 여부에 대한 지침은 Microsoft에 문의하세요. 50,000명 이상의 동시 시청자 규모가 예상되는 경우(microsoft.com amsstreaming)에 문의하는 것이 좋습니다.
배율 단위를 조정하여 프리미엄 형식으로 이동합니다. 배율 단위는 200Mbps 단위로 구입할 수 있는 전용 송신 용량을 제공합니다. 프리미엄 유형을 사용할 경우 설정된 각 단위가 애플리케이션에 대한 추가 대역폭 용량을 제공합니다. 자세한 내용은 StreamingEndpoint 크기를 조정하는 방법을 참조하세요.
자세한 내용은 스트리밍 엔드포인트 개요를 참조하세요.
StreamingEndpoint 속성 및 작업
중요
Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API를 사용하여 Media Services에 연결을 참조하세요.
이 섹션에서는 엔터티에 StreamingEndpoint 대한 개요를 제공하고 Media Services REST API를 사용하여 다양한 작업을 실행하는 방법을 보여 줍니다.
StreamingEndpoint 엔터티
StreamingEndpoint 엔터티에는 다음 속성이 포함됩니다.
| 속성 | 형식 | 설명 |
|---|---|---|
Id읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 만들 때 할당되는 StreamingEndpoint ID입니다. 형식은 nb:oid:UUID:<GUID>입니다. |
Name |
Edm.String | StreamingEndpoint 서비스의 이름입니다. - Media Services 계정 내에서 고유해야 합니다. - 최대 길이 = 32자. - 공백을 포함할 수 없습니다. - 하이픈 및 영숫자 문자만 - 하이픈으로 시작하거나 끝낼 수 없습니다. |
Description |
Edm.String | StreamingEndpoint에 대한 설명입니다. 최대 길이는 256자입니다. |
Created읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.DateTime | Microsoft Azure Media Services 라이브 스트리밍 미리 보기 서비스에서 생성됩니다. |
State읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.Int32 | 해당 속성의 값에는 다음이 포함됩니다. - Stopped. 생성 후 StreamingEndpoint의 초기 상태입니다. - Starting. StreamingEndpoint가 실행 중 상태로 전환되고 있습니다. - Running. StreamingEndpoint가 클라이언트에 콘텐츠를 스트리밍할 수 있습니다. - Scaling. 스트리밍 단위(ScaleUnits)가 늘어나거나 감소하고 있습니다. - Stopping. StreamingEndpoint가 중지됨 상태로 전환되고 있습니다. |
HostName읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.String | 기본 스트리밍 엔드포인트 호스트 이름입니다. |
LastModified읽기 전용입니다. 미디어 서비스에 의해 설정됩니다. |
Edm.DateTime | 이 엔터티의 마지막 업데이트 시간입니다. |
ScaleUnits읽기 전용입니다. |
Edm.Int32 | StreamingEndpoint 배포에 할당된 프리미엄 스트리밍 엔드포인트 수입니다. StreamingEndpoint가 Running 상태이면 Scale 작업을 호출하여 StreamingEndpoint의 스트리밍 단위를 확장할 수 있습니다.또한 이 속성은 스트리밍 엔드포인트 버전의 조합을 사용하여 스트리밍 엔드포인트 유형을 제어합니다. 스트리밍 엔드포인트 버전이 1.0이고 ScaleUnits=0인 경우 스트리밍 엔드포인트는 클래식 형식입니다. 스트리밍 엔드포인트가 표준 또는 프리미엄 AccessControl인 경우에만 StreamingEndpoint의 속성을 구성할 수 있습니다. , , CustomHostNames, CacheControlCrossSiteAccessPolicies. |
CdnEnabled이 속성은 미디어 서비스 2.9에서 추가되었습니다. |
Edm.Boolean |
이 StreamingEndpoint에 대해 Azure CDN 통합이 사용하도록 설정되었는지 여부를 나타냅니다(기본적으로 사용하지 않도록 설정됨). 를 CdnEnabled true로 설정하려면 StreamingEndpoint 버전 1.0 StreamingEndpoints에 대해 하나 이상의 프리미엄 스트리밍 엔드포인트(ScaleUnits)가 있어야 하며 중지된 상태여야 합니다. ScaleUnits 값에 관계없이 StreamingEndpoint 버전이 2.0인 경우 이 속성을 설정할 수 있습니다(표준 스트리밍 엔드포인트 참조) 작업 REST API를 사용하여 상태 검사. 사용하도록 설정되면 및 AccessControl구성을 사용할 수 없게 CustomHostNames 됩니다.참고: 모든 데이터 센터가 Azure CDN 통합을 지원하는 것은 아닙니다. 데이터 센터에서 Azure CDN 통합을 사용할 수 있는지를 확인하려면 다음을 수행합니다. - CdnEnabled를 true로 설정해봅니다.- "현재 지역에서 CDN 기능을 사용할 수 없으므로 스트리밍 엔드포인트 CdnEnabled 속성을 true로 설정할 수 없습니다."라는 메시지와 함께 (PreconditionFailed)에 대해 HTTP Error Code 412 반환된 결과를 확인합니다.이 오류가 발생하면 데이터 센터가 통합을 지원하지 않는 것입니다. 다른 데이터 센터를 시도해보세요. |
CdnProvider이 속성은 Media Services 2.15에 추가되었습니다. |
Edm.String | CDN을 사용하도록 설정한 경우("CdnEnabled":true) CdnProvider 값을 전달할 수도 있습니다. CdnProvider는 사용할 공급자를 제어합니다. 현재, "StandardVerizon", "PremiumVerizon" 및 "StandardAkamai"의 세 가지 값이 지원됩니다. 값이 제공되지 않고 "CdnEnabled":true이면 "StandardVerizon"이 사용됩니다(기본값). 예: "CdnProvider":"StandardAkamai". 참고: 이전 AMS 버전(<2.15)이 있는 "CDNEnabled":true인 StreamingEndpoints에는 레거시 CDN 통합이 있으며 "StandardVerizon" CDN 공급자를 사용합니다. 더 나은 환경과 전체 기능을 얻으려면 StreamingEndpoints를 최신 CDN 통합으로 마이그레이션하는 것이 좋습니다. |
CdnProfile이 속성은 Media Services 2.15에 추가되었습니다. |
Edm.String | CDN을 사용하도록 설정한 경우("CdnEnabled":true) CdnProfile 값을 전달할 수도 있습니다. "CdnProfile"은 CDN 엔드포인트 지점이 만들어질 CDN 프로필의 이름입니다. 기존 CdnProfile을 제공하거나 새 CdnProfile을 사용할 수 있습니다. 값이 NULL이고 "CdnEnabled":true이면 기본값 "AzureMediaStreamingPlatformCdnProfile"이 사용됩니다. 제공된 CdnProfile이 이미 있는 경우 엔드포인트가 그 아래에 만들어집니다. 프로필이 없으면 새 프로필이 자동으로 생성됩니다. 예: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTime읽기 전용입니다. 이 속성은 Media Services 2.15에 추가되었습니다. |
Edm.DateTime | 새 미디어 서비스 계정이 만들어지면 기본 표준 스트리밍 엔드포인트도 자동으로 계정 아래에 중지된 상태로 프로비전됩니다. 이 엔드포인트에는 15일의 평가판 기간이 포함되며, 엔드포인트가 처음으로 시작될 때 평가판 기간이 시작됩니다. 평가판은 기존 계정에 적용되지 않으며 종료 날짜는 중지/시작과 같은 상태 전환으로 변경되지 않습니다. 무료 평가판은 스트리밍 엔드포인트를 처음 시작하고 15일 후에 종료됩니다. 평가판은 기본 스트리밍 엔드포인트에만 적용되며 추가 스트리밍 엔드포인트에는 적용되지 않습니다. 엔드포인트가 방금 만들어지고 중지된 상태이면 "FreeTrialEndTime" 값이 "0001-01-01T00:00:00Z"로 설정됩니다. 시작 날짜에 15일이 추가되고 평가판 종료 날짜 "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z"를 나타내는 값이 시작됩니다. 평가판에 적합하지 않은 스트리밍 엔드포인트의 값은 상태에 관계없이 항상 "FreeTrialEndTime":"0001-01-01T00:00:00Z"입니다. 예제: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersion이 속성은 Media Services 2.15에 추가되었습니다. |
Edm.String | StreamingEndpointVersion과 ScaleUnits의 조합은 스트리밍 엔드포인트 유형을 제어합니다. 2.15(2017년 1월 10일) 업데이트 이전에 만든 모든 스트리밍 엔드포인트에는 "StreamingEndpointVersion":"1.0"이 있고 업데이트 후에 만든 스트리밍 엔드포인트에는 "StreamingEndpointVersion":"2.0"이 있습니다. 버전 1.0인 스트리밍 엔드포인트는 자동으로 버전 2.0으로 업그레이드되지 않지만 명시적으로 "StreamingEndpointVersion":"2.0"으로 업그레이드할 수 있습니다. "ScaleUnits":0을 사용하여 스트리밍 엔드포인트 및 "StreamingEndpointVersion":"1.0"은 동적 패키징 또는 동적 암호화와 같은 고급 기능이 없는 클래식 스트리밍 엔드포인트로 간주됩니다. "ScaleUnits" > 0이 있는 스트리밍 엔드포인트("StreamingEndpointVersion"이 버전 "1.0" 또는 버전 "2.0"로 설정되어 있는지 여부)는 프리미엄 단위입니다. "ScaleUnits":0을 사용하는 표준 스트리밍 엔드포인트 및 "StreamingEndpointVersion":"2.0"에는 프리미엄 단위와 동일한 기능(동적 패키징 및 동적 암호화 포함)이 포함됩니다. 버전을 "StreamingEndpointVersion":"2.0"으로 설정하여 클래식 스트리밍 엔드포인트를 표준 으로 업그레이드할 수 있습니다. 단방향 작업입니다. 버전 2.0을 1.0으로 다운그레이드할 수 없습니다. 이 작업을 롤백할 수 없고 가격 책정에 미치는 영향이 있음에 주의합니다. 이 새 구성이 전파되려면 최대 30분이 걸릴 수 있습니다. 이 기간 동안 엔드포인트는 성능이 저하된 모드에서 작동하며 동적 패키징 및 동적 암호화 요청에 오류가 발생할 수 있습니다. 예제: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNames선택 사항입니다. |
Collection(Edm.String) | 사용자 지정 호스트 이름으로 리디렉션되는 트래픽을 허용하도록 스트리밍 엔드포인트를 구성하는 데 사용됩니다. 이렇게 하면 GTM(Global Traffic Manager)을 통해 트래픽 관리 구성을 보다 쉽게 수행할 수 있고 브랜드 도메인 이름을 스트리밍 엔드포인트 이름으로 사용할 수 있습니다. Azure Media Services에서 도메인 이름 소유권을 확인해야 합니다. Azure Media Services는 Azure Media Services 계정을 포함하는 CName 레코드를 사용 중인 도메인에 추가할 구성 요소로 요구하여 도메인 이름 소유권을 확인합니다. 예를 들어 스트리밍 엔드포인트의 사용자 지정 호스트 이름으로 "sports.contoso.com"을 사용하려면 Media Services 확인 호스트 이름 중 하나를 가리키도록 "<accountId.contoso.com>"에 대한 레코드를 구성해야 합니다. 확인 호스트 이름은 verifydns로 구성됩니다.<mediaservices-dns-zone>. 다음 표에는 다른 Azure 지역에 대한 확인 레코드에서 사용해야 하는 DNS 영역을 보여 줍니다.북아메리카, 유럽, 싱가포르, 홍콩, 일본: - mediaservices.windows.net - verifydns.mediaservices.windows.net 중국: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn 예를 들어 “945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com”을 “verifydns.mediaservices.windows.net”에 매핑하는 CName 레코드는 Azure Media Services ID 945a4c4e-28ea-45cd-8ccb-a519f6b700ad가 contoso.com 도메인의 소유권을 가지므로 contoso.com 아래의 모든 이름을 해당 계정 아래의 스트리밍 엔드포인트에 대한 사용자 지정 호스트 이름으로 사용할 수 있음을 입증합니다.미디어 서비스 ID 값을 찾으려면 Azure Portal로 이동한 후 미디어 서비스 계정을 선택합니다. 미디어 서비스 ID는 대시보드 페이지의 오른쪽에 나타납니다. 경고: CName 레코드를 적절히 확인하지 않고 사용자 지정 호스트 이름을 설정하려고 하면 DNS 응답이 실패하고 일정 시간 동안 캐시됩니다. 적절한 레코드가 준비되고 나면, 캐시된 응답의 유효성이 다시 확인될 때까지 잠시 시간이 소요될 수 있습니다. 사용자 지정 도메인에 대한 DNS 공급자에 따라, 레코드의 유효성이 다시 확인되기까지 몇 분에서 1시간 정도 걸릴 수 있습니다.<accountId>.<parent domain>을 verifydns.<mediaservices-dns-zone>에 매핑하는 CName 외에도, 사용자 지정 호스트 이름(예: sports.contoso.com)을 Media Services StreamingEndpont 호스트 이름(예: sports.contoso.com)을 Media Services StreamingEndpont의 호스트 이름(예: amstest.streaming.mediaservices.windows.net)에 매핑하는 다른 CName을 만들어야 합니다.참고: 동일한 데이터 센터에 있는 스트리밍 엔드포인트는 동일한 사용자 지정 호스트 이름을 공유할 수 없습니다. 이 속성은 표준 및 프리미엄 스트리밍 엔드포인트에 유효하며 "CdnEnabled":false일 때 설정할 수 있습니다. 현재 AMS는 사용자 지정 도메인을 사용하는 SSL을 지원하지 않습니다. |
AccessControl |
StreamingEndpointAccessControl ComplexType | 이 스트리밍 엔드포인트에 대한 보안 설정(Akamai 서명 헤더 인증 키 및 이 엔드포인트에 연결되도록 허용되는 IP 주소)을 구성하는 데 사용됩니다. 참고: 이 속성은 표준 및 프리미엄 스트리밍 엔드포인트에 유효하며 "CdnEnabled":false일 때 설정할 수 있습니다. |
CacheControl |
StreamingEndpointCacheControl | 이 스트리밍 엔드포인트를 통해 제공된 자산의 자산 캐시 수명을 구성하는 데 사용됩니다. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | 다양한 클라이언트에 대한 사이트 간 액세스 정책을 지정하는 데 사용됩니다. 자세한 내용은 도메인 간 정책 파일 사양 및 여러 도메인 간에 서비스를 사용하도록 지정을 참조하세요. |
StreamingEndpointCacheControl
| 속성 | 형식 | Description |
|---|---|---|
MaxAge선택 사항입니다. |
Edm.Int64 | 미디어 조각 및 주문형 매니페스트에서 스트리밍 엔드포인트가 설정한 기본 max-age HTTP 캐시 제어 헤더를 재정의합니다. 이 값은 초 단위로 설정됩니다. |
StreamingEndpointAccessControl ComplexType
| 속성 | 형식 | Description |
|---|---|---|
Akamai |
AkamaiAccessControl | Akamai 액세스 제어입니다. |
IP |
IPAccessControl | IP 액세스 제어입니다. |
AkamaiAccessControl
| 속성 | 형식 | Description |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Akamai 서명 헤더 인증 키에 대한 정보를 포함합니다. |
IPAccessControl
| 속성 | 형식 | Description |
|---|---|---|
| 허용 | IPRange ComplexType | 스트리밍 엔드포인트에 연결할 수 있는 IP 주소를 정의합니다. 참고: 이 값을 null로 설정하면 모든 IP 원본 주소를 연결할 수 있습니다. Setting it to an empty string (“”) allows no one to connect. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
이 유형에서는 Akamai G20 인증 설정에 대해 설명합니다. Akamai 인증은 키 해시 메시지 인증 체계입니다. 인증 키는 Akamai CDN 및 Azure Media Origin Streaming Service에서 공유하는 비밀입니다. Azure Media Services는 HMAC-MD5를 사용하는 버전 3만 지원합니다.
| 속성 | 형식 | Description |
|---|---|---|
Identifier |
Edm.String | 인증 키의 식별자입니다. Akamai에서 제공하는 nonce입니다. |
Expiration |
Edm.DateTime | Akamai 인증이 만료되는 시기를 지정하는 DateTime 값 |
Base64Key |
Edm.String | CDN에서 사용되는 Base64로 인코딩된 인증 키입니다. Akamai에서 제공하는 인증 키는 ASCII로 인코딩된 문자열이며 바이트로 변환한 다음 base64로 인코딩되어야 합니다. |
다음 C# 예제에서는 Akamai 인증 키를 base64로 변환하는 방법을 보여줍니다.
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| 속성 | 형식 | Description |
|---|---|---|
Name |
Edm.String | 이 IP 범위에 대한 이름입니다. |
Address |
Edm.String | 서브넷 표현의 기본 IP 주소(예: 192.168.0.1)입니다. |
SubnetPrefixLength |
Edm.Int32 | 서브넷 마스크의 최상위 비트 수입니다. 예를 들어 다음 IP 주소 192.168.0.1/24에서 24는 최상위 비트 수를 나타냅니다. |
StreamingEndpoint 만들기
새 StreamingEndpoint 서비스를 만듭니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
샘플 요청
Fiddler의 작성기 탭에서 다음 예제를 사용해 볼 수 있습니다.
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
헤더 요청:
POST https://testrest.cloudapp.net/api/StreamingEndpoints HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
본문 요청:
{
"Id":null,
"Name":"teststreamingendpoint001",
"Description":"",
"Created":"0001-01-01T00:00:00",
"LastModified":"0001-01-01T00:00:00",
"State":null,
"HostName":null,
"ScaleUnits":0,
"CustomHostNames":[
],
"AccessControl":{
"Akamai":{
"AkamaiSignatureHeaderAuthenticationKeyList":[
{
"Identifier":"My key",
"Expiration":"2015-08-08T21:45:34.463Z",
"Base64Key":"/31iWKdqNC7YUnj8zQ3XHA=="
}
]
},
"IP":{
"Allow":[
{
"Name":"Allow all",
"Address":"0.0.0.0",
"SubnetPrefixLength":0
}
]
}
},
"CacheControl":{
"MaxAge":"1800"
},
"CrossSiteAccessPolicies":{
"ClientAccessPolicy":"<access-policy><cross-domain-access><policy><allow-from http-request-headers='*'><domain uri='http://*' /></allow-from><grant-to><resource path='/' include-subpaths='false' /></grant-to></policy></cross-domain-access></access-policy>",
"CrossDomainPolicy":"<?xml version='1.0'?><!DOCTYPE cross-domain-policy SYSTEM 'http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd'><cross-domain-policy><allow-access-from domain='*' /></cross-domain-policy>"
}
}
이 코드가 성공적으로 실행되면 응답 본문에 만든 엔터티가 표시되고 202 수락됨 상태 코드가 반환됩니다.
HTTP/1.1 202 Accepted
Cache-Control: no-cache
Content-Length: 1185
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8
Location: https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3Ad2742eb8-ce32-44b8-aae8-83f21364c291')
Server: Microsoft-IIS/8.5
request-id: 917c74d3-ebc7-48b6-8484-a103054a9e34
x-ms-request-id: 917c74d3-ebc7-48b6-8484-a103054a9e34
operation-id: nb:opid:UUID:ec2e517c-9b33-4af5-baca-e6136acfb40f
X-Content-Type-Options: nosniff
DataServiceVersion: 3.0;
X-Powered-By: ASP.NET
Date: Sun, 10 Aug 2014 00:31:28 GMT
{
"odata.metadata":"https://testrest.cloudapp.net/api/$metadata#StreamingEndpoints/@Element",
"Id":"nb:oid:UUID:d2742eb8-ce32-44b8-aae8-83f21364c291",
"Name":"teststreamingendpoint001",
"Description":"",
"Created":"2014-08-10T00:31:28.6760592Z",
"LastModified":"2014-08-10T00:31:28.6760592Z",
"State":"Stopped",
"HostName":null,
"ScaleUnits":0,
"CustomHostNames":[
],
"AccessControl":{
"Akamai":{
"AkamaiSignatureHeaderAuthenticationKeyList":[
{
"Identifier":"My key",
"Expiration":"2015-08-08T21:45:34.463Z",
"Base64Key":"/31iWKdqNC7YUnj8zQ3XHA=="
}
]
},
"IP":{
"Allow":[
{
"Name":"Allow all",
"Address":"0.0.0.0",
"SubnetPrefixLength":0
}
]
}
},
"CacheControl":{
"MaxAge":"1800"
},
"CrossSiteAccessPolicies":{
"ClientAccessPolicy":"<access-policy><cross-domain-access><policy><allow-from http-request-headers='*'><domain uri='http://*' /></allow-from><grant-to><resource path='/' include-subpaths='false' /></grant-to></policy></cross-domain-access></access-policy>",
"CrossDomainPolicy":"<?xml version='1.0'?><!DOCTYPE cross-domain-policy SYSTEM 'http://www.macromedia.com/xml/dtds/cross-domain-policy.dtd'><cross-domain-policy><allow-access-from domain='*' /></cross-domain-policy>"
}
}
202 수락됨 상태 코드는 비동기 작업을 나타냅니다. 이 경우 StreamingEndpoint 시작 중 또는 중지 중 같은 장기 실행 작업의 상태를 폴링하고 추적하는 데 사용할 수 있도록 operation-id 헤더 값도 제공됩니다. Operation 엔터티에 operation-id 헤더 값을 전달하여 상태를 검색합니다. 자세한 내용은 수동으로 폴링 Long-Running 작업을 참조하세요.
StreamingEndpoint 시작
지정된 StreamingEndpoint를 시작합니다. StreamingEndpoint가 중지됨 상태인 경우에만 시작할 수 있습니다. StreamingEdpoint를 시작한 후 잠시 후 상태가 로 변경됩니다 Running.
나중에 스트리밍을 중지하려면 중지 작업을 호출합니다.
실행 중 상태일 때 사용 가능한 작업입니다.
| 시스템 상태 | 스트리밍 단위 | Description | 가능한 작업 |
|---|---|---|---|
| 실행 중 | 0 | 표준 스트리밍 엔드포인트에서 스트리밍. | 중지, 크기 조정 |
| 실행 중 | >0 | 프리미엄 스트리밍 엔드포인트에서 스트리밍. | 중지, 크기 조정 |
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
샘플 요청
Fiddler의 Composer 탭에서 다음 예제를 사용해 볼 수 있습니다.
헤더 요청:
POST https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427')/Start HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
이 코드가 성공적으로 실행되면 202 수락됨 상태 코드가 반환됩니다. 202 수락됨 상태 코드는 비동기 작업을 나타냅니다. 이 경우 StreamingEndpoint 시작 중 또는 중지 중 같은 장기 실행 작업의 상태를 폴링하고 추적하는 데 사용할 수 있도록 operation-id 헤더 값도 제공됩니다. Operation 엔터티에 operation-id 헤더 값을 전달하여 상태를 검색합니다. 자세한 내용은 수동으로 폴링 Long-Running 작업을 참조하세요.
StreamingEndpoint 중지
지정된 StreamingEndpoint를 중지합니다. StreamingEndpoint가 실행 중 상태인 경우에만 중지할 수 있습니다.
중지됨 상태일 때 사용 가능한 작업입니다.
| 시스템 상태 | 스트리밍 단위 | Description | 가능한 작업 |
|---|---|---|---|
| 중지됨 | 0 | 스트리밍하지 않습니다. | 시작, 크기 조정 |
| 중지됨 | >0 | 스트리밍하지 않습니다. | 시작, 크기 조정 |
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
샘플 요청
Fiddler의 Composer 탭에서 다음 예제를 사용해 볼 수 있습니다.
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
헤더 요청:
POST https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427')/Start HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
이 코드가 성공적으로 실행되면 202 수락됨 상태 코드가 반환됩니다. 202 수락됨 상태 코드는 비동기 작업을 나타냅니다. 이 경우 StreamingEndpoint 시작 중 또는 중지 중 같은 장기 실행 작업의 상태를 폴링하고 추적하는 데 사용할 수 있도록 operation-id 헤더 값도 제공됩니다. Operation 엔터티에 operation-id 헤더 값을 전달하여 상태를 검색합니다. 자세한 내용은 수동으로 폴링 Long-Running 작업을 참조하세요.
StreamingEndpoint 크기 조정
실행 중인 상태에서 스트리밍 단위 용량을 동적으로 업데이트하고 "ScaleUnits":0에서 업데이트된 경우 표준 스트리밍 엔드포인트에서 프리미엄 스트리밍 엔드포인트로 형식을 변경합니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
샘플 요청
Fiddler의 Composer 탭에서 다음 예제를 사용해 볼 수 있습니다.
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
헤더 요청:
POST https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427')/Scale HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
본문 요청:
{"scaleUnits" : 2}
이 코드가 성공적으로 실행되면 202 수락됨 상태 코드가 반환됩니다. 202 수락됨 상태 코드는 비동기 작업을 나타냅니다. 이 경우 StreamingEndpoint 시작 중 또는 중지 중 같은 장기 실행 작업의 상태를 폴링하고 추적하는 데 사용할 수 있도록 operation-id 헤더 값도 제공됩니다. Operation 엔터티에 operation-id 헤더 값을 전달하여 상태를 검색합니다. 자세한 내용은 수동으로 폴링 Long-Running 작업을 참조하세요.
StreamingEndpoint 나열
StreamingEndpoint는 GET HTTP 요청을 사용하여 검색됩니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| GET | 모든 StreamingEndpoint 가져오기: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> 지정된 StreamingEndpoint를 가져옵니다. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
샘플 요청
Fiddler의 Composer 탭에서 다음 예제를 사용해 볼 수 있습니다.
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
헤더 요청:
GET https://testrest.cloudapp.net/api/StreamingEndpoints HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
성공하면 이 작업은 200 OK 상태 코드와 Media Services 계정에서 만든 모든 StreamingEndpoints 목록을 반환합니다.
StreamingEndpoint 업데이트
새로운 속성 값으로 StreamingEndpoint를 업데이트합니다. StreamingEndpoint가 실행 중이고 설정이 변경된 경우 이는 비동기 작업입니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| PATCH/PUT/MERGE 이 작업에 대한 자세한 내용은 PATCH/PUT/MERGE를 참조하세요. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
샘플 요청
Fiddler의 Composer 탭에서 다음 예제를 사용해 볼 수 있습니다. 이 예제에서는 MaxAge 값을 업데이트합니다.
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
헤더 요청:
PATCH https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427') HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
본문 요청:
{"CacheControl":{"MaxAge":"2000"}}
업데이트가 동기적으로 완료되면 204 콘텐츠 없음 상태 코드를 반환하거나 202 수락됨 상태 코드를 반환합니다. 202 수락됨 상태 코드는 비동기 작업을 나타냅니다. 이 경우 StreamingEndpoint 시작 중 또는 중지 중 같은 장기 실행 작업의 상태를 폴링하고 추적하는 데 사용할 수 있도록 operation-id 헤더 값도 제공됩니다. Operation 엔터티에 operation-id 헤더 값을 전달하여 상태를 검색합니다. 자세한 내용은 수동으로 폴링 Long-Running 작업을 참조하세요.
StreamingEndpoint 삭제
StreamingEndpoint를 삭제합니다. StreamingEndpoint는 중지됨 상태인 경우에만 삭제할 수 있습니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
샘플 요청
Fiddler의 Composer 탭에서 다음 예제를 사용해 볼 수 있습니다.
최신 x-ms-version:을 얻으려면 Media Services REST를 참조하세요.
헤더 요청:
DELETE https://testrest.cloudapp.net/api/StreamingEndpoints('nb%3Aoid%3AUUID%3A32ad7fa6-f780-4345-bbc6-45a79a914427') HTTP/1.1
Content-Type: application/json;odata=minimalmetadata
Accept: application/json;odata=minimalmetadata
DataServiceVersion: 3.0;NetFx
MaxDataServiceVersion: 3.0;NetFx
x-ms-version: 2.19
Authorization: Bearer <token value>
이 코드가 성공적으로 실행되면 202 수락됨 상태 코드가 반환됩니다. 202 수락됨 상태 코드는 비동기 작업을 나타냅니다. 이 경우 StreamingEndpoint 시작 중 또는 중지 중 같은 장기 실행 작업의 상태를 폴링하고 추적하는 데 사용할 수 있도록 operation-id 헤더 값도 제공됩니다. Operation 엔터티에 operation-id 헤더 값을 전달하여 상태를 검색합니다. 자세한 내용은 수동으로 폴링 Long-Running 작업을 참조하세요.