Pools - Create Pool

A solicitação foi bem-sucedida e um novo recurso foi criado como resultado.

Cabeçalhos

• DataServiceId: string
• ETag: string
• Last-Modified: string
• client-request-id: string
• request-id: string

BatchError

Uma resposta de erro inesperada.

boolean

Se o recurso de reversão de imagem do sistema operacional deve ser desabilitado.

boolean

Indica se as atualizações do sistema operacional devem ser aplicadas automaticamente às instâncias do conjunto de dimensionamento de forma sem interrupção quando uma versão mais recente da imagem do sistema operacional estiver disponível.

Se isso for definido como true para pools baseados no Windows, WindowsConfiguration.enableAutomaticUpdates não poderá ser definido como true.

boolean

Adie as atualizações do sistema operacional nos TVMs se elas estiverem executando tarefas.

boolean

Indica se a política de atualização sem interrupção deve ser usada durante a Atualização automática do sistema operacional. A atualização automática do sistema operacional fará fallback para a política padrão se nenhuma política for definida no VMSS.

ElevationLevel

O nível de elevação do usuário automático. O valor padrão é nonAdmin.

AutoUserScope

O escopo do usuário automático. O valor padrão é pool. Se o pool estiver executando o Windows, um valor de Tarefa deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa alterar o registro de uma forma que possa afetar outras tarefas.

string (password)

A chave da Conta de Armazenamento do Azure. Essa propriedade é mutuamente exclusiva com sasKey e identidade; exatamente um deve ser especificado.

string

O nome da Conta de Armazenamento do Azure.

string

Opções de linha de comando adicionais para passar para o comando de montagem. Estas são opções de "uso líquido" no Windows e opções de "montagem" no Linux.

string

O nome do Contêiner de Armazenamento de Blobs do Azure.

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário para usar para acessar o ContainerName. Essa propriedade é mutuamente exclusiva com accountKey e sasKey; exatamente um deve ser especificado.

string

O caminho relativo no nó de computação onde o sistema de arquivos será montado. Todos os sistemas de arquivos são montados em relação ao diretório de montagens do Lote, acessível por meio da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR.

string (password)

O token SAS do Armazenamento do Azure. Essa propriedade é mutuamente exclusiva com accountKey e identidade; exatamente um deve ser especificado.

string (password)

A chave da conta de Armazenamento do Azure.

string

O nome da conta de Armazenamento do Azure.

string (uri)

A URL de Arquivos do Azure. Isso é do formulário 'https://{account}.file.core.windows.net/'.

string

Opções de linha de comando adicionais para passar para o comando de montagem. Estas são opções de "uso líquido" no Windows e opções de "montagem" no Linux.

string

O caminho relativo no nó de computação onde o sistema de arquivos será montado. Todos os sistemas de arquivos são montados em relação ao diretório de montagens do Lote, acessível por meio da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR.

string

