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

Live Outputs - Get

获取实时输出
获取实时输出。

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

URI 参数

名称 必需 类型 说明
accountName
path True

string

媒体服务帐户名称。

liveEventName
path True

string

直播活动的名称,最大长度为 32。

正则表达式模式: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

liveOutputName
path True

string

实时输出的名称。

正则表达式模式: ^([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

LiveOutput

没问题。 请求已成功。

Other Status Codes

ErrorResponse

描述操作失败原因的流式处理错误响应。

示例

Get a LiveOutput by name

示例请求

GET https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1/liveOutputs/myLiveOutput1?api-version=2022-11-01

示例响应

{
  "name": "myLiveOutput1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/liveoutputs/myLiveOutput1",
  "type": "Microsoft.Media/mediaservices/liveevents/liveoutputs",
  "properties": {
    "description": null,
    "assetName": "cb2ae0bc-677a-4830-9c8e-06ce4c4cb607",
    "archiveWindowLength": "PT5M",
    "manifestName": "fc7096f5-c488-4b86-8302-f3bfde53fc27",
    "outputSnapTime": 0,
    "resourceState": "Running",
    "provisioningState": "Succeeded",
    "created": "0001-01-01T00:00:00-08:00",
    "lastModified": "0001-01-01T00:00:00-08:00",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "0001-01-01T00:00:00-08:00",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "0001-01-01T00:00:00-08:00"
  }
}

定义

名称 说明
createdByType

创建资源的标识类型。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

Hls

HTTP Live Streaming (实时输出的 HLS) 打包设置。

LiveOutput

实时输出。

LiveOutputResourceState

实时输出的资源状态。

systemData

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

createdByType

创建资源的标识类型。

名称 类型 说明
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

Hls

HTTP Live Streaming (实时输出的 HLS) 打包设置。

名称 类型 说明
fragmentsPerTsSegment

integer

HTTP Live Streaming (HLS 中的片段数) 实时事件的输出中的 TS 段数。 此值不会影响 HLS CMAF 输出的打包比率。

LiveOutput

实时输出。

名称 类型 说明
id

string

资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

资源的名称

properties.archiveWindowLength

string

ISO 8601 时间介于 1 分钟到 25 小时之间,以指示可存档到此实时输出的资产中的最大内容长度。 这还会设置倒带窗口的最大内容长度。 例如,使用 PT1H30M 指示 1 小时 30 分钟的存档时段。

properties.assetName

string

实时输出将写入到的资产。

properties.created

string

实时输出的创建时间。

properties.description

string

实时输出的说明。

properties.hls

Hls

HTTP Live Streaming (实时输出的 HLS) 打包设置。

properties.lastModified

string

上次修改实时输出的时间。

properties.manifestName

string

清单文件名。 如果未提供,该服务将自动生成一个。

properties.outputSnapTime

integer

实时输出将开始的初始时间戳,此值之前的任何内容都不会存档。

properties.provisioningState

string

实时输出的预配状态。

properties.resourceState

LiveOutputResourceState

实时输出的资源状态。

properties.rewindWindowLength

string

ISO 8601 时间介于 1 分钟到 archiveWindowLength 的持续时间之间,以在 Live 期间控制可查找窗口长度。 一旦 LiveOutput 停止,服务将不会使用此属性。 存档的 VOD 将包含原始 ArchiveWindowLength 的完整内容。 例如,使用 PT1H30M 指示 1 小时 30 分钟的倒退窗口长度。 仅当实时事件启用 LL 时,服务才会使用隐式默认值 30m。

systemData

systemData

与此资源相关的系统元数据。

type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

LiveOutputResourceState

实时输出的资源状态。

名称 类型 说明
Creating

string

正在创建实时输出。 在实时输出处于运行状态之前,不会在资产中存档任何内容。

Deleting

string

正在删除实时输出。 实时资产正在从实时资产转换为按需资产。 在实时输出资产上创建的任何流式处理 URL 将继续工作。

Running

string

实时输出正在运行,如果有来自贡献编码器的有效输入,则会将实时传送视频流内容存档到资产。

systemData

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

名称 类型 说明
createdAt

string

资源创建时间戳 (UTC) 。

createdBy

string

创建资源的标识。

createdByType

createdByType

创建资源的标识类型。

lastModifiedAt

string

资源上次修改的时间戳 (UTC)

lastModifiedBy

string

上次修改资源的标识。

lastModifiedByType

createdByType

上次修改资源的标识类型。