Compartir a través de


Microsoft.Batch BatchAccounts/pools 2023-11-01

Definición de recursos de Bicep

El tipo de recurso batchAccounts/pools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Batch/batchAccounts/pools, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2023-11-01' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  name: 'string'
  properties: {
    applicationLicenses: [
      'string'
    ]
    applicationPackages: [
      {
        id: 'string'
        version: 'string'
      }
    ]
    certificates: [
      {
        id: 'string'
        storeLocation: 'string'
        storeName: 'string'
        visibility: [
          'string'
        ]
      }
    ]
    deploymentConfiguration: {
      cloudServiceConfiguration: {
        osFamily: 'string'
        osVersion: 'string'
      }
      virtualMachineConfiguration: {
        containerConfiguration: {
          containerImageNames: [
            'string'
          ]
          containerRegistries: [
            {
              identityReference: {
                resourceId: 'string'
              }
              password: 'string'
              registryServer: 'string'
              username: 'string'
            }
          ]
          type: 'string'
        }
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        diskEncryptionConfiguration: {
          targets: [
            'string'
          ]
        }
        extensions: [
          {
            autoUpgradeMinorVersion: bool
            enableAutomaticUpgrade: bool
            name: 'string'
            protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
            provisionAfterExtensions: [
              'string'
            ]
            publisher: 'string'
            settings: any(Azure.Bicep.Types.Concrete.AnyType)
            type: 'string'
            typeHandlerVersion: 'string'
          }
        ]
        imageReference: {
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        nodePlacementConfiguration: {
          policy: 'string'
        }
        osDisk: {
          caching: 'string'
          diskSizeGB: int
          ephemeralOSDiskSettings: {
            placement: 'CacheDisk'
          }
          managedDisk: {
            storageAccountType: 'string'
          }
          writeAcceleratorEnabled: bool
        }
        securityProfile: {
          encryptionAtHost: bool
          securityType: 'trustedLaunch'
          uefiSettings: {
            secureBootEnabled: bool
            vTpmEnabled: bool
          }
        }
        serviceArtifactReference: {
          id: 'string'
        }
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    mountConfiguration: [
      {
        azureBlobFileSystemConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          blobfuseOptions: 'string'
          containerName: 'string'
          identityReference: {
            resourceId: 'string'
          }
          relativeMountPath: 'string'
          sasKey: 'string'
        }
        azureFileShareConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          azureFileUrl: 'string'
          mountOptions: 'string'
          relativeMountPath: 'string'
        }
        cifsMountConfiguration: {
          mountOptions: 'string'
          password: 'string'
          relativeMountPath: 'string'
          source: 'string'
          userName: 'string'
        }
        nfsMountConfiguration: {
          mountOptions: 'string'
          relativeMountPath: 'string'
          source: 'string'
        }
      }
    ]
    networkConfiguration: {
      dynamicVnetAssignmentScope: 'string'
      enableAcceleratedNetworking: bool
      endpointConfiguration: {
        inboundNatPools: [
          {
            backendPort: int
            frontendPortRangeEnd: int
            frontendPortRangeStart: int
            name: 'string'
            networkSecurityGroupRules: [
              {
                access: 'string'
                priority: int
                sourceAddressPrefix: 'string'
                sourcePortRanges: [
                  'string'
                ]
              }
            ]
            protocol: 'string'
          }
        ]
      }
      publicIPAddressConfiguration: {
        ipAddressIds: [
          'string'
        ]
        provision: 'string'
      }
      subnetId: 'string'
    }
    resourceTags: {
      {customized property}: 'string'
    }
    scaleSettings: {
      autoScale: {
        evaluationInterval: 'string'
        formula: 'string'
      }
      fixedScale: {
        nodeDeallocationOption: 'string'
        resizeTimeout: 'string'
        targetDedicatedNodes: int
        targetLowPriorityNodes: int
      }
    }
    startTask: {
      commandLine: 'string'
      containerSettings: {
        containerRunOptions: 'string'
        imageName: 'string'
        registry: {
          identityReference: {
            resourceId: 'string'
          }
          password: 'string'
          registryServer: 'string'
          username: 'string'
        }
        workingDirectory: 'string'
      }
      environmentSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      maxTaskRetryCount: int
      resourceFiles: [
        {
          autoStorageContainerName: 'string'
          blobPrefix: 'string'
          fileMode: 'string'
          filePath: 'string'
          httpUrl: 'string'
          identityReference: {
            resourceId: 'string'
          }
          storageContainerUrl: 'string'
        }
      ]
      userIdentity: {
        autoUser: {
          elevationLevel: 'string'
          scope: 'string'
        }
        userName: 'string'
      }
      waitForSuccess: bool
    }
    targetNodeCommunicationMode: 'string'
    taskSchedulingPolicy: {
      nodeFillType: 'string'
    }
    taskSlotsPerNode: int
    userAccounts: [
      {
        elevationLevel: 'string'
        linuxUserConfiguration: {
          gid: int
          sshPrivateKey: 'string'
          uid: int
        }
        name: 'string'
        password: 'string'
        windowsUserConfiguration: {
          loginMode: 'string'
        }
      }
    ]
    vmSize: 'string'
  }
}

Valores de propiedad

ApplicationPackageReference

Nombre Descripción Valor
identificación Identificador del paquete de aplicación que se va a instalar. Debe estar dentro de la misma cuenta por lotes que el grupo. Puede ser una referencia a una versión específica o a la versión predeterminada si existe una. string (obligatorio)
Versión Si se omite 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. Si llama directamente a la API REST, el código de estado HTTP es 409. cuerda

AutoScaleSettings

Nombre Descripción Valor
evaluationInterval Si se omite, el valor predeterminado es 15 minutos (PT15M). cuerda
fórmula Fórmula para el número deseado de nodos de proceso en el grupo. string (obligatorio)

AutoUserSpecification

Nombre Descripción Valor
elevationLevel El valor predeterminado es nonAdmin. 'Admin'
'NonAdmin'
alcance 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 que deben ser accesibles por tareas iniciales. 'Pool'
'Tarea'

AzureBlobFileSystemConfiguration

Nombre Descripción Valor
accountKey Esta propiedad es mutuamente excluyente con sasKey e identidad; exactamente uno debe especificarse. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
accountName Nombre de la cuenta de Azure Storage. string (obligatorio)
blobfuseOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
containerName Nombre del contenedor de Azure Blob Storage. string (obligatorio)
identityReference Esta propiedad es mutuamente excluyente con accountKey y sasKey; exactamente uno debe especificarse. ComputeNodeIdentityReference
relativeMountPath 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. string (obligatorio)
sasKey Esta propiedad es mutuamente excluyente tanto con accountKey como con la identidad; exactamente uno debe especificarse. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

AzureFileShareConfiguration

Nombre Descripción Valor
accountKey Clave de cuenta de Azure Storage. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
accountName Nombre de la cuenta de Azure Storage. string (obligatorio)
azureFileUrl Este es el formato "https://{account}.file.core.windows.net/". string (obligatorio)
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
relativeMountPath 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. string (obligatorio)

BatchPoolIdentity

Nombre Descripción Valor
tipo Tipo de identidad que se usa para el grupo de Batch. 'Ninguno'
'UserAssigned' (obligatorio)
userAssignedIdentities Lista de identidades de usuario asociadas al grupo de Batch. batchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Nombre Descripción Valor

CertificateReference

Nombre Descripción Valor
identificación Identificador completo del certificado que se va a instalar en el grupo. Debe estar dentro de la misma cuenta por lotes que el grupo. string (obligatorio)
storeLocation El valor predeterminado es currentUser. Esta propiedad solo es aplicable a los grupos configurados con nodos 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. Para 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. 'CurrentUser'
"LocalMachine"
storeName Esta propiedad solo es aplicable a los grupos configurados con nodos 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. cuerda
visibilidad Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado. Matriz de cadenas que contiene cualquiera de:
'RemoteUser'
'StartTask'
'Tarea'

CifsMountConfiguration

Nombre Descripción Valor
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
contraseña Contraseña que se va a usar para la autenticación en el sistema de archivos CIFS. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
relativeMountPath 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. string (obligatorio)
fuente URI del sistema de archivos que se va a montar. string (obligatorio)
nombre de usuario El usuario que se va a usar para la autenticación en el sistema de archivos CIFS. string (obligatorio)

CloudServiceConfiguration

Nombre Descripción Valor
osFamily Los valores posibles son: 2 - Familia de so 2, equivalente a Windows Server 2008 R2 SP1. 3 - Familia de so 3, equivalente a Windows Server 2012. 4 - Familia de so 4, equivalente a Windows Server 2012 R2. 5 - Familia de so 5, equivalente a Windows Server 2016. 6 - Familia de so 6, 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). string (obligatorio)
osVersion El valor predeterminado es * que especifica la versión más reciente del sistema operativo para la familia de sistema operativo especificada. cuerda

ComputeNodeIdentityReference

Nombre Descripción Valor
resourceId Identificador de recurso de ARM de la identidad asignada por el usuario. cuerda

ContainerConfiguration

Nombre Descripción Valor
containerImageNames Esta es la referencia de imagen completa, como se especificaría en "docker pull". Se generará una imagen del registro de Docker predeterminado a menos que la imagen esté completa con un registro alternativo. string[]
containerRegistries Si se deben descargar imágenes de un registro privado que requiera credenciales, esas credenciales deben proporcionarse aquí. containerRegistry[]
tipo Tecnología de contenedor que se va a usar. 'CriCompatible'
'DockerCompatible' (obligatorio)

ContainerRegistry

Nombre Descripción Valor
identityReference Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. ComputeNodeIdentityReference
contraseña Contraseña que se va a iniciar sesión en el servidor del Registro. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
RegistryServer Si se omite, el valor predeterminado es "docker.io". cuerda
nombre de usuario Nombre de usuario que se va a iniciar sesión en el servidor del Registro. cuerda

DataDisk

Nombre Descripción Valor
Caché Los valores son:

none: el modo de almacenamiento en caché del disco no está habilitado.
readOnly: el modo de almacenamiento en caché del disco es de solo lectura.
readWrite: el modo de almacenamiento en caché del disco es de lectura y escritura.

El valor predeterminado para el almacenamiento en caché no es ninguno. Para obtener información sobre las opciones de almacenamiento en caché, consulte: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'Ninguno'
'ReadOnly'
"ReadWrite"
diskSizeGB Tamaño de disco inicial en GB al crear un nuevo disco de datos. int (obligatorio)
Lun 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. int (obligatorio)
storageAccountType Si se omite, el valor predeterminado es "Standard_LRS". Los valores son:

Standard_LRS: el disco de datos debe usar el almacenamiento con redundancia local estándar.
Premium_LRS: el disco de datos debe usar el almacenamiento con redundancia local Premium.
"Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

DeploymentConfiguration

Nombre Descripción Valor
cloudServiceConfiguration 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". CloudServiceConfiguration
virtualMachineConfiguration Esta propiedad y cloudServiceConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades. VirtualMachineConfiguration

DiffDiskSettings

Nombre Descripción Valor
colocación El usuario puede usar esta propiedad en la solicitud para elegir en qué ubicación debe estar el sistema operativo. Por ejemplo, el espacio en disco de caché para el aprovisionamiento de discos del sistema operativo efímero. Para 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 /azure/virtual-machines/windows/efímero-os-disks#size-requirements y máquinas virtuales Linux en /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. 'CacheDisk'

DiskEncryptionConfiguration

Nombre Descripción Valor
Objetivos En el grupo de Linux, solo se admite "TemporaryDisk"; en el grupo de Windows, se debe especificar "OsDisk" y "TemporaryDisk". Matriz de cadenas que contiene cualquiera de:
'OsDisk'
'TemporaryDisk'

