Partilhar via

Microsoft.Batch batchAccounts/pools 2023-11-01

  • Artigo

Definição de recursos do bíceps

O tipo de recurso batchAccounts/pools pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Batch/batchAccounts/pools, adicione o seguinte Bíceps ao seu modelo.

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 propriedade

ApplicationPackageReference

Designação Descrição Valor
ID A ID do pacote de aplicativo a ser instalado. Isso deve estar dentro da mesma conta de lote que o pool. Isso pode ser uma referência a uma versão específica ou a versão padrão, se existir. string (obrigatório)
Versão Se isso for omitido e nenhuma versão padrão for especificada para este aplicativo, a solicitação falhará com o código de erro InvalidApplicationPackageReferences. Se você estiver chamando a API REST diretamente, o código de status HTTP será 409. string

AutoScaleSettings

Designação Descrição Valor
avaliaçãoIntervalo Se omitido, o valor padrão é 15 minutos (PT15M). string
fórmula Uma fórmula para o número desejado de nós de computação no pool. string (obrigatório)

AutoUserSpecification

Designação Descrição Valor
elevaçãoNível O valor padrão é nonAdmin. 'Administrador'
'Não administrador'
Âmbito de aplicação O valor padrão é Pool. Se o pool estiver executando o Windows, um valor de Task deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa muta o registro de uma forma que pode afetar outras tarefas, ou se certificados foram especificados no pool que não deve ser acessível por tarefas normais, mas deve ser acessível por tarefas iniciais. 'Piscina'
'Tarefa'

AzureBlobFileSystemConfiguration

Designação Descrição Valor
accountKey Esta propriedade é mutuamente exclusiva com sasKey e identidade; exatamente um deve ser especificado. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
nomedaconta; O nome da Conta de Armazenamento do Azure. string (obrigatório)
blobfuseOptions Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
containerName O nome do Contêiner de Armazenamento de Blob do Azure. string (obrigatório)
identityReference Esta propriedade é mutuamente exclusiva com accountKey e sasKey; exatamente um deve ser especificado. ComputeNodeIdentityReference
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
sasKey Esta propriedade é mutuamente exclusiva com accountKey e identity; exatamente um deve ser especificado. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.

AzureFileShareConfiguration

Designação Descrição Valor
accountKey A chave da conta do Armazenamento do Azure. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
nomedaconta; O nome da conta de Armazenamento do Azure. string (obrigatório)
azureFileUrl Este é o formato 'https://{account}.file.core.windows.net/'. string (obrigatório)
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)

BatchPoolIdentity

Designação Descrição Valor
tipo O tipo de identidade usado para o pool de lotes. 'Nenhuma'
'UserAssigned' (obrigatório)
userAssignedIdentities A lista de identidades de usuário associadas ao pool de lotes. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Designação Descrição Valor

CertificadoReferência

Designação Descrição Valor
ID A ID totalmente qualificada do certificado a ser instalado no pool. Isso deve estar dentro da mesma conta de lote que o pool. string (obrigatório)
storeLocalização O valor padrão é currentUser. Essa propriedade é aplicável somente para pools configurados com nós do Windows (ou seja, criados com cloudServiceConfiguration ou com virtualMachineConfiguration usando uma referência de imagem do Windows). Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório inicial do usuário (por exemplo, /home/{user-name}/certs) e os certificados são colocados nesse diretório. 'CurrentUser'
'LocalMachine'
nome_da_loja Essa propriedade é aplicável somente para pools configurados com nós do Windows (ou seja, criados com cloudServiceConfiguration ou com virtualMachineConfiguration usando uma referência de imagem do Windows). Os nomes de armazenamento comuns incluem: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mas qualquer nome de loja personalizado também pode ser usado. O valor padrão é My. string
Visibilidade Quais contas de usuário no nó de computação devem ter acesso aos dados privados do certificado. Matriz de cadeia de caracteres contendo qualquer uma das:
'RemoteUser'
'StartTask'
'Tarefa'

CifsMountConfiguration

Designação Descrição Valor
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
palavra-passe A senha a ser usada para autenticação no sistema de arquivos CIFS. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
fonte O URI do sistema de arquivos a ser montado. string (obrigatório)
nome de utilizador O usuário a ser usado para autenticação no sistema de arquivos CIFS. string (obrigatório)

CloudServiceConfiguration

Designação Descrição Valor
osFamília Os valores possíveis são: 2 - OS Family 2, equivalente ao Windows Server 2008 R2 SP1. 3 - OS Family 3, equivalente ao Windows Server 2012. 4 - Família OS 4, equivalente ao Windows Server 2012 R2. 5 - Família OS 5, equivalente ao Windows Server 2016. 6 - OS Family 6, equivalente ao Windows Server 2019. Para obter mais informações, consulte Versões do SO convidado do Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). string (obrigatório)
osVersão O valor padrão é *, que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada. string

ComputeNodeIdentityReference

Designação Descrição Valor
resourceId O ID de recurso ARM da identidade atribuída ao usuário. string

ContainerConfiguration

Designação Descrição Valor
containerImageNames Esta é a referência de imagem completa, como seria especificado para "docker pull". Uma imagem será originada do registro padrão do Docker, a menos que a imagem seja totalmente qualificada com um registro alternativo. string[]
contentoresRegistos Se alguma imagem deve ser baixada de um registro privado que requer credenciais, então essas credenciais devem ser fornecidas aqui. ContainerRegistry[]
tipo A tecnologia de contentores a utilizar. 'CriCompatível'
'DockerCompatible' (obrigatório)

ContainerRegistry

Designação Descrição Valor
identityReference A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. ComputeNodeIdentityReference
palavra-passe A palavra-passe para iniciar sessão no servidor de registo. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
registryServer [en] Se omitido, o padrão é "docker.io". string
nome de utilizador O nome de utilizador para iniciar sessão no servidor de registo. string

Disco de dados

Designação Descrição Valor
armazenamento em cache Os valores são:

none - O modo de cache para o disco não está ativado.
readOnly - O modo de cache do disco é somente leitura.
readWrite - O modo de cache para o disco é leitura e gravação.

O valor padrão para cache é none. Para obter informações sobre as opções de cache, consulte: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.		 'Nenhuma'
'Somente leitura'
'ReadWrite'
diskSizeGB O tamanho inicial do disco em GB ao criar um novo disco de dados. int (obrigatório)
LUN O lun é usado para identificar exclusivamente cada disco de dados. Se anexar vários discos, cada um deve ter um lun distinto. O valor deve estar entre 0 e 63, inclusive. int (obrigatório)
storageAccountType Se omitido, o padrão é "Standard_LRS". Os valores são:

Standard_LRS - O disco de dados deve usar armazenamento padrão localmente redundante.
Premium_LRS - O disco de dados deve usar armazenamento redundante local premium.		 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'

DeploymentConfiguration

Designação Descrição Valor
cloudServiceConfiguration Essa propriedade e virtualMachineConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Esta propriedade não pode ser especificada se a conta Batch foi criada com sua propriedade poolAllocationMode definida como 'UserSubscription'. CloudServiceConfiguration
virtualMachineConfiguration Esta propriedade e cloudServiceConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. VirtualMachineConfiguration

DiffDiskSettings

Designação Descrição Valor
colocação Essa propriedade pode ser usada pelo usuário na solicitação para escolher em qual local o sistema operacional deve estar. por exemplo, espaço em disco de cache para provisionamento de disco do sistema operacional efêmero. Para obter mais informações sobre os requisitos de tamanho de disco do Ephemeral OS, consulte Ephemeral OS disk size requirements for Windows VMs em /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e Linux VMs em /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. 'CacheDisk'

DiskEncryptionConfiguration

Designação Descrição Valor
Objetivos No pool Linux, apenas "TemporaryDisk" é suportado; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Matriz de cadeia de caracteres contendo qualquer uma das:
'OsDisk'
'DiscoTemporário'

AmbienteConfiguração

Designação Descrição Valor
Designação O nome da variável de ambiente. string (obrigatório)
valor O valor da variável de ambiente. string

FixedScaleSettings

Designação Descrição Valor
nodeDeallocationOption Se omitido, o valor padrão é Requeue. 'Refila de espera'
'Dados retidos'
'Conclusão de tarefas'
'Terminar'
redimensionarTimeout O valor padrão é 15 minutos. Os valores de tempo limite usam o formato ISO 8601. Por exemplo, use PT10M por 10 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço em lote rejeitará a solicitação com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). string
targetDedicatedNodes Pelo menos um dos targetDedicatedNodes, targetLowPriorityNodes deve ser definido. Int
targetLowPriorityNodes Pelo menos um dos targetDedicatedNodes, targetLowPriorityNodes deve ser definido. Int

ImageReference

Designação Descrição Valor
ID Esta propriedade é mutuamente exclusiva com outras propriedades. A Imagem da Galeria de Computação do Azure deve ter réplicas na mesma região que a conta do Lote do Azure. Para obter informações sobre as configurações de firewall para o agente do nó Batch se comunicar com o serviço Batch, consulte /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. string
oferta Por exemplo, UbuntuServer ou WindowsServer. string
editora Por exemplo, Canonical ou MicrosoftWindowsServer. string
SKU Por exemplo, 18.04-LTS ou 2022-datacenter. string
Versão Um valor de 'mais recente' pode ser especificado para selecionar a versão mais recente de uma imagem. Se omitido, o padrão é 'mais recente'. string

InboundNatPool

Designação Descrição Valor
backendPort Isso deve ser exclusivo dentro de um pool de lotes. Os valores aceitáveis situam-se entre 1 e 65535, exceto para 22, 3389, 29876 e 29877, uma vez que estes são reservados. Se algum valor reservado for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
frontendPortRangeEnd Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas pelo serviço de lote. Todos os intervalos dentro de um pool devem ser distintos e não podem se sobrepor. Se algum valor reservado ou sobreposto for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
frontendPortRangeStart Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas. Todos os intervalos dentro de um pool devem ser distintos e não podem se sobrepor. Se algum valor reservado ou sobreposto for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
Designação O nome deve ser exclusivo dentro de um pool de lotes, pode conter letras, números, sublinhados, pontos e hífenes. Os nomes devem começar com uma letra ou número, devem terminar com uma letra, número ou sublinhado e não podem exceder 77 caracteres. Se algum valor inválido for fornecido, a solicitação falhará com o código de status HTTP 400. string (obrigatório)
networkSecurityGroupRules O número máximo de regras que podem ser especificadas em todos os pontos de extremidade em um pool de lotes é 25. Se nenhuma regra de grupo de segurança de rede for especificada, uma regra padrão será criada para permitir o acesso de entrada à porta de back-end especificada. Se o número máximo de regras de grupo de segurança de rede for excedido, a solicitação falhará com o código de status HTTP 400. NetworkSecurityGroupRule[]
protocolo O protocolo do ponto de extremidade. 'TCP'
'UDP' (obrigatório)

LinuxUserConfiguration

Designação Descrição Valor
GID As propriedades uid e gid devem ser especificadas juntas ou não devem ser especificadas de todo. Se não for especificado, o sistema operacional subjacente seleciona o gid. Int
sshPrivateKey A chave privada não deve ser protegida por senha. A chave privada é usada para configurar automaticamente a autenticação baseada em chave assimétrica para SSH entre nós em um pool Linux quando a propriedade enableInterNodeCommunication do pool é true (ela é ignorada se enableInterNodeCommunication for false). Ele faz isso colocando o par de chaves no diretório .ssh do usuário. Se não for especificado, o SSH sem senha não será configurado entre nós (nenhuma modificação do diretório .ssh do usuário será feita). string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
UID As propriedades uid e gid devem ser especificadas juntas ou não devem ser especificadas de todo. Se não for especificado, o sistema operacional subjacente seleciona o uid. Int

ManagedDisk

Designação Descrição Valor
storageAccountType O tipo de conta de armazenamento para uso na criação de discos de dados ou disco do sistema operacional. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'

MetadataItem

Designação Descrição Valor
Designação O nome do item de metadados. string (obrigatório)
valor O valor do item de metadados. string (obrigatório)

