az batch pool

Administrar grupos de Batch.

Comandos

az batch pool all-statistics

Vea las estadísticas de todos los grupos en una cuenta de Batch.

az batch pool all-statistics show

Obtenga estadísticas de resumen de duración de todos los grupos de una cuenta de Batch.

az batch pool autoscale

Administrar el escalado automático de grupos de Batch.

az batch pool autoscale disable

Deshabilita el escalado automático de un grupo.

az batch pool autoscale enable

Habilita el escalado automático para un grupo.

az batch pool autoscale evaluate

Obtiene el resultado de evaluar una fórmula de escalado automático en el grupo.

az batch pool create

Cree un grupo de Batch en una cuenta. Al crear un grupo, elija argumentos de Cloud Services Configuración o Configuración de máquina virtual.

az batch pool delete

Elimina un grupo de la cuenta especificada.

az batch pool list

Enumera todos los grupos de la cuenta especificada.

az batch pool node-counts

Obtención de recuentos de nodos para grupos de Batch.

az batch pool node-counts list

Obtiene el número de nodos de ejecución en cada estado, agrupados por grupo.

az batch pool reset

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

az batch pool resize

Cambie el tamaño o deje de cambiar el tamaño de un grupo de Batch.

az batch pool set

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

az batch pool show

Obtiene información sobre el grupo especificado.

az batch pool supported-images

Consulte información sobre imágenes de máquina virtual compatibles con Azure Batch servicio.

az batch pool supported-images list

Enumera todas las imágenes de máquina virtual compatibles con el servicio Azure Batch.

az batch pool usage-metrics

Vea las métricas de uso de los grupos de Batch.

az batch pool usage-metrics list

Enumera las métricas de uso, agregadas por Grupo en intervalos de tiempo individuales, para la cuenta especificada.

az batch pool create

Cree un grupo de Batch en una cuenta. Al crear un grupo, elija argumentos de Cloud Services Configuración o Configuración de máquina virtual.

az batch pool create [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--application-licenses]
                     [--application-package-references]
                     [--auto-scale-formula]
                     [--certificate-references]
                     [--disk-encryption-targets]
                     [--enable-inter-node-communication]
                     [--id]
                     [--image]
                     [--json-file]
                     [--metadata]
                     [--node-agent-sku-id]
                     [--os-family {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--policy {regional, zonal}]
                     [--resize-timeout]
                     [--start-task-command-line]
                     [--start-task-resource-files]
                     [--start-task-wait-for-success]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]
                     [--targets]
                     [--task-slots-per-node]
                     [--vm-size]

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.

--application-licenses

La lista de licencias de aplicación debe ser un subconjunto de las licencias de aplicación de servicio de Batch disponibles. Si se solicita una licencia que no se admite, se producirá un error en la creación del grupo. Valores separados por espacios.

--application-package-references

Los cambios en las referencias de paquete afectan a todos los nodos nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear una imagen inicial. Hay un máximo de 10 referencias de paquete en cualquier grupo determinado. Identificadores de aplicación separados por espacios con una versión opcional en formato "id[#version]".

--auto-scale-formula

Fórmula para el número deseado de nodos de proceso en el grupo. Se comprueba la validez de la fórmula antes de crearse el grupo. Si la fórmula no es válida, el servicio Batch rechaza la solicitud con información de error detallada. Para obtener más información acerca de cómo especificar esta fórmula, vea https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.

--certificate-references

Para Windows nodos, el servicio Batch instala los certificados en el almacén de certificados y la ubicación especificados. En el caso de los nodos de ejecución de Linux, los certificados se almacenan en un directorio dentro del directorio de trabajo de la tarea y se proporciona una variable de entorno AZ_BATCH_CERTIFICATES_DIR a la tarea para consultar esta ubicación. En el caso de los certificados con visibilidad de "remoteUser", se crea un directorio "certs" en el directorio principal del usuario (por ejemplo, /home/{user-name}/certs) y los certificados se colocan en ese directorio. Huellas digitales de certificado separadas por espacios.

--disk-encryption-targets

Lista separada por espacios de DiskEncryptionTargets. los valores posibles actuales incluyen OsDisk y TemporaryDisk.

--enable-inter-node-communication

Si el grupo permite la comunicación directa entre nodos de proceso. La habilitación de la comunicación entre nodos limita el tamaño máximo del grupo debido a las restricciones de implementación en los nodos de proceso del grupo. Esto puede dar lugar a que el grupo no alcance su tamaño deseado. El valor predeterminado es false. True si la marca está presente.

--id

Obligatorio. 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 de grupo dentro de una cuenta que solo difiere por mayúsculas y minúsculas).

