Sdílet prostřednictvím


az ams transform

Správa transformací pro účet Azure Media Services

Příkazy

Name Description Typ Stav
az ams transform create

Vytvořte transformaci.

Core GA
az ams transform delete

Odstranění transformace

Core GA
az ams transform list

Zobrazí seznam všech transformací účtu Azure Media Services.

Core GA
az ams transform output

Umožňuje spravovat výstupy transformace pro účet Azure Media Services.

Core GA
az ams transform output add

Přidejte výstup do existující transformace.

Core GA
az ams transform output remove

Odeberte výstup z existující transformace.

Core GA
az ams transform show

Zobrazí podrobnosti transformace.

Core GA
az ams transform update

Aktualizujte podrobnosti transformace.

Core GA

az ams transform create

Vytvořte transformaci.

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]

Příklady

Vytvořte transformaci s integrovanou předvolbou AdaptiveStreaming a vysokou relativní prioritou.

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

Vytvořte transformaci s vlastní předvolbou standardního kodéru ze souboru JSON a nízkou relativní prioritou.

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

Povinné parametry

--account-name -a

Název účtu Azure Media Services.

--name -n

Název transformace.

--preset

Přednastavení, které popisuje operace, které se použijí k úpravě, transkódování nebo extrahování přehledů ze zdrojového souboru za účelem vygenerování výstupu transformace. Povolené hodnoty: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Kroměpovolených Další podrobnosti o nastaveních, která se mají použít k vytvoření vlastní předvolby, najdete v https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--audio-analysis-mode

Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadána hodnota Standard AudioAnalysisMode, zvolí se. Povolené hodnoty: Standard, Basic.

Vlastnost Hodnota
Skupina parametrů: Audio/Video Analyzer Arguments
--audio-language

Jazyk datové části zvuku ve vstupu pomocí formátu BCP-47 "language tag-region" (např. en-US). Pokud není zadáno, použije se automatické rozpoznávání jazyka. Tato funkce v současné době podporuje angličtinu, čínštinu, francouzštinu, němčinu, italštinu, japonštinu, španělštinu, ruštinu a portugalštinu. Automatické rozpoznávání funguje nejlépe se zvukovými nahrávkami s jasně rozpoznatelnou řečí. Pokud se automatické zjišťování nepodaří najít jazyk, přepis se vrátí do angličtiny. Povolené hodnoty: 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.

Vlastnost Hodnota
Skupina parametrů: Audio/Video Analyzer Arguments
--blur-type

Povolené hodnoty: Box, Low, Med, High, Black.

Vlastnost Hodnota
Skupina parametrů: Face Detector Arguments
--description

Popis transformace.

--face-detector-mode

Tento režim umožňuje zvolit mezi následujícími nastaveními: 1) Analyzovat – pouze pro detekci. Tento režim vygeneruje vzhledy tváří ve videu v souboru JSON s metadaty. Tam, kde je to možné, jsou vzhledy stejné osoby přiřazeny stejnému ID. 2) Sloučené – dále redakce (rozostření) rozpoznaných tváří. 3) Redact - To umožňuje proces 2 průchodu, což umožňuje selektivní redakci podmnožinu detekovaných tváří. Vezme soubor metadat z předchozího předání analýzy spolu se zdrojovým videem a uživatelsky vybranou podmnožinou ID, která vyžadují redakci. Povolené hodnoty: Analyzovat, Redact, Combined.

Vlastnost Hodnota
Skupina parametrů: Face Detector Arguments
--insights-to-extract

Typ přehledů, který se má extrahovat. Pokud není nastavená, bude typ vybrán na základě typu obsahu. Pokud je obsah jenom zvuk, budou extrahovány pouze zvukové přehledy a pokud se jedná o video pouze přehledy videa, budou extrahovány.

Vlastnost Hodnota
Skupina parametrů: Video Analyzer Arguments
Přípustné hodnoty: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Transformace může definovat více než jeden výstup. Tato vlastnost definuje, co má služba dělat, když jeden výstup selže – buď pokračovat v vytváření dalších výstupů, nebo zastavit ostatní výstupy. Celkový stav úlohy nebude odrážet selhání výstupů zadaných funkcí ContinueJob. Výchozí hodnota je StopProcessingJob.

Vlastnost Hodnota
Přípustné hodnoty: ContinueJob, StopProcessingJob
--relative-priority

Nastaví relativní prioritu výstupů transformace v rámci transformace. Tím se nastaví priorita, kterou služba používá ke zpracování transformoutputů. Výchozí priorita je Normální.

Vlastnost Hodnota
Přípustné hodnoty: High, Low, Normal
--resolution

Určuje maximální rozlišení, při kterém se video analyzuje. Výchozí chování je SourceResolution, které při analýze zachová vstupní video při původním rozlišení. Použití StandardDefinition změní velikost vstupních videí na standardní definici a zachová odpovídající poměr stran. Velikost se změní jenom v případě, že video má vyšší rozlišení. Například vstup 1920x1080 se před zpracováním škáluje na 640x360. Přepnutím na StandardDefinition snížíte dobu potřebnou ke zpracování videa s vysokým rozlišením. Může také snížit náklady na používání této komponenty (podrobnosti najdete v https://azure.microsoft.com/pricing/details/media-services/#analytics). Tváře, které jsou ale ve změně velikosti videa příliš malé, ale nemusí být zjištěny. Povolené hodnoty: StandardDefinition, SourceResolution.

Vlastnost Hodnota
Skupina parametrů: Face Detector Arguments
--video-analysis-mode

Určuje sadu operací analýzy zvuku, které se mají provést. Pokud není zadána hodnota Standard AudioAnalysisMode, zvolí se. Povolené hodnoty: Standard, Basic.

Vlastnost Hodnota
Skupina parametrů: Video Analyzer Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az ams transform delete

Odstranění transformace

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-name -a

Název účtu Azure Media Services.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--name -n

Název transformace.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az ams transform list

Zobrazí seznam všech transformací účtu Azure Media Services.

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

Povinné parametry

--account-name -a

Název účtu Azure Media Services.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--filter

Omezuje sadu vrácených položek.

--orderby

Určuje klíč, podle kterého má být kolekce výsledků seřazena.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az ams transform show

Zobrazí podrobnosti transformace.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-name -a

Název účtu Azure Media Services.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--name -n

Název transformace.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az ams transform update

Aktualizujte podrobnosti transformace.

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

Příklady

Aktualizujte první výstup transformace nastavením jeho relativní priority na hodnotu Vysoká.

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

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--account-name -a

Název účtu Azure Media Services.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
Default value: []
--description

Popis transformace.

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
Default value: False
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--name -n

Název transformace.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
Default value: []
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
Default value: []
--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False