Live Outputs - Create

リファレンス

サービス:: Media Services

API バージョン:: 2022-11-01

ライブ出力の作成
新しいライブ出力を作成します。

PUT 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	Media Services アカウント名。
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 のバージョン。

要求本文

名前	必須	型	説明
properties.archiveWindowLength	True	string	ISO 8601 の 1 分から 25 時間の間の時間。このライブ出力の資産でアーカイブできる最大コンテンツ長を示します。これにより、巻き戻しウィンドウの最大コンテンツ長も設定されます。たとえば、PT1H30Mを使用して、1 時間 30 分のアーカイブウィンドウを示します。
properties.assetName	True	string	ライブ出力の書き込み対象となる資産。
properties.description		string	ライブ出力の説明。
properties.hls		Hls	ライブ出力のHTTP ライブストリーミング (HLS) パッキング設定。
properties.manifestName		string	マニフェストファイル名。指定しない場合、サービスによって自動的に生成されます。
properties.outputSnapTime		integer	ライブ出力が開始する最初のタイムスタンプ。この値より前のコンテンツはアーカイブされません。
properties.rewindWindowLength		string	ISO 8601 time between 1 minute to the duration of archiveWindowLength to control seek-able window length during Live. LiveOutput が停止すると、サービスはこのプロパティを使用しません。アーカイブされた VOD には、元の ArchiveWindowLength を含む完全なコンテンツが含まれます。たとえば、PT1H30Mを使用して、1 時間 30 分の巻き戻しウィンドウの長さを示します。サービスでは、Live Event で LL が有効な場合にのみ、暗黙的な既定値 30m が使用されます。

応答

名前	型	説明
200 OK	LiveOutput	OK です。要求は成功しました。
201 Created	LiveOutput	作成されました。要求は処理のために受け入れられ、操作は非同期的に完了します。 Azure-AsyncOperation 応答ヘッダーを使用した非同期 Azure 操作の監視の詳細については、「」を参照してください https://go.microsoft.com/fwlink/?linkid=2087017 。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するストリーミングエラー応答。

例

Create a LiveOutput

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-11-01

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


import com.azure.resourcemanager.mediaservices.models.Hls;
import java.time.Duration;

/**
 * Samples for LiveOutputs Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveoutput-
     * create.json
     */
    /**
     * Sample code: Create a LiveOutput.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createALiveOutput(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveOutputs().define("myLiveOutput1")
            .withExistingLiveEvent("mediaresources", "slitestmedia10", "myLiveEvent1")
            .withDescription("test live output 1").withAssetName("6f3264f5-a189-48b4-a29a-a40f22575212")
            .withArchiveWindowLength(Duration.parse("PT5M")).withRewindWindowLength(Duration.parse("PT4M"))
            .withManifestName("testmanifest").withHls(new Hls().withFragmentsPerTsSegment(5)).create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "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"
  }
}

状態コード:: 201

{
  "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	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
Hls	ライブ出力のHTTP ライブストリーミング (HLS) パッキング設定。
LiveOutput	ライブ出力。
LiveOutputResourceState	ライブ出力のリソースの状態。
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

リソースを作成した ID の種類。

名前	型	説明
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	error オブジェクト。

Hls

ライブ出力のHTTP ライブストリーミング (HLS) パッキング設定。

名前	型	説明
fragmentsPerTsSegment	integer	ライブイベントの出力内のHTTP ライブストリーミング (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 ライブストリーミング (HLS) パッキング設定。
properties.lastModified	string	ライブ出力が最後に変更された時刻。
properties.manifestName	string	マニフェストファイル名。指定しない場合、サービスによって自動的に生成されます。
properties.outputSnapTime	integer	ライブ出力が開始する最初のタイムスタンプ。この値より前のコンテンツはアーカイブされません。
properties.provisioningState	string	ライブ出力のプロビジョニング状態。
properties.resourceState	LiveOutputResourceState	ライブ出力のリソースの状態。
properties.rewindWindowLength	string	ISO 8601 time between 1 minute to the duration of archiveWindowLength to control seek-able window length during Live. LiveOutput が停止すると、サービスはこのプロパティを使用しません。アーカイブされた VOD には、元の ArchiveWindowLength を含む完全なコンテンツが含まれます。たとえば、PT1H30Mを使用して、1 時間 30 分の巻き戻しウィンドウの長さを示します。サービスでは、Live Event で 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	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有