Live Events - List
Listar eventos em direto
Listas todos os eventos em direto na conta.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents?api-version=2022-11-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta dos Serviços de Multimédia. |
resource
|
path | True |
string |
O nome do grupo de recursos na subscrição do Azure. |
subscription
|
path | True |
string |
O identificador exclusivo de uma subscrição do Microsoft Azure. |
api-version
|
query | True |
string |
A versão da API a ser utilizada com o pedido de cliente. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
OK. O pedido foi efetuada com êxito. |
|
Other Status Codes |
A resposta do erro de transmissão em fluxo que descreve o motivo pela qual a operação falhou. |
Exemplos
List all LiveEvents
Pedido de amostra
Resposta da amostra
{
"value": [
{
"name": "myLiveEvent1",
"id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
"type": "Microsoft.Media/mediaservices/liveevents",
"location": "West US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"description": "test event 1",
"resourceState": "Stopped",
"provisioningState": "Succeeded",
"created": "2018-03-03T02:25:08.5564064Z",
"lastModified": "2018-03-03T02:25:08.5564064Z",
"useStaticHostname": false,
"streamOptions": [],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "RTMP",
"accessToken": "<accessToken>",
"endpoints": [
{
"protocol": "RTMP",
"url": "rtmp://clouddeployment.media-test.net:1935/live/de153bb0814542d9b7e2339ce9430dc4"
},
{
"protocol": "RTMP",
"url": "rtmp://clouddeployment.media-test.net:1936/live/de153bb0814542d9b7e2339ce9430dc4"
},
{
"protocol": "RTMP",
"url": "rtmps://clouddeployment.media-test.net:2935/live/de153bb0814542d9b7e2339ce9430dc4"
},
{
"protocol": "RTMP",
"url": "rtmps://clouddeployment.media-test.net:2936/live/de153bb0814542d9b7e2339ce9430dc4"
}
],
"timedMetadataEndpoints": [
{
"url": "https://clouddeployment.media-test.net/de153bb0814542d9b7e2339ce9430dc4/ingest.isml/eventdata"
}
]
},
"preview": {
"previewLocator": "a220e223-faf8-4e03-b9a9-2c2432f48025",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"endpoints": [
{
"protocol": "FragmentedMP4",
"url": "https://myliveevent1-slitestmedia10.preview-usso.channel.mediaservices.windows.net/a220e223-faf8-4e03-b9a9-2c2432f48025/preview.ism/manifest"
}
]
},
"encoding": {
"encodingType": "None",
"presetName": null
},
"crossSiteAccessPolicies": {
"clientAccessPolicy": null,
"crossDomainPolicy": null
}
}
}
]
}
Definições
Name | Description |
---|---|
created |
O tipo de identidade que criou o recurso. |
Cross |
A política de acesso do cliente. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
IPAccess |
O controlo de acesso ao IP. |
IPRange |
O intervalo de endereços IP no esquema CIDR. |
Live |
O evento em direto. |
Live |
Especifica o tipo de evento em direto e as definições de codificação opcionais para codificar eventos em direto. |
Live |
Tipo de evento em direto. Quando encodingType está definido como PassthroughBasic ou PassthroughStandard, o serviço simplesmente passa pelas camadas de áudio e vídeo recebidos para a saída. Quando encodingType está definido como Standard ou Premium1080p, um codificador em direto transcodifica o fluxo de entrada em múltiplas velocidades de transmissão ou camadas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obter mais informações. Esta propriedade não pode ser modificada após a criação do evento em direto. |
Live |
O ponto final do evento em direto. |
Live |
A entrada do evento em direto. |
Live |
O controlo de acesso ao IP para a entrada de eventos em direto. |
Live |
O protocolo de entrada do evento em direto. Isto é especificado no momento da criação e não pode ser atualizado. |
Live |
Uma condição de seleção de controlo. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
Live |
LiveEventListResult |
Live |
Descreve uma faixa de transcrição na saída de um evento em direto, gerada com a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
Live |
Definições de pré-visualização de eventos em direto. |
Live |
O controlo de acesso ao IP para o ponto final de pré-visualização de eventos em direto. |
Live |
O estado do recurso do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações. |
Live |
O ponto final de inserção de metadados de eventos em direto. |
Live |
Descreve as faixas de transcrição na saída de um evento em direto, gerado através da transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
Stream |
As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada de matriz são "Predefinição" e "LowLatency". |
Stretch |
Especifica como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é Nenhuma |
system |
Metadados relativos à criação e última modificação do recurso. |
createdByType
O tipo de identidade que criou o recurso.
Name | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CrossSiteAccessPolicies
A política de acesso do cliente.
Name | Tipo | Description |
---|---|---|
clientAccessPolicy |
string |
O conteúdo do clientaccesspolicy.xml utilizado pelo Silverlight. |
crossDomainPolicy |
string |
O conteúdo do crossdomain.xml utilizado pelo Silverlight. |
ErrorAdditionalInfo
Informações adicionais sobre o erro de gestão de recursos.
Name | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informações adicionais. |
ErrorDetail
O detalhe do erro.
Name | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta a erros
Name | Tipo | Description |
---|---|---|
error |
O objeto de erro. |
IPAccessControl
O controlo de acesso ao IP.
Name | Tipo | Description |
---|---|---|
allow |
IPRange[] |
A lista de permissões de IP. |
IPRange
O intervalo de endereços IP no esquema CIDR.
Name | Tipo | Description |
---|---|---|
address |
string |
O endereço IP. |
name |
string |
O nome amigável do intervalo de endereços IP. |
subnetPrefixLength |
integer |
O comprimento do prefixo da máscara de sub-rede (veja Notação CIDR). |
LiveEvent
O evento em direto.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
A localização geográfica onde o recurso se encontra |
name |
string |
O nome do recurso |
properties.created |
string |
A hora de criação do evento em direto |
properties.crossSiteAccessPolicies |
Políticas de acesso entre sites de eventos em direto. |
|
properties.description |
string |
Uma descrição para o evento em direto. |
properties.encoding |
Definições de codificação para o evento em direto. Configura se um codificador em direto é utilizado para o evento em direto e as definições do codificador em direto, se for utilizado. |
|
properties.hostnamePrefix |
string |
Quando useStaticHostname está definido como verdadeiro, o hostnamePrefix especifica a primeira parte do nome do anfitrião atribuído à pré-visualização de eventos em direto e ingerir pontos finais. O nome de anfitrião final seria uma combinação deste prefixo, o nome da conta do serviço de multimédia e um código abreviado para o datacenter dos Serviços de Multimédia do Azure. |
properties.input |
Definições de entrada de eventos em direto. Define como o evento em direto recebe entradas de um codificador de contribuição. |
|
properties.lastModified |
string |
A última hora modificada do evento em direto. |
properties.preview |
Definições de pré-visualização de eventos em direto. A pré-visualização permite aos produtores de eventos em direto pré-visualizar o conteúdo de transmissão em fluxo em direto sem criar qualquer saída em direto. |
|
properties.provisioningState |
string |
O estado de aprovisionamento do evento em direto. |
properties.resourceState |
O estado do recurso do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações. |
|
properties.streamOptions |
As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada da matriz são "Predefinição" e "LowLatency". |
|
properties.transcriptions |
Definições de transcrição em direto para o evento em direto. Veja https://go.microsoft.com/fwlink/?linkid=2133742 para obter mais informações sobre a funcionalidade de transcrição em direto. |
|
properties.useStaticHostname |
boolean |
Especifica se um nome de anfitrião estático seria atribuído à pré-visualização de eventos em direto e pontos finais de ingestão. Este valor só pode ser atualizado se o evento em direto estiver no estado De Espera |
systemData |
Os metadados do sistema relacionados com este recurso. |
|
tags |
object |
Etiquetas de recursos. |
type |
string |
O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
LiveEventEncoding
Especifica o tipo de evento em direto e as definições de codificação opcionais para codificar eventos em direto.
Name | Tipo | Description |
---|---|---|
encodingType |
Tipo de evento em direto. Quando encodingType está definido como PassthroughBasic ou PassthroughStandard, o serviço simplesmente passa pelas camadas de áudio e vídeo recebidos para a saída. Quando encodingType está definido como Standard ou Premium1080p, um codificador dinâmico transcodifica o fluxo de entrada em múltiplas velocidades de transmissão ou camadas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obter mais informações. Esta propriedade não pode ser modificada após a criação do evento em direto. |
|
keyFrameInterval |
string |
Utilize um valor de tempo ISO 8601 entre 0,5 e 20 segundos para especificar o comprimento do fragmento de saída para as faixas de vídeo e áudio de um evento em direto de codificação. Por exemplo, utilize PT2S para indicar 2 segundos. Para a faixa de vídeo, também define o intervalo da moldura da chave ou o comprimento de um GoP (grupo de imagens). Se este valor não estiver definido para um evento em direto de codificação, a duração do fragmento é predefinida para 2 segundos. Não é possível definir o valor para eventos em direto pass-through. |
presetName |
string |
O nome predefinido de codificação opcional, utilizado quando encodingType não é Nenhum. Este valor é especificado no momento da criação e não pode ser atualizado. Se o encodingType estiver definido como Standard, o nome predefinido predefinido é "Default720p". Caso contrário, se o encodingType estiver definido como Premium1080p, a predefinição predefinida é "Default1080p". |
stretchMode |
Especifica como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é Nenhuma |
LiveEventEncodingType
Tipo de evento em direto. Quando encodingType está definido como PassthroughBasic ou PassthroughStandard, o serviço simplesmente passa pelas camadas de áudio e vídeo recebidos para a saída. Quando encodingType está definido como Standard ou Premium1080p, um codificador em direto transcodifica o fluxo de entrada em múltiplas velocidades de transmissão ou camadas. Consulte https://go.microsoft.com/fwlink/?linkid=2095101 para obter mais informações. Esta propriedade não pode ser modificada após a criação do evento em direto.
Name | Tipo | Description |
---|---|---|
None |
string |
Isto é o mesmo que PassthroughStandard. Veja a descrição abaixo. Este valor de enumeração está a ser preterido. |
PassthroughBasic |
string |
O fluxo ingerido passa pelo evento em direto a partir do codificador de contribuição sem qualquer processamento adicional. No modo PassthroughBasic, a ingestão está limitada a até 5 Mbps e só é permitida uma saída em direto simultânea. A transcrição em direto não está disponível. |
PassthroughStandard |
string |
O fluxo ingerido passa pelo evento em direto a partir do codificador de contribuição sem qualquer processamento adicional. A transcrição em direto está disponível. Os limites de velocidade de transmissão da ingestão são muito superiores e são permitidas até 3 saídas em direto simultâneas. |
Premium1080p |
string |
Um codificador em direto de contribuição envia uma transmissão em fluxo de velocidade de transmissão única para o evento em direto e os Serviços de Multimédia criam vários fluxos de velocidade de transmissão. A saída não pode exceder os 1080p na resolução. |
Standard |
string |
Um codificador em direto de contribuição envia uma transmissão em fluxo de velocidade de transmissão única para o evento em direto e os Serviços de Multimédia criam vários fluxos de velocidade de transmissão. A saída não pode exceder os 720p na resolução. |
LiveEventEndpoint
O ponto final do evento em direto.
Name | Tipo | Description |
---|---|---|
protocol |
string |
O protocolo de ponto final. |
url |
string |
O URL do ponto final. |
LiveEventInput
A entrada do evento em direto.
Name | Tipo | Description |
---|---|---|
accessControl |
Controlo de acesso para entrada de eventos em direto. |
|
accessToken |
string |
Um UUID em forma de cadeia para identificar exclusivamente o fluxo. Isto pode ser especificado no momento da criação, mas não pode ser atualizado. Se omitido, o serviço irá gerar um valor exclusivo. |
endpoints |
Os pontos finais de entrada para o evento em direto. |
|
keyFrameIntervalDuration |
string |
ISO 8601 duração de tempo da duração do intervalo de fotogramas chave da entrada. Este valor define a propriedade EXT-X-TARGETDURATION na saída HLS. Por exemplo, utilize PT2S para indicar 2 segundos. Deixe o valor vazio para codificar eventos em direto. |
streamingProtocol |
O protocolo de entrada para o evento em direto. Esta ação é especificada no momento da criação e não pode ser atualizada. |
|
timedMetadataEndpoints |
Os pontos finais de metadados do evento em direto. |
LiveEventInputAccessControl
O controlo de acesso ao IP para a entrada de eventos em direto.
Name | Tipo | Description |
---|---|---|
ip |
As propriedades do controlo de acesso ao IP. |
LiveEventInputProtocol
O protocolo de entrada do evento em direto. Isto é especificado no momento da criação e não pode ser atualizado.
Name | Tipo | Description |
---|---|---|
FragmentedMP4 |
string |
A entrada de Transmissão em Fluxo Uniforme será enviada pelo codificador de contribuição para o evento em direto. |
RTMP |
string |
A entrada RTMP será enviada pelo codificador de contribuição para o evento em direto. |
LiveEventInputTrackSelection
Uma condição de seleção de controlo. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
Name | Tipo | Description |
---|---|---|
operation |
string |
A comparar a operação. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
property |
string |
Nome da propriedade a selecionar. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
value |
string |
Valor da propriedade a selecionar. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
LiveEventListResult
LiveEventListResult
Name | Tipo | Description |
---|---|---|
@odata.count |
integer |
O número de resultados. |
@odata.nextLink |
string |
A ligação para o próximo conjunto de resultados. Não está vazio se o valor contiver uma lista incompleta de saídas dinâmicas. |
value |
O resultado da operação Listar Evento em Direto. |
LiveEventOutputTranscriptionTrack
Descreve uma faixa de transcrição na saída de um evento em direto, gerada com a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
Name | Tipo | Description |
---|---|---|
trackName |
string |
O nome do registo de saída. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
LiveEventPreview
Definições de pré-visualização de eventos em direto.
Name | Tipo | Description |
---|---|---|
accessControl |
O controlo de acesso para pré-visualização de eventos em direto. |
|
alternativeMediaId |
string |
Um identificador de multimédia alternativo associado ao localizador de transmissão em fluxo criado para a pré-visualização. Este valor é especificado no momento da criação e não pode ser atualizado. O identificador pode ser utilizado no CustomLicenseAcquisitionUrlTemplate ou no CustomKeyAcquisitionUrlTemplate do StreamingPolicy especificado no campo StreamingPolicyName. |
endpoints |
Os pontos finais para pré-visualização. Não partilhe o URL de pré-visualização com a audiência do evento em direto. |
|
previewLocator |
string |
O identificador do localizador de pré-visualização no formato Guid. Especificar isto no momento da criação permite que o autor da chamada saiba o URL do localizador de pré-visualização antes de o evento ser criado. Se omitido, o serviço irá gerar um identificador aleatório. Este valor não pode ser atualizado depois de o evento em direto ser criado. |
streamingPolicyName |
string |
O nome da política de transmissão em fluxo utilizada para a pré-visualização de eventos em direto. Este valor é especificado no momento da criação e não pode ser atualizado. |
LiveEventPreviewAccessControl
O controlo de acesso ao IP para o ponto final de pré-visualização de eventos em direto.
Name | Tipo | Description |
---|---|---|
ip |
As propriedades do controlo de acesso ao IP. |
LiveEventResourceState
O estado do recurso do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.
Name | Tipo | Description |
---|---|---|
Allocating |
string |
A ação alocar foi chamada no evento em direto e os recursos estão a ser aprovisionados para este evento em direto. Assim que a alocação for concluída com êxito, o evento em direto transitará para o estado StandBy. |
Deleting |
string |
O evento em direto está a ser eliminado. Não ocorre nenhuma faturação neste estado transitório. Atualizações ou transmissão em fluxo não são permitidos durante este estado. |
Running |
string |
Os recursos de eventos em direto foram alocados, os URLs de ingestão e pré-visualização foram gerados e é capaz de receber transmissões em direto. Neste momento, a faturação está ativa. Tem de chamar explicitamente Parar no recurso do evento em direto para parar a faturação adicional. |
StandBy |
string |
Os recursos de eventos em direto foram aprovisionados e estão prontos para começar. A faturação ocorre neste estado. A maioria das propriedades ainda pode ser atualizada. No entanto, a ingestão ou a transmissão em fluxo não são permitidas durante este estado. |
Starting |
string |
O evento em direto está a ser iniciado e os recursos estão a ser alocados. Não ocorre nenhuma faturação neste estado. Atualizações ou transmissão em fluxo não são permitidos durante este estado. Se ocorrer um erro, o evento em direto regressa ao estado Parado. |
Stopped |
string |
Este é o estado inicial do evento em direto após a criação (a menos que o início automático tenha sido definido como verdadeiro.) Não ocorre nenhuma faturação neste estado. Neste estado, as propriedades do evento em direto podem ser atualizadas, mas a transmissão em fluxo não é permitida. |
Stopping |
string |
O evento em direto está a ser parado e os recursos estão a ser desaprovisionados. Não ocorre nenhuma faturação neste estado transitório. Atualizações ou transmissão em fluxo não são permitidos durante este estado. |
LiveEventTimedMetadataEndpoint
O ponto final de inserção de metadados de eventos em direto.
Name | Tipo | Description |
---|---|---|
url |
string |
O URL do ponto final de metadados. |
LiveEventTranscription
Descreve as faixas de transcrição na saída de um evento em direto, gerado através da transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado.
Name | Tipo | Description |
---|---|---|
inputTrackSelection |
Fornece um mecanismo para selecionar a faixa de áudio no feed dinâmico de entrada, ao qual é aplicada a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
|
language |
string |
Especifica o idioma (região) a ser utilizado para transcrição de voz em texto– deve corresponder ao idioma falado na faixa de áudio. O valor deve estar no formato BCP-47 (por exemplo, "en-US"). Veja https://go.microsoft.com/fwlink/?linkid=2133742 para obter mais informações sobre a funcionalidade de transcrição em direto e a lista de idiomas suportados. |
outputTranscriptionTrack |
Descreve uma faixa de transcrição na saída de um evento em direto, gerada com a transcrição de voz em texto. Esta propriedade está reservada para utilização futura, qualquer valor definido nesta propriedade será ignorado. |
StreamOptionsFlag
As opções a utilizar para o LiveEvent. Este valor é especificado no momento da criação e não pode ser atualizado. Os valores válidos para os valores de entrada de matriz são "Predefinição" e "LowLatency".
Name | Tipo | Description |
---|---|---|
Default |
string |
Transmissão em fluxo em direto sem otimizações de latência especiais. |
LowLatency |
string |
O evento em direto proporciona latência de ponto a ponto inferior ao reduzir as memórias intermédias internas. |
LowLatencyV2 |
string |
O evento em direto está otimizado para latência ponto a ponto. Esta opção só está disponível para codificar eventos em direto com entrada RTMP. As saídas podem ser transmitidas em fluxo com formatos HLS ou DASH. O comprimento de rebobinamento do DVR ou arquivo das saídas está limitado a 6 horas. Utilize a opção de fluxo "LowLatency" para todos os outros cenários. |
StretchMode
Especifica como o vídeo de entrada será redimensionado para se ajustar às resoluções de saída pretendidas. A predefinição é Nenhuma
Name | Tipo | Description |
---|---|---|
AutoFit |
string |
Preencho a saída (com caixa de correio ou pilar) para respeitar a resolução de saída, garantindo ao mesmo tempo que a região de vídeo ativa na saída tem a mesma proporção que a entrada. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, a saída será a 1280x1280, que contém um retângulo interno de 1280x720 na proporção de 16:9 e as regiões da caixa do pilar com 280 píxeis de largura à esquerda e à direita. |
AutoSize |
string |
Substitua a resolução de saída e altere-a para corresponder à proporção de apresentação da entrada, sem preenchimento. Por exemplo, se a entrada for 1920x1080 e a predefinição de codificação pedir 1280x1280, o valor na predefinição será substituído e o resultado será 1280x720, que mantém a proporção de entrada de 16:9. |
None |
string |
Respeita estritamente a resolução de saída especificada na predefinição de codificação sem considerar a proporção de píxeis ou apresentar a proporção do vídeo de entrada. |
systemData
Metadados relativos à criação e última modificação do recurso.
Name | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |