az batch job-schedule

  • Referencia

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

Editar

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

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

--do-not-run-after

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.

--do-not-run-until

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.

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

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

--on-all-tasks-complete

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.

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

--recurrence-interval

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.

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

--start-window

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.

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

Editar

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

--job-schedule-id

Identificador de la programación de trabajos 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-schedule disable

Editar

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

--job-schedule-id

Identificador de la programación de trabajos 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.

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

Editar

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

--job-schedule-id

Identificador de la programación de trabajos 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-schedule list

Editar

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

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

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

Editar

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

--job-schedule-id

Identificador de la programación de trabajos que se va a 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.

--do-not-run-after

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.

--do-not-run-until

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.

--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-manager-task-application-package-references

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

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

--json-file

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.

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

--on-all-tasks-complete

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.

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

--recurrence-interval

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.

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

--start-window

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.

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

Editar

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

--job-schedule-id

Identificador de la programación de trabajos que se va a 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.

--do-not-run-after

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.

--do-not-run-until

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.

--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-manager-task-application-package-references

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

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

--json-file

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.

--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 no especifica este elemento, los metadatos existentes se dejan sin cambios. Valores separados por espacios en formato 'key=value'.

--on-all-tasks-complete

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.

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

--recurrence-interval

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.

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

--start-window

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.

--uses-task-dependencies

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

Editar

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

--job-schedule-id

Identificador de la programación de trabajos que se va a obtener.

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

Editar

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

--job-schedule-id

Identificador de la programación de trabajos 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.

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.