Live Events - List Get Status

  • Ссылка
Service:
Media Services
API Version:
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.

Regex pattern: ^[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 .

Headers

  • Location: string
  • Azure-AsyncOperation: string
Other Status Codes

Не изменено. ETag в заголовке запроса совпадает с eTag в контейнере хранилища.
Other Status Codes

ErrorResponse

Ответ об ошибке потоковой передачи, описывающий причину сбоя операции.

Примеры

Get status of a LiveEvent

Sample Request

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

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

Определения

Имя Описание
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

Идентификатор дорожки.