Microsoft.Batch/batchAccounts/pools

Designação Descrição Valor
identidade O tipo de identidade usado para o pool de lotes. BatchPoolIdentity
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[a-zA-Z0-9_-]+$ (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para recurso do tipo: batchAccounts
propriedades As propriedades associadas ao pool. PoolProperties

MountConfiguration

Designação Descrição Valor
azureBlobFileSystemConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. AzureFileShareConfiguration
cifsMountConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. CifsMountConfiguration
nfsMountConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. NFSMountConfiguration

Configuração de rede

Designação Descrição Valor
dynamicVnetAssignmentScope O escopo da atribuição dinâmica de vnet. 'Trabalho'
'nenhuma'
enableAcceleratedNetworking A rede acelerada permite a virtualização de E/S de raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho de rede. Para obter mais detalhes, consulte: /azure/virtual-network/accelerated-networking-overview. Bool
endpointConfiguration A configuração do ponto de extremidade do pool só é suportada em pools com a propriedade virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Essa propriedade só é suportada em Pools com a propriedade virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId A rede virtual deve estar na mesma região e assinatura que a conta do Lote do Azure. A sub-rede especificada deve ter endereços IP livres suficientes para acomodar o número de nós no pool. Se a sub-rede não tiver endereços IP livres suficientes, o pool alocará parcialmente os nós de computação e ocorrerá um erro de redimensionamento. A entidade de serviço 'MicrosoftAzureBatch' deve ter a função 'Colaborador de Máquina Virtual Clássica' Role-Based Controle de Acesso (RBAC) para a VNet especificada. A sub-rede especificada deve permitir a comunicação do serviço Lote do Azure para poder agendar tarefas nos nós de computação. Isso pode ser verificado verificando se a rede virtual especificada tem algum NSG (Network Security Groups) associado. Se a comunicação com os nós de computação na sub-rede especificada for negada por um NSG, o serviço em lote definirá o estado dos nós de computação como inutilizável. Se a VNet especificada tiver algum NSG (Network Security Groups) associado, algumas portas de sistema reservadas deverão ser habilitadas para comunicação de entrada. Para pools criados com uma configuração de máquina virtual, habilite as portas 29876 e 29877, bem como a porta 22 para Linux e a porta 3389 para Windows. Para pools criados com uma configuração de serviço de nuvem, habilite as portas 10100, 20100 e 30100. Habilite também as conexões de saída para o Armazenamento do Azure na porta 443. Para pools cloudServiceConfiguration, apenas VNETs 'clássicas' são suportadas. Para obter mais detalhes, consulte: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration string

NetworkSecurityGroupRule

Designação Descrição Valor
Acesso A ação que deve ser tomada para um endereço IP, intervalo de sub-rede ou tag especificado. 'Permitir'
'Negar' (obrigatório)
prioridade As prioridades dentro de um pool devem ser únicas e são avaliadas por ordem de prioridade. Quanto menor o número, maior a prioridade. Por exemplo, as regras podem ser especificadas com números de ordem de 150, 250 e 350. A regra com o número de ordem 150 tem precedência sobre a regra que tem uma ordem de 250. As prioridades permitidas são de 150 a 4096. Se algum valor reservado ou duplicado for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
sourceAddressPrefix Os valores válidos são um único endereço IP (ou seja, 10.10.10.10), sub-rede IP (ou seja, 192.168.1.0/24), tag padrão ou * (para todos os endereços). Se quaisquer outros valores forem fornecidos, a solicitação falhará com o código de status HTTP 400. string (obrigatório)
sourcePortRanges Os valores válidos são '*' (para todas as portas 0 - 65535) ou matrizes de portas ou intervalos de portas (ou seja, 100-200). As portas devem estar no intervalo de 0 a 65535 e os intervalos de portas ou portas não podem se sobrepor. Se quaisquer outros valores forem fornecidos, a solicitação falhará com o código de status HTTP 400. O valor padrão será *. string[]

NFSMountConfiguration

Designação Descrição Valor
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
fonte O URI do sistema de arquivos a ser montado. string (obrigatório)

NodePlacementConfiguration

Designação Descrição Valor
política Política de alocação usada pelo Batch Service para provisionar os nós. Se não for especificado, o Batch usará a política regional. 'Regional'
'Zonal'

OSDisk

Designação Descrição Valor
armazenamento em cache O tipo de cache a ser habilitado para o disco. 'Nenhuma'
'Somente leitura'
'ReadWrite'
diskSizeGB O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional. Int
ephemeralOSDiskSettings Especifica as configurações de disco efêmeras para o disco do sistema operacional usado pela máquina virtual. DiffDiskSettings
managedDisk ManagedDisk
writeAcceleratorEnabled Especifica se writeAccelerator deve ser habilitado ou desabilitado no disco. Bool

PoolEndpointConfiguration

Designação Descrição Valor
inboundNatPools O número máximo de pools de NAT de entrada por pool de lotes é 5. Se o número máximo de pools NAT de entrada for excedido, a solicitação falhará com o código de status HTTP 400. Isso não pode ser especificado se o IPAddressProvisioningType for NoPublicIPAddresses. InboundNatPool[] (obrigatório)

PoolProperties

Designação Descrição Valor
applicationLicenses A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço em lote disponíveis. Se for solicitada uma licença que não é suportada, a criação do pool falhará. string[]
applicationPackages As alterações nas referências do pacote de aplicativos afetam todos os novos nós de computação que ingressam no pool, mas não afetam os nós de computação que já estão no pool até que sejam reinicializados ou recriados com imagem. Há um máximo de 10 referências de pacotes de aplicativos em um determinado pool. ApplicationPackageReference []
Certificados Para nós de computação do Windows, o serviço Batch instala os certificados no armazenamento de certificados e no local especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório inicial do usuário (por exemplo, /home/{user-name}/certs) e os certificados são colocados nesse diretório.

Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o Azure KeyVault Extension.		 CertificateReference[]
deploymentConfiguration Usar CloudServiceConfiguration especifica que os nós devem ser criados usando os Serviços de Nuvem do Azure (PaaS), enquanto VirtualMachineConfiguration usa Máquinas Virtuais do Azure (IaaS). DeploymentConfiguration
displayName O nome para exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024. string
interNodeCommunication Isso impõe restrições sobre quais nós podem ser atribuídos ao pool. Habilitar esse valor pode reduzir a chance de o número solicitado de nós ser alocado no pool. Se não for especificado, o padrão desse valor será 'Desativado'. 'Desativado'
'Habilitado'
metadados O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário. MetadataItem []
mountConfiguration Isso dá suporte a Arquivos do Azure, NFS, CIFS/SMB e Blobfuse. MountConfiguration[]
networkConfiguration A configuração de rede para um pool. NetworkConfiguration
resourceTags As marcas definidas pelo usuário a serem associadas ao Pool de Lotes do Azure. Quando especificadas, essas marcas são propagadas para os recursos do Azure de suporte associados ao pool. Essa propriedade só pode ser especificada quando a conta Batch foi criada com a propriedade poolAllocationMode definida como 'UserSubscription'. PoolPropertiesResourceTags
scaleSettings Define o tamanho desejado do pool. Isso pode ser 'fixedScale', onde o targetDedicatedNodes solicitado é especificado, ou 'autoScale', que define uma fórmula que é reavaliada periodicamente. Se essa propriedade não for especificada, o pool terá uma escala fixa com 0 targetDedicatedNodes. ScaleSettings
startTask Em uma operação PATCH (atualização), essa propriedade pode ser definida como um objeto vazio para remover a tarefa inicial do pool. StartTask
targetNodeCommunicationMode Se omitido, o valor padrão é Default. 'Clássico'
'Inadimplência'
'Simplificado'
taskSchedulingPolicy Se não for especificado, o padrão será spread. TaskSchedulingPolicy
taskSlotsPerNode O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256. Int
userContas A lista de contas de usuário a serem criadas em cada nó do pool. Conta de Utilizador[]
vmTamanho Para obter informações sobre tamanhos disponíveis de máquinas virtuais para pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Tamanhos para Serviços de Nuvem (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Batch suporta todos os tamanhos de VM dos Serviços de Nuvem, exceto o ExtraSmall. Para obter informações sobre tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Tamanhos para máquinas virtuais (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). O Batch dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (STANDARD_GS, STANDARD_DS e STANDARD_DSV2 séries). string

PoolPropertiesResourceTags

Designação Descrição Valor

PublicIPAddressConfiguration

Designação Descrição Valor
ipAddressIds O número de IPs especificado aqui limita o tamanho máximo do Pool - 100 nós dedicados ou 100 nós Spot/de baixa prioridade podem ser alocados para cada IP público. Por exemplo, um pool que precisa de 250 VMs dedicadas precisaria de pelo menos 3 IPs públicos especificados. Cada elemento desta coleção tem o formato: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. string[]
provisão O valor padrão é BatchManaged 'BatchManaged'
'NoPublicIPAddresses'
'UserManaged'

Ficheiro de Recursos

Designação Descrição Valor
autoStorageContainerName As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. string
blobPrefix A propriedade é válida somente quando autoStorageContainerName ou storageContainerUrl é usado. Esse prefixo pode ser um nome de arquivo parcial ou um subdiretório. Se um prefixo não for especificado, todos os arquivos no contêiner serão baixados. string
fileMode Esta propriedade aplica-se apenas a arquivos que estão sendo baixados para nós de computação do Linux. Ele será ignorado se for especificado para um resourceFile que será baixado para um nó do Windows. Se essa propriedade não for especificada para um nó Linux, um valor padrão de 0770 será aplicado ao arquivo. string
filePath Se a propriedade httpUrl for especificada, o filePath será necessário e descreverá o caminho para o qual o arquivo será baixado, incluindo o nome do arquivo. Caso contrário, se a propriedade autoStorageContainerName ou storageContainerUrl for especificada, filePath será opcional e será o diretório para o qual os arquivos serão baixados. No caso em que filePath é usado como um diretório, qualquer estrutura de diretório já associada aos dados de entrada será mantida na íntegra e anexada ao diretório filePath especificado. O caminho relativo especificado não pode sair do diretório de trabalho da tarefa (por exemplo, usando '..'). string
httpUrl As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Se a URL apontar para o Armazenamento de Blobs do Azure, ela deverá ser legível a partir dos nós de computação. Há três maneiras de obter essa URL para um blob no armazenamento do Azure: incluir uma Assinatura de Acesso Compartilhado (SAS) concedendo permissões de leitura no blob, usar uma identidade gerenciada com permissão de leitura ou definir a ACL para o blob ou seu contêiner para permitir acesso público. string
identityReference A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. ComputeNodeIdentityReference
storageContainerUrl As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Este URL deve ser legível e listável a partir de nós de computação. Há três maneiras de obter essa URL para um contêiner no armazenamento do Azure: incluir uma SAS (Assinatura de Acesso Compartilhado) concedendo permissões de leitura e lista no contêiner, usar uma identidade gerenciada com permissões de leitura e lista ou definir a ACL do contêiner para permitir acesso público. string

Configurações de escala

Designação Descrição Valor
autoDimensionamento Esta propriedade e fixedScale são mutuamente exclusivas e uma das propriedades deve ser especificada. AutoScaleSettings
escala fixa Esta propriedade e autoScale são mutuamente exclusivas e uma das propriedades deve ser especificada. FixedScaleSettings

Perfil de Segurança

Designação Descrição Valor
criptografiaAtHost Essa propriedade pode ser usada pelo usuário na solicitação para habilitar ou desabilitar a Criptografia de Host para a máquina virtual ou o conjunto de dimensionamento de máquina virtual. Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. Bool
securityType [en] Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. 'Lançamento confiável'
uefiSettings Especifica as configurações de segurança, como inicialização segura e vTPM, usadas durante a criação da máquina virtual. UefiSettings

ServiceArtifactReference

Designação Descrição Valor
ID A ID de referência do artefato de serviço na forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} string (obrigatório)

IniciarTarefa

Designação Descrição Valor
linha de comando A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Obrigatório se quaisquer outras propriedades do startTask forem especificadas. string
containerSettings Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios do Lote do Azure no nó) são mapeados no contêiner, todas as variáveis de ambiente de tarefa são mapeadas no contêiner e a linha de comando da tarefa é executada no contêiner. TaskContainerSettings
ambienteConfigurações Uma lista de configurações de variáveis de ambiente para a tarefa iniciar. EnvironmentSetting[]
maxTaskRetryCount O serviço de lote tenta novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço de lote tentará a tarefa uma vez e, em seguida, poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Batch tentará a tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço Batch não repetirá a tarefa. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá a tarefa sem limite. O padrão é 0 Int
resourceFiles Uma lista de arquivos que o serviço Batch baixará para o nó de computação antes de executar a linha de comando. ResourceFile []
userIdentity Se omitida, a tarefa é executada como um usuário não administrativo exclusivo para a tarefa. UserIdentity
waitForSuccess Se true e a tarefa inicial falhar em um nó de computação, o serviço Batch tentará novamente a tarefa inicial até sua contagem máxima de tentativas (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o nó de computação como inutilizável e não agendará tarefas para ele. Esta condição pode ser detetada através do estado do nó e detalhes do erro de agendamento. Se false, o serviço Batch não aguardará a conclusão da tarefa inicial. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda está em execução; E mesmo que a tarefa Iniciar falhe, novas tarefas continuarão a ser agendadas no nó. O padrão é true. Bool

TaskContainerSettings

Designação Descrição Valor
containerRunOptions Essas opções adicionais são fornecidas como argumentos para o comando "docker create", além daquelas controladas pelo Batch Service. string
nome_da_imagem Esta é a referência de imagem completa, como seria especificado para "docker pull". Se nenhuma tag for fornecida como parte do nome da imagem, a tag ":latest" será usada como padrão. string (obrigatório)
registo Essa configuração pode ser omitida se já tiver sido fornecida na criação do pool. ContainerRegistry
diretório de trabalho Um sinalizador para indicar onde está o diretório de trabalho da tarefa de contêiner. O padrão é 'taskWorkingDirectory'. 'ContainerImageDefault'
'TaskWorkingDirectory'

TaskSchedulingPolicy

Designação Descrição Valor
nodeFillType Como as tarefas devem ser distribuídas entre nós de computação. 'Pacote'
'Spread' (obrigatório)

UefiSettings

Designação Descrição Valor
secureBootEnabled Especifica se a inicialização segura deve ser habilitada na máquina virtual. Bool
vTpmAtivado Especifica se o vTPM deve ser habilitado na máquina virtual. Bool

Conta de Utilizador

Designação Descrição Valor
elevaçãoNível nonAdmin - O usuário automático é um usuário padrão sem acesso elevado. admin - O usuário automático é um usuário com acesso elevado e opera com permissões totais de administrador. O valor padrão é nonAdmin. 'Administrador'
'Não administrador'
linuxUserConfiguration Esta propriedade é ignorada se especificada em um pool do Windows. Se não for especificado, o usuário será criado com as opções padrão. LinuxUserConfiguration
Designação O nome da conta de usuário. Os nomes podem conter caracteres Unicode até um comprimento máximo de 20. string (obrigatório)
palavra-passe A senha da conta de usuário. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
windowsUserConfiguration Essa propriedade só pode ser especificada se o usuário estiver em um pool do Windows. Se não especificado e em um pool do Windows, o usuário é criado com as opções padrão. WindowsUserConfiguration

UserAssignedIdentities

Designação Descrição Valor

Identidade do usuário

Designação Descrição Valor
autoUsuário As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. AutoUserSpecification
nome de utilizador As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. string

VirtualMachineConfiguration

Designação Descrição Valor
containerConfiguration Se especificado, a configuração é executada em cada nó do pool para permitir que as tarefas sejam executadas em contêineres. Todas as tarefas regulares e tarefas do gerenciador de tarefas executadas nesse pool devem especificar a propriedade containerSettings e todas as outras tarefas podem especificá-la. ContainerConfiguration
dataDisks Essa propriedade deve ser especificada se os nós de computação no pool precisarem ter discos de dados vazios conectados a eles. DataDisk[]
diskEncryptionConfiguration Se especificado, a criptografia é executada em cada nó do pool durante o provisionamento do nó. DiskEncryptionConfiguration
Extensões Se especificado, as extensões mencionadas nesta configuração serão instaladas em cada nó. VMExtension[]
imageReference Uma referência a uma imagem do Azure Virtual Machines Marketplace ou ao recurso Azure Image de uma Máquina Virtual personalizada. Para obter a lista de todas as imageReferences verificadas pelo Lote do Azure, consulte a operação 'Listar SKUs de agente de nó suportado'. ImageReference (obrigatório)
Tipo de licença Isso só se aplica a imagens que contêm o sistema operacional Windows e só deve ser usado quando você possui licenças locais válidas para os nós que serão implantados. Se omitido, nenhum desconto de licenciamento local será aplicado. Os valores são:

Windows_Server - A licença local é para o Windows Server.
Windows_Client - A licença local é para o Windows Client.		 string
nodeAgentSkuId O agente do nó Batch é um programa executado em cada nó do pool e fornece a interface de comando e controle entre o nó e o serviço Batch. Existem diferentes implementações do agente de nó, conhecido como SKUs, para diferentes sistemas operacionais. Você deve especificar uma SKU do agente de nó que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente de nó suportados, juntamente com sua lista de referências de imagem verificadas, consulte a operação 'Listar SKUs de agente de nó suportados'. string (obrigatório)
nodePlacementConfiguration Essa configuração especificará regras sobre como os nós no pool serão fisicamente alocados. NodePlacementConfiguration
osDisk Contém configuração para configurações efêmeras do OSDisk. OSDisk
perfil de segurança Especifica as configurações de perfil de segurança para a máquina virtual ou o conjunto de dimensionamento de máquina virtual. SecurityProfile
serviceArtifactReference A ID de referência do artefato de serviço na forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} ServiceArtifactReference
windowsConfiguração Essa propriedade não deve ser especificada se imageReference especificar uma imagem do sistema operacional Linux. WindowsConfiguration

