Udostępnij przez


az ams transform

Zarządzanie przekształceniami dla konta usługi Azure Media Services.

Polecenia

Nazwa Opis Typ Stan
az ams transform create

Utwórz przekształcenie.

Core ogólna dostępność
az ams transform delete

Usuń przekształcenie.

Core ogólna dostępność
az ams transform list

Wyświetl listę wszystkich przekształceń konta usługi Azure Media Services.

Core ogólna dostępność
az ams transform output

Zarządzanie danymi wyjściowymi przekształcania dla konta usługi Azure Media Services.

Core ogólna dostępność
az ams transform output add

Dodaj dane wyjściowe do istniejącego przekształcenia.

Core ogólna dostępność
az ams transform output remove

Usuń dane wyjściowe z istniejącego przekształcenia.

Core ogólna dostępność
az ams transform show

Pokaż szczegóły przekształcenia.

Core ogólna dostępność
az ams transform update

Zaktualizuj szczegóły przekształcenia.

Core ogólna dostępność

az ams transform create

Utwórz przekształcenie.

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]

Przykłady

Utwórz przekształcenie za pomocą wbudowanego ustawienia wstępnego funkcji AdaptiveStreaming i wysokiego priorytetu względnego.

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

Utwórz przekształcenie z niestandardowym ustawieniem wstępnym kodera standardowego z pliku JSON i niskim priorytetem względnym.

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

Parametry wymagane

--account-name -a

Nazwa konta usługi Azure Media Services.

--name -n

Nazwa przekształcenia.

--preset

Ustawienie wstępne opisujące operacje, które będą używane do modyfikowania, transkodowania lub wyodrębniania szczegółowych informacji z pliku źródłowego w celu wygenerowania danych wyjściowych przekształcenia. Dozwolone wartości: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Oprócz dozwolonych wartości można również przekazać ścieżkę do niestandardowego pliku JSON kodera standardowego. Aby uzyskać więcej informacji na temat ustawień używanych do tworzenia niestandardowego ustawienia, zobacz https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--audio-analysis-mode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określony, zostanie wybrany standardowy tryb AudioAnalysisMode. Dozwolone wartości: Standardowa, Podstawowa.

Właściwość Wartość
Grupa parametrów: Audio/Video Analyzer Arguments
--audio-language

Język ładunku audio w danych wejściowych przy użyciu formatu BCP-47 "language tag-region" (np. en-US). Jeśli nie zostanie określony, zostanie zastosowane automatyczne wykrywanie języka. Ta funkcja obsługuje obecnie angielski, chiński, francuski, niemiecki, włoski, japoński, hiszpański, rosyjski i portugalski. Automatyczne wykrywanie działa najlepiej z nagraniami audio z wyraźnie zauważalną mową. Jeśli funkcja automatycznego wykrywania nie znajdzie języka, transkrypcja wróci do języka angielskiego. Dozwolone wartości: 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.

Właściwość Wartość
Grupa parametrów: Audio/Video Analyzer Arguments
--blur-type

Dozwolone wartości: Box, Low, Med, High, Black.

Właściwość Wartość
Grupa parametrów: Face Detector Arguments
--description

Opis przekształcenia.

--face-detector-mode

Ten tryb umożliwia wybór między następującymi ustawieniami: 1) Analizowanie — tylko do wykrywania. Ten tryb generuje metadanych plik JSON z oznaczeniem wyglądów twarzy w całym filmie wideo. Jeśli to możliwe, wygląd tej samej osoby jest przypisany do tego samego identyfikatora. 2) Połączone — dodatkowo zredagowane (rozmycia) wykryte twarze. 3) Redact — umożliwia to proces dwuprzepustowy, co umożliwia selektywne redagowanie podzestawu wykrytych twarzy. Pobiera on plik metadanych z poprzedniego przebiegu analizy wraz ze źródłowym filmem wideo oraz wybranym przez użytkownika podzestawem identyfikatorów, które wymagają ponownej analizy. Dozwolone wartości: Analizuj, Redact, Połączone.

