Pool - Update Properties

Referência

Serviço:: Batch Service

Versão da API:: 2024-07-01.20.0

Atualiza as propriedades do Pool especificado.
Isso substitui totalmente todas as propriedades atualizáveis do Pool. Por exemplo, se o Pool tiver um StartTask associado a ele e se StartTask não for especificado com essa solicitação, o serviço em lote removerá o StartTask existente.

POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2024-07-01.20.0

Com parâmetros opcionais:

POST {batchUrl}/pools/{poolId}/updateproperties?timeout={timeout}&api-version=2024-07-01.20.0

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
batchUrl	path	True	string	A URL base para todas as solicitações de serviço do Lote do Azure.
poolId	path	True	string	A ID do Pool a ser atualizado.
api-version	query	True	string	Versão da API do cliente.
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 do Pedido

Media Types: "application/json; odata=minimalmetadata"

Name	Tipo	Description
client-request-id	string uuid	A identidade de solicitação gerada pelo chamador, na forma de um GUID sem decoração, como chaves encaracoladas, por exemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Se o servidor deve retornar o client-request-id na resposta.
ocp-date	string date-time-rfc1123	A hora em que o pedido foi emitido. As bibliotecas de cliente normalmente definem isso para a hora atual do relógio do sistema; defina-o explicitamente se você estiver chamando a API REST diretamente.

Corpo do Pedido

Media Types: "application/json; odata=minimalmetadata"

Name	Necessário	Tipo	Description
applicationPackageReferences	True	ApplicationPackageReference[]	A lista de Pacotes de Aplicativos a serem instalados em cada Nó de Computação no Pool. A lista substitui todas as referências existentes do Pacote de Aplicativos no Pool. As alterações nas referências do Pacote de Aplicativo afetam todos os novos Nós de Computação que ingressam no Pool, mas não afetam os Nós de Computação que já estão no Pool até que sejam reinicializados ou recriados com imagem. Há um máximo de 10 referências de Pacote de Aplicativos em qualquer Pool. Se omitida ou se você especificar uma coleção vazia, todas as referências de Pacotes de Aplicativos existentes serão removidas do Pool. Um máximo de 10 referências podem ser especificadas em um determinado Pool.
certificateReferences	True	CertificateReference[]	Uma lista de certificados a serem instalados em cada nó de computação no pool. Essa lista substitui todas as referências de certificado existentes configuradas no Pool. Se você especificar uma coleção vazia, todas as referências de Certificado existentes serão removidas do Pool. Para nós do Windows, o serviço em lote instala os certificados no armazenamento de certificados e no local especificados. Para nós de computação Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho Tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para Certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório base do usuário (por exemplo, /home/{user-name}/certs) e os Certificados são colocados nesse diretório. Aviso: Esta propriedade foi preterida e será removida após fevereiro de 2024. Em vez disso, use o Azure KeyVault Extension.
metadata	True	MetadataItem[]	Uma lista de pares nome-valor associados ao Pool como metadados. Essa lista substitui todos os metadados existentes configurados no Pool. Se omitido, ou se você especificar uma coleção vazia, todos os metadados existentes serão removidos do Pool.
startTask		StartTask	Uma Tarefa a ser executada em cada Nó de Computação à medida que ele se junta ao Pool. A Tarefa é executada quando o Nó de Computação é adicionado ao Pool ou quando o Nó de Computação é reiniciado. Se esse elemento estiver presente, ele substituirá qualquer StartTask existente. Se omitido, qualquer StartTask existente será removido do Pool.
targetNodeCommunicationMode		NodeCommunicationMode	O modo de comunicação de nó desejado para o pool. Essa configuração substitui qualquer configuração targetNodeCommunication existente no Pool. Se omitida, a configuração existente é padrão.

Respostas

Name	Tipo	Description
204 No Content		A solicitação para o serviço de lote foi bem-sucedida. Cabeçalhos client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	O erro do serviço de lote.

Name

Tipo

Description

204 No Content

A solicitação para o serviço de lote foi bem-sucedida.

Cabeçalhos

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

Other Status Codes

BatchError

O erro do serviço de lote.

Segurança

azure_auth

Fluxo de código de autenticação do Microsoft Entra OAuth 2.0

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	Personificar a sua conta de utilizador

Authorization