VMExtension

Designação Descrição Valor
autoUpgradeMinorVersion Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Bool
enableAutomaticUpgrade Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. Bool
Designação O nome da extensão da máquina virtual. string (obrigatório)
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
provisionAfterExtensions Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. string[]
editora O nome do editor do manipulador de extensão. string (obrigatório)
Configurações Configurações públicas formatadas em JSON para a extensão. qualquer
tipo O tipo de extensões. string (obrigatório)
typeHandlerVersion A versão do manipulador de script. string

WindowsConfiguration

Designação Descrição Valor
enableAutomaticUpdates Se omitido, o valor padrão é true. Bool

WindowsUserConfiguration

Designação Descrição Valor
loginMode Especifica o modo de login para o usuário. O valor padrão para pools VirtualMachineConfiguration é o modo interativo e para os pools CloudServiceConfiguration é o modo em lote. 'Lote'
'Interativo'

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
pool de lotes do Azure sem endereços IP públicos Este modelo cria o pool de comunicação de nó simplificado do Lote do Azure sem endereços IP públicos.

Definição de recurso de modelo ARM

O tipo de recurso batchAccounts/pools pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Batch/batchAccounts/pools, adicione o seguinte JSON ao seu modelo.

{
  "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 propriedade

ApplicationPackageReference

Designação Descrição Valor
ID A ID do pacote de aplicativo a ser instalado. Isso deve estar dentro da mesma conta de lote que o pool. Isso pode ser uma referência a uma versão específica ou a versão padrão, se existir. string (obrigatório)
Versão Se isso for omitido e nenhuma versão padrão for especificada para este aplicativo, a solicitação falhará com o código de erro InvalidApplicationPackageReferences. Se você estiver chamando a API REST diretamente, o código de status HTTP será 409. string

AutoScaleSettings

Designação Descrição Valor
avaliaçãoIntervalo Se omitido, o valor padrão é 15 minutos (PT15M). string
fórmula Uma fórmula para o número desejado de nós de computação no pool. string (obrigatório)

AutoUserSpecification

Designação Descrição Valor
elevaçãoNível O valor padrão é nonAdmin. 'Administrador'
'Não administrador'
Âmbito de aplicação O valor padrão é Pool. Se o pool estiver executando o Windows, um valor de Task deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa muta o registro de uma forma que pode afetar outras tarefas, ou se certificados foram especificados no pool que não deve ser acessível por tarefas normais, mas deve ser acessível por tarefas iniciais. 'Piscina'
'Tarefa'

AzureBlobFileSystemConfiguration

Designação Descrição Valor
accountKey Esta propriedade é mutuamente exclusiva com sasKey e identidade; exatamente um deve ser especificado. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
nomedaconta; O nome da Conta de Armazenamento do Azure. string (obrigatório)
blobfuseOptions Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
containerName O nome do Contêiner de Armazenamento de Blob do Azure. string (obrigatório)
identityReference Esta propriedade é mutuamente exclusiva com accountKey e sasKey; exatamente um deve ser especificado. ComputeNodeIdentityReference
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
sasKey Esta propriedade é mutuamente exclusiva com accountKey e identity; exatamente um deve ser especificado. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.

AzureFileShareConfiguration

Designação Descrição Valor
accountKey A chave da conta do Armazenamento do Azure. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
nomedaconta; O nome da conta de Armazenamento do Azure. string (obrigatório)
azureFileUrl Este é o formato 'https://{account}.file.core.windows.net/'. string (obrigatório)
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)

BatchPoolIdentity

Designação Descrição Valor
tipo O tipo de identidade usado para o pool de lotes. 'Nenhuma'
'UserAssigned' (obrigatório)
userAssignedIdentities A lista de identidades de usuário associadas ao pool de lotes. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Designação Descrição Valor

CertificadoReferência

Designação Descrição Valor
ID A ID totalmente qualificada do certificado a ser instalado no pool. Isso deve estar dentro da mesma conta de lote que o pool. string (obrigatório)
storeLocalização O valor padrão é currentUser. Essa propriedade é aplicável somente para pools configurados com nós do Windows (ou seja, criados com cloudServiceConfiguration ou com virtualMachineConfiguration usando uma referência de imagem do Windows). Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório inicial do usuário (por exemplo, /home/{user-name}/certs) e os certificados são colocados nesse diretório. 'CurrentUser'
'LocalMachine'
nome_da_loja Essa propriedade é aplicável somente para pools configurados com nós do Windows (ou seja, criados com cloudServiceConfiguration ou com virtualMachineConfiguration usando uma referência de imagem do Windows). Os nomes de armazenamento comuns incluem: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mas qualquer nome de loja personalizado também pode ser usado. O valor padrão é My. string
Visibilidade Quais contas de usuário no nó de computação devem ter acesso aos dados privados do certificado. Matriz de cadeia de caracteres contendo qualquer uma das:
'RemoteUser'
'StartTask'
'Tarefa'

CifsMountConfiguration

Designação Descrição Valor
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
palavra-passe A senha a ser usada para autenticação no sistema de arquivos CIFS. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
fonte O URI do sistema de arquivos a ser montado. string (obrigatório)
nome de utilizador O usuário a ser usado para autenticação no sistema de arquivos CIFS. string (obrigatório)

CloudServiceConfiguration

Designação Descrição Valor
osFamília Os valores possíveis são: 2 - OS Family 2, equivalente ao Windows Server 2008 R2 SP1. 3 - OS Family 3, equivalente ao Windows Server 2012. 4 - Família OS 4, equivalente ao Windows Server 2012 R2. 5 - Família OS 5, equivalente ao Windows Server 2016. 6 - OS Family 6, equivalente ao Windows Server 2019. Para obter mais informações, consulte Versões do SO convidado do Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). string (obrigatório)
osVersão O valor padrão é *, que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada. string

ComputeNodeIdentityReference

Designação Descrição Valor
resourceId O ID de recurso ARM da identidade atribuída ao usuário. string

ContainerConfiguration

