Share via

az ams transform

  • Referência

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

Comandos

Name Description Tipo Estado
az ams transform create

Crie uma transformação.

 Principal GA
az ams transform delete

Exclua uma transformação.

 Principal GA
az ams transform list

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

 Principal GA
az ams transform output

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

 Principal GA
az ams transform output add

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

 Principal GA
az ams transform output remove

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

 Principal GA
az ams transform show

Mostrar os detalhes de uma transformação.

 Principal GA
az ams transform update

Atualize os detalhes de uma transformação.

 Principal 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 integrada do AdaptiveStreaming e Alta prioridade relativa.

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

Crie uma transformação com uma predefinição personalizada do Codificador Padrão a partir 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 Obrigatórios

--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 da 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 Padrão personalizado. Consulte https://docs.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

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

Parâmetros Opcionais

--audio-analysis-mode

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

--audio-language

O idioma da carga útil de áudio na entrada usando o formato BCP-47 de "language tag-region" (por exemplo: en-US). Se não for especificado, a deteção automática de idioma será empregada. Atualmente, esse recurso suporta inglês, chinês, francês, alemão, italiano, japonês, espanhol, russo e português. A deteção automática funciona melhor com gravações de áudio com fala claramente percetível. Se a deteção automática não conseguir encontrar o idioma, a transcrição voltará para o 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.

--blur-type

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

--description

A descrição da transformação.

--face-detector-mode

Este modo fornece a capacidade de escolher entre as seguintes configurações: 1) Analisar - Apenas para deteção. Este modo gera um arquivo JSON de metadados marcando aparências de rostos ao longo do vídeo. Sempre que possível, as aparências da mesma pessoa recebem o mesmo ID. 2) Combinado - Além disso, os rostos detetados são vermelhos (borrões). 3) Redact - Isso permite um processo de 2 passagens, permitindo a redação seletiva de um subconjunto de faces detetadas. Ele recebe o arquivo de metadados de um passo 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.

--insights-to-extract

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

valores aceites: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Uma transformação pode definir mais de uma saída. Esta propriedade define o que o serviço deve fazer quando uma saída falha - continuar a produzir outras saídas ou, parar as outras saídas. O estado geral do trabalho não refletirá falhas de saídas especificadas com 'ContinueJob'. O padrão é 'StopProcessingJob'.

valores aceites: 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.

valores aceites: 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 proporção apropriada. Ele só será redimensionado se o vídeo for de maior resolução. Por exemplo, uma entrada de 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 utilização deste componente (ver https://azure.microsoft.com/pricing/details/media-services/#analytics para mais detalhes). No entanto, rostos que acabam sendo muito pequenos no vídeo redimensionado podem não ser detetados. Valores permitidos: StandardDefinition, SourceResolution.

--video-analysis-mode

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az ams transform delete

Editar

Exclua uma transformação.

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

Parâmetros Opcionais

--account-name -a

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome da transformação.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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 Obrigatórios

--account-name -a

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

--resource-group -g

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

Parâmetros Opcionais

--filter

Restringe o conjunto de itens devolvidos.

--orderby

Especifica a chave pela qual a coleta de resultados deve ser ordenada.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

--account-name -a

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

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome da transformação.

--resource-group -g

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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 saída da primeira 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

--account-name -a

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

--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>.

valor predefinido: []
--description

A descrição da transformação.

--force-string

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

valor predefinido: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--name -n

O nome da transformação.

--remove

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

valor predefinido: []
--resource-group -g

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

--set

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

valor predefinido: []
--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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