Live Outputs - Get

リファレンス

サービス:: Media Services

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

ライブ出力を取得する
ライブ出力を取得します。

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	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 のバージョン。

応答

名前	型	説明
200 OK	LiveOutput	OK です。要求は成功しました。
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


/**
 * Samples for LiveOutputs Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveoutput-list
     * -by-name.json
     */
    /**
     * Sample code: Get a LiveOutput by name.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getALiveOutputByName(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveOutputs().getWithResponse("mediaresources", "slitestmedia10", "myLiveEvent1", "myLiveOutput1",
            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

応答のサンプル

状態コード:: 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": 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	リソースを作成した 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 分であることを示します。サービスでは、ライブイベントで 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 の種類。

次の方法で共有