EnvironmentSetting

Nombre Descripción Valor
nombre Nombre de la variable de entorno. string (obligatorio)
valor Valor de la variable de entorno. cuerda

FixedScaleSettings

Nombre Descripción Valor
nodeDeallocationOption Si se omite, el valor predeterminado es Requeue. 'Requeue'
'RetainedData'
'TaskCompletion'
'Terminate'
resizeTimeout El valor predeterminado es de 15 minutos. Los valores de tiempo de espera usan el formato ISO 8601. Por ejemplo, use PT10M durante 10 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch rechaza la solicitud con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). cuerda
targetDedicatedNodes Al menos uno de targetDedicatedNodes, se deben establecer targetLowPriorityNodes. Int
targetLowPriorityNodes Al menos uno de targetDedicatedNodes, se deben establecer targetLowPriorityNodes. Int

ImageReference

Nombre Descripción Valor
identificación Esta propiedad es mutuamente excluyente con otras propiedades. La imagen de Azure Compute Gallery debe tener réplicas en la misma región que la cuenta de Azure Batch. Para obtener información sobre la configuración del firewall para que el agente de nodo de Batch se comunique con el servicio Batch, consulte /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. cuerda
ofrecer Por ejemplo, UbuntuServer o WindowsServer. cuerda
editor Por ejemplo, Canonical o MicrosoftWindowsServer. cuerda
Sku Por ejemplo, 18.04-LTS o 2022-datacenter. cuerda
Versión 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". cuerda

InboundNatPool

Nombre Descripción Valor
backendPort Debe ser único dentro de un grupo de Batch. 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. int (obligatorio)
frontendPortRangeEnd Los valores aceptables oscilan entre 1 y 65534, excepto los puertos de 50000 a 55000 que están reservados por el servicio Batch. Todos los intervalos de un grupo deben ser distintos y no se pueden superponer. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400. int (obligatorio)
frontendPortRangeStart 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. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400. int (obligatorio)
nombre El nombre debe ser único dentro de un grupo de Batch, 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. string (obligatorio)
networkSecurityGroupRules El número máximo de reglas que se pueden especificar en todos los puntos de conexión de un grupo de Batch es 25. Si no se especifica ninguna regla 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. networkSecurityGroupRule[]
protocolo Protocolo del punto de conexión. 'TCP'
'UDP' (obligatorio)

LinuxUserConfiguration

Nombre Descripción Valor
Gid Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica, el sistema operativo subyacente elige el gid. Int
sshPrivateKey La clave privada no debe estar protegida con contraseña. La clave privada se usa para configurar automáticamente la autenticación basada en claves asimétricas para SSH entre nodos de 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 (no se realiza ninguna modificación del directorio .ssh del usuario). cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
Uid Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica, el sistema operativo subyacente elige el uid. Int

ManagedDisk

Nombre Descripción Valor
storageAccountType Tipo de cuenta de almacenamiento para su uso en la creación de discos de datos o disco del sistema operativo. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

MetadataItem

Nombre Descripción Valor
nombre Nombre del elemento de metadatos. string (obligatorio)
valor Valor del elemento de metadatos. string (obligatorio)

Microsoft.Batch/batchAccounts/pools

Nombre Descripción Valor
identidad Tipo de identidad que se usa para el grupo de Batch. BatchPoolIdentity
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 1
Patrón = ^[a-zA-Z0-9_-]+$ (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: batchAccounts
Propiedades Propiedades asociadas al grupo. poolProperties de

MountConfiguration

Nombre Descripción Valor
azureBlobFileSystemConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. AzureFileShareConfiguration
cifsMountConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. cifsMountConfiguration de
nfsMountConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. NFSMountConfiguration

NetworkConfiguration

Nombre Descripción Valor
dynamicVnetAssignmentScope Ámbito de la asignación dinámica de red virtual. 'job'
'none'
enableAcceleratedNetworking 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 rendimiento de red mejorado. Para más información, consulte :/azure/virtual-network/accelerated-networking-overview. Bool
endpointConfiguration La configuración del punto de conexión del grupo solo se admite en grupos con la propiedad virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Esta propiedad solo se admite en Grupos con la propiedad virtualMachineConfiguration. publicIPAddressConfiguration
subnetId 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 dar cabida al número de nodos del grupo. Si la subred no tiene suficientes direcciones IP libres, el grupo asignará parcialmente nodos de proceso 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 Control de acceso (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 de proceso. Para comprobarlo, compruebe si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado. Si un NSG deniega la comunicación con los nodos de proceso de la subred especificada, el servicio Batch establecerá el estado de los nodos de proceso en inutilizable. Si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado, se deben habilitar algunos puertos del sistema reservados para la comunicación entrante. En el caso de 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. En el caso de 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. En el caso de los grupos de cloudServiceConfiguration, solo se admiten redes virtuales "clásicas". Para más información, consulte : /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration cuerda

NetworkSecurityGroupRule

Nombre Descripción Valor
acceso Acción que se debe realizar para una dirección IP, un intervalo de subred o una etiqueta especificados. 'Permitir'
'Deny' (obligatorio)
prioridad Las prioridades dentro de un grupo deben ser únicas y se evalúan en orden de prioridad. Cuanto menor sea el número, mayor será la prioridad. 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. int (obligatorio)
sourceAddressPrefix 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. string (obligatorio)
sourcePortRanges Los valores válidos son '*' (para todos los puertos 0 - 65535) o matrices de puertos o intervalos de puertos (es decir, 100-200). Los puertos deben estar comprendidos entre 0 y 65535 y los intervalos de puertos o puertos no se pueden superponer. Si se proporcionan otros valores, se produce un error en la solicitud con el código de estado HTTP 400. El valor predeterminado será *. string[]

NFSMountConfiguration

Nombre Descripción Valor
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
relativeMountPath 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. string (obligatorio)
fuente URI del sistema de archivos que se va a montar. string (obligatorio)

NodePlacementConfiguration

Nombre Descripción Valor
política Directiva de asignación que usa Batch Service para aprovisionar los nodos. Si no se especifica, Batch usará la directiva regional. "Regional"
'Zonal'

OSDisk

Nombre Descripción Valor
Caché Tipo de almacenamiento en caché que se va a habilitar para el disco. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskSizeGB Tamaño de disco inicial en GB al crear un nuevo disco del sistema operativo. Int
ephemeralOSDiskSettings Especifica la configuración de disco efímero para el disco del sistema operativo utilizado por la máquina virtual. DiffDiskSettings
managedDisk managedDisk
writeAcceleratorEnabled Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco. Bool

PoolEndpointConfiguration

Nombre Descripción Valor
inboundNatPools El número máximo de grupos NAT entrantes por grupo de Batch 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. inboundNatPool[] (obligatorio)

PoolProperties

Nombre Descripción Valor
applicationLicenses La lista de licencias de aplicación debe ser un subconjunto de licencias de aplicaciones de servicio de Batch disponibles. Si se solicita una licencia que no se admite, se producirá un error en la creación del grupo. string[]
applicationPackages Los cambios en las referencias del paquete de aplicación afectan a todos los nodos de proceso nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear imágenes. Hay un máximo de 10 referencias de paquete de aplicación en cualquier grupo determinado. ApplicationPackageReference[]
Certificados En el caso de los nodos de proceso 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. Para los certificados con visibilidad de "remoteUser", se crea un directorio "certs" en el directorio principal del usuario (por ejemplo, /home/{user-name}/certs) y los certificados se colocan en ese directorio.

Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de .
certificateReference[]
deploymentConfiguration El uso de CloudServiceConfiguration especifica que los nodos deben crearse mediante Azure Cloud Services (PaaS), mientras que VirtualMachineConfiguration usa Azure Virtual Machines (IaaS). DeploymentConfiguration
displayName El nombre para mostrar no debe ser único y puede contener caracteres Unicode de hasta una longitud máxima de 1024. cuerda
interNodeCommunication Esto impone restricciones en las que se pueden asignar nodos al grupo. La habilitación de este valor puede reducir la posibilidad de asignar el número solicitado de nodos en el grupo. Si no se especifica, este valor tiene como valor predeterminado "Disabled". 'Deshabilitado'
'Habilitado'
metadatos El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario. metadataItem[]
mountConfiguration Esto admite Azure Files, NFS, CIFS/SMB y Blobfuse. mountConfiguration[]
networkConfiguration Configuración de red de un grupo. networkConfiguration
resourceTags Etiquetas definidas por el usuario que se van a asociar 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". PoolPropertiesResourceTags
scaleSettings Define el tamaño deseado del grupo. Esto puede ser "fixedScale" donde se especifica targetDedicatedNodes solicitado o "autoScale", que define una fórmula que se vuelve a evaluar periódicamente. Si no se especifica esta propiedad, el grupo tendrá una escala fija con 0 targetDedicatedNodes. scaleSettings
startTask En una operación PATCH (actualización), esta propiedad se puede establecer en un objeto vacío para quitar la tarea de inicio del grupo. StartTask
targetNodeCommunicationMode Si se omite, el valor predeterminado es Default. 'Clásico'
'Valor predeterminado'
"Simplificado"
taskSchedulingPolicy Si no se especifica, el valor predeterminado se propaga. TaskSchedulingPolicy
taskSlotsPerNode El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos de vmSize del grupo o 256. Int
userAccounts Lista de cuentas de usuario que se van a crear en cada nodo del grupo. UserAccount []
vmSize Para obtener información sobre los tamaños disponibles de las máquinas virtuales para los grupos de Cloud Services (grupos creados con cloudServiceConfiguration), consulte Tamaños de Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch admite todos los tamaños de máquina virtual de Cloud Services, excepto ExtraSmall. Para obtener información sobre los tamaños de máquina virtual disponibles para los grupos que usan imágenes de Marketplace de máquinas virtuales (grupos creados con virtualMachineConfiguration), consulte Tamaños de máquinas virtuales (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Tamaños de máquinas virtuales (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). cuerda

PoolPropertiesResourceTags

Nombre Descripción Valor

PublicIPAddressConfiguration

Nombre Descripción Valor
ipAddressIds El número de direcciones IP especificadas aquí limita el tamaño máximo del grupo: 100 nodos dedicados o 100 nodos de spot o prioridad baja se pueden 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}. string[]
Provisión El valor predeterminado es BatchManaged. "BatchManaged"
'NoPublicIPAddresses'
"UserManaged"

ResourceFile

Nombre Descripción Valor
autoStorageContainerName Las propiedades autoStorageContainerName, storageContainerUrl y httpUrl son mutuamente excluyentes y se debe especificar una de ellas. cuerda
blobPrefix 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. cuerda
fileMode Esta propiedad solo se aplica a los archivos que se descargan en los nodos de proceso de Linux. Se omitirá si se especifica para un resourceFile que se descargará en un nodo de Windows. Si no se especifica esta propiedad para un nodo de Linux, se aplica un valor predeterminado de 0770 al archivo. cuerda
filePath Si se especifica la propiedad httpUrl, se requiere filePath y describe la ruta de acceso a la que se descargará el archivo, incluido el nombre de archivo. De lo contrario, si se especifica la propiedad autoStorageContainerName o storageContainerUrl, filePath es opcional y es el directorio al que descargar los archivos. En el caso de que filePath se use como directorio, cualquier estructura de directorios que ya esté asociada a los datos de entrada se conservará en su totalidad y se anexará al directorio filePath especificado. La ruta de acceso relativa especificada no puede dividirse en el directorio de trabajo de la tarea (por ejemplo, mediante '..'). cuerda
httpUrl 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. cuerda
identityReference Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. ComputeNodeIdentityReference
storageContainerUrl 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. cuerda

ScaleSettings

Nombre Descripción Valor
escalado automático Esta propiedad y fixedScale son mutuamente excluyentes y se debe especificar una de las propiedades. AutoScaleSettings
fixedScale Esta propiedad y autoScale son mutuamente excluyentes y se debe especificar una de las propiedades. fixedScaleSettings

SecurityProfile

Nombre Descripción Valor
encryptionAtHost 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 recurso o el disco temporal en el propio host. Bool
securityType Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. "trustedLaunch"
uefiSettings Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. UefiSettings

ServiceArtifactReference

Nombre Descripción Valor
identificación Identificador de referencia del artefacto de servicio en forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} string (obligatorio)

StartTask

Nombre Descripción Valor
commandLine 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. Obligatorio si se especifican otras propiedades de startTask. cuerda
containerSettings Cuando se especifica esto, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de los directorios de Azure Batch en el nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor. TaskContainerSettings
environmentSettings Lista de opciones de configuración de variables de entorno para la tarea de inicio. EnvironmentSetting[]
maxTaskRetryCount 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, volverá a intentarlo hasta este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite. El valor predeterminado es 0 Int
resourceFiles Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. ResourceFile []
userIdentity Si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea. UserIdentity de
waitForSuccess Si es true y la tarea de inicio produce un error en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su recuento 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 de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar mediante el estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas seguirán programando en el nodo. El valor predeterminado es true. Bool

TaskContainerSettings

Nombre Descripción Valor
containerRunOptions Estas opciones adicionales se proporcionan como argumentos para el comando "docker create", además de las controladas por el servicio Batch. cuerda
imageName Esta es la referencia de imagen completa, como se especificaría en "docker pull". Si no se proporciona ninguna etiqueta como parte del nombre de la imagen, la etiqueta ":latest" se usa como valor predeterminado. string (obligatorio)
registro Esta configuración se puede omitir si ya se proporcionó en la creación del grupo. containerRegistry de
workingDirectory Marca para indicar dónde está el directorio de trabajo de la tarea de contenedor. El valor predeterminado es "taskWorkingDirectory". 'ContainerImageDefault'
'TaskWorkingDirectory'

TaskSchedulingPolicy

Nombre Descripción Valor
nodeFillType Cómo se deben distribuir las tareas entre nodos de proceso. 'Pack'
'Spread' (obligatorio)

UefiSettings

Nombre Descripción Valor
secureBootEnabled Especifica si se debe habilitar el arranque seguro en la máquina virtual. Bool
vTpmEnabled Especifica si vTPM debe estar habilitado en la máquina virtual. Bool

UserAccount

Nombre Descripción Valor
elevationLevel nonAdmin: el usuario automático es un usuario estándar sin acceso elevado. admin: el usuario automático es un usuario con acceso elevado y funciona con permisos de administrador completos. El valor predeterminado es nonAdmin. 'Admin'
'NonAdmin'
linuxUserConfiguration Esta propiedad se omite si se especifica en un grupo de Windows. Si no se especifica, el usuario se crea con las opciones predeterminadas. LinuxUserConfiguration
nombre Nombre de la cuenta de usuario. Los nombres pueden contener caracteres Unicode de hasta una longitud máxima de 20. string (obligatorio)
contraseña Contraseña de la cuenta de usuario. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
windowsUserConfiguration 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. windowsUserConfiguration

UserAssignedIdentities

Nombre Descripción Valor

UserIdentity

Nombre Descripción Valor
autoUser Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos. AutoUserSpecification
nombre de usuario Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos. cuerda

VirtualMachineConfiguration

Nombre Descripción Valor
containerConfiguration Si se especifica, la instalación se realiza en cada nodo del grupo para permitir que las tareas se ejecuten en contenedores. Todas las tareas normales y las tareas del administrador de trabajos que se ejecutan en este grupo deben especificar la propiedad containerSettings y todas las demás tareas pueden especificarla. containerConfiguration
dataDisks Esta propiedad debe especificarse si los nodos de proceso del grupo deben tener discos de datos vacíos conectados a ellos. DataDisk []
diskEncryptionConfiguration Si se especifica, el cifrado se realiza en cada nodo del grupo durante el aprovisionamiento de nodos. DiskEncryptionConfiguration
Extensiones Si se especifica, las extensiones mencionadas en esta configuración se instalarán en cada nodo. vmExtension[]
imageReference Referencia a una imagen de Marketplace de Azure Virtual Machines o al recurso De imagen de Azure de una máquina virtual personalizada. Para obtener la lista de todas las imageReferences verificadas por Azure Batch, consulte la operación "Enumeración de SKU de agente de nodo compatibles". imageReference (obligatorio)
licenseType Esto solo se aplica a las imágenes que contienen el sistema operativo Windows y solo se deben usar cuando contenga licencias locales válidas para los nodos 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.
cuerda
nodeAgentSkuId El agente de nodo de Batch es un programa que se ejecuta en cada nodo del grupo y proporciona la interfaz de comando y control entre el nodo y el servicio Batch. Hay diferentes implementaciones del agente de nodo, conocidas como SKU, para diferentes sistemas operativos. Debe especificar una SKU del agente de nodo que coincida con la referencia de imagen seleccionada. Para obtener la lista de SKU de agente de nodo compatibles junto con su lista de referencias de imágenes verificadas, consulte la operación "Enumerar SKU de agente de nodo compatibles". string (obligatorio)
nodePlacementConfiguration Esta configuración especificará reglas sobre cómo se asignarán físicamente los nodos del grupo. NodePlacementConfiguration
osDisk Contiene la configuración de los valores de OSDisk efímeros. OSDisk
securityProfile Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales. securityProfile 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} serviceArtifactReference
windowsConfiguration Esta propiedad no se debe especificar si imageReference especifica una imagen del sistema operativo Linux. windowsConfiguration