Designação Descrição Valor
containerImageNames Esta é a referência de imagem completa, como seria especificado para "docker pull". Uma imagem será originada do registro padrão do Docker, a menos que a imagem seja totalmente qualificada com um registro alternativo. string[]
contentoresRegistos Se alguma imagem deve ser baixada de um registro privado que requer credenciais, então essas credenciais devem ser fornecidas aqui. ContainerRegistry[]
tipo A tecnologia de contentores a utilizar. 'CriCompatível'
'DockerCompatible' (obrigatório)

ContainerRegistry

Designação Descrição Valor
identityReference A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. ComputeNodeIdentityReference
palavra-passe A palavra-passe para iniciar sessão no servidor de registo. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
registryServer [en] Se omitido, o padrão é "docker.io". string
nome de utilizador O nome de utilizador para iniciar sessão no servidor de registo. string

Disco de dados

Designação Descrição Valor
armazenamento em cache Os valores são:

none - O modo de cache para o disco não está ativado.
readOnly - O modo de cache do disco é somente leitura.
readWrite - O modo de cache para o disco é leitura e gravação.

O valor padrão para cache é none. Para obter informações sobre as opções de cache, consulte: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.		 'Nenhuma'
'Somente leitura'
'ReadWrite'
diskSizeGB O tamanho inicial do disco em GB ao criar um novo disco de dados. int (obrigatório)
LUN O lun é usado para identificar exclusivamente cada disco de dados. Se anexar vários discos, cada um deve ter um lun distinto. O valor deve estar entre 0 e 63, inclusive. int (obrigatório)
storageAccountType Se omitido, o padrão é "Standard_LRS". Os valores são:

Standard_LRS - O disco de dados deve usar armazenamento padrão localmente redundante.
Premium_LRS - O disco de dados deve usar armazenamento redundante local premium.		 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'

DeploymentConfiguration

Designação Descrição Valor
cloudServiceConfiguration Essa propriedade e virtualMachineConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Esta propriedade não pode ser especificada se a conta Batch foi criada com sua propriedade poolAllocationMode definida como 'UserSubscription'. CloudServiceConfiguration
virtualMachineConfiguration Esta propriedade e cloudServiceConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. VirtualMachineConfiguration

DiffDiskSettings

Designação Descrição Valor
colocação Essa propriedade pode ser usada pelo usuário na solicitação para escolher em qual local o sistema operacional deve estar. por exemplo, espaço em disco de cache para provisionamento de disco do sistema operacional efêmero. Para obter mais informações sobre os requisitos de tamanho de disco do Ephemeral OS, consulte Ephemeral OS disk size requirements for Windows VMs em /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e Linux VMs em /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. 'CacheDisk'

DiskEncryptionConfiguration

Designação Descrição Valor
Objetivos No pool Linux, apenas "TemporaryDisk" é suportado; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Matriz de cadeia de caracteres contendo qualquer uma das:
'OsDisk'
'DiscoTemporário'

AmbienteConfiguração

Designação Descrição Valor
Designação O nome da variável de ambiente. string (obrigatório)
valor O valor da variável de ambiente. string

FixedScaleSettings

Designação Descrição Valor
nodeDeallocationOption Se omitido, o valor padrão é Requeue. 'Refila de espera'
'Dados retidos'
'Conclusão de tarefas'
'Terminar'
redimensionarTimeout O valor padrão é 15 minutos. Os valores de tempo limite usam o formato ISO 8601. Por exemplo, use PT10M por 10 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço em lote rejeitará a solicitação com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). string
targetDedicatedNodes Pelo menos um dos targetDedicatedNodes, targetLowPriorityNodes deve ser definido. Int
targetLowPriorityNodes Pelo menos um dos targetDedicatedNodes, targetLowPriorityNodes deve ser definido. Int

ImageReference

Designação Descrição Valor
ID Esta propriedade é mutuamente exclusiva com outras propriedades. A Imagem da Galeria de Computação do Azure deve ter réplicas na mesma região que a conta do Lote do Azure. Para obter informações sobre as configurações de firewall para o agente do nó Batch se comunicar com o serviço Batch, consulte /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. string
oferta Por exemplo, UbuntuServer ou WindowsServer. string
editora Por exemplo, Canonical ou MicrosoftWindowsServer. string
SKU Por exemplo, 18.04-LTS ou 2022-datacenter. string
Versão Um valor de 'mais recente' pode ser especificado para selecionar a versão mais recente de uma imagem. Se omitido, o padrão é 'mais recente'. string

InboundNatPool

Designação Descrição Valor
backendPort Isso deve ser exclusivo dentro de um pool de lotes. Os valores aceitáveis situam-se entre 1 e 65535, exceto para 22, 3389, 29876 e 29877, uma vez que estes são reservados. Se algum valor reservado for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
frontendPortRangeEnd Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas pelo serviço de lote. Todos os intervalos dentro de um pool devem ser distintos e não podem se sobrepor. Se algum valor reservado ou sobreposto for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
frontendPortRangeStart Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas. Todos os intervalos dentro de um pool devem ser distintos e não podem se sobrepor. Se algum valor reservado ou sobreposto for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
Designação O nome deve ser exclusivo dentro de um pool de lotes, pode conter letras, números, sublinhados, pontos e hífenes. Os nomes devem começar com uma letra ou número, devem terminar com uma letra, número ou sublinhado e não podem exceder 77 caracteres. Se algum valor inválido for fornecido, a solicitação falhará com o código de status HTTP 400. string (obrigatório)
networkSecurityGroupRules O número máximo de regras que podem ser especificadas em todos os pontos de extremidade em um pool de lotes é 25. Se nenhuma regra de grupo de segurança de rede for especificada, uma regra padrão será criada para permitir o acesso de entrada à porta de back-end especificada. Se o número máximo de regras de grupo de segurança de rede for excedido, a solicitação falhará com o código de status HTTP 400. NetworkSecurityGroupRule[]
protocolo O protocolo do ponto de extremidade. 'TCP'
'UDP' (obrigatório)

LinuxUserConfiguration

Designação Descrição Valor
GID As propriedades uid e gid devem ser especificadas juntas ou não devem ser especificadas de todo. Se não for especificado, o sistema operacional subjacente seleciona o gid. Int
sshPrivateKey A chave privada não deve ser protegida por senha. A chave privada é usada para configurar automaticamente a autenticação baseada em chave assimétrica para SSH entre nós em um pool Linux quando a propriedade enableInterNodeCommunication do pool é true (ela é ignorada se enableInterNodeCommunication for false). Ele faz isso colocando o par de chaves no diretório .ssh do usuário. Se não for especificado, o SSH sem senha não será configurado entre nós (nenhuma modificação do diretório .ssh do usuário será feita). string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
UID As propriedades uid e gid devem ser especificadas juntas ou não devem ser especificadas de todo. Se não for especificado, o sistema operacional subjacente seleciona o uid. Int

ManagedDisk

Designação Descrição Valor
storageAccountType O tipo de conta de armazenamento para uso na criação de discos de dados ou disco do sistema operacional. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'

MetadataItem

Designação Descrição Valor
Designação O nome do item de metadados. string (obrigatório)
valor O valor do item de metadados. string (obrigatório)

Microsoft.Batch/batchAccounts/pools

Designação Descrição Valor
apiVersion A versão api '2023-11-01'
identidade O tipo de identidade usado para o pool de lotes. BatchPoolIdentity
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[a-zA-Z0-9_-]+$ (obrigatório)
propriedades As propriedades associadas ao pool. PoolProperties
tipo O tipo de recurso 'Microsoft.Batch/batchAccounts/pools'

MountConfiguration

Designação Descrição Valor
azureBlobFileSystemConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. AzureFileShareConfiguration
cifsMountConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. CifsMountConfiguration
nfsMountConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. NFSMountConfiguration

Configuração de rede

Designação Descrição Valor
dynamicVnetAssignmentScope O escopo da atribuição dinâmica de vnet. 'Trabalho'
'nenhuma'
enableAcceleratedNetworking A rede acelerada permite a virtualização de E/S de raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho de rede. Para obter mais detalhes, consulte: /azure/virtual-network/accelerated-networking-overview. Bool
endpointConfiguration A configuração do ponto de extremidade do pool só é suportada em pools com a propriedade virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Essa propriedade só é suportada em Pools com a propriedade virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId A rede virtual deve estar na mesma região e assinatura que a conta do Lote do Azure. A sub-rede especificada deve ter endereços IP livres suficientes para acomodar o número de nós no pool. Se a sub-rede não tiver endereços IP livres suficientes, o pool alocará parcialmente os nós de computação e ocorrerá um erro de redimensionamento. A entidade de serviço 'MicrosoftAzureBatch' deve ter a função 'Colaborador de Máquina Virtual Clássica' Role-Based Controle de Acesso (RBAC) para a VNet especificada. A sub-rede especificada deve permitir a comunicação do serviço Lote do Azure para poder agendar tarefas nos nós de computação. Isso pode ser verificado verificando se a rede virtual especificada tem algum NSG (Network Security Groups) associado. Se a comunicação com os nós de computação na sub-rede especificada for negada por um NSG, o serviço em lote definirá o estado dos nós de computação como inutilizável. Se a VNet especificada tiver algum NSG (Network Security Groups) associado, algumas portas de sistema reservadas deverão ser habilitadas para comunicação de entrada. Para pools criados com uma configuração de máquina virtual, habilite as portas 29876 e 29877, bem como a porta 22 para Linux e a porta 3389 para Windows. Para pools criados com uma configuração de serviço de nuvem, habilite as portas 10100, 20100 e 30100. Habilite também as conexões de saída para o Armazenamento do Azure na porta 443. Para pools cloudServiceConfiguration, apenas VNETs 'clássicas' são suportadas. Para obter mais detalhes, consulte: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration string

NetworkSecurityGroupRule

Designação Descrição Valor
Acesso A ação que deve ser tomada para um endereço IP, intervalo de sub-rede ou tag especificado. 'Permitir'
'Negar' (obrigatório)
prioridade As prioridades dentro de um pool devem ser únicas e são avaliadas por ordem de prioridade. Quanto menor o número, maior a prioridade. Por exemplo, as regras podem ser especificadas com números de ordem de 150, 250 e 350. A regra com o número de ordem 150 tem precedência sobre a regra que tem uma ordem de 250. As prioridades permitidas são de 150 a 4096. Se algum valor reservado ou duplicado for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
sourceAddressPrefix Os valores válidos são um único endereço IP (ou seja, 10.10.10.10), sub-rede IP (ou seja, 192.168.1.0/24), tag padrão ou * (para todos os endereços). Se quaisquer outros valores forem fornecidos, a solicitação falhará com o código de status HTTP 400. string (obrigatório)
sourcePortRanges Os valores válidos são '*' (para todas as portas 0 - 65535) ou matrizes de portas ou intervalos de portas (ou seja, 100-200). As portas devem estar no intervalo de 0 a 65535 e os intervalos de portas ou portas não podem se sobrepor. Se quaisquer outros valores forem fornecidos, a solicitação falhará com o código de status HTTP 400. O valor padrão será *. string[]

NFSMountConfiguration

Designação Descrição Valor
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
fonte O URI do sistema de arquivos a ser montado. string (obrigatório)

NodePlacementConfiguration

Designação Descrição Valor
política Política de alocação usada pelo Batch Service para provisionar os nós. Se não for especificado, o Batch usará a política regional. 'Regional'
'Zonal'

OSDisk

Designação Descrição Valor
armazenamento em cache O tipo de cache a ser habilitado para o disco. 'Nenhuma'
'Somente leitura'
'ReadWrite'
diskSizeGB O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional. Int
ephemeralOSDiskSettings Especifica as configurações de disco efêmeras para o disco do sistema operacional usado pela máquina virtual. DiffDiskSettings
managedDisk ManagedDisk
writeAcceleratorEnabled Especifica se writeAccelerator deve ser habilitado ou desabilitado no disco. Bool

PoolEndpointConfiguration

