Share via

az ams transform

  • リファレンス

Azure Media Services アカウントの変換を管理します。

コマンド

名前 説明 型 Status
az ams transform create

変換を作成します。

 コア GA
az ams transform delete

変換を削除します。

 コア GA
az ams transform list

Azure Media Services アカウントのすべての変換を一覧表示します。

 コア GA
az ams transform output

Azure Media Services アカウントの変換出力を管理します。

 コア GA
az ams transform output add

既存の変換に出力を追加します。

 コア GA
az ams transform output remove

既存の変換から出力を削除します。

 コア GA
az ams transform show

変換の詳細を表示します。

 コア GA
az ams transform update

変換の詳細を更新します。

 コア GA

az ams transform create

編集

変換を作成します。

az ams transform create --account-name
                        --name
                        --preset
                        --resource-group
                        [--audio-analysis-mode]
                        [--audio-language]
                        [--blur-type]
                        [--description]
                        [--face-detector-mode]
                        [--insights-to-extract {AllInsights, AudioInsightsOnly, VideoInsightsOnly}]
                        [--on-error {ContinueJob, StopProcessingJob}]
                        [--relative-priority {High, Low, Normal}]
                        [--resolution]
                        [--video-analysis-mode]

例

AdaptiveStreaming 組み込みのプリセットと高い相対優先度を使用して変換を作成します。

az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset AdaptiveStreaming --relative-priority High

JSON ファイルからカスタム Standard Encoder プリセットと低相対優先度を使用して変換を作成します。

az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset "C:\MyPresets\CustomPreset.json" --relative-priority Low

必須のパラメーター

--account-name -a

Azure Media Services アカウントの名前。

--name -n

変換の名前。

--preset

変換出力を生成するためにソース ファイルから分析情報を変更、トランスコード、または抽出するために使用される操作を記述するプリセット。 使用できる値: H264SingleBitrateSD、H264SingleBitrate720p、H264SingleBitrate1080p、AdaptiveStreaming、AACGoodQualityAudio、ContentAwareEncodingExperimental、ContentAwareEncoding、CopyAllBitrateNonInterleaved、H264MultipleBitrate1080p、 H264MultipleBitrate720p、H264MultipleBitrateSD、H265ContentAwareEncoding、H265AdaptiveStreaming、H265SingleBitrate720p、H265SingleBitrate1080p、H265SingleBitrate4K、AudioAnalyzer、VideoAnalyzer、FaceDetector。 使用できる値に加えて、カスタム Standard Encoder プリセット JSON ファイルへのパスを渡すこともできます。 カスタム プリセットの構築に使用する設定の詳細については、以下を参照してください https://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset 。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--audio-analysis-mode

実行するオーディオ分析操作のセットを決定します。 指定しない場合は、Standard AudioAnalysisMode が選択されます。 使用できる値: Standard、Basic。

--audio-language

BCP-47 形式の "language tag-region" (en-US など) を使用した入力内のオーディオ ペイロードの言語。 指定しない場合は、自動言語検出が使用されます。 この機能は現在、英語、中国語、フランス語、ドイツ語、イタリア語、日本語、スペイン語、ロシア語、ポルトガル語をサポートしています。 自動検出は、明確に識別可能な音声によるオーディオ録音に最適です。 自動検出で言語が見つからない場合、文字起こしは英語にフォールバックします。 使用できる値: en-US、en-GB、es-ES、es-MX、fr-FR、it-IT、ja-JP、pt-BR、zh-CN、de-DE、ar-EG、ru-RU、hi-IN。

--blur-type

使用できる値: Box、Low、Med、High、Black。

--description

変換の説明。

--face-detector-mode

このモードでは、1) 分析 - 検出専用の設定から選択できます。このモードでは、ビデオ全体で顔の外観をマークするメタデータ JSON ファイルが生成されます。可能な場合は、同じ人物の外観に同じ ID が割り当てられます。2) 結合 - 検出された顔をさらに編集 (ぼかし) します。 3)編集 - これにより、2パスプロセスが可能になり、検出された顔のサブセットの選択的な編集が可能になります。メタデータ ファイルは、ソース ビデオと共に、以前の分析パスと、再編集を必要とするユーザーが選択した ID のサブセットを取り込みます。 使用できる値: 分析、編集、結合。

--insights-to-extract

抽出する分析情報の種類。 設定しない場合は、コンテンツ タイプに基づいてタイプが選択されます。 コンテンツがオーディオのみの場合は、オーディオ分析情報のみが抽出され、ビデオの場合はビデオ分析情報のみが抽出されます。

承認された値: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

変換では、複数の出力を定義できます。 このプロパティは、1 つの出力が失敗したときにサービスが実行する必要がある処理を定義します。これは、他の出力の生成を続行するか、他の出力を停止します。 ジョブの全体的な状態には、"ContinueJob" で指定された出力のエラーは反映されません。 既定値は 'StopProcessingJob' です。

承認された値: ContinueJob, StopProcessingJob
--relative-priority

変換内の変換出力の相対的な優先順位を設定します。 これにより、サービスが TransformOutputs の処理に使用する優先順位が設定されます。 既定の優先度は Normal です。

承認された値: High, Low, Normal
--resolution

ビデオを分析する最大解像度を指定します。 既定の動作は "SourceResolution" であり、分析時に入力ビデオが元の解像度で維持されます。 StandardDefinition を使用すると、適切な縦横比を維持しながら、入力ビデオのサイズが標準定義に変更されます。 ビデオの解像度が高い場合にのみサイズが変更されます。 たとえば、1920 x 1080 の入力は、処理の前に 640 x 360 にスケーリングされます。 "StandardDefinition" に切り替えると、高解像度ビデオの処理にかかる時間が短縮されます。 また、このコンポーネントを使用するコストも削減される可能性があります (詳細については、以下を参照してください https://azure.microsoft.com/pricing/details/media-services/#analytics )。 ただし、サイズ変更されたビデオでは、最終的に小さすぎる顔が検出されない場合があります。 使用できる値: StandardDefinition、SourceResolution。

--video-analysis-mode

実行するオーディオ分析操作のセットを決定します。 指定しない場合は、Standard AudioAnalysisMode が選択されます。 使用できる値: Standard、Basic。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ams transform delete

編集

変換を削除します。

az ams transform delete [--account-name]
                        [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

省略可能のパラメーター

--account-name -a

Azure Media Services アカウントの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

変換の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ams transform list

編集

Azure Media Services アカウントのすべての変換を一覧表示します。

az ams transform list --account-name
                      --resource-group
                      [--filter]
                      [--orderby]

必須のパラメーター

--account-name -a

Azure Media Services アカウントの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--filter

返される項目のセットを制限します。

--orderby

結果コレクションを並べ替えるキーを指定します。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ams transform show

編集

変換の詳細を表示します。

az ams transform show [--account-name]
                      [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

省略可能のパラメーター

--account-name -a

Azure Media Services アカウントの名前。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

変換の名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az ams transform update

編集

変換の詳細を更新します。

az ams transform update [--account-name]
                        [--add]
                        [--description]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

例

相対優先度を High に設定して、変換の最初の変換出力を更新します。

az ams transform update -a myAmsAccount -n transformName -g myResourceGroup --set outputs[0].relativePriority=High

省略可能のパラメーター

--account-name -a

Azure Media Services アカウントの名前。

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>。

既定値: []
--description

変換の説明。

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

既定値: False
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

変換の名前。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

既定値: []
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>。

既定値: []
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。