VMExtension

Nombre Descripción Valor
autoUpgradeMinorVersion Indica si la extensión debe usar una versión secundaria más reciente si está 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. Bool
enableAutomaticUpgrade Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. Bool
nombre Nombre de la extensión de máquina virtual. string (obligatorio)
protectedSettings La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. cualquier
provisionAfterExtensions Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. string[]
editor Nombre del publicador de controladores de extensión. string (obligatorio)
Configuración Configuración pública con formato JSON para la extensión. cualquier
tipo Tipo de las extensiones. string (obligatorio)
typeHandlerVersion Versión del controlador de script. cuerda

WindowsConfiguration

Nombre Descripción Valor
enableAutomaticUpdates Si se omite, el valor predeterminado es true. Bool

WindowsUserConfiguration

Nombre Descripción Valor
loginMode Especifica el modo de inicio de sesión para el usuario. El valor predeterminado de los grupos de VirtualMachineConfiguration es el modo interactivo y para los grupos de CloudServiceConfiguration es el modo por lotes. 'Batch'
'Interactivo'

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
grupo de Azure Batch sin direcciones IP públicas Esta plantilla crea un grupo de comunicación de nodos simplificado de Azure Batch sin direcciones IP públicas.

Definición de recursos de plantilla de ARM

El tipo de recurso batchAccounts/pools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Batch/batchAccounts/pools, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Batch/batchAccounts/pools",
  "apiVersion": "2023-11-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "properties": {
    "applicationLicenses": [ "string" ],
    "applicationPackages": [
      {
        "id": "string",
        "version": "string"
      }
    ],
    "certificates": [
      {
        "id": "string",
        "storeLocation": "string",
        "storeName": "string",
        "visibility": [ "string" ]
      }
    ],
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "osFamily": "string",
        "osVersion": "string"
      },
      "virtualMachineConfiguration": {
        "containerConfiguration": {
          "containerImageNames": [ "string" ],
          "containerRegistries": [
            {
              "identityReference": {
                "resourceId": "string"
              },
              "password": "string",
              "registryServer": "string",
              "username": "string"
            }
          ],
          "type": "string"
        },
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [ "string" ]
        },
        "extensions": [
          {
            "autoUpgradeMinorVersion": "bool",
            "enableAutomaticUpgrade": "bool",
            "name": "string",
            "protectedSettings": {},
            "provisionAfterExtensions": [ "string" ],
            "publisher": "string",
            "settings": {},
            "type": "string",
            "typeHandlerVersion": "string"
          }
        ],
        "imageReference": {
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "nodePlacementConfiguration": {
          "policy": "string"
        },
        "osDisk": {
          "caching": "string",
          "diskSizeGB": "int",
          "ephemeralOSDiskSettings": {
            "placement": "CacheDisk"
          },
          "managedDisk": {
            "storageAccountType": "string"
          },
          "writeAcceleratorEnabled": "bool"
        },
        "securityProfile": {
          "encryptionAtHost": "bool",
          "securityType": "trustedLaunch",
          "uefiSettings": {
            "secureBootEnabled": "bool",
            "vTpmEnabled": "bool"
          }
        },
        "serviceArtifactReference": {
          "id": "string"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "mountConfiguration": [
      {
        "azureBlobFileSystemConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "blobfuseOptions": "string",
          "containerName": "string",
          "identityReference": {
            "resourceId": "string"
          },
          "relativeMountPath": "string",
          "sasKey": "string"
        },
        "azureFileShareConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "azureFileUrl": "string",
          "mountOptions": "string",
          "relativeMountPath": "string"
        },
        "cifsMountConfiguration": {
          "mountOptions": "string",
          "password": "string",
          "relativeMountPath": "string",
          "source": "string",
          "userName": "string"
        },
        "nfsMountConfiguration": {
          "mountOptions": "string",
          "relativeMountPath": "string",
          "source": "string"
        }
      }
    ],
    "networkConfiguration": {
      "dynamicVnetAssignmentScope": "string",
      "enableAcceleratedNetworking": "bool",
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "backendPort": "int",
            "frontendPortRangeEnd": "int",
            "frontendPortRangeStart": "int",
            "name": "string",
            "networkSecurityGroupRules": [
              {
                "access": "string",
                "priority": "int",
                "sourceAddressPrefix": "string",
                "sourcePortRanges": [ "string" ]
              }
            ],
            "protocol": "string"
          }
        ]
      },
      "publicIPAddressConfiguration": {
        "ipAddressIds": [ "string" ],
        "provision": "string"
      },
      "subnetId": "string"
    },
    "resourceTags": {
      "{customized property}": "string"
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "string",
        "formula": "string"
      },
      "fixedScale": {
        "nodeDeallocationOption": "string",
        "resizeTimeout": "string",
        "targetDedicatedNodes": "int",
        "targetLowPriorityNodes": "int"
      }
    },
    "startTask": {
      "commandLine": "string",
      "containerSettings": {
        "containerRunOptions": "string",
        "imageName": "string",
        "registry": {
          "identityReference": {
            "resourceId": "string"
          },
          "password": "string",
          "registryServer": "string",
          "username": "string"
        },
        "workingDirectory": "string"
      },
      "environmentSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "maxTaskRetryCount": "int",
      "resourceFiles": [
        {
          "autoStorageContainerName": "string",
          "blobPrefix": "string",
          "fileMode": "string",
          "filePath": "string",
          "httpUrl": "string",
          "identityReference": {
            "resourceId": "string"
          },
          "storageContainerUrl": "string"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "elevationLevel": "string",
          "scope": "string"
        },
        "userName": "string"
      },
      "waitForSuccess": "bool"
    },
    "targetNodeCommunicationMode": "string",
    "taskSchedulingPolicy": {
      "nodeFillType": "string"
    },
    "taskSlotsPerNode": "int",
    "userAccounts": [
      {
        "elevationLevel": "string",
        "linuxUserConfiguration": {
          "gid": "int",
          "sshPrivateKey": "string",
          "uid": "int"
        },
        "name": "string",
        "password": "string",
        "windowsUserConfiguration": {
          "loginMode": "string"
        }
      }
    ],
    "vmSize": "string"
  }
}

