az batch job-schedule
Administrar programaciones de trabajos de Batch.
Comandos
Nombre | Description | Tipo | Estado |
---|---|---|---|
az batch job-schedule create |
Agregue una programación de trabajos de Batch a una cuenta. |
Principal | GA |
az batch job-schedule delete |
Elimina una programación de trabajos de la cuenta especificada. |
Principal | GA |
az batch job-schedule disable |
Deshabilita una programación de trabajos. |
Principal | GA |
az batch job-schedule enable |
Habilita una programación de trabajos. |
Principal | GA |
az batch job-schedule list |
Enumera todas las programaciones de trabajo de la cuenta especificada. |
Principal | GA |
az batch job-schedule reset |
Restablezca las propiedades de una programación de trabajo. Una especificación de trabajo actualizada solo se aplica a los nuevos trabajos. |
Principal | GA |
az batch job-schedule set |
Actualice las propiedades de una programación de trabajo. |
Principal | GA |
az batch job-schedule show |
Obtiene información sobre la programación de trabajos especificada. |
Principal | GA |
az batch job-schedule stop |
Finaliza una programación de trabajo. |
Principal | GA |
az batch job-schedule create
Agregue una programación de trabajos de Batch a una cuenta.
az batch job-schedule create [--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--do-not-run-after]
[--do-not-run-until]
[--id]
[--job-manager-task-command-line]
[--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 {noaction, terminatejob}]
[--pool-id]
[--priority]
[--recurrence-interval]
[--required-slots]
[--start-window]
[--uses-task-dependencies]
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.
Si no especifica una hora doNotRunAfter y va a crear una programación de trabajos periódica, la programación de trabajos permanecerá activa hasta que la finalice explícitamente. El formato esperado es una marca de tiempo ISO-8601.
Si no especifica una hora doNotRunUntil, la programación estará lista para crear trabajos inmediatamente. El formato esperado es una marca de tiempo ISO-8601.
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).
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).
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.
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.
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).
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 de programación de trabajos en la nube 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 programación de trabajos en la nube.
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 .
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 el servicio Batch debe realizar cuando todas las tareas de un trabajo creado en esta programación 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.
Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado.
Prioridad de los trabajos creados en esta programación. 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. Esta prioridad se usa como valor predeterminado para todos los trabajos en la programación de trabajos. Puede actualizar la prioridad de un trabajo después de que se haya creado mediante la API de trabajo de actualización.
Dado que una programación de trabajos puede tener como máximo un trabajo activo en él en un momento dado, si es el momento de crear un nuevo trabajo en una programación de trabajos, pero el trabajo anterior todavía se está ejecutando, el servicio Batch no creará el nuevo trabajo hasta que finalice el trabajo anterior. Si el trabajo anterior no finaliza dentro del período startWindow de la nueva periodicidadInterval, no se programará ningún nuevo trabajo para ese intervalo. Para trabajos periódicos, normalmente debe especificar un jobManagerTask en jobSpecification. Si no usa jobManagerTask, necesitará un proceso externo para supervisar cuándo se crean trabajos, agregue Tareas a los trabajos y finalice los trabajos listos para la siguiente periodicidad. El valor predeterminado es que la programación no se repite: se crea un trabajo, dentro de startWindow después de la hora doNotRunUntil y la programación se completa en cuanto finaliza el trabajo. El valor mínimo es de 1 minuto. Si especifica un valor inferior, el servicio Batch rechaza la programación con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). El formato esperado es una duración ISO-8601.
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 no se crea un trabajo dentro del intervalo startWindow, se pierde la "oportunidad" ; no se creará ningún trabajo hasta la siguiente periodicidad de la programación. Si la programación es periódica y startWindow es mayor que el intervalo de periodicidad, esto equivale a un startWindow infinito, ya que el trabajo que es "due" en una periodicidadInterval no se lleva a cabo en el siguiente intervalo de periodicidad. El valor predeterminado es infinito. El valor mínimo es de 1 minuto. Si especifica un valor inferior, el servicio Batch rechaza la programación con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). El formato esperado es una duración ISO-8601.
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 de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule delete
Elimina una programación de trabajos de la cuenta especificada.
Al eliminar una programación de trabajos, esto también elimina todos los trabajos y tareas de esa programación. Cuando se eliminan las tareas, también se eliminan todos los archivos de sus directorios de trabajo en los nodos de proceso (se omite el período de retención). Las estadísticas de programación de trabajos ya no son accesibles una vez eliminada la programación de trabajos, aunque todavía se cuentan para las estadísticas de duración de la cuenta.
az batch job-schedule delete --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]
Parámetros requeridos
Identificador de la programación de trabajos que se va a eliminar.
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 no se ha modificado desde el momento especificado.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule disable
Deshabilita una programación de trabajos.
No se creará ningún nuevo trabajo hasta que se vuelva a habilitar la programación de trabajos.
az batch job-schedule disable --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Parámetros requeridos
Identificador de la programación de trabajos que se va a deshabilitar.
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 no se ha modificado desde el momento especificado.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule enable
Habilita una programación de trabajos.
az batch job-schedule enable --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Parámetros requeridos
Identificador de la programación de trabajos que se va a habilitar.
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 no se ha modificado desde el momento especificado.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule list
Enumera todas las programaciones de trabajo de la cuenta especificada.
az batch job-schedule list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]
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.
Una cláusula $filter de OData. Para obtener más información sobre cómo construir este filtro, vea https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules.
Una cláusula $select de OData.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule reset
Restablezca las propiedades de una programación de trabajo. Una especificación de trabajo actualizada solo se aplica a los nuevos trabajos.
az batch job-schedule reset --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--do-not-run-after]
[--do-not-run-until]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--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-metadata]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete {noaction, terminatejob}]
[--pool-id]
[--priority]
[--recurrence-interval]
[--required-slots]
[--start-window]
[--uses-task-dependencies]
Parámetros requeridos
Identificador de la programación de trabajos que se va a actualizar.
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.
Si no especifica una hora doNotRunAfter y va a crear una programación de trabajos periódica, la programación de trabajos permanecerá activa hasta que la finalice explícitamente. El formato esperado es una marca de tiempo ISO-8601.
Si no especifica una hora doNotRunUntil, la programación estará lista para crear trabajos inmediatamente. El formato esperado es una marca de tiempo ISO-8601.
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 no se ha modificado desde el momento especificado.
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]".
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).
Valores separados por espacios en formato 'key=value'.
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.
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.
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'.
Un archivo que contiene la especificación del parámetro de actualización de programació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 programación de trabajos.
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 .
Si no especifica este elemento, toma el valor predeterminado de una lista vacía; en efecto, se eliminan los metadatos existentes. Valores separados por espacios en formato 'key=value'.
La acción que el servicio Batch debe realizar cuando todas las tareas de un trabajo creado en esta programación 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.
Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado.
Prioridad de los trabajos creados en esta programación. 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. Esta prioridad se usa como valor predeterminado para todos los trabajos en la programación de trabajos. Puede actualizar la prioridad de un trabajo después de que se haya creado mediante la API de trabajo de actualización.
Dado que una programación de trabajos puede tener como máximo un trabajo activo en él en un momento dado, si es el momento de crear un nuevo trabajo en una programación de trabajos, pero el trabajo anterior todavía se está ejecutando, el servicio Batch no creará el nuevo trabajo hasta que finalice el trabajo anterior. Si el trabajo anterior no finaliza dentro del período startWindow de la nueva periodicidadInterval, no se programará ningún nuevo trabajo para ese intervalo. Para trabajos periódicos, normalmente debe especificar un jobManagerTask en jobSpecification. Si no usa jobManagerTask, necesitará un proceso externo para supervisar cuándo se crean trabajos, agregue Tareas a los trabajos y finalice los trabajos listos para la siguiente periodicidad. El valor predeterminado es que la programación no se repite: se crea un trabajo, dentro de startWindow después de la hora doNotRunUntil y la programación se completa en cuanto finaliza el trabajo. El valor mínimo es de 1 minuto. Si especifica un valor inferior, el servicio Batch rechaza la programación con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). El formato esperado es una duración ISO-8601.
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 no se crea un trabajo dentro del intervalo startWindow, se pierde la "oportunidad" ; no se creará ningún trabajo hasta la siguiente periodicidad de la programación. Si la programación es periódica y startWindow es mayor que el intervalo de periodicidad, esto equivale a un startWindow infinito, ya que el trabajo que es "due" en una periodicidadInterval no se lleva a cabo en el siguiente intervalo de periodicidad. El valor predeterminado es infinito. El valor mínimo es de 1 minuto. Si especifica un valor inferior, el servicio Batch rechaza la programación con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). El formato esperado es una duración ISO-8601.
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 de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule set
Actualice las propiedades de una programación de trabajo.
Puede actualizar de forma independiente la programación y la especificación del trabajo, pero cualquier cambio en cualquiera de estas entidades restablecerá todas las propiedades de esa entidad.
az batch job-schedule set --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--allow-task-preemption]
[--do-not-run-after]
[--do-not-run-until]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--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-metadata]
[--json-file]
[--max-parallel-tasks]
[--metadata]
[--on-all-tasks-complete {noaction, terminatejob}]
[--pool-id]
[--priority]
[--recurrence-interval]
[--required-slots]
[--start-window]
[--uses-task-dependencies]
Parámetros requeridos
Identificador de la programación de trabajos que se va a actualizar.
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. Especifique "true" o "false" para actualizar la propiedad.
Si no especifica una hora doNotRunAfter y va a crear una programación de trabajos periódica, la programación de trabajos permanecerá activa hasta que la finalice explícitamente. El formato esperado es una marca de tiempo ISO-8601.
Si no especifica una hora doNotRunUntil, la programación estará lista para crear trabajos inmediatamente. El formato esperado es una marca de tiempo ISO-8601.
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 no se ha modificado desde el momento especificado.
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]".
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).
Valores separados por espacios en formato 'key=value'.
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.
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.
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'.
Un archivo que contiene la especificación del parámetro de revisión de programación de trabajos 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 programación de trabajos.
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 .
Si no especifica este elemento, los metadatos existentes se dejan sin cambios. Valores separados por espacios en formato 'key=value'.
La acción que el servicio Batch debe realizar cuando todas las tareas de un trabajo creado en esta programación 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.
Identificador de un grupo existente. Todas las tareas del trabajo se ejecutarán en el grupo especificado.
Prioridad de los trabajos creados en esta programación. 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. Esta prioridad se usa como valor predeterminado para todos los trabajos en la programación de trabajos. Puede actualizar la prioridad de un trabajo después de que se haya creado mediante la API de trabajo de actualización.
Dado que una programación de trabajos puede tener como máximo un trabajo activo en él en un momento dado, si es el momento de crear un nuevo trabajo en una programación de trabajos, pero el trabajo anterior todavía se está ejecutando, el servicio Batch no creará el nuevo trabajo hasta que finalice el trabajo anterior. Si el trabajo anterior no finaliza dentro del período startWindow de la nueva periodicidadInterval, no se programará ningún nuevo trabajo para ese intervalo. Para trabajos periódicos, normalmente debe especificar un jobManagerTask en jobSpecification. Si no usa jobManagerTask, necesitará un proceso externo para supervisar cuándo se crean trabajos, agregue Tareas a los trabajos y finalice los trabajos listos para la siguiente periodicidad. El valor predeterminado es que la programación no se repite: se crea un trabajo, dentro de startWindow después de la hora doNotRunUntil y la programación se completa en cuanto finaliza el trabajo. El valor mínimo es de 1 minuto. Si especifica un valor inferior, el servicio Batch rechaza la programación con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). El formato esperado es una duración ISO-8601.
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 no se crea un trabajo dentro del intervalo startWindow, se pierde la "oportunidad" ; no se creará ningún trabajo hasta la siguiente periodicidad de la programación. Si la programación es periódica y startWindow es mayor que el intervalo de periodicidad, esto equivale a un startWindow infinito, ya que el trabajo que es "due" en una periodicidadInterval no se lleva a cabo en el siguiente intervalo de periodicidad. El valor predeterminado es infinito. El valor mínimo es de 1 minuto. Si especifica un valor inferior, el servicio Batch rechaza la programación con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). El formato esperado es una duración ISO-8601.
Si las tareas del trabajo pueden definir dependencias entre sí. El valor predeterminado es false. Especifique "true" o "false" para actualizar la propiedad.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule show
Obtiene información sobre la programación de trabajos especificada.
az batch job-schedule show --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]
Parámetros requeridos
Identificador de la programación de trabajos que se va a obtener.
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 no se ha modificado desde el momento especificado.
Una cláusula $select de OData.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.
az batch job-schedule stop
Finaliza una programación de trabajo.
az batch job-schedule stop --job-schedule-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
Parámetros requeridos
Identificador de la programación de trabajos que se va a finalizar.
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 no se ha modificado desde el momento especificado.
Parámetros globales
Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.
Muestre este mensaje de ayuda y salga.
Mostrar solo los errores y suprimir las advertencias.
Formato de salida.
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
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 de registro. Use --debug para obtener registros de depuración completos.