Pool - Add

Service:

Batch Service

API Version:

2023-11-01.18.0

Agrega un grupo a la cuenta especificada.
Al asignar nombres a grupos, evite incluir información confidencial, como nombres de usuario o nombres de proyecto secretos. Esta información puede aparecer en los registros de telemetría a los que pueden acceder los ingenieros de Soporte técnico de Microsoft.

POST {batchUrl}/pools?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools?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.
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 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
id	True	string	Cadena que identifica de forma única el grupo dentro de la cuenta. 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 conserva mayúsculas de minúsculas y distingue mayúsculas de minúsculas (es decir, es posible que no tenga dos identificadores de grupo dentro de una cuenta que solo difieren por mayúsculas y minúsculas).
vmSize	True	string	Tamaño de las máquinas virtuales del grupo. Todas las máquinas virtuales de un grupo tienen el mismo tamaño. 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 mediante 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).
applicationLicenses		string[]	La lista de licencias de aplicación que el servicio Batch pondrá a disposición en cada nodo de proceso del grupo. La lista de licencias de aplicación debe ser un subconjunto de licencias de aplicación de servicio batch disponibles. Si se solicita una licencia que no se admite, se producirá un error en la creación del grupo.
applicationPackageReferences		ApplicationPackageReference[]	Lista de paquetes que se van a instalar en cada nodo de proceso del grupo. 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}). 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 imágenes. Hay un máximo de 10 referencias de paquete en cualquier grupo determinado.
autoScaleEvaluationInterval		string	Intervalo de tiempo en el que ajustar automáticamente el tamaño del grupo según la fórmula de escalado automático. El valor predeterminado es 15 minutos. El valor mínimo y máximo son 5 minutos y 168 horas respectivamente. Si especifica un valor inferior a 5 minutos o superior a 168 horas, el servicio Batch devuelve un error; Si va a llamar directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).
autoScaleFormula		string	Fórmula para el número deseado de nodos de proceso en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en false. Es necesario si enableAutoScale está establecido en true. La fórmula se comprueba si hay validez antes de crear el grupo. Si la fórmula no es válida, el servicio Batch rechaza la solicitud con información detallada de error. Para obtener más información sobre cómo especificar esta fórmula, consulte "Escalado automático de nodos de proceso en un grupo de Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
certificateReferences		CertificateReference[]	Lista de certificados que se van a instalar en cada nodo de proceso 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.
cloudServiceConfiguration		CloudServiceConfiguration	Configuración del servicio en la nube para el grupo. Esta propiedad y virtualMachineConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades. Esta propiedad no se puede especificar si la cuenta de Batch se creó con su propiedad poolAllocationMode establecida en "UserSubscription".
displayName		string	Nombre para mostrar del grupo. El nombre para mostrar no debe ser único y puede contener cualquier carácter Unicode hasta una longitud máxima de 1024.
enableAutoScale		boolean	Si el tamaño del grupo se debe ajustar automáticamente con el tiempo. Si es false, se debe especificar al menos uno de targetDedicatedNodes y targetLowPriorityNodes. Si es true, se requiere la propiedad autoScaleFormula y el grupo cambia automáticamente el tamaño según la fórmula. El valor predeterminado es false.
enableInterNodeCommunication		boolean	Si el grupo permite la comunicación directa entre los nodos de proceso. Habilitar la comunicación entre nodos limita el tamaño máximo del grupo debido a 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.
metadata		MetadataItem[]	Lista de pares nombre-valor asociados al grupo como metadatos. El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario.
mountConfiguration		MountConfiguration[]	Monte el almacenamiento mediante el sistema de archivos especificado durante toda la duración del grupo. Monte el almacenamiento mediante el sistema de archivos basado en Azure fileshare, NFS, CIFS o Blobfuse.
networkConfiguration		NetworkConfiguration	Configuración de red para el grupo. Configuración de red de un grupo.
resizeTimeout		string	Tiempo de espera para la asignación de nodos de proceso al grupo. 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 va a llamar directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).
resourceTags		object	Etiquetas especificadas por el usuario asociadas al grupo. Etiquetas definidas por el usuario que se asociarán al grupo de Azure Batch. Cuando se especifica, estas etiquetas se propagan a los recursos de Azure de respaldo asociados al grupo. Esta propiedad solo se puede especificar cuando se creó la cuenta de Batch con la propiedad poolAllocationMode establecida en "UserSubscription".
startTask		StartTask	Tarea especificada para ejecutarse 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.
targetDedicatedNodes		integer	Número deseado de nodos de proceso dedicados en el grupo. Esta propiedad no se debe especificar si enableAutoScale está establecido en true. Si enableAutoScale está establecido en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.
targetLowPriorityNodes		integer	Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo. Esta propiedad no se debe especificar si enableAutoScale está establecido en true. Si enableAutoScale está establecido en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.
targetNodeCommunicationMode		NodeCommunicationMode	Modo de comunicación de nodo deseado para el grupo. Si se omite, el valor predeterminado es Default.
taskSchedulingPolicy		TaskSchedulingPolicy	Cómo se distribuyen las tareas entre nodos de proceso en un grupo. Si no se especifica, el valor predeterminado se distribuye.
taskSlotsPerNode		integer	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.
userAccounts		UserAccount[]	Lista de cuentas de usuario que se van a crear en cada nodo de proceso del grupo.
virtualMachineConfiguration		VirtualMachineConfiguration	Configuración de la máquina virtual para el grupo. Esta propiedad y cloudServiceConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades.

Respuestas

Nombre	Tipo	Description
201 Created		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

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

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

Add a CloudServiceConfiguration pool

Add a pool with accelerated networking

Add a pool with mount drive specified

Add a pool with SecurityProfile

Add a simple pool with resourceTags

Add a VirtualMachineConfiguration pool

Add a VirtualMachineConfiguration pool with containers

Add a VirtualMachineConfiguration pool with extensions

Add a VirtualMachineConfiguration pool with OS disk

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Add a CloudServiceConfiguration pool

Sample Request

HTTP

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