O ID do aplicativo a ser implantado. Ao criar um pool, a ID do aplicativo do pacote deve ser totalmente qualificada (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

string

A versão do aplicativo a ser implantado. Se omitida, a versão padrão será implantada. Se isso for omitido em um Pool, e nenhuma versão padrão for especificada para esta aplicação, a solicitação falha com o código de erro InvalidApplicationPackageReferences, e o código de status HTTP 409. Se isso for omitido em uma tarefa, e nenhuma versão padrão for especificada para essa aplicação, a tarefa falha com um erro de pré-processamento.

string[]

A coleção de nomes de imagens dos contêineres. Esta é a referência completa da Imagem, conforme especificado para "docker pull". Uma Imagem será obtida a partir do registro padrão do Docker, a menos que a Imagem esteja totalmente qualificada em um registro alternativo.

ContainerRegistryReference[]

Registros privados adicionais dos quais os contêineres podem ser extraídos. Se alguma Imagem precisa ser baixada de um registro privado que exige credenciais, então essas credenciais devem ser fornecidas aqui.

ContainerType

A tecnologia de contêiner a ser usada.

DiffDiskPlacement

Especifica o posicionamento de disco efêmero para o disco do sistema operacional para todas as VMs no pool. Essa propriedade pode ser usada pelo usuário na solicitação para escolher o local, por exemplo, armazenar espaço em disco em cache para provisionamento de disco do sistema operacional efêmero. Para obter mais informações sobre os requisitos de tamanho do disco do sistema operacional efêmero, consulte os requisitos de tamanho de disco do sistema operacional efêmero para VMs windows em VMs https://v4.hkg1.meaqua.org/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements e Linux em https://v4.hkg1.meaqua.org/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

BatchErrorMessage

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

BatchErrorDetail[]

Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro.

string

Um identificador que especifica o significado da propriedade Value.

string

As informações adicionais incluídas na resposta de erro.

string

O código de idioma da mensagem de erro.

string

O texto da mensagem.

integer (int32)

O número da porta no Nó de Computação. Isso deve ser único dentro de um Batch Pool. Os valores aceitáveis estão entre 1 e 65535, exceto 29876 e 29877, pois são reservados. Se quaisquer valores reservados forem fornecidos, a solicitação falhará com o código de status HTTP 400.

integer (int32)

O último número de porta na faixa de portas externas que serão usadas para fornecer acesso de entrada ao backendPort em nós de computação individuais. Os valores aceitáveis variam entre 1 e 65534, exceto as portas de 50000 a 55000 que são reservadas pelo serviço do Lote. Todos os intervalos dentro de um Pool devem ser distintos e não podem se sobrepor. Cada faixa deve conter pelo menos 40 portas. Se quaisquer valores reservados ou sobrepostos forem fornecidos, a solicitação falhará com o código de status HTTP 400.

integer (int32)

O primeiro número de porta na faixa de portas externas que serão usadas para fornecer acesso de entrada ao backendPort em nós de computação individuais. 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. Cada faixa deve conter pelo menos 40 portas. Se quaisquer valores reservados ou sobrepostos forem fornecidos, a solicitação falhará com o código de status HTTP 400.

string

O nome do ponto de extremidade. O nome deve ser único dentro de um Batch Pool, podendo conter letras, números, sublinhatões, pontos e hífens. Os nomes devem começar com uma letra ou número, devem terminar com uma letra, um número ou um sublinhado e não podem exceder 77 caracteres. Se quaisquer valores inválidos forem fornecidos, a solicitação falhará com o código de status HTTP 400.

NetworkSecurityGroupRule[]

Uma lista de regras de grupo de segurança de rede que serão aplicadas ao ponto de extremidade. O número máximo de regras que podem ser especificadas em todos os endpoints de um Batch Pool é 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 ao back-endPort especificado. Se o número máximo de regras do grupo de segurança de rede for excedido, a solicitação falhará com o código de status HTTP 400.

InboundEndpointProtocol

O protocolo do ponto de extremidade.

string

O nome do item de metadados.

string

O valor do item de metadados.

string (arm-id)

A ID de recurso do ARM da identidade atribuída pelo usuário.

BatchNodePlacementPolicyType

Tipo de política de posicionamento de nó em pools de lote. Política de alocação usada pelo Serviço de Lote para provisionar os nós. Se não for especificado, o Lote usará a política regional.

CachingType

Especifica os requisitos de cache. Os valores possíveis são: None, ReadOnly, ReadWrite. Os valores padrão são: Nenhum para armazenamento Standard. ReadOnly para armazenamento Premium.

integer (int32)

O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional.

BatchDiffDiskSettings

Especifica as Configurações de Disco efêmero para o disco do sistema operacional usado pela VM (nó de computação).

ManagedDisk

Os parâmetros de disco gerenciado.

boolean

Especifica se writeAccelerator deve ser habilitado ou desabilitado no disco.

BatchApplicationPackageReference[]

A lista de pacotes a serem instalados em cada Nó de Computação no Pool. Ao criar um pool, a ID do aplicativo do pacote deve ser totalmente qualificada (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). As alterações nas referências de pacote afetam todos os novos nós que ingressam no Pool, mas não afetam nós de computação que já estão no Pool até que sejam reinicializados ou reimageados. Há um máximo de 10 referências de pacote em um determinado pool.

string (duration)

O intervalo de tempo no qual ajustar automaticamente o tamanho do Pool de acordo com a fórmula de dimensionamento automático. O valor padrão é 15 minutos. O valor mínimo e máximo é de 5 minutos e 168 horas, respectivamente. Se você especificar um valor menor que 5 minutos ou maior que 168 horas, o serviço do Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).

string

