Pool - Update Properties

Servicio:

Batch Service

Versión de la API:

2024-07-01.20.0

Actualiza las propiedades del grupo especificado.
Esto reemplaza por completo todas las propiedades actualizables del grupo. Por ejemplo, si el grupo tiene un StartTask asociado a él y si StartTask no se especifica con esta solicitud, el servicio Batch quitará el startTask existente.

POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2024-07-01.20.0

Con parámetros opcionales:

POST {batchUrl}/pools/{poolId}/updateproperties?timeout={timeout}&api-version=2024-07-01.20.0

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
batchUrl	path	True	string	Dirección URL base de todas las solicitudes de servicio de Azure Batch.
poolId	path	True	string	Identificador del grupo que se va a actualizar.
api-version	query	True	string	Versión de la API de cliente.
timeout	query		integer int32	Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos. Si el valor es mayor que 30, se usará el valor predeterminado en su lugar.

Encabezado de la solicitud

Media Types: "application/json; odata=minimalmetadata"

Nombre	Requerido	Tipo	Description
client-request-id		string uuid	La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Si el servidor debe devolver el client-request-id en la respuesta.
ocp-date		string date-time-rfc1123	Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.

Cuerpo de la solicitud

Media Types: "application/json; odata=minimalmetadata"

Nombre	Requerido	Tipo	Description
applicationPackageReferences	True	ApplicationPackageReference[]	Lista de paquetes de aplicación que se van a instalar en cada nodo de proceso del grupo. 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 imágenes. 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.
certificateReferences	True	CertificateReference[]	Lista de certificados que se van a instalar en cada nodo de proceso del grupo. Esta lista reemplaza las referencias de certificado existentes configuradas en el grupo. Si especifica una colección vacía, las referencias de certificado existentes se quitan del grupo. En el caso de los nodos de Windows, 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. Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de .
metadata	True	MetadataItem[]	Lista de pares nombre-valor asociados al grupo como metadatos. 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.
startTask		StartTask	Tarea que se va a ejecutar en cada nodo de proceso a medida que se une al grupo. La tarea se ejecuta cuando se agrega el nodo de proceso al grupo o cuando se reinicia el nodo de proceso. Si este elemento está presente, sobrescribe cualquier StartTask existente. Si se omite, se quita cualquier StartTask existente del grupo.
targetNodeCommunicationMode		NodeCommunicationMode	Modo de comunicación de nodo deseado para el grupo. Esta configuración reemplaza cualquier configuración de targetNodeCommunication existente en el grupo. Si se omite, la configuración existente es predeterminada.

Respuestas

Nombre	Tipo	Description
204 No Content		La solicitud al servicio Batch se realizó correctamente. Encabezados client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Error del servicio Batch.

Seguridad

azure_auth

Flujo de código de autenticación de Microsoft Entra OAuth 2.0

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	Suplantar la cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Pool update

Solicitud de ejemplo

HTTP

POST account.region.batch.azure.com/pools/poolId/updateproperties?api-version=2024-07-01.20.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "certificateReferences": [],
  "applicationPackageReferences": [],
  "metadata": []
}

Respuesta de muestra

status code:

204

Definiciones

Nombre	Description
ApplicationPackageReference	Referencia a un paquete que se va a implementar en nodos de proceso.
AutoUserScope	Ámbito del usuario automático
AutoUserSpecification	Especifica los parámetros del usuario automático que ejecuta una tarea en el servicio Batch.
BatchError	Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail	Un elemento de información adicional incluida en una respuesta de error de Azure Batch.
CertificateReference	Referencia a un certificado que se va a instalar en nodos de proceso de un grupo.
CertificateStoreLocation	Ubicación del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado.
CertificateVisibility	Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado.
ComputeNodeIdentityReference	Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.
ContainerHostBatchBindMountEntry	La entrada de la ruta de acceso y el modo de montaje que desea montar en el contenedor de tareas.
ContainerHostDataPath	Rutas de acceso que se montarán en el contenedor de la tarea de contenedor.
ContainerRegistry	Un registro de contenedor privado.
ContainerWorkingDirectory	Ubicación del directorio de trabajo de la tarea de contenedor.
ElevationLevel	Nivel de elevación del usuario.
EnvironmentSetting	Variable de entorno que se va a establecer en un proceso de tarea.
ErrorMessage	Mensaje de error recibido en una respuesta de error de Azure Batch.
MetadataItem	Par nombre-valor asociado a un recurso de servicio de Batch.
NodeCommunicationMode	Determina cómo se comunica un grupo con el servicio Batch.
PoolUpdatePropertiesParameter	Conjunto de cambios que se van a realizar en un grupo.
ResourceFile	Un único archivo o varios archivos que se van a descargar en un nodo de proceso.
StartTask	Tarea que se ejecuta cuando un nodo se une a un grupo en el servicio Azure Batch, o cuando se reinicia o se vuelve a crear una imagen de imagen del nodo de proceso.
TaskContainerSettings	Configuración del contenedor de una tarea.
UserIdentity	Definición de la identidad de usuario en la que se ejecuta la tarea.

