Live Events - List Get Status

Referenz

Dienst:: Media Services

API-Version:: 2022-11-01

Abrufen status eines Liveereignisses
Ruft status Telemetriedaten eines Liveereignisses ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string	Der Name des Media Services-Kontos.
liveEventName	path	True	string	Der Name des Liveereignisses, die maximale Länge beträgt 32. RegEx-Muster: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.
subscriptionId	path	True	string	Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.
api-version	query	True	string	Die Version der API, die mit der Clientanforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	LiveEventGetStatusResult	OK. Die Anforderung war erfolgreich.
202 Accepted		Akzeptiert: Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Ausführliche Informationen zur Überwachung asynchroner Azure-Vorgänge finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter. Header Location: string Azure-AsyncOperation: string
Other Status Codes		Nicht geändert. Das eTag im Anforderungsheader ist identisch mit dem eTag im Speichercontainer.
Other Status Codes	ErrorResponse	Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

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

Beispiel für eine Antwort

Statuscode:: 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
        }
      ]
    }
  ]
}

Statuscode:: 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

Statuscode:: 304

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
LiveEventGetStatusResult	Abrufen des Liveereignisses status Ergebnis.
LiveEventHealthStatus	Integrität status der letzten 20 Sekunden.
LiveEventIngestInterruption	Das Liveereignis erfasst Unterbrechungsdaten.
LiveEventIngestion	Die Telemetriedaten der Liveereigniserfassung.
LiveEventState	Aktueller Status des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventStatus	Das Liveereignis status.
LiveEventTrackStatus	Die Liveereignisverfolgung status.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

LiveEventGetStatusResult

Abrufen des Liveereignisses status Ergebnis.

Name	Typ	Beschreibung
value	LiveEventStatus[]	Das Ergebnis der status "Liveereignis abrufen".

LiveEventHealthStatus

Integrität status der letzten 20 Sekunden.

Name	Typ	Beschreibung
Excellent	string	Eingehende Bitrate >= 75 % der Zielbitrate UND keine Erfassungswarnung und Fehler AND ABS(IngestDrift) ist gleich 0.
Good	string	Eingehende Bitrate >= 20 % AND no Ingest Error or Warning exception disities which gap < 10 seconds.
Poor	string	Andernfalls.

LiveEventIngestInterruption

Das Liveereignis erfasst Unterbrechungsdaten.

Name	Typ	Beschreibung
begin	string	UTC-Zeit des Unterbrechungsstarts, Encoder getrennt.
duration	string	Dauer der Unterbrechung in ISO 8601. Verwenden Sie beispielsweise PT1H30M, um 1 Stunde und 30 Minuten anzugeben.
end	string	UTC-Zeit des Unterbrechungsendes, Encoder erneut verbunden.
reason	string	Unterbrechungsgrund.

LiveEventIngestion

Die Telemetriedaten der Liveereigniserfassung.

Name	Typ	Beschreibung
begin	string	Startzeit der Erfassung in UTC.
end	string	Endzeit der Erfassung in UTC. Leer, wenn es noch nicht beendet wurde.
endReason	string	Grund, warum die Erfassung beendet wird. Leer, wenn es noch nicht beendet wurde. Z.B. Dienst beendet. Keine Erfassung.
ingestInterruptions	LiveEventIngestInterruption[]	Eintragsliste "IngestInterruption".
streamName	string	Name des Erfassungsdatenstroms.

LiveEventState

Aktueller Status des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.

Name	Typ	Beschreibung
Running	string	Die Liveereignisressourcen wurden zugewiesen, Erfassungs- und Vorschau-URLs wurden generiert, und Livestreams können empfangen werden. Zu diesem Zeitpunkt ist die Abrechnung aktiv. Sie müssen für die Liveereignisressource explizit „Beenden“ auswählen, damit keine Gebühren mehr anfallen.
Stopped	string	Dies ist der anfängliche Zustand des Liveereignisses nach der Erstellung (es sei denn, der automatische Start wurde auf „true“ festgelegt). In diesem Status werden keine Gebühren berechnet. In diesem Zustand können die Liveereigniseigenschaften aktualisiert werden, aber das Streaming ist nicht zulässig.

LiveEventStatus

Das Liveereignis status.

Name	Typ	Beschreibung
healthDescriptions	string[]	Liste der Zeichenfolgen, die die Integrität status.
healthStatus	LiveEventHealthStatus	Integrität status der letzten 20 Sekunden.
ingestion	LiveEventIngestion	Erfassungseintrag für Liveereignisse.
lastUpdatedTime	string	Die UTC-Zeit der letzten Aktualisierung dieses status.
state	LiveEventState	Aktueller Status des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.
trackStatus	LiveEventTrackStatus[]	Eintragsliste nachverfolgen.

LiveEventTrackStatus

Die Liveereignisverfolgung status.

Name	Typ	Beschreibung
expectedBitrate	integer	Erwartete Bitrate für diese Spur.
incomingBitrate	integer	Durchschnittliche eingehende Bitrate für die letzten 20 Sekunden, wenn das Liveereignis ausgeführt wird.
ingestDrift	string	Aktueller Erfassungswert in Sekunden für die letzte Minute.
requestReceived	integer	Gesamtanzahl der empfangenen zeitlimitierten Metadatenanforderung.
requestSucceeded	integer	Gesamtanzahl der erfolgreich empfangenen Metadatenanforderung mit zeitlimitierter Metadaten.
trackId	string	Track-ID.

Freigeben über