Pool - Resize
Altera o número de nós de computação atribuídos a um pool.
Você só pode redimensionar um Pool quando seu estado de alocação for estável. Se o Pool já estiver redimensionando, a solicitação falhará com status código 409. Quando você redimensiona um Pool, o estado de alocação do pool muda de estável para redimensionamento. Não é possível redimensionar pools configurados para dimensionamento automático. Se você tentar fazer isso, o serviço do Lote retornará um erro 409. Se você redimensionar um Pool para baixo, o serviço lote escolherá quais nós de computação remover. Para remover nós de computação específicos, use a API Pool remove Nós de Computação.
POST {batchUrl}/pools/{poolId}/resize?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/resize?timeout={timeout}&api-version=2023-11-01.18.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 Lote do Azure. |
pool
|
path | True |
string |
A ID do Pool a ser redimensionada. |
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. |
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 o client-request-id 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 conhecido 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 conhecido 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 a hora especificada. |
|
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. |
Corpo da solicitação
Media Types: "application/json; odata=minimalmetadata"
Nome | Tipo | Description |
---|---|---|
nodeDeallocationOption |
Determina o que fazer com um Nó de Computação e suas tarefas em execução se o tamanho do Pool estiver diminuindo. |
|
resizeTimeout |
string |
O tempo limite para alocação de nós para o pool ou a remoção de nós de computação 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. |
Respostas
Nome | Tipo | Description |
---|---|---|
202 Accepted |
A solicitação para o serviço do Lote foi bem-sucedida. Headers
|
|
Other Status Codes |
O erro do serviço do Lote. |
Segurança
azure_auth
Microsoft Entra fluxo de código de autenticação OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Description |
---|---|
user_impersonation | Representar sua conta de usuário |
Authorization
Type:
apiKey
In:
header
Exemplos
Pool resize
Sample Request
POST account.region.batch.azure.com/pools/resizePool/resize?api-version=2023-11-01.18.0
{
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0
}
Sample Response
Definições
Nome | Description |
---|---|
Batch |
Uma resposta de erro recebida do serviço Lote do Azure. |
Batch |
Um item de informações adicionais incluído em uma resposta de erro Lote do Azure. |
Compute |
Determina o que fazer com um Nó de Computação e suas tarefas em execução depois de ter sido selecionado para desalocação. |
Error |
Uma mensagem de erro recebida em uma resposta de erro Lote do Azure. |
Pool |
Opções para alterar o tamanho de um Pool. |
BatchError
Uma resposta de erro recebida do serviço 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 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. |
ComputeNodeDeallocationOption
Determina o que fazer com um Nó de Computação e suas tarefas em execução depois de ter sido selecionado para desalocação.
Nome | Tipo | Description |
---|---|---|
requeue |
string |
Encerre a execução dos processos da tarefa e requeira as Tarefas. As Tarefas serão executadas novamente quando um Nó de Computação estiver disponível. Remova nós de computação assim que As tarefas forem encerradas. |
retaineddata |
string |
Permita que tarefas em execução no momento sejam concluídas e aguarde até que todos os períodos de retenção de dados da tarefa expirem. Não agende nenhuma nova Tarefa enquanto aguarda. Remova nós de computação quando todos os períodos de retenção de tarefa expirarem. |
taskcompletion |
string |
Permitir que tarefas em execução no momento sejam concluídas. Não agende nenhuma nova Tarefa enquanto aguarda. Remova nós de computação quando todas as Tarefas tiverem sido concluídas. |
terminate |
string |
Encerre a execução de Tarefas. As Tarefas serão concluídas com failureInfo indicando que foram encerradas e não serão executadas novamente. Remova nós de computação assim que As tarefas forem encerradas. |
ErrorMessage
Uma mensagem de erro recebida em uma resposta de erro Lote do Azure.
Nome | Tipo | Description |
---|---|---|
lang |
string |
O código de idioma da mensagem de erro |
value |
string |
O texto da mensagem. |
PoolResizeParameter
Opções para alterar o tamanho de um Pool.
Nome | Tipo | Description |
---|---|---|
nodeDeallocationOption |
Determina o que fazer com um Nó de Computação e suas tarefas em execução se o tamanho do Pool estiver diminuindo. |
|
resizeTimeout |
string |
O tempo limite para alocação de nós para o pool ou a remoção de nós de computação 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. |