ApplicationPackageReference

Referencia a un paquete que se va a implementar en nodos de proceso.

Nombre	Tipo	Description
applicationId	string	Identificador de la aplicación que se va a implementar. Al crear un grupo, el identificador de aplicación del paquete debe estar completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	Versión de la aplicación que se va a implementar. Si se omite, se implementa la versión predeterminada. Si se omite en un grupo y no se especifica ninguna versión predeterminada para esta aplicación, se produce un error en la solicitud con el código de error InvalidApplicationPackageReferences y el código de estado HTTP 409. Si se omite en una tarea y no se especifica ninguna versión predeterminada para esta aplicación, la tarea produce un error de preprocesamiento.

AutoUserScope

Ámbito del usuario automático

Nombre	Tipo	Description
pool	string	Especifica que la tarea se ejecuta como la cuenta de usuario automático común que se crea en cada nodo de proceso de un grupo.
task	string	Especifica que el servicio debe crear un nuevo usuario para la tarea.

AutoUserSpecification

Especifica los parámetros del usuario automático que ejecuta una tarea en el servicio Batch.

Nombre	Tipo	Description
elevationLevel	ElevationLevel	Nivel de elevación del usuario automático. El valor predeterminado es nonAdmin.
scope	AutoUserScope	Ámbito del usuario automático El valor predeterminado es pool. Si el grupo ejecuta Windows, se debe especificar un valor de Task si se requiere un aislamiento más estricto entre las tareas. Por ejemplo, si la tarea muta el registro de una manera que podría afectar a otras tareas, o si se han especificado certificados en el grupo al que no deben acceder las tareas normales, pero deben ser accesibles por StartTasks.

BatchError

Respuesta de error recibida del servicio Azure Batch.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	ErrorMessage	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
values	BatchErrorDetail[]	Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.

Nombre	Tipo	Description
key	string	Identificador que especifica el significado de la propiedad Value.
value	string	La información adicional incluida con la respuesta de error.

CertificateReference

Referencia a un certificado que se va a instalar en nodos de proceso de un grupo.

Nombre	Tipo	Description
storeLocation	CertificateStoreLocation	Ubicación del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado. El valor predeterminado es currentuser. Esta propiedad solo es aplicable a los grupos configurados con nodos de proceso de Windows. 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.
storeName	string	Nombre del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado. Esta propiedad solo es aplicable a los grupos configurados con nodos de proceso de Windows. Los nombres de almacén comunes incluyen: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, pero también se puede usar cualquier nombre de almacén personalizado. El valor predeterminado es My.
thumbprint	string	Huella digital del certificado.
thumbprintAlgorithm	string	Algoritmo con el que está asociada la huella digital. Debe ser sha1.
visibility	CertificateVisibility[]	Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado. Puede especificar más de una visibilidad en esta colección. El valor predeterminado es todas las cuentas.

CertificateStoreLocation

Ubicación del almacén de certificados en el nodo de proceso en el que se va a instalar el certificado.

Nombre	Tipo	Description
currentuser	string	Los certificados deben instalarse en el almacén de certificados CurrentUser.
localmachine	string	Los certificados deben instalarse en el almacén de certificados LocalMachine.

CertificateVisibility

Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado.