{
  "id": "poolId",
  "vmSize": "small",
  "cloudServiceConfiguration": {
    "osFamily": "4"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Status code:

201

Add a pool with accelerated networking

Sample Request

HTTP

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



{
  "id": "mypool01",
  "vmSize": "Standard_D1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2,
  "networkConfiguration": {
    "enableAcceleratedNetworking": true
  }
}

Sample Response

Status code:

201

Add a pool with mount drive specified

Sample Request

HTTP

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


{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "mountConfiguration": [
    {
      "azureBlobFileSystemConfiguration": {
        "accountName": "accountName",
        "containerName": "blobContainerName",
        "accountKey": "accountKey",
        "relativeMountPath": "bfusepath"
      }
    },
    {
      "azureFileShareConfiguration": {
        "accountName": "accountName",
        "azureFileUrl": "https://myaccount.file.core.windows.net/fileshare",
        "accountKey": "accountKey",
        "relativeMountPath": "filesharepath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "nfsMountConfiguration": {
        "source": "somesource nfs url",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    },
    {
      "cifsMountConfiguration": {
        "username": "accountName",
        "password": "password",
        "source": "//myaccount.file.core.windows.net/file",
        "relativeMountPath": "mountpath",
        "mountOptions": "mount options ver=1.0"
      }
    }
  ],
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Status code:

201

Add a pool with SecurityProfile

Sample Request

HTTP

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



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04",
    "securityProfile": {
      "securityType": "trustedLaunch",
      "encryptionAtHost": true,
      "uefiSettings": {
        "secureBootEnabled": false
      }
    }
  },
  "targetDedicatedNodes": 1
}

Sample Response

Status code:

201

Add a simple pool with resourceTags

Sample Request

HTTP

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



{
  "id": "mypool001",
  "vmSize": "STANDARD_DC2s_V2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "UbuntuServer",
      "sku": "18_04-lts-gen2",
      "version": "latest"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 18.04"
  },
  "targetDedicatedNodes": 1,
  "resourceTags": {
    "TagName1": "TagValue1",
    "TagName2": "TagValue2"
  }
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool

Sample Request

HTTP

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



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with containers

Sample Request

HTTP

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



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "120_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "containerConfiguration": {
      "type": "dockerCompatible",
      "containerImageNames": [
        "busybox"
      ]
    }
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with extensions

Sample Request

HTTP

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



{
  "id": "pool2",
  "vmSize": "standard_a1",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04",
    "extensions": [
      {
        "name": "batchextension1",
        "type": "KeyVaultForLinux",
        "publisher": "Microsoft.Azure.KeyVault",
        "typeHandlerVersion": "2.0",
        "autoUpgradeMinorVersion": true,
        "enableAutomaticUpgrade": true,
        "settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
      }
    ]
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 5,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 3,
  "taskSchedulingPolicy": {
    "nodeFillType": "spread"
  },
  "enableAutoScale": false,
  "enableInterNodeCommunication": true,
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ],
  "targetNodeCommunicationMode": "simplified"
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with OS disk

Sample Request

HTTP

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



{
  "id": "mypool001",
  "vmSize": "standard_d2s_v3",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "Canonical",
      "offer": "0001-com-ubuntu-server-focal",
      "sku": "20_04-lts"
    },
    "osDisk": {
      "diskSizeGB": 100,
      "managedDisk": {
        "storageAccountType": "standardssd_lrs"
      },
      "caching": "readwrite",
      "ephemeralOSDiskSettings": {
        "placement": "CacheDisk"
      }
    },
    "nodeAgentSKUId": "batch.node.ubuntu 20.04"
  },
  "resizeTimeout": "PT15M",
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0,
  "taskSlotsPerNode": 1,
  "enableAutoScale": false
}

Sample Response

Status code:

201

Add a VirtualMachineConfiguration pool with ServiceArtifactReference

Sample Request

HTTP

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



{
  "id": "mypool002",
  "vmSize": "Standard_A1_v2",
  "virtualMachineConfiguration": {
    "imageReference": {
      "publisher": "MicrosoftWindowsServer",
      "offer": "WindowsServer",
      "sku": "2016-datacenter-smalldisk",
      "version": "latest"
    },
    "windowsConfiguration": {
      "enableAutomaticUpdates": false
    },
    "serviceArtifactReference": {
      "id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
    },
    "nodeAgentSKUId": "batch.node.windows amd64"
  },
  "targetDedicatedNodes": 2
}

Sample Response

Status code:

201

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.
AzureBlobFileSystemConfiguration	Información usada para conectarse a un contenedor de Azure Storage mediante Blobfuse.
AzureFileShareConfiguration	Información usada para conectarse a un recurso compartido de archivos de Azure.
BatchError	Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail	Elemento de información adicional incluida en una respuesta de error Azure Batch.
CachingType	Tipo de almacenamiento en caché que se va a habilitar para el disco.
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.
CIFSMountConfiguration	Información utilizada para conectarse a un sistema de archivos CIFS.
CloudServiceConfiguration	Configuración de nodos de proceso en un grupo basado en la plataforma de Azure Cloud Services.
ComputeNodeFillType	Cómo se distribuyen las tareas entre nodos de proceso en un grupo.
ComputeNodeIdentityReference	Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso.
ContainerConfiguration	Configuración de grupos habilitados para contenedores.
ContainerRegistry	Un registro de contenedor privado.
ContainerType	Tecnología de contenedor que se va a usar.
ContainerWorkingDirectory	La ubicación del directorio de trabajo task del contenedor.
DataDisk	Configuración que usarán los discos de datos asociados a los nodos de proceso del grupo. Cuando use discos de datos conectados, debe montar y dar formato a los discos desde una máquina virtual para usarlos.
DiffDiskPlacement	Especifica la ubicación del disco efímero para el disco del sistema operativo para todos los nodos de proceso (VM) del grupo.
DiffDiskSettings	Especifica la configuración de disco efímera para el disco del sistema operativo usado por el nodo de proceso (VM).
DiskEncryptionConfiguration	La configuración de cifrado de disco aplicada en los nodos de proceso del grupo. La configuración de cifrado de disco no se admite en el grupo de Linux creado con la imagen de Azure Compute Gallery.
DiskEncryptionTarget	La lista de destinos de disco de Batch Service cifrará en el nodo de proceso.
DynamicVNetAssignmentScope	Ámbito de la asignación de red virtual dinámica.
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.
ImageReference	Referencia a una imagen de Azure Virtual Machines Marketplace o a una imagen de Azure Compute Gallery. Para obtener la lista de todas las referencias de imagen Azure Marketplace comprobadas por Azure Batch, consulte la operación "Enumerar imágenes admitidas".
InboundEndpointProtocol	Protocolo del punto de conexión.
InboundNATPool	Un grupo NAT de entrada que se puede usar para abordar puertos específicos en nodos de proceso de un grupo de Batch externamente.
IPAddressProvisioningType	Tipo de aprovisionamiento para direcciones IP públicas para el grupo.
LinuxUserConfiguration	Propiedades usadas para crear una cuenta de usuario en un nodo de proceso de Linux.
LoginMode	Modo de inicio de sesión para el usuario
ManagedDisk
MetadataItem	Un par nombre-valor asociado a un recurso de servicio de Batch.
MountConfiguration	Sistema de archivos que se va a montar en cada nodo.
NetworkConfiguration	Configuración de red de un grupo.
NetworkSecurityGroupRule	Una regla de grupo de seguridad de red que se va a aplicar a un punto de conexión de entrada.
NetworkSecurityGroupRuleAccess	Acción que se debe realizar para una dirección IP, un intervalo de subred o una etiqueta especificados.
NFSMountConfiguration	Información usada para conectarse a un sistema de archivos NFS.
NodeCommunicationMode	Determina cómo se comunica un grupo con el servicio Batch.
NodePlacementConfiguration	Configuración de ubicación del nodo para un grupo.
NodePlacementPolicyType	Directiva de selección de ubicación para asignar nodos en el grupo.
OSDisk	Configuración del disco del sistema operativo del nodo de proceso (VM).
PoolAddParameter	Un grupo en el servicio Azure Batch que se va a agregar.
PoolEndpointConfiguration	Configuración del punto de conexión de un grupo.
PublicIPAddressConfiguration	Configuración de la dirección IP pública de la configuración de red de un grupo.
ResourceFile	Un único archivo o varios archivos que se van a descargar en un nodo de proceso.
SecurityProfile	Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales.
SecurityTypes	Especifica el SecurityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings.
ServiceArtifactReference	Especifica el identificador de referencia del artefacto de servicio que se usa para establecer la misma versión de imagen para todas las máquinas virtuales del conjunto de escalado cuando se usa la versión de imagen "más reciente".
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 la imagen inicial del nodo de ejecución.
StorageAccountType	El tipo de cuenta de almacenamiento que se usa para crear discos de datos o disco del sistema operativo.
TaskContainerSettings	Configuración del contenedor de una tarea.
TaskSchedulingPolicy	Especifica cómo se deben distribuir las tareas entre nodos de proceso.
UefiSettings	Especifica la configuración de seguridad como el arranque seguro y vTPM que se usa al crear la máquina virtual.
UserAccount	Propiedades usadas para crear un usuario que se usa para ejecutar tareas en un nodo de proceso de Azure Batch.
UserIdentity	Definición de la identidad de usuario con la que se ejecuta la tarea.
VirtualMachineConfiguration	Configuración de nodos de proceso en un grupo basado en la infraestructura de Azure Virtual Machines.
VMExtension	Configuración de extensiones de máquina virtual.
WindowsConfiguration	Configuración del sistema operativo Windows que se va a aplicar a la máquina virtual.
WindowsUserConfiguration	Propiedades usadas para crear una cuenta de usuario en un nodo de proceso de Windows.

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 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 que no deben ser accesibles por tareas normales, pero deben ser accesibles por StartTasks.

