az batch task

  • Référence

Gérer les tâches Batch.

Commandes

Nom Description Type État
az batch task create

Créez des tâches Batch.

 Core GA
az batch task delete

Supprime une tâche du travail spécifié.

 Core GA
az batch task file

Gérer les fichiers de tâches Batch.

 Core GA
az batch task file delete

Supprime le fichier de tâche spécifié du nœud de calcul où la tâche a été exécutée.

 Core GA
az batch task file download

Téléchargez le contenu d’un fichier de tâches Batch.

 Core GA
az batch task file list

Répertorie les fichiers dans le répertoire d’une tâche sur son nœud de calcul.

 Core GA
az batch task file show

Obtient les propriétés du fichier de tâche spécifié.

 Core GA
az batch task list

Répertorie toutes les tâches associées au travail spécifié.

 Core GA
az batch task reactivate

Réactive une tâche, ce qui lui permet de s’exécuter à nouveau même si son nombre de nouvelles tentatives a été épuisé.

 Core GA
az batch task reset

Réinitialisez les propriétés d’une tâche Batch.

 Core GA
az batch task show

Obtient des informations sur la tâche spécifiée.

 Core GA
az batch task stop

Termine la tâche spécifiée.

 Core GA
az batch task subtask

Gérer les informations de sous-tâche d’une tâche Batch.

 Core GA
az batch task subtask list

Répertorie toutes les tâches subordonnées associées à la tâche multi-instance spécifiée.

 Core GA

az batch task create

Modifier

Créez des tâches Batch.

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--task-id]

Paramètres obligatoires

--job-id

ID du travail contenant la tâche.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--affinity-id

Obligatoire. Vous pouvez transmettre l’affinityId d’un nœud pour indiquer que cette tâche doit s’exécuter sur ce nœud de calcul. Notez qu’il s’agit simplement d’une affinité douce. Si le nœud de calcul cible est occupé ou indisponible au moment où la tâche est planifiée, la tâche est planifiée ailleurs.

--application-package-references

Liste d’ID séparés par l’espace spécifiant les packages d’application à installer. ID d’application séparés par espace avec version facultative au format « id[#version] ».

--command-line

La ligne de commande de la tâche. La ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes telles que l’extension de variable d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux.

--environment-settings

Liste des paramètres de variable d’environnement pour la tâche. Valeurs séparées par l’espace au format « key=value ».

--json-file

Fichier contenant la ou les tâches à créer dans JSON(mis en forme pour correspondre au corps de la requête de l’API REST). Lors de l’envoi de plusieurs tâches, accepte un tableau de tâches ou un TaskAddCollectionParamater. Si ce paramètre est spécifié, tous les autres paramètres sont ignorés.

--max-task-retry-count

Nombre maximal de nouvelles tentatives de la tâche. Le service Batch retente une tâche si son code de sortie n’est pas différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives pour l’exécutable de tâche en raison d’un code de sortie différent de zéro. Le service Batch essaiera la tâche une seule fois et peut ensuite réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est égal à 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est égal à 0, le service Batch ne réessaye pas la tâche après la première tentative. Si le nombre maximal de nouvelles tentatives est -1, le service Batch retente la tâche sans limite, mais cela n’est pas recommandé pour une tâche de démarrage ou une tâche. La valeur par défaut est 0 (aucune nouvelle tentative).

--max-wall-clock-time

S’il n’est pas spécifié, il n’existe aucune limite de temps sur la durée pendant laquelle la tâche peut s’exécuter.

--resource-files

Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande. Références de ressources séparées par l’espace au format filename=httpurl, httpurl étant n’importe quelle URL HTTP avec accès public ou URL SAS avec accès en lecture.

--retention-time

La valeur par défaut est de 7 jours, c’est-à-dire que le répertoire des tâches est conservé pendant 7 jours, sauf si le nœud de calcul est supprimé ou si le travail est supprimé.

--task-id

ID de la tâche.

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 batch task delete

Modifier

Supprime une tâche du travail spécifié.

Lorsqu’une tâche est supprimée, tous les fichiers de son répertoire sur le nœud de calcul où il a été exécuté sont également supprimés (indépendamment de l’heure de rétention). Pour les tâches multi-instances, l’opération de suppression de tâche s’applique de manière synchrone à la tâche principale ; les tâches subordonnées et leurs fichiers sont ensuite supprimés de manière asynchrone en arrière-plan.

az batch task delete --job-id
                     --task-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--yes]

Paramètres obligatoires

--job-id

ID du travail à partir duquel supprimer la tâche.

--task-id

ID de la tâche à supprimer.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--if-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.

--if-modified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.

--if-none-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.

--if-unmodified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service n’a pas été modifiée depuis l’heure spécifiée.

--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
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 batch task list

Modifier