Nombre	Tipo	Description
remoteuser	string	El certificado debe ser visible para las cuentas de usuario en las que los usuarios acceden de forma remota al nodo de proceso.
starttask	string	El certificado debe estar visible para la cuenta de usuario en la que se ejecuta StartTask. Tenga en cuenta que si El ámbito de autousuario es Pool para StartTask y una tarea, este certificado también será visible para la tarea.
task	string	El certificado debe estar visible para las cuentas de usuario en las que se ejecutan las tareas de trabajo.

ComputeNodeIdentityReference

Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso de ARM de la identidad asignada por el usuario.

ContainerHostBatchBindMountEntry

La entrada de la ruta de acceso y el modo de montaje que desea montar en el contenedor de tareas.

Nombre	Tipo	Description
isReadOnly	boolean	Monte esta ruta de acceso de origen como modo de solo lectura o no. El valor predeterminado es false (modo de lectura y escritura). Para Linux, si monta esta ruta de acceso como modo de lectura y escritura, esto no significa que todos los usuarios del contenedor tengan acceso de lectura y escritura para la ruta de acceso, depende del acceso en la máquina virtual host. Si esta ruta de acceso está montada de solo lectura, todos los usuarios del contenedor no podrán modificar la ruta de acceso.
source	ContainerHostDataPath	La ruta de acceso que se va a montar en el cliente contenedor puede seleccionar.

ContainerHostDataPath

Rutas de acceso que se montarán en el contenedor de la tarea de contenedor.

Nombre	Tipo	Description
Applications	string	Ruta de acceso de las aplicaciones.
JobPrep	string	Ruta de acceso de la tarea de preparación del trabajo.
Shared	string	Ruta de acceso de la tarea de varias instancias para compartir sus archivos.
Startup	string	Ruta de acceso para la tarea de inicio.
Task	string	Ruta de acceso de la tarea.
VfsMounts	string	La ruta de acceso contiene todos los sistemas de archivos virtuales que se montan en este nodo.

ContainerRegistry

Un registro de contenedor privado.

Nombre	Tipo	Description
identityReference	ComputeNodeIdentityReference	Referencia a la identidad asignada por el usuario que se va a usar para acceder a una instancia de Azure Container Registry en lugar de un nombre de usuario y una contraseña. Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.
password	string	Contraseña que se va a iniciar sesión en el servidor del Registro.
registryServer	string	Dirección URL del Registro. Si se omite, el valor predeterminado es "docker.io".
username	string	Nombre de usuario que se va a iniciar sesión en el servidor del Registro.

ContainerWorkingDirectory

Ubicación del directorio de trabajo de la tarea de contenedor.

Nombre	Tipo	Description
containerImageDefault	string	Use el directorio de trabajo definido en la imagen del contenedor. Tenga en cuenta que este directorio no contendrá los archivos de recursos descargados por Batch.
taskWorkingDirectory	string	Use el directorio de trabajo de tarea del servicio Batch estándar, que contendrá los archivos de recursos de tarea rellenados por Batch.

ElevationLevel

Nivel de elevación del usuario.

Nombre	Tipo	Description
admin	string	El usuario es un usuario con acceso elevado y funciona con permisos de administrador completos.
nonadmin	string	El usuario es un usuario estándar sin acceso elevado.

EnvironmentSetting

Variable de entorno que se va a establecer en un proceso de tarea.

Nombre	Tipo	Description
name	string	Nombre de la variable de entorno.
value	string	Valor de la variable de entorno.

ErrorMessage

Mensaje de error recibido en una respuesta de error de Azure Batch.

Nombre	Tipo	Description
lang	string	El código de idioma del mensaje de error
value	string	Texto del mensaje.

MetadataItem

Par nombre-valor asociado a un recurso de servicio de Batch.

Nombre	Tipo	Description
name	string	Nombre del elemento de metadatos.
value	string	Valor del elemento de metadatos.

NodeCommunicationMode

Determina cómo se comunica un grupo con el servicio Batch.

Nombre	Tipo	Description
classic	string	Los nodos que usan el modo de comunicación clásica requieren la comunicación TCP entrante en los puertos 29876 y 29877 de BatchNodeManagement. {region}" etiqueta de servicio y comunicación TCP saliente en el puerto 443 a "Storage.region" y "BatchNodeManagement". Etiquetas de servicio {region}".
default	string	El servicio Batch establece automáticamente el modo de comunicación de nodo.
simplified	string	Los nodos que usan el modo de comunicación simplificada requieren la comunicación TCP saliente en el puerto 443 a "BatchNodeManagement. Etiqueta de servicio {region}". No se requieren puertos de entrada abiertos.