AzureBlobFileSystemConfiguration

Información usada para conectarse a un contenedor de Azure Storage mediante Blobfuse.

Nombre	Tipo	Description
accountKey	string	Clave de la cuenta de Azure Storage. Esta propiedad es mutuamente excluyente tanto con sasKey como con la identidad; exactamente uno debe especificarse.
accountName	string	El nombre de la cuenta de Azure Storage.
blobfuseOptions	string	Opciones de línea de comandos adicionales para pasar al comando mount. Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux.
containerName	string	Nombre del contenedor de Azure Blob Storage.
identityReference	ComputeNodeIdentityReference	Referencia a la identidad asignada por el usuario que se va a usar para acceder a containerName. Esta propiedad es mutuamente excluyente tanto con accountKey como con sasKey; exactamente uno debe especificarse.
relativeMountPath	string	Ruta de acceso relativa en el nodo de proceso donde se montará el sistema de archivos. Todos los sistemas de archivos se montan en relación con el directorio de montajes de Batch, accesibles a través de la variable de entorno AZ_BATCH_NODE_MOUNTS_DIR.
sasKey	string	Token de SAS de Azure Storage. Esta propiedad es mutuamente excluyente tanto con accountKey como con la identidad; exactamente uno debe especificarse.

AzureFileShareConfiguration

Información usada para conectarse a un recurso compartido de archivos de Azure.

Nombre	Tipo	Description
accountKey	string	clave de la cuenta de Azure Storage.
accountName	string	El nombre de la cuenta de Azure Storage.
azureFileUrl	string	Dirección URL de Azure Files. Tiene el formato "https://{account}.file.core.windows.net/".
mountOptions	string	Opciones de línea de comandos adicionales para pasar al comando mount. Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux.
relativeMountPath	string	Ruta de acceso relativa en el nodo de proceso donde se montará el sistema de archivos. Todos los sistemas de archivos se montan en relación con el directorio de montajes de Batch, accesibles a través de la variable de entorno AZ_BATCH_NODE_MOUNTS_DIR.

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.

CachingType

Tipo de almacenamiento en caché que se va a habilitar para el disco.

Nombre	Tipo	Description
none	string	El modo de almacenamiento en caché del disco no está habilitado.
readonly	string	El modo de almacenamiento en caché del disco es de solo lectura.
readwrite	string	El modo de almacenamiento en caché del disco es de lectura y escritura.

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

CIFSMountConfiguration

Información utilizada para conectarse a un sistema de archivos CIFS.

Nombre	Tipo	Description
mountOptions	string	Opciones de línea de comandos adicionales para pasar al comando mount. Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux.
password	string	Contraseña que se va a usar para la autenticación en el sistema de archivos CIFS.
relativeMountPath	string	Ruta de acceso relativa en el nodo de proceso donde se montará el sistema de archivos. Todos los sistemas de archivos se montan en relación con el directorio de montajes de Batch, accesibles a través de la variable de entorno AZ_BATCH_NODE_MOUNTS_DIR.
source	string	URI del sistema de archivos que se va a montar.
username	string	El usuario que se va a usar para la autenticación en el sistema de archivos CIFS.

CloudServiceConfiguration

Configuración de nodos de proceso en un grupo basado en la plataforma de Azure Cloud Services.

Nombre	Tipo	Description
osFamily	string	La familia de so invitado de Azure que se va a instalar en las máquinas virtuales del grupo. 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).
osVersion	string	La versión del sistema operativo invitado de Azure que se va a instalar en las máquinas virtuales del grupo. El valor predeterminado es * que especifica la versión más reciente del sistema operativo para la familia de sistema operativo especificada.

ComputeNodeFillType

Cómo se distribuyen las tareas entre nodos de proceso en un grupo.

Nombre	Tipo	Description
pack	string	Se deben asignar tantas tareas como sea posible (taskSlotsPerNode) a cada nodo de proceso del grupo antes de que se asignen tareas al siguiente nodo de proceso del grupo.
spread	string	Las tareas se deben asignar uniformemente en todos los nodos de proceso del grupo.

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.

ContainerConfiguration

