Live Events - List Get Status

Odwołanie

Service:: Media Services

API Version:: 2022-11-01

Pobieranie stanu jednego wydarzenia na żywo
Pobiera dane telemetryczne stanu wydarzenia na żywo.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string	Nazwa konta usługi Media Services.
liveEventName	path	True	string	Nazwa wydarzenia na żywo, maksymalna długość to 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nazwa grupy zasobów w ramach subskrypcji platformy Azure.
subscriptionId	path	True	string	Unikatowy identyfikator subskrypcji platformy Microsoft Azure.
api-version	query	True	string	Wersja interfejsu API, która ma być używana z żądaniem klienta.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	LiveEventGetStatusResult	OK. Żądanie zakończyło się pomyślnie.
202 Accepted		Akceptowane. Żądanie zostało zaakceptowane na potrzeby przetwarzania, a operacja zostanie ukończona asynchronicznie. Zobacz https://go.microsoft.com/fwlink/?linkid=2087017 , aby uzyskać szczegółowe informacje na temat asynchronicznych operacji platformy Azure monitorowania. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Nie zmodyfikowano. Element eTag w nagłówku żądania jest taki sam jak element eTag w kontenerze magazynu.
Other Status Codes	ErrorResponse	Odpowiedź z błędem przesyłania strumieniowego opisująca, dlaczego operacja nie powiodła się.

Przykłady

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

Definicje

Nazwa	Opis
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
LiveEventGetStatusResult	Pobierz wynik stanu wydarzenia na żywo.
LiveEventHealthStatus	Stan kondycji z ostatnich 20 sekund.
LiveEventIngestInterruption	Zdarzenie na żywo pozyskuje dane o przerwie.
LiveEventIngestion	Dane telemetryczne pozyskiwania zdarzeń na żywo.
LiveEventState	Bieżący stan wydarzenia na żywo. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventStatus	Stan wydarzenia na żywo.
LiveEventTrackStatus	Stan śledzenia wydarzeń na żywo.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

LiveEventGetStatusResult

Pobierz wynik stanu wydarzenia na żywo.

Nazwa	Typ	Opis
value	LiveEventStatus[]	Wynik stanu zdarzenia na żywo.

LiveEventHealthStatus

Stan kondycji z ostatnich 20 sekund.

Nazwa	Typ	Opis
Excellent	string	Szybkość >transmisji bitów przychodzących = 75% docelowej szybkości transmisji bitów ORAZ brak ostrzeżenia i błędu POZYSKIWANIA ORAZ ABS(IngestDrift) jest równe 0.
Good	string	Szybkość transmisji >bitów przychodzących = 20% I brak błędów pozyskiwania lub wyjątków ostrzegawczych, które przerywają < 10 sekund.
Poor	string	Inaczej.

LiveEventIngestInterruption

Zdarzenie na żywo pozyskuje dane o przerwie.

Nazwa	Typ	Opis
begin	string	Czas utc rozpoczęcia przerwy, odłączony koder.
duration	string	Czas trwania przerwy w działaniu ISO 8601. Na przykład użyj PT1H30M, aby wskazać 1 godzinę i 30 minut.
end	string	Godzina zakończenia przerwy w działaniu kodera i ponownego połączenia.
reason	string	Przyczyna przerwania.

LiveEventIngestion

Dane telemetryczne pozyskiwania zdarzeń na żywo.

Nazwa	Typ	Opis
begin	string	Godzina rozpoczęcia pozyskiwania w formacie UTC.
end	string	Godzina zakończenia pozyskiwania w formacie UTC. Pusty, jeśli jeszcze nie został zatrzymany.
endReason	string	Przyczyna zatrzymania pozyskiwania. Pusty, jeśli jeszcze nie został zatrzymany. Np. Zatrzymano usługę. Brak pozyskiwania.
ingestInterruptions	LiveEventIngestInterruption[]	Lista pozycji IngestInterruption.
streamName	string	Nazwa strumienia pozyskiwania.

LiveEventState

Bieżący stan wydarzenia na żywo. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2139012.

Nazwa	Typ	Opis
Running	string	Przydzielono zasoby zdarzeń na żywo, wygenerowano adresy URL pozyskiwania i podglądu oraz można odbierać strumienie na żywo. W tym momencie rozliczenia są aktywne. Aby zatrzymać dalsze rozliczenia, należy jawnie wywołać metodę Zatrzymaj zasób wydarzenia na żywo.
Stopped	string	Jest to początkowy stan wydarzenia na żywo po utworzeniu (chyba że autostart został ustawiony na wartość true). W tym stanie nie ma żadnych rozliczeń. W tym stanie właściwości wydarzenia na żywo można zaktualizować, ale przesyłanie strumieniowe jest niedozwolone.

LiveEventStatus

Stan wydarzenia na żywo.

Nazwa	Typ	Opis
healthDescriptions	string[]	Lista ciągów uzasadniających stan kondycji.
healthStatus	LiveEventHealthStatus	Stan kondycji z ostatnich 20 sekund.
ingestion	LiveEventIngestion	Wpis pozyskiwania zdarzeń na żywo.
lastUpdatedTime	string	Ostatnia aktualizacja czasu UTC tego stanu.
state	LiveEventState	Bieżący stan wydarzenia na żywo. Aby uzyskać więcej informacji, zobacz https://go.microsoft.com/fwlink/?linkid=2139012.
trackStatus	LiveEventTrackStatus[]	Śledzenie listy pozycji.

LiveEventTrackStatus

Stan śledzenia wydarzeń na żywo.

Nazwa	Typ	Opis
expectedBitrate	integer	Oczekiwana szybkość transmisji bitów dla tej ścieżki.
incomingBitrate	integer	Średnia szybkość transmisji bitów przychodzących z ostatnich 20 sekund, gdy wydarzenie na żywo jest uruchomione.
ingestDrift	string	Bieżąca wartość dryfu pozyskiwania w sekundach dla ostatniej 1 minuty.
requestReceived	integer	Łączna liczba odebranych żądań metadanych z upływem czasu.
requestSucceeded	integer	Łączna liczba odebranych żądań metadanych zakończonych powodzeniem.
trackId	string	Śledzenie identyfikatora.

Share via