Compartilhar via

az ams transform

Gerenciar transformações para uma conta dos Serviços de Mídia do Azure.

Comandos

Nome Description Tipo Status
az ams transform create

Crie uma transformação.

 Core GA
az ams transform delete

Excluir uma transformação.

 Core GA
az ams transform list

Liste todas as transformações de uma conta dos Serviços de Mídia do Azure.

 Core GA
az ams transform output

Gerenciar saídas de transformação para uma conta dos Serviços de Mídia do Azure.

 Core GA
az ams transform output add

Adicione uma saída a uma transformação existente.

 Core GA
az ams transform output remove

Remova uma saída de uma transformação existente.

 Core GA
az ams transform show

Mostrar os detalhes de uma transformação.

 Core GA
az ams transform update

Atualize os detalhes de uma transformação.

 Core GA

az ams transform create

Editar

Crie uma transformação.

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]

Exemplos

Crie uma transformação com a predefinição interna AdaptiveStreaming e a alta prioridade relativa.

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

Crie uma transformação com um Codificador Standard personalizado predefinido de um arquivo JSON e baixa prioridade relativa.

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

Parâmetros Exigidos

--account-name -a

O nome da conta dos Serviços de Mídia do Azure.

--name -n

O nome da transformação.

--preset

Predefinição que descreve as operações que serão usadas para modificar, transcodificar ou extrair insights do arquivo de origem para gerar a saída de transformação. Valores permitidos: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Além dos valores permitidos, você também pode passar um caminho para um arquivo JSON predefinido do Codificador Standard personalizado. Consulte https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset para obter mais detalhes sobre as configurações a serem usadas para criar uma predefinição personalizada.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--audio-analysis-mode

Determina o conjunto de operações de análise de áudio a serem executadas. Se não for especificado, o Standard AudioAnalysisMode será escolhido. Valores permitidos: Standard, Basic.

Propriedade Valor
Grupo de parâmetros: Audio/Video Analyzer Arguments
--audio-language

O idioma do conteúdo de áudio na entrada usando o formato BCP-47 de "região de marca de idioma" (por exemplo: en-US). Se não for especificado, a detecção automática de idioma será empregada. Atualmente, esse recurso dá suporte a inglês, chinês, francês, alemão, italiano, japonês, espanhol, russo e português. A detecção automática funciona melhor com gravações de áudio com fala claramente perceptível. Se a detecção automática não encontrar o idioma, a transcrição retornará ao inglês. Valores permitidos: 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.

Propriedade Valor
Grupo de parâmetros: Audio/Video Analyzer Arguments
--blur-type

Valores permitidos: Box, Low, Med, High, Black.

Propriedade Valor
Grupo de parâmetros: Face Detector Arguments
--description

A descrição da transformação.

--face-detector-mode

Esse modo fornece a capacidade de escolher entre as seguintes configurações: 1) Analisar – somente para detecção. Esse modo gera um arquivo JSON de metadados marcando aparências de rostos em todo o vídeo. Sempre que possível, as aparências da mesma pessoa recebem a mesma ID. 2) Combinado - Além disso, redacts(desfoca) rostos detectados. 3) Redact - Isso permite um processo de 2 passões, permitindo a redação seletiva de um subconjunto de rostos detectados. Ele usa o arquivo de metadados de uma passagem de análise anterior, juntamente com o vídeo de origem e um subconjunto selecionado pelo usuário de IDs que exigem redação. Valores permitidos: Analisar, Redact, Combinado.

Propriedade Valor
Grupo de parâmetros: Face Detector Arguments
--insights-to-extract

O tipo de insights a serem extraídos. Se não for definido, o tipo será selecionado com base no tipo de conteúdo. Se o conteúdo for apenas áudio, somente os insights de áudio serão extraídos e, se for vídeo, somente os insights de vídeo serão extraídos.

Propriedade Valor
Grupo de parâmetros: Video Analyzer Arguments
Valores aceitos: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Uma transformação pode definir mais de uma saída. Essa propriedade define o que o serviço deve fazer quando uma saída falha – continue produzindo outras saídas ou interrompa as outras saídas. O estado geral do trabalho não refletirá falhas de saídas especificadas com 'ContinueJob'. O padrão é 'StopProcessingJob'.

Propriedade Valor
Valores aceitos: ContinueJob, StopProcessingJob
--relative-priority

Define a prioridade relativa das saídas de transformação dentro de uma transformação. Isso define a prioridade que o serviço usa para processar TransformOutputs. A prioridade padrão é Normal.

Propriedade Valor
Valores aceitos: High, Low, Normal
--resolution

Especifica a resolução máxima na qual o vídeo é analisado. O comportamento padrão é "SourceResolution", que manterá o vídeo de entrada em sua resolução original quando analisado. O uso de StandardDefinition redimensionará os vídeos de entrada para a definição padrão, preservando a taxa de proporção apropriada. Ele só será redimensionado se o vídeo for de maior resolução. Por exemplo, uma entrada 1920x1080 seria dimensionada para 640x360 antes do processamento. Mudar para "StandardDefinition" reduzirá o tempo necessário para processar vídeo de alta resolução. Também pode reduzir o custo de uso desse componente (consulte https://azure.microsoft.com/pricing/details/media-services/#analytics para obter detalhes). No entanto, rostos que acabam sendo muito pequenos no vídeo redimensionado podem não ser detectados. Valores permitidos: StandardDefinition, SourceResolution.

Propriedade Valor
Grupo de parâmetros: Face Detector Arguments
--video-analysis-mode

Determina o conjunto de operações de análise de áudio a serem executadas. Se não for especificado, o Standard AudioAnalysisMode será escolhido. Valores permitidos: Standard, Basic.

Propriedade Valor
Grupo de parâmetros: Video Analyzer Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ams transform delete

Editar

Excluir uma transformação.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-name -a

O nome da conta dos Serviços de Mídia do Azure.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da transformação.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ams transform list

Editar

Liste todas as transformações de uma conta dos Serviços de Mídia do Azure.

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

Parâmetros Exigidos

--account-name -a

O nome da conta dos Serviços de Mídia do Azure.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--filter

Restringe o conjunto de itens retornados.

--orderby

Especifica a chave pela qual a coleção de resultados deve ser ordenada.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ams transform show

Editar

Mostrar os detalhes de uma transformação.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-name -a

O nome da conta dos Serviços de Mídia do Azure.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da transformação.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az ams transform update

Editar

Atualize os detalhes de uma transformação.

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

Exemplos

Atualize a primeira saída de transformação de uma transformação definindo sua prioridade relativa como Alta.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--account-name -a

O nome da conta dos Serviços de Mídia do Azure.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--description

A descrição da transformação.

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: False
--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

O nome da transformação.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Valor padrão: []
--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False