Répertorie toutes les tâches associées au travail spécifié.

Pour les tâches multi-instances, des informations telles que affinityId, executionInfo et nodeInfo font référence à la tâche principale. Utilisez l’API de sous-tâches de liste pour récupérer des informations sur les tâches subordonnées.

az batch task list --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--select]

Paramètres obligatoires

--job-id

ID du travail.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--expand

Clause $expand OData.

--filter

Clause OData $filter. Pour plus d’informations sur la construction de ce filtre, consultez https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks.

--select

Clause OData $select.

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 batch task reactivate

Modifier

Réactive une tâche, ce qui lui permet de s’exécuter à nouveau même si son nombre de nouvelles tentatives a été épuisé.

La réactivation rend une tâche éligible à une nouvelle tentative jusqu’au nombre maximal de nouvelles tentatives. L’état de la tâche est remplacé par actif. Comme la tâche n’est plus dans l’état terminé, tout code de sortie ou informations d’échec précédents n’est plus disponible après la réactivation. Chaque fois qu’une tâche est réactivée, son nombre de nouvelles tentatives est réinitialisé à 0. La réactivation échoue pour les tâches qui ne sont pas terminées ou qui se sont terminées précédemment (avec un code de sortie de 0). En outre, elle échoue si le travail est terminé (ou termine ou supprime).

az batch task reactivate --job-id
                         --task-id
                         [--account-endpoint]
                         [--account-key]
                         [--account-name]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]

Paramètres obligatoires

--job-id

ID du travail contenant la tâche.

--task-id

ID de la tâche à réactiver.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--if-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.

--if-modified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.

--if-none-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.

--if-unmodified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service n’a pas été modifiée depuis l’heure spécifié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 batch task reset

Modifier

Réinitialisez les propriétés d’une tâche Batch.

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]

Paramètres obligatoires

--job-id

ID du travail contenant la tâche.

--task-id

ID de la tâche à mettre à jour.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--if-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.

--if-modified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.

--if-none-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.

--if-unmodified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service n’a pas été modifiée depuis l’heure spécifiée.

--json-file

Fichier contenant la spécification des contraintes au format JSON (mis en forme pour correspondre au corps de l’API REST respective). Si ce paramètre est spécifié, tous les « arguments de contraintes » sont ignorés.

--max-task-retry-count

Nombre maximal de nouvelles tentatives de la tâche. Le service Batch retente une tâche si son code de sortie n’est pas différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives pour l’exécutable de tâche en raison d’un code de sortie différent de zéro. Le service Batch essaiera la tâche une seule fois et peut ensuite réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est égal à 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est égal à 0, le service Batch ne réessaye pas la tâche après la première tentative. Si le nombre maximal de nouvelles tentatives est -1, le service Batch retente la tâche sans limite, mais cela n’est pas recommandé pour une tâche de démarrage ou une tâche. La valeur par défaut est 0 (aucune nouvelle tentative).

--max-wall-clock-time

S’il n’est pas spécifié, il n’existe aucune limite de temps sur la durée pendant laquelle la tâche peut s’exécuter. Le format attendu est une durée ISO-8601.

--retention-time

La valeur par défaut est de 7 jours, c’est-à-dire que le répertoire des tâches est conservé pendant 7 jours, sauf si le nœud de calcul est supprimé ou si le travail est supprimé. Le format attendu est une durée ISO-8601.

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 batch task show

Modifier

Obtient des informations sur la tâche spécifiée.

Pour les tâches multi-instances, des informations telles que affinityId, executionInfo et nodeInfo font référence à la tâche principale. Utilisez l’API de sous-tâches de liste pour récupérer des informations sur les tâches subordonnées.

az batch task show --job-id
                   --task-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--select]

Paramètres obligatoires

--job-id

ID du travail qui contient la tâche.

--task-id

ID de la tâche à obtenir des informations.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--expand

Clause $expand OData.

--if-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.

--if-modified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.

--if-none-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.

--if-unmodified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service n’a pas été modifiée depuis l’heure spécifiée.

--select

Clause OData $select.

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 batch task stop

Modifier

Termine la tâche spécifiée.

Une fois la tâche terminée, elle passe à l’état terminé. Pour les tâches multi-instances, l’opération terminer la tâche s’applique de manière synchrone à la tâche principale ; Les tâches subordonnées sont ensuite arrêtées de manière asynchrone en arrière-plan.

az batch task stop --job-id
                   --task-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]

Paramètres obligatoires

--job-id

ID du travail contenant la tâche.

--task-id

ID de la tâche à terminer.

Paramètres facultatifs

--account-endpoint

Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.

--account-key

Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.

--account-name

Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.

--if-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.

--if-modified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.

--if-none-match

Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.

--if-unmodified-since

Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service n’a pas été modifiée depuis l’heure spécifié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.