Valores de propiedad

ApplicationPackageReference

Nombre Descripción Valor
identificación Identificador del paquete de aplicación que se va a instalar. Debe estar dentro de la misma cuenta por lotes que el grupo. Puede ser una referencia a una versión específica o a la versión predeterminada si existe una. string (obligatorio)
Versión Si se omite 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. Si llama directamente a la API REST, el código de estado HTTP es 409. cuerda

AutoScaleSettings

Nombre Descripción Valor
evaluationInterval Si se omite, el valor predeterminado es 15 minutos (PT15M). cuerda
fórmula Fórmula para el número deseado de nodos de proceso en el grupo. string (obligatorio)

AutoUserSpecification

Nombre Descripción Valor
elevationLevel El valor predeterminado es nonAdmin. 'Admin'
'NonAdmin'
alcance 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 que deben ser accesibles por tareas iniciales. 'Pool'
'Tarea'

AzureBlobFileSystemConfiguration

Nombre Descripción Valor
accountKey Esta propiedad es mutuamente excluyente con sasKey e identidad; exactamente uno debe especificarse. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
accountName Nombre de la cuenta de Azure Storage. string (obligatorio)
blobfuseOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
containerName Nombre del contenedor de Azure Blob Storage. string (obligatorio)
identityReference Esta propiedad es mutuamente excluyente con accountKey y sasKey; exactamente uno debe especificarse. ComputeNodeIdentityReference
relativeMountPath 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. string (obligatorio)
sasKey Esta propiedad es mutuamente excluyente tanto con accountKey como con la identidad; exactamente uno debe especificarse. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

AzureFileShareConfiguration

Nombre Descripción Valor
accountKey Clave de cuenta de Azure Storage. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
accountName Nombre de la cuenta de Azure Storage. string (obligatorio)
azureFileUrl Este es el formato "https://{account}.file.core.windows.net/". string (obligatorio)
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
relativeMountPath 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. string (obligatorio)

BatchPoolIdentity

Nombre Descripción Valor
tipo Tipo de identidad que se usa para el grupo de Batch. 'Ninguno'
'UserAssigned' (obligatorio)
userAssignedIdentities Lista de identidades de usuario asociadas al grupo de Batch. batchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Nombre Descripción Valor

CertificateReference

Nombre Descripción Valor
identificación Identificador completo del certificado que se va a instalar en el grupo. Debe estar dentro de la misma cuenta por lotes que el grupo. string (obligatorio)
storeLocation El valor predeterminado es currentUser. Esta propiedad solo es aplicable a los grupos configurados con nodos 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. Para 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. 'CurrentUser'
"LocalMachine"
storeName Esta propiedad solo es aplicable a los grupos configurados con nodos 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. cuerda
visibilidad Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado. Matriz de cadenas que contiene cualquiera de:
'RemoteUser'
'StartTask'
'Tarea'

CifsMountConfiguration

Nombre Descripción Valor
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
contraseña Contraseña que se va a usar para la autenticación en el sistema de archivos CIFS. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
relativeMountPath 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. string (obligatorio)
fuente URI del sistema de archivos que se va a montar. string (obligatorio)
nombre de usuario El usuario que se va a usar para la autenticación en el sistema de archivos CIFS. string (obligatorio)

CloudServiceConfiguration

Nombre Descripción Valor
osFamily Los valores posibles son: 2 - Familia de so 2, equivalente a Windows Server 2008 R2 SP1. 3 - Familia de so 3, equivalente a Windows Server 2012. 4 - Familia de so 4, equivalente a Windows Server 2012 R2. 5 - Familia de so 5, equivalente a Windows Server 2016. 6 - Familia de so 6, 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). string (obligatorio)
osVersion El valor predeterminado es * que especifica la versión más reciente del sistema operativo para la familia de sistema operativo especificada. cuerda

ComputeNodeIdentityReference

Nombre Descripción Valor
resourceId Identificador de recurso de ARM de la identidad asignada por el usuario. cuerda

ContainerConfiguration

Nombre Descripción Valor
containerImageNames Esta es la referencia de imagen completa, como se especificaría en "docker pull". Se generará una imagen del registro de Docker predeterminado a menos que la imagen esté completa con un registro alternativo. string[]
containerRegistries Si se deben descargar imágenes de un registro privado que requiera credenciales, esas credenciales deben proporcionarse aquí. containerRegistry[]
tipo Tecnología de contenedor que se va a usar. 'CriCompatible'
'DockerCompatible' (obligatorio)

ContainerRegistry

Nombre Descripción Valor
identityReference Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. ComputeNodeIdentityReference
contraseña Contraseña que se va a iniciar sesión en el servidor del Registro. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
RegistryServer Si se omite, el valor predeterminado es "docker.io". cuerda
nombre de usuario Nombre de usuario que se va a iniciar sesión en el servidor del Registro. cuerda

DataDisk

Nombre Descripción Valor
Caché Los valores son:

none: el modo de almacenamiento en caché del disco no está habilitado.
readOnly: el modo de almacenamiento en caché del disco es de solo lectura.
readWrite: el modo de almacenamiento en caché del disco es de lectura y escritura.

El valor predeterminado para el almacenamiento en caché no es ninguno. Para obtener información sobre las opciones de almacenamiento en caché, consulte: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'Ninguno'
'ReadOnly'
"ReadWrite"
diskSizeGB Tamaño de disco inicial en GB al crear un nuevo disco de datos. int (obligatorio)
Lun 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. int (obligatorio)
storageAccountType Si se omite, el valor predeterminado es "Standard_LRS". Los valores son:

Standard_LRS: el disco de datos debe usar el almacenamiento con redundancia local estándar.
Premium_LRS: el disco de datos debe usar el almacenamiento con redundancia local Premium.
"Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

DeploymentConfiguration

Nombre Descripción Valor
cloudServiceConfiguration 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". CloudServiceConfiguration
virtualMachineConfiguration Esta propiedad y cloudServiceConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades. VirtualMachineConfiguration

DiffDiskSettings

Nombre Descripción Valor
colocación El usuario puede usar esta propiedad en la solicitud para elegir en qué ubicación debe estar el sistema operativo. Por ejemplo, el espacio en disco de caché para el aprovisionamiento de discos del sistema operativo efímero. Para 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 /azure/virtual-machines/windows/efímero-os-disks#size-requirements y máquinas virtuales Linux en /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. 'CacheDisk'

DiskEncryptionConfiguration

Nombre Descripción Valor
Objetivos En el grupo de Linux, solo se admite "TemporaryDisk"; en el grupo de Windows, se debe especificar "OsDisk" y "TemporaryDisk". Matriz de cadenas que contiene cualquiera de:
'OsDisk'
'TemporaryDisk'

EnvironmentSetting

Nombre Descripción Valor
nombre Nombre de la variable de entorno. string (obligatorio)
valor Valor de la variable de entorno. cuerda

FixedScaleSettings

Nombre Descripción Valor
nodeDeallocationOption Si se omite, el valor predeterminado es Requeue. 'Requeue'
'RetainedData'
'TaskCompletion'
'Terminate'
resizeTimeout El valor predeterminado es de 15 minutos. Los valores de tiempo de espera usan el formato ISO 8601. Por ejemplo, use PT10M durante 10 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch rechaza la solicitud con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). cuerda
targetDedicatedNodes Al menos uno de targetDedicatedNodes, se deben establecer targetLowPriorityNodes. Int
targetLowPriorityNodes Al menos uno de targetDedicatedNodes, se deben establecer targetLowPriorityNodes. Int

ImageReference

Nombre Descripción Valor
identificación Esta propiedad es mutuamente excluyente con otras propiedades. La imagen de Azure Compute Gallery debe tener réplicas en la misma región que la cuenta de Azure Batch. Para obtener información sobre la configuración del firewall para que el agente de nodo de Batch se comunique con el servicio Batch, consulte /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. cuerda
ofrecer Por ejemplo, UbuntuServer o WindowsServer. cuerda
editor Por ejemplo, Canonical o MicrosoftWindowsServer. cuerda
Sku Por ejemplo, 18.04-LTS o 2022-datacenter. cuerda
Versión 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". cuerda

InboundNatPool

Nombre Descripción Valor
backendPort Debe ser único dentro de un grupo de Batch. 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. int (obligatorio)
frontendPortRangeEnd Los valores aceptables oscilan entre 1 y 65534, excepto los puertos de 50000 a 55000 que están reservados por el servicio Batch. Todos los intervalos de un grupo deben ser distintos y no se pueden superponer. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400. int (obligatorio)
frontendPortRangeStart 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. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400. int (obligatorio)
nombre El nombre debe ser único dentro de un grupo de Batch, 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. string (obligatorio)
networkSecurityGroupRules El número máximo de reglas que se pueden especificar en todos los puntos de conexión de un grupo de Batch es 25. Si no se especifica ninguna regla 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. networkSecurityGroupRule[]
protocolo Protocolo del punto de conexión. 'TCP'
'UDP' (obligatorio)

LinuxUserConfiguration

Nombre Descripción Valor
Gid Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica, el sistema operativo subyacente elige el gid. Int
sshPrivateKey La clave privada no debe estar protegida con contraseña. La clave privada se usa para configurar automáticamente la autenticación basada en claves asimétricas para SSH entre nodos de 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 (no se realiza ninguna modificación del directorio .ssh del usuario). cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
Uid Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica, el sistema operativo subyacente elige el uid. Int

ManagedDisk

Nombre Descripción Valor
storageAccountType Tipo de cuenta de almacenamiento para su uso en la creación de discos de datos o disco del sistema operativo. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

MetadataItem

Nombre Descripción Valor
nombre Nombre del elemento de metadatos. string (obligatorio)
valor Valor del elemento de metadatos. string (obligatorio)

Microsoft.Batch/batchAccounts/pools

Nombre Descripción Valor
apiVersion La versión de api '2023-11-01'
identidad Tipo de identidad que se usa para el grupo de Batch. BatchPoolIdentity
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 1
Patrón = ^[a-zA-Z0-9_-]+$ (obligatorio)
Propiedades Propiedades asociadas al grupo. poolProperties de
tipo El tipo de recurso "Microsoft.Batch/batchAccounts/pools"

MountConfiguration

Nombre Descripción Valor
azureBlobFileSystemConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. AzureFileShareConfiguration
cifsMountConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. cifsMountConfiguration de
nfsMountConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. NFSMountConfiguration

NetworkConfiguration

