Dela via

az ams transform

  • Referens

Hantera transformeringar för ett Azure Media Services-konto.

Kommandon

Name Description Typ Status
az ams transform create

Skapa en transformering.

 Kärna GA
az ams transform delete

Ta bort en transformering.

 Kärna GA
az ams transform list

Visa en lista över alla transformeringar av ett Azure Media Services-konto.

 Kärna GA
az ams transform output

Hantera transformeringsutdata för ett Azure Media Services-konto.

 Kärna GA
az ams transform output add

Lägg till utdata i en befintlig transformering.

 Kärna GA
az ams transform output remove

Ta bort utdata från en befintlig transformering.

 Kärna GA
az ams transform show

Visa information om en transformering.

 Kärna GA
az ams transform update

Uppdatera information om en transformering.

 Kärna GA

az ams transform create

Redigera

Skapa en transformering.

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]

Exempel

Skapa en transformering med den inbyggda förinställningen AdaptiveStreaming och hög relativ prioritet.

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

Skapa en transformering med en anpassad standardkodarförinställning från en JSON-fil och låg relativ prioritet.

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

Obligatoriska parametrar

--account-name -a

Namnet på Azure Media Services-kontot.

--name -n

Namnet på transformen.

--preset

Förinställning som beskriver de åtgärder som ska användas för att ändra, omkoda eller extrahera insikter från källfilen för att generera transformeringsutdata. Tillåtna värden: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Förutom de tillåtna värdena kan du även skicka en sökväg till en anpassad standardkodares förinställda JSON-fil. Mer information om de inställningar som ska användas för att skapa en anpassad förinställning finns i https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--audio-analysis-mode

Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det är ospecificerat väljs Standard AudioAnalysisMode. Tillåtna värden: Standard, Basic.

--audio-language

Språket för ljudnyttolasten i indata med BCP-47-formatet för "language tag-region" (t.ex. en-US). Om det inte anges används automatisk språkidentifiering. Den här funktionen stöder för närvarande engelska, kinesiska, franska, tyska, italienska, japanska, spanska, ryska och portugisiska. Den automatiska identifieringen fungerar bäst med ljudinspelningar med tydligt urskiljbart tal. Om automatisk identifiering inte hittar språket, skulle transkriptionen återgå till engelska. Tillåtna värden: 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

Tillåtna värden: Box, Low, Med, High, Black.

--description

Beskrivningen av transformering.

--face-detector-mode

Det här läget ger möjlighet att välja mellan följande inställningar: 1) Analysera – endast för identifiering. Det här läget genererar en metadata-JSON-fil som markerar ansikten i hela videon. När det är möjligt tilldelas samma persons utseende samma ID. 2) Kombinerat – Dessutom redigerar (suddar) identifierade ansikten. 3) Redact – Detta möjliggör en 2-pass-process, vilket möjliggör selektiv redigering av en delmängd av identifierade ansikten. Den tar in metadatafilen från ett tidigare analyspass, tillsammans med källvideon, och en användarvald delmängd av ID:t som kräver redigering. Tillåtna värden: Analysera, Redigera, Kombinerad.

--insights-to-extract

Vilken typ av insikter som ska extraheras. Om den inte anges väljs typen baserat på innehållstypen. Om innehållet bara är ljud extraheras endast ljudinsikter och om det bara är videoinsikter extraheras.

Godkända värden: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

En transformering kan definiera fler än en utdata. Den här egenskapen definierar vad tjänsten ska göra när ett utdata misslyckas – antingen fortsätter du att producera andra utdata eller stoppar de andra utdata. Det övergripande jobbtillståndet återspeglar inte fel i utdata som har angetts med "ContinueJob". Standardvärdet är "StopProcessingJob".

Godkända värden: ContinueJob, StopProcessingJob
--relative-priority

Anger den relativa prioriteten för transformeringsutdata i en transformering. Detta anger den prioritet som tjänsten använder för bearbetning av TransformOutputs. Standardprioriteten är Normal.

Godkända värden: High, Low, Normal
--resolution

Anger den maximala upplösning som videon analyseras med. Standardbeteendet är "SourceResolution", som håller indatavideon på sin ursprungliga upplösning när den analyseras. Med StandardDefinition ändrar du storlek på indatavideor till standarddefinitionen samtidigt som lämpligt proportioner bevaras. Den ändrar bara storlek om videon har högre upplösning. Till exempel skulle en indata på 1920x1080 skalas till 640x360 före bearbetning. Om du byter till "StandardDefinition" minskar den tid det tar att bearbeta video med hög upplösning. Det kan också minska kostnaden för att använda den här komponenten (se https://azure.microsoft.com/pricing/details/media-services/#analytics för mer information). Ansikten som blir för små i videon med storleksändras kanske inte identifieras. Tillåtna värden: StandardDefinition, SourceResolution.

--video-analysis-mode

Avgör vilken uppsättning ljudanalysåtgärder som ska utföras. Om det är ospecificerat väljs Standard AudioAnalysisMode. Tillåtna värden: Standard, Basic.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ams transform delete

Redigera

Ta bort en transformering.

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

Valfria parametrar

--account-name -a

Namnet på Azure Media Services-kontot.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på transformen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ams transform list

Redigera

Visa en lista över alla transformeringar av ett Azure Media Services-konto.

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

Obligatoriska parametrar

--account-name -a

Namnet på Azure Media Services-kontot.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--filter

Begränsar den uppsättning objekt som returneras.

--orderby

Anger den nyckel som resultatsamlingen ska sorteras efter.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ams transform show

Redigera

Visa information om en transformering.

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

Valfria parametrar

--account-name -a

Namnet på Azure Media Services-kontot.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på transformen.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ams transform update

Redigera

Uppdatera information om en transformering.

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

Exempel

Uppdatera den första transformeringsutdatan för en transformering genom att ange dess relativa prioritet till Hög.

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

Valfria parametrar

--account-name -a

Namnet på Azure Media Services-kontot.

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Standardvärde: []
--description

Beskrivningen av transformering.

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Standardvärde: False
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--name -n

Namnet på transformen.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Standardvärde: []
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Standardvärde: []
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.