Pool - Enable Auto Scale
Abilita il ridimensionamento automatico per un pool.
Non è possibile abilitare il ridimensionamento automatico in un pool se è in corso un'operazione di ridimensionamento nel pool. Se il ridimensionamento automatico del pool è attualmente disabilitato, è necessario specificare una formula di scalabilità automatica valida come parte della richiesta. Se la scalabilità automatica del pool è già abilitata, è possibile specificare una nuova formula di scalabilità automatica e/o un nuovo intervallo di valutazione. Non è possibile chiamare questa API per lo stesso pool più di una volta ogni 30 secondi.
POST {batchUrl}/pools/{poolId}/enableautoscale?api-version=2024-07-01.20.0POST {batchUrl}/pools/{poolId}/enableautoscale?timeout={timeout}&api-version=2024-07-01.20.0Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
batch
|
path | True |
string |
URL di base per tutte le richieste del servizio Azure Batch. |
|
pool
|
path | True |
string |
ID del pool in cui abilitare il ridimensionamento automatico. |
|
api-version
|
query | True |
string |
Versione dell'API client. |
|
timeout
|
query |
integer int32 |
Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è maggiore di 30, verrà usato il valore predefinito. |
Intestazione della richiesta
Media Types: "application/json; odata=minimalmetadata"
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| client-request-id |
string uuid |
Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
| return-client-request-id |
boolean |
Indica se il server deve restituire l'ID richiesta client nella risposta. |
|
| ocp-date |
string date-time-rfc1123 |
Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; 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'ora dell'ultima modifica 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'ora dell'ultima modifica della risorsa nota al client. L'operazione verrà eseguita solo se la risorsa nel servizio non è stata modificata dall'ora specificata. |
Corpo della richiesta
Media Types: "application/json; odata=minimalmetadata"
| Nome | Tipo | Descrizione |
|---|---|---|
| autoScaleEvaluationInterval |
string |
Intervallo di tempo in cui modificare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. |
| autoScaleFormula |
string |
Formula per il numero desiderato di nodi di calcolo nel pool. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
La richiesta al servizio Batch ha avuto esito positivo. Intestazioni
|
|
| Other Status Codes |
Errore del servizio Batch. |
Sicurezza
azure_auth
Flusso del codice di autenticazione di Microsoft Entra OAuth 2.0
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | Rappresentare l'account utente |
Authorization
Tipo:
apiKey
In:
header
Esempio
Pool enable autoscale
Esempio di richiesta
POST account.region.batch.azure.com/pools/poolId/enableautoscale?api-version=2024-07-01.20.0
{
"autoScaleFormula": "$TargetDedicated=0",
"autoScaleEvaluationInterval": "PT8M"
}
Risposta di esempio
Definizioni
| Nome | Descrizione |
|---|---|
|
Batch |
Risposta di errore ricevuta dal servizio Azure Batch. |
|
Batch |
Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch. |
|
Error |
Messaggio di errore ricevuto in una risposta di errore di Azure Batch. |
|
Pool |
Opzioni per abilitare il ridimensionamento automatico in 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 utilizzati 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 di Azure Batch.
| Nome | Tipo | Descrizione |
|---|---|---|
| key |
string |
Identificatore che specifica il significato della proprietà Value. |
| value |
string |
Informazioni aggiuntive incluse nella risposta di errore. |
ErrorMessage
Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
| Nome | Tipo | Descrizione |
|---|---|---|
| lang |
string |
Codice linguistico del messaggio di errore |
| value |
string |
Testo del messaggio. |
PoolEnableAutoScaleParameter
Opzioni per abilitare il ridimensionamento automatico in un pool.
| Nome | Tipo | Descrizione |
|---|---|---|
| autoScaleEvaluationInterval |
string |
Intervallo di tempo in cui modificare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. |
| autoScaleFormula |
string |
Formula per il numero desiderato di nodi di calcolo nel pool. |