Live Events - List Get Status

Referência

Serviço:: Media Services

Versão da API:: 2022-11-01

Obter status de um evento ao vivo
Obtém status telemetria de um evento ao vivo.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/getStatus?api-version=2022-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Mídia.
liveEventName	path	True	string	O nome do evento ao vivo, o comprimento máximo é 32. Padrão Regex: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	O nome do grupo de recursos na assinatura do Azure.
subscriptionId	path	True	string	O identificador exclusivo para uma assinatura do Microsoft Azure.
api-version	query	True	string	A versão da API a ser usada com a solicitação do cliente.

Respostas

Nome	Tipo	Description
200 OK	LiveEventGetStatusResult	OK. A solicitação foi bem-sucedida.
202 Accepted		Aceita. A solicitação foi aceita para processamento e a operação será concluída de forma assíncrona. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre o monitoramento de operações assíncronas do Azure. Cabeçalhos Location: string Azure-AsyncOperation: string
Other Status Codes		Não modificado. A eTag no cabeçalho da solicitação é a mesma que a eTag no contêiner de armazenamento.
Other Status Codes	ErrorResponse	A resposta de erro de streaming que descreve por que a operação falhou.

Exemplos

Get status of a LiveEvent

POST https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1/getStatus?api-version=2022-11-01


/**
 * Samples for LiveEvents ListGetStatus.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-get-
     * status.json
     */
    /**
     * Sample code: Get status of a LiveEvent.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getStatusOfALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveEvents().listGetStatus("mediaresources", "slitestmedia10", "myLiveEvent1",
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "state": "Stopped",
      "healthStatus": "",
      "healthDescriptions": [
        "No issues with ingest."
      ],
      "lastUpdatedTime": "2022-10-19T22:23:05.22Z",
      "ingestion": {
        "streamName": "myStream",
        "begin": "2022-08-17T22:13:59.45Z",
        "end": "2022-08-17T22:20:36.33Z",
        "endReason": "MPE_CLIENT_TERMINATED_SESSION",
        "ingestInterruptions": [
          {
            "begin": "2022-08-17T22:14:32.33Z",
            "end": "2022-08-17T22:15:33.22Z",
            "duration": "PT1S",
            "reason": "MPE_CLIENT_TERMINATED_SESSION"
          }
        ]
      },
      "trackStatus": [
        {
          "trackId": "audio_128000",
          "expectedBitrate": 128000,
          "incomingBitrate": null,
          "ingestDrift": "",
          "requestReceived": null,
          "requestSucceeded": null
        },
        {
          "trackId": "video_2025000",
          "expectedBitrate": 2025000,
          "incomingBitrate": null,
          "ingestDrift": "",
          "requestReceived": null,
          "requestSucceeded": null
        }
      ]
    }
  ]
}

Código de status:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

Código de status:: 304

Definições

Nome	Description
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
LiveEventGetStatusResult	Obter status resultado do evento ao vivo.
LiveEventHealthStatus	Integridade status dos últimos 20 segundos.
LiveEventIngestInterruption	Os dados de interrupção da ingestão de eventos ao vivo.
LiveEventIngestion	Os dados de telemetria de ingestão de eventos ao vivo.
LiveEventState	Estado atual do evento ao vivo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.
LiveEventStatus	O evento ao vivo status.
LiveEventTrackStatus	A faixa de eventos ao vivo status.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

LiveEventGetStatusResult

Obter status resultado do evento ao vivo.

Nome	Tipo	Description
value	LiveEventStatus[]	O resultado da status obter evento ao vivo.

LiveEventHealthStatus

Integridade status dos últimos 20 segundos.

Nome	Tipo	Description
Excellent	string	Taxa de bits de >entrada = 75% da taxa de bits de destino E nenhum aviso de ingestão e erro E ABS(IngestDrift) é igual a 0.
Good	string	Taxa de bits de >entrada = 20% E sem erros de ingestão ou descontinuidades de exceção de aviso que são descontinuadas < de 10 segundos.
Poor	string	Caso contrário.

LiveEventIngestInterruption

Os dados de interrupção da ingestão de eventos ao vivo.

Nome	Tipo	Description
begin	string	Hora UTC de início da interrupção, codificador desconectado.
duration	string	Duração da interrupção no tempo ISO 8601. Por exemplo, use PT1H30M para indicar 1 hora e 30 minutos.
end	string	Hora UTC de término da interrupção, codificador conectado novamente.
reason	string	Motivo da interrupção.

LiveEventIngestion

Os dados de telemetria de ingestão de eventos ao vivo.

Nome	Tipo	Description
begin	string	Hora de início da ingestão em UTC.
end	string	Hora de término da ingestão em UTC. Vazio se ainda não tiver sido interrompido.
endReason	string	Motivo pelo qual a ingestão é interrompida. Vazio se ainda não tiver sido interrompido. Por exemplo, serviço interrompido. Sem ingestão.
ingestInterruptions	LiveEventIngestInterruption[]	Lista de entradas IngestInterruption.
streamName	string	Nome do fluxo de ingestão.

LiveEventState

Estado atual do evento ao vivo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.

Nome	Tipo	Description
Running	string	Os recursos do evento ao vivo foram alocados, as URLs de visualização e ingestão foram geradas e o evento ao vivo já pode receber transmissões ao vivo. Neste ponto, o faturamento está ativo. É necessário chamar explicitamente o recurso Parar no evento ao vivo para impedir cobranças adicionais.
Stopped	string	Esse é o estado inicial do evento ao vivo após a criação (exceto se a inicialização automática estiver definida como true). Não há cobrança nesse estado. Nesse estado, as propriedades do evento ao vivo podem ser atualizadas, mas o streaming não é permitido.

LiveEventStatus

O evento ao vivo status.

Nome	Tipo	Description
healthDescriptions	string[]	Lista de cadeias de caracteres que justificam o status de integridade.
healthStatus	LiveEventHealthStatus	Integridade status dos últimos 20 segundos.
ingestion	LiveEventIngestion	Entrada de ingestão de eventos ao vivo.
lastUpdatedTime	string	Hora UTC da última atualização deste status.
state	LiveEventState	Estado atual do evento ao vivo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.
trackStatus	LiveEventTrackStatus[]	Acompanhe a lista de entradas.

LiveEventTrackStatus

A faixa de eventos ao vivo status.

Nome	Tipo	Description
expectedBitrate	integer	Taxa de bits esperada para essa faixa.
incomingBitrate	integer	Taxa média de bits de entrada nos últimos 20 segundos quando o evento ao vivo está em execução.
ingestDrift	string	Valor de descompasso de ingestão atual em segundos para o último minuto.
requestReceived	integer	Número total de solicitações de metadados cronometrados recebidas.
requestSucceeded	integer	Número total de solicitações de metadados cronometrados bem-sucedida recebidas.
trackId	string	ID da faixa.

Compartilhar via