Nombre Descripción Valor
dynamicVnetAssignmentScope Ámbito de la asignación dinámica de red virtual. 'job'
'none'
enableAcceleratedNetworking 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 rendimiento de red mejorado. Para más información, consulte :/azure/virtual-network/accelerated-networking-overview. Bool
endpointConfiguration La configuración del punto de conexión del grupo solo se admite en grupos con la propiedad virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Esta propiedad solo se admite en Grupos con la propiedad virtualMachineConfiguration. publicIPAddressConfiguration
subnetId 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 dar cabida al número de nodos del grupo. Si la subred no tiene suficientes direcciones IP libres, el grupo asignará parcialmente nodos de proceso 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 Control de acceso (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 de proceso. Para comprobarlo, compruebe si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado. Si un NSG deniega la comunicación con los nodos de proceso de la subred especificada, el servicio Batch establecerá el estado de los nodos de proceso en inutilizable. Si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado, se deben habilitar algunos puertos del sistema reservados para la comunicación entrante. En el caso de 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. En el caso de 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. En el caso de los grupos de cloudServiceConfiguration, solo se admiten redes virtuales "clásicas". Para más información, consulte : /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration cuerda

NetworkSecurityGroupRule

Nombre Descripción Valor
acceso Acción que se debe realizar para una dirección IP, un intervalo de subred o una etiqueta especificados. 'Permitir'
'Deny' (obligatorio)
prioridad Las prioridades dentro de un grupo deben ser únicas y se evalúan en orden de prioridad. Cuanto menor sea el número, mayor será la prioridad. 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. int (obligatorio)
sourceAddressPrefix 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. string (obligatorio)
sourcePortRanges Los valores válidos son '*' (para todos los puertos 0 - 65535) o matrices de puertos o intervalos de puertos (es decir, 100-200). Los puertos deben estar comprendidos entre 0 y 65535 y los intervalos de puertos o puertos no se pueden superponer. Si se proporcionan otros valores, se produce un error en la solicitud con el código de estado HTTP 400. El valor predeterminado será *. string[]

NFSMountConfiguration

Nombre Descripción Valor
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
relativeMountPath 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. string (obligatorio)
fuente URI del sistema de archivos que se va a montar. string (obligatorio)

NodePlacementConfiguration

Nombre Descripción Valor
política Directiva de asignación que usa Batch Service para aprovisionar los nodos. Si no se especifica, Batch usará la directiva regional. "Regional"
'Zonal'

OSDisk

Nombre Descripción Valor
Caché Tipo de almacenamiento en caché que se va a habilitar para el disco. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskSizeGB Tamaño de disco inicial en GB al crear un nuevo disco del sistema operativo. Int
ephemeralOSDiskSettings Especifica la configuración de disco efímero para el disco del sistema operativo utilizado por la máquina virtual. DiffDiskSettings
managedDisk managedDisk
writeAcceleratorEnabled Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco. Bool

PoolEndpointConfiguration

Nombre Descripción Valor
inboundNatPools El número máximo de grupos NAT entrantes por grupo de Batch 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. inboundNatPool[] (obligatorio)

PoolProperties

Nombre Descripción Valor
applicationLicenses La lista de licencias de aplicación debe ser un subconjunto de licencias de aplicaciones de servicio de Batch disponibles. Si se solicita una licencia que no se admite, se producirá un error en la creación del grupo. string[]
applicationPackages Los cambios en las referencias del paquete de aplicación afectan a todos los nodos de proceso nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear imágenes. Hay un máximo de 10 referencias de paquete de aplicación en cualquier grupo determinado. ApplicationPackageReference[]
Certificados En el caso de los nodos de proceso 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. Para los certificados con visibilidad de "remoteUser", se crea un directorio "certs" en el directorio principal del usuario (por ejemplo, /home/{user-name}/certs) y los certificados se colocan en ese directorio.

Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de .
certificateReference[]
deploymentConfiguration El uso de CloudServiceConfiguration especifica que los nodos deben crearse mediante Azure Cloud Services (PaaS), mientras que VirtualMachineConfiguration usa Azure Virtual Machines (IaaS). DeploymentConfiguration
displayName El nombre para mostrar no debe ser único y puede contener caracteres Unicode de hasta una longitud máxima de 1024. cuerda
interNodeCommunication Esto impone restricciones en las que se pueden asignar nodos al grupo. La habilitación de este valor puede reducir la posibilidad de asignar el número solicitado de nodos en el grupo. Si no se especifica, este valor tiene como valor predeterminado "Disabled". 'Deshabilitado'
'Habilitado'
metadatos El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario. metadataItem[]
mountConfiguration Esto admite Azure Files, NFS, CIFS/SMB y Blobfuse. mountConfiguration[]
networkConfiguration Configuración de red de un grupo. networkConfiguration
resourceTags Etiquetas definidas por el usuario que se van a asociar 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". PoolPropertiesResourceTags
scaleSettings Define el tamaño deseado del grupo. Esto puede ser "fixedScale" donde se especifica targetDedicatedNodes solicitado o "autoScale", que define una fórmula que se vuelve a evaluar periódicamente. Si no se especifica esta propiedad, el grupo tendrá una escala fija con 0 targetDedicatedNodes. scaleSettings
startTask En una operación PATCH (actualización), esta propiedad se puede establecer en un objeto vacío para quitar la tarea de inicio del grupo. StartTask
targetNodeCommunicationMode Si se omite, el valor predeterminado es Default. 'Clásico'
'Valor predeterminado'
"Simplificado"
taskSchedulingPolicy Si no se especifica, el valor predeterminado se propaga. TaskSchedulingPolicy
taskSlotsPerNode El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos de vmSize del grupo o 256. Int
userAccounts Lista de cuentas de usuario que se van a crear en cada nodo del grupo. UserAccount []
vmSize Para obtener información sobre los tamaños disponibles de las máquinas virtuales para los grupos de Cloud Services (grupos creados con cloudServiceConfiguration), consulte Tamaños de Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch admite todos los tamaños de máquina virtual de Cloud Services, excepto ExtraSmall. Para obtener información sobre los tamaños de máquina virtual disponibles para los grupos que usan imágenes de Marketplace de máquinas virtuales (grupos creados con virtualMachineConfiguration), consulte Tamaños de máquinas virtuales (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Tamaños de máquinas virtuales (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). cuerda

PoolPropertiesResourceTags

Nombre Descripción Valor

PublicIPAddressConfiguration

Nombre Descripción Valor
ipAddressIds El número de direcciones IP especificadas aquí limita el tamaño máximo del grupo: 100 nodos dedicados o 100 nodos de spot o prioridad baja se pueden 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}. string[]
Provisión El valor predeterminado es BatchManaged. "BatchManaged"
'NoPublicIPAddresses'
"UserManaged"

ResourceFile

Nombre Descripción Valor
autoStorageContainerName Las propiedades autoStorageContainerName, storageContainerUrl y httpUrl son mutuamente excluyentes y se debe especificar una de ellas. cuerda
blobPrefix 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. cuerda
fileMode Esta propiedad solo se aplica a los archivos que se descargan en los nodos de proceso de Linux. Se omitirá si se especifica para un resourceFile que se descargará en un nodo de Windows. Si no se especifica esta propiedad para un nodo de Linux, se aplica un valor predeterminado de 0770 al archivo. cuerda
filePath Si se especifica la propiedad httpUrl, se requiere filePath y describe la ruta de acceso a la que se descargará el archivo, incluido el nombre de archivo. De lo contrario, si se especifica la propiedad autoStorageContainerName o storageContainerUrl, filePath es opcional y es el directorio al que descargar los archivos. En el caso de que filePath se use como directorio, cualquier estructura de directorios que ya esté asociada a los datos de entrada se conservará en su totalidad y se anexará al directorio filePath especificado. La ruta de acceso relativa especificada no puede dividirse en el directorio de trabajo de la tarea (por ejemplo, mediante '..'). cuerda
httpUrl 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. cuerda
identityReference Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. ComputeNodeIdentityReference
storageContainerUrl 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. cuerda

ScaleSettings

Nombre Descripción Valor
escalado automático Esta propiedad y fixedScale son mutuamente excluyentes y se debe especificar una de las propiedades. AutoScaleSettings
fixedScale Esta propiedad y autoScale son mutuamente excluyentes y se debe especificar una de las propiedades. fixedScaleSettings

SecurityProfile

Nombre Descripción Valor
encryptionAtHost 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 recurso o el disco temporal en el propio host. Bool
securityType Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. "trustedLaunch"
uefiSettings Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. UefiSettings

ServiceArtifactReference

Nombre Descripción Valor
identificación Identificador de referencia del artefacto de servicio en forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} string (obligatorio)

StartTask

Nombre Descripción Valor
commandLine 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. Obligatorio si se especifican otras propiedades de startTask. cuerda
containerSettings Cuando se especifica esto, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de los directorios de Azure Batch en el nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor. TaskContainerSettings
environmentSettings Lista de opciones de configuración de variables de entorno para la tarea de inicio. EnvironmentSetting[]
maxTaskRetryCount 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, volverá a intentarlo hasta este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite. El valor predeterminado es 0 Int
resourceFiles Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. ResourceFile []
userIdentity Si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea. UserIdentity de
waitForSuccess Si es true y la tarea de inicio produce un error en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su recuento 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 de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar mediante el estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas seguirán programando en el nodo. El valor predeterminado es true. Bool

TaskContainerSettings

Nombre Descripción Valor
containerRunOptions Estas opciones adicionales se proporcionan como argumentos para el comando "docker create", además de las controladas por el servicio Batch. cuerda
imageName Esta es la referencia de imagen completa, como se especificaría en "docker pull". Si no se proporciona ninguna etiqueta como parte del nombre de la imagen, la etiqueta ":latest" se usa como valor predeterminado. string (obligatorio)
registro Esta configuración se puede omitir si ya se proporcionó en la creación del grupo. containerRegistry de
workingDirectory Marca para indicar dónde está el directorio de trabajo de la tarea de contenedor. El valor predeterminado es "taskWorkingDirectory". 'ContainerImageDefault'
'TaskWorkingDirectory'

TaskSchedulingPolicy

Nombre Descripción Valor
nodeFillType Cómo se deben distribuir las tareas entre nodos de proceso. 'Pack'
'Spread' (obligatorio)

UefiSettings

Nombre Descripción Valor
secureBootEnabled Especifica si se debe habilitar el arranque seguro en la máquina virtual. Bool
vTpmEnabled Especifica si vTPM debe estar habilitado en la máquina virtual. Bool

UserAccount

Nombre Descripción Valor
elevationLevel nonAdmin: el usuario automático es un usuario estándar sin acceso elevado. admin: el usuario automático es un usuario con acceso elevado y funciona con permisos de administrador completos. El valor predeterminado es nonAdmin. 'Admin'
'NonAdmin'
linuxUserConfiguration Esta propiedad se omite si se especifica en un grupo de Windows. Si no se especifica, el usuario se crea con las opciones predeterminadas. LinuxUserConfiguration
nombre Nombre de la cuenta de usuario. Los nombres pueden contener caracteres Unicode de hasta una longitud máxima de 20. string (obligatorio)
contraseña Contraseña de la cuenta de usuario. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
windowsUserConfiguration 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. windowsUserConfiguration

UserAssignedIdentities

Nombre Descripción Valor

UserIdentity

Nombre Descripción Valor
autoUser Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos. AutoUserSpecification
nombre de usuario Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos. cuerda

VirtualMachineConfiguration

Nombre Descripción Valor
containerConfiguration Si se especifica, la instalación se realiza en cada nodo del grupo para permitir que las tareas se ejecuten en contenedores. Todas las tareas normales y las tareas del administrador de trabajos que se ejecutan en este grupo deben especificar la propiedad containerSettings y todas las demás tareas pueden especificarla. containerConfiguration
dataDisks Esta propiedad debe especificarse si los nodos de proceso del grupo deben tener discos de datos vacíos conectados a ellos. DataDisk []
diskEncryptionConfiguration Si se especifica, el cifrado se realiza en cada nodo del grupo durante el aprovisionamiento de nodos. DiskEncryptionConfiguration
Extensiones Si se especifica, las extensiones mencionadas en esta configuración se instalarán en cada nodo. vmExtension[]
imageReference Referencia a una imagen de Marketplace de Azure Virtual Machines o al recurso De imagen de Azure de una máquina virtual personalizada. Para obtener la lista de todas las imageReferences verificadas por Azure Batch, consulte la operación "Enumeración de SKU de agente de nodo compatibles". imageReference (obligatorio)
licenseType Esto solo se aplica a las imágenes que contienen el sistema operativo Windows y solo se deben usar cuando contenga licencias locales válidas para los nodos 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.
cuerda
nodeAgentSkuId El agente de nodo de Batch es un programa que se ejecuta en cada nodo del grupo y proporciona la interfaz de comando y control entre el nodo y el servicio Batch. Hay diferentes implementaciones del agente de nodo, conocidas como SKU, para diferentes sistemas operativos. Debe especificar una SKU del agente de nodo que coincida con la referencia de imagen seleccionada. Para obtener la lista de SKU de agente de nodo compatibles junto con su lista de referencias de imágenes verificadas, consulte la operación "Enumerar SKU de agente de nodo compatibles". string (obligatorio)
nodePlacementConfiguration Esta configuración especificará reglas sobre cómo se asignarán físicamente los nodos del grupo. NodePlacementConfiguration
osDisk Contiene la configuración de los valores de OSDisk efímeros. OSDisk
securityProfile Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales. securityProfile 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} serviceArtifactReference
windowsConfiguration Esta propiedad no se debe especificar si imageReference especifica una imagen del sistema operativo Linux. windowsConfiguration

