共用方式為

StreamingEndpoint

  • 發行項

重要

自 Media Services 2.7 起，Origin 實體已重新命名為 StreamingEndpoint。

StreamingEndpoint 實體代表可以將內容直接傳遞至用戶端播放器應用程式，或傳遞至「內容傳遞網路 (CDN)」進行進一步散發的串流服務。 從 2.9 版開始，Microsoft Azure 媒體服務提供 Azure CDN 整合 (以取得詳細資訊，請參閱 CdnEnabled 下列) 所述的屬性。 來自 StreamingEndpoint 服務的輸出資料流程可以是即時串流，或媒體服務帳戶中的視訊隨選資產。

每個 Azure 媒體服務 (AMS) 帳戶都包含預設的 StreamingEndpoint;您可以在帳戶下建立其他 StreamingEndpoints。 從媒體服務 2.15 開始， (于 2017 年 1 月 10 日發行) 有兩個 StreamingEndpoint 版本： 1.0 和 2.0。 此外，還有三種類型的 StreamingEndpoint： 傳統、**Standard 或 Premium。

根據預設，在 AMS REST 2.15 更新之前建立的媒體服務帳戶包含 傳統 串流端點 1.0版。 您可以升級至 2.0版，無法降級為 1.0。 在 2.15 更新之後建立的 AMS 帳戶預設包括 標準 串流端點 2.0版。 2.0版串流端點有計費和功能變更。 如需詳細資訊，請參閱 StreamingEndpointVersion 以下所述的屬性。

自動布建的 StreamingEndpoint 名稱為 「Default」，因此無法刪除。 StreamingEndpoint 的狀態為 Stopped。 若要開始串流處理，您必須啟動串流端點。

如果您透過 Azure 傳統入口網站建立帳戶，且區域中有 Azure CDN 可用，則帳戶預設會有 CDN 整合 (「CdnEnabled」：true、「CdnProvider」：StandardVerizon 和 「CdnProfile」：AzureMediaStreamingPlatformCdnProfile) 。

在大部分情況下，您應該讓 CDN 保持啟用狀態。 不過，如果您預期同時觀看人數最多不會超過 500 人，則建議您停用 CDN，因為 CDN 的功能是依據同時觀看人數進行最佳調整。

傳統、標準、進階串流端點概觀

本節所述的進階功能包括動態封裝和動態加密。

此表格總結了以下行為：

類型 版本 ScaleUnits 進階功能 CDN 計費
傳統 1.0 0 NA NA 免費
標準串流端點 (建議) 2.0 0 是 是 已支付
進階串流端點 1.0 >0 是 是 已支付
進階串流端點 2.0 >0 是 是 已支付

建議您將 傳統 串流端點升級至 標準 串流端點，以取得更好的體驗和進階功能。 標準 串流也會自動調整輸出頻寬。