Tipo: apiKey
Em: header

Exemplos

Pool update

Pedido de amostra

HTTP

POST account.region.batch.azure.com/pools/poolId/updateproperties?api-version=2024-07-01.20.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "certificateReferences": [],
  "applicationPackageReferences": [],
  "metadata": []
}

Resposta da amostra

Código de estado:: 204

Definições

Name	Description
ApplicationPackageReference	Uma referência a um pacote a ser implantado em nós de computação.
AutoUserScope	O escopo para o usuário automático
AutoUserSpecification	Especifica os parâmetros para o usuário automático que executa uma tarefa no serviço em lote.
BatchError	Uma resposta de erro recebida do serviço Batch do Azure.
BatchErrorDetail	Um item de informações adicionais incluído em uma resposta de erro do Lote do Azure.
CertificateReference	Uma referência a um certificado a ser instalado em nós de computação em um pool.
CertificateStoreLocation	O local do armazenamento de certificados no nó de computação no qual instalar o certificado.
CertificateVisibility	Quais Contas de usuário no Nó de Computação devem ter acesso aos dados privados do Certificado.
ComputeNodeIdentityReference	A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará.
ContainerHostBatchBindMountEntry	A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas.
ContainerHostDataPath	Os caminhos que serão montados no contêiner da tarefa do contêiner.
ContainerRegistry	Um registro de contêiner privado.
ContainerWorkingDirectory	O local do diretório de trabalho da tarefa do contêiner.
ElevationLevel	O nível de elevação do usuário.
EnvironmentSetting	Uma variável de ambiente a ser definida em um processo Task.
ErrorMessage	Uma mensagem de erro recebida em uma resposta de erro do Lote do Azure.
MetadataItem	Um par nome-valor associado a um recurso de serviço em lote.
NodeCommunicationMode	Determina como um pool se comunica com o serviço de lote.
PoolUpdatePropertiesParameter	O conjunto de alterações a serem feitas em um pool.
ResourceFile	Um único arquivo ou vários arquivos a serem baixados para um nó de computação.
StartTask	Uma Tarefa que é executada quando um Nó ingressa em um Pool no serviço Lote do Azure ou quando o Nó de Computação é reinicializado ou recriado.
TaskContainerSettings	As configurações de contêiner para uma Tarefa.
UserIdentity	A definição da identidade do usuário sob a qual a Tarefa é executada.

ApplicationPackageReference

Uma referência a um pacote a ser implantado em nós de computação.

Name	Tipo	Description
applicationId	string	A 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}).
version	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 este aplicativo, a solicitação falhará 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 este aplicativo, a Tarefa falhará com um erro de pré-processamento.

AutoUserScope

O escopo para o usuário automático

Name	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 em lote.

Name	Tipo	Description
elevationLevel	ElevationLevel	O nível de elevação do usuário automático. O valor padrão é nonAdmin.
scope	AutoUserScope	O escopo para o usuário automático O valor padrão é pool. Se o pool estiver executando o Windows, um valor de Task deverá ser especificado se for necessário um isolamento mais rigoroso entre as tarefas. Por exemplo, se a tarefa muta o registro de uma forma que pode afetar outras tarefas, ou se certificados foram especificados no pool que não deve ser acessível por tarefas normais, mas deve ser acessível por StartTasks.

BatchError

Uma resposta de erro recebida do serviço Batch do Azure.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
message	ErrorMessage	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
values	BatchErrorDetail[]	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.

Name	Tipo	Description
key	string	Um identificador que especifica o significado da propriedade Value.
value	string	As informações adicionais incluídas com a resposta de erro.

CertificateReference

Uma referência a um certificado a ser instalado em nós de computação em um pool.

