Compartir a través de


az batch job

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar trabajos de Batch.

Comandos

Nombre Description Tipo Estado
az batch job create

Agregue un trabajo a una cuenta de Batch.

Principal GA
az batch job create (azure-batch-cli-extensions extensión)

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

Extensión GA
az batch job delete

Elimina un trabajo.

Principal GA
az batch job disable

Deshabilita el trabajo especificado, lo que impide que se ejecuten nuevas tareas.

Principal GA
az batch job enable

Habilita el trabajo especificado, lo que permite que se ejecuten nuevas tareas.

Principal GA
az batch job list

Enumere todos los trabajos o la programación de trabajos en una cuenta de Batch.

Principal GA
az batch job prep-release-status

Vea el estado de las tareas de preparación y liberación del trabajo de Batch.

Principal GA
az batch job prep-release-status list

Muestra el estado de ejecución de la tarea de preparación del trabajo y liberación de trabajos para el trabajo especificado en los nodos de proceso en los que se ha ejecutado el trabajo.

Principal GA
az batch job reset

Actualice las propiedades de un trabajo de Batch. Las propiedades no especificadas que se pueden actualizar se restablecen a sus valores predeterminados.

Principal GA
az batch job set

Actualice las propiedades de un trabajo de Batch. La actualización de una propiedad en un subgrupo restablecerá las propiedades no especificadas de ese grupo.

Principal GA
az batch job show

Obtiene información sobre el trabajo especificado.

Principal GA
az batch job stop

Detenga un trabajo de Batch en ejecución.

Principal GA
az batch job task-counts

Vea el número de tareas y ranuras en un trabajo de Batch y sus estados.

Principal GA
az batch job task-counts show

Obtiene los recuentos de tareas para el trabajo especificado.

Principal GA

az batch job create

Agregue un trabajo 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]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--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. True si la marca está presente.

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

Necesario. 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. Si la línea de comandos hace referencia a rutas de acceso de archivo, debe usar una ruta de acceso relativa (relativa al directorio de trabajo de la tarea) o usar la variable de entorno proporcionada por Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--job-manager-task-environment-settings

Valores separados por espacios en formato 'key=value'.

--job-manager-task-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.

--job-manager-task-resource-files

Los archivos enumerados en este elemento se encuentran en el directorio de trabajo de la tarea. Hay un tamaño máximo para la lista de archivos de recursos. Cuando se supera el tamaño máximo, se producirá un error en la solicitud y el código de error de respuesta será RequestEntityTooLarge. Si esto ocurre, la colección de ResourceFiles debe reducirse en tamaño. Esto se puede lograr mediante archivos .zip, paquetes de aplicaciones o contenedores de Docker. 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 Batch vuelve a intentar una tarea si su 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 número máximo de reintentos es 3, Batch intenta una tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar tareas. Si el número máximo de reintentos es -1, el servicio Batch vuelve a intentar tareas sin límite. El valor predeterminado es 0 (sin ningún reintento).

--job-max-wall-clock-time

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. Valores separados por espacios en formato 'key=value'.

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

--uses-task-dependencies

Si las tareas del trabajo pueden definir dependencias entre sí. El valor predeterminado es false. True si la marca está presente.

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 batch job create (azure-batch-cli-extensions extensión)

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.

az batch job delete

Elimina un trabajo.

Al eliminar un trabajo también se eliminan todas las tareas que forman parte de ese trabajo y todas las estadísticas de trabajo. Esto también invalida el período de retención para los datos de tarea; es decir, si el trabajo contiene tareas que todavía se conservan en nodos de proceso, los servicios de Batch eliminan los directorios de trabajo de esas tareas y todo su contenido. Cuando se recibe una solicitud eliminar trabajo, el servicio Batch establece el trabajo en el estado de eliminación. Todas las operaciones de actualización de un trabajo que se encuentra en estado de eliminación producirán un error con el código de estado 409 (conflicto), con información adicional que indica que se está eliminando el trabajo.

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

Parámetros requeridos

--job-id

Identificador del trabajo que se va a eliminar.

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.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

--yes -y

No solicita confirmación.

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.

az batch job disable

Deshabilita el trabajo especificado, lo que impide que se ejecuten nuevas tareas.

El servicio Batch mueve inmediatamente el trabajo al estado de deshabilitación. A continuación, Batch usa el parámetro disableTasks para determinar qué hacer con las tareas actualmente en ejecución del trabajo. El trabajo permanece en el estado de deshabilitación hasta que se complete la operación de deshabilitación y se hayan tratado todas las tareas según la opción disableTasks; A continuación, el trabajo pasa al estado deshabilitado. No se inicia ninguna nueva tarea en el trabajo hasta que vuelve al estado activo. Si intenta deshabilitar un trabajo que se encuentra en cualquier estado distinto de activo, deshabilitado o deshabilitado, se produce un error en la solicitud con el código de estado 409.

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

Parámetros requeridos

--job-id

Identificador del trabajo que se va a deshabilitar.

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.

--disable-tasks

Entre los valores posibles se incluyen: 'requeue', 'terminate', 'wait'.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

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 batch job enable

Habilita el trabajo especificado, lo que permite que se ejecuten nuevas tareas.

