Live Events - List Get Status

Referência

Serviço:: Media Services

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

Obter o estado de um evento em direto
Obtém a telemetria de estado de um evento em direto.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Multimédia.
liveEventName	path	True	string	O nome do evento em direto, 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 subscrição do Azure.
subscriptionId	path	True	string	O identificador exclusivo de uma subscrição do Microsoft Azure.
api-version	query	True	string	A versão da API a utilizar com o pedido de cliente.

Respostas

Name	Tipo	Description
200 OK	LiveEventGetStatusResult	OK. O pedido foi bem-sucedido.
202 Accepted		Aceite. O pedido foi aceite para processamento e a operação será concluída de forma assíncrona. Veja https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre as Operações do Azure assíncronas de monitorização. Cabeçalhos Location: string Azure-AsyncOperation: string
Other Status Codes		Não Modificado. O eTag no cabeçalho do pedido é o mesmo que o eTag no contentor de armazenamento.
Other Status Codes	ErrorResponse	A resposta a erros de transmissão em fluxo que descreve a razão pela qual 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 da amostra

Código de estado:: 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 estado:: 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 estado:: 304

Definições

Name	Description
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
LiveEventGetStatusResult	Obtenha o resultado do estado do evento em direto.
LiveEventHealthStatus	Estado de funcionamento dos últimos 20 segundos.
LiveEventIngestInterruption	Os dados de interrupção da ingestão de eventos em direto.
LiveEventIngestion	Os dados telemétricos de ingestão de eventos em direto.
LiveEventState	Estado atual do evento em direto. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obter mais informações.
LiveEventStatus	O estado do evento em direto.
LiveEventTrackStatus	O estado do registo de eventos em direto.

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ção adicional.

ErrorDetail

O detalhe do erro.

Name	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 a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

LiveEventGetStatusResult

Obtenha o resultado do estado do evento em direto.

Name	Tipo	Description
value	LiveEventStatus[]	O resultado do estado do evento em direto.

LiveEventHealthStatus

Estado de funcionamento dos últimos 20 segundos.

Name	Tipo	Description
Excellent	string	Velocidade de transmissão >de entrada = 75% da velocidade de transmissão de destino E nenhum aviso de ingestão e erro E ABS(Ingestão À Deriva) é igual a 0.
Good	string	Velocidade de transmissão >de entrada = 20% E nenhuma exceção de erro ou aviso de ingestão de dados descontinua o intervalo < de 10 segundos.
Poor	string	Caso contrário.

LiveEventIngestInterruption

Os dados de interrupção da ingestão de eventos em direto.

Name	Tipo	Description
begin	string	Hora UTC do início da interrupção, codificador desligado.
duration	string	Duração da interrupção na hora ISO 8601. Por exemplo, utilize PT1H30M para indicar 1 hora e 30 minutos.
end	string	Hora UTC do fim da interrupção, codificador novamente ligado.
reason	string	Motivo da interrupção.

LiveEventIngestion

Os dados telemétricos de ingestão de eventos em direto.

Name	Tipo	Description
begin	string	Hora de início da ingestão em UTC.
end	string	Hora de fim da ingestão em UTC. Vazio se ainda não tiver parado.
endReason	string	Motivo pelo qual a ingestão para. Vazio se ainda não tiver parado. Por exemplo, Serviço Parado. Sem ingestão.
ingestInterruptions	LiveEventIngestInterruption[]	Lista de entrada IngestInterruption.
streamName	string	Nome do fluxo de ingestão.

LiveEventState

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

Name	Tipo	Description
Running	string	Os recursos de eventos em direto foram alocados, foram gerados URLs de ingestão e pré-visualização e é capaz de receber transmissões em direto. Neste momento, a faturação está ativa. Tem de chamar explicitamente Parar no recurso de evento em direto para parar a faturação adicional.
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.

LiveEventStatus

O estado do evento em direto.

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

LiveEventTrackStatus

O estado do registo de eventos em direto.

Name	Tipo	Description
expectedBitrate	integer	Velocidade de transmissão esperada para esta faixa.
incomingBitrate	integer	Taxa média de entrada dos últimos 20 segundos quando o evento em direto está em execução.
ingestDrift	string	Valor de desvio de ingestão atual em segundos durante os últimos 1 minuto.
requestReceived	integer	Número total de pedidos de metadados cronometrados recebidos.
requestSucceeded	integer	Número total de pedidos de metadados cronometrados bem-sucedidos recebidos.
trackId	string	Controlar O ID.

Partilhar via