Uma fórmula para o número desejado de Nós de Computação no Pool. Essa propriedade não deverá ser especificada se enableAutoScale for definido como false. Ele será necessário se enableAutoScale estiver definido como true. A fórmula é verificada quanto à validade antes da criação do Pool. Se a fórmula não for válida, o serviço do Lote rejeitará a solicitação com informações detalhadas de erro. Para obter mais informações sobre como especificar essa fórmula, consulte "Dimensionar automaticamente nós de computação em um pool de lote do Azure" (https://v4.hkg1.meaqua.org/azure/batch/batch-automatic-scaling).

string

O nome de exibição do Pool. O nome de exibição não precisa ser exclusivo e pode conter caracteres Unicode até um comprimento máximo de 1024.

boolean

Se o tamanho do Pool deve ser ajustado automaticamente ao longo do tempo. Se for falso, pelo menos um dos targetDedicatedNodes e targetLowPriorityNodes deverá ser especificado. Se for true, a propriedade autoScaleFormula será necessária e o Pool será redimensionado automaticamente de acordo com a fórmula. O valor padrão é false.

boolean

Se o Pool permite comunicação direta entre nós de computação. Habilitar a comunicação entre nós limita o tamanho máximo do pool devido a restrições de implantação nos nós de computação do pool. Isso pode fazer com que o Pool não atinja o tamanho desejado. O valor padrão é false.

string

Uma cadeia de caracteres que identifica exclusivamente o pool na Conta. A ID pode conter qualquer combinação de caracteres alfanuméricos, incluindo hifens e sublinhados, e não pode conter mais de 64 caracteres. A ID não diferencia maiúsculas de minúsculas e maiúsculas de minúsculas (ou seja, você pode não ter duas IDs de pool em uma conta que diferem apenas por caso).

BatchMetadataItem[]

Uma lista de pares nome-valor associados ao Pool como metadados. O serviço do Lote não atribui nenhum significado aos metadados; é apenas para o uso do código do usuário.

MountConfiguration[]

Monte o armazenamento usando o sistema de arquivos especificado durante todo o tempo de vida do pool. Monte o armazenamento usando o compartilhamento de arquivos do Azure, NFS, CIFS ou sistema de arquivos baseado em Blobfuse.

NetworkConfiguration

A configuração de rede do Pool.

string (duration)

O tempo limite para alocação de nós de computação para o pool. Esse tempo limite se aplica apenas ao dimensionamento manual; ele não tem efeito quando enableAutoScale é definido como true. O valor padrão é 15 minutos. O valor mínimo é 5 minutos. Se você especificar um valor menor que 5 minutos, o serviço do Lote retornará um erro; se você estiver chamando a API REST diretamente, o código de status HTTP será 400 (Solicitação Incorreta).

BatchStartTask

Uma tarefa especificada para ser executada em cada Nó de Computação à medida que ele ingressa no pool. A Tarefa é executada quando o Nó de Computação é adicionado ao Pool ou quando o Nó de Computação é reiniciado.

integer (int32)

O número desejado de nós de computação dedicados no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale for definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

integer (int32)

O número desejado de nós de computação spot/de baixa prioridade no pool. Essa propriedade não deve ser especificada se enableAutoScale estiver definido como true. Se enableAutoScale for definido como false, você deverá definir targetDedicatedNodes, targetLowPriorityNodes ou ambos.

BatchTaskSchedulingPolicy

Como as tarefas são distribuídas entre nós de computação em um pool. Se não for especificado, o padrão será distribuído.

integer (int32)

O número de slots de tarefas que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. 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.

UpgradePolicy

A política de atualização do Pool. Descreve uma política de atualização – automática, manual ou sem interrupção.

UserAccount[]

A lista de contas de usuário a serem criadas em cada Nó de Computação no Pool.

VirtualMachineConfiguration

A configuração da máquina virtual para o Pool. Essa propriedade deve ser especificada.

string

O tamanho das máquinas virtuais no Pool. Todas as máquinas virtuais em um Pool têm o mesmo tamanho. Para obter informações sobre os tamanhos de VM disponíveis para pools usando imagens do Marketplace de Máquinas Virtuais (pools criados com virtualMachineConfiguration), consulte Tamanhos para máquinas virtuais no Azure (https://v4.hkg1.meaqua.org/azure/virtual-machines/sizes/overview). O Lote dá suporte a todos os tamanhos de VM do Azure, exceto STANDARD_A0 e aqueles com armazenamento premium (séries STANDARD_GS, STANDARD_DS e STANDARD_DSV2).

BatchInboundNatPool[]

Uma lista de NAT Pools de entrada que podem ser usados para endereçar portas específicas em um Nó de Computação individual externamente. O número máximo de NAT Pools de entrada por Batch Pool é 5. Se o número máximo de NAT Pools de entrada for ultrapassado, a solicitação falha com o código de status HTTP 400. Isso não poderá ser especificado se o IPAddressProvisioningType for NoPublicIPAddresses.

string (arm-id)

A ID de recurso do ARM da identidade atribuída pelo usuário. Essa referência deve ser incluída nas identidades do pool.

string[] (arm-id)

A lista de IPs públicos que o serviço do Lote usará ao provisionar nós de computação. 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 três IPs públicos especificados. Cada elemento dessa coleção é do formulário: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

IPFamily[]

As famílias de IP usadas para especificar as versões de IP disponíveis para o pool. As famílias de IP são usadas para determinar pools de pilha única ou dupla. Para pilha única, o valor esperado é IPv4. Para pilha dupla, os valores esperados são IPv4 e IPv6.

IPTag[]

Uma lista de marcas IP associadas aos endereços IP públicos do Pool. As tags IP são usadas para categorizar e filtrar endereços IP públicos para fins de cobrança e gerenciamento.

IpAddressProvisioningType

O tipo de provisionamento para endereços IP públicos para o pool. O valor padrão é BatchManaged.

string

A linha de comando do StartTask. A linha de comando não é executada em um shell e, portanto, não pode aproveitar os recursos do shell, como expansão de variável de ambiente. Se quiser aproveitar esses recursos, invoque o shell na linha de comando, por exemplo, usando "cmd /c MyCommand" no Windows ou "/bin/sh -c MyCommand" no Linux. Se a linha de comando se referir a caminhos de arquivo, ela deverá usar um caminho relativo (relativo ao diretório de trabalho da Tarefa) ou usar a variável de ambiente fornecida pelo Lote (https://v4.hkg1.meaqua.org/azure/batch/batch-compute-node-environment-variables).

BatchTaskContainerSettings

As configurações do contêiner sob o qual o StartTask roda. Quando isso é especificado, todos os diretórios recursivamente abaixo do AZ_BATCH_NODE_ROOT_DIR (a raiz dos diretórios Batch do Azure no nó) são mapeados no contêiner, todas as variáveis do ambiente Tarefa são mapeadas no contêiner, e a linha de comando Tarefa é executada no contêiner. Arquivos produzidos no contêiner fora do AZ_BATCH_NODE_ROOT_DIR podem não ser refletidos no disco hospedeiro, o que significa que APIs de arquivos Batch não conseguirão acessar esses arquivos.

EnvironmentSetting[]

Uma lista de configurações de variável de ambiente para o StartTask.

integer (int32)

O número máximo de vezes que a Tarefa pode ser repetida. O serviço do Lote tentará novamente uma Tarefa se o código de saída não for zero. Observe que esse valor controla especificamente o número de repetições. O serviço lote tentará a Tarefa uma vez e poderá tentar novamente até esse limite. Por exemplo, se a contagem máxima de repetição for 3, o Lote tentará a Tarefa até 4 vezes (uma tentativa inicial e três tentativas). Se a contagem máxima de repetição for 0, o serviço do Lote não tentará novamente a Tarefa. Se a contagem máxima de repetição for -1, o serviço do Lote repetirá a Tarefa sem limite, no entanto, isso não é recomendado para uma tarefa inicial ou qualquer tarefa. O valor padrão é 0 (sem novas tentativas).

ResourceFile[]

Uma lista de arquivos que o serviço do Lote baixará no Nó de Computação antes de executar a linha de comando. Há um tamanho máximo para a lista de arquivos de recurso. Quando o tamanho máximo for excedido, a solicitação falhará e o código de erro de resposta será RequestEntityTooLarge. Se isso ocorrer, a coleção de ResourceFiles deverá ser reduzida em tamanho. Isso pode ser feito usando arquivos .zip, pacotes de aplicativos ou contêineres do Docker. Os arquivos listados sob esse elemento estão localizados no diretório de trabalho da Tarefa.

UserIdentity

A identidade do usuário sob a qual o StartTask é executado. Se omitida, a Tarefa roda como um usuário não administrativo exclusivo da Tarefa.

boolean

Se o serviço do Lote deve aguardar a conclusão do StartTask com êxito (ou seja, sair com o código de saída 0) antes de agendar tarefas no Nó de Computação. Se true e o StartTask falharem em um nó, o serviço do Lote tentará novamente o StartTask até sua contagem máxima de repetição (maxTaskRetryCount). Se a Tarefa ainda não tiver sido concluída com êxito após todas as novas tentativas, o serviço do Lote marcará o nó inutilizável e não agendará Tarefas para ela. Essa condição pode ser detectada por meio do estado do Nó de Computação e dos detalhes das informações de falha. Se for falso, o serviço do Lote não aguardará a conclusão do StartTask. Nesse caso, outras tarefas podem começar a ser executadas no Nó de Computação enquanto o StartTask ainda estiver em execução; e mesmo que o StartTask falhe, novas tarefas continuarão a ser agendadas no Nó de Computação. O padrão é verdadeiro.

ContainerHostBatchBindMountEntry[]

Os caminhos que você deseja montar na tarefa de contêiner. Se essa matriz for nula ou não estiver presente, a tarefa de contêiner montará toda a unidade de disco temporária no Windows (ou AZ_BATCH_NODE_ROOT_DIR no Linux). Ele não montará nenhum caminho de dados no contêiner se essa matriz estiver definida como vazia.

string

Opções adicionais para o comando de criação de contêiner. Essas opções adicionais são fornecidas como argumentos para o comando "docker create", além das controladas pelo Serviço de Lote.

string

A imagem a ser usada para criar o contêiner onde a tarefa será executada. Esta é a referência completa da Imagem, conforme especificado para "docker pull". Se nenhuma tag for fornecida como parte do nome da Imagem, a tag ":latest" é usada como padrão.

ContainerRegistryReference

O registro privado que contém a imagem do contêiner. Essa configuração pode ser omitida se já foi fornecida na criação do Pool.

ContainerWorkingDirectory

A localização do diretório de trabalho Container Task. O padrão é 'taskWorkingDirectory'.

BatchJobDefaultOrder

A ordem para agendar tarefas de diferentes trabalhos com a mesma prioridade. Se não for especificado, o padrão será nenhum.

BatchNodeFillType

Como as tarefas são distribuídas entre nós de computação em um pool. Se não for especificado, o padrão será distribuído.

boolean

Especifica se a inicialização segura deve ser habilitada na máquina virtual.

boolean

Especifica se o vTPM deve ser habilitado na máquina virtual.

SecurityEncryptionTypes

Especifica o EncryptionType do disco gerenciado. Ele é definido como VMGuestStateOnly para criptografia apenas do blob VMGuestState e NonPersistedTPM para não persistir o estado de firmware no blob VMGuestState. Observação: ele pode ser definido apenas para VMs confidenciais e é necessário ao usar VMs confidenciais.

string

A imagem da galeria comunitária identificador único. Essa propriedade é mutuamente exclusiva com outras propriedades e pode ser buscada na chamada GET da imagem da galeria da comunidade.

string

A versão específica da imagem da plataforma ou da imagem do marketplace usada para criar o nó. Esse campo somente leitura difere de 'versão' apenas se o valor especificado para 'versão' quando o pool foi criado fosse 'mais recente'.

string

O tipo de oferta da Imagem do Marketplace de Máquinas Virtuais Azure. Por exemplo, UbuntuServer ou WindowsServer.

string

A editora da Azure Virtual Machines Marketplace Image. Por exemplo, Canonical ou MicrosoftWindowsServer.

string

Identificador único da imagem da galeria compartilhada. Essa propriedade é mutuamente exclusiva com outras propriedades e pode ser buscada na chamada GET da imagem da galeria compartilhada.

string

O SKU da Imagem do Azure Virtual Machines Marketplace. Por exemplo, 18.04-LTS ou 2019-Datacenter.

string

A versão da Imagem do Marketplace de Máquinas Virtuais do Azure. Um valor de 'mais recente' pode ser especificado para selecionar a versão mais recente de uma Imagem. Se omitido, o padrão será 'latest'.

string (arm-id)

O identificador de recurso do ARM da Imagem da Galeria de Computação do Azure. Os Nós de Computação no Pool serão criados usando este ID de Imagem. Isso é da forma /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} ou /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} para sempre usar a versão mais recente da imagem. Essa propriedade é mutuamente exclusiva com outras propriedades do ImageReference. A Imagem da Galeria de Computação do Azure deve ter réplicas na mesma região e estar na mesma assinatura da conta Batch do Azure. Se a versão da imagem não for especificada no imageId, a versão mais recente será usada. Para informações sobre as configurações do firewall para o agente do Nó de Computação Batch para se comunicar com o serviço Batch, veja https://v4.hkg1.meaqua.org/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

string

Opções de linha de comando adicionais para passar para o comando de montagem. Estas são opções de "uso líquido" no Windows e opções de "montagem" no Linux.

string (password)

A senha a ser usada para autenticação no sistema de arquivos CIFS.

string

O caminho relativo no nó de computação onde o sistema de arquivos será montado. Todos os sistemas de arquivos são montados em relação ao diretório de montagens do Lote, acessível por meio da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR.

string

O URI do sistema de arquivos a ser montado.

string

O usuário a ser usado para autenticação no sistema de arquivos CIFS.

boolean

Monte esse caminho de origem como modo somente leitura ou não. O valor padrão é falso (modo de leitura/gravação). Para o Linux, se você montar esse caminho como um modo de leitura/gravação, isso não significa que todos os usuários no contêiner tenham o acesso de leitura/gravação para o caminho, isso depende do acesso na VM do host. Se esse caminho for montado somente leitura, todos os usuários dentro do contêiner não poderão modificar o caminho.

ContainerHostDataPath

O caminho que será montado no cliente do contêiner pode ser selecionado.

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário a ser usada para acessar um Registro de Contêiner do Azure em vez de nome de usuário e senha.

string (password)

A senha para fazer logon no servidor do Registro.

string (uri)

A URL do registro. Se omitido, o padrão será "docker.io".

string

O nome de usuário a ser conectado ao servidor do Registro.

CachingType

O tipo de cache a ser habilitado para os discos de dados. O valor padrão para o cache é readwrite. 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/.

integer (int32)

O tamanho inicial do disco em gigabytes.

integer (int32)

O número da unidade lógica. O logicalUnitNumber é usado para identificar exclusivamente cada disco de dados. Se estiver anexando vários discos, cada um deve ter um logicalUnitNumber distinto. O valor deve estar entre 0 e 63, inclusive.

ManagedDisk

Os parâmetros de disco gerenciado.

StorageAccountType

O tipo de conta de armazenamento a ser usado para o disco de dados. Se omitido, o padrão será "standard_lrs".

BatchPoolIdentityReference

A referência de uma das identidades do pool para criptografar o disco. Essa identidade será usada para acessar o KeyVault.

string

Url de chave totalmente com versão apontando para uma chave no KeyVault. O segmento de versão da URL é necessário independentemente do valor rotationToLatestKeyVersionEnabled.

boolean

Defina esse sinalizador como true para habilitar a atualização automática da Criptografia de Disco para a versão mais recente da chave. O padrão é false.

DiskCustomerManagedKey

A referência de Chave Gerenciada pelo Cliente para criptografar o disco do sistema operacional. A Chave Gerenciada pelo Cliente criptografará o disco do sistema operacional por EncryptionAtRest e, por padrão, também criptografaremos o disco de dados. Ele só pode ser usado quando o pool está configurado com uma identidade e o OsDisk está definido como um dos destinos do DiskEncryption.

DiskEncryptionTarget[]

A lista de destinos de disco do Serviço de Lote será criptografada no nó de computação. A lista de destinos de disco do Serviço de Lote será criptografada no nó de computação.

string (arm-id)

A ID do recurso ARM do conjunto de criptografia de disco. O recurso deve estar na mesma assinatura que a conta do Lote.

string

O nome da variável de ambiente.

string

O valor da variável de ambiente.

string

Especifica a referência à ID do recurso InVMAccessControlProfileVersion na forma de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}.

