Pool - Update Properties

Novedades las propiedades del grupo especificado.
Esto reemplaza completamente todas las propiedades actualizables del grupo. Por ejemplo, si el grupo tiene una clase StartTask asociada y si StartTask no se especifica con esta solicitud, el servicio Batch quitará el objeto StartTask existente.

POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/updateproperties?timeout={timeout}&api-version=2023-11-01.18.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.

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 a la que se emitió la solicitud. Normalmente, las bibliotecas cliente establecen esto en la hora actual del reloj del sistema; 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 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, las referencias de paquetes de aplicación existentes se quitan 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, se quitan las referencias de certificado existentes 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 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.

Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use la extensión Azure KeyVault en su lugar.

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 ejecución a medida que se une al grupo. La tarea se ejecuta cuando se agrega el nodo de ejecución al grupo o cuando se reinicia el nodo de ejecución.
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 valor 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.

Headers

  • 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 OAuth 2.0 Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre Description
user_impersonation Suplantación de su cuenta de usuario

Authorization

Type: apiKey
In: header

Ejemplos

Pool update

Sample Request

POST account.region.batch.azure.com/pools/poolId/updateproperties?api-version=2023-11-01.18.0



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

Sample Response

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 para el usuario automático que ejecuta una tarea en el servicio Batch.

BatchError

Respuesta de error recibida del servicio Azure Batch.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error 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.

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

MetadataItem

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

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, se produce un error de procesamiento previo a la tarea.

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 para el 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 que no deben ser accesibles por 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 su presentación en una interfaz de usuario.

values

BatchErrorDetail[]

Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error 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 se aplica a los grupos configurados con nodos de proceso de Windows (es decir, creados con cloudServiceConfiguration o con virtualMachineConfiguration mediante una referencia de imagen 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/{nombre-de-usuario}/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 se aplica a los grupos configurados con nodos de proceso de Windows (es decir, creados con cloudServiceConfiguration o con virtualMachineConfiguration mediante una referencia de imagen 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 ser visible para la cuenta de usuario en la que se ejecuta StartTask. Tenga en cuenta que si El ámbito de autousuario es Grupo para startTask y una tarea, este certificado también será visible para la tarea.

task

string

El certificado debe ser 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.

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 un 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 tareas 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 Azure Batch.

Nombre Tipo Description
lang

string

Código de idioma del mensaje de error

value

string

Texto del mensaje.

MetadataItem

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

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, se quitan las referencias de certificado existentes 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/{nombre-de-usuario}/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 la extensión De Azure KeyVault en su lugar.

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

El 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 comiencen 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 de 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 ejecución 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 en 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 interrumpir el directorio de trabajo de la tarea (por ejemplo, mediante "..").

httpUrl

string

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

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

containerSettings

TaskContainerSettings

La configuración del contenedor en el que se ejecuta StartTask.
Cuando se especifica esto, todos los directorios de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de Azure Batch directorios del nodo) se asignan al 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 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 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 reintenta 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 ningún reintento).

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 de tamaño. Esto se puede lograr mediante archivos .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 con 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 se sigue ejecutando StartTask; 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
containerRunOptions

string

Opciones adicionales para el comando container create.
Estas opciones adicionales se proporcionan como argumentos para el comando "docker create", además de los controlados por el servicio Batch.

imageName

string

Imagen que se va a usar para crear el contenedor en el que se ejecutará la tarea.
Se trata de 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

La ubicación del directorio de trabajo task del 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.