Configuración de grupos habilitados para contenedores.

Nombre	Tipo	Description
containerImageNames	string[]	Colección de nombres de imagen de contenedor. Se trata de la referencia de imagen completa, como se especificaría en "docker pull". Se obtendrá una imagen del registro de Docker predeterminado, a menos que image esté completa con un registro alternativo.
containerRegistries	ContainerRegistry[]	Registros privados adicionales de los que se pueden extraer contenedores. Si se debe descargar alguna imagen de un registro privado que requiera credenciales, esas credenciales deben proporcionarse aquí.
type	ContainerType	Tecnología de contenedor que se va a usar.

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.

ContainerType

Tecnología de contenedor que se va a usar.

Nombre	Tipo	Description
criCompatible	string	Se usará una tecnología basada en CRI para lanzar los contenedores.
dockerCompatible	string	Se usará una tecnología de contenedor compatible con Docker para iniciar los contenedores.

ContainerWorkingDirectory

La ubicación del directorio de trabajo task del 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 task del servicio Batch estándar, que contendrá los archivos de recursos de tarea rellenados por Batch.

DataDisk

Configuración que usarán los discos de datos asociados a los nodos de proceso del grupo. Cuando use discos de datos conectados, debe montar y dar formato a los discos desde una máquina virtual para usarlos.

Nombre	Tipo	Description
caching	CachingType	Tipo de almacenamiento en caché que se va a habilitar para los discos de datos. El valor predeterminado para el almacenamiento en caché es readwrite. Para obtener información sobre las opciones de almacenamiento en caché, vea: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	Tamaño inicial del disco en gigabytes.
lun	integer	Número de unidad lógica. El lun se usa para identificar de forma única cada disco de datos. Si conecta varios discos, cada uno debe tener un lun distinto. El valor debe estar comprendido entre 0 y 63, ambos incluidos.
storageAccountType	StorageAccountType	Tipo de cuenta de almacenamiento que se va a usar para el disco de datos. Si se omite, el valor predeterminado es "standard_lrs".

DiffDiskPlacement

Especifica la ubicación del disco efímero para el disco del sistema operativo para todos los nodos de proceso (VM) del grupo.

Nombre	Tipo	Description
CacheDisk	string	El disco del sistema operativo efímero se almacena en la memoria caché de la máquina virtual.

DiffDiskSettings

Especifica la configuración de disco efímera para el disco del sistema operativo usado por el nodo de proceso (VM).

Nombre	Tipo	Description
placement	DiffDiskPlacement	Especifica la ubicación del disco efímero para el disco del sistema operativo para todas las máquinas virtuales del grupo. El usuario puede usar esta propiedad en la solicitud para elegir la ubicación, por ejemplo, el espacio en disco de caché para el aprovisionamiento de discos del sistema operativo efímero. Para obtener más información sobre los requisitos de tamaño de disco del sistema operativo efímero, consulte Requisitos de tamaño de disco del sistema operativo efímero para máquinas virtuales Windows en https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements y máquinas virtuales Linux en https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

DiskEncryptionConfiguration

La configuración de cifrado de disco aplicada en los nodos de proceso del grupo. La configuración de cifrado de disco no se admite en el grupo de Linux creado con la imagen de Azure Compute Gallery.

Nombre	Tipo	Description
targets	DiskEncryptionTarget[]	La lista de destinos de disco que el servicio Batch cifrará en el nodo de proceso. 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 el grupo de Windows, debe especificarse "OsDisk" y "TemporaryDisk".

DiskEncryptionTarget

La lista de destinos de disco de Batch Service cifrará en el nodo de proceso.

Nombre	Tipo	Description
osdisk	string	El disco del sistema operativo en el nodo de proceso está cifrado.
temporarydisk	string	El disco temporal del nodo de proceso está cifrado. En Linux, este cifrado se aplica a otras particiones (como las de discos de datos montados) cuando se produce el cifrado en tiempo de arranque.

DynamicVNetAssignmentScope

Ámbito de la asignación de red virtual dinámica.

Nombre	Tipo	Description
job	string	La asignación de red virtual dinámica se realiza por trabajo.
none	string	No hay ninguna asignación de red virtual dinámica habilitada.

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.

ImageReference

Referencia a una imagen de Azure Virtual Machines Marketplace o a una imagen de Azure Compute Gallery. Para obtener la lista de todas las referencias de imagen Azure Marketplace comprobadas por Azure Batch, consulte la operación "Enumerar imágenes admitidas".

Nombre	Tipo	Description
exactVersion	string	Versión específica de la imagen de plataforma o imagen de Marketplace que se usa para crear el nodo. Este campo de solo lectura difiere de "version" solo si el valor especificado para "version" cuando se creó el grupo era "latest".
offer	string	Tipo de oferta de la imagen de Azure Virtual Machines Marketplace. Por ejemplo, UbuntuServer o WindowsServer.
publisher	string	Publicador de la imagen de Azure Virtual Machines Marketplace. Por ejemplo, Canonical o MicrosoftWindowsServer.
sku	string	SKU de la imagen de Azure Virtual Machines Marketplace. Por ejemplo, 18.04-LTS o 2019-Datacenter.
version	string	Versión de la imagen de Azure Virtual Machines Marketplace. Se puede especificar un valor de "latest" para seleccionar la versión más reciente de una imagen. Si se omite, el valor predeterminado es "latest".
virtualMachineImageId	string	Identificador de recurso de ARM de la imagen de Azure Compute Gallery. Los nodos de proceso del grupo se crearán con este identificador de imagen. Se trata del formulario /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} o /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} para la versión de imagen más reciente. Esta propiedad es mutuamente excluyente con otras propiedades ImageReference. La imagen de Azure Compute Gallery debe tener réplicas en la misma región y debe estar en la misma suscripción que la cuenta de Azure Batch. Si la versión de la imagen no se especifica en imageId, se usará la versión más reciente. Para obtener información sobre la configuración del firewall para que el agente de Batch Compute Node se comunique con el servicio Batch, consulte https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

Protocolo del punto de conexión.

Nombre	Tipo	Description
tcp	string	Use TCP para el punto de conexión.
udp	string	Use UDP para el punto de conexión.

InboundNATPool

Un grupo NAT de entrada que se puede usar para abordar puertos específicos en nodos de proceso de un grupo de Batch externamente.