--image

Referencia de imagen del sistema operativo. Puede ser el formato "publisher:offer:sku[:version]" o un identificador de imagen arm completo con el formato "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Si el formato "publisher:offer:sku[:version]", la versión es opcional y si se omite más reciente se usará. Los valores válidos se pueden recuperar mediante "az batch pool supported-images list". Por ejemplo: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Un archivo que contiene la especificación del grupo 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 '{group_title(arg[0])}.

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

--node-agent-sku-id

Obligatorio. El agente de Batch Compute Node es un programa que se ejecuta en cada nodo de proceso del grupo y proporciona la interfaz de comando y control entre el nodo de proceso y el servicio Batch. Hay diferentes implementaciones del agente de Compute Node, conocidas como SKU, para distintos sistemas operativos. Debe especificar una SKU del agente de Nodo de proceso que coincida con la referencia de imagen seleccionada. Para obtener la lista de SKU de agente de Node de proceso compatibles junto con su lista de referencias de imágenes comprobadas, consulte la operación "Enumeración de SKU de agente de nodo de proceso compatibles".

--os-family

Obligatorio. Los valores posibles son: 2 - Familia del sistema operativo 2, equivalente a Windows Server 2008 R2 SP1. 3 - Familia 3 del sistema operativo, equivalente a Windows Server 2012. 4 - Familia 4 del sistema operativo, equivalente a Windows Server 2012 R2. 5 - Familia 5 del sistema operativo, equivalente a Windows Server 2016. 6 - Familia 6 del sistema operativo, equivalente a Windows Server 2019. Para más información, consulte Versiones del sistema operativo invitado de Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).

valores aceptados: 2, 3, 4, 5, 6
--os-version

El valor predeterminado es * que especifica la versión más reciente del sistema operativo para la familia de sistema operativo especificada.

--policy

Tipo de directiva de selección de ubicación de nodo en grupos de lotes. Directiva de asignación usada por el servicio Batch para aprovisionar los nodos. Si no se especifica, Batch usará la directiva regional.

valores aceptados: regional, zonal
--resize-timeout

Este tiempo de espera solo se aplica al escalado manual; no tiene ningún efecto cuando enableAutoScale se establece en true. El valor predeterminado es 15 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch devuelve 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.

--start-task-command-line

Obligatorio. 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, mediante "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 tarea) o usar la variable de entorno proporcionada por Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Los archivos enumerados en este elemento se encuentran en el directorio de trabajo de la tarea. Referencias de recursos separadas por espacios en formato filename=httpurl.

--start-task-wait-for-success

Si el servicio Batch debe esperar a que startTask se complete correctamente (es decir, salir con el código de salida 0) antes de programar cualquier tarea en el nodo de proceso. Si es true y StartTask produce un error en un nodo, el servicio Batch reintenta startTask hasta su número máximo de reintentos (maxTaskRetryCount). Si la tarea todavía no se ha completado correctamente después de todos los reintentos, el servicio Batch marca el nodo inutilizable y no programará tareas en él. Esta condición se puede detectar a través del estado del nodo de ejecución y los detalles de información de error. Si es false, el servicio Batch no esperará a que se complete startTask. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de ejecución mientras se está ejecutando startTask; e incluso si se produce un error en StartTask, las nuevas tareas se seguirán programando en el nodo de ejecución. El valor predeterminado es true. True si la marca está presente.

--target-dedicated-nodes

Número deseado de nodos de proceso dedicados en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en true. Si enableAutoScale está establecido en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.

--target-low-priority-nodes

Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en true. Si enableAutoScale está establecido en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.

--targets

Si se omite, no se cifrará ningún disco en los nodos de proceso del grupo. En el grupo de Linux, solo se admite "TemporaryDisk"; en Windows grupo, debe especificarse "OsDisk" y "TemporaryDisk". Discos de destino separados de espacio que se van a cifrar. Los valores pueden ser OsDisk o TemporaryDisk.

--task-slots-per-node

El número de ranuras de tareas que pueden usarse para ejecutar tareas simultáneas en un solo nodo de ejecución en el grupo. El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos del vmSize del grupo o 256.

--vm-size

Obligatorio. Para obtener información sobre los tamaños disponibles de las máquinas virtuales para Cloud Services Grupos (grupos creados con cloudServiceConfiguration), consulte Tamaños para Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch admite todos los tamaños de máquina virtual Cloud Services excepto ExtraSmall, A1V2 y A2V2. Para obtener información sobre los tamaños de máquina virtual disponibles para grupos que usan imágenes de Virtual Machines Marketplace (grupos creados con virtualMachineConfiguration), consulte Tamaños para Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Tamaños para Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)). Batch admite todos los tamaños de máquina virtual de Azure, excepto STANDARD_A0 y aquellos con premium Storage (STANDARD_GS, STANDARD_DS y serie STANDARD_DSV2).

