StreamingEndpoint
Importante
A partir de los Servicios multimedia 2.7, el nombre de la entidad Origin se ha cambiado a StreamingEndpoint.
La entidad StreamingEndpoint representa un servicio de streaming que puede entregar contenido directamente a una aplicación de reproducción del cliente o a una Red de entrega de contenido (CDN) para su distribución posterior. A partir de la versión 2.9, Microsoft Azure Media Services proporciona la integración de Azure CDN (para obtener más información, consulte la CdnEnabled propiedad documentada a continuación). La secuencia de salida de un servicio StreamingEndpoint puede ser una transmisión en directo o un recurso de vídeo a petición en la cuenta de Media Services.
Cada cuenta de Azure Media Services (AMS) incluye un streamingendpoint predeterminado; se pueden crear puntos de conexión adicionales en la cuenta. A partir de Media Services 2.15 (publicado el 10 de enero de 2017), hay dos versiones de StreamingEndpoint: 1.0 y 2.0. Además, hay tres tipos de StreamingEndpoints: Classic, **Standard o Premium.
Las cuentas de Media Services creadas antes de la actualización de REST 2.15 de AMS, incluyen de forma predeterminada puntos de conexión de streaming clásicos , versión 1.0. Puede actualizar a la versión 2.0, no puede cambiar a la versión 1.0. Las cuentas de AMS creadas después de la actualización 2.15 incluyen de forma predeterminada puntos de conexión de streaming estándar , versión 2.0. Los puntos de conexión de streaming de la versión 2.0 tienen cambios de características y facturación. Para obtener información más detallada, vea la StreamingEndpointVersion propiedad documentada a continuación.
El objeto StreamingEndpoint aprovisionado automáticamente tiene el nombre "Default" y no se puede eliminar. El estado de StreamingEndpoint es Detenido. Para iniciar el streaming, debe iniciar el punto de conexión de streaming.
Si creó la cuenta a través del Portal de Azure clásico y Azure CDN está disponible en la región, la cuenta tendrá la integración de cdn de forma predeterminada ("CdnEnabled":true, "CdnProvider":StandardVerizon y "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
En la mayoría de los casos, debe mantener la red CDN habilitada. Sin embargo, si prevé una simultaneidad máxima inferior a 500 visores, se recomienda deshabilitar la red CDN, ya que esta escala mejor con simultaneidad.
Introducción a los puntos de conexión de streaming clásicos, Estándar y Premium
Entre las características avanzadas descritas en esta sección se incluyen el empaquetado dinámico y el cifrado dinámico.
La tabla proporciona un resumen del comportamiento:
| Tipo | Versión | Unidades de escalado | Características avanzadas | CDN | Facturación |
|---|---|---|---|---|---|
| Clásico | 1.0 | 0 | N/D | N/D | Gratuito |
| Punto de conexión de streaming estándar (recomendado) | 2.0 | 0 | Sí | Sí | De pago |
| Punto de conexión de streaming premium | 1.0 | >0 | Sí | Sí | De pago |
| Punto de conexión de streaming premium | 2.0 | >0 | Sí | Sí | De pago |
Se recomienda actualizar los puntos de conexión de streaming clásicos a los puntos de conexión de streaming estándar para obtener una mejor experiencia y características avanzadas. El streaming estándar también escala automáticamente el ancho de banda de salida.
El tipo estándar es la opción recomendada para prácticamente todos los escenarios de streaming y tamaños de audiencia. Para los clientes con requisitos extremadamente exigentes, AMS también ofrece puntos de conexión de streaming Premium , que se pueden usar para escalar horizontalmente la capacidad para las audiencias de Internet más grandes. Si espera audiencias grandes y espectadores simultáneos, póngase en contacto con nosotros para obtener instrucciones sobre si necesita pasar al tipo Premium . Una buena publicación de guía es ponerse en contacto con nosotros (amsstreaming en microsoft.com) si espera un tamaño de audiencia simultáneo superior a 50.000 espectadores.
Para pasar a un tipo Premium , ajuste las unidades de escalado. Las unidades de escalado proporcionan capacidad de salida dedicada que se puede adquirir en incrementos de 200 Mbps. Cuando se usa el tipo premium, cada unidad habilitada proporciona capacidad de ancho de banda adicional a la aplicación. Para obtener más información, vea Escalado de streamingEndpoint.
Para obtener más información, consulte Streaming endpoints overview (Información general de puntos de conexión de streaming).
Operaciones y propiedades de StreamingEndpoint
Importante
Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración del desarrollo de la API de REST de Media Services y Conexión a Media Services con la API de REST de Media Services.
En esta sección se proporciona información general sobre la StreamingEndpoint entidad y también se muestra cómo ejecutar varias operaciones con la API de REST de Media Services.
Entidad StreamingEndpoint
La StreamingEndpoint entidad contiene las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
IdSolo lectura. Establecido por Servicios multimedia. |
Edm.String | Identificador de StreamingEndpoint, asignado durante la creación. El formato es: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Nombre descriptivo para el servicio StreamingEndpoint. - Debe ser único dentro de su cuenta de Media Services. - Longitud máxima = 32 caracteres. - No se pueden contener espacios. - Guiones y caracteres alfanuméricos únicamente. - No se puede comenzar ni terminar con un guión. |
Description |
Edm.String | Descripción de StreamingEndpoint. La longitud máxima es de 256 caracteres. |
CreatedSolo lectura. Establecido por Servicios multimedia. |
Edm.DateTime | Creado por el servicio Microsoft Azure Media Services Live Streaming Preview. |
StateSolo lectura. Establecido por Servicios multimedia. |
Edm.Int32 | Los valores para la propiedad son: - Stopped. Estado inicial de un elemento StreamingEndpoint después de la creación. - Starting. El elemento StreamingEndpoint realiza la transición al estado en ejecución. - Running. El elemento StreamingEndpoint puede transmitir contenido a los clientes. - Scaling. Las unidades de streaming (ScaleUnits) están aumentado o disminuyendo. - Stopping. El elemento StreamingEndpoint realiza la transición al estado detenido. |
HostNameSolo lectura. Establecido por Servicios multimedia. |
Edm.String | Nombre de host del extremo de streaming predeterminado. |
LastModifiedSolo lectura. Establecido por Servicios multimedia. |
Edm.DateTime | Hora de la última actualización para esta entidad. |
ScaleUnitsSolo lectura. |
Edm.Int32 | Número de puntos de conexión de streaming premium asignados para la implementación de StreamingEndpoint. Cuando el elemento StreamingEndpoint se encuentra en el estado Running, las unidades de streaming del StreamingEndpoint pueden aumentarse llamando a la operación Scale.Esta propiedad también controla el tipo de punto de conexión de streaming con la combinación de la versión del punto de conexión de streaming. Si la versión del punto de conexión de streaming es 1.0 y ScaleUnits=0, el punto de conexión de streaming es de un tipo clásico . Las siguientes propiedades de StreamingEndpoint solo se pueden configurar si el punto de conexión de streaming es estándar o premium: AccessControl, CustomHostNames, CacheControl, CrossSiteAccessPolicies. |
CdnEnabledEsta propiedad se agregó en Media Services 2.9. |
Edm.Boolean |
Indica si la integración de CDN de Azure de este StreamingEndpoint está habilitada o no (está deshabilitada de forma predeterminada). Para establecer en CdnEnabled true, StreamingEndpoint debe tener al menos un punto de conexión de streaming premium (ScaleUnits) para la versión 1.0 StreamingEndpoints y estar en estado detenido. Puede establecer esta propiedad si la versión de StreamingEndpoint es 2.0, independientemente del valor scaleUnits (consulte punto de conexión de streaming estándar ). Use la API rest de operación para comprobar el estado. Una vez habilitada, se deshabilitan las siguientes configuraciones: CustomHostNames y AccessControl.Nota: No todos los centros de datos admiten la integración de Azure CDN. Para comprobar si su centro de datos tiene disponible la integración de la red Azure CDN, haga lo siguiente: - Pruebe de establecer el valor de CdnEnabled en true.- Compruebe el resultado devuelto de un HTTP Error Code 412 (PreconditionFailed) con un mensaje de "La propiedad CdnEnabled del punto de conexión de streaming no se puede establecer en true, ya que la funcionalidad de cdn no está disponible en la región actual".Si recibe este error, el centro de datos no la admite. Debe probar otro centro de datos. |
CdnProviderEsta propiedad se agregó en Media Services 2.15. |
Edm.String | Cuando la red CDN está habilitada ("CdnEnabled":true), también puede pasar los valores de CdnProvider. CdnProvider controla qué proveedor se usará. Actualmente, se admiten tres valores: "StandardVerizon", "PremiumVerizon" y "StandardAkamai". Si no se proporciona ningún valor y "CdnEnabled":true, se usa "StandardVerizon" (es decir, el valor predeterminado). Ejemplo: "CdnProvider":"StandardAkamai". Nota: StreamingEndpoints, que son "CDNEnabled":true con versiones anteriores de AMS (<2.15) tiene una integración de CDN heredada y usa el proveedor de CDN "StandardVerizon". Se recomienda migrar los puntos de conexión de Streaming a la integración de CDN más reciente para obtener una mejor experiencia y una característica completa. |
CdnProfileEsta propiedad se agregó en Media Services 2.15. |
Edm.String | Cuando la red CDN está habilitada ("CdnEnabled":true), también puede pasar valores de CdnProfile. "CdnProfile" es el nombre del perfil de CDN donde se creará el punto de conexión de la red CDN. Puede proporcionar un cdnProfile existente o usar uno nuevo. Si value es NULL y "CdnEnabled":true, se usa el valor predeterminado "AzureMediaStreamingPlatformCdnProfile". Si el cdnProfile proporcionado ya existe, se crea un punto de conexión en él. Si el perfil no existe, se crea un nuevo perfil automáticamente. Ejemplo: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeSolo lectura. Esta propiedad se agregó en Media Services 2.15. |
Edm.DateTime | Cuando se crea una nueva cuenta de Media Services, un punto de conexión de streaming estándar predeterminado también se aprovisiona automáticamente en la cuenta, en estado detenido. Este punto de conexión incluye un período de prueba gratuito de 15 días y el período de prueba se inicia cuando el punto de conexión se inicia por primera vez. La evaluación gratuita no se aplica a las cuentas existentes y la fecha de finalización no cambia con transiciones de estado como stop/start. La evaluación gratuita comienza la primera vez que inicia el punto de conexión de streaming y finaliza después de 15 días naturales. La evaluación gratuita solo se aplica al punto de conexión de streaming predeterminado y no se aplica a puntos de conexión de streaming adicionales. Cuando el punto de conexión se acaba de crear y está en estado detenido, el valor de "FreeTrialEndTime" se establece en "0001-01-01T00:00:00Z". Cuando se inicia, se agregan 15 días a la fecha de inicio y el valor comienza a representar la fecha de finalización de la evaluación gratuita "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Los valores de los puntos de conexión de streaming que no son aptos para la evaluación gratuita siempre serán "FreeTrialEndTime":"0001-01-01T00:00:00Z" independientemente del estado. Ejemplos: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersionEsta propiedad se agregó en Media Services 2.15. |
Edm.String | La combinación de StreamingEndpointVersion y ScaleUnits controla el tipo de punto de conexión de streaming. Cualquier punto de conexión de streaming creado antes de la actualización 2.15 (10 de enero de 2017) tendrá "StreamingEndpointVersion":"1.0" y los puntos de conexión de streaming creados después de la actualización tendrán "StreamingEndpointVersion":"2.0". Los puntos de conexión de streaming, que son la versión 1.0, no se actualizarán automáticamente a la versión 2.0, pero se pueden actualizar explícitamente a "StreamingEndpointVersion":"2.0". Puntos de conexión de streaming con "ScaleUnits":0 y "StreamingEndpointVersion":"1.0" se considerarán puntos de conexión de streaming clásicos , que no tienen las características avanzadas, como el empaquetado dinámico o el cifrado dinámico. Los puntos de conexión de streaming con "ScaleUnits" > 0 (si "StreamingEndpointVersion" está establecido en la versión "1.0" o la versión "2.0") son unidades premium . Puntos de conexión de streaming estándar con "ScaleUnits":0 y "StreamingEndpointVersion":"2.0" incluirán las mismas características que las unidades premium (que incluyen el empaquetado dinámico y el cifrado dinámico). Puede actualizar un punto de conexión de streaming clásico a estándar estableciendo la versión en "StreamingEndpointVersion":"2.0". Esta es una operación unidireccional; no se puede cambiar a la versión 2.0 a 1.0. Tenga en cuenta que esta operación no se puede revertir y afectará al precio. Esta nueva configuración puede tardar hasta 30 minutos en propagarse. Durante este período de tiempo, el punto de conexión funcionará en modo degradado y es posible que se produzcan errores en las solicitudes de empaquetado dinámico y cifrado dinámico. Ejemplos: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesOpcional. |
Collection(Edm.String) | Se usa para configurar un punto de conexión de streaming para que acepte el tráfico dirigido a un nombre de host personalizado. Esto facilita la configuración de la administración del tráfico a través de Global Traffic Manager (GTM) y también permite el uso de nombres de dominio con marca como nombre de punto de conexión de streaming. La propiedad del nombre de dominio debe confirmarse mediante Azure Media Services. Azure Media Services comprueba la propiedad del nombre de dominio solicitando un registro CName que contenga el id. de cuenta de Azure Media Services como componente para agregarlo al dominio en uso. Por ejemplo, para que "sports.contoso.com" se use como nombre de host personalizado para el punto de conexión de streaming, se debe configurar un registro para "<accountId.contoso.com>" para que apunte a uno de los nombres de host de verificación de Media Services. El nombre de host de comprobación se compone de verifydns.<mediaservices-dns-zone>. La tabla siguiente contiene las zonas DNS esperadas que se van a usar en el registro de comprobación para diferentes regiones de Azure.Norteamérica, Europa, Singapur, Hong Kong, Japón: - mediaservices.windows.net - verifydns.mediaservices.windows.net China: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Por ejemplo, un registro CName que asigna "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" a "verifydns.mediaservices.windows.net" prueba que el id. de Azure Media Services 945a4c4e-28ea-45cd-8ccb-a519f6b700ad tiene la propiedad del dominio contoso.com, lo que permite usar cualquier nombre de contoso.com como nombre de host personalizado para un punto de conexión de streaming en esa cuenta.Para buscar el valor de id. de Media Services, vaya a Azure Portal y seleccione su cuenta de Media Services. El ID. DE MEDIA SERVICES aparece a la derecha de la página PANEL. Advertencia: Si se intenta establecer un nombre de host personalizado sin una comprobación adecuada del registro CName, se producirá un error de respuesta de DNS y se almacenará en caché durante algún tiempo. Una vez que haya un registro adecuado, podría tardar un tiempo hasta que se vuelva a validar la respuesta almacenada en caché. En función del proveedor de DNS para el dominio personalizado, podría tardar desde unos minutos a una hora en volver a validar el registro.Además del registro CName que asigna <accountId>.<parent domain> a verifydns.<mediaservices-dns-zone>, debe crear otro registro CName que asigne el nombre de host personalizado (por ejemplo, sports.contoso.com) al nombre de host de su StreamingEndpoint de Media Services (por ejemplo, amstest.streaming.mediaservices.windows.net).Nota: Los puntos de conexión de streaming ubicados en el mismo centro de datos no pueden compartir el mismo nombre de host personalizado. Esta propiedad es válida para los puntos de conexión de streaming Estándar y Premium y se puede establecer cuando "CdnEnabled":false Tenga en cuenta que, actualmente, AMS no admite SSL con dominios personalizados. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Se usa para configurar las siguientes opciones de seguridad para el punto de conexión de streaming: claves de autenticación de encabezado de firma de Akamai y direcciones IP que pueden conectarse a este punto de conexión. Nota: Esta propiedad es válida para los puntos de conexión de streaming Estándar y Premium y se puede establecer cuando "CdnEnabled":false |
CacheControl |
StreamingEndpointCacheControl | Utilizado para configurar la duración en caché de los recursos entregados a través de este extremo de streaming. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Se usa para especificar las directivas de acceso entre sitios para varios clientes. Para obtener más información, consulte Cross-domain policy file specification (Especificación del archivo de directivas entre dominios) y Making a Service Available Across Domain Boundaries (Hacer que un servicio esté disponible a través de los límites del dominio). |
StreamingEndpointCacheControl
| Nombre | Tipo | Descripción |
|---|---|---|
MaxAgeOpcional. |
Edm.Int64 | Invalida el encabezado max-age de control de caché HTTP predeterminado establecido por el punto de conexión de streaming en fragmentos multimedia y manifiestos a petición. El valor se establece en segundos. |
StreamingEndpointAccessControl ComplexType
| Nombre | Tipo | Descripción |
|---|---|---|
Akamai |
AkamaiAccessControl | Control de acceso de Akamai. |
IP |
IPAccessControl | Control de acceso de IP. |
AkamaiAccessControl
| Nombre | Tipo | Descripción |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Contiene información sobre las claves de autenticación de encabezado de firma de Akamai. |
IPAccessControl
| Nombre | Tipo | Descripción |
|---|---|---|
| Allow | IPRange ComplexType | Define las direcciones IP que se pueden conectar a un extremo de streaming. Nota: Establecer este valor en NULL permite que todas las direcciones de origen IP se conecten. Establecerlo en una cadena vacía (“”) no permite a nadie conectarse. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Este tipo describe la configuración de autenticación de Akamai G20. La autenticación de Akamai es un esquema de autenticación de mensajes hash con clave. La clave de autenticación es un secreto compartido por Akamai CDN y Azure Media Origin Streaming Service. Azure Media Services solo admite la versión 3, que usa HMAC-MD5.
| Nombre | Tipo | Descripción |
|---|---|---|
Identifier |
Edm.String | Identificador de la clave de autenticación. Esta es la nonce proporcionada por Akamai. |
Expiration |
Edm.DateTime | Valor DateTime que especifica cuándo expira la autenticación de Akamai |
Base64Key |
Edm.String | Clave de autenticación con codificación base64 que usará el CDN. La clave de autenticación proporcionada por Akamai es una cadena codificada en ASCII y debe convertirse en bytes y, a continuación, codificarse en base64. |
En el ejemplo de C# siguiente se muestra cómo convertir la clave de autenticación de Akamai en base64:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Nombre | Tipo | Descripción |
|---|---|---|
Name |
Edm.String | Nombre descriptivo para este intervalo IP. |
Address |
Edm.String | Dirección IP base para la representación de subred (por ejemplo, 192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | Número de bits importantes para la máscara de subred (por ejemplo, en la dirección IP 192.168.0.1/24, 24 representa el número de bits importantes). |
Crear StreamingEndpoint
Cree un nuevo servicio StreamingEndpoint.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Encabezados de solicitud:
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>
Cuerpo de la solicitud:
{
"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>"
}
}
Si es correcto, se devolverá un código de estado 202 Accepted junto con una representación de la entidad creada en el cuerpo de respuesta.
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>"
}
}
El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un elemento StreamingEndpoint. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.
Iniciar StreamingEndpoint
Inicie el elemento StreamingEndpoint especificado. Solo se puede iniciar un elemento StreamingEndpoint cuando se encuentra en el estado Detenido. Algún tiempo después de iniciar StreamingEdpoint, el estado cambia a Running.
Para detener el streaming en un momento posterior, llame a la operación Detener .
Acciones disponibles cuando están en estado En ejecución .
| State | Unidades de streaming | Descripción | Acciones disponibles |
|---|---|---|---|
| En ejecución | 0 | Streaming desde el punto de conexión de streaming estándar. | Detener, Escalar |
| En ejecución | >0 | Streaming desde el punto de conexión de streaming Premium. | Detener, Escalar |
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.
Encabezados de solicitud:
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>
Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un elemento StreamingEndpoint. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.
Detener StreamingEndpoints
Detenga el elemento StreamingEndpoint especificado. Un elemento StreamingEndpoint solo se puede detener cuando se encuentra en el estado En ejecución.
Acciones disponibles cuando están en estado Detenido .
| State | Unidades de streaming | Descripción | Acciones disponibles |
|---|---|---|---|
| Detenido | 0 | No hace streaming. | Iniciar, Escalar |
| Detenido | >0 | No hace streaming. | Iniciar, Escalar |
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Encabezados de solicitud:
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>
Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un elemento StreamingEndpoint. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.
Escalar StreamingEndpoints
Actualiza dinámicamente la capacidad de la unidad de streaming mientras se encuentra en estado de ejecución y cambia el tipo de punto de conexión de streaming estándar a punto de conexión de streaming Premium si se actualiza desde "ScaleUnits":0.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Encabezados de solicitud:
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>
Cuerpo de la solicitud:
{"scaleUnits" : 2}
Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un elemento StreamingEndpoint. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.
Enumerar StreamingEndpoints
Para recuperar los StreamingEndpoints, use una solicitud HTTP GET.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| GET | Obtener todos los StreamingEndpoints: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Obtener el elemento StreamingEndpoint especificado: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Encabezados de solicitud:
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>
Si se ejecuta correctamente, esta operación devuelve un código de estado 200 OK y una lista de todos los puntos de conexión de Streaming creados en la cuenta de Media Services.
Actualizar StreamingEndpoints
Actualice un elemento StreamingEndpoint con nuevos valores de propiedad. Esta es una operación asincrónica si el elemento StreamingEndpoint se está ejecutando y se cambia la configuración.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| PATCH/PUT/MERGE Para obtener más información acerca de estas operaciones, vea PATCH, PUT, MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler. En el ejemplo se actualiza el valor MaxAge .
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Encabezados de solicitud:
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>
Cuerpo de la solicitud:
{"CacheControl":{"MaxAge":"2000"}}
Si la actualización se completa de manera sincrónica, devuelve un código de estado 204 No Content; de lo contrario, devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un elemento StreamingEndpoint. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.
Eliminar StreamingEndpoints
Elimine un elemento StreamingEndpoint. Un elemento StreamingEndpoint solo se puede eliminar cuando se encuentra en el estado Detenido.
Solicitud
| Método | URI de solicitud | Versión HTTP |
|---|---|---|
| Delete | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Solicitud de ejemplo
Puede probar el ejemplo siguiente en la pestaña Compositor de Fiddler.
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Encabezados de solicitud:
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>
Si es correcto, se devuelve un código de estado 202 Accepted. El código de estado 202 Accepted indica una operación asincrónica, en cuyo caso el valor de encabezado operation-id también se proporciona para usarlo en el sondeo y el seguimiento del estado de operaciones de larga duración, tal como el inicio y la detención de un elemento StreamingEndpoint. Pase el valor de encabezado operation-id a la entidad de operación para recuperar el estado. Para obtener más información, vea Operaciones de sondeo manual Long-Running.