Nombre	Tipo	Description
backendPort	integer	Número de puerto en el nodo de ejecución. Debe ser único dentro de un grupo de lotes. Los valores aceptables están comprendidos entre 1 y 65535, excepto 22, 3389, 29876 y 29877, ya que están reservados. Si se proporcionan valores reservados, se produce un error en la solicitud con el código de estado HTTP 400.
frontendPortRangeEnd	integer	El último número de puerto del intervalo de puertos externos que se usarán para proporcionar acceso entrante a backendPort en nodos de proceso individuales. Los valores aceptables oscilan entre 1 y 65534, excepto los puertos de 50000 a 55000 reservados por el servicio Batch. Todos los intervalos de un grupo deben ser distintos y no se pueden superponer. Cada intervalo debe contener al menos 40 puertos. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400.
frontendPortRangeStart	integer	El primer número de puerto del intervalo de puertos externos que se usarán para proporcionar acceso entrante a backendPort en nodos de proceso individuales. Los valores aceptables oscilan entre 1 y 65534, excepto los puertos de 50000 a 55000 que están reservados. Todos los intervalos de un grupo deben ser distintos y no se pueden superponer. Cada intervalo debe contener al menos 40 puertos. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400.
name	string	Nombre del punto de conexión. El nombre debe ser único dentro de un grupo de lotes, puede contener letras, números, caracteres de subrayado, puntos y guiones. Los nombres deben comenzar con una letra o un número, deben terminar con una letra, un número o un carácter de subrayado, y no pueden superar los 77 caracteres. Si se proporcionan valores no válidos, se produce un error en la solicitud con el código de estado HTTP 400.
networkSecurityGroupRules	NetworkSecurityGroupRule[]	Lista de reglas de grupo de seguridad de red que se aplicarán al punto de conexión. El número máximo de reglas que se pueden especificar en todos los puntos de conexión de un grupo de lotes es 25. Si no se especifican reglas de grupo de seguridad de red, se creará una regla predeterminada para permitir el acceso entrante a backendPort especificado. Si se supera el número máximo de reglas de grupo de seguridad de red, se produce un error en la solicitud con el código de estado HTTP 400.
protocol	InboundEndpointProtocol	Protocolo del punto de conexión.

IPAddressProvisioningType

Tipo de aprovisionamiento para direcciones IP públicas para el grupo.

Nombre	Tipo	Description
batchmanaged	string	Batch creará y administrará una dirección IP pública. Puede haber varias direcciones IP públicas en función del tamaño del grupo.
nopublicipaddresses	string	No se creará ninguna dirección IP pública.
usermanaged	string	El usuario proporciona direcciones IP públicas y se usará para aprovisionar los nodos de proceso.

LinuxUserConfiguration

Propiedades usadas para crear una cuenta de usuario en un nodo de proceso de Linux.

Nombre	Tipo	Description
gid	integer	Identificador de grupo de la cuenta de usuario. Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica el sistema operativo subyacente, elige el gid.
sshPrivateKey	string	Clave privada SSH para la cuenta de usuario. La clave privada no debe estar protegida con contraseña. La clave privada se usa para configurar automáticamente la autenticación basada en clave asimétrica para SSH entre nodos de proceso en un grupo de Linux cuando la propiedad enableInterNodeCommunication del grupo es true (se omite si enableInterNodeCommunication es false). Para ello, coloca el par de claves en el directorio .ssh del usuario. Si no se especifica, SSH sin contraseña no está configurado entre nodos de ejecución (no se realiza ninguna modificación del directorio .ssh del usuario).
uid	integer	Identificador de usuario de la cuenta de usuario. Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica el sistema operativo subyacente, elige el uid.

LoginMode

Modo de inicio de sesión para el usuario

Nombre	Tipo	Description
batch	string	Modo de inicio de sesión de Win32 LOGON32_LOGON_BATCH. El modo de inicio de sesión por lotes se recomienda para procesos paralelos de larga duración.
interactive	string	Modo de inicio de sesión de Win32 LOGON32_LOGON_INTERACTIVE. UAC está habilitado en grupos de Windows VirtualMachineConfiguration. Si esta opción se usa con una identidad de usuario con privilegios elevados en un grupo de Windows VirtualMachineConfiguration, la sesión de usuario no se elevará a menos que la aplicación ejecutada por la línea de comandos task esté configurada para requerir siempre privilegios administrativos o para requerir siempre el privilegio máximo.

ManagedDisk

Nombre	Tipo	Description
storageAccountType	StorageAccountType	Tipo de cuenta de almacenamiento para disco administrado.

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.

MountConfiguration

Sistema de archivos que se va a montar en cada nodo.

Nombre	Tipo	Description
azureBlobFileSystemConfiguration	AzureBlobFileSystemConfiguration	Contenedor de Azure Storage que se va a montar mediante BLOB FUSE en cada nodo. Esta propiedad es mutuamente excluyente con todas las demás propiedades.
azureFileShareConfiguration	AzureFileShareConfiguration	Recurso compartido de archivos de Azure que se va a montar en cada nodo. Esta propiedad es mutuamente excluyente con todas las demás propiedades.
cifsMountConfiguration	CIFSMountConfiguration	Sistema de archivos CIFS/SMB que se va a montar en cada nodo. Esta propiedad es mutuamente excluyente con todas las demás propiedades.
nfsMountConfiguration	NFSMountConfiguration	Sistema de archivos NFS que se va a montar en cada nodo. Esta propiedad es mutuamente excluyente con todas las demás propiedades.

NetworkConfiguration

Configuración de red de un grupo.

Nombre	Tipo	Description
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	Ámbito de asignación de red virtual dinámica.
enableAcceleratedNetworking	boolean	Si este grupo debe habilitar las redes aceleradas. Las redes aceleradas permiten la virtualización de E/S raíz única (SR-IOV) a una máquina virtual, lo que puede dar lugar a un mejor rendimiento de red. Para más información, consulte https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	PoolEndpointConfiguration	La configuración de los puntos de conexión en nodos de proceso en el grupo de Batch. La configuración del punto de conexión del grupo solo se admite en Grupos con la propiedad virtualMachineConfiguration.
publicIPAddressConfiguration	PublicIPAddressConfiguration	Configuración de IP públicaAddress para nodos de proceso en el grupo de lotes. La propiedad de configuración de IP pública solo se admite en Grupos con la propiedad virtualMachineConfiguration.
subnetId	string	Identificador de recursos arm de la subred de red virtual a la que se unirán los nodos de proceso del grupo. Tiene el formato /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. La red virtual debe estar en la misma región y suscripción que la cuenta de Azure Batch. La subred especificada debe tener suficientes direcciones IP libres para acomodar el número de nodos de proceso en el grupo. Si la subred no tiene suficientes direcciones IP libres, el grupo asignará parcialmente nodos y se producirá un error de cambio de tamaño. La entidad de servicio "MicrosoftAzureBatch" debe tener el rol "Colaborador de máquina virtual clásica" Role-Based Access Control (RBAC) para la red virtual especificada. La subred especificada debe permitir la comunicación desde el servicio Azure Batch para poder programar tareas en los nodos. Esto se puede comprobar comprobando si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado. Si un grupo de seguridad de red deniega la comunicación con los nodos de la subred especificada, el servicio Batch establecerá el estado de los nodos de proceso en inutilizables. En el caso de los grupos creados con virtualMachineConfiguration, solo se admiten redes virtuales arm ("Microsoft.Network/virtualNetworks") pero para los grupos creados con cloudServiceConfiguration se admiten las redes virtuales de ARM y clásicas. Si la red virtual especificada tiene grupos de seguridad de red (NSG) asociados, será preciso habilitar varios puertos del sistema reservados para las comunicaciones entrantes. Para los grupos creados con una configuración de máquina virtual, habilite los puertos 29876 y 29877, así como el puerto 22 para Linux y el puerto 3389 para Windows. Para los grupos creados con una configuración de servicio en la nube, habilite los puertos 10100, 20100 y 30100. Habilite también las conexiones salientes a Azure Storage en el puerto 443. Para más información, consulte: https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Una regla de grupo de seguridad de red que se va a aplicar a un punto de conexión de entrada.

