StreamingEndpoint
Importante
A partir dos Serviços de Multimédia 2.7, a Origin entidade foi renomeada para StreamingEndpoint.
A StreamingEndpoint entidade representa um serviço de transmissão em fluxo que pode fornecer conteúdo diretamente a uma aplicação de leitor de cliente ou a uma Rede de Entrega de Conteúdos (CDN) para distribuição adicional. A partir da versão 2.9, Serviços de Multimédia do Microsoft Azure fornece a integração da CDN do Azure (para obter mais informações, veja a CdnEnabled propriedade documentada abaixo). O fluxo de saída de um serviço StreamingEndpoint pode ser uma transmissão em direto ou um Recurso a pedido de vídeo na sua conta dos Serviços de Multimédia.
Cada conta dos Serviços de Multimédia do Azure (AMS) inclui um StreamingEndpoint predefinido; Podem ser criados pontos de transmissão em fluxo adicionais na conta. A partir do Media Services 2.15 (lançado a 10 de janeiro de 2017), existem duas versões streamingEndpoint: 1.0 e 2.0. Além disso, existem três tipos de StreamingEndpoints: Clássico, **Standard ou Premium.
As contas dos Serviços de Multimédia criadas antes da atualização DO AMS REST 2.15 incluem, por predefinição, pontos finais de transmissão em fluxo clássicos , versão 1.0. Pode atualizar para a versão 2.0, não pode mudar para a versão 1.0. As contas AMS criadas após a atualização 2.15 incluem, por predefinição, pontos finais de transmissão em fluxo Standard , versão 2.0. Os pontos finais de transmissão em fluxo da versão 2.0 têm faturação e alterações de funcionalidades. Para obter informações mais detalhadas, veja a StreamingEndpointVersion propriedade documentada abaixo.
O StreamingEndpoint aprovisionado automaticamente tem o nome "Predefinido" e não pode ser eliminado. O estado do StreamingEndpoint é Parado. Para iniciar a transmissão em fluxo, tem de iniciar o ponto final de transmissão em fluxo.
Se tiver criado a conta através do portal clássico do Azure e a CDN do Azure estiver disponível na região, a conta terá a integração da CDN por predefinição ("CdnEnabled":true, "CdnProvider":StandardVerizon e "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
Na maioria dos casos, deve manter a CDN ativada. No entanto, se estiver a prever uma simultaneidade máxima inferior a 500 visualizadores, recomendamos que desative a CDN, uma vez que a CDN dimensiona melhor com simultaneidade.
Descrição geral dos pontos finais de transmissão em fluxo Clássicos, Standard e Premium
As funcionalidades avançadas descritas nesta secção incluem empacotamento dinâmico e encriptação dinâmica.
A tabela resume o comportamento:
| Tipo | Versão | ScaleUnits | Funcionalidades avançadas | CDN | Faturação |
|---|---|---|---|---|---|
| Clássico | 1.0 | 0 | ND | ND | Gratuito |
| Ponto Final de Transmissão em Fluxo Standard (recomendado) | 2.0 | 0 | Yes | Yes | Paga |
| Ponto Final de Transmissão em Fluxo Premium | 1.0 | >0 | Yes | Yes | Paga |
| Ponto Final de Transmissão em Fluxo Premium | 2.0 | >0 | Yes | Yes | Paga |
Recomenda-se atualizar os pontos finais de transmissão em fluxo clássicos para pontos finais de transmissão em fluxo Standard para obter uma melhor experiência e funcionalidades avançadas. A transmissão em fluxo padrão também dimensiona automaticamente a largura de banda de saída.
O tipo Standard é a opção recomendada para praticamente todos os cenários de transmissão em fluxo e tamanhos de audiência. Para clientes com requisitos extremamente exigentes, o AMS também oferece pontos finais de transmissão em fluxo Premium , que podem ser utilizados para aumentar horizontalmente a capacidade para as maiores audiências da Internet. Se espera grandes audiências e visualizadores simultâneos, contacte-nos para obter orientações sobre se precisa de mudar para o tipo Premium . Uma boa mensagem de guia é contactar-nos (amsstreaming às microsoft.com) se esperar um tamanho de audiência simultâneo superior a 50.000 visualizadores.
Move-se para um tipo Premium ao ajustar as unidades de dimensionamento. As unidades de dimensionamento fornecem-lhe capacidade de saída dedicada que pode ser comprada em incrementos de 200 Mbps. Ao utilizar o tipo Premium, cada unidade ativada fornece capacidade de largura de banda adicional à aplicação. Para obter mais informações, veja How to Scale StreamingEndpoint (Como Dimensionar StreamingEndpoint).
Para obter mais informações, veja Streaming endpoints overview (Descrição geral dos pontos finais de transmissão em fluxo).
Propriedades e operações do StreamingEndpoint
Importante
Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API ( Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).
Esta secção fornece uma descrição geral da StreamingEndpoint entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.
Entidade StreamingEndpoint
A StreamingEndpoint entidade contém as seguintes propriedades:
| Propriedade | Tipo | Description |
|---|---|---|
IdSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | O ID do StreamingEndpoint, atribuído após a criação. O formato é: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Nome amigável para o serviço StreamingEndpoint. - Tem de ser exclusivo na sua conta dos Serviços de Multimédia. - Comprimento máximo = 32 carateres. - Não é possível conter espaços. - Apenas hífenes e carateres alfanuméricos. - Não é possível começar ou terminar com um hífen. |
Description |
Edm.String | Descrição do StreamingEndpoint. O comprimento máximo é de 256 carateres. |
CreatedSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.DateTime | Criado pelo serviço Serviços de Multimédia do Microsoft Azure Live Streaming Preview. |
StateSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.Int32 | Os valores da propriedade incluem: - Parado. O estado inicial de um StreamingEndpoint após a criação. - A começar. O StreamingEndpoint está em transição para o estado em execução. - Em execução. O StreamingEndpoint consegue transmitir conteúdos em fluxo para clientes. - Dimensionamento. As unidades de transmissão em fluxo (ScaleUnits) estão a ser aumentadas ou diminuídas. - A parar. O StreamingEndpoint está em transição para o estado parado. |
HostNameSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.String | Nome do anfitrião do ponto final de transmissão em fluxo predefinido. |
LastModifiedSó de leitura. Definido pelos Serviços de Multimédia. |
Edm.DateTime | Hora da última atualização para esta entidade. |
ScaleUnitsSó de leitura. |
Edm.Int32 | O número de pontos finais de transmissão em fluxo premium alocados para a implementação streamingEndpoint. Quando o StreamingEndpoint está no Running estado, as unidades de transmissão em fluxo no StreamingEndpoint podem ser aumentados verticalmente ao chamar a Scale operação.Esta propriedade também controla o tipo de ponto final de transmissão em fluxo com a combinação da versão do ponto final de transmissão em fluxo. Se a versão do ponto final de transmissão em fluxo for 1.0 e ScaleUnits=0, o ponto final de transmissão em fluxo é de um tipo clássico . As seguintes propriedades do StreamingEndpoint só podem ser configuradas se o ponto final de transmissão em fluxo for standard ou premium: AccessControl, , CustomHostNames, CacheControlCrossSiteAccessPolicies. |
CdnEnabledEsta propriedade foi adicionada nos Serviços de Multimédia 2.9. |
Edm.Boolean |
Indica se a integração da CDN do Azure para este StreamingEndpoint está ativada (desativada por predefinição.) Para definir como CdnEnabled verdadeiro, o StreamingEndpoint tem de ter, pelo menos, um ponto final de transmissão em fluxo premium (ScaleUnits) para a versão 1.0 StreamingEndpoints e estar no estado parado. Pode definir esta propriedade se a versão do StreamingEndpoint for 2.0, independentemente do valor ScaleUnits (veja Ponto final de transmissão em fluxo Padrão ) Utilize a API REST da Operação para verificar o estado. Assim que estiver ativada, as seguintes configurações são desativadas: CustomHostNames e AccessControl.Nota: nem todos os datacenters suportam a integração da CDN do Azure. Para verificar se o datacenter tem ou não a integração da CDN do Azure disponível, faça o seguinte: - Tente definir como CdnEnabled verdadeiro.- Verifique o resultado devolvido de um HTTP Error Code 412 (PreconditionFailed) com uma mensagem de "A propriedade CdnEnabled do ponto final de transmissão em fluxo não pode ser definida como verdadeira, uma vez que a capacidade da CDN não está disponível na região atual".Se receber este erro, o datacenter não o suporta. Deve experimentar outro datacenter. |
CdnProviderEsta propriedade foi adicionada nos Serviços de Multimédia 2.15. |
Edm.String | Quando a CDN está ativada ("CdnEnabled":true), também pode transmitir valores CdnProvider. O CdnProvider controla o fornecedor que será utilizado. Atualmente, são suportados três valores: "StandardVerizon", "PremiumVerizon" e "StandardAkamai". Se não for fornecido nenhum valor e "CdnEnabled":true, é utilizado "StandardVerizon" (esse é o valor predefinido.) Exemplo: "CdnProvider":"StandardAkamai". Nota: o StreamingEndpoints, que são "CDNEnabled":true com versões amS mais antigas (<2.15) tem uma integração de CDN legada e utiliza o fornecedor de CDN "StandardVerizon". Recomenda-se migrar os seus StreamingEndpoints para a integração mais recente da CDN para obter uma melhor experiência e funcionalidade completa. |
CdnProfileEsta propriedade foi adicionada nos Serviços de Multimédia 2.15. |
Edm.String | Quando a CDN está ativada ("CdnEnabled":true), também pode transmitir valores CdnProfile. "CdnProfile" é o nome do perfil da CDN onde o ponto final da CDN será criado. Pode fornecer um CdnProfile existente ou utilizar um novo. Se o valor for NULL e "CdnEnabled":true, é utilizado o valor predefinido "AzureMediaStreamingPlatformCdnProfile". Se o CdnProfile fornecido já existir, será criado um ponto final sob o mesmo. Se o perfil não existir, será criado automaticamente um novo perfil. Exemplo: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeSó de leitura. Esta propriedade foi adicionada nos Serviços de Multimédia 2.15. |
Edm.DateTime | Quando uma nova conta de serviços de multimédia é criada, um ponto final de transmissão em fluxo padrão predefinido também é aprovisionado automaticamente no estado de paragem da conta. Este ponto final inclui um período de avaliação gratuito de 15 dias e o período de avaliação começa quando o ponto final é iniciado pela primeira vez. A avaliação gratuita não se aplica às contas existentes e a data de fim não é alterada com transições de estado, como parar/iniciar. A avaliação gratuita inicia a primeira vez que inicia o ponto final de transmissão em fluxo e termina após 15 dias de calendário. A avaliação gratuita aplica-se apenas ao ponto final de transmissão em fluxo predefinido e não se aplica a pontos finais de transmissão em fluxo adicionais. Quando o ponto final acaba de ser criado e estiver no estado parado, o valor de "FreeTrialEndTime" é definido como "0001-01-01T00:00:00Z". Quando é iniciada, são adicionados 15 dias à data de início e o valor começa a representar a data de fim da avaliação gratuita "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Os valores para pontos finais de transmissão em fluxo que não são elegíveis para avaliação gratuita serão sempre "FreeTrialEndTime":"0001-01-01T00:00:00Z" independentemente do estado. Exemplos: "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z" "FreeTrialEndTime":"0001-01-01T00:00:00Z" |
StreamingEndpointVersionEsta propriedade foi adicionada nos Serviços de Multimédia 2.15. |
Edm.String | A combinação de StreamingEndpointVersion e ScaleUnits controla o tipo de ponto final de transmissão em fluxo. Qualquer ponto final de transmissão em fluxo criado antes da atualização 2.15 (10 de janeiro de 2017) terá "StreamingEndpointVersion":"1.0" e os pontos finais de transmissão em fluxo criados após a atualização terão "StreamingEndpointVersion":"2.0". Os Pontos Finais de Transmissão em Fluxo, que são a versão 1.0, não serão atualizados automaticamente para a versão 2.0, mas podem ser explicitamente atualizados para "StreamingEndpointVersion":"2.0". Pontos finais de transmissão em fluxo com "ScaleUnits":0 e "StreamingEndpointVersion":"1.0" serão considerados pontos finais de transmissão em fluxo clássicos , que não têm as funcionalidades avançadas, como o empacotamento dinâmico ou a encriptação dinâmica. Os pontos finais de transmissão em fluxo com "ScaleUnits" > 0 (se o "StreamingEndpointVersion" está definido para a versão "1.0" ou a versão "2.0") são unidades premium . Pontos finais de transmissão em fluxo padrão com "ScaleUnits":0 e "StreamingEndpointVersion":"2.0" incluirão as mesmas funcionalidades que as unidades premium (que incluem empacotamento dinâmico e encriptação dinâmica.) Pode atualizar um ponto final de transmissão em fluxo clássico para padrão ao definir a versão para "StreamingEndpointVersion":"2.0". Esta é uma operação unidirecional; não pode mudar a versão 2.0 para 1.0. Tenha em atenção que esta operação não pode ser revertida e tem um impacto nos preços. Esta nova configuração pode demorar até 30 minutos a propagar. Durante este período de tempo, o ponto final funcionará no modo degradado e poderá encontrar falhas no empacotamento dinâmico e nos pedidos de encriptação dinâmicos. Exemplos: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesOpcional. |
Coleção (Edm.String) | Utilizado para configurar um ponto final de transmissão em fluxo para aceitar o tráfego direcionado para um nome de anfitrião personalizado. Isto permite uma configuração de gestão de tráfego mais fácil através de um Global Traffic Manager (GTM) e também para que os nomes de domínio de marca sejam utilizados como o nome do ponto final de transmissão em fluxo. A propriedade do nome de domínio tem de ser confirmada pelos Serviços de Multimédia do Azure. Os Serviços de Multimédia do Azure verificam a propriedade do nome de domínio ao exigir um CName registo que contenha o ID da conta dos Serviços de Multimédia do Azure como um componente a adicionar ao domínio em utilização. Por exemplo, para que "sports.contoso.com" seja utilizado como um nome de anfitrião personalizado para o Ponto Final de Transmissão em Fluxo, tem de configurar um registo para "<accountId.contoso.com>" para apontar para um dos nomes de anfitrião de verificação dos Serviços de Multimédia. O nome do anfitrião de verificação é composto por checkdns.<mediaservices-dns-zone>. A tabela seguinte contém as zonas DNS esperadas para serem utilizadas no registo de verificação para diferentes regiões do Azure.América do Norte, Europa, Singapura, Hong Kong, Japão: - mediaservices.windows.net - verifydns.mediaservices.windows.net China: - mediaservices.chinacloudapi.cn - verifydns.mediaservices.chinacloudapi.cn Por exemplo, um CName registo que mapeia "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" para "verifydns.mediaservices.windows.net" prova que o ID dos Serviços de Multimédia do Azure 945a4c4e-28ea-45cd-8ccb-a519f6b700ad tem a propriedade do domínio contoso.com, permitindo assim que qualquer nome em contoso.com seja utilizado como um nome de anfitrião personalizado para um ponto final de transmissão em fluxo nessa conta.Para localizar o valor do ID do Serviço de Multimédia, aceda à portal do Azure e selecione a sua conta do Serviço de Multimédia. O ID do SERVIÇO DE MULTIMÉDIA é apresentado à direita da página DASHBOARD. Aviso: se houver uma tentativa de definir um nome de anfitrião personalizado sem uma verificação adequada do CName registo, a resposta DNS falhará e, em seguida, será colocada em cache durante algum tempo. Assim que um registo adequado estiver implementado, poderá demorar algum tempo até que a resposta em cache seja revalidada. Consoante o fornecedor de DNS do domínio personalizado, pode demorar entre alguns minutos a uma hora para revalidar o registo.Além do CName que mapeia <accountId>.<parent domain> para verifydns.<mediaservices-dns-zone>, tem de criar outro CName que mapeie o nome do anfitrião personalizado (por exemplo, sports.contoso.com) para o nome do anfitrião do StreamingEndpont dos Serviços de Multimédia (por exemplo, amstest.streaming.mediaservices.windows.net).Nota: os pontos finais de transmissão em fluxo localizados no mesmo datacenter não podem partilhar o mesmo nome de anfitrião personalizado. Esta propriedade é válida para pontos finais de transmissão em fluxo Standard e premium e pode ser definida quando "CdnEnabled":false Tenha em atenção que, atualmente, o AMS não suporta SSL com domínios personalizados. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Utilizado para configurar as seguintes definições de segurança para este ponto final de transmissão em fluxo: chaves de autenticação de cabeçalho de assinatura Akamai e endereços IP com permissão para ligar a este ponto final. Nota: esta propriedade é válida para pontos finais de transmissão em fluxo Standard e premium e pode ser definida quando "CdnEnabled":false |
CacheControl |
StreamingEndpointCacheControl | Utilizado para configurar a duração da cache de recursos para recursos servidos através deste ponto final de transmissão em fluxo. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Utilizado para especificar políticas de acesso entre sites para vários clientes. Para obter mais informações, veja Especificação de ficheiros de políticas entre domínios e Tornar um Serviço Disponível Entre Limites de Domínio. |
StreamingEndpointCacheControl
| Nome | Tipo | Description |
|---|---|---|
MaxAgeOpcional. |
Edm.Int64 | Substitui o cabeçalho de controlo de cache HTTP de idade máxima predefinido definido pelo ponto final de transmissão em fluxo em fragmentos de multimédia e manifestos a pedido. O valor é definido em segundos. |
StreamingEndpointAccessControl ComplexType
| Nome | Tipo | Description |
|---|---|---|
Akamai |
AkamaiAccessControl | Controlo de acesso da Akamai. |
IP |
IPAccessControl | Controlo de acesso ao IP. |
AkamaiAccessControl
| Nome | Tipo | Description |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Contém informações sobre as chaves de Autenticação do Cabeçalho de Assinatura do Akamai. |
IPAccessControl
| Nome | Tipo | Description |
|---|---|---|
| Permitir | IPRange ComplexType | Define os endereços IP que podem ligar a um ponto final de transmissão em fluxo. Nota: definir este valor como nulo permite que todos os endereços de origem IP se liguem. Defini-la como uma cadeia vazia ("") não permite que ninguém se ligue. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Este tipo descreve as definições de autenticação do Akamai G20. A Autenticação Akamai é um esquema de autenticação de mensagens hash com chave. A chave de autenticação é um segredo partilhado pela CDN da Akamai e pelo Azure Media Origin Streaming Service. Os Serviços de Multimédia do Azure só suportam a versão 3, que utiliza o HMAC-MD5.
| Nome | Tipo | Description |
|---|---|---|
Identifier |
Edm.String | O identificador da chave de autenticação. Este é o nonce fornecido pela Akamai. |
Expiration |
Edm.DateTime | Valor DateTime que especifica quando a autenticação Akamai expira |
Base64Key |
Edm.String | Chave de autenticação codificada em Base64 que será utilizada pela CDN. A chave de autenticação fornecida pela Akamai é uma cadeia codificada ASCII e tem de ser convertida em bytes e, em seguida, codificada em base64. |
O exemplo C# seguinte mostra como converter a chave de autenticação Akamai em base64:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Nome | Tipo | Description |
|---|---|---|
Name |
Edm.String | Um nome amigável para este Intervalo de IP. |
Address |
Edm.String | O endereço IP base para a representação da sub-rede (por exemplo: 192.168.0.1). |
SubnetPrefixLength |
Edm.Int32 | O número de bits significativos para a máscara de sub-rede (por exemplo, no seguinte endereço IP 192.168.0.1/24, 24 representa o número de bits significativos). |
Criar StreamingEndpoint
Crie um novo serviço StreamingEndpoint.
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
Cabeçalhos de pedido:
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>
Corpo do pedido:
{
"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>"
}
}
Se for bem-sucedido, é devolvido um código de estado 202 Aceite juntamente com uma representação da entidade criada no corpo da resposta.
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>"
}
}
O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um StreamingEndpoint. Transmita o valor do cabeçalho operation-id para a Entidade da Operação para obter o estado. Para obter mais informações, veja Manually Polling Long-Running Operations (Consultas Manualmente Long-Running Operações).
Iniciar StreamingEndpoint
Inicie o StreamingEndpoint especificado. Um StreamingEndpoint só pode ser iniciado quando está no estado Parado . Algum tempo depois de iniciar o StreamingEdpoint, o estado muda para Running.
Para parar a transmissão em fluxo mais tarde, chame a operação Parar .
Ações disponíveis quando estiver no estado Em execução .
| Estado | Unidades de Transmissão em Fluxo | Description | Ações Disponíveis |
|---|---|---|---|
| Em Execução | 0 | Transmissão em fluxo a partir do Ponto Final de Transmissão em Fluxo Standard. | Parar, Dimensionar |
| Em Execução | >0 | Transmissão em fluxo a partir do Ponto Final de Transmissão em Fluxo Premium. | Parar, Dimensionar |
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Iniciar | HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.
Cabeçalhos de pedido:
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>
Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um StreamingEndpoint. Transmita o valor do cabeçalho operation-id para a Entidade da Operação para obter o estado. Para obter mais informações, veja Manually Polling Long-Running Operations (Consultas Manualmente Long-Running Operações).
Parar StreamingEndpoints
Pare o StreamingEndpoint especificado. Um StreamingEndpoint só pode ser parado quando está no estado Em execução .
Ações disponíveis no estado Parado .
| Estado | Unidades de Transmissão em Fluxo | Description | Ações Disponíveis |
|---|---|---|---|
| Parada | 0 | Não é transmissão em fluxo. | Iniciar, Dimensionar |
| Parada | >0 | Não é transmissão em fluxo. | Iniciar, Dimensionar |
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
Cabeçalhos de pedido:
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>
Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um StreamingEndpoint. Transmita o valor do cabeçalho operation-id para a Entidade da Operação para obter o estado. Para obter mais informações, veja Manually Polling Long-Running Operations (Consultas Manualmente Long-Running Operações).
Dimensionar Pontos Finais de Transmissão em Fluxo
Atualiza dinamicamente a capacidade da unidade de transmissão em fluxo no estado em execução e altera o tipo do Ponto Final de Transmissão em Fluxo Standard para o Ponto Final de Transmissão em Fluxo Premium se for atualizado a partir de "ScaleUnits":0.
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
Cabeçalhos de pedido:
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>
Corpo do pedido:
{"scaleUnits" : 2}
Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um StreamingEndpoint. Transmita o valor do cabeçalho operation-id para a Entidade da Operação para obter o estado. Para obter mais informações, veja Manually Polling Long-Running Operations (Consultas Manualmente Long-Running Operações).
Listar Pontos Finais de Transmissão em Fluxo
Os StreamingEndpoints são obtidos com um pedido GET HTTP.
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| GET | Obter todos os StreamingEndpoints: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Obtenha o StreamingEndpoint especificado. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.
Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.
Cabeçalhos de pedido:
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>
Se for bem-sucedida, esta operação devolve um código de estado 200 OK e uma lista de todos os StreamingEndpoints criados na sua conta dos Serviços de Multimédia.
Atualizar StreamingEndpoints
Atualize um StreamingEndpoint com novos valores de propriedade. Esta é uma operação assíncrona se o StreamingEndpoint estiver em execução e as definições forem alteradas.
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| PATCH/PUT/MERGE Para obter mais informações sobre estas operações, consulte PATCH/PUT/MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler. O exemplo atualiza o valor MaxAge .
Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.
Cabeçalhos de pedido:
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>
Corpo do pedido:
{"CacheControl":{"MaxAge":"2000"}}
Se a atualização for concluída de forma síncrona, devolve um código de estado 204 Sem Conteúdo ; caso contrário, devolve um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um StreamingEndpoint. Transmita o valor do cabeçalho operation-id para a Entidade de Operação para obter o estado. Para obter mais informações, consulte Consulta Manual Long-Running Operações.
Eliminar Pontos Finais de Transmissão em Fluxo
Eliminar um StreamingEndpoint. Um StreamingEndpoint só pode ser eliminado quando está no estado Parado .
Pedir
| Método | URI do pedido | Versão HTTP |
|---|---|---|
| DELETE | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Pedido de Amostra
Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.
Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.
Cabeçalhos de pedido:
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>
Se for bem-sucedido, é devolvido um código de estado 202 Aceite . O código de estado 202 Aceite indica uma operação assíncrona, caso em que o valor do cabeçalho operation-id também é fornecido para utilização na consulta e controlo do estado das operações de execução prolongada, como iniciar ou parar um StreamingEndpoint. Transmita o valor do cabeçalho operation-id para a Entidade de Operação para obter o estado. Para obter mais informações, consulte Consulta Manual Long-Running Operações.