Live Events - List Get Status

Ссылка

Служба:: Media Services

Версия API:: 2022-11-01

Получение состояния одного трансляции
Возвращает данные телеметрии состояния трансляции.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string	Имя учетной записи Служб мультимедиа.
liveEventName	path	True	string	Имя трансляции, максимальная длина — 32. Шаблон регулярного выражения: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure.
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure.
api-version	query	True	string	Версия API, используемая с клиентским запросом.

Ответы

Имя	Тип	Описание
200 OK	LiveEventGetStatusResult	Все в порядке. Запрос выполнен успешно.
202 Accepted		Принято. Запрос принят для обработки, и операция будет выполнена асинхронно. Дополнительные сведения о мониторинге асинхронных операций Azure см. в этой статье https://go.microsoft.com/fwlink/?linkid=2087017 . Заголовки Location: string Azure-AsyncOperation: string
Other Status Codes		Не изменено. ETag в заголовке запроса совпадает с eTag в контейнере хранилища.
Other Status Codes	ErrorResponse	Ответ об ошибке потоковой передачи, описывающий причину сбоя операции.

Примеры

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

Пример ответа

Код состояния:: 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
        }
      ]
    }
  ]
}

Код состояния:: 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

Код состояния:: 304

Определения

Имя	Описание
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
LiveEventGetStatusResult	Получение результата состояния трансляции.
LiveEventHealthStatus	Состояние работоспособности за последние 20 секунд.
LiveEventIngestInterruption	Данные прерывания приема трансляции.
LiveEventIngestion	Данные телеметрии приема трансляций.
LiveEventState	Текущее состояние трансляции. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventStatus	Состояние трансляции.
LiveEventTrackStatus	Состояние отслеживания трансляции событий.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

LiveEventGetStatusResult

Получение результата состояния трансляции.

Имя	Тип	Описание
value	LiveEventStatus[]	Результат получения состояния трансляции.

LiveEventHealthStatus

Состояние работоспособности за последние 20 секунд.

Имя	Тип	Описание
Excellent	string	Входящий битрейт >= 75 % от целевой скорости И отсутствие предупреждения о приеме и ошибки И ABS(IngestDrift) равно 0.
Good	string	>Скорость входящего трафика = 20 % И без ошибок приема или предупреждений о несоответствии исключений, разрыв которых составляет < 10 секунд.
Poor	string	Иначе.

LiveEventIngestInterruption

Данные прерывания приема трансляции.

Имя	Тип	Описание
begin	string	Время начала прерывания в формате UTC, кодировщик отключен.
duration	string	Продолжительность прерывания по стандарту ISO 8601. Например, используйте PT1H30M, чтобы указать 1 час и 30 минут.
end	string	Время окончания прерывания в формате UTC, повторное подключение кодировщика.
reason	string	Причина прерывания.

LiveEventIngestion

Данные телеметрии приема трансляций.

Имя	Тип	Описание
begin	string	Время начала приема в формате UTC.
end	string	Время окончания приема в формате UTC. Пусто, если он еще не остановлен.
endReason	string	Причина остановки приема. Пусто, если он еще не остановлен. Например, служба остановлена. Нет приема.
ingestInterruptions	LiveEventIngestInterruption[]	Список записей IngestInterruption.
streamName	string	Имя потока приема.

LiveEventState

Текущее состояние трансляции. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2139012.

Имя	Тип	Описание
Running	string	Ресурсы для трансляции успешно выделены, URL-адреса приема и предварительного просмотра созданы, все готово к получению прямых трансляций. На этом этапе начисление оплаты активно. Чтобы остановить начисление платы, нужно явно вызвать функцию Stop (Остановить) для ресурса трансляции.
Stopped	string	Это начальное состояние трансляции после ее создания, если не было указано значение true для параметра autostart. В этом состоянии плата не начисляется. В этом состоянии свойства трансляции можно обновить, но потоковая передача запрещена.

LiveEventStatus

Состояние трансляции.

Имя	Тип	Описание
healthDescriptions	string[]	Список строк, оправдывающих состояние работоспособности.
healthStatus	LiveEventHealthStatus	Состояние работоспособности за последние 20 секунд.
ingestion	LiveEventIngestion	Запись приема трансляции.
lastUpdatedTime	string	Последнее обновление времени в формате UTC этого состояния.
state	LiveEventState	Текущее состояние трансляции. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2139012.
trackStatus	LiveEventTrackStatus[]	Список записей отслеживания.

LiveEventTrackStatus

Состояние отслеживания трансляции событий.

Имя	Тип	Описание
expectedBitrate	integer	Ожидаемая скорость для этой дорожки.
incomingBitrate	integer	Средняя скорость входящего трафика за последние 20 секунд при выполнении трансляции.
ingestDrift	string	Текущее значение смещения приема в секундах за последние 1 минуту.
requestReceived	integer	Общее количество полученных запросов метаданных с повременным временем.
requestSucceeded	integer	Общее количество успешных запросов метаданных, полученных по времени.
trackId	string	Идентификатор дорожки.

Поделиться через