az batch pool delete

Elimina un grupo de la cuenta especificada.

Cuando solicita que se elimine un grupo, se producen las siguientes acciones: el estado del grupo se establece en eliminar; cualquier operación de cambio de tamaño en curso en el grupo se detiene; El servicio Batch comienza a cambiar el tamaño del grupo a cero nodos de proceso; las tareas que se ejecutan en nodos de ejecución existentes se finalizan y se vuelven a poner en cola (como si se hubiera solicitado una operación de grupo de cambio de tamaño con la opción de requeue predeterminada); por último, el grupo se quita del sistema. Dado que se vuelven a poner en cola las tareas en ejecución, el usuario puede volver a ejecutar estas tareas actualizando su trabajo para establecer como destino un grupo diferente. A continuación, las tareas se pueden ejecutar en el nuevo grupo. Si desea invalidar el comportamiento de la puesta en cola, debe llamar al grupo de cambio de tamaño explícitamente para reducir el tamaño del grupo a cero antes de eliminar el grupo. Si llama a una API de actualización, revisión o eliminación en un grupo en el estado de eliminación, se producirá un error con el código de estado HTTP 409 con el código de error PoolBeingDeleted.

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

Parámetros requeridos

--pool-id

Identificador del grupo 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 la última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde la hora especificada.

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

az batch pool list

Enumera todos los grupos de la cuenta especificada.

az batch pool 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 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-pools.

--select

Una cláusula $select OData.

az batch pool reset

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

az batch pool reset --pool-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--application-package-references]
                    [--certificate-references]
                    [--json-file]
                    [--metadata]
                    [--start-task-command-line]
                    [--start-task-environment-settings]
                    [--start-task-max-task-retry-count]
                    [--start-task-wait-for-success]

Parámetros requeridos

--pool-id

Identificador del grupo 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.

--application-package-references

Obligatorio. La lista reemplaza las referencias existentes del paquete de aplicación en el grupo. Los cambios en las referencias del paquete de aplicación afectan a todos los nodos de proceso nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear una imagen inicial. Hay un máximo de 10 referencias de paquete de aplicación en cualquier grupo determinado. Si se omite o especifica una colección vacía, se quitan las referencias de paquetes de aplicación existentes del grupo. Se puede especificar un máximo de 10 referencias en un grupo determinado.

--certificate-references

Obligatorio. Esta lista reemplaza las referencias de certificado existentes configuradas en el grupo. Si especifica una colección vacía, se quitan las referencias de certificado existentes del grupo. Para Windows nodos, el servicio Batch instala los certificados en el almacén de certificados y la ubicación especificados. En el caso de los nodos de proceso de Linux, los certificados se almacenan en un directorio dentro del directorio de trabajo de la tarea y se proporciona una variable de entorno AZ_BATCH_CERTIFICATES_DIR a la tarea para consultar esta ubicación. En el caso de los certificados con visibilidad de "remoteUser", se crea un directorio "certs" en el directorio principal del usuario (por ejemplo, /home/{user-name}/certs) y los certificados se colocan en ese directorio.

--json-file

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

--metadata

Obligatorio. Esta lista reemplaza los metadatos existentes configurados en el grupo. Si se omite o especifica una colección vacía, se quitan los metadatos existentes del grupo.

--start-task-command-line

Línea de comandos de la tarea de inicio. 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, mediante "cmd /c MyCommand" en Windows o "/bin/sh -c MyCommand" en Linux.

--start-task-environment-settings

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

--start-task-max-task-retry-count

Número máximo de veces que se puede reintentar la tarea.

--start-task-wait-for-success

Si el servicio Batch debe esperar a que la tarea de inicio se complete correctamente (es decir, salir con el código de salida 0) antes de programar las tareas en el nodo de proceso. True si la marca está presente; de lo contrario, el valor predeterminado es False.

az batch pool resize

Cambie el tamaño o deje de cambiar el tamaño de un grupo de Batch.

az batch pool resize --pool-id
                     [--abort]
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
                     [--resize-timeout]
                     [--target-dedicated-nodes]
                     [--target-low-priority-nodes]

Parámetros requeridos

--pool-id

El identificador del grupo.

Parámetros opcionales

--abort

Detenga la operación de cambio de tamaño del grupo.

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

La operación solo se realizará si la ETag actual del recurso coincide exactamente con el valor especificado.

--if-modified-since

