Compartir a través de

az ams transform

  • Referencia

Administración de transformaciones para una cuenta de Azure Media Services.

Comandos

Nombre Description Tipo Estado
az ams transform create

Cree una transformación.

 Principal GA
az ams transform delete

Elimine una transformación.

 Principal GA
az ams transform list

Enumere todas las transformaciones de una cuenta de Azure Media Services.

 Principal GA
az ams transform output

Administración de salidas de transformación para una cuenta de Azure Media Services.

 Principal GA
az ams transform output add

Agregue una salida a una transformación existente.

 Principal GA
az ams transform output remove

Quite una salida de una transformación existente.

 Principal GA
az ams transform show

Muestra los detalles de una transformación.

 Principal GA
az ams transform update

Actualice los detalles de una transformación.

 Principal GA

az ams transform create

Editar

Cree una transformación.

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]

Ejemplos

Cree una transformación con el valor preestablecido integrado AdaptiveStreaming y prioridad relativa alta.

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

Cree una transformación con un valor preestablecido de Codificador estándar personalizado a partir de un archivo JSON y prioridad relativa baja.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Azure Media Services.

--name -n

Nombre de la transformación.

--preset

Valor preestablecido que describe las operaciones que se usarán para modificar, transcodificar o extraer información del archivo de origen para generar la salida de transformación. Valores permitidos: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Además de los valores permitidos, también puede pasar una ruta de acceso a un archivo JSON preestablecido de Codificador estándar personalizado. Consulte https://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset para obtener más información sobre la configuración que se va a usar para crear un valor preestablecido personalizado.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--audio-analysis-mode

Determina el conjunto de operaciones de análisis de audio que se van a realizar. Si no se especifica, se elegiría Standard AudioAnalysisMode. Valores permitidos: Estándar, Básico.

--audio-language

Idioma de la carga de audio en la entrada mediante el formato BCP-47 de "idioma tag-region" (por ejemplo, en-US). Si no se especifica, se emplearía la detección automática de idioma. Esta característica admite actualmente inglés, chino, francés, alemán, italiano, japonés, español, ruso y portugués. La detección automática funciona mejor con grabaciones de audio con voz claramente reconocible. Si la detección automática no encuentra el idioma, la transcripción se revertiría al 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

Descripción de la transformación.

--face-detector-mode

Este modo proporciona la capacidad de elegir entre las siguientes opciones: 1) Analizar: solo para la detección. Este modo genera un archivo JSON de metadatos que marca las apariencias de las caras en todo el vídeo. Siempre que sea posible, a las apariencias de la misma persona se les asigna el mismo identificador. 2) Combinado: además, se han detectado censuras (desenfoques). 3) Redactar: esto permite un proceso de 2 pasos, lo que permite la reacción selectiva de un subconjunto de caras detectadas. Toma el archivo de metadatos de un paso de análisis anterior, junto con el vídeo de origen, y un subconjunto seleccionado por el usuario de identificadores que requieren reacción. Valores permitidos: Analyze, Redact, Combined.

--insights-to-extract

Tipo de información que se va a extraer. Si no se establece, el tipo se seleccionará en función del tipo de contenido. Si el contenido es solo audio, solo se extraerá información de audio y, si es solo la información de vídeo, se extraerá la información de vídeo.

Valores aceptados: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Una transformación puede definir más de una salida. Esta propiedad define lo que el servicio debe hacer cuando se produce un error en una salida, ya sea para generar otras salidas o para detener las otras salidas. El estado general del trabajo no reflejará los errores de las salidas especificadas con "ContinueJob". El valor predeterminado es "StopProcessingJob".

Valores aceptados: ContinueJob, StopProcessingJob
--relative-priority

Establece la prioridad relativa de las salidas de transformación dentro de una transformación. Esto establece la prioridad que usa el servicio para procesar TransformOutputs. La prioridad predeterminada es Normal.

Valores aceptados: High, Low, Normal
--resolution

Especifica la resolución máxima en la que se analiza el vídeo. El comportamiento predeterminado es "SourceResolution", que mantendrá el vídeo de entrada en su resolución original cuando se analice. El uso de StandardDefinition cambiará el tamaño de los vídeos de entrada a la definición estándar, a la vez que conserva la relación de aspecto adecuada. Solo cambiará el tamaño si el vídeo es de mayor resolución. Por ejemplo, una entrada de 1920x1080 se escalaría a 640x360 antes del procesamiento. Cambiar a "StandardDefinition" reducirá el tiempo necesario para procesar vídeo de alta resolución. También puede reducir el costo de usar este componente (consulte https://azure.microsoft.com/pricing/details/media-services/#analytics para obtener más información). Sin embargo, es posible que las caras que terminan siendo demasiado pequeñas en el vídeo cambiado de tamaño no se detecten. Valores permitidos: StandardDefinition, SourceResolution.

--video-analysis-mode

Determina el conjunto de operaciones de análisis de audio que se van a realizar. Si no se especifica, se elegiría Standard AudioAnalysisMode. Valores permitidos: Estándar, Básico.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ams transform delete

Editar

Elimine una transformación.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta de Azure Media Services.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la transformación.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ams transform list

Editar

Enumere todas las transformaciones de una cuenta de Azure Media Services.

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

Parámetros requeridos

--account-name -a

Nombre de la cuenta de Azure Media Services.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--filter

Restringe el conjunto de elementos devueltos.

--orderby

Especifica la clave por la que se debe ordenar la colección de resultados.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ams transform show

Editar

Muestra los detalles de una transformación.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta de Azure Media Services.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la transformación.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az ams transform update

Editar

Actualice los detalles de una transformación.

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

Ejemplos

Actualice la primera salida de transformación de una transformación estableciendo su prioridad relativa en Alta.

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

Parámetros opcionales

--account-name -a

Nombre de la cuenta de Azure Media Services.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Valor predeterminado: []
--description

Descripción de la transformación.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la transformación.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []
--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.