HostEndpointSettingsModeTypes

Especifica o modo de execução da política de controle de acesso.

string

O tipo de tag IP. Exemplo: FirstPartyUsage.

string

O valor da marca IP associada ao IP público. Exemplo: SQL.

integer (int32)

O ID do grupo para a conta do usuário. As propriedades uid e gid devem ser especificadas juntas ou não. Se não for especificado, o sistema operacional subjacente escolherá o gid.

string (password)

A chave privada SSH para a conta do usuário. 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 de Computação em um Pool Linux quando a propriedade enableInterNodeCommunication do Pool é verdadeira (ela é ignorada se o enableInterNodeCommunication for falso). Ele faz isso colocando o par de chaves no diretório .ssh do usuário. Se não especificado, o SSH sem senha não é configurado entre os Nós de Computação (nenhuma modificação do diretório .ssh do usuário é feita).

integer (int32)

O ID de usuário da conta do usuário. As propriedades uid e gid devem ser especificadas juntas ou não. Se não for especificado, o sistema operacional subjacente escolherá a uid.

DiskEncryptionSetParameters

Especifica a ID do recurso do conjunto de criptografia de disco gerenciado pelo cliente para o disco gerenciado. Ele só pode ser definido no modo UserSubscription.

BatchVmDiskSecurityProfile

