Pool - Get
Obtém informações sobre o pool especificado.
GET {batchUrl}/pools/{poolId}?api-version=2024-07-01.20.0
GET {batchUrl}/pools/{poolId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2024-07-01.20.0
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
batch
|
path | True |
string |
A URL base para todas as solicitações de serviço do Lote do Azure. |
pool
|
path | True |
string |
A ID do Pool a ser obtido. |
api-version
|
query | True |
string |
Versão da API do cliente. |
$expand
|
query |
string |
Uma cláusula $expand OData. |
|
$select
|
query |
string |
Uma cláusula $select OData. |
|
timeout
|
query |
integer int32 |
O tempo máximo que o servidor pode gastar processando a solicitação, em segundos. O padrão é 30 segundos. Se o valor for maior que 30, o padrão será usado. |
Cabeçalho da solicitação
Media Types: "application/json; odata=minimalmetadata"
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
client-request-id |
string uuid |
A identidade da solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Se o servidor deve retornar a ID de solicitação do cliente na resposta. |
|
ocp-date |
string date-time-rfc1123 |
A hora em que a solicitação foi emitida. As bibliotecas de cliente normalmente definem isso como a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente. |
|
If-Match |
string |
Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço corresponder exatamente ao valor especificado pelo cliente. |
|
If-None-Match |
string |
Um valor ETag associado à versão do recurso conhecida pelo cliente. A operação será executada somente se a ETag atual do recurso no serviço não corresponder ao valor especificado pelo cliente. |
|
If-Modified-Since |
string date-time-rfc1123 |
Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço tiver sido modificado desde o horário especificado. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Um carimbo de data/hora que indica a hora da última modificação do recurso conhecido pelo cliente. A operação será executada somente se o recurso no serviço não tiver sido modificado desde o horário especificado. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Uma resposta que contém o Pool. Cabeçalhos
|
|
Other Status Codes |
O erro do serviço do Lote. |
Segurança
azure_auth
Fluxo de código de autenticação do Microsoft Entra OAuth 2.0
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | Representar sua conta de usuário |
Authorization
Tipo:
apiKey
Em:
header
Exemplos
Add a VirtualMachineConfiguration pool with OS disk
Solicitação de exemplo
GET account.region.batch.azure.com/pools/mypool001?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "mypool001",
"url": "http://localhost:20302/testaccount1tls/pools/mypool001",
"eTag": "0x8DBA3B4E91CD7B7",
"lastModified": "2023-08-23T08:42:40.3479479Z",
"creationTime": "2023-08-23T08:42:40.3479479Z",
"state": "active",
"stateTransitionTime": "2023-08-23T08:42:40.3479479Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2023-08-23T08:42:53.8587829Z",
"vmSize": "standard_d2s_v3",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 1,
"targetDedicatedNodes": 1,
"currentLowPriorityNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "20_04-lts",
"version": "latest"
},
"osDisk": {
"ephemeralOSDiskSettings": {
"placement": "CacheDisk"
},
"managedDisk": {
"storageAccountType": "standardssd_lrs"
},
"diskSizeGB": 100,
"caching": "readwrite"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04"
},
"currentNodeCommunicationMode": "classic"
}
Get a pool with AcceleratedNetworking
Solicitação de exemplo
GET account.region.batch.azure.com/pools/pool?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "pool",
"url": "https://account.region.batch.azure.com/pools/pool",
"eTag": "0x8DB4792BE8566A2",
"lastModified": "2023-04-28T02:46:19.0268066Z",
"creationTime": "2023-04-28T02:46:19.0268066Z",
"state": "active",
"stateTransitionTime": "2023-04-28T02:46:19.0268066Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2023-04-28T02:47:17.9169655Z",
"vmSize": "standard_d1_v2",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 2,
"targetDedicatedNodes": 2,
"currentLowPriorityNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64"
},
"networkConfiguration": {
"dynamicVNetAssignmentScope": "none",
"enableAcceleratedNetworking": true
},
"currentNodeCommunicationMode": "classic"
}
Get a VirtualMachineConfiguration pool with extensions
Solicitação de exemplo
GET account.region.batch.azure.com/pools/pool?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "pool",
"url": "https://account.region.batch.azure.com/pools/pool",
"eTag": "0x8D413091E739A56",
"lastModified": "2016-11-22T18:55:25.2608598Z",
"creationTime": "2016-11-22T18:55:24.2632496Z",
"state": "active",
"stateTransitionTime": "2016-11-22T18:55:24.2632496Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2016-11-22T18:55:24.8154041Z",
"vmSize": "standard_a1",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"targetDedicatedNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"startTask": {
"commandLine": "/bin/bash -c 'echo start task'",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "20_04-lts",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04",
"extensions": [
{
"name": "batchextension1",
"type": "KeyVaultForLinux",
"publisher": "Microsoft.Azure.KeyVault",
"typeHandlerVersion": "2.0",
"autoUpgradeMinorVersion": true,
"enableAutomaticUpgrade": true,
"settings": "{\"secretsManagementSettingsKey\":\"secretsManagementSettingsValue\",\"authenticationSettingsKey\":\"authenticationSettingsValue\"}"
}
]
},
"targetNodeCommunicationMode": "classic",
"currentNodeCommunicationMode": "classic"
}
Get a VirtualMachineConfiguration pool with SecurityProfile
Solicitação de exemplo
GET account.region.batch.azure.com/pools/mypool001?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "mypool001",
"url": "https://account.region.batch.azure.com/pools/pool",
"eTag": "0x8DB6CA2DFF530D1",
"lastModified": "2023-06-14T06:45:00.0946897Z",
"creationTime": "2023-06-14T06:45:00.0946897Z",
"state": "active",
"stateTransitionTime": "2023-06-14T06:45:00.0946897Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2023-06-14T06:45:59.4770341Z",
"vmSize": "standard_dc2s_v2",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 1,
"targetDedicatedNodes": 1,
"currentLowPriorityNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "UbuntuServer",
"sku": "18_04-lts-gen2",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.ubuntu 18.04",
"securityProfile": {
"securityType": "trustedLaunch",
"encryptionAtHost": true,
"uefiSettings": {
"secureBootEnabled": false
}
}
},
"currentNodeCommunicationMode": "classic"
}
Get a VirtualMachineConfiguration pool with ServiceArtifactReference
Solicitação de exemplo
GET account.region.batch.azure.com/pools/pool?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "pool",
"url": "https://account.region.batch.azure.com/pools/pool",
"eTag": "0x8DB51F652DFC78F",
"lastModified": "2023-05-11T08:04:19.7259151Z",
"creationTime": "2023-05-11T08:04:19.7259151Z",
"state": "active",
"stateTransitionTime": "2023-05-11T08:04:19.7259151Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2023-05-11T08:05:22.0020052Z",
"vmSize": "standard_a1_v2",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 2,
"targetDedicatedNodes": 2,
"currentLowPriorityNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64",
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"serviceArtifactReference": {
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Compute/galleries/myGallery/serviceArtifacts/myServiceArtifact/vmArtifactsProfiles/vmArtifactsProfile"
}
},
"currentNodeCommunicationMode": "classic",
"upgradePolicy": {
"mode": "automatic",
"automaticOSUpgradePolicy": {
"enableAutomaticOSUpgrade": true
}
}
}
Get a VirtualMachineConfiguration pool with UpgradePolicy
Solicitação de exemplo
GET account.region.batch.azure.com/pools/mypool001?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "mypool001",
"url": "https://account.region.batch.azure.com/pools/mypool001",
"eTag": "0x8DB51ED3C9B6CF4",
"lastModified": "2023-05-11T06:59:16.8975092Z",
"creationTime": "2023-05-11T06:59:16.8975092Z",
"state": "active",
"stateTransitionTime": "2023-05-11T06:59:16.8975092Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2023-05-11T07:00:34.9878574Z",
"vmSize": "standard_a1_v2",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 2,
"targetDedicatedNodes": 2,
"currentLowPriorityNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-datacenter-smalldisk",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.windows amd64",
"windowsConfiguration": {
"enableAutomaticUpdates": false
},
"nodePlacementConfiguration": {
"policy": "zonal"
}
},
"currentNodeCommunicationMode": "classic",
"upgradePolicy": {
"mode": "automatic",
"automaticOSUpgradePolicy": {
"disableAutomaticRollback": true,
"enableAutomaticOSUpgrade": true,
"useRollingUpgradePolicy": true,
"osRollingUpgradeDeferral": true
},
"rollingUpgradePolicy": {
"enableCrossZoneUpgrade": true,
"maxBatchInstancePercent": 20,
"maxUnhealthyInstancePercent": 20,
"maxUnhealthyUpgradedInstancePercent": 20,
"pauseTimeBetweenBatches": "PT0S",
"prioritizeUnhealthyInstances": false,
"rollbackFailedInstancesOnPolicyBreach": false
}
}
}
Pool get
Solicitação de exemplo
GET account.region.batch.azure.com/pools/pool?api-version=2024-07-01.20.0
Resposta de exemplo
{
"id": "pool",
"url": "https://account.region.batch.azure.com/pools/pool",
"eTag": "0x8D413091E739A56",
"lastModified": "2016-11-22T18:55:25.2608598Z",
"creationTime": "2016-11-22T18:55:24.2632496Z",
"state": "active",
"stateTransitionTime": "2016-11-22T18:55:24.2632496Z",
"allocationState": "steady",
"allocationStateTransitionTime": "2016-11-22T18:55:24.8154041Z",
"vmSize": "standard_a1",
"resizeTimeout": "PT15M",
"currentDedicatedNodes": 0,
"currentLowPriorityNodes": 0,
"targetDedicatedNodes": 0,
"targetLowPriorityNodes": 0,
"enableAutoScale": false,
"enableInterNodeCommunication": false,
"startTask": {
"commandLine": "/bin/bash -c 'echo start task'",
"userIdentity": {
"autoUser": {
"scope": "task",
"elevationLevel": "nonadmin"
}
},
"maxTaskRetryCount": 0,
"waitForSuccess": false
},
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "spread"
},
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "Canonical",
"offer": "0001-com-ubuntu-server-focal",
"sku": "20_04-lts",
"version": "latest"
},
"nodeAgentSKUId": "batch.node.ubuntu 20.04"
}
}
Definições
Nome | Description |
---|---|
Allocation |
Se o Pool está redimensionando. |
Application |
Uma referência a um pacote a ser implantado em Nós de Computação. |
Automatic |
Os parâmetros de configuração usados para executar a atualização automática do sistema operacional. |
Auto |
Os resultados e erros de uma execução de uma fórmula de dimensionamento automático do Pool. |
Auto |
Erro ao executar ou avaliar uma fórmula de dimensionamento automático do Pool. |
Auto |
O escopo do usuário automático |
Auto |
Especifica os parâmetros para o usuário automático que executa uma Tarefa no serviço do Lote. |
Azure |
Informações usadas para se conectar a um Contêiner de Armazenamento do Azure usando Blobfuse. |
Azure |
Informações usadas para se conectar a um compartilhamento de arquivos do Azure. |
Batch |
Uma resposta de erro recebida do serviço do Lote do Azure. |
Batch |
Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure. |
Batch |
A identidade do pool do Lote, se configurada. |
Caching |
O tipo de cache a ser habilitado para o disco. |
Certificate |
Uma referência a um certificado a ser instalado em nós de computação em um pool. |
Certificate |
O local do repositório de certificados no Nó de Computação no qual instalar o Certificado. |
Certificate |
Quais contas de usuário no Nó de Computação devem ter acesso aos dados privados do Certificado. |
CIFSMount |
Informações usadas para se conectar a um sistema de arquivos CIFS. |
Cloud |
Um pool no serviço do Lote do Azure. |
Compute |
Como as tarefas são distribuídas entre nós de computação em um pool. |
Compute |
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará. |
Container |
A configuração para pools habilitados para contêineres. |
Container |
A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas. |
Container |
Os caminhos que serão montados no contêiner da tarefa de contêiner. |
Container |
Um registro de contêiner privado. |
Container |
A tecnologia de contêiner a ser usada. |
Container |
O local do diretório de trabalho da Tarefa de contêiner. |
Data |
Configurações que serão usadas pelos discos de dados associados aos Nós de Computação no Pool. Ao usar discos de dados anexados, você precisa montar e formatar os discos de dentro de uma VM para usá-los. |
Diff |
Especifica o posicionamento de disco efêmero para o disco do sistema operacional para todos os nós de computação (VMs) no pool. |
Diff |
Especifica as Configurações de Disco efêmero para o disco do sistema operacional usado pela VM (nó de computação). |
Disk |
A configuração de criptografia de disco aplicada em nós de computação no pool. Não há suporte para a configuração de criptografia de disco no pool do Linux criado com a Imagem da Galeria de Computação do Azure. |
Disk |
A lista de destinos de disco do Serviço de Lote será criptografada no nó de computação. |
Dynamic |
O escopo da atribuição de vnet dinâmica. |
Elevation |
O nível de elevação do usuário. |
Environment |
Uma variável de ambiente a ser definida em um processo de tarefa. |
Error |
Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure. |
Image |
Uma referência a uma imagem do Marketplace de Máquinas Virtuais do Azure ou a uma Imagem da Galeria de Computação do Azure. Para obter a lista de todas as referências de imagem do Azure Marketplace verificadas pelo Lote do Azure, consulte a operação 'Listar Imagens Com Suporte'. |
Inbound |
O protocolo do ponto de extremidade. |
Inbound |
Um pool nat de entrada que pode ser usado para abordar portas específicas em nós de computação em um pool de lote externamente. |
IPAddress |
O tipo de provisionamento para endereços IP públicos para o pool. |
Linux |
Propriedades usadas para criar uma conta de usuário em um Nó de Computação do Linux. |
Login |
O modo de logon do usuário |
Managed |
|
Metadata |
Um par nome-valor associado a um recurso de serviço do Lote. |
Mount |
O sistema de arquivos a ser montado em cada nó. |
Name |
Representa um par nome-valor. |
Network |
A configuração de rede de um pool. |
Network |
Uma regra de grupo de segurança de rede a ser aplicada a um ponto de extremidade de entrada. |
Network |
A ação que deve ser tomada para um endereço IP especificado, intervalo de sub-rede ou marca. |
NFSMount |
Informações usadas para se conectar a um sistema de arquivos NFS. |
Node |
Determina como um pool se comunica com o serviço do Lote. |
Node |
Configuração de posicionamento do nó para um pool. |
Node |
A política de posicionamento para alocar nós no pool. |
OSDisk |
Configurações do disco do sistema operacional do nó de computação (VM). |
Pool |
A configuração do ponto de extremidade para um pool. |
Pool |
A identidade do pool do Lote, se configurada. |
Pool |
O estado atual do pool. |
Pool |
Contém estatísticas de utilização e uso de recursos para o tempo de vida de um pool. |
Public |
A configuração de endereço IP público da configuração de rede de um pool. |
Resize |
Erro ao redimensionar um pool. |
Resource |
Um único arquivo ou vários arquivos a serem baixados em um Nó de Computação. |
Resource |
Estatísticas relacionadas ao consumo de recursos por nós de computação em um pool. |
Rolling |
Os parâmetros de configuração usados durante a execução de uma atualização sem interrupção. |
Security |
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. |
Security |
Especifica as configurações de perfil de segurança para a máquina virtual ou o conjunto de dimensionamento de máquinas virtuais. |
Security |
Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. |
Service |
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'. |
Start |
Uma tarefa que é executada quando um nó ingressa em um pool no serviço do Lote do Azure ou quando o Nó de Computação é reinicializado ou reimageado. |
Storage |
O tipo de conta de armazenamento para uso na criação de discos de dados ou disco do sistema operacional. |
Task |
As configurações de contêiner de uma Tarefa. |
Task |
Especifica como as tarefas devem ser distribuídas entre nós de computação. |
Uefi |
Especifica as configurações de segurança, como inicialização segura e vTPM usadas durante a criação da máquina virtual. |
Upgrade |
Especifica o modo de uma atualização para máquinas virtuais no conjunto de dimensionamento. |
Upgrade |
Descreve uma política de atualização – automática, manual ou sem interrupção. |
Usage |
Estatísticas relacionadas às informações de uso do Pool. |
User |
Propriedades usadas para criar um usuário usado para executar Tarefas em um Nó de Computação em Lote do Azure. |
User |
A identidade atribuída pelo usuário |
User |
A definição da identidade do usuário na qual a Tarefa é executada. |
Virtual |
A configuração para nós de computação em um pool com base na infraestrutura de Máquinas Virtuais do Azure. |
VMDisk |
Especifica as configurações de perfil de segurança para o disco gerenciado. Observação: ele só pode ser definido para VMs confidenciais e necessário ao usar VMs confidenciais. |
VMExtension |
A configuração para extensões de máquina virtual. |
Windows |
Configurações do sistema operacional Windows a serem aplicadas à máquina virtual. |
Windows |
Propriedades usadas para criar uma conta de usuário em um Nó de Computação do Windows. |
AllocationState
Se o Pool está redimensionando.
Nome | Tipo | Description |
---|---|---|
resizing |
string |
O pool está redimensionando; ou seja, nós de computação estão sendo adicionados ou removidos do pool. |
steady |
string |
O Pool não está redimensionando. Não há alterações no número de nós de computação no pool em andamento. Um pool entra nesse estado quando ele é criado e quando nenhuma operação está sendo executada no Pool para alterar o número de Nós de Computação. |
stopping |
string |
O Pool estava redimensionando, mas o usuário solicitou que o redimensionamento fosse interrompido, mas a solicitação de parada ainda não foi concluída. |
ApplicationPackageReference
Uma referência a um pacote a ser implantado em Nós de Computação.
Nome | Tipo | Description |
---|---|---|
applicationId |
string |
A ID do aplicativo a ser implantado. |
version |
string |
A versão do aplicativo a ser implantado. Se omitida, a versão padrão será implantada. |
AutomaticOSUpgradePolicy
Os parâmetros de configuração usados para executar a atualização automática do sistema operacional.
Nome | Tipo | Description |
---|---|---|
disableAutomaticRollback |
boolean |
Se o recurso de reversão de imagem do sistema operacional deve ser desabilitado. |
enableAutomaticOSUpgrade |
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. |
osRollingUpgradeDeferral |
boolean |
Adie as atualizações do sistema operacional nos TVMs se elas estiverem executando tarefas. |
useRollingUpgradePolicy |
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. |
AutoScaleRun
Os resultados e erros de uma execução de uma fórmula de dimensionamento automático do Pool.
Nome | Tipo | Description |
---|---|---|
error |
Detalhes do erro encontrado avaliando a fórmula de dimensionamento automático no Pool, se a avaliação não tiver sido bem-sucedida. |
|
results |
string |
Os valores finais de todas as variáveis usadas na avaliação da fórmula de dimensionamento automático. |
timestamp |
string |
A hora em que a fórmula de dimensionamento automático foi avaliada pela última vez. |
AutoScaleRunError
Erro ao executar ou avaliar uma fórmula de dimensionamento automático do Pool.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro de dimensionamento automático. Os códigos são invariáveis e devem ser consumidos programaticamente. |
message |
string |
Uma mensagem que descreve o erro de dimensionamento automático, destinada a ser adequada para exibição em uma interface do usuário. |
values |
Uma lista de detalhes de erro adicionais relacionados ao erro de dimensionamento automático. |
AutoUserScope
O escopo do usuário automático
Nome | Tipo | Description |
---|---|---|
pool |
string |
Especifica que a Tarefa é executada como a conta de usuário automático comum que é criada em cada nó de computação em um pool. |
task |
string |
Especifica que o serviço deve criar um novo usuário para a Tarefa. |
AutoUserSpecification
Especifica os parâmetros para o usuário automático que executa uma Tarefa no serviço do Lote.
Nome | Tipo | Description |
---|---|---|
elevationLevel |
O nível de elevação do usuário automático. |
|
scope |
O escopo do usuário automático |
AzureBlobFileSystemConfiguration
Informações usadas para se conectar a um Contêiner de Armazenamento do Azure usando Blobfuse.
Nome | Tipo | Description |
---|---|---|
accountKey |
string |
A chave da Conta de Armazenamento do Azure. |
accountName |
string |
O nome da Conta de Armazenamento do Azure. |
blobfuseOptions |
string |
Opções de linha de comando adicionais para passar para o comando de montagem. |
containerName |
string |
O nome do Contêiner de Armazenamento de Blobs do Azure. |
identityReference |
A referência à identidade atribuída pelo usuário a ser usada para acessar containerName |
|
relativeMountPath |
string |
O caminho relativo no nó de computação em que o sistema de arquivos será montado |
sasKey |
string |
O token SAS do Armazenamento do Azure. |
AzureFileShareConfiguration
Informações usadas para se conectar a um compartilhamento de arquivos do Azure.
Nome | Tipo | Description |
---|---|---|
accountKey |
string |
A chave da conta de Armazenamento do Azure. |
accountName |
string |
O nome da conta de Armazenamento do Azure. |
azureFileUrl |
string |
A URL de Arquivos do Azure. |
mountOptions |
string |
Opções de linha de comando adicionais para passar para o comando de montagem. |
relativeMountPath |
string |
O caminho relativo no nó de computação em que o sistema de arquivos será montado |
BatchError
Uma resposta de erro recebida do serviço do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente. |
message |
Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário. |
|
values |
Uma coleção de pares chave-valor contendo detalhes adicionais sobre o erro. |
BatchErrorDetail
Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
key |
string |
Um identificador que especifica o significado da propriedade Value. |
value |
string |
As informações adicionais incluídas na resposta de erro. |
BatchPoolIdentity
A identidade do pool do Lote, se configurada.
Nome | Tipo | Description |
---|---|---|
type |
A identidade do pool do Lote, se configurada. |
|
userAssignedIdentities |
A lista de identidades de usuário associadas à conta do Lote. |
CachingType
O tipo de cache a ser habilitado para o disco.
Nome | Tipo | Description |
---|---|---|
none |
string |
O modo de cache do disco não está habilitado. |
readonly |
string |
O modo de cache do disco é somente leitura. |
readwrite |
string |
O modo de cache do disco é leitura e gravação. |
CertificateReference
Uma referência a um certificado a ser instalado em nós de computação em um pool.
Nome | Tipo | Description |
---|---|---|
storeLocation |
O local do repositório de certificados no Nó de Computação no qual instalar o Certificado. |
|
storeName |
string |
O nome do repositório de certificados no Nó de Computação no qual instalar o Certificado. |
thumbprint |
string |
A impressão digital do Certificado. |
thumbprintAlgorithm |
string |
O algoritmo com o qual a impressão digital está associada. Isso deve ser sha1. |
visibility |
Quais contas de usuário no Nó de Computação devem ter acesso aos dados privados do Certificado. |
CertificateStoreLocation
O local do repositório de certificados no Nó de Computação no qual instalar o Certificado.
Nome | Tipo | Description |
---|---|---|
currentuser |
string |
Os certificados devem ser instalados no repositório de certificados currentUser. |
localmachine |
string |
Os certificados devem ser instalados no repositório de certificados LocalMachine. |
CertificateVisibility
Quais contas de usuário no Nó de Computação devem ter acesso aos dados privados do Certificado.
Nome | Tipo | Description |
---|---|---|
remoteuser |
string |
O Certificado deve estar visível para as contas de usuário nas quais os usuários acessam remotamente o Nó de Computação. |
starttask |
string |
O Certificado deve estar visível para a conta de usuário na qual o StartTask é executado. Observe que, se o Escopo do AutoUser for Pool para o StartTask e uma Tarefa, esse certificado também ficará visível para a Tarefa. |
task |
string |
O Certificado deve estar visível para as contas de usuário nas quais as Tarefas de Trabalho são executadas. |
CIFSMountConfiguration
Informações usadas para se conectar a um sistema de arquivos CIFS.
Nome | Tipo | Description |
---|---|---|
mountOptions |
string |
Opções de linha de comando adicionais para passar para o comando de montagem. |
password |
string |
A senha a ser usada para autenticação no sistema de arquivos CIFS. |
relativeMountPath |
string |
O caminho relativo no nó de computação em que o sistema de arquivos será montado |
source |
string |
O URI do sistema de arquivos a ser montado. |
username |
string |
O usuário a ser usado para autenticação no sistema de arquivos CIFS. |
CloudPool
Um pool no serviço do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
allocationState |
Se o Pool está redimensionando. |
|
allocationStateTransitionTime |
string |
O momento em que o Pool inseriu seu estado de alocação atual. |
applicationPackageReferences |
A lista de pacotes a serem instalados em cada Nó de Computação no Pool. |
|
autoScaleEvaluationInterval |
string |
O intervalo de tempo no qual ajustar automaticamente o tamanho do Pool de acordo com a fórmula de dimensionamento automático. |
autoScaleFormula |
string |
Uma fórmula para o número desejado de Nós de Computação no Pool. |
autoScaleRun |
Os resultados e os erros da última execução da fórmula de dimensionamento automático. |
|
certificateReferences |
A lista de certificados a serem instalados em cada Nó de Computação no Pool. Aviso: essa propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o de Extensão do Azure KeyVault |
|
creationTime |
string |
A hora de criação do pool. |
currentDedicatedNodes |
integer |
O número de nós de computação dedicados atualmente no pool. |
currentLowPriorityNodes |
integer |
O número de nós de computação spot/de baixa prioridade atualmente no pool. |
currentNodeCommunicationMode |
O estado atual do modo de comunicação do pool. |
|
displayName |
string |
O nome de exibição do Pool. |
eTag |
string |
A ETag do Pool. |
enableAutoScale |
boolean |
Se o tamanho do Pool deve ser ajustado automaticamente ao longo do tempo. |
enableInterNodeCommunication |
boolean |
Se o Pool permite comunicação direta entre nós de computação. |
id |
string |
Uma cadeia de caracteres que identifica exclusivamente o pool na Conta. |
identity |
A identidade do pool do Lote, se configurada. |
|
lastModified |
string |
A hora da última modificação do pool. |
metadata |
Uma lista de pares nome-valor associados ao Pool como metadados. |
|
mountConfiguration |
Uma lista de sistemas de arquivos a serem montados em cada nó no pool. |
|
networkConfiguration |
A configuração de rede do Pool. |
|
resizeErrors |
Uma lista de erros encontrados ao executar o último redimensionamento no Pool. |
|
resizeTimeout |
string |
O tempo limite para alocação de nós de computação para o pool. |
resourceTags |
object |
As marcas especificadas pelo usuário associadas ao pool. |
startTask |
Uma tarefa especificada para ser executada em cada Nó de Computação à medida que ele ingressa no pool. |
|
state |
O estado atual do pool. |
|
stateTransitionTime |
string |
A hora em que o Pool entrou em seu estado atual. |
stats |
Estatísticas de utilização e uso de recursos durante todo o tempo de vida do pool. |
|
targetDedicatedNodes |
integer |
O número desejado de nós de computação dedicados no pool. |
targetLowPriorityNodes |
integer |
O número desejado de nós de computação spot/de baixa prioridade no pool. |
targetNodeCommunicationMode |
O modo de comunicação de nó desejado para o pool. |
|
taskSchedulingPolicy |
Como as tarefas são distribuídas entre nós de computação em um pool. |
|
taskSlotsPerNode |
integer |
O número de slots de tarefa que podem ser usados para executar tarefas simultâneas em um único nó de computação no pool. |
upgradePolicy |
A política de atualização do Pool. |
|
url |
string |
A URL do pool. |
userAccounts |
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. |
|
vmSize |
string |
O tamanho das máquinas virtuais no Pool. Todas as máquinas virtuais em um Pool têm o mesmo tamanho. |
ComputeNodeFillType
Como as tarefas são distribuídas entre nós de computação em um pool.
Nome | Tipo | Description |
---|---|---|
pack |
string |
O maior número possível de tarefas (taskSlotsPerNode) deve ser atribuído a cada nó de computação no pool antes que as tarefas sejam atribuídas ao próximo Nó de Computação no Pool. |
spread |
string |
As tarefas devem ser atribuídas uniformemente em todos os Nós de Computação no Pool. |
ComputeNodeIdentityReference
A referência a uma identidade atribuída pelo usuário associada ao pool do Lote que um nó de computação usará.
Nome | Tipo | Description |
---|---|---|
resourceId |
string |
A ID de recurso do ARM da identidade atribuída pelo usuário. |
ContainerConfiguration
A configuração para pools habilitados para contêineres.
Nome | Tipo | Description |
---|---|---|
containerImageNames |
string[] |
A coleção de nomes de imagem de contêiner. |
containerRegistries |
Registros privados adicionais dos quais os contêineres podem ser extraídos. |
|
type |
A tecnologia de contêiner a ser usada. |
ContainerHostBatchBindMountEntry
A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas.
Nome | Tipo | Description |
---|---|---|
isReadOnly |
boolean |
Monte esse caminho de origem como modo somente leitura ou não. O valor padrão é falso (modo de leitura/gravação). |
source |
O caminho que será montado no cliente do contêiner pode ser selecionado. |
ContainerHostDataPath
Os caminhos que serão montados no contêiner da tarefa de contêiner.
Nome | Tipo | Description |
---|---|---|
Applications |
string |
O caminho dos aplicativos. |
JobPrep |
string |
O caminho da tarefa de preparação do trabalho. |
Shared |
string |
O caminho para a tarefa de várias instâncias compartilhar seus arquivos. |
Startup |
string |
O caminho para iniciar a tarefa. |
Task |
string |
O caminho da tarefa. |
VfsMounts |
string |
O caminho contém todos os sistemas de arquivos virtuais montados neste nó. |
ContainerRegistry
Um registro de contêiner privado.
Nome | Tipo | Description |
---|---|---|
identityReference |
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. |
|
password |
string |
A senha para fazer logon no servidor do Registro. |
registryServer |
string |
A URL do Registro. |
username |
string |
O nome de usuário a ser conectado ao servidor do Registro. |
ContainerType
A tecnologia de contêiner a ser usada.
Nome | Tipo | Description |
---|---|---|
criCompatible |
string |
Uma tecnologia baseada em CRI será usada para iniciar os contêineres. |
dockerCompatible |
string |
Uma tecnologia de contêiner compatível com o Docker será usada para iniciar os contêineres. |
ContainerWorkingDirectory
O local do diretório de trabalho da Tarefa de contêiner.
Nome | Tipo | Description |
---|---|---|
containerImageDefault |
string |
Use o diretório de trabalho definido na imagem do contêiner. Cuidado para que esse diretório não contenha os Arquivos de Recursos baixados pelo Lote. |
taskWorkingDirectory |
string |
Use o diretório de trabalho da Tarefa de Serviço do Lote padrão, que conterá os Arquivos de Recurso de Tarefa preenchidos pelo Lote. |
DataDisk
Configurações que serão usadas pelos discos de dados associados aos Nós de Computação no Pool. Ao usar discos de dados anexados, você precisa montar e formatar os discos de dentro de uma VM para usá-los.
Nome | Tipo | Description |
---|---|---|
caching |
O tipo de cache a ser habilitado para os discos de dados. |
|
diskSizeGB |
integer |
O tamanho inicial do disco em gigabytes. |
lun |
integer |
O número da unidade lógica. |
storageAccountType |
O tipo de conta de armazenamento a ser usado para o disco de dados. |
DiffDiskPlacement
Especifica o posicionamento de disco efêmero para o disco do sistema operacional para todos os nós de computação (VMs) no pool.
Nome | Tipo | Description |
---|---|---|
CacheDisk |
string |
O Disco do SO Efêmero é armazenado no cache da VM. |
DiffDiskSettings
Especifica as Configurações de Disco efêmero para o disco do sistema operacional usado pela VM (nó de computação).
Nome | Tipo | Description |
---|---|---|
placement |
Especifica o posicionamento de disco efêmero para o disco do sistema operacional para todas as VMs no pool. |
DiskEncryptionConfiguration
A configuração de criptografia de disco aplicada em nós de computação no pool. Não há suporte para a configuração de criptografia de disco no pool do Linux criado com a Imagem da Galeria de Computação do Azure.
Nome | Tipo | Description |
---|---|---|
targets |
A lista de destinos de disco do Serviço de Lote será criptografada no nó de computação. |
DiskEncryptionTarget
A lista de destinos de disco do Serviço de Lote será criptografada no nó de computação.
Nome | Tipo | Description |
---|---|---|
osdisk |
string |
O disco do sistema operacional no nó de computação é criptografado. |
temporarydisk |
string |
O disco temporário no nó de computação é criptografado. No Linux, essa criptografia se aplica a outras partições (como aquelas em discos de dados montados) quando a criptografia ocorre no momento da inicialização. |
DynamicVNetAssignmentScope
O escopo da atribuição de vnet dinâmica.
Nome | Tipo | Description |
---|---|---|
job |
string |
A atribuição de VNet dinâmica é feita por trabalho. |
none |
string |
Nenhuma atribuição de VNet dinâmica está habilitada. |
ElevationLevel
O nível de elevação do usuário.
Nome | Tipo | Description |
---|---|---|
admin |
string |
O usuário é um usuário com acesso elevado e opera com permissões de Administrador completas. |
nonadmin |
string |
O usuário é um usuário padrão sem acesso elevado. |
EnvironmentSetting
Uma variável de ambiente a ser definida em um processo de tarefa.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome da variável de ambiente. |
value |
string |
O valor da variável de ambiente. |
ErrorMessage
Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
Nome | Tipo | Description |
---|---|---|
lang |
string |
O código de idioma da mensagem de erro |
value |
string |
O texto da mensagem. |
ImageReference
Uma referência a uma imagem do Marketplace de Máquinas Virtuais do Azure ou a uma Imagem da Galeria de Computação do Azure. Para obter a lista de todas as referências de imagem do Azure Marketplace verificadas pelo Lote do Azure, consulte a operação 'Listar Imagens Com Suporte'.
Nome | Tipo | Description |
---|---|---|
communityGalleryImageId |
string |
O identificador exclusivo da imagem da galeria da comunidade |
exactVersion |
string |
A versão específica da imagem da plataforma ou da imagem do marketplace usada para criar o nó. Esse campo somente leitura será diferente de "version" somente se o valor especificado para 'version' quando o pool foi criado for 'latest'. |
offer |
string |
O tipo de oferta da Imagem do Marketplace de Máquinas Virtuais do Azure. |
publisher |
string |
O editor da Imagem do Marketplace de Máquinas Virtuais do Azure. |
sharedGalleryImageId |
string |
O identificador exclusivo da imagem da galeria compartilhada |
sku |
string |
A SKU da imagem do Marketplace de Máquinas Virtuais do Azure. |
version |
string |
A versão da Imagem do Marketplace de Máquinas Virtuais do Azure. |
virtualMachineImageId |
string |
O identificador de recurso do ARM da Imagem da Galeria de Computação do Azure. Nós de computação no pool serão criados usando essa ID de imagem. Isso é do formulário /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. |
InboundEndpointProtocol
O protocolo do ponto de extremidade.
Nome | Tipo | Description |
---|---|---|
tcp |
string |
Use TCP para o ponto de extremidade. |
udp |
string |
Use UDP para o ponto de extremidade. |
InboundNATPool
Um pool nat de entrada que pode ser usado para abordar portas específicas em nós de computação em um pool de lote externamente.
Nome | Tipo | Description |
---|---|---|
backendPort |
integer |
O número da porta no Nó de Computação. |
frontendPortRangeEnd |
integer |
O último número de porta no intervalo de portas externas que serão usadas para fornecer acesso de entrada ao back-endPort em nós de computação individuais. |
frontendPortRangeStart |
integer |
O primeiro número de porta no intervalo de portas externas que serão usadas para fornecer acesso de entrada ao backendPort em nós de computação individuais. |
name |
string |
O nome do ponto de extremidade. |
networkSecurityGroupRules |
Uma lista de regras de grupo de segurança de rede que serão aplicadas ao ponto de extremidade. |
|
protocol |
O protocolo do ponto de extremidade. |
IPAddressProvisioningType
O tipo de provisionamento para endereços IP públicos para o pool.
Nome | Tipo | Description |
---|---|---|
batchmanaged |
string |
Um IP público será criado e gerenciado pelo Lote. Pode haver vários IPs públicos dependendo do tamanho do pool. |
nopublicipaddresses |
string |
Nenhum endereço IP público será criado. |
usermanaged |
string |
Os IPs públicos são fornecidos pelo usuário e serão usados para provisionar os Nós de Computação. |
LinuxUserConfiguration
Propriedades usadas para criar uma conta de usuário em um Nó de Computação do Linux.
Nome | Tipo | Description |
---|---|---|
gid |
integer |
A ID do grupo para a conta de usuário. |
sshPrivateKey |
string |
A chave privada SSH para a conta de usuário. |
uid |
integer |
A ID de usuário da conta de usuário. |
LoginMode
O modo de logon do usuário
Nome | Tipo | Description |
---|---|---|
batch |
string |
O LOGON32_LOGON_BATCH modo de logon do Win32. O modo de logon em lote é recomendado para processos paralelos de execução prolongada. |
interactive |
string |
O LOGON32_LOGON_INTERACTIVE modo de logon do Win32. O UAC está habilitado em Pools do Windows. Se essa opção for usada com uma identidade de usuário elevada em um Pool do Windows, a sessão do usuário não será elevada, a menos que o aplicativo executado pela linha de comando tarefa esteja configurado para sempre exigir privilégio administrativo ou sempre exigir privilégio máximo. |
ManagedDisk
Nome | Tipo | Description |
---|---|---|
securityProfile |
Especifica as configurações de perfil de segurança para o disco gerenciado. |
|
storageAccountType |
O tipo de conta de armazenamento do disco gerenciado. |
MetadataItem
Um par nome-valor associado a um recurso de serviço do Lote.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome do item de metadados. |
value |
string |
O valor do item de metadados. |
MountConfiguration
O sistema de arquivos a ser montado em cada nó.
Nome | Tipo | Description |
---|---|---|
azureBlobFileSystemConfiguration |
O Contêiner de Armazenamento do Azure a ser montado usando o FUSE de blob em cada nó. |
|
azureFileShareConfiguration |
O Compartilhamento de Arquivos do Azure a ser montado em cada nó. |
|
cifsMountConfiguration |
O sistema de arquivos CIFS/SMB a ser montado em cada nó. |
|
nfsMountConfiguration |
O sistema de arquivos NFS a ser montado em cada nó. |
NameValuePair
Representa um par nome-valor.
Nome | Tipo | Description |
---|---|---|
name |
string |
O nome no par nome-valor. |
value |
string |
O valor no par nome-valor. |
NetworkConfiguration
A configuração de rede de um pool.
Nome | Tipo | Description |
---|---|---|
dynamicVNetAssignmentScope |
O escopo da atribuição de vnet dinâmica. |
|
enableAcceleratedNetworking |
boolean |
Se esse pool deve habilitar a rede acelerada. |
endpointConfiguration |
A configuração para pontos de extremidade em Nós de Computação no Pool de Lotes. |
|
publicIPAddressConfiguration |
A configuração de IPAddress público para nós de computação no Pool de Lotes. |
|
subnetId |
string |
O identificador de recurso arm da sub-rede de rede virtual à qual os Nós de Computação do Pool ingressarão. Isso é do formulário /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. |
NetworkSecurityGroupRule
Uma regra de grupo de segurança de rede a ser aplicada a um ponto de extremidade de entrada.
Nome | Tipo | Description |
---|---|---|
access |
A ação que deve ser tomada para um endereço IP especificado, intervalo de sub-rede ou marca. |
|
priority |
integer |
A prioridade dessa regra. |
sourceAddressPrefix |
string |
O prefixo ou marca de endereço de origem a ser correspondente à regra. |
sourcePortRanges |
string[] |
Os intervalos de porta de origem a serem correspondentes à regra. |
NetworkSecurityGroupRuleAccess
A ação que deve ser tomada para um endereço IP especificado, intervalo de sub-rede ou marca.
Nome | Tipo | Description |
---|---|---|
allow |
string |
Permitir acesso. |
deny |
string |
Negar acesso. |
NFSMountConfiguration
Informações usadas para se conectar a um sistema de arquivos NFS.
Nome | Tipo | Description |
---|---|---|
mountOptions |
string |
Opções de linha de comando adicionais para passar para o comando de montagem. |
relativeMountPath |
string |
O caminho relativo no nó de computação em que o sistema de arquivos será montado |
source |
string |
O URI do sistema de arquivos a ser montado. |
NodeCommunicationMode
Determina como um pool se comunica com o serviço do Lote.
Nome | Tipo | Description |
---|---|---|
classic |
string |
Os nós que usam o modo de comunicação clássico exigem comunicação TCP de entrada nas portas 29876 e 29877 do "BatchNodeManagement. {region}" marca de serviço e comunicação TCP de saída na porta 443 para "Storage.region" e "BatchNodeManagement. Marcas de serviço {region}". |
default |
string |
O modo de comunicação do nó é definido automaticamente pelo serviço do Lote. |
simplified |
string |
Os nós que usam o modo de comunicação simplificado exigem comunicação TCP de saída na porta 443 para o "BatchNodeManagement. {region}" marca de serviço. Não são necessárias portas de entrada abertas. |
NodePlacementConfiguration
Configuração de posicionamento do nó para um pool.
Nome | Tipo | Description |
---|---|---|
policy |
Tipo de política de posicionamento de nó em pools de lote. |
NodePlacementPolicyType
A política de posicionamento para alocar nós no pool.
Nome | Tipo | Description |
---|---|---|
regional |
string |
Todos os nós no pool serão alocados na mesma região. |
zonal |
string |
Nós no pool serão distribuídos entre diferentes zonas de disponibilidade com melhor balanceamento de esforço. |
OSDisk
Configurações do disco do sistema operacional do nó de computação (VM).
Nome | Tipo | Description |
---|---|---|
caching |
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. |
|
diskSizeGB |
integer |
O tamanho inicial do disco em GB ao criar um novo disco do sistema operacional. |
ephemeralOSDiskSettings |
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. |
|
writeAcceleratorEnabled |
boolean |
Especifica se writeAccelerator deve ser habilitado ou desabilitado no disco. |
PoolEndpointConfiguration
A configuração do ponto de extremidade para um pool.
Nome | Tipo | Description |
---|---|---|
inboundNATPools |
Uma lista de pools NAT de entrada que podem ser usados para abordar portas específicas em um nó de computação individual externamente. |
PoolIdentityType
A identidade do pool do Lote, se configurada.
Nome | Tipo | Description |
---|---|---|
None |
string |
O pool de lotes não tem nenhuma identidade associada a ele. A configuração |
UserAssigned |
string |
O pool de lotes tem identidades atribuídas pelo usuário com ele. |
PoolState
O estado atual do pool.
Nome | Tipo | Description |
---|---|---|
active |
string |
O Pool está disponível para executar Tarefas sujeitas à disponibilidade de Nós de Computação. |
deleting |
string |
O usuário solicitou que o Pool fosse excluído, mas a operação de exclusão ainda não foi concluída. |
PoolStatistics
Contém estatísticas de utilização e uso de recursos para o tempo de vida de um pool.
Nome | Tipo | Description |
---|---|---|
lastUpdateTime |
string |
A hora em que as estatísticas foram atualizadas pela última vez. Todas as estatísticas são limitadas ao intervalo entre startTime e lastUpdateTime. |
resourceStats |
Estatísticas relacionadas ao consumo de recursos por Nós de Computação no Pool. |
|
startTime |
string |
A hora de início do intervalo de tempo coberto pelas estatísticas. |
url |
string |
A URL das estatísticas. |
usageStats |
Estatísticas relacionadas ao uso do Pool, como a quantidade de tempo principal usado. |
PublicIPAddressConfiguration
A configuração de endereço IP público da configuração de rede de um pool.
Nome | Tipo | Description |
---|---|---|
ipAddressIds |
string[] |
A lista de IPs públicos que o serviço do Lote usará ao provisionar nós de computação. |
provision |
O tipo de provisionamento para endereços IP públicos para o pool. |
ResizeError
Erro ao redimensionar um pool.
Nome | Tipo | Description |
---|---|---|
code |
string |
Um identificador para o erro de redimensionamento do Pool. Os códigos são invariáveis e devem ser consumidos programaticamente. |
message |
string |
Uma mensagem que descreve o erro de redimensionamento do Pool, destinada a ser adequada para exibição em uma interface do usuário. |
values |
Uma lista de detalhes de erro adicionais relacionados ao erro de redimensionamento do Pool. |
ResourceFile
Um único arquivo ou vários arquivos a serem baixados em um Nó de Computação.
Nome | Tipo | Description |
---|---|---|
autoStorageContainerName |
string |
O nome do contêiner de armazenamento na Conta de armazenamento automático. |
blobPrefix |
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. |
fileMode |
string |
O atributo de modo de permissão de arquivo no formato octal. |
filePath |
string |
O local no Nó de Computação para o qual baixar os arquivos em relação ao diretório de trabalho da Tarefa. |
httpUrl |
string |
A URL do arquivo a ser baixado. |
identityReference |
A referência à identidade atribuída pelo usuário a ser usada para acessar o Armazenamento de Blobs do Azure especificado por storageContainerUrl ou httpUrl |
|
storageContainerUrl |
string |
A URL do contêiner de blob no Armazenamento de Blobs do Azure. |
ResourceStatistics
Estatísticas relacionadas ao consumo de recursos por nós de computação em um pool.
Nome | Tipo | Description |
---|---|---|
avgCPUPercentage |
number |
O uso médio da CPU em todos os Nós de Computação no Pool (percentual por nó). |
avgDiskGiB |
number |
A média de espaço em disco usado no GiB em todos os Nós de Computação no Pool. |
avgMemoryGiB |
number |
O uso médio de memória no GiB em todos os Nós de Computação no Pool. |
diskReadGiB |
number |
A quantidade total de dados no GiB de leituras de disco em todos os nós de computação no pool. |
diskReadIOps |
integer |
O número total de operações de leitura de disco em todos os Nós de Computação no Pool. |
diskWriteGiB |
number |
A quantidade total de dados no GiB de gravações de disco em todos os Nós de Computação no Pool. |
diskWriteIOps |
integer |
O número total de operações de gravação de disco em todos os Nós de Computação no Pool. |
lastUpdateTime |
string |
A hora em que as estatísticas foram atualizadas pela última vez. Todas as estatísticas são limitadas ao intervalo entre startTime e lastUpdateTime. |
networkReadGiB |
number |
A quantidade total de dados no GiB de leituras de rede em todos os nós de computação no pool. |
networkWriteGiB |
number |
A quantidade total de dados no GiB de gravações de rede em todos os Nós de Computação no Pool. |
peakDiskGiB |
number |
O pico de espaço em disco usado no GiB em todos os Nós de Computação no Pool. |
peakMemoryGiB |
number |
O pico de uso de memória no GiB em todos os Nós de Computação no Pool. |
startTime |
string |
A hora de início do intervalo de tempo coberto pelas estatísticas. |
RollingUpgradePolicy
Os parâmetros de configuração usados durante a execução de uma atualização sem interrupção.
Nome | Tipo | Description |
---|---|---|
enableCrossZoneUpgrade |
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. |
maxBatchInstancePercent |
integer |
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. |
maxUnhealthyInstancePercent |
integer |
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. |
maxUnhealthyUpgradedInstancePercent |
integer |
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. |
pauseTimeBetweenBatches |
string |
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. |
prioritizeUnhealthyInstances |
boolean |
Atualize todas as instâncias não íntegras em um conjunto de dimensionamento antes de qualquer instância íntegra. |
rollbackFailedInstancesOnPolicyBreach |
boolean |
Reverter instâncias com falha para o modelo anterior se a política de Atualização Sem Interrupção for violada. |
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.
Nome | Tipo | Description |
---|---|---|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
SecurityProfile
Especifica as configurações de perfil de segurança para a máquina virtual ou o conjunto de dimensionamento de máquinas virtuais.
Nome | Tipo | Description |
---|---|---|
encryptionAtHost |
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://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes. |
securityType |
Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. |
|
uefiSettings |
Especifica as configurações de segurança, como inicialização segura e vTPM usadas durante a criação da máquina virtual. |
SecurityTypes
Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings.
Nome | Tipo | Description |
---|---|---|
confidentialVM |
string |
A computação confidencial do Azure oferece VMs confidenciais para locatários com requisitos de alta segurança e confidencialidade. Essas VMs fornecem um limite forte e imposto por hardware para ajudar a atender às suas necessidades de segurança. Você pode usar VMs confidenciais para migrações sem fazer alterações no código, com a plataforma protegendo o estado da VM de ser lida ou modificada. |
trustedLaunch |
string |
O inicialização confiável protege contra técnicas de ataque avançadas e persistentes. |
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'.
Nome | Tipo | Description |
---|---|---|
id |
string |
A ID de referência do artefato de serviço de ServiceArtifactReference |
StartTask
Uma tarefa que é executada quando um nó ingressa em um pool no serviço do Lote do Azure ou quando o Nó de Computação é reinicializado ou reimageado.
Nome | Tipo | Description |
---|---|---|
commandLine |
string |
A linha de comando do StartTask. |
containerSettings |
As configurações do contêiner no qual o StartTask é executado. |
|
environmentSettings |
Uma lista de configurações de variável de ambiente para o StartTask. |
|
maxTaskRetryCount |
integer |
O número máximo de vezes que a Tarefa pode ser repetida. |
resourceFiles |
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. |
|
userIdentity |
A identidade do usuário na qual o StartTask é executado. |
|
waitForSuccess |
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. |
StorageAccountType
O tipo de conta de armazenamento para uso na criação de discos de dados ou disco do sistema operacional.
Nome | Tipo | Description |
---|---|---|
premium_lrs |
string |
O disco de dados/disco do sistema operacional deve usar o armazenamento premium com redundância local. |
standard_lrs |
string |
O disco de dados/disco do sistema operacional deve usar o armazenamento padrão com redundância local. |
standardssd_lrs |
string |
O disco de dados/disco do sistema operacional deve usar o armazenamento com redundância local do SSD padrão. |
TaskContainerSettings
As configurações de contêiner de uma Tarefa.
Nome | Tipo | Description |
---|---|---|
containerHostBatchBindMounts |
Os caminhos que você deseja montar na tarefa de contêiner. |
|
containerRunOptions |
string |
Opções adicionais para o comando de criação de contêiner. |
imageName |
string |
A imagem a ser usada para criar o contêiner no qual a Tarefa será executada. |
registry |
O registro privado que contém a imagem do contêiner. |
|
workingDirectory |
O local do diretório de trabalho da Tarefa de contêiner. |
TaskSchedulingPolicy
Especifica como as tarefas devem ser distribuídas entre nós de computação.
Nome | Tipo | Description |
---|---|---|
nodeFillType |
Como as tarefas são distribuídas entre nós de computação em um pool. |
UefiSettings
Especifica as configurações de segurança, como inicialização segura e vTPM usadas durante a criação da máquina virtual.
Nome | Tipo | Description |
---|---|---|
secureBootEnabled |
boolean |
Especifica se a inicialização segura deve ser habilitada na máquina virtual. |
vTpmEnabled |
boolean |
Especifica se o vTPM deve ser habilitado na máquina virtual. |
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.
Nome | Tipo | Description |
---|---|---|
automatic |
string |
Todas as máquinas virtuais no conjunto de dimensionamento são atualizadas automaticamente ao mesmo tempo. |
manual |
string |
Você controla a aplicação de atualizações para máquinas virtuais no conjunto de dimensionamento. Faça isso usando a ação manualUpgrade. |
rolling |
string |
As instâncias existentes em um conjunto de dimensionamento são derrubadas em lotes a serem atualizados. Depois que o lote atualizado for concluído, as instâncias começarão a usar o tráfego novamente e o próximo lote será iniciado. Isso continua até que todas as instâncias sejam up-to-date. |
UpgradePolicy
Descreve uma política de atualização – automática, manual ou sem interrupção.
Nome | Tipo | Description |
---|---|---|
automaticOSUpgradePolicy |
Parâmetros de configuração usados para executar a atualização automática do sistema operacional. |
|
mode |
Especifica o modo de uma atualização para máquinas virtuais no conjunto de dimensionamento. |
|
rollingUpgradePolicy |
Os parâmetros de configuração usados durante a execução de uma atualização sem interrupção. |
UsageStatistics
Estatísticas relacionadas às informações de uso do Pool.
Nome | Tipo | Description |
---|---|---|
dedicatedCoreTime |
string |
A hora agregada do relógio de parede dos núcleos dedicados do Nó de Computação que fazem parte do Pool. |
lastUpdateTime |
string |
A hora em que as estatísticas foram atualizadas pela última vez. Todas as estatísticas são limitadas ao intervalo entre startTime e lastUpdateTime. |
startTime |
string |
A hora de início do intervalo de tempo coberto pelas estatísticas. |
UserAccount
Propriedades usadas para criar um usuário usado para executar Tarefas em um Nó de Computação em Lote do Azure.
Nome | Tipo | Description |
---|---|---|
elevationLevel |
O nível de elevação da conta de usuário. |
|
linuxUserConfiguration |
A configuração de usuário específica do Linux para a conta de usuário. |
|
name |
string |
O nome da conta de usuário. Os nomes podem conter caracteres Unicode até um comprimento máximo de 20. |
password |
string |
A senha da conta de usuário. |
windowsUserConfiguration |
A configuração de usuário específica do Windows para a conta de usuário. |
UserAssignedIdentity
A identidade atribuída pelo usuário
Nome | Tipo | Description |
---|---|---|
clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
principalId |
string |
A ID principal da identidade atribuída pelo usuário. |
resourceId |
string |
A ID de recurso do ARM da identidade atribuída pelo usuário |
UserIdentity
A definição da identidade do usuário na qual a Tarefa é executada.
Nome | Tipo | Description |
---|---|---|
autoUser |
O usuário automático no qual a Tarefa é executada. |
|
username |
string |
O nome da identidade do usuário na qual a Tarefa é executada. |
VirtualMachineConfiguration
A configuração para nós de computação em um pool com base na infraestrutura de Máquinas Virtuais do Azure.
Nome | Tipo | Description |
---|---|---|
containerConfiguration |
A configuração do contêiner para o Pool. |
|
dataDisks |
Data |
A configuração de discos de dados anexados aos Nós de Computação no Pool. |
diskEncryptionConfiguration |
A configuração de criptografia de disco para o pool. |
|
extensions |
A extensão da máquina virtual para o pool. |
|
imageReference |
Uma referência à imagem do Marketplace de Máquinas Virtuais do Azure ou à imagem de máquina virtual personalizada a ser usada. |
|
licenseType |
string |
O tipo de licença local a ser usado ao implantar o sistema operacional. Windows_Server - A licença local é para o Windows Server. Windows_Client - A licença local é para o Cliente Windows. |
nodeAgentSKUId |
string |
A SKU do agente do Nó de Computação em Lote a ser provisionada em Nós de Computação no Pool. |
nodePlacementConfiguration |
A configuração de posicionamento do nó para o pool. |
|
osDisk |
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'. |
|
windowsConfiguration |
Configurações do sistema operacional Windows na máquina virtual. |
VMDiskSecurityProfile
Especifica as configurações de perfil de segurança para o disco gerenciado. Observação: ele só pode ser definido para VMs confidenciais e necessário ao usar VMs confidenciais.
Nome | Tipo | Description |
---|---|---|
securityEncryptionType |
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. |
VMExtension
A configuração para extensões de máquina virtual.
Nome | Tipo | Description |
---|---|---|
autoUpgradeMinorVersion |
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. |
enableAutomaticUpgrade |
boolean |
Indica se a extensão deve ser atualizada automaticamente pela plataforma se houver uma versão mais recente da extensão disponível. |
name |
string |
O nome da extensão da máquina virtual. |
protectedSettings |
object |
A extensão pode conter protectedSettings ou protectedSettingsFromKeyVault ou nenhuma configuração protegida. |
provisionAfterExtensions |
string[] |
A coleção de nomes de extensão. |
publisher |
string |
O nome do editor do manipulador de extensão. |
settings |
object |
Configurações públicas formatadas em JSON para a extensão. |
type |
string |
O tipo da extensão. |
typeHandlerVersion |
string |
A versão do manipulador de script. |
WindowsConfiguration
Configurações do sistema operacional Windows a serem aplicadas à máquina virtual.
Nome | Tipo | Description |
---|---|---|
enableAutomaticUpdates |
boolean |
Se as atualizações automáticas estão habilitadas na máquina virtual. |
WindowsUserConfiguration
Propriedades usadas para criar uma conta de usuário em um Nó de Computação do Windows.
Nome | Tipo | Description |
---|---|---|
loginMode |
O modo de logon do usuário |