Live Events - List Get Status

Riferimento

Service:: Media Services

API Version:: 2022-11-01

Ottenere lo stato di un evento live
Ottiene i dati di telemetria dello stato di un evento live.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
accountName	path	True	string	Nome dell'account di Servizi multimediali.
liveEventName	path	True	string	Il nome dell'evento live, la lunghezza massima è 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nome del gruppo di risorse all'interno della sottoscrizione di Azure.
subscriptionId	path	True	string	Identificatore univoco per una sottoscrizione di Microsoft Azure.
api-version	query	True	string	Versione dell'API da usare con la richiesta client.

Risposte

Nome	Tipo	Descrizione
200 OK	LiveEventGetStatusResult	OK. La richiesta ha avuto esito positivo.
202 Accepted		Accettato. La richiesta è stata accettata per l'elaborazione e l'operazione verrà completata in modo asincrono. Per informazioni dettagliate sul monitoraggio delle operazioni asincrone di Azure, vedere https://go.microsoft.com/fwlink/?linkid=2087017 per informazioni dettagliate sul monitoraggio delle operazioni di Azure. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Non modificato. L'eTag nell'intestazione della richiesta è uguale a eTag nel contenitore di archiviazione.
Other Status Codes	ErrorResponse	Risposta di errore di streaming che descrive perché l'operazione non è riuscita.

Esempio

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

Sample Response

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

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sulla gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
LiveEventGetStatusResult	Ottenere il risultato dello stato dell'evento live.
LiveEventHealthStatus	Stato di integrità degli ultimi 20 secondi.
LiveEventIngestInterruption	L'evento live inserisce i dati di interruzione.
LiveEventIngestion	Dati di telemetria di inserimento eventi live.
LiveEventState	Stato corrente dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventStatus	Stato dell'evento live.
LiveEventTrackStatus	Stato della traccia dell'evento live.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

LiveEventGetStatusResult

Ottenere il risultato dello stato dell'evento live.

Nome	Tipo	Descrizione
value	LiveEventStatus[]	Risultato dello stato dell'evento live.

LiveEventHealthStatus

Stato di integrità degli ultimi 20 secondi.

Nome	Tipo	Descrizione
Excellent	string	Velocità in bit in ingresso = 75% di bitrate >di destinazione E nessun avviso di inserimento e errore AND ABS(IngestDrift) è uguale a 0.
Good	string	Velocità >in ingresso = 20% E nessun errore di inserimento o interruzione dell'eccezione di avviso che si trova a < 10 secondi.
Poor	string	Altrimenti.

LiveEventIngestInterruption

L'evento live inserisce i dati di interruzione.

Nome	Tipo	Descrizione
begin	string	Ora UTC di avvio dell'interruzione, codificatore disconnesso.
duration	string	Durata dell'interruzione nell'ora ISO 8601. Ad esempio, usare PT1H30M per indicare 1 ora e 30 minuti.
end	string	Ora UTC di fine interruzione, codificatore riconnessa.
reason	string	Motivo di interruzione.

LiveEventIngestion

Dati di telemetria di inserimento eventi live.

Nome	Tipo	Descrizione
begin	string	Ora di inizio inserimento in FORMATO UTC.
end	string	Ora di fine inserimento in FORMATO UTC. Vuoto se non è ancora arrestato.
endReason	string	Motivo per cui l'inserimento si arresta. Vuoto se non è ancora arrestato. Ad esempio, servizio arrestato. Nessun inserimento.
ingestInterruptions	LiveEventIngestInterruption[]	Elenco di voci ingestInterruption.
streamName	string	Nome del flusso di inserimento.

LiveEventState

Stato corrente dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.

Nome	Tipo	Descrizione
Running	string	Le risorse degli eventi live sono state allocate, inseriti e URL di anteprima sono stati generati ed è in grado di ricevere flussi live. A questo punto, la fatturazione è attiva. È necessario chiamare in modo esplicito Stop nella risorsa evento live per arrestare ulteriormente la fatturazione.
Stopped	string	Questo è lo stato iniziale dell'evento live dopo la creazione (a meno che l'avvio automatico non sia stato impostato su true). Nessuna fatturazione si verifica in questo stato. In questo stato, le proprietà degli eventi live possono essere aggiornate ma lo streaming non è consentito.

LiveEventStatus

Stato dell'evento live.

Nome	Tipo	Descrizione
healthDescriptions	string[]	Elenco di stringhe che giustificano lo stato di integrità.
healthStatus	LiveEventHealthStatus	Stato di integrità degli ultimi 20 secondi.
ingestion	LiveEventIngestion	Voce di inserimento eventi live.
lastUpdatedTime	string	Ultima ora UTC aggiornata di questo stato.
state	LiveEventState	Stato corrente dell'evento live. Per altre informazioni, vedere https://go.microsoft.com/fwlink/?linkid=2139012.
trackStatus	LiveEventTrackStatus[]	Tenere traccia dell'elenco di voci.

LiveEventTrackStatus

Stato della traccia dell'evento live.

Nome	Tipo	Descrizione
expectedBitrate	integer	Velocità in bit prevista per questa traccia.
incomingBitrate	integer	Velocità in bit in ingresso media per gli ultimi 20 secondi quando l'evento live è in esecuzione.
ingestDrift	string	Valore di deriva dell'inserimento corrente in secondi per l'ultimo minuto.
requestReceived	integer	Numero totale di richieste di metadati timed ricevute.
requestSucceeded	integer	Numero totale di richieste di metadati timed ricevute.
trackId	string	Id traccia.

Share via