Partilhar via

az ams transform

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

Comandos

Name Description Tipo Status
az ams transform create

Crie uma transformação.

 Core disponibilidade geral
az ams transform delete

Exclua uma transformação.

 Core disponibilidade geral
az ams transform list

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

 Core disponibilidade geral
az ams transform output

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

 Core disponibilidade geral
az ams transform output add

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

 Core disponibilidade geral
az ams transform output remove

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

 Core disponibilidade geral
az ams transform show

Mostrar os detalhes de uma transformação.

 Core disponibilidade geral
az ams transform update

Atualize os detalhes de uma transformação.

 Core disponibilidade geral

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://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 tornar-se necessários para que o comando seja executado com êxito.

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

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

O idioma para a 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.

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

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.

Propriedade Valor
Grupo de parâmetros: Face Detector Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Video Analyzer Arguments
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'.

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

Propriedade Valor
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 (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 detetados. 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 AudioAnalysisMode padrão será escolhido. Valores permitidos: Padrão, Básico.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az ams transform delete

Editar

Exclua 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 tornar-se necessários para que o comando seja executado com êxito.

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

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

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 subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 Obrigatórios

--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 tornar-se necessários para que o comando seja executado com êxito.

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: 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 tornar-se necessários para que o comando seja executado com êxito.

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

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

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 subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: 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 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--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
Default value: []
--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.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: False
--ids

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

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> OU --remove propertyToRemove.

Propriedade Valor
Grupo de parâmetros: Generic Update Arguments
Default value: []
--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
Default value: []
--subscription

Nome ou ID da subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False