Especifica as configurações de perfil de segurança para o disco gerenciado.

StorageAccountType

O tipo de conta de armazenamento do disco gerenciado.

AzureBlobFileSystemConfiguration

O Contêiner de Armazenamento do Azure a ser montado usando o FUSE de blob em cada nó. Essa propriedade é mutuamente exclusiva com todas as outras propriedades.

AzureFileShareConfiguration

O Compartilhamento de Arquivos do Azure a ser montado em cada nó. Essa propriedade é mutuamente exclusiva com todas as outras propriedades.

CifsMountConfiguration

O sistema de arquivos CIFS/SMB a ser montado em cada nó. Essa propriedade é mutuamente exclusiva com todas as outras propriedades.

NfsMountConfiguration

O sistema de arquivos NFS a ser montado em cada nó. Essa propriedade é mutuamente exclusiva com todas as outras propriedades.

DynamicVNetAssignmentScope

O escopo da atribuição de vnet dinâmica.

boolean

Se esse pool deve habilitar a rede acelerada. A rede acelerada permite a virtualização de E/S raiz única (SR-IOV) para uma VM, o que pode levar a um melhor desempenho de rede. Para obter mais detalhes, consulte: https://v4.hkg1.meaqua.org/azure/virtual-network/accelerated-networking-overview.

