StreamingEndpoint
Importante
A partir dos Serviços de Mídia 2.7, a entidade Origin foi renomeada como StreamingEndpoint.
A entidade StreamingEndpoint representa um serviço de streaming que pode entregar conteúdo diretamente a um aplicativo de reprodução do cliente ou a uma Rede de Distribuição de Conteúdo (CDN) para melhor distribuição. A partir da versão 2.9, Serviços de Mídia do Microsoft Azure fornece a integração da CDN do Azure (para obter mais informações, consulte a CdnEnabled propriedade documentada abaixo). O fluxo de saída de um serviço StreamingEndpoint pode ser uma transmissão ao vivo ou um ativo sob demanda de vídeo em sua conta dos Serviços de Mídia.
Cada conta dos Serviços de Mídia do Azure (AMS) inclui um StreamingEndpoint padrão; StreamingEndpoints adicionais podem ser criados na conta. A partir do Media Services 2.15 (lançado em 10 de janeiro de 2017) há duas versões do StreamingEndpoint: 1.0 e 2.0. Além disso, há três tipos de StreamingEndpoints: Clássico, **Standard ou Premium.
As contas dos Serviços de Mídia criadas antes da atualização DO AMS REST 2.15, por padrão, incluem pontos de extremidade de streaming clássicos , versão 1.0. Você pode atualizar para a versão 2.0, não é possível fazer downgrade para 1.0. As contas ams criadas após a atualização 2.15, por padrão, incluem pontos de extremidade de streaming Standard , versão 2.0. Os pontos de extremidade de streaming da versão 2.0 têm alterações de cobrança e recursos. Para obter informações mais detalhadas, consulte a StreamingEndpointVersion propriedade documentada abaixo.
O StreamingEndpoint provisionado automaticamente tem o nome "Padrão" e não pode ser excluído. O estado do StreamingEndpoint é Parado. Para iniciar o streaming, você precisa iniciar o ponto de extremidade de streaming.
Se você criou a conta por meio do portal clássico do Azure e a CDN do Azure está disponível na região, a conta terá a integração da CDN por padrão ("CdnEnabled":true, "CdnProvider":StandardVerizon e "CdnProfile":AzureMediaStreamingPlatformCdnProfile).
Na maioria dos casos, você deve manter a CDN habilitada. No entanto, se você estiver antecipando uma simultaneidade máxima menor que 500 visualizadores, então, é recomendável desabilitar a CDN, já que a CDN dimensiona melhor com simultaneidade.
Visão geral dos pontos de extremidade de streaming Clássicos, Standard e Premium
Os recursos avançados descritos nesta seção incluem empacotamento dinâmico e criptografia dinâmica.
A tabela resume o comportamento:
| Tipo | Versão | ScaleUnits | Recursos avançados | CDN | Cobrança |
|---|---|---|---|---|---|
| Clássico | 1.0 | 0 | NA | NA | Gratuita |
| Ponto de Extremidade de Streaming Standard (recomendado) | 2,0 | 0 | Sim | Yes | Pago |
| Ponto de Extremidade de Streaming Premium | 1.0 | >0 | Sim | Yes | Pago |
| Ponto de Extremidade de Streaming Premium | 2,0 | >0 | Sim | Yes | Pago |
É recomendável atualizar seus pontos de extremidade de streaming clássicos para pontos de extremidade de streaming Standard para obter uma experiência melhor e recursos avançados. O streaming standard também dimensiona a largura de banda de saída automaticamente.
O tipo Standard é a opção recomendada para praticamente todos os cenários de streaming e tamanhos de público-alvo. Para clientes com requisitos extremamente exigentes, o AMS também oferece pontos de extremidade de streaming Premium , que podem ser usados para expandir a capacidade para as maiores audiências da Internet. Se você espera grandes audiências e visualizadores simultâneos, entre em contato conosco para obter diretrizes sobre se você precisa mudar para o tipo Premium . Uma boa postagem de guia é entrar em contato conosco (amsstreaming em microsoft.com) se você espera um tamanho de audiência simultâneo maior que 50.000 espectadores.
Você passa para um tipo Premium ajustando as unidades de escala. As unidades de escala fornecem capacidade de saída dedicada que pode ser adquirida em incrementos de 200 Mbps. Ao usar o tipo Premium, cada unidade habilitada fornece capacidade adicional de largura de banda ao aplicativo. Para obter mais informações, consulte How to Scale StreamingEndpoint.
Para saber mais, confira Streaming endpoints overview (Visão geral dos pontos de extremidade de streaming).
Operações e propriedades do StreamingEndpoint
Importante
Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.
Esta seção fornece uma visão geral da StreamingEndpoint entidade e também demonstra como executar várias operações com a API REST dos Serviços de Mídia.
Entidade StreamingEndpoint
A StreamingEndpoint entidade contém as seguintes propriedades:
| Propriedade | Type | Descrição |
|---|---|---|
IdSomente leitura. Configurada pelos Serviços de Mídia. |
Edm.String | ID do StreamingEndpoint, atribuída no momento da criação. O formato é: nb:oid:UUID:<GUID>. |
Name |
Edm.String | Nome amigável do serviço StreamingEndpoint. - Deve ser exclusivo em sua conta dos Serviços de Mídia. - Comprimento máximo = 32 caracteres. - Não é possível conter espaços. - Hífens e caracteres alfanuméricos somente. - Não é possível começar ou terminar com um hífen. |
Description |
Edm.String | Descrição do StreamingEndpoint. O tamanho máximo é de 256 caracteres. |
CreatedSomente leitura. Configurada pelos Serviços de Mídia. |
Edm.DateTime | Criado pelo serviço Serviços de Mídia do Microsoft Azure Live Streaming Preview. |
StateSomente leitura. Configurada pelos Serviços de Mídia. |
Edm.Int32 | Valores para a propriedade incluem: - Parado. Estado inicial de um StreamingEndpoint após a criação. - Iniciando. O StreamingEndpoint está em transição para o estado de execução. - Executando. O StreamingEndpoint está habilitado para transmitir conteúdo aos clientes. - Dimensionando. As unidades de reserva (ScaleUnits) estão aumentando ou diminuindo. - Parando. O StreamingEndpoint está em transição para o estado parado. |
HostNameSomente leitura. Configurada pelos Serviços de Mídia. |
Edm.String | Nome de host padrão do ponto de extremidade de streaming. |
LastModifiedSomente leitura. Configurada pelos Serviços de Mídia. |
Edm.DateTime | Hora da última atualização dessa entidade. |
ScaleUnitsSomente leitura. |
Edm.Int32 | O número de pontos de extremidade de streaming premium alocados para a implantação do StreamingEndpoint. Quando o StreamingEndpoint está no estado Running, as unidades de streaming do StreamingEndpoint podem ser escaladas verticalmente chamando a operação Scale.Essa propriedade também controla o tipo de ponto de extremidade de streaming com a combinação da versão do ponto de extremidade de streaming. Se a versão do ponto de extremidade de streaming for 1.0 e ScaleUnits=0, o ponto de extremidade de streaming será de um tipo clássico . As seguintes propriedades do StreamingEndpoint só poderão ser configuradas se o ponto de extremidade de streaming for standard ou premium: AccessControl, CustomHostNames, CacheControl, . CrossSiteAccessPolicies |
CdnEnabledEssa propriedade foi adicionada no Serviços de Mídia 2.9. |
Edm.Boolean |
Indica se a integração do Azure CDN para este StreamingEndpoint está ou não ativado (desativado por padrão.) Para definir o CdnEnabled como true, o StreamingEndpoint deve ter pelo menos um ponto de extremidade de streaming premium (ScaleUnits) para a versão 1.0 StreamingEndpoints e estar no estado interrompido. Você poderá definir essa propriedade se a versão streamingEndpoint for 2.0 independentemente do valor ScaleUnits (consulte Ponto de extremidade de streaming Standard) Use a API REST de Operação para marcar o status. Depois que ele estiver habilitado, as seguintes configurações serão desabilitadas: CustomHostNames e AccessControl.Observação: nem todos os data centers dão suporte à integração da CDN do Azure. Para verificar se o data center tem ou não a integração da CDN do Azure disponível, execute o seguinte: - Experimente definir CdnEnabled como verdadeiro.- Verifique o resultado retornado de um HTTP Error Code 412 (PreconditionFailed) com uma mensagem de "A propriedade CdnEnabled do ponto de extremidade de streaming não pode ser definida como true, pois a funcionalidade cdn não está disponível na região atual".Se você receber esse erro, o data center não dará suporte. Você deve experimentar outro data center. |
CdnProviderEssa propriedade foi adicionada aos Serviços de Mídia 2.15. |
Edm.String | Quando a CDN está habilitada ("CdnEnabled":true), você também pode passar valores cdnProvider. CdnProvider controla qual provedor será usado. Atualmente, há suporte para três valores: "StandardVerizon", "PremiumVerizon" e "StandardAkamai". Se nenhum valor for fornecido e "CdnEnabled":true, "StandardVerizon" será usado (esse é o valor padrão).) Exemplo: "CdnProvider":"StandardAkamai". Observação: StreamingEndpoints, que são "CDNEnabled":true com versões ams mais antigas (<2.15) tem uma integração cdn herdada e usa o provedor de CDN "StandardVerizon". É recomendável migrar seus StreamingEndpoints para a integração mais recente da CDN para obter uma experiência melhor e um recurso completo. |
CdnProfileEssa propriedade foi adicionada aos Serviços de Mídia 2.15. |
Edm.String | Quando a CDN está habilitada ("CdnEnabled":true), você também pode passar valores cdnProfile. "CdnProfile" é o nome do perfil cdn em que o ponto de extremidade da CDN será criado. Você pode fornecer um CdnProfile existente ou usar um novo. Se value for NULL e "CdnEnabled":true, o valor padrão "AzureMediaStreamingPlatformCdnProfile" será usado. Se o CdnProfile fornecido já existir, um ponto de extremidade será criado sob ele. Se o perfil não existir, um novo perfil será criado automaticamente. Exemplo: "CdnProfile":"AzureMediaStreamingPlatformCdnProfile". |
FreeTrialEndTimeSomente leitura. Essa propriedade foi adicionada aos Serviços de Mídia 2.15. |
Edm.DateTime | Quando uma nova conta de serviços de mídia é criada, um ponto de extremidade de streaming padrão padrão também é provisionado automaticamente na conta, no estado parado. Esse ponto de extremidade inclui um período de avaliação gratuito de 15 dias e o período de avaliação começa quando o ponto de extremidade é iniciado pela primeira vez. A avaliação gratuita não se aplica a contas existentes e a data de término não é alterada com transições de estado, como stop/start. A avaliação gratuita começa na primeira vez que você inicia o ponto de extremidade de streaming e termina após 15 dias de calendário. A avaliação gratuita só se aplica ao ponto de extremidade de streaming padrão e não se aplica a pontos de extremidade de streaming adicionais. Quando o ponto de extremidade é criado e está no estado parado, o valor de "FreeTrialEndTime" é definido como "0001-01-01T00:00:00Z". Quando ele é iniciado, 15 dias são adicionados à data de início e o valor começa a representar a data de término da avaliação gratuita "FreeTrialEndTime":"2016-12-16T18:01:47.8524725Z". Os valores para pontos de extremidade de streaming que não estão qualificados 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" |
StreamingEndpointVersionEssa propriedade foi adicionada aos Serviços de Mídia 2.15. |
Edm.String | A combinação de StreamingEndpointVersion e ScaleUnits controla o tipo de ponto de extremidade de streaming. Qualquer ponto de extremidade de streaming criado antes da atualização 2.15 (10 de janeiro de 2017) terá "StreamingEndpointVersion":"1.0" e os pontos de extremidade de streaming criados após a atualização terão "StreamingEndpointVersion":"2.0". Os pontos de extremidade de streaming, que são a versão 1.0, não serão atualizados automaticamente para a versão 2.0, mas podem ser atualizados explicitamente para "StreamingEndpointVersion":"2.0". Pontos de extremidade de streaming com "ScaleUnits":0 e "StreamingEndpointVersion":"1.0" serão considerados pontos de extremidade de streaming clássicos , que não têm os recursos avançados, como empacotamento dinâmico ou criptografia dinâmica. Os pontos de extremidade de streaming com "ScaleUnits" > 0 (se o "StreamingEndpointVersion" está definido como a versão "1.0" ou a versão "2.0") são unidades premium . Pontos de extremidade de streaming padrão com "ScaleUnits":0 e "StreamingEndpointVersion":"2.0" incluirão os mesmos recursos que as unidades premium (que incluem empacotamento dinâmico e criptografia dinâmica).) Você pode atualizar um ponto de extremidade de streaming clássico para o padrão definindo a versão como "StreamingEndpointVersion":"2.0". Esta é uma operação unidirecional; você não pode fazer downgrade da versão 2.0 para 1.0. Lembre-se de que essa operação não pode ser revertida e tem um impacto no preço. Pode levar até 30 minutos para que essa nova configuração seja propagada. Durante esse período, o ponto de extremidade funcionará no modo degradado e você poderá encontrar falhas para empacotamento dinâmico e solicitações de criptografia dinâmica. Exemplos: "StreamingEndpointVersion":"2.0" "StreamingEndpointVersion":"1.0" |
CustomHostNamesOpcional. |
Collection(Edm.String) | Usado para configurar um ponto de extremidade de streaming para aceitar tráfego direcionado para um nome do host personalizado. Isso permite uma configuração de gerenciamento de tráfego mais fácil por meio de um GTM (Gerenciador de Tráfego Global) e também para nomes de domínio de marca a serem usados como o nome do ponto de extremidade de streaming. A propriedade do nome de domínio deve ser confirmada pelos Serviços de Mídia do Azure. Os Serviços de Mídia do Azure verificam a propriedade do nome de domínio, exigindo que um registro CName contendo a ID da conta de Serviços de Mídia do Azure como um componente seja adicionado ao domínio em uso. Por exemplo, para que "sports.contoso.com" seja usado como um nome de host personalizado para o Ponto de Extremidade de Streaming, um registro para "<accountId.contoso.com>" deve ser configurado para apontar para um dos nomes de host de verificação dos Serviços de Mídia. O nome do host de verificação é composto de verifydns.<mediaservices-dns-zone>. A tabela a seguir contém as zonas DNS esperadas a serem usadas no registro 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 registro CName que mapeia "945a4c4e-28ea-45cd-8ccb-a519f6b700ad.contoso.com" para "verifydns.mediaservices.windows.net" prova que a ID dos Serviços de Mídia do Azure 945a4c4e-28ea-45cd-8ccb-a519f6b700ad tem a propriedade do domínio contoso.com, permitindo que qualquer nome sob contoso.com seja usado como um nome do host personalizado para um ponto de extremidade de streaming sob essa conta.Para localizar o valor da ID do Serviço de Mídia, acesse o portal do Azure e selecione a conta de Serviço de Mídia. A ID do SERVIÇO DE MÍDIA aparece à direita da página de PAINEL. Aviso: se houver uma tentativa de definir um nome do host personalizado sem uma verificação adequada do registro CName, a resposta DNS falhará e, em seguida, será armazenada em cache por algum tempo. Depois que um registro adequado estiver em vigor, poderá demorar um pouco até que a resposta armazenada em cache seja revalidada. Dependendo do provedor DNS do domínio personalizado, pode levar de alguns minutos a uma hora para revalidar o registro.Além de CName que mapeia <accountId>.<parent domain> para verifydns.<mediaservices-dns-zone>, você deve criar outro CName que mapeie o nome do host personalizado (por exemplo, sports.contoso.com) para o nome do host do StreamingEndpont dos Serviços de Mídia (por exemplo, amstest.streaming.mediaservices.windows.net).Observação: pontos de extremidade de streaming localizados no mesmo data center, não podem compartilhar o mesmo nome do host personalizado. Essa propriedade é válida para pontos de extremidade de streaming Standard e Premium e pode ser definida quando "CdnEnabled":false Observe que, atualmente, o AMS não dá suporte ao SSL com domínios personalizados. |
AccessControl |
StreamingEndpointAccessControl ComplexType | Usado para definir as seguintes configurações de segurança para este ponto de extremidade de streaming: Chaves de autenticação de cabeçalho de assinatura Akamai e endereços IP que tenham permissão para conectar esse ponto de extremidade. Observação: essa propriedade é válida para pontos de extremidade de streaming Standard e Premium e pode ser definida quando "CdnEnabled":false |
CacheControl |
StreamingEndpointCacheControl | Usado para configurar o tempo de vida de ativos atendidos por esse ponto de extremidade. |
CrossSiteAccessPolicies |
CrossSiteAccessPolicies | Usado para especificar políticas de acesso entre sites para vários clientes. Para obter mais informações, consulte Especificação de arquivo de política entre domínios e Disponibilizando um serviço entre limites de domínios. |
StreamingEndpointCacheControl
| Nome | Type | Descrição |
|---|---|---|
MaxAgeOpcional. |
Edm.Int64 | Substitui o cabeçalho de controle de cache HTTP max-age padrão definido pelo ponto de extremidade de streaming em fragmentos de mídia e manifestos sob demanda. O valor é definido em segundos. |
StreamingEndpointAccessControl ComplexType
| Nome | Type | Descrição |
|---|---|---|
Akamai |
AkamaiAccessControl | Controle de acesso do Akamai. |
IP |
IPAccessControl | Controle de acesso do IP. |
AkamaiAccessControl
| Nome | Type | Descrição |
|---|---|---|
| AkamaiSignatureHeaderAuthenticationKeyList | AkamaiSignatureHeaderAuthenticationKey ComplexType | Contém informações sobre as chaves de Autenticação do Cabeçalho da Assinatura do Akamai. |
IPAccessControl
| Nome | Type | Descrição |
|---|---|---|
| Allow | IPRange ComplexType | Define o endereço IP que pode conectar a um ponto de extremidade de streaming. Observação: definir esse valor como nulo permite que todos os endereços de origem IP se conectem. Configurá-lo como uma cadeia vazia (“”) faz com que nenhum se conecte. |
AkamaiSignatureHeaderAuthenticationKey ComplexType
Esse tipo descreve as configurações de autenticação do Akamai G20. A Autenticação akamai é um esquema de autenticação de mensagem com hash chave. A chave de autenticação é um segredo compartilhado pela CDN do Akamai e pelo Serviço de Streaming de Origem de Mídia do Azure. Os Serviços de Mídia do Azure só dão suporte à versão 3, que usa HMAC-MD5.
| Nome | Type | Descrição |
|---|---|---|
Identifier |
Edm.String | O identificador da chave de autenticação. Este é o nó fornecido pelo Akamai. |
Expiration |
Edm.DateTime | Valor DateTime que especifica quando a autenticação do Akamai expira |
Base64Key |
Edm.String | Chave de autenticação codificada em Base64 que será usada pela CDN. A chave de autenticação fornecida pelo Akamai é uma cadeia de caracteres codificada em ASCII e deve ser convertida em bytes e, em seguida, codificada em base64. |
O exemplo de C# a seguir mostra como converter a chave de autenticação do Akamai em base64:
string akamaiKey = "01234567890123456789012345678901";
string base64Key = Convert.ToBase64String(System.Text.Encoding.ASCII.GetBytes(akamaiKey);
IPRange ComplexType
| Nome | Type | Descrição |
|---|---|---|
Name |
Edm.String | Um nome amigável para o Intervalo IP. |
Address |
Edm.String | Endereço IP de 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 da sub-rede (por exemplo, no endereço IP 192.168.0.1/24, 24 representa o número de bits significativos). |
Criar StreamingEndpoint
Cria um novo serviço de StreamingEndpoint.
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoint> | HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler.
Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.
Cabeçalhos de solicitação:
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 da solicitação:
{
"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 o procedimento for bem-sucedido, um código de status 202 Aceito será emitido junto 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 status 202 Aceito indica uma operação assíncrona. Nesse caso, o valor de cabeçalho da ID de operação também é proporcionado para uso no monitoramento e sondagem do status de operações de execução longa, como iniciar ou parar um StreamingEndpoint. Transmita o valor de cabeçalho do id de operação na entidade de operação para recuperar o status. Para obter mais informações, consulte Operações de Long-Running de sondagem manual.
Iniciar StreamingEndpoint
Inicia 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 interromper o streaming em um momento posterior, chame a operação Parar .
Ações disponíveis quando estiver no estado Em execução .
| Estado | Unidades de streaming | Descrição | Ações disponíveis |
|---|---|---|---|
| Executando | 0 | Streaming do Ponto de Extremidade de Streaming Standard. | Parar, Dimensionar |
| Executando | >0 | Streaming do Ponto de Extremidade de Streaming Premium. | Parar, Dimensionar |
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Start | HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler.
Cabeçalhos de solicitação:
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 a operação for bem-sucedida, um código de status 202 Aceito será emitido. O código de status 202 Aceito indica uma operação assíncrona. Nesse caso, o valor de cabeçalho da ID de operação também é proporcionado para uso no monitoramento e sondagem do status de operações de execução longa, como iniciar ou parar um StreamingEndpoint. Transmita o valor de cabeçalho do id de operação na entidade de operação para recuperar o status. Para obter mais informações, consulte Operações de Long-Running de sondagem manual.
Parar StreamingEndpoints
Para o StreamingEndpoint especificado. Um StreamingEndpoint só pode ser parado quando está no estado Executando.
Ações disponíveis quando estiver no estado Parado .
| Estado | Unidades de streaming | Descrição | Ações disponíveis |
|---|---|---|---|
| Parado | 0 | Não transmitindo. | Iniciar, Dimensionar |
| Parado | >0 | Não transmitindo. | Iniciar, Dimensionar |
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Stop | HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler.
Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.
Cabeçalhos de solicitação:
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 a operação for bem-sucedida, um código de status 202 Aceito será emitido. O código de status 202 Aceito indica uma operação assíncrona. Nesse caso, o valor de cabeçalho da ID de operação também é proporcionado para uso no monitoramento e sondagem do status de operações de execução longa, como iniciar ou parar um StreamingEndpoint. Transmita o valor de cabeçalho do id de operação na entidade de operação para recuperar o status. Para obter mais informações, consulte Operações de Long-Running de sondagem manual.
Escalar StreamingEndpoints
Atualiza dinamicamente a capacidade da unidade de streaming enquanto estiver no estado em execução e altera o tipo do Ponto de Extremidade de Streaming Standard para o Ponto de Extremidade de Streaming Premium se atualizado de "ScaleUnits":0.
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| POST | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId')/Scale | HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler.
Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.
Cabeçalhos de solicitação:
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 da solicitação:
{"scaleUnits" : 2}
Se a operação for bem-sucedida, um código de status 202 Aceito será emitido. O código de status 202 Aceito indica uma operação assíncrona. Nesse caso, o valor de cabeçalho da ID de operação também é proporcionado para uso no monitoramento e sondagem do status de operações de execução longa, como iniciar ou parar um StreamingEndpoint. Transmita o valor de cabeçalho do id de operação na entidade de operação para recuperar o status. Para obter mais informações, consulte Operações de Long-Running de sondagem manual.
Listar StreamingEndpoints
Os StreamingEndpoints são recuperados usando uma solicitação HTTP GET.
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| GET | Obter todos os StreamingEndpoints: <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints> Obtém o StreamingEndpoint especificado. <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') |
HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler.
Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.
Cabeçalhos de solicitação:
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 tiver êxito, essa operação retornará um código de status 200 OK e uma lista de todos os StreamingEndpoints criados em sua conta dos Serviços de Mídia.
Atualizar StreamingEndpoint
Atualiza um StreamingEndpoint com novos valores de propriedade. Essa operação é assíncrona quando o StreamingEndpoint está em execução e as configurações são alteradas.
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| PATCH/PUT/MERGE Para obter mais informações sobre essas operações, consulte PATCH, PUT, MERGE. |
<https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler. O exemplo atualiza o valor maxage .
Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.
Cabeçalhos de solicitação:
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 da solicitação:
{"CacheControl":{"MaxAge":"2000"}}
Caso a atualização seja concluída de forma síncrona, ela emitirá um código de status 204 Sem conteúdo; caso contrário, gerará um código de status 202 Aceito. O código de status 202 Aceito indica uma operação assíncrona. Nesse caso, o valor de cabeçalho da ID de operação também é proporcionado para uso no monitoramento e sondagem do status de operações de execução longa, como iniciar ou parar um StreamingEndpoint. Transmita o valor de cabeçalho do id de operação na entidade de operação para recuperar o status. Para obter mais informações, consulte Operações de Long-Running de sondagem manual.
Excluir StreamingEndpoints
Exclui um StreamingEndpoint. Um StreamingEndpoint só pode ser excluído quando está no estado Parado.
Solicitação
| Método | URI da solicitação | Versão de HTTP |
|---|---|---|
| Delete (excluir) | <https:// accountname.restv2>.<location.media.azure.net/api/StreamingEndpoints>('StreamingEndpointId') | HTTP/1.1 |
Solicitação de Exemplo
Você pode experimentar o exemplo a seguir na guia Compositor do Fiddler.
Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.
Cabeçalhos de solicitação:
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 a operação for bem-sucedida, um código de status 202 Aceito será emitido. O código de status 202 Aceito indica uma operação assíncrona. Nesse caso, o valor de cabeçalho da ID de operação também é proporcionado para uso no monitoramento e sondagem do status de operações de execução longa, como iniciar ou parar um StreamingEndpoint. Transmita o valor de cabeçalho do id de operação na entidade de operação para recuperar o status. Para obter mais informações, consulte Operações de Long-Running de sondagem manual.