Live Events - List Get Status

Referens

Service:: Media Services

API Version:: 2022-11-01

Hämta status för en livehändelse
Hämtar statustelemetri för en livehändelse.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Media Services-kontonamnet.
liveEventName	path	True	string	Namnet på livehändelsen, maxlängden är 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Namnet på resursgruppen i Azure-prenumerationen.
subscriptionId	path	True	string	Den unika identifieraren för en Microsoft Azure-prenumeration.
api-version	query	True	string	Den version av API:et som ska användas med klientbegäran.

Svar

Name	Typ	Description
200 OK	LiveEventGetStatusResult	OK. Begäran har slutförts.
202 Accepted		Accepterade. Begäran har accepterats för bearbetning och åtgärden slutförs asynkront. Mer information om övervakning av asynkrona Azure-åtgärder https://go.microsoft.com/fwlink/?linkid=2087017 finns i. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Inte ändrad. ETag i begärandehuvudet är samma som eTag i lagringscontainern.
Other Status Codes	ErrorResponse	Strömningsfelsvaret som beskriver varför åtgärden misslyckades.

Exempel

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

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
LiveEventGetStatusResult	Hämta livehändelsestatusresultat.
LiveEventHealthStatus	Hälsostatus för de senaste 20 sekunderna.
LiveEventIngestInterruption	Livehändelsen matar in avbrottsdata.
LiveEventIngestion	Telemetridata för livehändelseinmatning.
LiveEventState	Aktuellt tillstånd för livehändelsen. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventStatus	Livehändelsens status.
LiveEventTrackStatus	Status för livehändelsespårning.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

LiveEventGetStatusResult

Hämta livehändelsestatusresultat.

Name	Typ	Description
value	LiveEventStatus[]	Resultatet av hämta livehändelsestatus.

LiveEventHealthStatus

Hälsostatus för de senaste 20 sekunderna.

Name	Typ	Description
Excellent	string	Inkommande bithastighet >= 75 % av målbithastigheten OCH ingen inmatningsvarning och fel OCH ABS (IngestDrift) är lika med 0.
Good	string	Inkommande bithastighet >= 20 % OCH ingen inmatning Avbrutna fel eller varningsfel som luckor < i 10 sekunder.
Poor	string	Annars.

LiveEventIngestInterruption

Livehändelsen matar in avbrottsdata.

Name	Typ	Description
begin	string	UTC-tid för avbrottsstart, kodare frånkopplad.
duration	string	Varaktighet för avbrott i ISO 8601-tid. Använd till exempel PT1H30M för att ange 1 timme och 30 minuter.
end	string	UTC-tid för avbrottsslut, kodare återansluten.
reason	string	Avbrottsorsak.

LiveEventIngestion

Telemetridata för livehändelseinmatning.

Name	Typ	Description
begin	string	Inmatningen börjar i UTC.
end	string	Sluttid för inmatning i UTC. Tom om den inte har stoppats än.
endReason	string	Orsak till varför inmatningen stoppas. Tom om den inte har stoppats än. T.ex. stoppades tjänsten. Ingen inmatning.
ingestInterruptions	LiveEventIngestInterruption[]	IngestInterruption-postlista.
streamName	string	Inmatningsströmnamn.

LiveEventState

Aktuellt tillstånd för livehändelsen. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2139012.

Name	Typ	Description
Running	string	Livehändelseresurserna har allokerats, inmatnings- och förhandsversions-URL:er har genererats och de kan ta emot liveströmmar. Nu är faktureringen aktiv. Du måste uttryckligen anropa Stoppa på livehändelseresursen för att stoppa ytterligare fakturering.
Stopped	string	Det här är det första tillståndet för livehändelsen efter skapandet (såvida inte autostarten har angetts till true.) Ingen fakturering sker i det här tillståndet. I det här tillståndet kan livehändelseegenskaperna uppdateras, men strömning tillåts inte.

LiveEventStatus

Livehändelsens status.

Name	Typ	Description
healthDescriptions	string[]	Lista över strängar som motiverar hälsostatusen.
healthStatus	LiveEventHealthStatus	Hälsostatus för de senaste 20 sekunderna.
ingestion	LiveEventIngestion	Inmatningspost för livehändelse.
lastUpdatedTime	string	Senast uppdaterad UTC-tid för den här statusen.
state	LiveEventState	Aktuellt tillstånd för livehändelsen. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2139012.
trackStatus	LiveEventTrackStatus[]	Spåra postlista.

LiveEventTrackStatus

Status för livehändelsespårning.

Name	Typ	Description
expectedBitrate	integer	Förväntad bithastighet för det här spåret.
incomingBitrate	integer	Genomsnittlig inkommande bithastighet för de senaste 20 sekunderna när livehändelsen körs.
ingestDrift	string	Aktuellt inmatningsavvikelsevärde i sekunder under de senaste 1 minuterna.
requestReceived	integer	Totalt antal mottagna tidsindelade metadatabegäran.
requestSucceeded	integer	Totalt antal lyckade mottagna tidsindelade metadatabegäran.
trackId	string	Spåra ID.

Dela via