BatchPoolEndpointConfiguration

A configuração para endpoints em nós de computação no Batch Pool.

BatchPublicIpAddressConfiguration

A configuração de IPAddress público para nós de computação no Pool de Lotes.

string

O identificador de recurso ARM da sub-rede virtual que os Nós de Computação do Pool irão se juntar. Isso é do formulário /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. 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 de Computação no Pool. Se a sub-rede não tiver endereços IP livres suficientes, o pool vai alocar parcialmente os nós e um erro de redimensionamento ocorre. A entidade de serviço 'MicrosoftAzureBatch' deve ter a função "Colaborador de Máquina Virtual Clássica" Role-Based RBAC (Controle de Acesso) para a VNet especificada. A sub-rede especificada deve permitir a comunicação do serviço Batch do Azure para que seja possível agendar Tarefas nos Nós. Isso pode ser verificado verificando se a VNet especificada tem algum NSG (Grupos de Segurança de Rede) associados. Se a comunicação com os Nós na sub-rede especificada for negada por um NSG, o serviço lote definirá o estado dos Nós de Computação como inutilizável. Apenas redes virtuais ARM ('Microsoft.Network/virtualNetworks') são suportadas. Se o VNet especificado tiver algum Agrupamento de Segurança de Rede (NSG) associado, então algumas portas reservadas do sistema devem ser habilitadas para comunicação de entrada, incluindo as portas 29876 e 29877. Habilite também conexões de saída para o Armazenamento do Azure na porta 443. Para obter mais detalhes, consulte: https://v4.hkg1.meaqua.org/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRuleAccess

A ação que deve ser tomada para um endereço IP especificado, intervalo de sub-rede ou marca.

integer (int32)

A prioridade dessa regra. Prioridades dentro de um Pool devem ser únicas e avaliadas em ordem de prioridade. Quanto menor o número, maior a prioridade. Por exemplo, as regras podem ser especificadas com números de pedidos 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 quaisquer valores reservados ou duplicados forem fornecidos, a solicitação falhará com o código de status HTTP 400.

string

O prefixo ou marca de endereço de origem a ser correspondente à regra. 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), marca 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[]

Os intervalos de porta de origem a serem correspondentes à regra. Valores válidos são '' (para todas as portas de 0 a 65535), uma porta específica (ou seja, 22) ou um intervalo de portas (ex. 100-200). As portas devem estar na faixa de 0 a 65535. Cada entrada nesta coleção não deve sobrepor-se a nenhuma outra entrada (seja um intervalo ou uma porta individual). Se outros valores forem fornecidos, a solicitação falha com o código de status HTTP 400. O valor padrão é ''.

string

Opções de linha de comando adicionais para passar para o comando de montagem. Estas são opções de "uso líquido" no Windows e opções de "montagem" no Linux.

string

O caminho relativo no nó de computação onde o sistema de arquivos será montado. Todos os sistemas de arquivos são montados em relação ao diretório de montagens do Lote, acessível por meio da variável de ambiente AZ_BATCH_NODE_MOUNTS_DIR.

string

O URI do sistema de arquivos a ser montado.

boolean

Especifica se o recurso Protocolo de Segurança de Metadados deve ser habilitado na máquina virtual ou no conjunto de dimensionamento de máquinas virtuais. O padrão é False.

