你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Live Events - Operation Location

服务:

Media Services

API 版本:

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。 正则表达式模式: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$
operationId	path	True	string	正在进行的异步操作的 ID。
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

示例请求

HTTP

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

Java

/**
 * 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

示例响应

状态代码:

202

状态代码:

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	CIDR 方案中的 IP 地址范围。
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	Silverlight 使用的 clientaccesspolicy.xml 的内容。
crossDomainPolicy	string	Silverlight 使用的 crossdomain.xml 的内容。

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

IPAccessControl

IP 访问控制。

名称	类型	说明
allow	IPRange[]	IP 允许列表。

IPRange

CIDR 方案中的 IP 地址范围。

名称	类型	说明
address	string	IP 地址。
name	string	IP 地址范围的友好名称。
subnetPrefixLength	integer	子网掩码前缀长度 (请参阅 CIDR 表示法) 。

LiveEvent

直播活动。

名称	类型	说明
id	string	资源的完全限定的资源 ID。 例如 - /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 时，hostnamePrefix 指定分配给实时事件预览和引入终结点的主机名的第一部分。 最终主机名将是此前缀、媒体服务帐户名称和 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	使用介于 0.5 到 20 秒之间的 ISO 8601 时间值指定编码实时事件的视频和音频轨道的输出片段长度。 例如，使用 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 模式下，引入限制为高达 5Mbps，并且仅允许 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 持续时间。 此值设置 HLS 输出中的 EXT-X-TARGETDURATION 属性。 例如，使用 PT2S 指示 2 秒。 将值留空，以便对实时事件进行编码。
streamingProtocol	LiveEventInputProtocol	实时事件的输入协议。 这是在创建时指定的，无法更新。
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	实时事件的元数据终结点。

LiveEventInputAccessControl

实时事件输入的 IP 访问控制。

名称	类型	说明
ip	IPAccessControl	IP 访问控制属性。

LiveEventInputProtocol

实时事件的输入协议。 这是在创建时指定的，无法更新。

名称	类型	说明
FragmentedMP4	string	平滑流式处理输入将由贡献编码器发送到实时事件。
RTMP	string	RTMP 输入将由贡献编码器发送到实时事件。

LiveEventInputTrackSelection

曲目选择条件。 此属性保留供将来使用，将忽略此属性上设置的任何值。

名称	类型	说明
operation	string	比较操作。 此属性保留供将来使用，将忽略此属性上设置的任何值。
property	string	要选择的属性名称。 此属性保留供将来使用，将忽略此属性上设置的任何值。
value	string	要选择的属性值。 此属性保留供将来使用，将忽略此属性上设置的任何值。

LiveEventOutputTranscriptionTrack

描述使用语音转文本听录生成的实时事件输出中的听录轨迹。 此属性保留供将来使用，将忽略此属性上设置的任何值。

名称	类型	说明
trackName	string	输出跟踪名称。 此属性保留供将来使用，将忽略此属性上设置的任何值。

LiveEventPreview

直播活动预览设置。

名称	类型	说明
accessControl	LiveEventPreviewAccessControl	实时事件预览的访问控制。
alternativeMediaId	string	与为预览创建的流式处理定位符关联的备用媒体标识符。 此值在创建时指定，无法更新。 标识符可以在 StreamingPolicyName 字段中指定的 StreamingPolicy 的 CustomLicenseAcquisitionUrlTemplate 或 CustomKeyAcquisitionUrlTemplate 中使用。
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，并且能够接收实时传送流。 此时，计费处于活动状态。 必须显式对直播活动资源调用停止操作才能停止进一步计费。
StandBy	string	直播活动资源已预配，已准备好启动。 此状态下将进行计费。 大多数属性仍可进行更新，但在此状态下不允许引入或流式传输。
Starting	string	正在启动直播活动并分配资源。 此状态下不会发生计费。 此状态下不允许进行更新或流式处理。 如果发生错误，则直播活动会返回到“已停止”状态。
Stopped	string	这是直播活动在创建后的初始状态（除非设置了自动启动）此状态下不会发生计费。 在此状态下，可以更新实时事件属性，但不允许进行流式处理。
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	在输出 (上填充写字框或柱框) 以遵循输出分辨率，同时确保输出中的活动视频区域具有与输入相同的纵横比。 例如，如果输入为 1920x1080，编码预设要求为 1280x1280，则输出将为 1280x1280，其中包含一个纵横比为 16：9 的 1280x720 的内部矩形，以及左右两侧宽为 280 像素的柱形框区域。
AutoSize	string	替代输出分辨率，并更改它以匹配输入的显示纵横比，而无需填充。 例如，如果输入为 1920x1080，而编码预设要求提供 1280x1280，则会重写预设中的值，输出将是 1280x720，这样可以保持 16:9 的输入纵横比。
None	string	严格遵循编码预设中指定的输出分辨率，而不考虑输入视频的像素纵横比或显示纵横比。

systemData

与资源的创建和上次修改相关的元数据。

名称	类型	说明
createdAt	string	资源创建时间戳 (UTC) 。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识类型。
lastModifiedAt	string	资源上次修改的时间戳 (UTC)
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识类型。