Share via

az batch job

  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-batch-cli-extensions para la CLI de Azure (versión 2.30.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az batch job . Obtenga más información sobre las extensiones.

Administrar trabajos de Batch.

Comandos

Nombre Description Tipo Estado
az batch job create

Agregue un trabajo y tareas asociadas a una cuenta de Batch.

 Extensión GA

az batch job create

Agregue un trabajo y tareas asociadas a una cuenta de Batch.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--parameters]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--resource-group]
                    [--template]
                    [--uses-task-dependencies]

Parámetros opcionales

--account-endpoint

Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.

--account-key

Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.

--account-name

Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Si las tareas de este trabajo pueden ser adelantadas por otros trabajos de prioridad alta. Si el valor se establece en True, otros trabajos de prioridad alta enviados al sistema tendrán prioridad y podrán volver a poner en cola las tareas de este trabajo. Puede actualizar allowTaskPreemption de un trabajo después de que se haya creado mediante la API de trabajo de actualización.

--id

Necesario. El identificador puede contener cualquier combinación de caracteres alfanuméricos, incluidos guiones y caracteres de subrayado, y no puede contener más de 64 caracteres. El identificador se conserva entre mayúsculas y minúsculas y no distingue mayúsculas de minúsculas (es decir, es posible que no tenga dos identificadores dentro de una cuenta que solo difiere por caso).

--job-manager-task-command-line

Línea de comandos de la tarea Administrador de trabajos. La línea de comandos no se ejecuta en un shell y, por tanto, no puede aprovechar las características del shell, como la expansión de variables de entorno. Si desea aprovechar estas características, debe invocar el shell en la línea de comandos, por ejemplo, con "cmd /c MyCommand" en Windows o "/bin/sh -c MyCommand" en Linux.

--job-manager-task-environment-settings

Lista de opciones de configuración de variables de entorno para la tarea Administrador de trabajos. Valores separados por espacios en formato 'key=value'.

--job-manager-task-id

Cadena que identifica de forma única la tarea Administrador de trabajos dentro del trabajo. El identificador puede contener cualquier combinación de caracteres alfanuméricos, incluidos guiones y caracteres de subrayado, y no puede contener más de 64 caracteres.

--job-manager-task-resource-files

Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. Los archivos enumerados en este elemento se encuentran en el directorio de trabajo de la tarea. Referencias de recursos separadas por espacios en formato filename=httpurl.

--job-max-task-retry-count

Número máximo de veces que se puede reintentar cada tarea. El servicio de Batch reintenta una tarea su el código de salida es distinto de cero. Tenga en cuenta que este valor controla específicamente el número de reintentos. El servicio Batch probará cada tarea una vez y, a continuación, volverá a intentarlo hasta este límite. Por ejemplo, si el conteo de reintentos máximo es 3, Batch intenta una tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el conteo de intentos máximo es 0, el servicio de Batch no reintenta las tareas. Si el conteo de intentos máximo es -1, el servicio de Batch reintenta las tareas sin ningún límite. El valor predeterminado es 0 (sin ningún reintento).

--job-max-wall-clock-time

Tiempo máximo transcurrido que se puede ejecutar el trabajo, medido desde el momento en que se crea el trabajo. Si el trabajo no se completa dentro del límite de tiempo, el servicio Batch lo finaliza y las tareas que todavía se están ejecutando. En este caso, el motivo de terminación será MaxWallClockTimeExpiry. Si no se especifica esta propiedad, no hay ningún límite de tiempo durante cuánto tiempo se puede ejecutar el trabajo. El formato esperado es una duración ISO-8601.

--json-file

Un archivo que contiene la especificación del trabajo en JSON (con formato para que coincida con el cuerpo de la API REST correspondiente). Si se especifica este parámetro, se omiten todos los argumentos de trabajo.

--max-parallel-tasks

Número máximo de tareas que se pueden ejecutar en paralelo para el trabajo. El valor de maxParallelTasks debe ser -1 o mayor que 0 si se especifica. Si no se especifica, el valor predeterminado es -1, lo que significa que no hay ningún límite para el número de tareas que se pueden ejecutar a la vez. Puede actualizar los maxParallelTasks de un trabajo después de que se haya creado mediante la API de trabajo de actualización. Valor predeterminado: -1 .

--metadata

El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario.

--parameters

Valores de parámetro para un archivo de plantilla JSON de trabajo de Batch. Solo se puede usar con --template.

--pool-id

Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado.

--priority

Prioridad del trabajo. Los valores de prioridad pueden oscilar entre -1000 y 1000, y -1000 es la prioridad más baja y 1000 es la prioridad más alta. El valor predeterminado es 0.

--required-slots

Número de ranuras de programación que requiere la tarea para ejecutarse. El valor predeterminado es 1. Una tarea solo se puede programar para ejecutarse en un nodo de proceso si el nodo tiene suficientes ranuras de programación libres disponibles. En el caso de las tareas de varias instancias, esta propiedad no se admite y no se debe especificar.

--resource-group

El grupo de recursos de la cuenta de Batch.

--template

Un archivo de plantilla JSON de trabajo de Batch. Si se especifica este parámetro, se omiten todos los demás parámetros.

--uses-task-dependencies

Marca que determina si este trabajo usará tareas con dependencias. True si la marca está presente.

valor predeterminado: False
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.