HostEndpointSettings

Configurações para o ponto de extremidade do IMDS.

HostEndpointSettings

Configurações do ponto de extremidade WireServer.

string

O nome do container de armazenamento está na conta de armazenamento automático. As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada.

string

O prefixo de blob a ser usado ao baixar blobs de um contêiner do Armazenamento do Azure. Somente os blobs cujos nomes começam com o prefixo especificado serão baixados. 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

O atributo de modo de permissão de arquivo no formato octal. Essa propriedade se aplica apenas a arquivos sendo baixados para os Nós de Computação do Linux. Ele será ignorado se for especificado para um ResourceFile que será baixado em um Nó de Computação do Windows. Se essa propriedade não for especificada para um Nó de Computação Linux, então um valor padrão de 0770 é aplicado ao arquivo.

string

A localização no Nó de Computação para onde baixar o(s) arquivo(s), relativa ao diretório de trabalho da Tarefa. 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 baixar os arquivos. No caso em que o filePath é usado como um diretório, qualquer estrutura de diretório já associada aos dados de entrada será retida na íntegra e acrescentada ao diretório filePath especificado. O caminho relativo especificado não pode sair do diretório de trabalho da Tarefa (por exemplo, usando '..').

string (uri)

A URL do arquivo a ser baixado. 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 de nós de computação. Há três maneiras de obter essa URL para um blob no armazenamento do Azure: incluir uma SAS (Assinatura de Acesso Compartilhado) 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.

BatchNodeIdentityReference

A referência à identidade atribuída pelo usuário para usar para acessar o Azure Blob Storage especificada por storageContainerUrl ou httpUrl.

string (uri)

A URL do contêiner de blob no Armazenamento de Blobs do Azure. As propriedades autoStorageContainerName, storageContainerUrl e httpUrl são mutuamente exclusivas e uma delas deve ser especificada. Essa URL deve ser legível e listável 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 para o contêiner para permitir acesso público.

boolean

Permitir que o VMSS ignore os limites do AZ ao construir lotes de atualização. Leve em consideração o Domínio de Atualização e maxBatchInstancePercent para determinar o tamanho do lote. Esse campo pode ser definido como true ou false somente ao usar NodePlacementConfiguration como Zonal.

integer (int32)

A porcentagem máxima do total de instâncias de máquina virtual que serão atualizadas simultaneamente pela atualização sem interrupção em um lote. Como isso é um máximo, instâncias não íntegras em lotes anteriores ou futuros podem fazer com que o percentual de instâncias em um lote diminua para garantir maior confiabilidade. O valor desse campo deve estar entre 5 e 100, inclusive. Se maxBatchInstancePercent e maxUnhealthyInstancePercent forem atribuídos com valor, o valor de maxBatchInstancePercent não deverá ser maior que maxUnhealthyInstancePercent.

integer (int32)

O percentual máximo do total de instâncias de máquina virtual no conjunto de dimensionamento que pode ser simultaneamente não íntegro, seja como resultado da atualização ou por ser encontrado em um estado não íntegro pelas verificações de integridade da máquina virtual antes que a atualização sem interrupção seja anulada. Essa restrição será verificada antes de iniciar qualquer lote. O valor desse campo deve estar entre 5 e 100, inclusive. Se maxBatchInstancePercent e maxUnhealthyInstancePercent forem atribuídos com valor, o valor de maxBatchInstancePercent não deverá ser maior que maxUnhealthyInstancePercent.

integer (int32)

O percentual máximo de instâncias de máquina virtual atualizadas que podem ser encontradas em um estado não íntegro. Essa verificação ocorrerá depois que cada lote for atualizado. Se esse percentual for excedido, a atualização sem interrupção será anulada. O valor desse campo deve estar entre 0 e 100, inclusive.

string (duration)

O tempo de espera entre concluir a atualização de todas as máquinas virtuais em um lote e iniciar o próximo lote. A duração do tempo deve ser especificada no formato ISO 8601..

boolean

Atualize todas as instâncias não íntegras em um conjunto de dimensionamento antes de qualquer instância íntegra.

boolean

Reverter instâncias com falha para o modelo anterior se a política de Atualização Sem Interrupção for violada.

boolean

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áquinas virtuais. Isso habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. Para obter mais informações sobre criptografia nos requisitos de host, consulte https://v4.hkg1.meaqua.org/azure/virtual-machines/disk-encryption#supported-vm-sizes.

ProxyAgentSettings

Especifica as configurações de ProxyAgent ao criar a máquina virtual.

SecurityTypes

Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings.

BatchUefiSettings

Especifica as configurações de segurança, como inicialização segura e vTPM usadas durante a criação da máquina virtual. Especifica as configurações de segurança, como inicialização segura e vTPM usadas durante a criação da máquina virtual.

string

O ID de referência do artefato de serviço 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}

AutomaticOsUpgradePolicy

Parâmetros de configuração usados para executar a atualização automática do sistema operacional. Os parâmetros de configuração usados para executar a atualização automática do sistema operacional.

UpgradeMode

Especifica o modo de uma atualização para máquinas virtuais no conjunto de dimensionamento.

Os valores possíveis são:

