Pool - Remove Nodes
Rimuove i nodi di calcolo dal pool specificato.
Questa operazione può essere eseguita solo quando lo stato di allocazione del pool è costante. Quando viene eseguita questa operazione, lo stato di allocazione cambia da costante a ridimensionamento. Ogni richiesta può rimuovere fino a 100 nodi.
POST {batchUrl}/pools/{poolId}/removenodes?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/removenodes?timeout={timeout}&api-version=2023-11-01.18.0
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
batch
|
path | True |
string |
URL di base per tutte le richieste di servizio Azure Batch. |
pool
|
path | True |
string |
ID del pool da cui si desidera rimuovere nodi di calcolo. |
api-version
|
query | True |
string |
Versione dell'API client. |
timeout
|
query |
integer int32 |
Tempo massimo per cui il server può trascorrere l'elaborazione della richiesta, in secondi. Il valore predefinito è 30 secondi. |
Intestazione della richiesta
Media Types: "application/json; odata=minimalmetadata"
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
client-request-id |
string uuid |
Identità richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50E-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Se il server deve restituire l'ID richiesta client nella risposta. |
|
ocp-date |
string date-time-rfc1123 |
Ora in cui è stata eseguita la richiesta. Le librerie client in genere impostano l'ora dell'orologio del sistema corrente; impostarla in modo esplicito se si chiama direttamente l'API REST. |
|
If-Match |
string |
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio corrisponde esattamente al valore specificato dal client. |
|
If-None-Match |
string |
Valore ETag associato alla versione della risorsa nota al client. L'operazione verrà eseguita solo se l'ETag corrente della risorsa nel servizio non corrisponde al valore specificato dal client. |
|
If-Modified-Since |
string date-time-rfc1123 |
Timestamp che indica l'ultima ora modificata della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio è stata modificata dall'ora specificata. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Timestamp che indica l'ultima ora modificata della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dopo l'ora specificata. |
Corpo della richiesta
Media Types: "application/json; odata=minimalmetadata"
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
nodeList | True |
string[] |
Elenco contenente gli ID dei nodi di calcolo da rimuovere dal pool specificato. |
nodeDeallocationOption |
Determina cosa fare con un nodo di calcolo e le relative attività in esecuzione dopo che è stata selezionata per deallocation. |
||
resizeTimeout |
string |
Timeout per la rimozione dei nodi di calcolo nel pool. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
202 Accepted |
La richiesta al servizio Batch ha avuto esito positivo. Headers
|
|
Other Status Codes |
Errore dal servizio Batch. |
Sicurezza
azure_auth
Microsoft Entra flusso di codice di autenticazione OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | Rappresentare l'account utente |
Authorization
Type:
apiKey
In:
header
Esempio
Pool remove nodes
Sample Request
POST account.region.batch.azure.com/pools/poolId/removenodes?api-version=2023-11-01.18.0
{
"nodeList": [
"tvm-1695681911_1-20161122t224741z",
"tvm-1695681911_2-20161122t224741z"
]
}
Sample Response
Definizioni
Nome | Descrizione |
---|---|
Batch |
Risposta di errore ricevuta dal servizio Azure Batch. |
Batch |
Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch. |
Compute |
Determina cosa fare con un nodo di calcolo e le relative attività in esecuzione dopo che è stata selezionata per deallocation. |
Error |
Messaggio di errore ricevuto in una risposta di errore Azure Batch. |
Node |
Opzioni per la rimozione dei nodi di calcolo da un pool. |
BatchError
Risposta di errore ricevuta dal servizio Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice. |
message |
Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente. |
|
values |
Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore. |
BatchErrorDetail
Elemento di informazioni aggiuntive incluse in una risposta di errore Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
key |
string |
Identificatore che specifica il significato della proprietà Value. |
value |
string |
Informazioni aggiuntive incluse nella risposta all'errore. |
ComputeNodeDeallocationOption
Determina cosa fare con un nodo di calcolo e le relative attività in esecuzione dopo che è stata selezionata per deallocation.
Nome | Tipo | Descrizione |
---|---|---|
requeue |
string |
Terminare l'esecuzione di processi attività e ripetere la sequenza delle attività. Le attività verranno eseguite di nuovo quando è disponibile un nodo di calcolo. Rimuovere nodi di calcolo non appena le attività sono state terminate. |
retaineddata |
string |
Consentire il completamento delle attività in esecuzione, quindi attendere la scadenza di tutti i periodi di conservazione dei dati attività. Pianificare nessuna nuova attività durante l'attesa. Rimuovere nodi di calcolo quando sono scaduti tutti i periodi di conservazione delle attività. |
taskcompletion |
string |
Consenti di completare le attività attualmente in esecuzione. Pianificare nessuna nuova attività durante l'attesa. Rimuovere nodi di calcolo al termine di tutte le attività. |
terminate |
string |
Terminare l'esecuzione di attività. Le attività verranno completate con failureInfo che indica che sono state terminate e non verranno eseguiti di nuovo. Rimuovere nodi di calcolo non appena le attività sono state terminate. |
ErrorMessage
Messaggio di errore ricevuto in una risposta di errore Azure Batch.
Nome | Tipo | Descrizione |
---|---|---|
lang |
string |
Codice del linguaggio del messaggio di errore |
value |
string |
Testo del messaggio. |
NodeRemoveParameter
Opzioni per la rimozione dei nodi di calcolo da un pool.
Nome | Tipo | Descrizione |
---|---|---|
nodeDeallocationOption |
Determina cosa fare con un nodo di calcolo e le relative attività in esecuzione dopo che è stata selezionata per deallocation. |
|
nodeList |
string[] |
Elenco contenente gli ID dei nodi di calcolo da rimuovere dal pool specificato. |
resizeTimeout |
string |
Timeout per la rimozione dei nodi di calcolo nel pool. |