Live Events - List Get Status

Referentie

Service:: Media Services

API Version:: 2022-11-01

Status van één livegebeurtenis ophalen
Hiermee haalt u de statustelemetrie van een livegebeurtenis op.

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

URI-parameters

Name	In	Vereist	Type	Description
accountName	path	True	string	De naam van het Media Services-account.
liveEventName	path	True	string	De naam van de livegebeurtenis, de maximale lengte is 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	De naam van de resourcegroep binnen het Azure-abonnement.
subscriptionId	path	True	string	De unieke id voor een Microsoft Azure-abonnement.
api-version	query	True	string	De versie van de API die moet worden gebruikt met de clientaanvraag.

Antwoorden

Name	Type	Description
200 OK	LiveEventGetStatusResult	OK. De aanvraag is geslaagd.
202 Accepted		Aanvaard. De aanvraag is geaccepteerd voor verwerking en de bewerking wordt asynchroon voltooid. Zie https://go.microsoft.com/fwlink/?linkid=2087017 voor meer informatie over de bewaking van asynchrone Azure-bewerkingen. Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Niet gewijzigd. De eTag in de aanvraagheader is hetzelfde als de eTag in de opslagcontainer.
Other Status Codes	ErrorResponse	Het streamingfoutantwoord waarin wordt beschreven waarom de bewerking is mislukt.

Voorbeelden

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

Definities

Name	Description
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
LiveEventGetStatusResult	Statusresultaat van livegebeurtenis ophalen.
LiveEventHealthStatus	Status van de laatste 20 seconden.
LiveEventIngestInterruption	De livegebeurtenis neemt onderbrekingsgegevens op.
LiveEventIngestion	De telemetriegegevens voor opname van livegebeurtenissen.
LiveEventState	Huidige status van de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2139012 voor meer informatie.
LiveEventStatus	De status van de livegebeurtenis.
LiveEventTrackStatus	De status van het livegebeurtenistrace.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

LiveEventGetStatusResult

Statusresultaat van livegebeurtenis ophalen.

Name	Type	Description
value	LiveEventStatus[]	Het resultaat van de status van de livegebeurtenis ophalen.

LiveEventHealthStatus

Status van de laatste 20 seconden.

Name	Type	Description
Excellent	string	Binnenkomende bitrate >= 75% van de doelbitsnelheid EN geen ingest-waarschuwing en -fout EN ABS(IngestDrift) is gelijk aan 0.
Good	string	Binnenkomende bitsnelheid >= 20% EN geen opnamefout of waarschuwingsuitzonderingscontinuïteiten die 10 seconden duren < .
Poor	string	Anders.

LiveEventIngestInterruption

De livegebeurtenis neemt onderbrekingsgegevens op.

Name	Type	Description
begin	string	UTC-tijd van het starten van de onderbreking, de verbinding met encoder is verbroken.
duration	string	Duur van de onderbreking in ISO 8601-tijd. Gebruik bijvoorbeeld PT1H30M om 1 uur en 30 minuten aan te geven.
end	string	UTC-tijd van het einde van de onderbreking, encoder opnieuw verbonden.
reason	string	Reden van onderbreking.

LiveEventIngestion

De telemetriegegevens voor opname van livegebeurtenissen.

Name	Type	Description
begin	string	Begintijd van opname in UTC.
end	string	Eindtijd van opname in UTC. Leeg als deze nog niet is gestopt.
endReason	string	Reden waarom de opname stopt. Leeg als deze nog niet is gestopt. Bijvoorbeeld: De service is gestopt. Geen opname.
ingestInterruptions	LiveEventIngestInterruption[]	Vermeldingenlijst voor IngestInterruption.
streamName	string	Naam van opnamestroom.

LiveEventState

Huidige status van de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2139012 voor meer informatie.

Name	Type	Description
Running	string	De resources voor livegebeurtenissen zijn toegewezen, url's voor opnemen en preview zijn gegenereerd en kunnen livestreams ontvangen. Op dit moment is facturering actief. U moet expliciet Stop aanroepen voor de livegebeurtenisresource om verdere facturering te stoppen.
Stopped	string	Dit is de beginstatus van de livegebeurtenis na het maken (tenzij autostart is ingesteld op true.) Er vindt geen facturering plaats in deze status. In deze status kunnen de eigenschappen van de livegebeurtenis worden bijgewerkt, maar is streamen niet toegestaan.

LiveEventStatus

De status van de livegebeurtenis.

Name	Type	Description
healthDescriptions	string[]	Lijst met tekenreeksen die de status rechtvaardigen.
healthStatus	LiveEventHealthStatus	Status van de laatste 20 seconden.
ingestion	LiveEventIngestion	Opnamevermelding van livegebeurtenis.
lastUpdatedTime	string	Laatst bijgewerkt UTC-tijd van deze status.
state	LiveEventState	Huidige status van de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2139012 voor meer informatie.
trackStatus	LiveEventTrackStatus[]	Lijst met vermeldingen bijhouden.

LiveEventTrackStatus

De status van het livegebeurtenistrace.

Name	Type	Description
expectedBitrate	integer	Verwachte bitrate voor dit nummer.
incomingBitrate	integer	Gemiddelde binnenkomende bitrate voor de afgelopen 20 seconden wanneer een livegebeurtenis wordt uitgevoerd.
ingestDrift	string	Huidige waarde voor opnamedrift in seconden voor de afgelopen 1 minuut.
requestReceived	integer	Het totale aantal ontvangen aanvraag voor getimede metagegevens.
requestSucceeded	integer	Het totale aantal geslaagde getimede metagegevensaanvragen die zijn ontvangen.
trackId	string	Traceer-id.

Share via