VMExtension

Nombre Descripción Valor
autoUpgradeMinorVersion Indica si la extensión debe usar una versión secundaria más reciente si está 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. Bool
enableAutomaticUpgrade Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. Bool
nombre Nombre de la extensión de máquina virtual. string (obligatorio)
protectedSettings La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. cualquier
provisionAfterExtensions Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. string[]
editor Nombre del publicador de controladores de extensión. string (obligatorio)
Configuración Configuración pública con formato JSON para la extensión. cualquier
tipo Tipo de las extensiones. string (obligatorio)
typeHandlerVersion Versión del controlador de script. cuerda

WindowsConfiguration

Nombre Descripción Valor
enableAutomaticUpdates Si se omite, el valor predeterminado es true. Bool

WindowsUserConfiguration

Nombre Descripción Valor
loginMode Especifica el modo de inicio de sesión para el usuario. El valor predeterminado de los grupos de VirtualMachineConfiguration es el modo interactivo y para los grupos de CloudServiceConfiguration es el modo por lotes. 'Batch'
'Interactivo'

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
grupo de Azure Batch sin direcciones IP públicas

Implementación en Azure
Esta plantilla crea un grupo de comunicación de nodos simplificado de Azure Batch sin direcciones IP públicas.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso batchAccounts/pools se puede implementar con operaciones destinadas a:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Batch/batchAccounts/pools, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/pools@2023-11-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  body = jsonencode({
    properties = {
      applicationLicenses = [
        "string"
      ]
      applicationPackages = [
        {
          id = "string"
          version = "string"
        }
      ]
      certificates = [
        {
          id = "string"
          storeLocation = "string"
          storeName = "string"
          visibility = [
            "string"
          ]
        }
      ]
      deploymentConfiguration = {
        cloudServiceConfiguration = {
          osFamily = "string"
          osVersion = "string"
        }
        virtualMachineConfiguration = {
          containerConfiguration = {
            containerImageNames = [
              "string"
            ]
            containerRegistries = [
              {
                identityReference = {
                  resourceId = "string"
                }
                password = "string"
                registryServer = "string"
                username = "string"
              }
            ]
            type = "string"
          }
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          diskEncryptionConfiguration = {
            targets = [
              "string"
            ]
          }
          extensions = [
            {
              autoUpgradeMinorVersion = bool
              enableAutomaticUpgrade = bool
              name = "string"
              protectedSettings = ?
              provisionAfterExtensions = [
                "string"
              ]
              publisher = "string"
              settings = ?
              type = "string"
              typeHandlerVersion = "string"
            }
          ]
          imageReference = {
            id = "string"
            offer = "string"
            publisher = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          nodePlacementConfiguration = {
            policy = "string"
          }
          osDisk = {
            caching = "string"
            diskSizeGB = int
            ephemeralOSDiskSettings = {
              placement = "CacheDisk"
            }
            managedDisk = {
              storageAccountType = "string"
            }
            writeAcceleratorEnabled = bool
          }
          securityProfile = {
            encryptionAtHost = bool
            securityType = "trustedLaunch"
            uefiSettings = {
              secureBootEnabled = bool
              vTpmEnabled = bool
            }
          }
          serviceArtifactReference = {
            id = "string"
          }
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      mountConfiguration = [
        {
          azureBlobFileSystemConfiguration = {
            accountKey = "string"
            accountName = "string"
            blobfuseOptions = "string"
            containerName = "string"
            identityReference = {
              resourceId = "string"
            }
            relativeMountPath = "string"
            sasKey = "string"
          }
          azureFileShareConfiguration = {
            accountKey = "string"
            accountName = "string"
            azureFileUrl = "string"
            mountOptions = "string"
            relativeMountPath = "string"
          }
          cifsMountConfiguration = {
            mountOptions = "string"
            password = "string"
            relativeMountPath = "string"
            source = "string"
            userName = "string"
          }
          nfsMountConfiguration = {
            mountOptions = "string"
            relativeMountPath = "string"
            source = "string"
          }
        }
      ]
      networkConfiguration = {
        dynamicVnetAssignmentScope = "string"
        enableAcceleratedNetworking = bool
        endpointConfiguration = {
          inboundNatPools = [
            {
              backendPort = int
              frontendPortRangeEnd = int
              frontendPortRangeStart = int
              name = "string"
              networkSecurityGroupRules = [
                {
                  access = "string"
                  priority = int
                  sourceAddressPrefix = "string"
                  sourcePortRanges = [
                    "string"
                  ]
                }
              ]
              protocol = "string"
            }
          ]
        }
        publicIPAddressConfiguration = {
          ipAddressIds = [
            "string"
          ]
          provision = "string"
        }
        subnetId = "string"
      }
      resourceTags = {
        {customized property} = "string"
      }
      scaleSettings = {
        autoScale = {
          evaluationInterval = "string"
          formula = "string"
        }
        fixedScale = {
          nodeDeallocationOption = "string"
          resizeTimeout = "string"
          targetDedicatedNodes = int
          targetLowPriorityNodes = int
        }
      }
      startTask = {
        commandLine = "string"
        containerSettings = {
          containerRunOptions = "string"
          imageName = "string"
          registry = {
            identityReference = {
              resourceId = "string"
            }
            password = "string"
            registryServer = "string"
            username = "string"
          }
          workingDirectory = "string"
        }
        environmentSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        maxTaskRetryCount = int
        resourceFiles = [
          {
            autoStorageContainerName = "string"
            blobPrefix = "string"
            fileMode = "string"
            filePath = "string"
            httpUrl = "string"
            identityReference = {
              resourceId = "string"
            }
            storageContainerUrl = "string"
          }
        ]
        userIdentity = {
          autoUser = {
            elevationLevel = "string"
            scope = "string"
          }
          userName = "string"
        }
        waitForSuccess = bool
      }
      targetNodeCommunicationMode = "string"
      taskSchedulingPolicy = {
        nodeFillType = "string"
      }
      taskSlotsPerNode = int
      userAccounts = [
        {
          elevationLevel = "string"
          linuxUserConfiguration = {
            gid = int
            sshPrivateKey = "string"
            uid = int
          }
          name = "string"
          password = "string"
          windowsUserConfiguration = {
            loginMode = "string"
          }
        }
      ]
      vmSize = "string"
    }
  })
}

Valores de propiedad

ApplicationPackageReference

Nombre Descripción Valor
identificación Identificador del paquete de aplicación que se va a instalar. Debe estar dentro de la misma cuenta por lotes que el grupo. Puede ser una referencia a una versión específica o a la versión predeterminada si existe una. string (obligatorio)
Versión Si se omite 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. Si llama directamente a la API REST, el código de estado HTTP es 409. cuerda

AutoScaleSettings

Nombre Descripción Valor
evaluationInterval Si se omite, el valor predeterminado es 15 minutos (PT15M). cuerda
fórmula Fórmula para el número deseado de nodos de proceso en el grupo. string (obligatorio)

AutoUserSpecification

Nombre Descripción Valor
elevationLevel El valor predeterminado es nonAdmin. 'Admin'
'NonAdmin'
alcance 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 que deben ser accesibles por tareas iniciales. 'Pool'
'Tarea'

AzureBlobFileSystemConfiguration

Nombre Descripción Valor
accountKey Esta propiedad es mutuamente excluyente con sasKey e identidad; exactamente uno debe especificarse. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
accountName Nombre de la cuenta de Azure Storage. string (obligatorio)
blobfuseOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
containerName Nombre del contenedor de Azure Blob Storage. string (obligatorio)
identityReference Esta propiedad es mutuamente excluyente con accountKey y sasKey; exactamente uno debe especificarse. ComputeNodeIdentityReference
relativeMountPath 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. string (obligatorio)
sasKey Esta propiedad es mutuamente excluyente tanto con accountKey como con la identidad; exactamente uno debe especificarse. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.

AzureFileShareConfiguration

Nombre Descripción Valor
accountKey Clave de cuenta de Azure Storage. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
accountName Nombre de la cuenta de Azure Storage. string (obligatorio)
azureFileUrl Este es el formato "https://{account}.file.core.windows.net/". string (obligatorio)
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
relativeMountPath 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. string (obligatorio)

BatchPoolIdentity

Nombre Descripción Valor
tipo Tipo de identidad que se usa para el grupo de Batch. 'Ninguno'
'UserAssigned' (obligatorio)
userAssignedIdentities Lista de identidades de usuario asociadas al grupo de Batch. batchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Nombre Descripción Valor

CertificateReference

Nombre Descripción Valor
identificación Identificador completo del certificado que se va a instalar en el grupo. Debe estar dentro de la misma cuenta por lotes que el grupo. string (obligatorio)
storeLocation El valor predeterminado es currentUser. Esta propiedad solo es aplicable a los grupos configurados con nodos 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. Para 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. 'CurrentUser'
"LocalMachine"
storeName Esta propiedad solo es aplicable a los grupos configurados con nodos 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. cuerda
visibilidad Qué cuentas de usuario del nodo de proceso deben tener acceso a los datos privados del certificado. Matriz de cadenas que contiene cualquiera de:
'RemoteUser'
'StartTask'
'Tarea'

CifsMountConfiguration

Nombre Descripción Valor
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
contraseña Contraseña que se va a usar para la autenticación en el sistema de archivos CIFS. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
relativeMountPath 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. string (obligatorio)
fuente URI del sistema de archivos que se va a montar. string (obligatorio)
nombre de usuario El usuario que se va a usar para la autenticación en el sistema de archivos CIFS. string (obligatorio)

CloudServiceConfiguration

Nombre Descripción Valor
osFamily Los valores posibles son: 2 - Familia de so 2, equivalente a Windows Server 2008 R2 SP1. 3 - Familia de so 3, equivalente a Windows Server 2012. 4 - Familia de so 4, equivalente a Windows Server 2012 R2. 5 - Familia de so 5, equivalente a Windows Server 2016. 6 - Familia de so 6, 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). string (obligatorio)
osVersion El valor predeterminado es * que especifica la versión más reciente del sistema operativo para la familia de sistema operativo especificada. cuerda

ComputeNodeIdentityReference

Nombre Descripción Valor
resourceId Identificador de recurso de ARM de la identidad asignada por el usuario. cuerda

ContainerConfiguration

Nombre Descripción Valor
containerImageNames Esta es la referencia de imagen completa, como se especificaría en "docker pull". Se generará una imagen del registro de Docker predeterminado a menos que la imagen esté completa con un registro alternativo. string[]
containerRegistries Si se deben descargar imágenes de un registro privado que requiera credenciales, esas credenciales deben proporcionarse aquí. containerRegistry[]
tipo Tecnología de contenedor que se va a usar. 'CriCompatible'
'DockerCompatible' (obligatorio)

ContainerRegistry

Nombre Descripción Valor
identityReference Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. ComputeNodeIdentityReference
contraseña Contraseña que se va a iniciar sesión en el servidor del Registro. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
RegistryServer Si se omite, el valor predeterminado es "docker.io". cuerda
nombre de usuario Nombre de usuario que se va a iniciar sesión en el servidor del Registro. cuerda

DataDisk

Nombre Descripción Valor
Caché Los valores son:

none: el modo de almacenamiento en caché del disco no está habilitado.
readOnly: el modo de almacenamiento en caché del disco es de solo lectura.
readWrite: el modo de almacenamiento en caché del disco es de lectura y escritura.

El valor predeterminado para el almacenamiento en caché no es ninguno. Para obtener información sobre las opciones de almacenamiento en caché, consulte: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
'Ninguno'
'ReadOnly'
"ReadWrite"
diskSizeGB Tamaño de disco inicial en GB al crear un nuevo disco de datos. int (obligatorio)
Lun 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. int (obligatorio)
storageAccountType Si se omite, el valor predeterminado es "Standard_LRS". Los valores son:

Standard_LRS: el disco de datos debe usar el almacenamiento con redundancia local estándar.
Premium_LRS: el disco de datos debe usar el almacenamiento con redundancia local Premium.
"Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

DeploymentConfiguration

Nombre Descripción Valor
cloudServiceConfiguration 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". CloudServiceConfiguration
virtualMachineConfiguration Esta propiedad y cloudServiceConfiguration son mutuamente excluyentes y se debe especificar una de las propiedades. VirtualMachineConfiguration

DiffDiskSettings

Nombre Descripción Valor
colocación El usuario puede usar esta propiedad en la solicitud para elegir en qué ubicación debe estar el sistema operativo. Por ejemplo, el espacio en disco de caché para el aprovisionamiento de discos del sistema operativo efímero. Para 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 /azure/virtual-machines/windows/efímero-os-disks#size-requirements y máquinas virtuales Linux en /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. 'CacheDisk'

DiskEncryptionConfiguration

Nombre Descripción Valor
Objetivos En el grupo de Linux, solo se admite "TemporaryDisk"; en el grupo de Windows, se debe especificar "OsDisk" y "TemporaryDisk". Matriz de cadenas que contiene cualquiera de:
'OsDisk'
'TemporaryDisk'

EnvironmentSetting

Nombre Descripción Valor
nombre Nombre de la variable de entorno. string (obligatorio)
valor Valor de la variable de entorno. cuerda

FixedScaleSettings

Nombre Descripción Valor
nodeDeallocationOption Si se omite, el valor predeterminado es Requeue. 'Requeue'
'RetainedData'
'TaskCompletion'
'Terminate'
resizeTimeout El valor predeterminado es de 15 minutos. Los valores de tiempo de espera usan el formato ISO 8601. Por ejemplo, use PT10M durante 10 minutos. El valor mínimo es de 5 minutos. Si especifica un valor inferior a 5 minutos, el servicio Batch rechaza la solicitud con un error; Si llama directamente a la API REST, el código de estado HTTP es 400 (solicitud incorrecta). cuerda
targetDedicatedNodes Al menos uno de targetDedicatedNodes, se deben establecer targetLowPriorityNodes. Int
targetLowPriorityNodes Al menos uno de targetDedicatedNodes, se deben establecer targetLowPriorityNodes. Int

ImageReference

Nombre Descripción Valor
identificación Esta propiedad es mutuamente excluyente con otras propiedades. La imagen de Azure Compute Gallery debe tener réplicas en la misma región que la cuenta de Azure Batch. Para obtener información sobre la configuración del firewall para que el agente de nodo de Batch se comunique con el servicio Batch, consulte /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. cuerda
ofrecer Por ejemplo, UbuntuServer o WindowsServer. cuerda
editor Por ejemplo, Canonical o MicrosoftWindowsServer. cuerda
Sku Por ejemplo, 18.04-LTS o 2022-datacenter. cuerda
Versión 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". cuerda

InboundNatPool

Nombre Descripción Valor
backendPort Debe ser único dentro de un grupo de Batch. 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. int (obligatorio)
frontendPortRangeEnd Los valores aceptables oscilan entre 1 y 65534, excepto los puertos de 50000 a 55000 que están reservados por el servicio Batch. Todos los intervalos de un grupo deben ser distintos y no se pueden superponer. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400. int (obligatorio)
frontendPortRangeStart 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. Si se proporcionan valores reservados o superpuestos, se produce un error en la solicitud con el código de estado HTTP 400. int (obligatorio)
nombre El nombre debe ser único dentro de un grupo de Batch, 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. string (obligatorio)
networkSecurityGroupRules El número máximo de reglas que se pueden especificar en todos los puntos de conexión de un grupo de Batch es 25. Si no se especifica ninguna regla 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. networkSecurityGroupRule[]
protocolo Protocolo del punto de conexión. 'TCP'
'UDP' (obligatorio)

LinuxUserConfiguration

Nombre Descripción Valor
Gid Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica, el sistema operativo subyacente elige el gid. Int
sshPrivateKey La clave privada no debe estar protegida con contraseña. La clave privada se usa para configurar automáticamente la autenticación basada en claves asimétricas para SSH entre nodos de 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 (no se realiza ninguna modificación del directorio .ssh del usuario). cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro.
Uid Las propiedades uid y gid deben especificarse juntas o no en absoluto. Si no se especifica, el sistema operativo subyacente elige el uid. Int

ManagedDisk

Nombre Descripción Valor
storageAccountType Tipo de cuenta de almacenamiento para su uso en la creación de discos de datos o disco del sistema operativo. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

MetadataItem

Nombre Descripción Valor
nombre Nombre del elemento de metadatos. string (obligatorio)
valor Valor del elemento de metadatos. string (obligatorio)

Microsoft.Batch/batchAccounts/pools

Nombre Descripción Valor
identidad Tipo de identidad que se usa para el grupo de Batch. BatchPoolIdentity
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 1
Patrón = ^[a-zA-Z0-9_-]+$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: batchAccounts
Propiedades Propiedades asociadas al grupo. poolProperties de
tipo El tipo de recurso "Microsoft.Batch/batchAccounts/pools@2023-11-01"

MountConfiguration

Nombre Descripción Valor
azureBlobFileSystemConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. AzureFileShareConfiguration
cifsMountConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. cifsMountConfiguration de
nfsMountConfiguration Esta propiedad es mutuamente excluyente con todas las demás propiedades. NFSMountConfiguration

NetworkConfiguration

Nombre Descripción Valor
dynamicVnetAssignmentScope Ámbito de la asignación dinámica de red virtual. 'job'
'none'
enableAcceleratedNetworking 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 rendimiento de red mejorado. Para más información, consulte :/azure/virtual-network/accelerated-networking-overview. Bool
endpointConfiguration La configuración del punto de conexión del grupo solo se admite en grupos con la propiedad virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Esta propiedad solo se admite en Grupos con la propiedad virtualMachineConfiguration. publicIPAddressConfiguration
subnetId 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 dar cabida al número de nodos del grupo. Si la subred no tiene suficientes direcciones IP libres, el grupo asignará parcialmente nodos de proceso 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 Control de acceso (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 de proceso. Para comprobarlo, compruebe si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado. Si un NSG deniega la comunicación con los nodos de proceso de la subred especificada, el servicio Batch establecerá el estado de los nodos de proceso en inutilizable. Si la red virtual especificada tiene algún grupo de seguridad de red (NSG) asociado, se deben habilitar algunos puertos del sistema reservados para la comunicación entrante. En el caso de 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. En el caso de 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. En el caso de los grupos de cloudServiceConfiguration, solo se admiten redes virtuales "clásicas". Para más información, consulte : /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration cuerda

NetworkSecurityGroupRule

Nombre Descripción Valor
acceso Acción que se debe realizar para una dirección IP, un intervalo de subred o una etiqueta especificados. 'Permitir'
'Deny' (obligatorio)
prioridad Las prioridades dentro de un grupo deben ser únicas y se evalúan en orden de prioridad. Cuanto menor sea el número, mayor será la prioridad. 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. int (obligatorio)
sourceAddressPrefix 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. string (obligatorio)
sourcePortRanges Los valores válidos son '*' (para todos los puertos 0 - 65535) o matrices de puertos o intervalos de puertos (es decir, 100-200). Los puertos deben estar comprendidos entre 0 y 65535 y los intervalos de puertos o puertos no se pueden superponer. Si se proporcionan otros valores, se produce un error en la solicitud con el código de estado HTTP 400. El valor predeterminado será *. string[]

NFSMountConfiguration

Nombre Descripción Valor
mountOptions Estas son opciones de "net use" en Windows y opciones de "montaje" en Linux. cuerda
relativeMountPath 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. string (obligatorio)
fuente URI del sistema de archivos que se va a montar. string (obligatorio)

NodePlacementConfiguration

Nombre Descripción Valor
política Directiva de asignación que usa Batch Service para aprovisionar los nodos. Si no se especifica, Batch usará la directiva regional. "Regional"
'Zonal'

OSDisk

Nombre Descripción Valor
Caché Tipo de almacenamiento en caché que se va a habilitar para el disco. 'Ninguno'
'ReadOnly'
"ReadWrite"
diskSizeGB Tamaño de disco inicial en GB al crear un nuevo disco del sistema operativo. Int
ephemeralOSDiskSettings Especifica la configuración de disco efímero para el disco del sistema operativo utilizado por la máquina virtual. DiffDiskSettings
managedDisk managedDisk
writeAcceleratorEnabled Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco. Bool

PoolEndpointConfiguration

Nombre Descripción Valor
inboundNatPools El número máximo de grupos NAT entrantes por grupo de Batch 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. inboundNatPool[] (obligatorio)

PoolProperties

Nombre Descripción Valor
applicationLicenses La lista de licencias de aplicación debe ser un subconjunto de licencias de aplicaciones de servicio de Batch disponibles. Si se solicita una licencia que no se admite, se producirá un error en la creación del grupo. string[]
applicationPackages Los cambios en las referencias del paquete de aplicación afectan a todos los nodos de proceso nuevos que se unen al grupo, pero no afectan a los nodos de proceso que ya están en el grupo hasta que se reinician o se vuelven a crear imágenes. Hay un máximo de 10 referencias de paquete de aplicación en cualquier grupo determinado. ApplicationPackageReference[]
Certificados En el caso de los nodos de proceso 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. Para los certificados con visibilidad de "remoteUser", se crea un directorio "certs" en el directorio principal del usuario (por ejemplo, /home/{user-name}/certs) y los certificados se colocan en ese directorio.

Advertencia: esta propiedad está en desuso y se quitará después de febrero de 2024. Use el de extensión de Azure KeyVault de .
certificateReference[]
deploymentConfiguration El uso de CloudServiceConfiguration especifica que los nodos deben crearse mediante Azure Cloud Services (PaaS), mientras que VirtualMachineConfiguration usa Azure Virtual Machines (IaaS). DeploymentConfiguration
displayName El nombre para mostrar no debe ser único y puede contener caracteres Unicode de hasta una longitud máxima de 1024. cuerda
interNodeCommunication Esto impone restricciones en las que se pueden asignar nodos al grupo. La habilitación de este valor puede reducir la posibilidad de asignar el número solicitado de nodos en el grupo. Si no se especifica, este valor tiene como valor predeterminado "Disabled". 'Deshabilitado'
'Habilitado'
metadatos El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario. metadataItem[]
mountConfiguration Esto admite Azure Files, NFS, CIFS/SMB y Blobfuse. mountConfiguration[]
networkConfiguration Configuración de red de un grupo. networkConfiguration
resourceTags Etiquetas definidas por el usuario que se van a asociar 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". PoolPropertiesResourceTags
scaleSettings Define el tamaño deseado del grupo. Esto puede ser "fixedScale" donde se especifica targetDedicatedNodes solicitado o "autoScale", que define una fórmula que se vuelve a evaluar periódicamente. Si no se especifica esta propiedad, el grupo tendrá una escala fija con 0 targetDedicatedNodes. scaleSettings
startTask En una operación PATCH (actualización), esta propiedad se puede establecer en un objeto vacío para quitar la tarea de inicio del grupo. StartTask
targetNodeCommunicationMode Si se omite, el valor predeterminado es Default. 'Clásico'
'Valor predeterminado'
"Simplificado"
taskSchedulingPolicy Si no se especifica, el valor predeterminado se propaga. TaskSchedulingPolicy
taskSlotsPerNode El valor predeterminado es 1. El valor máximo es el menor de 4 veces el número de núcleos de vmSize del grupo o 256. Int
userAccounts Lista de cuentas de usuario que se van a crear en cada nodo del grupo. UserAccount []
vmSize Para obtener información sobre los tamaños disponibles de las máquinas virtuales para los grupos de Cloud Services (grupos creados con cloudServiceConfiguration), consulte Tamaños de Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch admite todos los tamaños de máquina virtual de Cloud Services, excepto ExtraSmall. Para obtener información sobre los tamaños de máquina virtual disponibles para los grupos que usan imágenes de Marketplace de máquinas virtuales (grupos creados con virtualMachineConfiguration), consulte Tamaños de máquinas virtuales (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o Tamaños de máquinas virtuales (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). cuerda

PoolPropertiesResourceTags

Nombre Descripción Valor

PublicIPAddressConfiguration

Nombre Descripción Valor
ipAddressIds El número de direcciones IP especificadas aquí limita el tamaño máximo del grupo: 100 nodos dedicados o 100 nodos de spot o prioridad baja se pueden 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}. string[]
Provisión El valor predeterminado es BatchManaged. "BatchManaged"
'NoPublicIPAddresses'
"UserManaged"

ResourceFile

Nombre Descripción Valor
autoStorageContainerName Las propiedades autoStorageContainerName, storageContainerUrl y httpUrl son mutuamente excluyentes y se debe especificar una de ellas. cuerda
blobPrefix 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. cuerda
fileMode Esta propiedad solo se aplica a los archivos que se descargan en los nodos de proceso de Linux. Se omitirá si se especifica para un resourceFile que se descargará en un nodo de Windows. Si no se especifica esta propiedad para un nodo de Linux, se aplica un valor predeterminado de 0770 al archivo. cuerda
filePath Si se especifica la propiedad httpUrl, se requiere filePath y describe la ruta de acceso a la que se descargará el archivo, incluido el nombre de archivo. De lo contrario, si se especifica la propiedad autoStorageContainerName o storageContainerUrl, filePath es opcional y es el directorio al que descargar los archivos. En el caso de que filePath se use como directorio, cualquier estructura de directorios que ya esté asociada a los datos de entrada se conservará en su totalidad y se anexará al directorio filePath especificado. La ruta de acceso relativa especificada no puede dividirse en el directorio de trabajo de la tarea (por ejemplo, mediante '..'). cuerda
httpUrl 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. cuerda
identityReference Referencia a una identidad asignada por el usuario asociada al grupo de Batch que usará un nodo de proceso. ComputeNodeIdentityReference
storageContainerUrl 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. cuerda

ScaleSettings

Nombre Descripción Valor
escalado automático Esta propiedad y fixedScale son mutuamente excluyentes y se debe especificar una de las propiedades. AutoScaleSettings
fixedScale Esta propiedad y autoScale son mutuamente excluyentes y se debe especificar una de las propiedades. fixedScaleSettings

SecurityProfile

Nombre Descripción Valor
encryptionAtHost 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 recurso o el disco temporal en el propio host. Bool
securityType Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. "trustedLaunch"
uefiSettings Especifica la configuración de seguridad, como el arranque seguro y vTPM que se usa al crear la máquina virtual. UefiSettings

ServiceArtifactReference

Nombre Descripción Valor
identificación Identificador de referencia del artefacto de servicio en forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} string (obligatorio)

StartTask

Nombre Descripción Valor
commandLine 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. Obligatorio si se especifican otras propiedades de startTask. cuerda
containerSettings Cuando se especifica esto, todos los directorios se asignan de forma recursiva debajo del AZ_BATCH_NODE_ROOT_DIR (la raíz de los directorios de Azure Batch en el nodo) se asignan al contenedor, todas las variables de entorno de tareas se asignan al contenedor y la línea de comandos de la tarea se ejecuta en el contenedor. TaskContainerSettings
environmentSettings Lista de opciones de configuración de variables de entorno para la tarea de inicio. EnvironmentSetting[]
maxTaskRetryCount 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, volverá a intentarlo hasta este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta la tarea hasta 4 veces (un intento inicial y 3 reintentos). Si el número máximo de reintentos es 0, el servicio Batch no vuelve a intentar la tarea. Si el número máximo de reintentos es -1, el servicio Batch reintenta la tarea sin límite. El valor predeterminado es 0 Int
resourceFiles Lista de archivos que el servicio Batch descargará en el nodo de proceso antes de ejecutar la línea de comandos. ResourceFile []
userIdentity Si se omite, la tarea se ejecuta como un usuario no administrativo único para la tarea. UserIdentity de
waitForSuccess Si es true y la tarea de inicio produce un error en un nodo de proceso, el servicio Batch reintenta la tarea de inicio hasta su recuento 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 de proceso inutilizable y no programará tareas en él. Esta condición se puede detectar mediante el estado del nodo y los detalles del error de programación. Si es false, el servicio Batch no esperará a que se complete la tarea de inicio. En este caso, otras tareas pueden empezar a ejecutarse en el nodo de proceso mientras la tarea de inicio todavía se está ejecutando; e incluso si se produce un error en la tarea de inicio, las nuevas tareas seguirán programando en el nodo. El valor predeterminado es true. Bool

TaskContainerSettings

Nombre Descripción Valor
containerRunOptions Estas opciones adicionales se proporcionan como argumentos para el comando "docker create", además de las controladas por el servicio Batch. cuerda
imageName Esta es la referencia de imagen completa, como se especificaría en "docker pull". Si no se proporciona ninguna etiqueta como parte del nombre de la imagen, la etiqueta ":latest" se usa como valor predeterminado. string (obligatorio)
registro Esta configuración se puede omitir si ya se proporcionó en la creación del grupo. containerRegistry de
workingDirectory Marca para indicar dónde está el directorio de trabajo de la tarea de contenedor. El valor predeterminado es "taskWorkingDirectory". 'ContainerImageDefault'
'TaskWorkingDirectory'

TaskSchedulingPolicy

Nombre Descripción Valor
nodeFillType Cómo se deben distribuir las tareas entre nodos de proceso. 'Pack'
'Spread' (obligatorio)

UefiSettings

Nombre Descripción Valor
secureBootEnabled Especifica si se debe habilitar el arranque seguro en la máquina virtual. Bool
vTpmEnabled Especifica si vTPM debe estar habilitado en la máquina virtual. Bool

UserAccount

Nombre Descripción Valor
elevationLevel nonAdmin: el usuario automático es un usuario estándar sin acceso elevado. admin: el usuario automático es un usuario con acceso elevado y funciona con permisos de administrador completos. El valor predeterminado es nonAdmin. 'Admin'
'NonAdmin'
linuxUserConfiguration Esta propiedad se omite si se especifica en un grupo de Windows. Si no se especifica, el usuario se crea con las opciones predeterminadas. LinuxUserConfiguration
nombre Nombre de la cuenta de usuario. Los nombres pueden contener caracteres Unicode de hasta una longitud máxima de 20. string (obligatorio)
contraseña Contraseña de la cuenta de usuario. cuerda

Restricciones:
Valor confidencial. Pase como parámetro seguro. (obligatorio)
windowsUserConfiguration 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. windowsUserConfiguration

UserAssignedIdentities

Nombre Descripción Valor

UserIdentity

Nombre Descripción Valor
autoUser Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos. AutoUserSpecification
nombre de usuario Las propiedades userName y autoUser son mutuamente excluyentes; debe especificar uno pero no ambos. cuerda

VirtualMachineConfiguration

Nombre Descripción Valor
containerConfiguration Si se especifica, la instalación se realiza en cada nodo del grupo para permitir que las tareas se ejecuten en contenedores. Todas las tareas normales y las tareas del administrador de trabajos que se ejecutan en este grupo deben especificar la propiedad containerSettings y todas las demás tareas pueden especificarla. containerConfiguration
dataDisks Esta propiedad debe especificarse si los nodos de proceso del grupo deben tener discos de datos vacíos conectados a ellos. DataDisk []
diskEncryptionConfiguration Si se especifica, el cifrado se realiza en cada nodo del grupo durante el aprovisionamiento de nodos. DiskEncryptionConfiguration
Extensiones Si se especifica, las extensiones mencionadas en esta configuración se instalarán en cada nodo. vmExtension[]
imageReference Referencia a una imagen de Marketplace de Azure Virtual Machines o al recurso De imagen de Azure de una máquina virtual personalizada. Para obtener la lista de todas las imageReferences verificadas por Azure Batch, consulte la operación "Enumeración de SKU de agente de nodo compatibles". imageReference (obligatorio)
licenseType Esto solo se aplica a las imágenes que contienen el sistema operativo Windows y solo se deben usar cuando contenga licencias locales válidas para los nodos 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.
cuerda
nodeAgentSkuId El agente de nodo de Batch es un programa que se ejecuta en cada nodo del grupo y proporciona la interfaz de comando y control entre el nodo y el servicio Batch. Hay diferentes implementaciones del agente de nodo, conocidas como SKU, para diferentes sistemas operativos. Debe especificar una SKU del agente de nodo que coincida con la referencia de imagen seleccionada. Para obtener la lista de SKU de agente de nodo compatibles junto con su lista de referencias de imágenes verificadas, consulte la operación "Enumerar SKU de agente de nodo compatibles". string (obligatorio)
nodePlacementConfiguration Esta configuración especificará reglas sobre cómo se asignarán físicamente los nodos del grupo. NodePlacementConfiguration
osDisk Contiene la configuración de los valores de OSDisk efímeros. OSDisk
securityProfile Especifica la configuración del perfil de seguridad para la máquina virtual o el conjunto de escalado de máquinas virtuales. securityProfile 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} serviceArtifactReference
windowsConfiguration Esta propiedad no se debe especificar si imageReference especifica una imagen del sistema operativo Linux. windowsConfiguration

