Live Events - List Get Status

Référence

Service:: Media Services

API Version:: 2022-11-01

Obtenir status d’un événement en direct
Obtient status télémétrie d’un événement en direct.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string	Nom du compte Media Services.
liveEventName	path	True	string	Nom de l’événement en direct, la longueur maximale est 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Nom du groupe de ressources dans l’abonnement Azure.
subscriptionId	path	True	string	Identificateur unique d’un abonnement Microsoft Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande du client.

Réponses

Nom	Type	Description
200 OK	LiveEventGetStatusResult	OK. La demande a réussi.
202 Accepted		Accepté. La demande a été acceptée pour traitement et l’opération se termine de manière asynchrone. Pour plus d’informations sur la surveillance des opérations asynchrones Azure, consultez https://go.microsoft.com/fwlink/?linkid=2087017 . Headers Location: string Azure-AsyncOperation: string
Other Status Codes		Non modifié. L’eTag dans l’en-tête de requête est identique à l’eTag dans le conteneur de stockage.
Other Status Codes	ErrorResponse	Réponse d’erreur de diffusion en continu décrivant la raison de l’échec de l’opération.

Exemples

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

Définitions

Nom	Description
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
LiveEventGetStatusResult	Obtenez le résultat status de l’événement en direct.
LiveEventHealthStatus	Status d’intégrité des 20 dernières secondes.
LiveEventIngestInterruption	L’événement en direct ingère les données d’interruption.
LiveEventIngestion	Données de télémétrie d’ingestion d’événements en direct.
LiveEventState	État actuel de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.
LiveEventStatus	L’événement en direct status.
LiveEventTrackStatus	Le suivi de l’événement en direct status.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d'erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet error.

LiveEventGetStatusResult

Obtenez le résultat status de l’événement en direct.

Nom	Type	Description
value	LiveEventStatus[]	Résultat de l’événement get live status.

LiveEventHealthStatus

Status d’intégrité des 20 dernières secondes.

Nom	Type	Description
Excellent	string	Débit entrant >= 75 % de la vitesse de transmission cible ET absence d’avertissement et d’erreur d’ingestion ET ABS(IngestDrift) est égal à 0.
Good	string	>Débit entrant = 20 % ET aucune erreur d’ingestion ou interruptions d’exception d’avertissement qui écartent < 10 secondes.
Poor	string	Sinon.

LiveEventIngestInterruption

L’événement en direct ingère les données d’interruption.

Nom	Type	Description
begin	string	Heure UTC du début de l’interruption, l’encodeur est déconnecté.
duration	string	Durée de l’interruption dans le temps ISO 8601. Par exemple, utilisez PT1H30M pour indiquer 1 heure et 30 minutes.
end	string	Heure UTC de fin de l’interruption, l’encodeur est re-connecté.
reason	string	Raison de l’interruption.

LiveEventIngestion

Données de télémétrie d’ingestion d’événements en direct.

Nom	Type	Description
begin	string	Heure de début de l’ingestion en UTC.
end	string	Heure de fin de l’ingestion en UTC. Vide s’il n’est pas encore arrêté.
endReason	string	Raison pour laquelle l’ingestion s’arrête. Vide s’il n’est pas encore arrêté. Par exemple, service arrêté. Aucune ingestion.
ingestInterruptions	LiveEventIngestInterruption[]	Liste d’entrées IngestInterruption.
streamName	string	Nom du flux d’ingestion.

LiveEventState

État actuel de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.

Nom	Type	Description
Running	string	Les ressources de l’événement en direct ont été allouées, des URL de réception et d’aperçu ont été générées, et l’événement peut recevoir des flux temps réel. À ce stade, la facturation est active. Vous devez appeler explicitement la commande Stop sur la ressource de l’événement en direct pour arrêter toute facturation supplémentaire.
Stopped	string	C’est l’état initial de l’événement en direct après sa création (sauf si le démarrage automatique a été défini sur true). Aucune facturation ne survient dans cet état. Dans cet état, les propriétés de l’événement en direct peuvent être mises à jour, mais la diffusion en continu n’est pas autorisée.

LiveEventStatus

L’événement en direct status.

Nom	Type	Description
healthDescriptions	string[]	Liste de chaînes justifiant l’intégrité status.
healthStatus	LiveEventHealthStatus	Status d’intégrité des 20 dernières secondes.
ingestion	LiveEventIngestion	Entrée d’ingestion d’événement en direct.
lastUpdatedTime	string	Heure UTC de la dernière mise à jour de cette status.
state	LiveEventState	État actuel de l’événement en direct. Consultez la rubrique https://go.microsoft.com/fwlink/?linkid=2139012 (éventuellement en anglais) pour plus d'informations.
trackStatus	LiveEventTrackStatus[]	Liste d’entrées de suivi.

LiveEventTrackStatus

Le suivi de l’événement en direct status.

Nom	Type	Description
expectedBitrate	integer	Débit binaire attendu pour cette piste.
incomingBitrate	integer	Débit binaire entrant moyen pour les 20 dernières secondes lorsque l’événement en direct est en cours d’exécution.
ingestDrift	string	Valeur de dérive d’ingestion actuelle en secondes pour les 1 dernières minutes.
requestReceived	integer	Nombre total de demandes de métadonnées chrono timed reçues.
requestSucceeded	integer	Nombre total de demandes de métadonnées chrono timed réussies reçues.
trackId	string	ID de suivi.