你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

StreamingEndpoint

  • 项目

重要

从 Media Services 2.7 开始，Origin 实体已重命名为 StreamingEndpoint。

StreamingEndpoint 实体表示流服务，该服务可以直接将内容传递给客户端播放器应用程序，也可以传递给内容分发网络 (CDN) 进行进一步分发。 从版本 2.9 开始，Microsoft Azure 媒体服务提供 Azure CDN 集成 (有关详细信息，请参阅CdnEnabled下面记录的 属性) 。 来自 StreamingEndpoint 服务的出站流可以是实时流，也可以是媒体服务帐户中的视频点播资产。

每个 azure 媒体服务 (AMS) 帐户都包含一个默认的 StreamingEndpoint;可以在帐户下创建其他 StreamingEndpoints。 从 2017 年 1 月 10 日发布的媒体服务 2.15 () 有两个 StreamingEndpoint 版本： 1.0 和 2.0。 此外，还有三种类型的 StreamingEndpoint： 经典、**标准或 高级。

在 AMS REST 2.15 更新之前创建的媒体服务帐户默认包括 经典 流式处理终结点版本 1.0。 可以升级到 版本 2.0，但无法降级到 1.0。 默认情况下，在 2.15 更新后创建的 AMS 帐户包括 标准 流式处理终结点 版本 2.0。 版本 2.0 流式处理终结点具有计费和功能更改。 有关更多详细信息，请参阅 StreamingEndpointVersion 下面所述的 属性。

自动预配的 StreamingEndpoint 的名称为“Default”，无法删除。 StreamingEndpoint 的状态为 “已停止”。 若要开始流式处理，需要启动流式处理终结点。

