Live Events - List Get Status

Reference

Služba:: Media Services

Verze rozhraní API:: 2022-11-01

Získání stavu jedné živé události
Získá telemetrii stavu živé události.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountName	path	True	string	Název účtu služby Media Services.
liveEventName	path	True	string	Název živé události, maximální délka je 32. Vzor regulárního výrazu: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Název skupiny prostředků v rámci předplatného Azure.
subscriptionId	path	True	string	Jedinečný identifikátor předplatného Microsoft Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít s žádostí klienta.

Odpovědi

Name	Typ	Description
200 OK	LiveEventGetStatusResult	OK. Žádost byla úspěšná.
202 Accepted		Přijata. Požadavek byl přijat ke zpracování a operace se dokončí asynchronně. Podrobnosti https://go.microsoft.com/fwlink/?linkid=2087017 najdete v tématu Monitorování asynchronních operací Azure. Hlavičky Location: string Azure-AsyncOperation: string
Other Status Codes		Není změněno. Značka eTag v hlavičce požadavku je stejná jako značka eTag v kontejneru úložiště.
Other Status Codes	ErrorResponse	Odpověď na chybu streamování popisující, proč operace selhala.

Příklady

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

Ukázková odpověď

Stavový kód:: 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
        }
      ]
    }
  ]
}

Stavový kód:: 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

Stavový kód:: 304

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Odpověď na chybu
LiveEventGetStatusResult	Získejte výsledek stavu živé události.
LiveEventHealthStatus	Stav posledních 20 sekund.
LiveEventIngestInterruption	Živá událost ingestuje data přerušení.
LiveEventIngestion	Telemetrická data pro příjem živých událostí.
LiveEventState	Aktuální stav živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventStatus	Stav živé události.
LiveEventTrackStatus	Stav sledování živé události.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě
code	string	Kód chyby
details	ErrorDetail[]	Podrobnosti o chybě
message	string	Chybová zpráva
target	string	Cíl chyby.

ErrorResponse

Odpověď na chybu

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

LiveEventGetStatusResult

Získejte výsledek stavu živé události.

Name	Typ	Description
value	LiveEventStatus[]	Výsledek získání stavu živé události.

LiveEventHealthStatus

Stav posledních 20 sekund.

Name	Typ	Description
Excellent	string	Příchozí přenosová rychlost >= 75 % cílové přenosové rychlosti A žádné upozornění a chyba Ingestu a ABS(IngestDrift) se rovná 0.
Good	string	Příchozí přenosová rychlost >= 20 % A bez ingestování Chyby nebo výjimky upozornění, které zaostávají < za 10 sekund.
Poor	string	Jinak.

LiveEventIngestInterruption

Živá událost ingestuje data přerušení.

Name	Typ	Description
begin	string	Čas UTC přerušení spuštění, kodér byl odpojen.
duration	string	Doba přerušení v čase ISO 8601. Můžete například použít PT1H30M k označení 1 hodiny a 30 minut.
end	string	Čas UTC ukončení přerušení, kodér se znovu připojil.
reason	string	Důvod přerušení.

LiveEventIngestion

Telemetrická data pro příjem živých událostí.

Name	Typ	Description
begin	string	Čas zahájení příjmu dat v UTC.
end	string	Koncový čas příjmu dat v UTC. Prázdné, pokud ještě není zastaveno.
endReason	string	Důvod, proč se příjem dat zastaví Prázdné, pokud ještě není zastaveno. Např. Služba byla zastavena. Bez příjmu dat.
ingestInterruptions	LiveEventIngestInterruption[]	Seznam položek IngestInterruption.
streamName	string	Název streamu příjmu dat.

LiveEventState

Aktuální stav živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012.

Name	Typ	Description
Running	string	Prostředky živé události byly přiděleny, vygenerovaly se adresy URL pro ingestování a náhled a jsou schopné přijímat živé streamy. V tuto chvíli je fakturace aktivní. Pokud chcete zastavit další fakturaci, musíte u prostředku živé události explicitně volat stop.
Stopped	string	Toto je počáteční stav živé události po vytvoření (pokud nebylo automatické spuštění nastaveno na hodnotu true). V tomto stavu nedochází k žádné fakturaci. V tomto stavu je možné aktualizovat vlastnosti živé události, ale streamování není povolené.

LiveEventStatus

Stav živé události.

Name	Typ	Description
healthDescriptions	string[]	Seznam řetězců odůvodňujících stav
healthStatus	LiveEventHealthStatus	Stav posledních 20 sekund.
ingestion	LiveEventIngestion	Položka příjmu živé události.
lastUpdatedTime	string	Čas poslední aktualizace (UTC) tohoto stavu
state	LiveEventState	Aktuální stav živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012.
trackStatus	LiveEventTrackStatus[]	Seznam položek sledování.

LiveEventTrackStatus

Stav sledování živé události.

Name	Typ	Description
expectedBitrate	integer	Očekává se přenosová rychlost pro tuto trasu.
incomingBitrate	integer	Průměrná příchozí přenosová rychlost za posledních 20 sekund, pokud je spuštěná živá událost.
ingestDrift	string	Aktuální hodnota posunu příjmu v sekundách za posledních 1 minutu.
requestReceived	integer	Celkový počet přijatých požadavků na časovaná metadata
requestSucceeded	integer	Celkový počet úspěšných přijatých požadavků na časovaná metadata
trackId	string	ID sledování.

Sdílet prostřednictvím