Designação Descrição Valor
inboundNatPools O número máximo de pools de NAT de entrada por pool de lotes é 5. Se o número máximo de pools NAT de entrada for excedido, a solicitação falhará com o código de status HTTP 400. Isso não pode ser especificado se o IPAddressProvisioningType for NoPublicIPAddresses. InboundNatPool[] (obrigatório)

PoolProperties

Designação Descrição Valor
applicationLicenses A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço em lote disponíveis. Se for solicitada uma licença que não é suportada, a criação do pool falhará. string[]
applicationPackages As alterações nas referências do pacote de aplicativos afetam todos os novos nós de computação que ingressam no pool, mas não afetam os nós de computação que já estão no pool até que sejam reinicializados ou recriados com imagem. Há um máximo de 10 referências de pacotes de aplicativos em um determinado pool. ApplicationPackageReference []
Certificados Para nós de computação do Windows, o serviço Batch instala os certificados no armazenamento de certificados e no local especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório inicial do usuário (por exemplo, /home/{user-name}/certs) e os certificados são colocados nesse diretório.

Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o Azure KeyVault Extension.		 CertificateReference[]
deploymentConfiguration Usar CloudServiceConfiguration especifica que os nós devem ser criados usando os Serviços de Nuvem do Azure (PaaS), enquanto VirtualMachineConfiguration usa Máquinas Virtuais do Azure (IaaS). DeploymentConfiguration
displayName O nome para exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024. string
interNodeCommunication Isso impõe restrições sobre quais nós podem ser atribuídos ao pool. Habilitar esse valor pode reduzir a chance de o número solicitado de nós ser alocado no pool. Se não for especificado, o padrão desse valor será 'Desativado'. 'Desativado'
'Habilitado'
metadados O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário. MetadataItem []
mountConfiguration Isso dá suporte a Arquivos do Azure, NFS, CIFS/SMB e Blobfuse. MountConfiguration[]
networkConfiguration A configuração de rede para um pool. NetworkConfiguration
resourceTags As marcas definidas pelo usuário a serem associadas ao Pool de Lotes do Azure. Quando especificadas, essas marcas são propagadas para os recursos do Azure de suporte associados ao pool. Essa propriedade só pode ser especificada quando a conta Batch foi criada com a propriedade poolAllocationMode definida como 'UserSubscription'. PoolPropertiesResourceTags
scaleSettings Define o tamanho desejado do pool. Isso pode ser 'fixedScale', onde o targetDedicatedNodes solicitado é especificado, ou 'autoScale', que define uma fórmula que é reavaliada periodicamente. Se essa propriedade não for especificada, o pool terá uma escala fixa com 0 targetDedicatedNodes. ScaleSettings
startTask Em uma operação PATCH (atualização), essa propriedade pode ser definida como um objeto vazio para remover a tarefa inicial do pool. StartTask
targetNodeCommunicationMode Se omitido, o valor padrão é Default. 'Clássico'
'Inadimplência'
'Simplificado'
taskSchedulingPolicy Se não for especificado, o padrão será spread. TaskSchedulingPolicy
taskSlotsPerNode O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256. Int
userContas A lista de contas de usuário a serem criadas em cada nó do pool. Conta de Utilizador[]
vmTamanho Para obter informações sobre tamanhos disponíveis de máquinas virtuais para pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Tamanhos para Serviços de Nuvem (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Batch suporta todos os tamanhos de VM dos Serviços de Nuvem, exceto o ExtraSmall. Para obter informações sobre tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Tamanhos para máquinas virtuais (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). O Batch dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (STANDARD_GS, STANDARD_DS e STANDARD_DSV2 séries). string

PoolPropertiesResourceTags

Designação Descrição Valor

PublicIPAddressConfiguration

Designação Descrição Valor
ipAddressIds O número de IPs especificado aqui limita o tamanho máximo do Pool - 100 nós dedicados ou 100 nós Spot/de baixa prioridade podem ser alocados para cada IP público. Por exemplo, um pool que precisa de 250 VMs dedicadas precisaria de pelo menos 3 IPs públicos especificados. Cada elemento desta coleção tem o formato: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. string[]
provisão O valor padrão é BatchManaged 'BatchManaged'
'NoPublicIPAddresses'
'UserManaged'

Ficheiro de Recursos

Designação Descrição Valor
autoStorageContainerName As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. string
blobPrefix A propriedade é válida somente quando autoStorageContainerName ou storageContainerUrl é usado. Esse prefixo pode ser um nome de arquivo parcial ou um subdiretório. Se um prefixo não for especificado, todos os arquivos no contêiner serão baixados. string
fileMode Esta propriedade aplica-se apenas a arquivos que estão sendo baixados para nós de computação do Linux. Ele será ignorado se for especificado para um resourceFile que será baixado para um nó do Windows. Se essa propriedade não for especificada para um nó Linux, um valor padrão de 0770 será aplicado ao arquivo. string
filePath Se a propriedade httpUrl for especificada, o filePath será necessário e descreverá o caminho para o qual o arquivo será baixado, incluindo o nome do arquivo. Caso contrário, se a propriedade autoStorageContainerName ou storageContainerUrl for especificada, filePath será opcional e será o diretório para o qual os arquivos serão baixados. No caso em que filePath é usado como um diretório, qualquer estrutura de diretório já associada aos dados de entrada será mantida na íntegra e anexada ao diretório filePath especificado. O caminho relativo especificado não pode sair do diretório de trabalho da tarefa (por exemplo, usando '..'). string
httpUrl As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Se a URL apontar para o Armazenamento de Blobs do Azure, ela deverá ser legível a partir dos nós de computação. Há três maneiras de obter essa URL para um blob no armazenamento do Azure: incluir uma Assinatura de Acesso Compartilhado (SAS) concedendo permissões de leitura no blob, usar uma identidade gerenciada com permissão de leitura ou definir a ACL para o blob ou seu contêiner para permitir acesso público. string
identityReference A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. ComputeNodeIdentityReference
storageContainerUrl As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Este URL deve ser legível e listável a partir de nós de computação. Há três maneiras de obter essa URL para um contêiner no armazenamento do Azure: incluir uma SAS (Assinatura de Acesso Compartilhado) concedendo permissões de leitura e lista no contêiner, usar uma identidade gerenciada com permissões de leitura e lista ou definir a ACL do contêiner para permitir acesso público. string

Configurações de escala

Designação Descrição Valor
autoDimensionamento Esta propriedade e fixedScale são mutuamente exclusivas e uma das propriedades deve ser especificada. AutoScaleSettings
escala fixa Esta propriedade e autoScale são mutuamente exclusivas e uma das propriedades deve ser especificada. FixedScaleSettings

Perfil de Segurança

Designação Descrição Valor
criptografiaAtHost Essa propriedade pode ser usada pelo usuário na solicitação para habilitar ou desabilitar a Criptografia de Host para a máquina virtual ou o conjunto de dimensionamento de máquina virtual. Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. Bool
securityType [en] Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. 'Lançamento confiável'
uefiSettings Especifica as configurações de segurança, como inicialização segura e vTPM, usadas durante a criação da máquina virtual. UefiSettings

ServiceArtifactReference

Designação Descrição Valor
ID A ID de referência do artefato de serviço na forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} string (obrigatório)

IniciarTarefa

Designação Descrição Valor
linha de comando A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Obrigatório se quaisquer outras propriedades do startTask forem especificadas. string
containerSettings Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios do Lote do Azure no nó) são mapeados no contêiner, todas as variáveis de ambiente de tarefa são mapeadas no contêiner e a linha de comando da tarefa é executada no contêiner. TaskContainerSettings
ambienteConfigurações Uma lista de configurações de variáveis de ambiente para a tarefa iniciar. EnvironmentSetting[]
maxTaskRetryCount O serviço de lote tenta novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço de lote tentará a tarefa uma vez e, em seguida, poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Batch tentará a tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço Batch não repetirá a tarefa. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá a tarefa sem limite. O padrão é 0 Int
resourceFiles Uma lista de arquivos que o serviço Batch baixará para o nó de computação antes de executar a linha de comando. ResourceFile []
userIdentity Se omitida, a tarefa é executada como um usuário não administrativo exclusivo para a tarefa. UserIdentity
waitForSuccess Se true e a tarefa inicial falhar em um nó de computação, o serviço Batch tentará novamente a tarefa inicial até sua contagem máxima de tentativas (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o nó de computação como inutilizável e não agendará tarefas para ele. Esta condição pode ser detetada através do estado do nó e detalhes do erro de agendamento. Se false, o serviço Batch não aguardará a conclusão da tarefa inicial. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda está em execução; E mesmo que a tarefa Iniciar falhe, novas tarefas continuarão a ser agendadas no nó. O padrão é true. Bool

TaskContainerSettings

Designação Descrição Valor
containerRunOptions Essas opções adicionais são fornecidas como argumentos para o comando "docker create", além daquelas controladas pelo Batch Service. string
nome_da_imagem Esta é a referência de imagem completa, como seria especificado para "docker pull". Se nenhuma tag for fornecida como parte do nome da imagem, a tag ":latest" será usada como padrão. string (obrigatório)
registo Essa configuração pode ser omitida se já tiver sido fornecida na criação do pool. ContainerRegistry
diretório de trabalho Um sinalizador para indicar onde está o diretório de trabalho da tarefa de contêiner. O padrão é 'taskWorkingDirectory'. 'ContainerImageDefault'
'TaskWorkingDirectory'

TaskSchedulingPolicy

Designação Descrição Valor
nodeFillType Como as tarefas devem ser distribuídas entre nós de computação. 'Pacote'
'Spread' (obrigatório)

UefiSettings

Designação Descrição Valor
secureBootEnabled Especifica se a inicialização segura deve ser habilitada na máquina virtual. Bool
vTpmAtivado Especifica se o vTPM deve ser habilitado na máquina virtual. Bool

Conta de Utilizador

Designação Descrição Valor
elevaçãoNível nonAdmin - O usuário automático é um usuário padrão sem acesso elevado. admin - O usuário automático é um usuário com acesso elevado e opera com permissões totais de administrador. O valor padrão é nonAdmin. 'Administrador'
'Não administrador'
linuxUserConfiguration Esta propriedade é ignorada se especificada em um pool do Windows. Se não for especificado, o usuário será criado com as opções padrão. LinuxUserConfiguration
Designação O nome da conta de usuário. Os nomes podem conter caracteres Unicode até um comprimento máximo de 20. string (obrigatório)
palavra-passe A senha da conta de usuário. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
windowsUserConfiguration Essa propriedade só pode ser especificada se o usuário estiver em um pool do Windows. Se não especificado e em um pool do Windows, o usuário é criado com as opções padrão. WindowsUserConfiguration

UserAssignedIdentities

Designação Descrição Valor

Identidade do usuário

Designação Descrição Valor
autoUsuário As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. AutoUserSpecification
nome de utilizador As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. string

VirtualMachineConfiguration

Designação Descrição Valor
containerConfiguration Se especificado, a configuração é executada em cada nó do pool para permitir que as tarefas sejam executadas em contêineres. Todas as tarefas regulares e tarefas do gerenciador de tarefas executadas nesse pool devem especificar a propriedade containerSettings e todas as outras tarefas podem especificá-la. ContainerConfiguration
dataDisks Essa propriedade deve ser especificada se os nós de computação no pool precisarem ter discos de dados vazios conectados a eles. DataDisk[]
diskEncryptionConfiguration Se especificado, a criptografia é executada em cada nó do pool durante o provisionamento do nó. DiskEncryptionConfiguration
Extensões Se especificado, as extensões mencionadas nesta configuração serão instaladas em cada nó. VMExtension[]
imageReference Uma referência a uma imagem do Azure Virtual Machines Marketplace ou ao recurso Azure Image de uma Máquina Virtual personalizada. Para obter a lista de todas as imageReferences verificadas pelo Lote do Azure, consulte a operação 'Listar SKUs de agente de nó suportado'. ImageReference (obrigatório)
Tipo de licença Isso só se aplica a imagens que contêm o sistema operacional Windows e só deve ser usado quando você possui licenças locais válidas para os nós que serão implantados. Se omitido, nenhum desconto de licenciamento local será aplicado. Os valores são:

Windows_Server - A licença local é para o Windows Server.
Windows_Client - A licença local é para o Windows Client.		 string
nodeAgentSkuId O agente do nó Batch é um programa executado em cada nó do pool e fornece a interface de comando e controle entre o nó e o serviço Batch. Existem diferentes implementações do agente de nó, conhecido como SKUs, para diferentes sistemas operacionais. Você deve especificar uma SKU do agente de nó que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente de nó suportados, juntamente com sua lista de referências de imagem verificadas, consulte a operação 'Listar SKUs de agente de nó suportados'. string (obrigatório)
nodePlacementConfiguration Essa configuração especificará regras sobre como os nós no pool serão fisicamente alocados. NodePlacementConfiguration
osDisk Contém configuração para configurações efêmeras do OSDisk. OSDisk
perfil de segurança Especifica as configurações de perfil de segurança para a máquina virtual ou o conjunto de dimensionamento de máquina virtual. SecurityProfile
serviceArtifactReference A ID de referência do artefato de serviço na forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} ServiceArtifactReference
windowsConfiguração Essa propriedade não deve ser especificada se imageReference especificar uma imagem do sistema operacional Linux. WindowsConfiguration

