Live Events - List Get Status

Referencia

Servicio:: Media Services

Versión de la API:: 2022-11-01

Obtención del estado de un evento en directo
Obtiene la telemetría de estado de un evento en directo.

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 identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string	Nombre de la cuenta de Media Services.
liveEventName	path	True	string	El nombre del evento en directo, la longitud máxima es 32. Patrón de Regex: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción de Azure.
subscriptionId	path	True	string	Identificador único de una suscripción de Microsoft Azure.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	LiveEventGetStatusResult	Aceptar. La solicitud se ha realizado correctamente.
202 Accepted		Accepted. La solicitud se ha aceptado para su procesamiento y la operación se completará de forma asincrónica. Consulte https://go.microsoft.com/fwlink/?linkid=2087017 para más información sobre las operaciones asincrónicas de Azure de supervisión. Encabezados Location: string Azure-AsyncOperation: string
Other Status Codes		No modificado. La eTag del encabezado de solicitud es la misma que la eTag en el contenedor de almacenamiento.
Other Status Codes	ErrorResponse	Respuesta de error de streaming que describe por qué se produjo un error en la operación.

Ejemplos

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

Respuesta de muestra

status code:: 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
        }
      ]
    }
  ]
}

status code:: 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

status code:: 304

Definiciones

Nombre	Description
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
LiveEventGetStatusResult	Obtiene el resultado del estado del evento en directo.
LiveEventHealthStatus	Estado de mantenimiento de los últimos 20 segundos.
LiveEventIngestInterruption	Los datos de interrupción de ingesta de eventos en directo.
LiveEventIngestion	Datos de telemetría de ingesta de eventos en directo.
LiveEventState	Estado actual del evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obtener más información.
LiveEventStatus	Estado del evento en directo.
LiveEventTrackStatus	Estado de la pista de eventos en directo.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Los detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

LiveEventGetStatusResult

Obtiene el resultado del estado del evento en directo.

Nombre	Tipo	Description
value	LiveEventStatus[]	Resultado de la obtención del estado del evento en directo.

LiveEventHealthStatus

Estado de mantenimiento de los últimos 20 segundos.

Nombre	Tipo	Description
Excellent	string	Velocidad de bits >entrante = el 75 % de la velocidad de bits de destino Y no hay advertencia de ingesta y error AND ABS(IngestDrift) es igual a 0.
Good	string	Velocidad de >bits entrante = 20 % AND sin errores de ingesta o interrupciones de excepción de advertencia que gap < 10 segundos.
Poor	string	Lo contrario.

LiveEventIngestInterruption

Los datos de interrupción de ingesta de eventos en directo.

Nombre	Tipo	Description
begin	string	Hora UTC de inicio de interrupción, codificador desconectado.
duration	string	Duración de la interrupción en la hora ISO 8601. Por ejemplo, use PT1H30M para indicar 1 hora y 30 minutos.
end	string	Hora UTC del final de la interrupción, el codificador se vuelve a conectar.
reason	string	Motivo de interrupción.

LiveEventIngestion

Datos de telemetría de ingesta de eventos en directo.

Nombre	Tipo	Description
begin	string	Hora de inicio de la ingesta en UTC.
end	string	Hora de finalización de la ingesta en UTC. Está vacío si aún no está detenido.
endReason	string	Motivo por el que se detiene la ingesta. Está vacío si aún no está detenido. Por ejemplo, servicio detenido. Sin ingesta.
ingestInterruptions	LiveEventIngestInterruption[]	Lista de entradas ingestInterruption.
streamName	string	Nombre del flujo de ingesta.

LiveEventState

Estado actual del evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obtener más información.

Nombre	Tipo	Description
Running	string	Se han asignado los recursos del evento en directo, se han generado las direcciones URL de ingesta y visualización previa y puede recibir transmisiones en vivo. En este momento, la facturación está activa. Debe llamar explícitamente a Stop en el recurso del evento en directo para evitar que continúe la facturación.
Stopped	string	Este es el estado inicial del evento en directo después de su creación (a menos que haya establecido el inicio automático en true). No se produce ninguna facturación en este estado. En este estado, las propiedades del evento en directo se pueden actualizar, pero no se permite el streaming.

LiveEventStatus

Estado del evento en directo.

Nombre	Tipo	Description
healthDescriptions	string[]	Lista de cadenas que justifican el estado de mantenimiento.
healthStatus	LiveEventHealthStatus	Estado de mantenimiento de los últimos 20 segundos.
ingestion	LiveEventIngestion	Entrada de ingesta de eventos en directo.
lastUpdatedTime	string	Hora UTC actualizada por última vez de este estado.
state	LiveEventState	Estado actual del evento en directo. Consulte https://go.microsoft.com/fwlink/?linkid=2139012 para obtener más información.
trackStatus	LiveEventTrackStatus[]	Seguimiento de la lista de entradas.

LiveEventTrackStatus

Estado de la pista de eventos en directo.

Nombre	Tipo	Description
expectedBitrate	integer	Velocidad de bits esperada para esta pista.
incomingBitrate	integer	Velocidad de bits entrante media durante los últimos 20 segundos cuando se ejecuta el evento en directo.
ingestDrift	string	Valor de desfase de ingesta actual en segundos durante los últimos 1 minuto.
requestReceived	integer	Número total de solicitudes de metadatos con tiempo recibidas.
requestSucceeded	integer	Número total de solicitudes de metadatos con tiempo correcto recibidas.
trackId	string	Id. de seguimiento.

Compartir a través de