Nombre	Tipo	Description
access	NetworkSecurityGroupRuleAccess	Acción que se debe realizar para una dirección IP, un intervalo de subred o una etiqueta especificados.
priority	integer	Prioridad de esta regla. Las prioridades dentro de un grupo deben ser únicas y se evalúan en orden de prioridad. Cuanto menor sea el número de prioridad, mayor será la prioridad de la regla. Por ejemplo, se podrían especificar reglas con números de orden de 150, 250 y 350. La regla con el número de orden de 150 tiene prioridad sobre la regla que tiene un orden de 250. Las prioridades permitidas son de 150 a 4096. Si se proporcionan valores reservados o duplicados, se produce un error en la solicitud con el código de estado HTTP 400.
sourceAddressPrefix	string	Prefijo o etiqueta de dirección de origen que debe coincidir con la regla. Los valores válidos son una sola dirección IP (es decir, 10.10.10.10), subred IP (es decir, 192.168.1.0/24), etiqueta predeterminada o * (para todas las direcciones). Si se proporcionan otros valores, se produce un error en la solicitud con el código de estado HTTP 400.
sourcePortRanges	string[]	Intervalos de puertos de origen que se van a coincidir con la regla. Los valores válidos son "" (para todos los puertos 0 - 65535), un puerto específico (es decir, 22) o un intervalo de puertos (es decir, 100-200). Los puertos deben estar en el intervalo de 0 a 65535. Cada entrada de esta colección no debe superponerse a ninguna otra entrada (ya sea un intervalo o un puerto individual). Si se proporcionan otros valores, se produce un error en la solicitud con el código de estado HTTP 400. El valor predeterminado es "".

NetworkSecurityGroupRuleAccess

Acción que se debe realizar para una dirección IP, un intervalo de subred o una etiqueta especificados.

Nombre	Tipo	Description
allow	string	Permita el acceso.
deny	string	Deniegue el acceso.

NFSMountConfiguration

Información usada para conectarse a un sistema de archivos NFS.

Nombre	Tipo	Description
mountOptions	string	Opciones de línea de comandos adicionales para pasar al comando mount. Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux.
relativeMountPath	string	Ruta de acceso relativa en el nodo de proceso donde se montará el sistema de archivos. Todos los sistemas de archivos se montan en relación con el directorio de montajes de Batch, accesibles a través de la variable de entorno AZ_BATCH_NODE_MOUNTS_DIR.
source	string	URI del sistema de archivos que se va a montar.

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.

NodePlacementConfiguration

Configuración de ubicación del nodo para un grupo.

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

NodePlacementPolicyType

Directiva de selección de ubicación para asignar nodos en el grupo.

Nombre	Tipo	Description
regional	string	Todos los nodos del grupo se asignarán en la misma región.
zonal	string	Los nodos del grupo se distribuirán entre diferentes zonas de disponibilidad con el mejor equilibrio de esfuerzo.

OSDisk

Configuración del disco del sistema operativo del nodo de proceso (VM).

Nombre	Tipo	Description
caching	CachingType	Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None, ReadOnly, ReadWrite. Los valores predeterminados son: None para standard storage. ReadOnly para Premium Storage. El valor predeterminado para el almacenamiento en caché es none. Para obtener información sobre las opciones de almacenamiento en caché, vea: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	Tamaño inicial del disco en GB al crear un nuevo disco del sistema operativo.
ephemeralOSDiskSettings	DiffDiskSettings	Especifica la configuración de disco efímero para el disco del sistema operativo usado por el nodo de proceso (VM).
managedDisk	ManagedDisk	Parámetros de disco administrado.
writeAcceleratorEnabled	boolean	Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco.

PoolAddParameter

Un grupo en el servicio Azure Batch que se va a agregar.