La operación se realizará solo si el recurso se ha modificado desde la marca de tiempo especificada.

--if-none-match

La operación no se realizará solo si la ETag actual del recurso coincide exactamente con el valor especificado.

--if-unmodified-since

La operación no se realizará solo si el recurso se ha modificado desde la marca de tiempo especificada.

--node-deallocation-option

Cuando los nodos se pueden quitar del grupo, si el tamaño del grupo disminuye.

valores aceptados: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

El valor predeterminado es 15 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch devuelve un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).

--target-dedicated-nodes

Número deseado de nodos de proceso dedicados en el grupo.

--target-low-priority-nodes

Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo.

az batch pool set

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

az batch pool set --pool-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--application-package-references]
                  [--certificate-references]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--json-file]
                  [--metadata]
                  [--start-task-command-line]
                  [--start-task-environment-settings]
                  [--start-task-max-task-retry-count]
                  [--start-task-resource-files]
                  [--start-task-wait-for-success]

Parámetros requeridos

--pool-id

Identificador del grupo 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.

--application-package-references

Los cambios en las referencias de paquete afectan a todos los nodos nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear una imagen inicial. Si este elemento está presente, reemplaza las referencias existentes de Package. Si especifica una colección vacía, todas las referencias de paquete se quitan del grupo. Si se omite, las referencias existentes de Package no se modifican. Identificadores de aplicación separados por espacios con una versión opcional en formato "id[#version]".

--certificate-references

Si este elemento está presente, reemplaza las referencias de certificado existentes configuradas en el grupo. Si se omite, las referencias de certificado existentes se dejan sin cambios. Para Windows nodos, el servicio Batch instala los certificados en el almacén de certificados y la ubicación especificados. En el caso de los nodos de ejecución de Linux, los certificados se almacenan en un directorio dentro del directorio de trabajo de la tarea y se proporciona una variable de entorno AZ_BATCH_CERTIFICATES_DIR a la tarea para consultar esta ubicación. En el caso de los certificados con visibilidad de "remoteUser", se crea un directorio "certs" en el directorio principal del usuario (por ejemplo, /home/{user-name}/certs) y los certificados se colocan en ese directorio. Huellas digitales de certificado separadas por espacios.

--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 la última modificación del recurso conocido para el cliente. La operación se realizará solo 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 se realizará solo 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 la última modificación del recurso conocido para el cliente. La operación se realizará solo si el recurso del servicio no se ha modificado desde el momento especificado.

--json-file

Un archivo que contiene la especificación del parámetro de revisión del grupo 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 '{group_title(arg[0])}.

--metadata

Si este elemento está presente, reemplaza los metadatos existentes configurados en el grupo. Si especifica una colección vacía, se quitan los metadatos del grupo. Si se omite, los metadatos existentes se dejan sin cambios. Valores separados por espacios en formato "key=value".

--start-task-command-line

Obligatorio. 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, mediante "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 tarea) o usar la variable de entorno proporcionada por Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-environment-settings

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

--start-task-max-task-retry-count

Número máximo de veces que se puede reintentar la tarea. El servicio Batch reintenta 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á la tarea una vez y, a continuación, puede reintentar hasta este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y tres reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite.

--start-task-resource-files

Los archivos enumerados en este elemento se encuentran en el directorio de trabajo de la tarea. Referencias de recursos separadas por espacios en formato filename=httpurl.

--start-task-wait-for-success

Si el servicio Batch debe esperar a que startTask se complete correctamente (es decir, salir con el código de salida 0) antes de programar cualquier tarea en el nodo de proceso. Si es true y StartTask produce un error en un nodo, el servicio Batch reintenta startTask hasta su número máximo de reintentos (maxTaskRetryCount). Si la tarea todavía no se ha completado correctamente después de todos los reintentos, el servicio Batch marca el nodo inutilizable y no programará tareas en él. Esta condición se puede detectar a través del estado del nodo de ejecución y los detalles de información de error. Si es false, el servicio Batch no esperará a que se complete startTask. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de ejecución mientras se está ejecutando startTask; e incluso si se produce un error en StartTask, las nuevas tareas se seguirán programando en el nodo de ejecución. El valor predeterminado es true. Especifique "true" o "false" para actualizar la propiedad.

az batch pool show

Obtiene información sobre el grupo especificado.

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

Parámetros requeridos

--pool-id

Identificador del grupo 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 de 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 la última modificación del recurso conocido para el cliente. La operación se realizará solo 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 se realizará solo 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 la última modificación del recurso conocido para el cliente. La operación se realizará solo si el recurso del servicio no se ha modificado desde el momento especificado.

--select

Una cláusula $select de OData.