標準類型是幾乎所有串流案例和觀眾規模的建議選項。 對於需求非常需求的客戶，AMS 也提供 進階 串流端點，可用來向外延展最大網際網路物件的容量。 如果您預期大型物件和並行檢視者，請與我們連絡，以取得是否需要移至 Premium 類型的指引。 一個良好的指南文章是如果您預期同時超過 50，000 位檢視者，請在 microsoft.com) 與我們連絡 (amsstreaming。

您可以藉由調整縮放單位來移至 Premium 類型。 縮放單位提供專用輸出容量，可透過 200 Mbps 的增量購買。 使用進階類型時，每個啟用的單位會提供額外頻寬容量給應用程式。 如需詳細資訊，請參閱 如何調整 StreamingEndpoint。

如需詳細資訊，請參閱串流端點概觀。

StreamingEndpoint 屬性和作業

重要

在媒體服務中存取實體時，您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊，請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務。

本節提供實體的概 StreamingEndpoint 觀，並示範如何使用媒體服務 REST API 執行各種作業。

StreamingEndpoint 實體

實體 StreamingEndpoint 包含下列屬性：

屬性 類型 說明
Id

唯讀。 由 Media Services 設定。		 Edm.String 在建立時指派的 StreamingEndpoint 識別碼。 格式為：nb：oid：UUID： < GUID > 。
Name Edm.String StreamingEndpoint 服務的易記名稱。

- 在您的媒體服務帳戶內必須是唯一的。

- 長度上限 = 32 個字元。

- 不能包含空格。

- 僅限連字號和英數位元。

- 不能以連字號開頭或結尾。
Description Edm.String StreamingEndpoint 的描述。 最大長度是 256 個字元。
Created

唯讀。 由 Media Services 設定。		 Edm.DateTime 由Microsoft Azure 媒體服務即時串流預覽服務所建立。
State

唯讀。 由 Media Services 設定。		 Edm.Int32 屬性的值包括：

- 已停止。 StreamingEndpoint 在建立之後的初始狀態。

- 啟動中。 StreamingEndpoint 正在轉換為執行中狀態。

- 執行中。 StreamingEndpoint 可將內容串流至用戶端。

- 正在調整大小。 串流單位 (ScaleUnits) 正在增加或減少。

- 停止中。 StreamingEndpoint 正在轉換為已停止狀態。
HostName

唯讀。 由 Media Services 設定。		 Edm.String 預設串流端點主機名稱。
LastModified

唯讀。 由 Media Services 設定。		 Edm.DateTime 此實體的上次更新時間。
ScaleUnits

唯讀。

 Edm.Int32 為 StreamingEndpoint 部署配置的進階串流端點數目。 當 StreamingEndpoint 處於 Running 狀態時，StreamingEndpoint 上的串流單位可以藉由呼叫 Scale 作業進行調整。

此屬性也會使用串流端點版本的組合，控制串流端點類型。 如果您的串流端點版本是 1.0，而 ScaleUnits=0，則串流端點是 傳統 類型。

只有在串流端點是 標準 或 進階時，才能設定下列 StreamingEndpoint 的屬性： AccessControl 、、 CustomHostNames 、 CacheControlCrossSiteAccessPolicies 。
CdnEnabled

Media Services 2.9 已加入這個屬性。		 Edm.Boolean 指出此 StreamingEndpoint 的 Azure CDN 整合已啟用 (預設為停用。)

若要將 設定 CdnEnabled 為 true，StreamingEndpoint 至少必須有一個進階串流端點， (ScaleUnits 1.0 StreamingEndpoint 的) ，且處於停止狀態。 如果 StreamingEndpoint 版本是 2.0，不論 ScaleUnits 值 (都可以設定此屬性，請參閱 標準 串流端點) 使用 作業 REST API 檢查狀態。 啟用之後，會停用下列組態： CustomHostNames 和 AccessControl 。

注意：並非所有資料中心都支援 Azure CDN 整合。 若要檢查您的資料中心是否有 Azure CDN 整合，可執行下列動作：

- 試著將 CdnEnabled 設為 True。

- 檢查傳回的結果 HTTP Error Code 412 中是否有 (PreconditionFailed) 訊息：「串流端點 CdnEnabled 屬性無法設定為 true，因為目前區域中無法使用 CDN 功能」。

如果您收到此錯誤，表示資料中心不支援此功能。 您應該嘗試使用另一個資料中心。
CdnProvider

此屬性已新增至媒體服務 2.15。		 Edm.String 啟用 CDN (「CdnEnabled」：true) 您也可以傳遞 CdnProvider 值。 CdnProvider 會控制將使用哪一個提供者。 目前支援三個值："StandardVerizon"、"PremiumVerizon" 和 "StandardAkamai"。 如果未提供任何值，且 「CdnEnabled」：true，則會使用 「StandardVerizon」 (預設值。)
範例：「CdnProvider」：「StandardAkamai」。

注意：StreamingEndpoints，其為 「CDNEnabled」：true，舊版 AMS (< 2.15) 具有舊版 CDN 整合，並使用 「StandardVerizon」 CDN 提供者。 建議您將 StreamingEndpoints 移轉至較新的 CDN 整合，以取得更佳的體驗和完整功能。
CdnProfile

此屬性已新增至媒體服務 2.15。		 Edm.String 啟用 CDN (「CdnEnabled」：true) 您也可以傳遞 CdnProfile 值。 「CdnProfile」 是 CDN 端點建立所在 CDN 設定檔的名稱。 您可以提供現有的 CdnProfile 或使用新的 CdnProfile。 如果 value 為 Null 且 「CdnEnabled」：true，則會使用預設值 「AzureMediaStreamingPlatformCdnProfile」。 如果提供的 CdnProfile 已經存在，則會在它下建立端點。 如果設定檔不存在，則會自動建立新的設定檔。
範例：「CdnProfile」：「AzureMediaStreamingPlatformCdnProfile」。
FreeTrialEndTime
唯讀。

此屬性已新增至媒體服務 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

此屬性已新增至媒體服務 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) 進行較簡單的流量管理設定，以及使用品牌化的網域名稱作為串流端點名稱。

