az ams transform

  • Référence

Gérer les transformations d’un compte Azure Media Services.

Commandes

Nom Description Type État
az ams transform create

Créez une transformation.

 Core GA
az ams transform delete

Supprimez une transformation.

 Core GA
az ams transform list

Répertorier toutes les transformations d’un compte Azure Media Services.

 Core GA
az ams transform output

Gérer les sorties de transformation pour un compte Azure Media Services.

 Core GA
az ams transform output add

Ajoutez une sortie à une transformation existante.

 Core GA
az ams transform output remove

Supprimez une sortie d’une transformation existante.

 Core GA
az ams transform show

Afficher les détails d’une transformation.

 Core GA
az ams transform update

Mettez à jour les détails d’une transformation.

 Core GA

az ams transform create

Modifier

Créez une transformation.

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]

Exemples

Créez une transformation avec la présélection intégrée AdaptiveStreaming et la priorité relative élevée.

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

Créez une transformation avec une présélection Standard Encoder personnalisée à partir d’un fichier JSON et d’une priorité relative faible.

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

Paramètres obligatoires

--account-name -a

Nom du compte Azure Media Services.

--name -n

Nom de la transformation.

--preset

Présélection qui décrit les opérations qui seront utilisées pour modifier, transcoder ou extraire des insights du fichier source pour générer la sortie de la transformation. Valeurs autorisées : H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Outre les valeurs autorisées, vous pouvez également passer un chemin d’accès à un fichier JSON prédéfini Standard Encoder personnalisé. Pour plus d’informations sur les paramètres à utiliser pour générer une présélection personnalisée, consultez https://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset cette rubrique.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--audio-analysis-mode

Détermine l’ensemble des opérations d’analyse audio à effectuer. S’il n’est pas spécifié, le Standard AudioAnalysisMode est choisi. Valeurs autorisées : Standard, De base.

--audio-language

Langue de la charge utile audio dans l’entrée à l’aide du format BCP-47 « language tag-region » (par exemple, en-US). S’il n’est pas spécifié, la détection automatique de la langue est utilisée. Cette fonctionnalité prend actuellement en charge l’anglais, le chinois, le Français, l’allemand, l’italien, le japonais, l’espagnol, le russe et le portugais. La détection automatique fonctionne le mieux avec les enregistrements audio avec une voix clairement discernable. Si la détection automatique ne trouve pas la langue, la transcription revient à l’anglais. Valeurs autorisées : 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

Valeurs autorisées : Box, Low, Med, High, Black.

--description

Description de la transformation.

--face-detector-mode

Ce mode offre la possibilité de choisir entre les paramètres suivants : 1) Analyser - Pour la détection uniquement. Ce mode génère un fichier JSON de métadonnées qui marque les apparences des visages tout au long de la vidéo. Si possible, les apparences de la même personne se voient attribuer le même ID. 2) Combiné - En outre, les visages détectés (flous) ont été détectés. 3) Rédaction : cela permet un processus à 2 passes, ce qui permet une réaction sélective d’un sous-ensemble de visages détectés. Il prend dans le fichier de métadonnées à partir d’une passe d’analyse antérieure, ainsi que la vidéo source et un sous-ensemble sélectionné par l’utilisateur d’ID nécessitant une réaction. Valeurs autorisées : Analyser, React, Combiné.

--insights-to-extract

Type d’insights à extraire. Si ce n’est pas le cas, le type sera sélectionné en fonction du type de contenu. Si le contenu est audio uniquement, seuls les insights audio sont extraits et s’il s’agit uniquement d’insights vidéo seront extraits.

Valeurs acceptées: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Une transformation peut définir plusieurs sorties. Cette propriété définit ce que le service doit faire en cas d’échec d’une sortie : continuez à produire d’autres sorties ou arrêtez les autres sorties. L’état global du travail ne reflète pas les échecs des sorties spécifiées avec « ContinueJob ». La valeur par défaut est « StopProcessingJob ».

Valeurs acceptées: ContinueJob, StopProcessingJob
--relative-priority

Définit la priorité relative des sorties de transformation dans une transformation. Cela définit la priorité utilisée par le service pour le traitement de TransformOutputs. La priorité par défaut est Normal.

Valeurs acceptées: High, Low, Normal
--resolution

Spécifie la résolution maximale à laquelle votre vidéo est analysée. Le comportement par défaut est « SourceResolution », qui conserve la vidéo d’entrée à sa résolution d’origine lors de l’analyse. L’utilisation de StandardDefinition redimensionne les vidéos d’entrée en définition standard tout en conservant le rapport d’aspect approprié. Elle est redimensionnée uniquement si la vidéo est d’une résolution supérieure. Par exemple, une entrée 1920x1080 est mise à l’échelle à 640 x 360 avant le traitement. Le passage à « StandardDefinition » réduit le temps nécessaire pour traiter la vidéo haute résolution. Il peut également réduire le coût d’utilisation de ce composant (voir https://azure.microsoft.com/pricing/details/media-services/#analytics pour plus d’informations). Toutefois, les visages qui finissent par être trop petits dans la vidéo redimensionnée peuvent ne pas être détectés. Valeurs autorisées : StandardDefinition, SourceResolution.

--video-analysis-mode

Détermine l’ensemble des opérations d’analyse audio à effectuer. S’il n’est pas spécifié, le Standard AudioAnalysisMode est choisi. Valeurs autorisées : Standard, De base.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ams transform delete

Modifier

Supprimez une transformation.

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

Paramètres facultatifs

--account-name -a

Nom du compte Azure Media Services.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la transformation.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ams transform list

Modifier

Répertorier toutes les transformations d’un compte Azure Media Services.

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

Paramètres obligatoires

--account-name -a

Nom du compte Azure Media Services.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--filter

Limite l’ensemble des éléments retournés.

--orderby

Spécifie la clé par laquelle la collection de résultats doit être ordonnée.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ams transform show

Modifier

Afficher les détails d’une transformation.

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

Paramètres facultatifs

--account-name -a

Nom du compte Azure Media Services.

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la transformation.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az ams transform update

Modifier

Mettez à jour les détails d’une transformation.

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

Exemples

Mettez à jour la première sortie de transformation d’une transformation en définissant sa priorité relative sur High.

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

Paramètres facultatifs

--account-name -a

Nom du compte Azure Media Services.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Valeur par défaut: []
--description

Description de la transformation.

--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la transformation.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Valeur par défaut: []
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.