Compartilhar via

az ams transform

  • Referência

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.

 Núcleo GA
az ams transform delete

Excluir uma transformação.

 Núcleo GA
az ams transform list

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

 Núcleo GA
az ams transform output

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

 Núcleo GA
az ams transform output add

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

 Núcleo GA
az ams transform output remove

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

 Núcleo GA
az ams transform show

Mostrar os detalhes de uma transformação.

 Núcleo GA
az ams transform update

Atualize os detalhes de uma transformação.

 Núcleo 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

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

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

--blur-type

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

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

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

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

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.

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.

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

az ams transform delete

Editar

Excluir 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

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

--name -n

O nome da transformação.

--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

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

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

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

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

--name -n

O nome da transformação.

--resource-group -g

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

--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.

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

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

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

--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 padrão: []
--resource-group -g

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 padrão: []
--subscription

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

Parâmetros Globais
--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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.