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

Live Outputs - Create

创建实时输出
创建新的实时输出。

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

URI 参数

Name In Required Type Description
accountName
path True
  • string

媒体服务帐户名称。

liveEventName
path True
  • string

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

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

liveOutputName
path True
  • string

实时输出的名称。

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 版本。

请求正文

Name Required Type Description
properties.archiveWindowLength True
  • string

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

properties.assetName True
  • string

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

properties.description
  • string

实时输出的说明。

properties.hls

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

properties.manifestName
  • string

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

properties.outputSnapTime
  • integer

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

properties.rewindWindowLength
  • string

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

响应

Name Type Description
200 OK

没问题。 请求已成功。

201 Created

Created. 请求已被接受进行处理,并且操作将以异步方式完成。 有关 https://go.microsoft.com/fwlink/?linkid=2087017 使用Azure-AsyncOperation响应标头监视异步 Azure 操作的详细信息,

Other Status Codes

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

示例

Create a LiveOutput

Sample Request

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

{
  "properties": {
    "description": "test live output 1",
    "assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
    "archiveWindowLength": "PT5M",
    "rewindWindowLength": "PT4M",
    "manifestName": "testmanifest",
    "hls": {
      "fragmentsPerTsSegment": 5
    }
  }
}

Sample Response

{
  "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": "test live output 1",
    "assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
    "archiveWindowLength": "PT5M",
    "manifestName": "testmanifest",
    "outputSnapTime": 0,
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:09.9431835Z",
    "lastModified": "2018-03-03T02:25:09.9431835Z",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "2018-03-03T02:25:09.9431835Z",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-03-03T02:25:09.9431835Z"
  }
}
{
  "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": "test live output 1",
    "assetName": "6f3264f5-a189-48b4-a29a-a40f22575212",
    "archiveWindowLength": "PT5M",
    "manifestName": "testmanifest",
    "outputSnapTime": 0,
    "resourceState": "Creating",
    "provisioningState": "InProgress",
    "created": "2018-03-03T02:25:09.9431835Z",
    "lastModified": "2018-03-03T02:25:09.9431835Z",
    "hls": {
      "fragmentsPerTsSegment": 5
    },
    "rewindWindowLength": "PT4M"
  },
  "systemData": {
    "createdBy": "example@microsoft.com",
    "createdByType": "User",
    "createdAt": "2018-03-03T02:25:09.9431835Z",
    "lastModifiedBy": "example@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2018-03-03T02:25:09.9431835Z"
  }
}

定义

createdByType

创建资源的标识的类型。

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

Hls

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

LiveOutput

实时输出。

LiveOutputResourceState

实时输出的资源状态。

systemData

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

createdByType

创建资源的标识的类型。

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

ErrorDetail

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

ErrorResponse

错误响应

Name Type Description
error

错误对象。

Hls

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

Name Type Description
fragmentsPerTsSegment
  • integer

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

LiveOutput

实时输出。

Name Type Description
id
  • string

资源的完全限定的资源 ID。 Ex - /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

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

properties.lastModified
  • string

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

properties.manifestName
  • string

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

properties.outputSnapTime
  • integer

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

properties.provisioningState
  • string

实时输出的预配状态。

properties.resourceState

实时输出的资源状态。

properties.rewindWindowLength
  • string

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

systemData

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

type
  • string

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

LiveOutputResourceState

实时输出的资源状态。

Name Type Description
Creating
  • string

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

Deleting
  • string

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

Running
  • string

实时输出正在运行并将实时流式处理内容存档到资产(如果有来自贡献编码器的有效输入)。

systemData

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

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC) 。

createdBy
  • string

创建资源的标识。

createdByType

创建资源的标识的类型。

lastModifiedAt
  • string

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

lastModifiedBy
  • string

上次修改资源的标识。

lastModifiedByType

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