網域名稱的擁有權必須通過 Azure 媒體服務的確認。 Azure 媒體服務會透過要求 CName 記錄包含 Azure 媒體服務帳戶識別碼，以作為要新增至使用中網域的元件，來驗證網域名稱的擁有權。 例如，若要將 「sports.contoso.com」 當做串流端點的自訂主機名稱使用，必須將 「 < 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 媒體服務識別碼 945a4c4e-28ea-45cd-8ccb-a519f6b700ad 有 contoso.com 網域的擁有權，因此可讓 contoso.com 底下的任何名稱作為該帳戶底下串流端點的自訂主機名稱。

若要尋找媒體服務識別碼的值，請前往 Azure 入口網站，然後選取您的媒體服務帳戶。 媒體服務識別碼會出現在 [儀表板] 頁面的右側。

警告：如果有人嘗試設定自訂主機名稱，但沒有適當的 CName 記錄驗證，則 DNS 回應會失敗，然後快取會執行一段時間。 當適當的記錄就緒後，可能需要等待一段時間，才會重新驗證快取的回應。 視自訂網域的 DNS 提供者而定，重新驗證記錄可能會花費幾分鐘到一小時的時間。

除了將 <accountId>.<parent domain> 對應到 verifydns.<mediaservices-dns-zone> 的 CName，您必須建立另一個 CName，將自訂主機名稱 (例如，sports.contoso.com) 對應到您的媒體服務 StreamingEndpont 主機名稱 (例如，amstest.streaming.mediaservices.windows.net)。

請注意：如果串流端點位於相同的資料中心內，則不能共用相同的自訂主機名稱。
此屬性適用于標準和進階串流端點，而且可以在 「CdnEnabled」：false 時設定

請注意，目前 AMS 不支援使用 SSL 搭配自訂網域。
AccessControl StreamingEndpointAccessControl ComplexType 用來設定此串流端點的下列安全性設定：Akamai 簽章標頭驗證金鑰和可以連線至此端點的 IP 位址。
注意：此屬性適用于標準和進階串流端點，而且可以在 「CdnEnabled」：false 時設定
CacheControl StreamingEndpointCacheControl 用來為透過此串流端點而提供的資產設定資產快取生命週期。
CrossSiteAccessPolicies CrossSiteAccessPolicies 用來指定不同用戶端的跨網站存取原則。 如需詳細資訊，請參閱跨網域原則檔案規格和使服務可跨網域界限使用。

StreamingEndpointCacheControl

名稱 類型 描述
MaxAge

選擇性。		 Edm.Int64 覆寫媒體片段和隨選資訊清單上預設的 max-age HTTP 快取控制標頭 (由串流端點設定)。 此值的設定會以秒為單位。

StreamingEndpointAccessControl ComplexType

名稱 類型 Description
Akamai AkamaiAccessControl Akamai 存取控制。
IP IPAccessControl IP 存取控制。

AkamaiAccessControl

名稱 類型 Description
AkamaiSignatureHeaderAuthenticationKeyList AkamaiSignatureHeaderAuthenticationKey ComplexType 包含 Akamai 簽章標頭驗證金鑰的相關資訊。

IPAccessControl

名稱 類型 Description
Allow IPRange ComplexType 定義可連接到串流端點的 IP 位址。

注意：將此值設定為 null 可讓所有 IP 來源位址連線。 將其設定為空字串 (“”) 將不允許任何連線。

AkamaiSignatureHeaderAuthenticationKey ComplexType

此類型描述 Akamai G20 驗證設定。 Akamai 驗證是金鑰雜湊訊息驗證配置。 驗證金鑰是由 Akamai CDN 和 Azure 媒體原始串流服務共用的秘密。 Azure 媒體服務僅支援使用 HMAC-MD5 第 3 版。

名稱 類型 描述
Identifier Edm.String 驗證金鑰的識別碼。 這是 Akamai 提供的 nonce。
Expiration Edm.DateTime DateTime 值，指定 Akamai 驗證到期的時間
Base64Key Edm.String Base64 編碼的驗證金鑰會由 CDN 使用。 Akamai 提供的驗證金鑰是 ASCII 編碼字串，必須轉換成位元組，然後以 base64 編碼。