PoolUpdatePropertiesParameter

Conjunto de cambios que se van a realizar en un grupo.

Nombre	Tipo	Description
applicationPackageReferences	ApplicationPackageReference[]	Lista de paquetes de aplicación que se van a instalar en cada nodo de proceso del grupo. 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 imágenes. 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.
certificateReferences	CertificateReference[]	Lista de certificados que se van a instalar en cada nodo de proceso del grupo. Esta lista reemplaza las referencias de certificado existentes configuradas en el grupo. Si especifica una colección vacía, las referencias de certificado existentes se quitan del grupo. En el caso de los nodos de Windows, 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. Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de .
metadata	MetadataItem[]	Lista de pares nombre-valor asociados al grupo como metadatos. 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.
startTask	StartTask	Tarea que se va a ejecutar en cada nodo de proceso a medida que se une al grupo. La tarea se ejecuta cuando se agrega el nodo de proceso al grupo o cuando se reinicia el nodo de proceso. Si este elemento está presente, sobrescribe cualquier StartTask existente. Si se omite, se quita cualquier StartTask existente del grupo.
targetNodeCommunicationMode	NodeCommunicationMode	Modo de comunicación de nodo deseado para el grupo. Esta configuración reemplaza cualquier configuración de targetNodeCommunication existente en el grupo. Si se omite, la configuración existente es predeterminada.

ResourceFile

Un único archivo o varios archivos que se van a descargar en un nodo de proceso.

Nombre	Tipo	Description
autoStorageContainerName	string	Nombre del contenedor de almacenamiento en la cuenta de almacenamiento automática. Las propiedades autoStorageContainerName, storageContainerUrl y httpUrl son mutuamente excluyentes y se debe especificar una de ellas.
blobPrefix	string	Prefijo de blob que se va a usar al descargar blobs de un contenedor de Azure Storage. Solo se descargarán los blobs cuyos nombres comienzan por el prefijo especificado. La propiedad solo es válida cuando se usa autoStorageContainerName o storageContainerUrl. Este prefijo puede ser un nombre de archivo parcial o un subdirectorio. Si no se especifica un prefijo, se descargarán todos los archivos del contenedor.
fileMode	string	Atributo del modo de permiso de archivo en formato octal. Esta propiedad solo se aplica a los archivos que se descargan en nodos de proceso de Linux. Se omitirá si se especifica para un resourceFile que se descargará en un nodo de proceso de Windows. Si no se especifica esta propiedad para un nodo de proceso de Linux, se aplica un valor predeterminado de 0770 al archivo.
filePath	string	Ubicación en el nodo de proceso al que se van a descargar los archivos, en relación con el directorio de trabajo de la tarea. Si se especifica la propiedad httpUrl, se requiere filePath y describe la ruta de acceso a la que se descargará el archivo, incluido el nombre de archivo. De lo contrario, si se especifica la propiedad autoStorageContainerName o storageContainerUrl, filePath es opcional y es el directorio al que descargar los archivos. En el caso de que filePath se use como directorio, cualquier estructura de directorios que ya esté asociada a los datos de entrada se conservará en su totalidad y se anexará al directorio filePath especificado. La ruta de acceso relativa especificada no puede dividirse en el directorio de trabajo de la tarea (por ejemplo, mediante '..').
httpUrl	string	Dirección URL del archivo que se va a descargar. Las propiedades autoStorageContainerName, storageContainerUrl y httpUrl son mutuamente excluyentes y se debe especificar una de ellas. Si la dirección URL apunta a Azure Blob Storage, debe ser legible desde los nodos de proceso. Hay tres maneras de obtener esta dirección URL para un blob en Azure Storage: incluya una firma de acceso compartido (SAS) que conceda permisos de lectura en el blob, use una identidad administrada con permiso de lectura o establezca la ACL para el blob o su contenedor para permitir el acceso público.
identityReference	ComputeNodeIdentityReference	Referencia a la identidad asignada por el usuario que se va a usar para acceder a Azure Blob Storage especificado por storageContainerUrl o httpUrl Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.
storageContainerUrl	string	Dirección URL del contenedor de blobs en Azure Blob Storage. Las propiedades autoStorageContainerName, storageContainerUrl y httpUrl son mutuamente excluyentes y se debe especificar una de ellas. Esta dirección URL debe ser legible y enumerable desde los nodos de proceso. Hay tres maneras de obtener esta dirección URL para un contenedor en Azure Storage: incluya una firma de acceso compartido (SAS) que conceda permisos de lectura y lista en el contenedor, use una identidad administrada con permisos de lectura y lista, o establezca la ACL para que el contenedor permita el acceso público.

