StreamingEndpoint
重要
Media Services 2.7 より、Origin エンティティは StreamingEndpoint に名称が変更されました。
StreamingEndpoint エンティティは、コンテンツをクライアント プレーヤー アプリケーションに直接配信したり、より広範囲な配布用にコンテンツ配信ネットワーク (CDN) に配信したりできるストリーミング サービスを表します。 バージョン 2.9 以降では、Microsoft Azure Media Servicesは Azure CDN 統合を提供します (詳細については、以下に記載されているプロパティをCdnEnabled参照してください)。 StreamingEndpoint サービスからの送信ストリームには、ライブ ストリーム、または Media Services アカウントのビデオ オンデマンドアセットを指定できます。
各 Azure Media Services (AMS) アカウントには、既定の StreamingEndpoint が含まれています。追加の StreamingEndpoint をアカウントの下に作成できます。 Media Services 2.15 (2017 年 1 月 10 日にリリース) 以降、StreamingEndpoint バージョンは 1.0 と 2.0 の 2 つです。 また、StreamingEndpoints には、 Classic、**Standard、 Premium の 3 種類があります。
AMS REST 2.15 更新前に作成された Media Services アカウントには、既定で クラシック ストリーミング エンドポイントバージョン 1.0 が含まれます。 バージョン 2.0 にアップグレードできます。 1.0 にダウングレードすることはできません。 2.15 更新後に作成された AMS アカウントには、既定で Standard ストリーミング エンドポイントバージョン 2.0 が含まれます。 バージョン 2.0 ストリーミング エンドポイントには、課金と機能の変更があります。 詳細については、以下に記載されているプロパティを StreamingEndpointVersion 参照してください。
自動的にプロビジョニングされた StreamingEndpoint には "Default" という名前が付き、削除できません。 StreamingEndpoint の状態は 停止しています。 ストリーミングを開始するには、ストリーミング エンドポイントを開始する必要があります。
Azure クラシック ポータルを使用してアカウントを作成し、Azure CDN がリージョンで使用できる場合、アカウントには既定で CDN 統合が設定されます ("CdnEnabled":true、"CdnProvider":StandardVerizon、"CdnProfile":AzureMediaStreamingPlatformCdnProfile)。
ほとんどの場合、CDN を有効にしておく必要があります。 ただし、CDN はコンカレンシーに合わせて最適なスケーリングを行うため、最大コンカレンシーが 500 に満たないことが予想される場合は、CDN を無効にすることをお勧めします。
クラシック、Standard、Premium ストリーミング エンドポイントの概要
このセクションで説明する高度な機能には、動的パッケージ化と動的暗号化が含まれます。
動作を次の表にまとめます。
| Type | Version | ScaleUnits | 高度な機能 | CDN | 課金 |
|---|---|---|---|---|---|
| クラシック | 1.0 | 0 | NA | NA | Free |
| Standard ストリーミング エンドポイント (推奨) | 2.0 | 0 | はい | はい | 有料 |
| Premium ストリーミング エンドポイント | 1.0 | >0 | はい | はい | 有料 |
| Premium ストリーミング エンドポイント | 2.0 | >0 | はい | はい | 有料 |
従来のストリーミング エンドポイントを Standard ストリーミング エンドポイントにアップグレードして、エクスペリエンスと高度な機能を向上することをお勧めします。 標準 ストリーミングでは、送信帯域幅も自動的にスケーリングされます。
Standard 型は、実質的にすべてのストリーミング シナリオとオーディエンス サイズで推奨されるオプションです。 非常に要求の厳しい要件を持つお客様の場合、AMS は Premium ストリーミング エンドポイントも提供しています。これは、最大のインターネット対象ユーザーの容量をスケールアウトするために使用できます。 多数の対象ユーザーと同時閲覧者が予想される場合は、 Premium の種類に移行する必要があるかどうかのガイダンスについては、お問い合わせください。 視聴者数が 50,000 人を超えると予想される場合は、(microsoft.com で amsstreaming) お問い合わせください。
スケール ユニットを調整して Premium タイプに移動します。 スケール ユニットでは、200 Mbps 単位で購入できる専用のエグレス容量が提供されます。 Premium 型を使用するときは、有効になっている各ユニットがアプリケーションに追加の帯域幅容量を提供します。 詳細については、「 StreamingEndpoint をスケーリングする方法」を参照してください。
詳しくは、「ストリーミング エンドポイントの概要」をご覧ください。
StreamingEndpoint のプロパティと操作
重要
Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。
このセクションでは、エンティティの StreamingEndpoint 概要と、Media Services REST API を使用してさまざまな操作を実行する方法についても説明します。
StreamingEndpoint エンティティ
エンティティには StreamingEndpoint 、次のプロパティが含まれています。
| プロパティ | Type | 説明 |
|---|---|---|
Id読み取り専用です。 Media Services で設定します。 |
Edm.String | 作成時に割り当てられる StreamingEndpoint ID。 形式は nb:oid:UUID:<GUID です>。 |
Name |
Edm.String | StreamingEndpoint サービスのフレンドリ名。 - Media Services アカウント内で一意である必要があります。 - 最大長 = 32 文字。 - スペースを含めることはできません。 - ハイフンと英数字のみ。 - ハイフンで始めたり終わったりすることはできません。 |
Description |
Edm.String | StreamingEndpoint の説明。 最大長は 256 文字です。 |
Created読み取り専用です。 Media Services で設定します。 |
Edm.DateTime | Microsoft Azure Media Services ライブ ストリーミング プレビュー サービスによって作成されます。 |
State読み取り専用です。 Media Services で設定します。 |
Edm.Int32 | プロパティの値は次のとおりです。 - 停止済み。 作成後の StreamingEndpoint の初期状態。 - 開始中。 StreamingEndpoint が実行状態に遷移中です。 - 実行中。 StreamingEndpoint は、クライアントにコンテンツをストリーミング可能です。 - スケーリング中。 ストリーミング ユニット (ScaleUnits) を増やしているか減らしているところです。 - 停止中。 StreamingEndpoint が停止状態に遷移中です。 |
HostName読み取り専用です。 Media Services で設定します。 |
Edm.String | 既定のストリーミング エンドポイント ホスト名。 |
LastModified読み取り専用です。 Media Services で設定します。 |
Edm.DateTime | このエンティティの最終更新時刻。 |
ScaleUnits読み取り専用です。 |
Edm.Int32 | StreamingEndpoint デプロイに割り当てられた Premium ストリーミング エンドポイントの数。 StreamingEndpoint が Running 状態のとき、Scale 操作を呼び出して、StreamingEndpoint 上のストリーミング ユニットをスケールアップできます。このプロパティは、ストリーミング エンドポイントのバージョンを組み合わせてストリーミング エンドポイントの種類を制御します。 ストリーミング エンドポイントのバージョンが 1.0 で ScaleUnits=0 の場合、ストリーミング エンドポイントは クラシック タイプです。 ストリーミング エンドポイントが Standard または Premium の場合にのみ、StreamingEndpoint のプロパティを構成できます: AccessControl、 CustomHostNames、 CacheControl、 CrossSiteAccessPolicies。 |
CdnEnabledこのプロパティは、Media Services 2.9 で追加されました。 |
Edm.Boolean |
この StreamingEndpoint の Azure CDN 統合が有効かどうかを示します (既定では無効)。 を true に設定 CdnEnabled するには、StreamingEndpoint に、バージョン 1.0 StreamingEndpoints の Premium ストリーミング エンドポイント (ScaleUnits) が少なくとも 1 つあり、停止状態である必要があります。 ScaleUnits の値に関係なく StreamingEndpoint バージョンが 2.0 の場合は、このプロパティを設定できます (「Standard ストリーミング エンドポイント」を参照してください)。 Operation REST API を使用して状態をチェックします。 有効にすると、次の構成が無効になります: CustomHostNames と AccessControl。注: すべてのデータ センターで Azure CDN 統合がサポートされているわけではありません。 対象のデータ センターで Azure CDN 統合を利用できるかどうかを確認するには、次の操作を行います。 - CdnEnabled を true に設定する。- (PreconditionFailed) の返された結果 HTTP Error Code 412 を、"ストリーミング エンドポイント CdnEnabled プロパティは、現在のリージョンでは CDN 機能を使用できないため true に設定できません" というメッセージで確認します。このエラーが発生した場合、そのデータ センターはサポートされていません。 別のデータ センターをお試しください。 |
CdnProviderこのプロパティは Media Services 2.15 で追加されました。 |
Edm.String | CDN が有効になっている場合 ("CdnEnabled":true) CdnProvider 値を渡すこともできます。 CdnProvider は、使用するプロバイダーを制御します。 現時点では、"StandardVerizon"、"PremiumVerizon"、および "StandardAkamai" の 3 つの値がサポートされています。 値が指定されておらず、"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 を使用することもできます。 value が 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" に設定されているかどうか) は Premium ユニットです。 "ScaleUnits":0 を使用した標準ストリーミング エンドポイントおよび "StreamingEndpointVersion":"2.0" には、Premium ユニットと同じ機能が含まれます (動的パッケージ化と動的暗号化が含まれます)。 クラシック ストリーミング エンドポイントを標準にアップグレードするには、バージョンを "StreamingEndpointVersion":"2.0" に設定します。 これは一方向の操作です。バージョン 2.0 を 1.0 にダウングレードすることはできません。 この操作はロールバックできず、料金に影響を与えることに注意してください。 この新しい構成が反映されるまでに最大 30 分かかる場合があります。 この期間中、エンドポイントは機能低下モードで動作し、動的パッケージ化と動的暗号化要求でエラーが発生する可能性があります。 例: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNames省略可能。 |
Collection(Edm.String) | カスタム ホスト名に送信されるトラフィックを受け取るようストリーミング エンドポイントを構成するために使用します。 これにより、Global Traffic Manager (GTM) を通じてトラフィック管理の構成が簡単になり、ストリーミング エンドポイントの名前としてブランド化されたドメイン名を使用することを許可します。 ドメイン名の所有権は、Azure Media Services によって確認される必要があります。 Azure Media Services は、使用中のドメインに追加されるコンポーネントとして Azure Media Services アカウント ID が含まれる CName レコードを要求することで、ドメイン名の所有権を検証します。 たとえば、ストリーミング エンドポイントのカスタム ホスト名として "sports.contoso.com" を使用するには、"accountId.contoso.com>" のレコード<を Media Services 検証ホスト名のいずれかを指すように構成する必要があります。 検証ホスト名は 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 プロバイダーによっては、レコードの再検証に数分から数時間かかることがあります。<accountId>.<parent domain> を verifydns.<mediaservices-dns-zone> にマップする CName に加えて、カスタム ホスト名 (たとえば、sports.contoso.com) を Media Services StreamingEndpont のホスト名 (たとえば、amstest.streaming.mediaservices.windows.net) にマップする別の CName を作成する必要があります。注意: 同じデータ センターにあるストリーミング エンドポイントで、同じカスタム ホスト名を共有することはできません。 このプロパティは Standard および Premium ストリーミング エンドポイントに対して有効であり、"CdnEnabled":false の場合に設定できます なお、現在のところ、AMS ではカスタム ドメインを使用した SSL はサポートされていません。 |
AccessControl |
StreamingEndpointAccessControl ComplexType | このストリーミング エンドポイントのセキュリティ設定 (このエンドポイントに接続することが許可された Akamai 署名認証キーと IP アドレス) 構成するために使用されます。 注: このプロパティは Standard および Premium ストリーミング エンドポイントに対して有効であり、"CdnEnabled":false の場合に設定できます |
CacheControl |
StreamingEndpointCacheControl | このストリーミング エンドポイントを通じて提供される資産の資産キャッシュ有効期間を構成するために使用されます。 |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | さまざまなクライアントのクロス サイト アクセス ポリシーを指定するために使用されます。 詳しくは、Cross-domain ポリシー ファイルの仕様と「Making a Service Available Across Domain Boundaries」(ドメインの境界を越えてサービスを利用できるようにする) をご覧ください。 |
StreamingEndpointCacheControl
| 名前 | Type | 説明 |
|---|---|---|
MaxAge省略可能。 |
Edm.Int64 | メディア フラグメントとオンデマンドのマニフェスト上のストリーミング エンドポイントで設定されている、既定の max-age HTTP キャッシュ コントロール ヘッダーをオーバーライドします。 値は秒単位で設定されます。 |
StreamingEndpointAccessControl ComplexType
| 名前 | Type | Description |
|---|---|---|
Akamai |
AkamaiAccessControl | Akamai アクセス制御。 |
IP |
IPAccessControl | IP アクセス制御。 |
AkamaiAccessControl
| 名前 | Type | Description |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Akamai 署名ヘッダー認証キーに関する情報が含まれます。 |
IPAccessControl
| 名前 | Type | Description |
|---|---|---|
| Allow | IPRange ComplexType | ストリーミング エンドポイントに接続可能な IP アドレスを定義します。 注: この値を null に設定すると、すべての IP ソース アドレスが接続できるようになります。 空の文字列 ("") に設定すると、どこからの接続も許可しません。 |
AkamaiSignatureHeaderAuthenticationKey ComplexType
この種類では、Akamai G20 認証設定について説明します。 Akamai 認証は、キー付きハッシュ メッセージ認証スキームです。 認証キーは、Akamai CDN と Azure Media Origin Streaming Service によって共有されるシークレットです。 Azure Media Services では、HMAC-MD5 を使用するバージョン 3 のみがサポートされています。
| 名前 | Type | 説明 |
|---|---|---|
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
| 名前 | Type | 説明 |
|---|---|---|
Name |
Edm.String | この IP 範囲のフレンドリ名。 |
Address |
Edm.String | サブネット表記の基本 IP アドレス (例: 192.168.0.1)。 |
SubnetPrefixLength |
Edm.Int32 | サブネット マスクの有効ビット数 (たとえば、IP アドレス 192.168.0.1/24 の場合は、24 が有効ビット数を表しています)。 |
StreamingEndpoint の作成
新しい StreamingEndpoint サービスを作成します。
Request
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
| POST | <https:// accountname.restv2>。<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
要求のサンプル
Fiddler の [Composer] タブで次の例を試すことができます。
最新 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 Accepted ステータス コードと、作成されたエンティティの表記が返されます。
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 受理されました] ステータス コードは非同期操作を示しています。この場合、操作 ID ヘッダー値は、StreamingEndpoint の開始や停止など、長時間実行処理のステータスのポーリングと追跡にも使用されます。 ステータスを取得するために、操作 ID ヘッダー値を操作エンティティに渡します。 詳細については、「 手動で Long-Running 操作をポーリングする」を参照してください。
StreamingEndpoint の開始
指定した StreamingEndpoint を開始します。 StreamingEndpoint は、[Stopped] 状態の場合にのみ開始できます。 StreamingEdpoint を開始してからしばらくすると、状態が に Running変わります。
後の時点でストリーミングを停止するには、 Stop 操作を呼び出します。
実行中の状態の場合に使用可能なアクション。
| State | ストリーミング ユニット数 | Description | 利用可能なアクション |
|---|---|---|---|
| 実行中 | 0 | Standard ストリーミング エンドポイントからのストリーミング。 | 停止、スケール |
| 実行中 | >0 | Premium ストリーミング エンドポイントからのストリーミング。 | 停止、スケール |
Request
| Method | 要求 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 受理されました] ステータス コードは非同期操作を示しています。この場合、操作 ID ヘッダー値は、StreamingEndpoint の開始や停止など、長時間実行処理のステータスのポーリングと追跡にも使用されます。 ステータスを取得するために、操作 ID ヘッダー値を操作エンティティに渡します。 詳細については、「 Long-Running 操作を手動でポーリングする」を参照してください。
StreamingEndpoint の停止
指定した StreamingEndpoint を停止します。 StreamingEndpoint は、[Running] 状態の場合にのみ停止できます。
停止状態の場合に使用可能なアクション。
| State | ストリーミング ユニット数 | Description | 利用可能なアクション |
|---|---|---|---|
| 停止済み | 0 | ストリーミングされません。 | Start、Scale |
| 停止済み | >0 | ストリーミングされません。 | Start、Scale |
Request
| Method | 要求 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 受理されました] ステータス コードは非同期操作を示しています。この場合、操作 ID ヘッダー値は、StreamingEndpoint の開始や停止など、長時間実行処理のステータスのポーリングと追跡にも使用されます。 ステータスを取得するために、操作 ID ヘッダー値を操作エンティティに渡します。 詳細については、「 Long-Running 操作を手動でポーリングする」を参照してください。
StreamingEndpoint のスケーリング
実行中の状態でストリーミング ユニットの容量を動的に更新し、"ScaleUnits":0 から更新された場合は、種類を Standard Streaming Endpoint から Premium Streaming Endpoint に変更します。
Request
| Method | 要求 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 受理されました] ステータス コードは非同期操作を示しています。この場合、操作 ID ヘッダー値は、StreamingEndpoint の開始や停止など、長時間実行処理のステータスのポーリングと追跡にも使用されます。 ステータスを取得するために、操作 ID ヘッダー値を操作エンティティに渡します。 詳細については、「 Long-Running 操作を手動でポーリングする」を参照してください。
StreamingEndpoint のリスト
StreamingEndpoint は、GET HTTP 要求を使用して取得します。
Request
| Method | 要求 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 アカウントで作成されたすべての StreamingEndpoint の一覧を返します。
StreamingEndpoint の更新
StreamingEndpoint を新しいプロパティ値で更新します。 StreamingEndpoint が実行中で、設定が変更されている場合、これは非同期操作になります。
Request
| Method | 要求 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 No Content ステータス コードが返されます。そうでない場合は、202 Accepted ステータス コードが返されます。 [202 受理されました] ステータス コードは非同期操作を示しています。この場合、操作 ID ヘッダー値は、StreamingEndpoint の開始や停止など、長時間実行処理のステータスのポーリングと追跡にも使用されます。 ステータスを取得するために、操作 ID ヘッダー値を操作エンティティに渡します。 詳細については、「 Long-Running 操作を手動でポーリングする」を参照してください。
StreamingEndpoint の削除
StreamingEndpoint を削除します。 StreamingEndpoint は、[Stopped] 状態の場合にのみ削除できます。
Request
| Method | 要求 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 受理されました] ステータス コードは非同期操作を示しています。この場合、操作 ID ヘッダー値は、StreamingEndpoint の開始や停止など、長時間実行処理のステータスのポーリングと追跡にも使用されます。 ステータスを取得するために、操作 ID ヘッダー値を操作エンティティに渡します。 詳細については、「 Long-Running 操作を手動でポーリングする」を参照してください。