az batch job
Administrar trabajos de Batch.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az batch job create |
Agregue un trabajo a una cuenta de Batch. |
Núcleo | GA |
az batch job delete |
Elimina un trabajo de una cuenta de Batch. |
Núcleo | GA |
az batch job disable |
Deshabilite un trabajo de Batch. |
Núcleo | GA |
az batch job enable |
Habilite un trabajo de Batch. |
Núcleo | GA |
az batch job list |
Enumere todos los trabajos o la programación de trabajos en una cuenta de Batch. |
Núcleo | GA |
az batch job prep-release-status |
Vea el estado de las tareas de preparación y liberación del trabajo de Batch. |
Núcleo | 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. |
Núcleo | 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. |
Núcleo | 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. |
Núcleo | GA |
az batch job show |
Obtiene información sobre el trabajo de Batch especificado. |
Núcleo | GA |
az batch job stop |
Detenga un trabajo de Batch en ejecución. |
Núcleo | GA |
az batch job task-counts |
Vea el número de tareas y ranuras en un trabajo de Batch y sus estados. |
Núcleo | GA |
az batch job task-counts show |
Obtiene los recuentos de tareas para el trabajo especificado. |
Núcleo | 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-application-package-references]
[--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]
[--on-all-tasks-complete]
[--pool-id]
[--priority]
[--required-slots]
[--uses-task-dependencies]
Ejemplos
Cree un nuevo trabajo asociado a un grupo existente.
az batch job create --id job1 --pool-id pool1
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
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.
Cadena que identifica de forma única el trabajo dentro de la cuenta. 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). Obligatorio.
Lista de paquetes de aplicación que el servicio Batch implementará en el nodo de proceso antes de ejecutar la línea de comandos. Los paquetes de aplicación se descargan e implementan en un directorio compartido, no en el directorio de trabajo de la tarea. Por lo tanto, si un paquete de aplicación al que se hace referencia ya está en el nodo de proceso y está actualizado, no se vuelve a descargar; se usa la copia existente en el nodo de proceso. Si no se puede instalar un paquete de aplicación al que se hace referencia, por ejemplo porque se ha eliminado el paquete o porque se produjo un error en la descarga, se produce un error en la tarea. Identificadores de aplicación separados por espacios con versión opcional en formato "id[#version]".
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. 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). Obligatorio.
Lista de opciones de configuración de variables de entorno para la tarea Administrador de trabajos. Valores separados por espacios en formato 'key=value'.
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. Obligatorio.
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. 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 de .zip, paquetes de aplicación o contenedores de Docker. Referencias de recursos separadas por espacios en formato filename=httpurl.
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 reintentos).
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.
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.
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.
Lista de pares nombre-valor asociados al trabajo como metadatos. 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'.
La acción que debe realizar el servicio Batch cuando todas las tareas del trabajo estén en estado completado. Tenga en cuenta que si un trabajo no contiene tareas, todas las tareas se consideran completas. Por lo tanto, esta opción se usa con más frecuencia con una tarea del Administrador de trabajos; Si desea usar la terminación automática del trabajo sin un Administrador de trabajos, debe establecer inicialmente onAllTasksComplete en noaction y actualizar las propiedades job para establecer onAllTasksComplete para finalizarjob una vez que haya terminado de agregar Tareas. El valor predeterminado es noaction. Los valores conocidos son: "noaction" y "terminatejob".
Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado. Debe asegurarse de que existe el grupo al que hace referencia esta propiedad. Si el grupo no existe en el momento en que el servicio Batch intenta programar un trabajo, no se ejecutará ninguna tarea para el trabajo hasta que cree un grupo con ese identificador. Tenga en cuenta que el servicio Batch no rechazará la solicitud de trabajo; simplemente no ejecutará tareas hasta que exista el grupo. Debe especificar el identificador del grupo o la especificación del grupo automático, pero no ambos.
Prioridad del trabajo. Los valores de prioridad pueden oscilar entre -1000 y 1000, y -1000 ser la prioridad más baja y 1000 es la prioridad más alta. El valor predeterminado es 0.
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.
Si las tareas del trabajo pueden definir dependencias entre sí. El valor predeterminado es false. True si la marca está presente.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az batch job delete
Elimina un trabajo de una cuenta de Batch.
az batch job delete --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]
Ejemplos
Elimine un trabajo mediante el identificador de trabajo sin pedir confirmación.
az batch job delete --job-id job1 --yes
Parámetros requeridos
Identificador del trabajo que se va a eliminar. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
No solicite confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az batch job disable
Deshabilite un trabajo de Batch.
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]
[--json-file]
Ejemplos
Deshabilite un trabajo y vuelva a poner en cola las tareas en ejecución.
az batch job disable --job-id job1 --disable-tasks requeue
Parámetros requeridos
Identificador del trabajo que se va a deshabilitar. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
Qué hacer con las tareas activas asociadas al trabajo. Obligatorio. Los valores conocidos son: "requeue", "terminate" y "wait".
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.
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.
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.
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.
Archivo que contiene la especificación de contenido 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 contenido.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az batch job enable
Habilite un trabajo de Batch.
az batch job enable --job-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Ejemplos
Habilite un trabajo.
az batch job enable --job-id job1
Parámetros requeridos
Identificador del trabajo que se va a habilitar. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para 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]
Ejemplos
Enumeración de todos los trabajos de una cuenta de Batch
az batch job list
Enumerar toda la programación del trabajo en una cuenta de Batch
az batch job list --job-schedule-id jobschedule1
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Solo es necesario Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
Una cláusula $expand OData.
Una cláusula $filter de OData. Para obtener más información sobre cómo construir este filtro, vea https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
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.
Una cláusula $select de OData.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para 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]
[--pool-id]
[--priority]
Ejemplos
Restablezca todas las propiedades del trabajo excepto la prioridad.
az batch job reset --job-id job1 --priority 100
Parámetros requeridos
Identificador del trabajo cuyas propiedades desea actualizar. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
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.
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 reintentos).
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.
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.
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.
Lista de pares nombre-valor asociados al trabajo como metadatos. 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'.
La acción que debe realizar el servicio Batch cuando todas las tareas del trabajo estén en estado completado. El valor predeterminado es noaction. Los valores conocidos son: "noaction" y "terminatejob".
Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado. Debe asegurarse de que existe el grupo al que hace referencia esta propiedad. Si el grupo no existe en el momento en que el servicio Batch intenta programar un trabajo, no se ejecutará ninguna tarea para el trabajo hasta que cree un grupo con ese identificador. Tenga en cuenta que el servicio Batch no rechazará la solicitud de trabajo; simplemente no ejecutará tareas hasta que exista el grupo. Debe especificar el identificador del grupo o la especificación del grupo automático, pero no ambos.
Prioridad del trabajo. Los valores de prioridad pueden oscilar entre -1000 y 1000, y -1000 ser la prioridad más baja y 1000 es la prioridad más alta. El valor predeterminado es 0.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para 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]
[--pool-id]
[--priority]
Ejemplos
Actualizar la prioridad del trabajo.
az batch job set --job-id job1 --priority 100
Parámetros requeridos
Identificador del trabajo cuyas propiedades desea actualizar. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
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.
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 reintentos).
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.
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.
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.
Lista de pares nombre-valor asociados al trabajo como metadatos. Si se omite, los metadatos del trabajo existentes se dejan sin cambios. Valores separados por espacios en formato 'key=value'.
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). Los valores conocidos son: "noaction" y "terminatejob".
Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado. Debe asegurarse de que existe el grupo al que hace referencia esta propiedad. Si el grupo no existe en el momento en que el servicio Batch intenta programar un trabajo, no se ejecutará ninguna tarea para el trabajo hasta que cree un grupo con ese identificador. Tenga en cuenta que el servicio Batch no rechazará la solicitud de trabajo; simplemente no ejecutará tareas hasta que exista el grupo. Debe especificar el identificador del grupo o la especificación del grupo automático, pero no ambos.
Prioridad del trabajo. Los valores de prioridad pueden oscilar entre -1000 y 1000, y -1000 ser 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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.
az batch job show
Obtiene información sobre el trabajo de Batch 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]
Ejemplos
Muestra detalles de información sobre un trabajo.
az batch job show --job-id job1
Parámetros requeridos
Identificador del trabajo. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
Una cláusula $expand OData.
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.
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.
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.
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.
Una cláusula $select de OData.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para 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]
Ejemplos
Detener un trabajo y dar un motivo de finalización
az batch job stop --job-id job1 --terminate-reason "Completed workflow"
Parámetros requeridos
Identificador del trabajo que se va a finalizar. Obligatorio.
Parámetros opcionales
Punto de conexión de servicio de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ENDPOINT.
Clave de cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCESS_KEY.
Nombre de la cuenta de Batch. Como alternativa, establezca por variable de entorno: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Motivo de finalización.
El texto que desea que aparezca como TerminateReason del trabajo. El valor predeterminado es "UserTerminate".
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, supresión de advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.