VMExtension

Designação Descrição Valor
autoUpgradeMinorVersion Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Bool
enableAutomaticUpgrade Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. Bool
Designação O nome da extensão da máquina virtual. string (obrigatório)
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
provisionAfterExtensions Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. string[]
editora O nome do editor do manipulador de extensão. string (obrigatório)
Configurações Configurações públicas formatadas em JSON para a extensão. qualquer
tipo O tipo de extensões. string (obrigatório)
typeHandlerVersion A versão do manipulador de script. string

WindowsConfiguration

Designação Descrição Valor
enableAutomaticUpdates Se omitido, o valor padrão é true. Bool

WindowsUserConfiguration

Designação Descrição Valor
loginMode Especifica o modo de login para o usuário. O valor padrão para pools VirtualMachineConfiguration é o modo interativo e para os pools CloudServiceConfiguration é o modo em lote. 'Lote'
'Interativo'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
pool de lotes do Azure sem endereços IP públicos

Implantar no Azure 		Este modelo cria o pool de comunicação de nó simplificado do Lote do Azure sem endereços IP públicos.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso batchAccounts/pools pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.Batch/batchAccounts/pools, adicione o seguinte Terraform ao seu modelo.

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 propriedade

ApplicationPackageReference

Designação Descrição Valor
ID A ID do pacote de aplicativo a ser instalado. Isso deve estar dentro da mesma conta de lote que o pool. Isso pode ser uma referência a uma versão específica ou a versão padrão, se existir. string (obrigatório)
Versão Se isso for omitido e nenhuma versão padrão for especificada para este aplicativo, a solicitação falhará com o código de erro InvalidApplicationPackageReferences. Se você estiver chamando a API REST diretamente, o código de status HTTP será 409. string

AutoScaleSettings

Designação Descrição Valor
avaliaçãoIntervalo Se omitido, o valor padrão é 15 minutos (PT15M). string
fórmula Uma fórmula para o número desejado de nós de computação no pool. string (obrigatório)

AutoUserSpecification

Designação Descrição Valor
elevaçãoNível O valor padrão é nonAdmin. 'Administrador'
'Não administrador'
Âmbito de aplicação O valor padrão é Pool. Se o pool estiver executando o Windows, um valor de Task deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa muta o registro de uma forma que pode afetar outras tarefas, ou se certificados foram especificados no pool que não deve ser acessível por tarefas normais, mas deve ser acessível por tarefas iniciais. 'Piscina'
'Tarefa'

AzureBlobFileSystemConfiguration

Designação Descrição Valor
accountKey Esta propriedade é mutuamente exclusiva com sasKey e identidade; exatamente um deve ser especificado. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
nomedaconta; O nome da Conta de Armazenamento do Azure. string (obrigatório)
blobfuseOptions Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
containerName O nome do Contêiner de Armazenamento de Blob do Azure. string (obrigatório)
identityReference Esta propriedade é mutuamente exclusiva com accountKey e sasKey; exatamente um deve ser especificado. ComputeNodeIdentityReference
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
sasKey Esta propriedade é mutuamente exclusiva com accountKey e identity; exatamente um deve ser especificado. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.

AzureFileShareConfiguration

Designação Descrição Valor
accountKey A chave da conta do Armazenamento do Azure. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
nomedaconta; O nome da conta de Armazenamento do Azure. string (obrigatório)
azureFileUrl Este é o formato 'https://{account}.file.core.windows.net/'. string (obrigatório)
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)

BatchPoolIdentity

Designação Descrição Valor
tipo O tipo de identidade usado para o pool de lotes. 'Nenhuma'
'UserAssigned' (obrigatório)
userAssignedIdentities A lista de identidades de usuário associadas ao pool de lotes. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Designação Descrição Valor

CertificadoReferência

Designação Descrição Valor
ID A ID totalmente qualificada do certificado a ser instalado no pool. Isso deve estar dentro da mesma conta de lote que o pool. string (obrigatório)
storeLocalização O valor padrão é currentUser. Essa propriedade é aplicável somente para pools configurados com nós do Windows (ou seja, criados com cloudServiceConfiguration ou com virtualMachineConfiguration usando uma referência de imagem do Windows). Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório inicial do usuário (por exemplo, /home/{user-name}/certs) e os certificados são colocados nesse diretório. 'CurrentUser'
'LocalMachine'
nome_da_loja Essa propriedade é aplicável somente para pools configurados com nós do Windows (ou seja, criados com cloudServiceConfiguration ou com virtualMachineConfiguration usando uma referência de imagem do Windows). Os nomes de armazenamento comuns incluem: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mas qualquer nome de loja personalizado também pode ser usado. O valor padrão é My. string
Visibilidade Quais contas de usuário no nó de computação devem ter acesso aos dados privados do certificado. Matriz de cadeia de caracteres contendo qualquer uma das:
'RemoteUser'
'StartTask'
'Tarefa'

CifsMountConfiguration

Designação Descrição Valor
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
palavra-passe A senha a ser usada para autenticação no sistema de arquivos CIFS. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
fonte O URI do sistema de arquivos a ser montado. string (obrigatório)
nome de utilizador O usuário a ser usado para autenticação no sistema de arquivos CIFS. string (obrigatório)

CloudServiceConfiguration

Designação Descrição Valor
osFamília Os valores possíveis são: 2 - OS Family 2, equivalente ao Windows Server 2008 R2 SP1. 3 - OS Family 3, equivalente ao Windows Server 2012. 4 - Família OS 4, equivalente ao Windows Server 2012 R2. 5 - Família OS 5, equivalente ao Windows Server 2016. 6 - OS Family 6, equivalente ao Windows Server 2019. Para obter mais informações, consulte Versões do SO convidado do Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). string (obrigatório)
osVersão O valor padrão é *, que especifica a versão mais recente do sistema operacional para a família de sistemas operacionais especificada. string

ComputeNodeIdentityReference

Designação Descrição Valor
resourceId O ID de recurso ARM da identidade atribuída ao usuário. string

ContainerConfiguration

Designação Descrição Valor
containerImageNames Esta é a referência de imagem completa, como seria especificado para "docker pull". Uma imagem será originada do registro padrão do Docker, a menos que a imagem seja totalmente qualificada com um registro alternativo. string[]
contentoresRegistos Se alguma imagem deve ser baixada de um registro privado que requer credenciais, então essas credenciais devem ser fornecidas aqui. ContainerRegistry[]
tipo A tecnologia de contentores a utilizar. 'CriCompatível'
'DockerCompatible' (obrigatório)

ContainerRegistry

Designação Descrição Valor
identityReference A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. ComputeNodeIdentityReference
palavra-passe A palavra-passe para iniciar sessão no servidor de registo. string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
registryServer [en] Se omitido, o padrão é "docker.io". string
nome de utilizador O nome de utilizador para iniciar sessão no servidor de registo. string

Disco de dados

Designação Descrição Valor
armazenamento em cache Os valores são:

none - O modo de cache para o disco não está ativado.
readOnly - O modo de cache do disco é somente leitura.
readWrite - O modo de cache para o disco é leitura e gravação.

O valor padrão para cache é none. Para obter informações sobre as opções de cache, consulte: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.		 'Nenhuma'
'Somente leitura'
'ReadWrite'
diskSizeGB O tamanho inicial do disco em GB ao criar um novo disco de dados. int (obrigatório)
LUN O lun é usado para identificar exclusivamente cada disco de dados. Se anexar vários discos, cada um deve ter um lun distinto. O valor deve estar entre 0 e 63, inclusive. int (obrigatório)
storageAccountType Se omitido, o padrão é "Standard_LRS". Os valores são:

Standard_LRS - O disco de dados deve usar armazenamento padrão localmente redundante.
Premium_LRS - O disco de dados deve usar armazenamento redundante local premium.		 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'

DeploymentConfiguration

Designação Descrição Valor
cloudServiceConfiguration Essa propriedade e virtualMachineConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. Esta propriedade não pode ser especificada se a conta Batch foi criada com sua propriedade poolAllocationMode definida como 'UserSubscription'. CloudServiceConfiguration
virtualMachineConfiguration Esta propriedade e cloudServiceConfiguration são mutuamente exclusivas e uma das propriedades deve ser especificada. VirtualMachineConfiguration

DiffDiskSettings

Designação Descrição Valor
colocação Essa propriedade pode ser usada pelo usuário na solicitação para escolher em qual local o sistema operacional deve estar. por exemplo, espaço em disco de cache para provisionamento de disco do sistema operacional efêmero. Para obter mais informações sobre os requisitos de tamanho de disco do Ephemeral OS, consulte Ephemeral OS disk size requirements for Windows VMs em /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e Linux VMs em /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. 'CacheDisk'

DiskEncryptionConfiguration

Designação Descrição Valor
Objetivos No pool Linux, apenas "TemporaryDisk" é suportado; no pool do Windows, "OsDisk" e "TemporaryDisk" devem ser especificados. Matriz de cadeia de caracteres contendo qualquer uma das:
'OsDisk'
'DiscoTemporário'

AmbienteConfiguração

Designação Descrição Valor
Designação O nome da variável de ambiente. string (obrigatório)
valor O valor da variável de ambiente. string

FixedScaleSettings

Designação Descrição Valor
nodeDeallocationOption Se omitido, o valor padrão é Requeue. 'Refila de espera'
'Dados retidos'
'Conclusão de tarefas'
'Terminar'
redimensionarTimeout O valor padrão é 15 minutos. Os valores de tempo limite usam o formato ISO 8601. Por exemplo, use PT10M por 10 minutos. O valor mínimo é de 5 minutos. Se você especificar um valor inferior a 5 minutos, o serviço em lote rejeitará a solicitação com um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação incorreta). string
targetDedicatedNodes Pelo menos um dos targetDedicatedNodes, targetLowPriorityNodes deve ser definido. Int
targetLowPriorityNodes Pelo menos um dos targetDedicatedNodes, targetLowPriorityNodes deve ser definido. Int

ImageReference

Designação Descrição Valor
ID Esta propriedade é mutuamente exclusiva com outras propriedades. A Imagem da Galeria de Computação do Azure deve ter réplicas na mesma região que a conta do Lote do Azure. Para obter informações sobre as configurações de firewall para o agente do nó Batch se comunicar com o serviço Batch, consulte /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. string
oferta Por exemplo, UbuntuServer ou WindowsServer. string
editora Por exemplo, Canonical ou MicrosoftWindowsServer. string
SKU Por exemplo, 18.04-LTS ou 2022-datacenter. string
Versão Um valor de 'mais recente' pode ser especificado para selecionar a versão mais recente de uma imagem. Se omitido, o padrão é 'mais recente'. string

InboundNatPool

