Live Events - Operation Location

Ссылка

Service:: Media Services

API Version:: 2022-11-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/operationLocations/{operationId}?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])$`
operationId	path	True	string	Идентификатор текущей асинхронной операции.
resourceGroupName	path	True	string	Имя группы ресурсов в подписке Azure.
subscriptionId	path	True	string	Уникальный идентификатор подписки Microsoft Azure.
api-version	query	True	string	Версия API, которая будет использоваться с клиентским запросом.

Ответы

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

Примеры

Get the LiveEvent operation status

GET 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

/** Samples for LiveEvents OperationLocation. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-operation-location.json
     */
    /**
     * Sample code: Get the LiveEvent operation status.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getTheLiveEventOperationStatus(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .operationLocationWithResponse(
                "mediaresources",
                "slitestmedia10",
                "myLiveEvent1",
                "62e4d893-d233-4005-988e-a428d9f77076",
                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:: 202

Status code:: 200

{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {},
  "properties": {
    "description": "",
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:08.3474032Z",
    "lastModified": "2018-03-03T02:25:08.3474032Z",
    "useStaticHostname": false,
    "streamOptions": [
      "Default"
    ],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": null,
      "endpoints": [
        {
          "protocol": "FragmentedMP4",
          "url": "http://clouddeployment.media-test.net/ingest.isml"
        }
      ],
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "763f3ea4-d94f-441c-a634-c833f61a4e04",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": [
        {
          "protocol": "FragmentedMP4",
          "url": "https://testeventopito4idh2r-weibzmedia05.preview-ts051.channel.media-test.windows-int.net/763f3ea4-d94f-441c-a634-c833f61a4e04/preview.ism/manifest"
        }
      ]
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": "<access-policy><cross-domain-access><policy><allow-from http-methods=\"*\"><domain uri=\"http://*\"/></allow-from><grant-to><resource path=\"/\" include-subpaths=\"true\"/></grant-to></policy></cross-domain-access></access-policy>",
      "crossDomainPolicy": "<cross-domain-policy><allow-access-from domain=\"*\" secure=\"false\" /></cross-domain-policy>"
    }
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "2018-03-03T02:25:08.3474032Z",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-03-03T02:25:08.3474032Z"
  }
}

Определения

Имя	Описание
createdByType	Тип удостоверения, создавшего ресурс.
CrossSiteAccessPolicies	Политика клиентского доступа.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
IPAccessControl	Управление доступом по IP-адресу.
IPRange	Диапазон IP-адресов в схеме CIDR.
LiveEvent	Трансляция.
LiveEventEncoding	Указывает тип трансляции и необязательные параметры кодирования для кодирования трансляций.
LiveEventEncodingType	Тип трансляции. Если для encodingType задано значение PassthroughBasic или PassthroughStandard, служба просто проходит через входящие уровни видео и аудио в выходные данные. Если для encodingType задано значение Standard или Premium1080p, динамический кодировщик перекодирует входящий поток на несколько скоростей или слоев. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2095101. Это свойство нельзя изменить после создания трансляции.
LiveEventEndpoint	Конечная точка трансляции.
LiveEventInput	Входные данные трансляции.
LiveEventInputAccessControl	Управление доступом по IP-адресу для ввода трансляции.
LiveEventInputProtocol	Входной протокол для трансляции. Этот параметр указывается во время создания и не может быть обновлен.
LiveEventInputTrackSelection	Условие выбора отслеживания. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.
LiveEventOutputTranscriptionTrack	Описывает дорожку транскрибирования в выходных данных трансляции, созданной с помощью транскрибирования речи в текст. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.
LiveEventPreview	Параметры предварительного просмотра трансляций.
LiveEventPreviewAccessControl	Управление доступом по IP-адресу для конечной точки предварительной версии трансляции.
LiveEventResourceState	Состояние ресурса трансляции. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint	Конечная точка вставки метаданных трансляции.
LiveEventTranscription	Описывает дорожки транскрибирования в выходных данных трансляции, созданные с помощью транскрибирования речи в текст. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.
StreamOptionsFlag	Параметры, используемые для события LiveEvent. Это значение указывается во время создания и не может быть обновлено. Допустимые значения для входных значений массива: Default и LowLatency.
StretchMode	Указывает, как будет изменен размер входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — None
systemData	Метаданные, относящиеся к созданию и последнему изменению ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Имя	Тип	Описание
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Политика клиентского доступа.

Имя	Тип	Описание
clientAccessPolicy	string	Содержимое clientaccesspolicy.xml, используемое Silverlight.
crossDomainPolicy	string	Содержимое crossdomain.xml, используемое Silverlight.

ErrorAdditionalInfo

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

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

ErrorDetail

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

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

ErrorResponse

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

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

IPAccessControl

Управление доступом по IP-адресу.

Имя	Тип	Описание
allow	IPRange[]	Список разрешенных IP-адресов.

IPRange

Диапазон IP-адресов в схеме CIDR.

Имя	Тип	Описание
address	string	IP-адрес.
name	string	Понятное имя диапазона IP-адресов.
subnetPrefixLength	integer	Длина префикса маски подсети (см. нотацию CIDR).

LiveEvent

Трансляция.

Имя	Тип	Описание
id	string	Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса.
properties.created	string	Время создания трансляции
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Политики межустранитового доступа к трансляциям.
properties.description	string	Описание трансляции.
properties.encoding	LiveEventEncoding	Параметры кодирования для трансляции. Он настраивает, используется ли динамический кодировщик для трансляции, и параметры динамического кодировщика, если он используется.
properties.hostnamePrefix	string	Если для параметра useStaticHostname задано значение true, имя узлаPrefix указывает первую часть имени узла, назначенную конечным точкам предварительного просмотра и приема трансляции. Последняя часть имени узла представляет собой сочетание этого префикса, имя учетной записи службы мультимедиа и короткий код для центра обработки данных Службы мультимедиа Azure.
properties.input	LiveEventInput	Параметры ввода трансляций. Он определяет, как трансляция получает входные данные от кодировщика вклада.
properties.lastModified	string	Время последнего изменения трансляции.
properties.preview	LiveEventPreview	Параметры предварительного просмотра трансляций. Предварительная версия позволяет производителям трансляций предварительно просматривать содержимое потоковой трансляции без создания выходных данных в реальном времени.
properties.provisioningState	string	Состояние подготовки трансляции.
properties.resourceState	LiveEventResourceState	Состояние ресурса трансляции. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions	StreamOptionsFlag[]	Параметры, используемые для события LiveEvent. Это значение указывается во время создания и не может быть обновлено. Допустимые значения для входных значений массива: Default и LowLatency.
properties.transcriptions	LiveEventTranscription[]	Параметры динамического транскрибирования для трансляции. Дополнительные сведения о функции транскрибирования в реальном времени см https://go.microsoft.com/fwlink/?linkid=2133742 . в этой статье.
properties.useStaticHostname	boolean	Указывает, будет ли назначено статическое имя узла конечным точкам предварительного просмотра и приема трансляций. Это значение можно обновить только в том случае, если трансляция находится в режиме ожидания
systemData	systemData	Системные метаданные, относящиеся к этому ресурсу.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts.

LiveEventEncoding

Указывает тип трансляции и необязательные параметры кодирования для кодирования трансляций.

Имя	Тип	Описание
encodingType	LiveEventEncodingType	Тип трансляции. Если для encodingType задано значение PassthroughBasic или PassthroughStandard, служба просто проходит через входящие уровни видео и аудио в выходные данные. Если для encodingType задано значение Standard или Premium1080p, динамический кодировщик перекодирует входящий поток на несколько скоростей или слоев. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2095101. Это свойство нельзя изменить после создания трансляции.
keyFrameInterval	string	Используйте значение времени ISO 8601 от 0,5 до 20 секунд, чтобы указать длину выходного фрагмента для видео- и аудиодорожек трансляции кодирования. Например, используйте PT2S, чтобы указать 2 секунды. Для видеодорожки он также определяет интервал ключевого кадра или длину GoP (группы изображений). Если это значение не задано для трансляции кодирования, длительность фрагмента по умолчанию составляет 2 секунды. Невозможно задать значение для сквозных трансляций.
presetName	string	Необязательное имя предустановки кодирования, используемое, если encodingType не имеет значение None. Это значение указывается во время создания и не может быть обновлено. Если для encodingType задано значение Standard, то по умолчанию используется имя предустановки Default720p. Если для encodingType задано значение Premium1080p, предустановка по умолчанию — Default1080p.
stretchMode	StretchMode	Указывает, как будет изменен размер входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — None

LiveEventEncodingType

Тип трансляции. Если для encodingType задано значение PassthroughBasic или PassthroughStandard, служба просто проходит через входящие уровни видео и аудио в выходные данные. Если для encodingType задано значение Standard или Premium1080p, динамический кодировщик перекодирует входящий поток на несколько скоростей или слоев. Подробнее см. в разделе https://go.microsoft.com/fwlink/?linkid=2095101. Это свойство нельзя изменить после создания трансляции.

Имя	Тип	Описание
None	string	Это то же самое, что и PassthroughStandard, см. описание ниже. Это значение перечисления является нерекомендуемой.
PassthroughBasic	string	Полученный поток проходит через трансляцию из кодировщика вкладов без дополнительной обработки. В режиме PassthroughBasic прием ограничен 5 Мбит/с и допускается только 1 одновременный динамический вывод. Динамическое транскрибирование недоступно.
PassthroughStandard	string	Полученный поток проходит через трансляцию из кодировщика вкладов без дополнительной обработки. Доступно динамическое транскрибирование. Ограничения скорости приема гораздо выше, и допускается до 3 одновременных выходных данных в реальном времени.
Premium1080p	string	Динамический кодировщик вкладов отправляет односкоростной поток в трансляцию, а Службы мультимедиа создают несколько потоков скорости. Разрешение выходных данных не может превышать 1080p.
Standard	string	Динамический кодировщик вкладов отправляет односкоростной поток в трансляцию, а Службы мультимедиа создают несколько потоков скорости. Разрешение выходных данных не может превышать 720p.

LiveEventEndpoint

Конечная точка трансляции.

Имя	Тип	Описание
protocol	string	Протокол конечной точки.
url	string	URL-адрес конечной точки.

LiveEventInput

Входные данные трансляции.

Имя	Тип	Описание
accessControl	LiveEventInputAccessControl	Управление доступом для ввода трансляции.
accessToken	string	UUID в строковой форме для уникальной идентификации потока. Его можно указать во время создания, но не может быть обновлено. Если этот параметр опущен, служба создаст уникальное значение.
endpoints	LiveEventEndpoint[]	Входные конечные точки для трансляции.
keyFrameIntervalDuration	string	Длительность интервала ключевого кадра для входных данных в соответствии со стандартом ISO 8601. Это значение задает свойство EXT-X-TARGETDURATION в выходных данных HLS. Например, используйте PT2S, чтобы указать 2 секунды. Оставьте значение пустым для кодирования трансляций.
streamingProtocol	LiveEventInputProtocol	Входной протокол для трансляции. Этот параметр указывается во время создания и не может быть обновлен.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Конечные точки метаданных для трансляции.

LiveEventInputAccessControl

Управление доступом по IP-адресу для ввода трансляции.

Имя	Тип	Описание
ip	IPAccessControl	Свойства управления доступом по IP-адресу.

LiveEventInputProtocol

Входной протокол для трансляции. Этот параметр указывается во время создания и не может быть обновлен.

Имя	Тип	Описание
FragmentedMP4	string	Входные данные Smooth Streaming будут отправляться кодировщиком вкладов в трансляцию.
RTMP	string	Входные данные RTMP будут отправляться кодировщиком вкладов в трансляцию.

LiveEventInputTrackSelection

Условие выбора отслеживания. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.

Имя	Тип	Описание
operation	string	Операция сравнения. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.
property	string	Имя свойства для выбора. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.
value	string	Значение свойства для выбора. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.

LiveEventOutputTranscriptionTrack

Описывает дорожку транскрибирования в выходных данных трансляции, созданной с помощью транскрибирования речи в текст. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.

Имя	Тип	Описание
trackName	string	Имя выходной дорожки. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.

LiveEventPreview

Параметры предварительного просмотра трансляций.

Имя	Тип	Описание
accessControl	LiveEventPreviewAccessControl	Управление доступом для предварительного просмотра трансляции.
alternativeMediaId	string	Альтернативный идентификатор мультимедиа, связанный с указателем потоковой передачи, созданным для предварительной версии. Это значение указывается во время создания и не может быть обновлено. Идентификатор можно использовать в CustomLicenseAcquisitionUrlTemplate или CustomKeyAcquisitionUrlTemplate объекта StreamingPolicy, указанного в поле StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Конечные точки для предварительной версии. Не делитесь URL-адресом предварительного просмотра с аудиторией трансляции.
previewLocator	string	Идентификатор указателя предварительной версии в формате Guid. Если указать это во время создания, вызывающий объект может узнать URL-адрес указателя предварительного просмотра перед созданием события. Если этот параметр опущен, служба создаст случайный идентификатор. Это значение не может быть обновлено после создания трансляции.
streamingPolicyName	string	Имя политики потоковой передачи, используемой для предварительного просмотра трансляции. Это значение указывается во время создания и не может быть обновлено.

LiveEventPreviewAccessControl

Управление доступом по IP-адресу для конечной точки предварительной версии трансляции.

Имя	Тип	Описание
ip	IPAccessControl	Свойства управления доступом по IP-адресу.

LiveEventResourceState

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

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

LiveEventTimedMetadataEndpoint

Конечная точка вставки метаданных трансляции.

Имя	Тип	Описание
url	string	URL-адрес конечной точки метаданных.

LiveEventTranscription

Описывает дорожки транскрибирования в выходных данных трансляции, созданные с помощью транскрибирования речи в текст. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.

Имя	Тип	Описание
inputTrackSelection	LiveEventInputTrackSelection[]	Предоставляет механизм выбора звуковой дорожки во входном динамическом канале, к которому применяется транскрибирование речи в текст. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.
language	string	Указывает язык (языковой стандарт), используемый для транскрибирования речи в текст. Он должен соответствовать разговорному языку в звуковой дорожке. Значение должно быть в формате BCP-47 (например, "en-US"). Дополнительные сведения о функции транскрибирования в реальном времени и список поддерживаемых языков см https://go.microsoft.com/fwlink/?linkid=2133742 . в этой статье.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Описывает дорожку транскрибирования в выходных данных трансляции, созданной с помощью транскрибирования речи в текст. Это свойство зарезервировано для использования в будущем, любые значения, заданные для этого свойства, будут игнорироваться.

StreamOptionsFlag

Параметры, используемые для события LiveEvent. Это значение указывается во время создания и не может быть обновлено. Допустимые значения для входных значений массива: Default и LowLatency.

Имя	Тип	Описание
Default	string	Потоковая трансляция без специальных оптимизаций задержки.
LowLatency	string	Трансляция обеспечивает меньшую сквозную задержку, уменьшая внутренние буферы.
LowLatencyV2	string	Трансляция оптимизирована для сквозной задержки. Этот параметр доступен только для кодирования трансляций с помощью входных данных RTMP. Выходные данные можно передавать в потоковую передачу с помощью форматов HLS или DASH. Длина перемотки архива или DVR выходных данных ограничена 6 часами. Используйте параметр потока LowLatency для всех остальных сценариев.

StretchMode

Указывает, как будет изменен размер входного видео в соответствии с требуемым разрешением вывода. Значение по умолчанию — None

Имя	Тип	Описание
AutoFit	string	Закрепите выходные данные (с помощью почтового ящика или столба) в соответствии с разрешением выходных данных, гарантируя, что активная область видео в выходных данных имеет тот же пропорции, что и входные данные. Например, если входные данные — 1920 x 1080 и предустановка кодирования запрашивает 1280 x 1280, то выходные данные будут иметь размер 1280 x 1280, который содержит внутренний прямоугольник 1280 x 720 с пропорциями 16:9 и области столба шириной 280 пикселей слева и справа.
AutoSize	string	Переопределите разрешение выходных данных и измените его в соответствии с пропорциями отображения входных данных без заполнения. Например, если разрешение исходного видео составляет 1920×1080, а в предустановках кодирования задано 1280×1280, предустановленное значение будет изменено, а разрешение выходного видео составит 1280×720, что соответствует пропорциям входного видео, равным 16:9.
None	string	Строго учитывает разрешение выходных данных, указанное в предустановке кодирования, не учитывая пропорции пикселей или пропорции отображения входного видео.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Удостоверение, которое последним изменял ресурс.
lastModifiedByType	createdByType	Тип удостоверения, которое последним изменял ресурс.