Nombre	Tipo	Description
applicationLicenses	string[]	La lista de licencias de aplicación que el servicio Batch pondrá a disposición en cada nodo de proceso del grupo. La lista de licencias de aplicación debe ser un subconjunto de licencias de aplicación de servicio batch disponibles. Si se solicita una licencia que no se admite, se producirá un error en la creación del grupo.
applicationPackageReferences	ApplicationPackageReference[]	Lista de paquetes que se van a instalar en cada nodo de proceso del grupo. 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}). 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 imágenes. Hay un máximo de 10 referencias de paquete en cualquier grupo determinado.
autoScaleEvaluationInterval	string	Intervalo de tiempo en el que ajustar automáticamente el tamaño del grupo según la fórmula de escalado automático. El valor predeterminado es 15 minutos. El valor mínimo y máximo son 5 minutos y 168 horas respectivamente. Si especifica un valor inferior a 5 minutos o superior a 168 horas, el servicio Batch devuelve un error; Si va a llamar directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).
autoScaleFormula	string	Fórmula para el número deseado de nodos de proceso en el grupo. Esta propiedad no debe especificarse si enableAutoScale está establecido en false. Es necesario si enableAutoScale está establecido en true. La fórmula se comprueba si hay validez antes de crear el grupo. Si la fórmula no es válida, el servicio Batch rechaza la solicitud con información detallada de error. Para obtener más información sobre cómo especificar esta fórmula, consulte "Escalado automático de nodos de proceso en un grupo de Azure Batch" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
certificateReferences	CertificateReference[]	Lista de certificados que se van a instalar en cada nodo de proceso 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.
cloudServiceConfiguration	CloudServiceConfiguration	Configuración del servicio en la nube para el grupo. Esta propiedad y virtualMachineConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades. Esta propiedad no se puede especificar si la cuenta de Batch se creó con su propiedad poolAllocationMode establecida en "UserSubscription".
displayName	string	Nombre para mostrar del grupo. El nombre para mostrar no debe ser único y puede contener cualquier carácter Unicode hasta una longitud máxima de 1024.
enableAutoScale	boolean	Si el tamaño del grupo se debe ajustar automáticamente con el tiempo. Si es false, se debe especificar al menos uno de targetDedicatedNodes y targetLowPriorityNodes. Si es true, se requiere la propiedad autoScaleFormula y el grupo cambia automáticamente el tamaño según la fórmula. El valor predeterminado es false.
enableInterNodeCommunication	boolean	Si el grupo permite la comunicación directa entre los nodos de proceso. Habilitar la comunicación entre nodos limita el tamaño máximo del grupo debido a 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.
id	string	Cadena que identifica de forma única el grupo dentro de la cuenta. 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 conserva mayúsculas de minúsculas y distingue mayúsculas de minúsculas (es decir, es posible que no tenga dos identificadores de grupo dentro de una cuenta que solo difieren por mayúsculas y minúsculas).
metadata	MetadataItem[]	Lista de pares nombre-valor asociados al grupo como metadatos. El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario.
mountConfiguration	MountConfiguration[]	Monte el almacenamiento mediante el sistema de archivos especificado durante toda la duración del grupo. Monte el almacenamiento mediante el sistema de archivos basado en Azure fileshare, NFS, CIFS o Blobfuse.
networkConfiguration	NetworkConfiguration	Configuración de red para el grupo. Configuración de red de un grupo.
resizeTimeout	string	Tiempo de espera para la asignación de nodos de proceso al grupo. 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 va a llamar directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta).
resourceTags	object	Etiquetas especificadas por el usuario asociadas al grupo. Etiquetas definidas por el usuario que se asociarán al grupo de Azure Batch. Cuando se especifica, estas etiquetas se propagan a los recursos de Azure de respaldo asociados al grupo. Esta propiedad solo se puede especificar cuando se creó la cuenta de Batch con la propiedad poolAllocationMode establecida en "UserSubscription".
startTask	StartTask	Tarea especificada para ejecutarse 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.
targetDedicatedNodes	integer	Número deseado de nodos de proceso dedicados en el grupo. Esta propiedad no se debe especificar si enableAutoScale está establecido en true. Si enableAutoScale está establecido en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.
targetLowPriorityNodes	integer	Número deseado de nodos de proceso de prioridad baja o de acceso puntual en el grupo. Esta propiedad no se debe especificar si enableAutoScale está establecido en true. Si enableAutoScale está establecido en false, debe establecer targetDedicatedNodes, targetLowPriorityNodes o ambos.
targetNodeCommunicationMode	NodeCommunicationMode	Modo de comunicación de nodo deseado para el grupo. Si se omite, el valor predeterminado es Default.
taskSchedulingPolicy	TaskSchedulingPolicy	Cómo se distribuyen las tareas entre nodos de proceso en un grupo. Si no se especifica, el valor predeterminado se distribuye.
taskSlotsPerNode	integer	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.
userAccounts	UserAccount[]	Lista de cuentas de usuario que se van a crear en cada nodo de proceso del grupo.
virtualMachineConfiguration	VirtualMachineConfiguration	Configuración de la máquina virtual para el grupo. Esta propiedad y cloudServiceConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades.
vmSize	string	Tamaño de las máquinas virtuales del grupo. Todas las máquinas virtuales de un grupo tienen el mismo tamaño. 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 mediante 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).

PoolEndpointConfiguration

Configuración del punto de conexión de un grupo.

Nombre	Tipo	Description
inboundNATPools	InboundNATPool[]	Lista de grupos NAT de entrada que se pueden usar para abordar puertos específicos en un nodo de proceso individual externamente. El número máximo de grupos NAT entrantes por grupo de lotes es 5. Si se supera el número máximo de grupos NAT de entrada, se produce un error en la solicitud con el código de estado HTTP 400. No se puede especificar si IPAddressProvisioningType es NoPublicIPAddresses.

PublicIPAddressConfiguration

Configuración de la dirección IP pública de la configuración de red de un grupo.

Nombre	Tipo	Description
ipAddressIds	string[]	Lista de direcciones IP públicas que usará el servicio Batch al aprovisionar nodos de proceso. El número de direcciones IP especificadas aquí limita el tamaño máximo del grupo: 100 nodos dedicados o 100 nodos de prioridad baja o puntual se puede asignar para cada dirección IP pública. Por ejemplo, un grupo que necesita 250 máquinas virtuales dedicadas necesitaría al menos 3 direcciones IP públicas especificadas. Cada elemento de esta colección tiene el formato: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.
provision	IPAddressProvisioningType	Tipo de aprovisionamiento para direcciones IP públicas para el grupo. El valor predeterminado es BatchManaged.

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ático. 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 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 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 ya asociada a los datos de entrada se conservará en su totalidad y 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 especificados 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 dentro de 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.

SecurityProfile

Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales.

Nombre	Tipo	Description
encryptionAtHost	boolean	El usuario puede usar esta propiedad en la solicitud para habilitar o deshabilitar el cifrado de host para la máquina virtual o el conjunto de escalado de máquinas virtuales. Esto habilitará el cifrado para todos los discos, incluido el disco resource/temp en el propio host.
securityType	SecurityTypes	Especifica el SecurityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings.
uefiSettings	UefiSettings	Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual.

SecurityTypes

Especifica el SecurityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings.

Nombre	Tipo	Description
trustedLaunch	string	El inicio seguro protege frente a técnicas de ataque persistentes y avanzadas.

ServiceArtifactReference

Especifica el identificador de referencia del artefacto de servicio que se usa para establecer la misma versión de imagen para todas las máquinas virtuales del conjunto de escalado cuando se usa la versión de imagen "más reciente".

Nombre	Tipo	Description
id	string	Identificador de referencia del artefacto de servicio de ServiceArtifactReference Identificador de referencia del artefacto de servicio en forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

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 la imagen inicial del nodo de ejecución.

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, 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).
containerSettings	TaskContainerSettings	La configuración del contenedor en el que se ejecuta StartTask. Cuando se especifica, todos los directorios se asignan 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 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, 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 en 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 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 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.

StorageAccountType

El tipo de cuenta de almacenamiento que se usa para crear discos de datos o disco del sistema operativo.

Nombre	Tipo	Description
premium_lrs	string	El disco de datos o el disco del sistema operativo deben usar el almacenamiento con redundancia local Premium.
standard_lrs	string	El disco de datos o disco del sistema operativo debe usar el almacenamiento con redundancia local estándar.
standardssd_lrs	string	El disco de datos o el disco del sistema operativo deben usar el almacenamiento con redundancia local ssd estándar.

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