下列 C# 範例示範如何將 Akamai 驗證金鑰轉換為 base64：

string akamaiKey = "01234567890123456789012345678901";  
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);

IPRange ComplexType

名稱 類型 描述
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: ，請參閱 媒體服務 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。 將作業 ID 標頭值傳至作業實體以擷取狀態。 如需詳細資訊，請參閱 手動輪詢 Long-Running 作業。

啟動 StreamingEndpoint

啟動指定的 StreamingEndpoint。 只有在 StreamingEndpoint 處於 [已停止] 狀態時，才能啟動 StreamingEndpoint。 啟動 StreamingEdpoint 之後一段時間，狀態會變更為 Running 。
若要在稍後的時間點停止串流，請呼叫 Stop 作業。

處於 [執行 中] 狀態時的可用動作。

狀態 串流處理單位 Description 可用的動作
執行中 0 從標準串流端點進行串流處理。 停止，擴充
執行中 >0 從進階串流端點進行串流處理。 停止，擴充

要求

方法 要求 URI HTTP 版本
POST HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/StreamingEndpoints ('StreamingEndpointId> ') /Start HTTP/1.1

範例要求

您可以在 Fiddler的 [編輯器] 索引標籤中試用下列範例。

要求標頭：

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。 將作業 ID 標頭值傳至作業實體以擷取狀態。 如需詳細資訊，請參閱 手動輪詢 Long-Running 作業。

停止 StreamingEndpoint

停止指定的 StreamingEndpoint。 只有在 StreamingEndpoint 處於 [執行中] 狀態時，才能停止 StreamingEndpoint。

處於 [已停止 ] 狀態時的可用動作。

狀態 串流處理單位 Description 可用的動作
已停止 0 未串流。 開始，擴充
已停止 >0 未串流。 開始，擴充

要求

方法 要求 URI HTTP 版本
POST HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/StreamingEndpoints ('StreamingEndpointId> ') /Stop HTTP/1.1

範例要求

您可以在 Fiddler的 [編輯器] 索引標籤中試用下列範例。

若要取得最新的 x-ms-version: ，請參閱 媒體服務 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。 將作業 ID 標頭值傳至作業實體以擷取狀態。 如需詳細資訊，請參閱 手動輪詢 Long-Running 作業。

調整 StreamingEndpoint

在處於執行中狀態時，動態更新串流單位容量，並在從 「ScaleUnits」：0 更新時，將類型從標準串流端點變更為進階串流端點。

要求

方法 要求 URI HTTP 版本
POST HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/StreamingEndpoints ('StreamingEndpointId> ') /Scale HTTP/1.1

範例要求

您可以在 Fiddler的 [編輯器] 索引標籤中試用下列範例。

若要取得最新的 x-ms-version: ，請參閱 媒體服務 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。 將作業 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的 [編輯器] 索引標籤中試用下列範例。

若要取得最新的 x-ms-version: ，請參閱 媒體服務 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 狀態碼，以及您在媒體服務帳戶中建立的所有 StreamingEndpoint 清單。

更新 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的 [編輯器] 索引標籤中試用下列範例。此範例會更新 MaxAge 值。

若要取得最新的 x-ms-version: ，請參閱 媒體服務 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。 將作業 ID 標頭值傳至作業實體以擷取狀態。 如需詳細資訊，請參閱 手動輪詢 Long-Running 作業。

刪除 StreamingEndpoint

刪除 StreamingEndpoint。 只有在 StreamingEndpoint 處於 [已停止] 狀態時，才能刪除 StreamingEndpoint。

要求

方法 要求 URI HTTP 版本
刪除 HTTPs:// < accountname.restv2 > 。 <location.media.azure.net/api/StreamingEndpoints ('StreamingEndpointId> ') HTTP/1.1

範例要求

您可以在 Fiddler的 [編輯器] 索引標籤中試用下列範例。

若要取得最新的 x-ms-version: ，請參閱 媒體服務 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。 將作業 ID 標頭值傳至作業實體以擷取狀態。 如需詳細資訊，請參閱 手動輪詢 Long-Running 作業。

另請參閱

通道
程式
運算