Właściwość Wartość
Grupa parametrów: Face Detector Arguments
--insights-to-extract

Typ szczegółowych informacji do wyodrębnienia. Jeśli nie zostanie ustawiona, typ zostanie wybrany na podstawie typu zawartości. Jeśli zawartość jest tylko audio, zostaną wyodrębnione tylko szczegółowe informacje audio i jeśli jest to tylko szczegółowe informacje wideo zostaną wyodrębnione.

Właściwość Wartość
Grupa parametrów: Video Analyzer Arguments
Dopuszczalne wartości: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Przekształcenie może definiować więcej niż jedno dane wyjściowe. Ta właściwość definiuje, co usługa powinna zrobić, gdy jedno wyjście zakończy się niepowodzeniem — albo nadal generuje inne dane wyjściowe, lub zatrzymaj inne dane wyjściowe. Ogólny stan zadania nie będzie odzwierciedlać błędów danych wyjściowych określonych za pomocą polecenia "ContinueJob". Wartość domyślna to "StopProcessingJob".

Właściwość Wartość
Dopuszczalne wartości: ContinueJob, StopProcessingJob
--relative-priority

Ustawia względny priorytet danych wyjściowych transformacji w ramach przekształcenia. Określa priorytet używany przez usługę do przetwarzania funkcji TransformOutputs. Domyślny priorytet to Normalny.

Właściwość Wartość
Dopuszczalne wartości: High, Low, Normal
--resolution

Określa maksymalną rozdzielczość, w której wideo jest analizowane. Domyślne zachowanie to "SourceResolution", które będzie przechowywać dane wejściowe wideo w oryginalnej rozdzielczości podczas analizowania. Użycie standardDefinition spowoduje zmianę rozmiaru wejściowych filmów wideo na definicję standardową przy zachowaniu odpowiedniego współczynnika proporcji. Zmiana rozmiaru zostanie zmieniona tylko wtedy, gdy wideo będzie mieć wyższą rozdzielczość. Na przykład dane wejściowe 1920x1080 zostaną przeskalowane do 640x360 przed przetworzeniem. Przełączenie na "StandardDefinition" skróci czas przetwarzania wideo o wysokiej rozdzielczości. Może również obniżyć koszty korzystania z tego składnika (zobacz https://azure.microsoft.com/pricing/details/media-services/#analytics, aby uzyskać szczegółowe informacje). Jednak twarze, które w końcu są zbyt małe w zmienionym rozmiarze wideo, mogą nie zostać wykryte. Dozwolone wartości: StandardDefinition, SourceResolution.

Właściwość Wartość
Grupa parametrów: Face Detector Arguments
--video-analysis-mode

Określa zestaw operacji analizy audio do wykonania. Jeśli nie zostanie określony, zostanie wybrany standardowy tryb AudioAnalysisMode. Dozwolone wartości: Standardowa, Podstawowa.

Właściwość Wartość
Grupa parametrów: Video Analyzer Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az ams transform delete

Usuń przekształcenie.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-name -a

Nazwa konta usługi Azure Media Services.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--name -n

Nazwa przekształcenia.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az ams transform list

Wyświetl listę wszystkich przekształceń konta usługi Azure Media Services.

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

Parametry wymagane

--account-name -a

Nazwa konta usługi Azure Media Services.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--filter

Ogranicza zestaw zwracanych elementów.

--orderby

Określa klucz, za pomocą którego ma być uporządkowana kolekcja wyników.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az ams transform show

Pokaż szczegóły przekształcenia.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-name -a

Nazwa konta usługi Azure Media Services.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--name -n

Nazwa przekształcenia.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az ams transform update

Zaktualizuj szczegóły przekształcenia.

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

Przykłady

Zaktualizuj pierwsze dane wyjściowe przekształcenia przekształcenia, ustawiając względny priorytet na Wysoki.

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account-name -a

Nazwa konta usługi Azure Media Services.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--description

Opis przekształcenia.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: False
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--name -n

Nazwa przekształcenia.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False