TaskSchedulingPolicy

Especifica cómo se deben distribuir las tareas entre nodos de proceso.

Nombre	Tipo	Description
nodeFillType	ComputeNodeFillType	Cómo se distribuyen las tareas entre nodos de proceso en un grupo. Si no se especifica, el valor predeterminado se distribuye.

UefiSettings

Especifica la configuración de seguridad como el arranque seguro y vTPM que se usa al crear la máquina virtual.

Nombre	Tipo	Description
secureBootEnabled	boolean	Especifica si se debe habilitar el arranque seguro en la máquina virtual.
vTpmEnabled	boolean	Especifica si vTPM debe estar habilitado en la máquina virtual.

UserAccount

Propiedades usadas para crear un usuario que se usa para ejecutar tareas en un nodo de proceso de Azure Batch.

Nombre	Tipo	Description
elevationLevel	ElevationLevel	Nivel de elevación de la cuenta de usuario. El valor predeterminado es nonAdmin.
linuxUserConfiguration	LinuxUserConfiguration	Configuración de usuario específica de Linux para la cuenta de usuario. Esta propiedad se omite si se especifica en un grupo de Windows. Si no se especifica, el usuario se crea con las opciones predeterminadas.
name	string	Nombre de la cuenta de usuario. Los nombres pueden contener cualquier carácter Unicode hasta una longitud máxima de 20.
password	string	Contraseña de la cuenta de usuario.
windowsUserConfiguration	WindowsUserConfiguration	Configuración de usuario específica de Windows para la cuenta de usuario. Esta propiedad solo se puede especificar si el usuario está en un grupo de Windows. Si no se especifica y en un grupo de Windows, el usuario se crea con las opciones predeterminadas.

UserIdentity

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

Nombre	Tipo	Description
autoUser	AutoUserSpecification	Usuario automático con 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 con la que se ejecuta la tarea. Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos.

VirtualMachineConfiguration

Configuración de nodos de proceso en un grupo basado en la infraestructura de Azure Virtual Machines.

Nombre	Tipo	Description
containerConfiguration	ContainerConfiguration	Configuración del contenedor para el grupo. Si se especifica, la instalación se realiza en cada nodo de proceso del grupo para permitir que las tareas se ejecuten en contenedores. Todas las tareas normales y tareas del administrador de trabajos que se ejecutan en este grupo deben especificar la propiedad containerSettings y todas las demás tareas pueden especificarla.
dataDisks	DataDisk[]	La configuración de los discos de datos conectados a los nodos de proceso del grupo. Esta propiedad debe especificarse si los nodos de proceso del grupo deben tener discos de datos vacíos conectados a ellos. No se puede actualizar. Cada nodo de proceso obtiene su propio disco (el disco no es un recurso compartido de archivos). Los discos existentes no se pueden conectar, cada disco conectado está vacío. Cuando se quita el nodo de proceso del grupo, el disco y todos los datos asociados a él también se eliminan. El disco no tiene formato después de conectarse, debe tener formato antes de usarlo; para obtener más información, vea https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux y https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.
diskEncryptionConfiguration	DiskEncryptionConfiguration	Configuración de cifrado de disco para el grupo. Si se especifica, el cifrado se realiza en cada nodo del grupo durante el aprovisionamiento de nodos.
extensions	VMExtension[]	Extensión de máquina virtual para el grupo. Si se especifica, las extensiones mencionadas en esta configuración se instalarán en cada nodo.
imageReference	ImageReference	Referencia a la imagen de Azure Virtual Machines Marketplace o a la imagen de máquina virtual personalizada que se va a usar.
licenseType	string	Tipo de licencia local que se usará al implementar el sistema operativo. Esto solo se aplica a las imágenes que contienen el sistema operativo Windows y solo se deben usar cuando se mantienen licencias locales válidas para los nodos de proceso que se implementarán. Si se omite, no se aplica ningún descuento de licencia local. Los valores son: Windows_Server: la licencia local es para Windows Server. Windows_Client: la licencia local es para el cliente de Windows.
nodeAgentSKUId	string	SKU del agente de nodo de proceso de Batch que se va a aprovisionar en los nodos de proceso del grupo. 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 verificadas, consulte la operación "Enumeración de SKU de agente de nodo de proceso compatibles".
nodePlacementConfiguration	NodePlacementConfiguration	Configuración de ubicación del nodo para el grupo. Esta configuración especificará reglas sobre cómo se asignarán físicamente los nodos del grupo.
osDisk	OSDisk	Configuración del disco del sistema operativo de la máquina virtual.
securityProfile	SecurityProfile	Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales. Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales.
serviceArtifactReference	ServiceArtifactReference	Especifica el identificador de referencia del artefacto de servicio que se usa para establecer la misma versión de imagen para todas las máquinas virtuales del conjunto de escalado cuando se usa la versión de imagen "más reciente". Identificador de referencia del artefacto de servicio en forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}
windowsConfiguration	WindowsConfiguration	Configuración del sistema operativo Windows en la máquina virtual. Esta propiedad no se debe especificar si la propiedad imageReference especifica una imagen del sistema operativo Linux.

VMExtension

Configuración de extensiones de máquina virtual.

Nombre	Tipo	Description
autoUpgradeMinorVersion	boolean	Indica si la extensión debe usar una versión secundaria más reciente si hay una disponible en el momento de la implementación. Sin embargo, una vez implementada, la extensión no actualizará las versiones secundarias a menos que se vuelva a implementar, incluso con esta propiedad establecida en true.
enableAutomaticUpgrade	boolean	Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible.
name	string	Nombre de la extensión de máquina virtual.
protectedSettings	object	La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida.
provisionAfterExtensions	string[]	Colección de nombres de extensión. Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión.
publisher	string	Nombre del publicador de controladores de extensión.
settings	object	Configuración pública con formato JSON para la extensión.
type	string	El tipo de extensión.
typeHandlerVersion	string	Versión del controlador de script.

WindowsConfiguration

Configuración del sistema operativo Windows que se va a aplicar a la máquina virtual.

Nombre	Tipo	Description
enableAutomaticUpdates	boolean	Si las actualizaciones automáticas están habilitadas en la máquina virtual. Si se omite, el valor predeterminado es true.

WindowsUserConfiguration

Propiedades usadas para crear una cuenta de usuario en un nodo de proceso de Windows.

Nombre	Tipo	Description
loginMode	LoginMode	Modo de inicio de sesión del usuario El valor predeterminado de Los grupos de VirtualMachineConfiguration es "batch" y para los grupos de CloudServiceConfiguration es "interactivo".