Manual – você controla a aplicação de atualizações para máquinas virtuais no conjunto de dimensionamento. Faça isso usando a ação manualUpgrade.

automático – todas as máquinas virtuais no conjunto de dimensionamento são atualizadas automaticamente ao mesmo tempo.

Rolling – O conjunto de dimensionamento executa atualizações em lotes com um tempo de pausa opcional no meio.

RollingUpgradePolicy

Os parâmetros de configuração usados durante a execução de uma atualização sem interrupção.

ElevationLevel

O nível de elevação da conta do usuário. O valor padrão é nonAdmin.

LinuxUserConfiguration

A configuração específica do usuário Linux para a Conta de usuário. Essa propriedade é ignorada se especificada em um Windows Pool. Se não for especificado, o usuário será criado com as opções padrão.

string

O nome da conta de usuário. Os nomes podem conter caracteres Unicode até um comprimento máximo de 20.

string (password)

A senha da conta de usuário.

WindowsUserConfiguration

A configuração específica do usuário do Windows para a Conta de usuário. Essa propriedade só pode ser especificada se o usuário estiver em um Windows Pool. Se não for especificado e estiver em um Windows Pool, o usuário é criado com as opções padrão.

AutoUserSpecification

O usuário automático sob o qual a Tarefa é executada. As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos.

string

O nome da identidade do usuário sob a qual a Tarefa é executada. As propriedades userName e autoUser são mutuamente exclusivas; você deve especificar um, mas não ambos.

BatchContainerConfiguration

A configuração do contêiner para o Pool. Se especificado, a configuração é realizada em cada Nó de Computação do Pool para permitir que as Tarefas sejam executadas em containers. Todas as Tarefas normais e Tarefas do Gerenciador de Jobs rodadas neste Pool devem especificar a propriedade containerSettings, e todas as outras Tarefas podem especificá-la.

DataDisk[]

A configuração para discos de dados conectados aos Nós de Computação no Pool. Essa propriedade deve ser especificada caso os Nós de Computação do Pool precisem ter discos de dados vazios conectados a eles. Isso não pode ser atualizado. Cada Nó de Computação recebe seu próprio disco (o disco não é um compartilhamento de arquivos). Discos existentes não podem ser conectados, cada disco conectado está vazio. Quando o Nó de Computação é removido do Pool, o disco e todos os dados associados a ele também são excluídos. O disco não é formatado após ser acoplado, deve ser formatado antes do uso - para mais informações, veja https://v4.hkg1.meaqua.org/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux e https://v4.hkg1.meaqua.org/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

DiskEncryptionConfiguration

A configuração de criptografia de disco para o pool. Se especificado, a criptografia é executada em cada nó no pool durante o provisionamento de nós.

VMExtension[]

A extensão da máquina virtual para o pool. Se especificado, as extensões mencionadas nessa configuração serão instaladas em cada nó.

BatchVmImageReference

Uma referência à imagem do Marketplace de Máquinas Virtuais do Azure ou à imagem de máquina virtual personalizada a ser usada.

string

Isso só se aplica a Imagens que contenham o sistema operacional Windows, e só deve ser usado quando você possui licenças on-premises válidas para os Nós de Computação 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 Cliente Windows.

string

A SKU do agente do Nó de Computação em Lote a ser provisionada em Nós de Computação no Pool. O agente do Nó de Computação em Lote é um programa executado em cada Nó de Computação no Pool e fornece a interface de comando e controle entre o Nó de Computação e o serviço do Lote. Há diferentes implementações do agente do Nó de Computação, conhecido como SKUs, para sistemas operacionais diferentes. Você deve especificar um SKU do agente do Nó de Computação que corresponda à referência de imagem selecionada. Para obter a lista de SKUs de agente do Nó de Computação com suporte, juntamente com sua lista de referências de imagem verificadas, consulte a operação "Listar SKUs de agente de nó de computação com suporte".

BatchNodePlacementConfiguration

A configuração de posicionamento do nó para o pool. Essa configuração especificará regras sobre como os nós no pool serão alocados fisicamente.

BatchOsDisk

Configurações do disco do sistema operacional da Máquina Virtual.

SecurityProfile

Especifica as configurações de perfil de segurança para a máquina virtual ou o conjunto de dimensionamento de máquinas virtuais.

ServiceArtifactReference

Especifica a ID de referência do artefato de serviço usada para definir a mesma versão de imagem para todas as máquinas virtuais no conjunto de dimensionamento ao usar a versão de imagem 'mais recente'. 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}

WindowsConfiguration

Configurações do sistema operacional Windows na máquina virtual. Essa propriedade não deve ser especificada se a propriedade imageReference especificar uma Imagem do Linux OS.

boolean

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.

boolean

Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível.

string

O nome da extensão da máquina virtual.

object

A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida.

string[]

A coleção de nomes de extensão. Coleção de nomes de extensão após o qual essa extensão precisa ser provisionada.

string

O nome do editor do manipulador de extensão.

object

Configurações públicas formatadas em JSON para a extensão.

string

O tipo da extensão.

string

A versão do manipulador de script.

boolean

Se as atualizações automáticas estão habilitadas na máquina virtual. Se omitido, o valor padrão será true.

LoginMode

O modo de login para o usuário. O padrão é 'batch'.