如果通过 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 还提供 高级 流式处理终结点，可用于为最大的 Internet 受众横向扩展容量。 如果预期受众和并发查看者较多，请与我们联系，获取是否需要转为 高级 类型的指导。 如果预计并发受众规模超过 50，000 名观众，请在 microsoft.com) 联系我们， (amsstreaming。

通过调整缩放单元移动到 高级 类型。 缩放单元提供专用的出口容量，可以以 200 Mbps 为增量购买。 使用高级类型时，每个启用的单元都为应用程序提供额外的带宽容量。 有关详细信息，请参阅 如何缩放 StreamingEndpoint。

有关详细信息，请参阅： 流式处理终结点概述。

StreamingEndpoint 属性和操作

重要

访问媒体服务中的实体时，必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息，请参阅 设置媒体服务 REST API 开发 和使用 媒体服务 REST API 连接到媒体服务。

本部分概述了 实体， StreamingEndpoint 并演示如何使用媒体服务 REST API 执行各种操作。

StreamingEndpoint 实体

实体 StreamingEndpoint 包含以下属性：

属性 类型 说明
Id

只读。 由 Media Services 设置。		 Edm.String StreamingEndpoint ID，在创建时分配。 格式为：nb：oid：UUID：<GUID>。
Name Edm.String StreamingEndpoint 服务的友好名称。

- 在媒体服务帐户中必须是唯一的。

- 最大长度 = 32 个字符。

- 不能包含空格。

- 仅连字符和字母数字字符。

- 不能以连字符开头或结尾。
Description Edm.String StreamingEndpoint 的说明。 最大长度为 256 个字符。
Created

只读。 由 Media Services 设置。		 Edm.DateTime 由 Microsoft Azure 媒体服务 Live Streaming Preview 服务创建。
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 状态，可以通过调用 Scale 操作来扩展 StreamingEndpoint 上的流式处理单位。

此属性还控制流式处理终结点 类型 与流式处理终结点 版本的组合。 如果流式处理终结点版本为 1.0 且 ScaleUnits=0，则流式处理终结点属于 经典 类型。

仅当流式处理终结点为标准或高级时，才能配置以下 StreamingEndpoint 的属性：AccessControl、、CustomHostNames、CacheControlCrossSiteAccessPolicies。
CdnEnabled

Media Services 2.9 中已添加此属性。		 Edm.Boolean 指示是否启用此 StreamingEndpoint 的 Azure CDN 集成（默认情况下已禁用）。

若要将 CdnEnabled 设置为 true，StreamingEndpoint 必须具有至少一个高级流式处理终结点， (ScaleUnits 版本 1.0 StreamingEndpoints) 并且处于停止状态。 如果 StreamingEndpoint 版本为 2.0，而不考虑 ScaleUnits 值 (请参阅标准流式处理终结点) 使用操作 REST API 检查状态。 启用后，将禁用以下配置： CustomHostNames 和 AccessControl。

注意：并非所有数据中心都支持 Azure CDN 集成。 要检查数据中心是否具有 Azure CDN 集成，请执行以下操作：

- 尝试将 CdnEnabled 设置为 true。

- 检查 (PreconditionFailed) 返回的结果 HTTP Error Code 412 ，并显示消息“无法将流式处理终结点 CdnEnabled 属性设置为 true，因为 CDN 功能在当前区域中不可用”。

如果出现此错误，则数据中心不支持 Azure CDN 集成。 你应该尝试其他数据中心。
CdnProvider

此属性已添加到媒体服务 2.15 中。		 Edm.String (“CdnEnabled”：true) 启用 CDN 时，还可以传递 CdnProvider 值。 CdnProvider 控制将使用哪个提供程序。 目前，支持三个值：“StandardVerizon”、“PremiumVerizon”和“StandardAkamai”。 如果未提供任何值，并且“CdnEnabled”：true，则使用“StandardVerizon” (默认值。)
示例：“CdnProvider”：“StandardAkamai”。

注意：StreamingEndpoints，即“CDNEnabled”：true，与较旧的 AMS 版本 (<2.15) 具有旧的 CDN 集成，并使用“StandardVerizon”CDN 提供程序。 建议将 StreamingEndpoint 迁移到较新的 CDN 集成，以获得更好的体验和完整的功能。
CdnProfile

此属性已添加到媒体服务 2.15 中。		 Edm.String 启用 CDN (“CdnEnabled”：true) 还可以传递 CdnProfile 值。 “CdnProfile”是将在其中创建 CDN 终结点点的 CDN 配置文件的名称。 可以提供现有的 CdnProfile 或使用新的 CdnProfile。 如果值为 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

可选。		 集合 (Edm.String) 用于配置流式处理终结点以接受定向到自定义主机名的流量。 这样可以通过全局流量管理器 (GTM) 更轻松地进行流量管理配置，也可以将品牌域名用作流式处理终结点名称。

域名的所有权必须由 Azure 媒体服务进行确认。 Azure 媒体服务通过要求将包含 Azure 媒体服务帐户 ID 的 CName 记录作为组件添加到正在使用的域来验证域名所有权。 例如，若要将“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 媒体服务 ID 945a4c4e-28ea-45cd-8ccb- a519f6b700ad 拥有 contoso.com 域的所有权，因此可以将 contoso.com 下的任何名称用作该帐户下的流式处理终结点的自定义主机名。

若要查找媒体服务 ID 值，请转至 Azure 门户，然后选择你的媒体服务帐户。 媒体服务 ID 显示在仪表板页的右侧。

警告：如果尝试在没有正确验证 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

名称 类型 说明
Akamai AkamaiAccessControl Akamai 访问控制。
IP IPAccessControl IP 访问控制。

AkamaiAccessControl

名称 类型 说明
AkamaiSignatureHeaderAuthenticationKeyList AkamaiSignatureHeaderAuthenticationKey ComplexType 包含有关 Akamai 签名标头身份验证密钥的信息。

IPAccessControl

名称 类型 说明
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 指定 Akamai 身份验证过期时间的 DateTime 值
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 子网掩码的有效位数（例如，在 192.168.0.1/24 这个 IP 地址中，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 已接受”状态代码表示异步操作，此时还会提供操作 ID 标头值，用于轮询和跟踪长时间运行的操作的状态（例如启动或停止 StreamingEndpoint）。 将操作 ID 标头值传递到 Operation 实体以检索状态。 有关详细信息，请参阅 手动轮询 Long-Running 操作。

启动 StreamingEndpoint

启动指定的 StreamingEndpoint。 只能启动处于“已停止”状态的 StreamingEndpoint。 启动 StreamingEdpoint 的一段时间后，状态将更改为 Running。
若要在以后的时间点停止流式处理，请调用 停止 操作。

处于 “正在运行” 状态时可用的操作。

状态 流式处理单位数 说明 可用操作
正在运行 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 已接受”状态代码表示异步操作，此时还会提供操作 ID 标头值，用于轮询和跟踪长时间运行的操作的状态（例如启动或停止 StreamingEndpoint）。 将操作 ID 标头值传递到 Operation 实体以检索状态。 有关详细信息，请参阅 手动轮询 Long-Running 操作。

停止 StreamingEndpoints

停止指定的 StreamingEndpoint。 只能停止处于“正在运行”状态的 StreamingEndpoint。

处于 “已停止” 状态时的可用操作。

状态 流式处理单位数 说明 可用操作
已停止 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 已接受”状态代码表示异步操作，此时还会提供操作 ID 标头值，用于轮询和跟踪长时间运行的操作的状态（例如启动或停止 StreamingEndpoint）。 将操作 ID 标头值传递到 Operation 实体以检索状态。 有关详细信息，请参阅 手动轮询 Long-Running 操作。

缩放 StreamingEndpoints

在处于运行状态时动态更新流式处理单元容量，如果从“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 已接受”状态代码表示异步操作，此时还会提供操作 ID 标头值，用于轮询和跟踪长时间运行的操作的状态（例如启动或停止 StreamingEndpoint）。 将操作 ID 标头值传递到 Operation 实体以检索状态。 有关详细信息，请参阅 手动轮询 Long-Running 操作。

列出 StreamingEndpoint

使用 GET HTTP 请求检索 StreamingEndpoint。

请求

方法 请求 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 正常 状态代码和在媒体服务帐户中创建的所有 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 已接受”状态代码表示异步操作，此时还会提供操作 ID 标头值，用于轮询和跟踪长时间运行的操作的状态（例如启动或停止 StreamingEndpoint）。 将操作 ID 标头值传递到 Operation 实体以检索状态。 有关详细信息，请参阅 手动轮询 Long-Running 操作。

删除 StreamingEndpoint

删除某个 StreamingEndpoint。 只能删除处于“已停止”状态的 StreamingEndpoint。

请求

方法 请求 URI HTTP 版本
DELETE 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 已接受”状态代码表示异步操作，此时还会提供操作 ID 标头值，用于轮询和跟踪长时间运行的操作的状态（例如启动或停止 StreamingEndpoint）。 将操作 ID 标头值传递到 Operation 实体以检索状态。 有关详细信息，请参阅 手动轮询 Long-Running 操作。

另请参阅

Channel
Program
操作