Al llamar a esta API, el servicio Batch establece un trabajo deshabilitado en el estado de habilitación. Una vez completada la operación, el trabajo pasa al estado activo y la programación de nuevas tareas en el trabajo se reanuda. El servicio Batch no permite que una tarea permanezca en estado activo durante más de 180 días. Por lo tanto, si habilita un trabajo que contiene tareas activas que se agregaron hace más de 180 días, esas tareas no se ejecutarán.

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

Parámetros requeridos

--job-id

Identificador del trabajo que se va a habilitar.

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.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

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 batch job list

Enumere todos los trabajos o la programación de trabajos en una cuenta de Batch.

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

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.

--expand

Una cláusula $expand OData.

--filter

Una cláusula $filter de OData.

--job-schedule-id

Identificador de la programación de trabajos desde la que desea obtener una lista de trabajos. Si se omite, enumera todos los trabajos de la cuenta.

--select

Una cláusula $select de OData.

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 batch job reset

Actualice las propiedades de un trabajo de Batch. Las propiedades no especificadas que se pueden actualizar se restablecen a sus valores predeterminados.

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]

Parámetros requeridos

--job-id

Identificador del trabajo cuyas propiedades desea actualizar.

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. True si la marca está presente.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

--job-max-task-retry-count

Número máximo de veces que se puede reintentar cada tarea. El servicio Batch vuelve a intentar una tarea si su 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 número máximo de reintentos es 3, Batch intenta una tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar tareas. Si el número máximo de reintentos es -1, el servicio Batch vuelve a intentar tareas sin límite. El valor predeterminado es 0 (sin ningún reintento).

--job-max-wall-clock-time

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 parámetro de actualizació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

Si se omite, toma el valor predeterminado de una lista vacía; en efecto, se eliminan los metadatos existentes. Valores separados por espacios en formato 'key=value'.

--on-all-tasks-complete

La acción que debe realizar el servicio Batch cuando todas las tareas del trabajo estén en estado completado. Si se omite, el comportamiento de finalización se establece en noaction. Si el valor actual es terminatejob, se trata de un error porque es posible que el comportamiento de finalización de un trabajo no se cambie de terminatejob a noaction. Es posible que no cambie el valor de terminatejob a noaction; es decir, una vez que haya comprometido la terminación automática del trabajo, no podrá desactivarlo de nuevo. Si intenta hacerlo, se produce un error en la solicitud y Batch devuelve el código de estado 400 (solicitud incorrecta) y una respuesta de error "valor de propiedad no válido". Si no especifica este elemento en una solicitud PUT, equivale a pasar noaction. Se trata de un error si el valor actual es terminatejob.

Valores aceptados: noaction, terminatejob
--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. Si se omite, se establece en el valor predeterminado 0.

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 batch job set

Actualice las propiedades de un trabajo de Batch. La actualización de una propiedad en un subgrupo restablecerá las propiedades no especificadas de ese grupo.

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]

Parámetros requeridos

--job-id

Identificador del trabajo cuyas propiedades desea actualizar.

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. Especifique "true" o "false" para actualizar la propiedad.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

--job-max-task-retry-count

Número máximo de veces que se puede reintentar cada tarea. El servicio Batch vuelve a intentar una tarea si su 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 número máximo de reintentos es 3, Batch intenta una tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar tareas. Si el número máximo de reintentos es -1, el servicio Batch vuelve a intentar tareas sin límite. El valor predeterminado es 0 (sin ningún reintento).

--job-max-wall-clock-time

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 parámetro de revisió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.

--metadata

Si se omite, los metadatos del trabajo existentes se dejan sin cambios. Valores separados por espacios en formato 'key=value'.

--on-all-tasks-complete

La acción que debe realizar el servicio Batch cuando todas las tareas del trabajo estén en estado completado. Si se omite, el comportamiento de finalización se deja sin cambios. Es posible que no cambie el valor de terminatejob a noaction; es decir, una vez que haya comprometido la terminación automática del trabajo, no podrá desactivarlo de nuevo. Si intenta hacerlo, se produce un error en la solicitud con una respuesta de error "valor de propiedad no válido" ; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).

Valores aceptados: noaction, terminatejob
--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. Si se omite, la prioridad del trabajo se deja sin cambios.

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

Obtiene información sobre el trabajo especificado.

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

Parámetros requeridos

--job-id

Identificador del trabajo.

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.

--expand

Una cláusula $expand OData.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

--select

Una cláusula $select de OData.

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

Detenga un trabajo de Batch en ejecución.

Finalice el trabajo especificado, lo que lo marca como completado. Cuando se recibe una solicitud finalizar trabajo, el servicio Batch establece el trabajo en el estado de terminación. A continuación, el servicio Batch finaliza las tareas en ejecución asociadas al trabajo y ejecuta las tareas de liberación de trabajos necesarias. A continuación, el trabajo pasa al estado completado. Si hay alguna tarea en el trabajo en estado activo, permanecerá en estado activo. Una vez finalizado un trabajo, no se pueden agregar nuevas tareas y no se programarán las tareas activas restantes.

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

Parámetros requeridos

--job-id

Identificador del trabajo que se va a finalizar.

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.

--if-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio coincide exactamente con el valor especificado por el cliente.

--if-modified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.

--if-none-match

Valor ETag asociado a la versión del recurso conocido para el cliente. La operación solo se realizará si la ETag actual del recurso en el servicio no coincide con el valor especificado por el cliente.

--if-unmodified-since

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

--terminate-reason

Motivo de finalización.

El texto que desea que aparezca como TerminateReason del trabajo. El valor predeterminado es "UserTerminate".

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.