Pool - Delete
Exclui um pool da Conta especificada.
Quando você solicita que um Pool seja excluído, ocorrem as seguintes ações: o estado do pool está definido como exclusão; qualquer operação de redimensionamento em andamento no pool é interrompida; o serviço lote começa a redimensionar o pool para zero nós de computação; todas as tarefas em execução em nós de computação existentes são encerradas e requeuídas (como se uma operação de pool de redimensionamento tivesse sido solicitada com a opção de remoção padrão); por fim, o Pool é removido do sistema. Como as tarefas em execução são requeuidas, o usuário pode executar novamente essas Tarefas atualizando seu Trabalho para direcionar a um pool diferente. Em seguida, as Tarefas podem ser executadas no novo pool. Se você quiser substituir o comportamento de remoção de fila, chame o pool de redimensionamento explicitamente para reduzir o pool para tamanho zero antes de excluir o Pool. Se você chamar uma API De atualização, patch ou exclusão em um pool no estado de exclusão, ela falhará com HTTP status código 409 com o código de erro PoolBeingDeleted.
DELETE {batchUrl}/pools/{poolId}?api-version=2023-11-01.18.0
DELETE {batchUrl}/pools/{poolId}?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 excluído. |
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 de 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 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 de 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 de 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 a hora especificada. |
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 delete
Sample Request
DELETE account.region.batch.azure.com/pools/poolId?api-version=2023-11-01.18.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. |
Error |
Uma mensagem de erro recebida em uma resposta de erro Lote do Azure. |
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 que contém 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. |
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. |