Designação Descrição Valor
backendPort Isso deve ser exclusivo dentro de um pool de lotes. Os valores aceitáveis situam-se entre 1 e 65535, exceto para 22, 3389, 29876 e 29877, uma vez que estes são reservados. Se algum valor reservado for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
frontendPortRangeEnd Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas pelo serviço de lote. Todos os intervalos dentro de um pool devem ser distintos e não podem se sobrepor. Se algum valor reservado ou sobreposto for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
frontendPortRangeStart Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas. Todos os intervalos dentro de um pool devem ser distintos e não podem se sobrepor. Se algum valor reservado ou sobreposto for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
Designação O nome deve ser exclusivo dentro de um pool de lotes, pode conter letras, números, sublinhados, pontos e hífenes. Os nomes devem começar com uma letra ou número, devem terminar com uma letra, número ou sublinhado e não podem exceder 77 caracteres. Se algum valor inválido for fornecido, a solicitação falhará com o código de status HTTP 400. string (obrigatório)
networkSecurityGroupRules O número máximo de regras que podem ser especificadas em todos os pontos de extremidade em um pool de lotes é 25. Se nenhuma regra de grupo de segurança de rede for especificada, uma regra padrão será criada para permitir o acesso de entrada à porta de back-end especificada. Se o número máximo de regras de grupo de segurança de rede for excedido, a solicitação falhará com o código de status HTTP 400. NetworkSecurityGroupRule[]
protocolo O protocolo do ponto de extremidade. 'TCP'
'UDP' (obrigatório)

LinuxUserConfiguration

Designação Descrição Valor
GID As propriedades uid e gid devem ser especificadas juntas ou não devem ser especificadas de todo. Se não for especificado, o sistema operacional subjacente seleciona o gid. Int
sshPrivateKey A chave privada não deve ser protegida por senha. A chave privada é usada para configurar automaticamente a autenticação baseada em chave assimétrica para SSH entre nós em um pool Linux quando a propriedade enableInterNodeCommunication do pool é true (ela é ignorada se enableInterNodeCommunication for false). Ele faz isso colocando o par de chaves no diretório .ssh do usuário. Se não for especificado, o SSH sem senha não será configurado entre nós (nenhuma modificação do diretório .ssh do usuário será feita). string

Restrições:
Valor sensível. Passe como um parâmetro seguro.
UID As propriedades uid e gid devem ser especificadas juntas ou não devem ser especificadas de todo. Se não for especificado, o sistema operacional subjacente seleciona o uid. Int

ManagedDisk

Designação Descrição Valor
storageAccountType O tipo de conta de armazenamento para uso na criação de discos de dados ou disco do sistema operacional. 'Premium_LRS'
'StandardSSD_LRS'
'Standard_LRS'

MetadataItem

Designação Descrição Valor
Designação O nome do item de metadados. string (obrigatório)
valor O valor do item de metadados. string (obrigatório)

Microsoft.Batch/batchAccounts/pools

Designação Descrição Valor
identidade O tipo de identidade usado para o pool de lotes. BatchPoolIdentity
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[a-zA-Z0-9_-]+$ (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID do recurso do tipo: batchAccounts
propriedades As propriedades associadas ao pool. PoolProperties
tipo O tipo de recurso "Microsoft.Batch/batchAccounts/pools@2023-11-01"

MountConfiguration

Designação Descrição Valor
azureBlobFileSystemConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. AzureFileShareConfiguration
cifsMountConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. CifsMountConfiguration
nfsMountConfiguration Esta propriedade é mutuamente exclusiva com todas as outras propriedades. NFSMountConfiguration

Configuração de rede

Designação Descrição Valor
dynamicVnetAssignmentScope O escopo da atribuição dinâmica de vnet. 'Trabalho'
'nenhuma'
enableAcceleratedNetworking A rede acelerada permite a virtualização de E/S de raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho de rede. Para obter mais detalhes, consulte: /azure/virtual-network/accelerated-networking-overview. Bool
endpointConfiguration A configuração do ponto de extremidade do pool só é suportada em pools com a propriedade virtualMachineConfiguration. PoolEndpointConfiguration
publicIPAddressConfiguration Essa propriedade só é suportada em Pools com a propriedade virtualMachineConfiguration. PublicIPAddressConfiguration
subnetId A rede virtual deve estar na mesma região e assinatura que a conta do Lote do Azure. A sub-rede especificada deve ter endereços IP livres suficientes para acomodar o número de nós no pool. Se a sub-rede não tiver endereços IP livres suficientes, o pool alocará parcialmente os nós de computação e ocorrerá um erro de redimensionamento. A entidade de serviço 'MicrosoftAzureBatch' deve ter a função 'Colaborador de Máquina Virtual Clássica' Role-Based Controle de Acesso (RBAC) para a VNet especificada. A sub-rede especificada deve permitir a comunicação do serviço Lote do Azure para poder agendar tarefas nos nós de computação. Isso pode ser verificado verificando se a rede virtual especificada tem algum NSG (Network Security Groups) associado. Se a comunicação com os nós de computação na sub-rede especificada for negada por um NSG, o serviço em lote definirá o estado dos nós de computação como inutilizável. Se a VNet especificada tiver algum NSG (Network Security Groups) associado, algumas portas de sistema reservadas deverão ser habilitadas para comunicação de entrada. Para pools criados com uma configuração de máquina virtual, habilite as portas 29876 e 29877, bem como a porta 22 para Linux e a porta 3389 para Windows. Para pools criados com uma configuração de serviço de nuvem, habilite as portas 10100, 20100 e 30100. Habilite também as conexões de saída para o Armazenamento do Azure na porta 443. Para pools cloudServiceConfiguration, apenas VNETs 'clássicas' são suportadas. Para obter mais detalhes, consulte: /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration string

NetworkSecurityGroupRule

Designação Descrição Valor
Acesso A ação que deve ser tomada para um endereço IP, intervalo de sub-rede ou tag especificado. 'Permitir'
'Negar' (obrigatório)
prioridade As prioridades dentro de um pool devem ser únicas e são avaliadas por ordem de prioridade. Quanto menor o número, maior a prioridade. Por exemplo, as regras podem ser especificadas com números de ordem de 150, 250 e 350. A regra com o número de ordem 150 tem precedência sobre a regra que tem uma ordem de 250. As prioridades permitidas são de 150 a 4096. Se algum valor reservado ou duplicado for fornecido, a solicitação falhará com o código de status HTTP 400. int (obrigatório)
sourceAddressPrefix Os valores válidos são um único endereço IP (ou seja, 10.10.10.10), sub-rede IP (ou seja, 192.168.1.0/24), tag padrão ou * (para todos os endereços). Se quaisquer outros valores forem fornecidos, a solicitação falhará com o código de status HTTP 400. string (obrigatório)
sourcePortRanges Os valores válidos são '*' (para todas as portas 0 - 65535) ou matrizes de portas ou intervalos de portas (ou seja, 100-200). As portas devem estar no intervalo de 0 a 65535 e os intervalos de portas ou portas não podem se sobrepor. Se quaisquer outros valores forem fornecidos, a solicitação falhará com o código de status HTTP 400. O valor padrão será *. string[]

NFSMountConfiguration

Designação Descrição Valor
mountOptions [en] Estas são opções de 'net use' no Windows e opções de 'mount' no Linux. string
relativeMountPath Todos os sistemas de arquivos são montados em relação ao diretório Batch mounts, acessível através da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR. string (obrigatório)
fonte O URI do sistema de arquivos a ser montado. string (obrigatório)

NodePlacementConfiguration

Designação Descrição Valor
política Política de alocação usada pelo Batch Service para provisionar os nós. Se não for especificado, o Batch usará a política regional. 'Regional'
'Zonal'

OSDisk

Designação Descrição Valor
armazenamento em cache O tipo de cache a ser habilitado para o disco. 'Nenhuma'
'Somente leitura'
'ReadWrite'
diskSizeGB O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional. Int
ephemeralOSDiskSettings Especifica as configurações de disco efêmeras para o disco do sistema operacional usado pela máquina virtual. DiffDiskSettings
managedDisk ManagedDisk
writeAcceleratorEnabled Especifica se writeAccelerator deve ser habilitado ou desabilitado no disco. Bool

PoolEndpointConfiguration

Designação Descrição Valor
inboundNatPools O número máximo de pools de NAT de entrada por pool de lotes é 5. Se o número máximo de pools NAT de entrada for excedido, a solicitação falhará com o código de status HTTP 400. Isso não pode ser especificado se o IPAddressProvisioningType for NoPublicIPAddresses. InboundNatPool[] (obrigatório)

PoolProperties

Designação Descrição Valor
applicationLicenses A lista de licenças de aplicativo deve ser um subconjunto de licenças de aplicativo de serviço em lote disponíveis. Se for solicitada uma licença que não é suportada, a criação do pool falhará. string[]
applicationPackages As alterações nas referências do pacote de aplicativos afetam todos os novos nós de computação que ingressam no pool, mas não afetam os nós de computação que já estão no pool até que sejam reinicializados ou recriados com imagem. Há um máximo de 10 referências de pacotes de aplicativos em um determinado pool. ApplicationPackageReference []
Certificados Para nós de computação do Windows, o serviço Batch instala os certificados no armazenamento de certificados e no local especificados. Para nós de computação do Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho da tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório inicial do usuário (por exemplo, /home/{user-name}/certs) e os certificados são colocados nesse diretório.

Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o Azure KeyVault Extension.		 CertificateReference[]
deploymentConfiguration Usar CloudServiceConfiguration especifica que os nós devem ser criados usando os Serviços de Nuvem do Azure (PaaS), enquanto VirtualMachineConfiguration usa Máquinas Virtuais do Azure (IaaS). DeploymentConfiguration
displayName O nome para exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024. string
interNodeCommunication Isso impõe restrições sobre quais nós podem ser atribuídos ao pool. Habilitar esse valor pode reduzir a chance de o número solicitado de nós ser alocado no pool. Se não for especificado, o padrão desse valor será 'Desativado'. 'Desativado'
'Habilitado'
metadados O serviço Batch não atribui qualquer significado aos metadados; é exclusivamente para o uso do código de usuário. MetadataItem []
mountConfiguration Isso dá suporte a Arquivos do Azure, NFS, CIFS/SMB e Blobfuse. MountConfiguration[]
networkConfiguration A configuração de rede para um pool. NetworkConfiguration
resourceTags As marcas definidas pelo usuário a serem associadas ao Pool de Lotes do Azure. Quando especificadas, essas marcas são propagadas para os recursos do Azure de suporte associados ao pool. Essa propriedade só pode ser especificada quando a conta Batch foi criada com a propriedade poolAllocationMode definida como 'UserSubscription'. PoolPropertiesResourceTags
scaleSettings Define o tamanho desejado do pool. Isso pode ser 'fixedScale', onde o targetDedicatedNodes solicitado é especificado, ou 'autoScale', que define uma fórmula que é reavaliada periodicamente. Se essa propriedade não for especificada, o pool terá uma escala fixa com 0 targetDedicatedNodes. ScaleSettings
startTask Em uma operação PATCH (atualização), essa propriedade pode ser definida como um objeto vazio para remover a tarefa inicial do pool. StartTask
targetNodeCommunicationMode Se omitido, o valor padrão é Default. 'Clássico'
'Inadimplência'
'Simplificado'
taskSchedulingPolicy Se não for especificado, o padrão será spread. TaskSchedulingPolicy
taskSlotsPerNode O valor padrão é 1. O valor máximo é o menor de 4 vezes o número de núcleos do vmSize do pool ou 256. Int
userContas A lista de contas de usuário a serem criadas em cada nó do pool. Conta de Utilizador[]
vmTamanho Para obter informações sobre tamanhos disponíveis de máquinas virtuais para pools de Serviços de Nuvem (pools criados com cloudServiceConfiguration), consulte Tamanhos para Serviços de Nuvem (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). O Batch suporta todos os tamanhos de VM dos Serviços de Nuvem, exceto o ExtraSmall. Para obter informações sobre tamanhos de VM disponíveis para pools usando imagens do Virtual Machines Marketplace (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Tamanhos para máquinas virtuais (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). O Batch dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (STANDARD_GS, STANDARD_DS e STANDARD_DSV2 séries). string

PoolPropertiesResourceTags

Designação Descrição Valor

PublicIPAddressConfiguration

Designação Descrição Valor
ipAddressIds O número de IPs especificado aqui limita o tamanho máximo do Pool - 100 nós dedicados ou 100 nós Spot/de baixa prioridade podem ser alocados para cada IP público. Por exemplo, um pool que precisa de 250 VMs dedicadas precisaria de pelo menos 3 IPs públicos especificados. Cada elemento desta coleção tem o formato: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}. string[]
provisão O valor padrão é BatchManaged 'BatchManaged'
'NoPublicIPAddresses'
'UserManaged'

Ficheiro de Recursos

Designação Descrição Valor
autoStorageContainerName As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. string
blobPrefix A propriedade é válida somente quando autoStorageContainerName ou storageContainerUrl é usado. Esse prefixo pode ser um nome de arquivo parcial ou um subdiretório. Se um prefixo não for especificado, todos os arquivos no contêiner serão baixados. string
fileMode Esta propriedade aplica-se apenas a arquivos que estão sendo baixados para nós de computação do Linux. Ele será ignorado se for especificado para um resourceFile que será baixado para um nó do Windows. Se essa propriedade não for especificada para um nó Linux, um valor padrão de 0770 será aplicado ao arquivo. string
filePath Se a propriedade httpUrl for especificada, o filePath será necessário e descreverá o caminho para o qual o arquivo será baixado, incluindo o nome do arquivo. Caso contrário, se a propriedade autoStorageContainerName ou storageContainerUrl for especificada, filePath será opcional e será o diretório para o qual os arquivos serão baixados. No caso em que filePath é usado como um diretório, qualquer estrutura de diretório já associada aos dados de entrada será mantida na íntegra e anexada ao diretório filePath especificado. O caminho relativo especificado não pode sair do diretório de trabalho da tarefa (por exemplo, usando '..'). string
httpUrl As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Se a URL apontar para o Armazenamento de Blobs do Azure, ela deverá ser legível a partir dos nós de computação. Há três maneiras de obter essa URL para um blob no armazenamento do Azure: incluir uma Assinatura de Acesso Compartilhado (SAS) concedendo permissões de leitura no blob, usar uma identidade gerenciada com permissão de leitura ou definir a ACL para o blob ou seu contêiner para permitir acesso público. string
identityReference A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará. ComputeNodeIdentityReference
storageContainerUrl As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Este URL deve ser legível e listável a partir de nós de computação. Há três maneiras de obter essa URL para um contêiner no armazenamento do Azure: incluir uma SAS (Assinatura de Acesso Compartilhado) concedendo permissões de leitura e lista no contêiner, usar uma identidade gerenciada com permissões de leitura e lista ou definir a ACL do contêiner para permitir acesso público. string

Configurações de escala

Designação Descrição Valor
autoDimensionamento Esta propriedade e fixedScale são mutuamente exclusivas e uma das propriedades deve ser especificada. AutoScaleSettings
escala fixa Esta propriedade e autoScale são mutuamente exclusivas e uma das propriedades deve ser especificada. FixedScaleSettings

Perfil de Segurança

Designação Descrição Valor
criptografiaAtHost Essa propriedade pode ser usada pelo usuário na solicitação para habilitar ou desabilitar a Criptografia de Host para a máquina virtual ou o conjunto de dimensionamento de máquina virtual. Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. Bool
securityType [en] Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. 'Lançamento confiável'
uefiSettings Especifica as configurações de segurança, como inicialização segura e vTPM, usadas durante a criação da máquina virtual. UefiSettings

ServiceArtifactReference

Designação Descrição Valor
ID A ID de referência do artefato de serviço na forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} string (obrigatório)