Name	Tipo	Description
storeLocation	CertificateStoreLocation	O local do armazenamento de certificados no nó de computação no qual instalar o certificado. O valor padrão é currentuser. Esta propriedade é aplicável somente para pools configurados com nós de computação do Windows. Para nós de computação Linux, os certificados são armazenados em um diretório dentro do diretório de trabalho Tarefa e uma variável de ambiente AZ_BATCH_CERTIFICATES_DIR é fornecida à tarefa para consultar esse local. Para Certificados com visibilidade de 'remoteUser', um diretório 'certs' é criado no diretório base do usuário (por exemplo, /home/{user-name}/certs) e os Certificados são colocados nesse diretório.
storeName	string	O nome do armazenamento de certificados no nó de computação no qual instalar o certificado. Esta propriedade é aplicável somente para pools configurados com nós de computação do Windows. Os nomes de armazenamento comuns incluem: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mas qualquer nome de loja personalizado também pode ser usado. O valor padrão é My.
thumbprint	string	A impressão digital do Certificado.
thumbprintAlgorithm	string	O algoritmo ao qual a impressão digital está associada. Isso deve ser sha1.
visibility	CertificateVisibility[]	Quais Contas de usuário no Nó de Computação devem ter acesso aos dados privados do Certificado. Você pode especificar mais de uma visibilidade nesta coleção. O padrão é todas as contas.

CertificateStoreLocation

O local do armazenamento de certificados no nó de computação no qual instalar o certificado.

Name	Tipo	Description
currentuser	string	Os certificados devem ser instalados no repositório de certificados CurrentUser.
localmachine	string	Os certificados devem ser instalados no armazenamento de certificados LocalMachine.

CertificateVisibility

Quais Contas de usuário no Nó de Computação devem ter acesso aos dados privados do Certificado.

Name	Tipo	Description
remoteuser	string	O Certificado deve estar visível para as contas de usuário sob as 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 sob a qual o StartTask é executado. Observe que, se o Escopo do Usuário Automático for Pool para 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 sob as quais as Tarefas de Trabalho são executadas.

ComputeNodeIdentityReference

A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará.

Name	Tipo	Description
resourceId	string	O ID de recurso ARM da identidade atribuída ao usuário.

ContainerHostBatchBindMountEntry

A entrada do caminho e do modo de montagem que você deseja montar no contêiner de tarefas.

Name	Tipo	Description
isReadOnly	boolean	Monte esse caminho de origem como modo somente leitura ou não. O valor padrão é false (modo de leitura/gravação). Para 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, 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 modificá-lo.
source	ContainerHostDataPath	O caminho que ser montado para o cliente de contêiner pode selecionar.

ContainerHostDataPath

Os caminhos que serão montados no contêiner da tarefa do contêiner.

Name	Tipo	Description
Applications	string	O caminho dos aplicativos.
JobPrep	string	O caminho da tarefa de preparação para o 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.

Name	Tipo	Description
identityReference	ComputeNodeIdentityReference	A referência à identidade atribuída ao usuário a ser usada para acessar um Registro de Contêiner do Azure em vez de nome de usuário e senha. A referência a uma identidade atribuída ao usuário associada ao pool de lotes que um nó de computação usará.
password	string	A palavra-passe para iniciar sessão no servidor de registo.
registryServer	string	O URL do registo. Se omitido, o padrão é "docker.io".
username	string	O nome de utilizador para iniciar sessão no servidor de registo.

ContainerWorkingDirectory

O local do diretório de trabalho da tarefa do contêiner.

Name	Tipo	Description
containerImageDefault	string	Use o diretório de trabalho definido na imagem do contêiner. Tenha cuidado que este diretório não conterá os arquivos de recursos baixados pelo lote.
taskWorkingDirectory	string	Use o diretório de trabalho padrão Tarefa do serviço em lote, que conterá os arquivos de recursos da tarefa preenchidos por lote.

ElevationLevel

O nível de elevação do usuário.

Name	Tipo	Description
admin	string	O usuário é um usuário com acesso elevado e opera com permissões completas de administrador.
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 Task.

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

Name	Tipo	Description
lang	string	O código de idioma da mensagem de erro
value	string	O texto da mensagem.

MetadataItem

Um par nome-valor associado a um recurso de serviço em lote.

Name	Tipo	Description
name	string	O nome do item de metadados.
value	string	O valor do item de metadados.

NodeCommunicationMode

Determina como um pool se comunica com o serviço de lote.

Name	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}" e comunicação TCP de saída na porta 443 para "Storage.region" e "BatchNodeManagement. {region}" tags de serviço.
default	string	O modo de comunicação do nó é definido automaticamente pelo serviço Batch.
simplified	string	Os nós que usam o modo de comunicação simplificado requerem comunicação TCP de saída na porta 443 para o "BatchNodeManagement. {region}" etiqueta de serviço. Não são necessárias portas de entrada abertas.