VMExtension

Nombre Descripción Valor
autoUpgradeMinorVersion Indica si la extensión debe usar una versión secundaria más reciente si está 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. Bool
enableAutomaticUpgrade Indica si la plataforma debe actualizar automáticamente la extensión si hay una versión más reciente de la extensión disponible. Bool
nombre Nombre de la extensión de máquina virtual. string (obligatorio)
protectedSettings La extensión puede contener protectedSettings o protectedSettingsFromKeyVault o ninguna configuración protegida. cualquier
provisionAfterExtensions Colección de nombres de extensión después de los cuales se debe aprovisionar esta extensión. string[]
editor Nombre del publicador de controladores de extensión. string (obligatorio)
Configuración Configuración pública con formato JSON para la extensión. cualquier
tipo Tipo de las extensiones. string (obligatorio)
typeHandlerVersion Versión del controlador de script. cuerda

WindowsConfiguration

Nombre Descripción Valor
enableAutomaticUpdates Si se omite, el valor predeterminado es true. Bool

WindowsUserConfiguration

Nombre Descripción Valor
loginMode Especifica el modo de inicio de sesión para el usuario. El valor predeterminado de los grupos de VirtualMachineConfiguration es el modo interactivo y para los grupos de CloudServiceConfiguration es el modo por lotes. 'Batch'
'Interactivo'