IniciarTarefa

Designação Descrição Valor
linha de comando A linha de comando não é executada sob um shell e, portanto, não pode aproveitar os recursos do shell, como a expansão da variável de ambiente. Se você quiser aproveitar esses recursos, você deve invocar o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Obrigatório se quaisquer outras propriedades do startTask forem especificadas. string
containerSettings Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios do Lote do Azure no nó) são mapeados no contêiner, todas as variáveis de ambiente de tarefa são mapeadas no contêiner e a linha de comando da tarefa é executada no contêiner. TaskContainerSettings
ambienteConfigurações Uma lista de configurações de variáveis de ambiente para a tarefa iniciar. EnvironmentSetting[]
maxTaskRetryCount O serviço de lote tenta novamente uma tarefa se seu código de saída for diferente de zero. Observe que esse valor controla especificamente o número de tentativas. O serviço de lote tentará a tarefa uma vez e, em seguida, poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de tentativas for 3, o Batch tentará a tarefa até 4 vezes (uma tentativa inicial e 3 tentativas). Se a contagem máxima de tentativas for 0, o serviço Batch não repetirá a tarefa. Se a contagem máxima de tentativas for -1, o serviço em lote repetirá a tarefa sem limite. O padrão é 0 Int
resourceFiles Uma lista de arquivos que o serviço Batch baixará para o nó de computação antes de executar a linha de comando. ResourceFile []
userIdentity Se omitida, a tarefa é executada como um usuário não administrativo exclusivo para a tarefa. UserIdentity
waitForSuccess Se true e a tarefa inicial falhar em um nó de computação, o serviço Batch tentará novamente a tarefa inicial até sua contagem máxima de tentativas (maxTaskRetryCount). Se a tarefa ainda não tiver sido concluída com êxito após todas as tentativas, o serviço em lote marcará o nó de computação como inutilizável e não agendará tarefas para ele. Esta condição pode ser detetada através do estado do nó e detalhes do erro de agendamento. Se false, o serviço Batch não aguardará a conclusão da tarefa inicial. Nesse caso, outras tarefas podem começar a ser executadas no nó de computação enquanto a tarefa inicial ainda está em execução; E mesmo que a tarefa Iniciar falhe, novas tarefas continuarão a ser agendadas no nó. O padrão é true. Bool

TaskContainerSettings

Designação Descrição Valor
containerRunOptions Essas opções adicionais são fornecidas como argumentos para o comando "docker create", além daquelas controladas pelo Batch Service. string
nome_da_imagem Esta é a referência de imagem completa, como seria especificado para "docker pull". Se nenhuma tag for fornecida como parte do nome da imagem, a tag ":latest" será usada como padrão. string (obrigatório)
registo Essa configuração pode ser omitida se já tiver sido fornecida na criação do pool. ContainerRegistry
diretório de trabalho Um sinalizador para indicar onde está o diretório de trabalho da tarefa de contêiner. O padrão é 'taskWorkingDirectory'. 'ContainerImageDefault'
'TaskWorkingDirectory'

TaskSchedulingPolicy

Designação Descrição Valor
nodeFillType Como as tarefas devem ser distribuídas entre nós de computação. 'Pacote'
'Spread' (obrigatório)

UefiSettings

Designação Descrição Valor
secureBootEnabled Especifica se a inicialização segura deve ser habilitada na máquina virtual. Bool
vTpmAtivado Especifica se o vTPM deve ser habilitado na máquina virtual. Bool

Conta de Utilizador

Designação Descrição Valor
elevaçãoNível nonAdmin - O usuário automático é um usuário padrão sem acesso elevado. admin - O usuário automático é um usuário com acesso elevado e opera com permissões totais de administrador. O valor padrão é nonAdmin. 'Administrador'
'Não administrador'
linuxUserConfiguration Esta propriedade é ignorada se especificada em um pool do Windows. Se não for especificado, o usuário será criado com as opções padrão. LinuxUserConfiguration
Designação O nome da conta de usuário. Os nomes podem conter caracteres Unicode até um comprimento máximo de 20. string (obrigatório)
palavra-passe A senha da conta de usuário. string

Restrições:
Valor sensível. Passe como um parâmetro seguro. (obrigatório)
windowsUserConfiguration Essa propriedade só pode ser especificada se o usuário estiver em um pool do Windows. Se não especificado e em um pool do Windows, o usuário é criado com as opções padrão. WindowsUserConfiguration

UserAssignedIdentities

Designação Descrição Valor

Identidade do usuário

Designação Descrição Valor
autoUsuário As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. AutoUserSpecification
nome de utilizador As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos. string

VirtualMachineConfiguration

Designação Descrição Valor
containerConfiguration Se especificado, a configuração é executada em cada nó do pool para permitir que as tarefas sejam executadas em contêineres. Todas as tarefas regulares e tarefas do gerenciador de tarefas executadas nesse pool devem especificar a propriedade containerSettings e todas as outras tarefas podem especificá-la. ContainerConfiguration
dataDisks Essa propriedade deve ser especificada se os nós de computação no pool precisarem ter discos de dados vazios conectados a eles. DataDisk[]
diskEncryptionConfiguration Se especificado, a criptografia é executada em cada nó do pool durante o provisionamento do nó. DiskEncryptionConfiguration
Extensões Se especificado, as extensões mencionadas nesta configuração serão instaladas em cada nó. VMExtension[]
imageReference Uma referência a uma imagem do Azure Virtual Machines Marketplace ou ao recurso Azure Image de uma Máquina Virtual personalizada. Para obter a lista de todas as imageReferences verificadas pelo Lote do Azure, consulte a operação 'Listar SKUs de agente de nó suportado'. ImageReference (obrigatório)
Tipo de licença Isso só se aplica a imagens que contêm o sistema operacional Windows e só deve ser usado quando você possui licenças locais válidas para os nós que serão implantados. Se omitido, nenhum desconto de licenciamento local será aplicado. Os valores são:

Windows_Server - A licença local é para o Windows Server.
Windows_Client - A licença local é para o Windows Client.		 string
nodeAgentSkuId O agente do nó Batch é um programa executado em cada nó do pool e fornece a interface de comando e controle entre o nó e o serviço Batch. Existem diferentes implementações do agente de nó, conhecido como SKUs, para diferentes sistemas operacionais. Você deve especificar uma SKU do agente de nó que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente de nó suportados, juntamente com sua lista de referências de imagem verificadas, consulte a operação 'Listar SKUs de agente de nó suportados'. string (obrigatório)
nodePlacementConfiguration Essa configuração especificará regras sobre como os nós no pool serão fisicamente alocados. NodePlacementConfiguration
osDisk Contém configuração para configurações efêmeras do OSDisk. OSDisk
perfil de segurança Especifica as configurações de perfil de segurança para a máquina virtual ou o conjunto de dimensionamento de máquina virtual. SecurityProfile
serviceArtifactReference A ID de referência do artefato de serviço na forma de /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} ServiceArtifactReference
windowsConfiguração Essa propriedade não deve ser especificada se imageReference especificar uma imagem do sistema operacional Linux. WindowsConfiguration

VMExtension

Designação Descrição Valor
autoUpgradeMinorVersion Indica se a extensão deve usar uma versão secundária mais recente, se uma estiver disponível no momento da implantação. Uma vez implantada, no entanto, a extensão não atualizará versões secundárias, a menos que seja reimplantada, mesmo com essa propriedade definida como true. Bool
enableAutomaticUpgrade Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. Bool
Designação O nome da extensão da máquina virtual. string (obrigatório)
protegido Configurações A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. qualquer
provisionAfterExtensions Coleção de nomes de extensão após a qual essa extensão precisa ser provisionada. string[]
editora O nome do editor do manipulador de extensão. string (obrigatório)
Configurações Configurações públicas formatadas em JSON para a extensão. qualquer
tipo O tipo de extensões. string (obrigatório)
typeHandlerVersion A versão do manipulador de script. string

WindowsConfiguration

Designação Descrição Valor
enableAutomaticUpdates Se omitido, o valor padrão é true. Bool

WindowsUserConfiguration

Designação Descrição Valor
loginMode Especifica o modo de login para o usuário. O valor padrão para pools VirtualMachineConfiguration é o modo interativo e para os pools CloudServiceConfiguration é o modo em lote. 'Lote'
'Interativo'