StartTask

Tarea que se ejecuta cuando un nodo se une a un grupo en el servicio Azure Batch, o cuando se reinicia o se vuelve a crear una imagen de imagen del nodo de proceso.

Nombre	Tipo	Description
commandLine	string	Línea de comandos de StartTask. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Configuración del contenedor en el que se ejecuta StartTask. Cuando se especifica esto, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de los directorios de Azure Batch en el nodo) en el contenedor, todas las variables de entorno task se asignan al contenedor y la línea de comandos task se ejecuta en el contenedor. Es posible que los archivos generados en el contenedor fuera de AZ_BATCH_NODE_ROOT_DIR no se reflejen en el disco host, lo que significa que las API de archivos de Batch no podrán acceder a esos archivos.
environmentSettings	EnvironmentSetting[]	Lista de opciones de configuración de variables de entorno para StartTask.
maxTaskRetryCount	integer	Número máximo de veces que se puede reintentar la 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á la tarea una vez y, a continuación, podrá volver a intentarlo 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 3 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, pero esto no se recomienda para una tarea de inicio ni para ninguna tarea. El valor predeterminado es 0 (sin reintentos).
resourceFiles	ResourceFile[]	Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. Hay un tamaño máximo para la lista de archivos de recursos. Cuando se supera el tamaño máximo, se producirá un error en la solicitud y el código de error de respuesta será RequestEntityTooLarge. Si esto ocurre, la colección de ResourceFiles debe reducirse en tamaño. Esto se puede lograr mediante archivos de .zip, paquetes de aplicación o contenedores de Docker. Los archivos enumerados en este elemento se encuentran en el directorio de trabajo de la tarea.
userIdentity	UserIdentity	Identidad de usuario en la que se ejecuta StartTask. Si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea.
waitForSuccess	boolean	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 se 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 proceso 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 proceso mientras startTask todavía se está ejecutando; e incluso si se produce un error en StartTask, las nuevas tareas seguirán programando en el nodo de proceso. El valor predeterminado es true.

TaskContainerSettings

Configuración del contenedor de una tarea.

Nombre	Tipo	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Las rutas de acceso que desea montar en la tarea contenedora. Si esta matriz es nula o no está presente, la tarea de contenedor montará toda la unidad de disco temporal en windows (o AZ_BATCH_NODE_ROOT_DIR en Linux). No montará ninguna ruta de acceso de datos en el contenedor si esta matriz está establecida como vacía.
containerRunOptions	string	Opciones adicionales para el comando container create. Estas opciones adicionales se proporcionan como argumentos para el comando "docker create", además de las controladas por el servicio Batch.
imageName	string	Imagen que se va a usar para crear el contenedor en el que se ejecutará la tarea. Esta es la referencia de imagen completa, como se especificaría en "docker pull". Si no se proporciona ninguna etiqueta como parte del nombre de la imagen, la etiqueta ":latest" se usa como valor predeterminado.
registry	ContainerRegistry	Registro privado que contiene la imagen de contenedor. Esta configuración se puede omitir si ya se proporcionó en la creación del grupo.
workingDirectory	ContainerWorkingDirectory	Ubicación del directorio de trabajo de la tarea de contenedor. El valor predeterminado es "taskWorkingDirectory".

UserIdentity

Definición de la identidad de usuario en la que se ejecuta la tarea.

Nombre	Tipo	Description
autoUser	AutoUserSpecification	Usuario automático en el que se ejecuta la tarea. Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos.
username	string	Nombre de la identidad de usuario en la que se ejecuta la tarea. Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos.