Pool - Remove Nodes
Hiermee verwijdert u rekenknooppunten uit de opgegeven pool.
Deze bewerking kan alleen worden uitgevoerd wanneer de toewijzingsstatus van de pool stabiel is. Wanneer deze bewerking wordt uitgevoerd, verandert de toewijzingsstatus van constant in wijzigen van formaat. Elke aanvraag kan maximaal 100 knooppunten verwijderen.
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
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
batch
|
path | True |
string |
De basis-URL voor alle Azure Batch serviceaanvragen. |
pool
|
path | True |
string |
De id van de pool waaruit u rekenknooppunten wilt verwijderen. |
api-version
|
query | True |
string |
Client-API-versie. |
timeout
|
query |
integer int32 |
De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. |
Aanvraagkoptekst
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
client-request-id |
string uuid |
De door de aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Of de server de client-request-id in het antwoord moet retourneren. |
|
ocp-date |
string date-time-rfc1123 |
Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige systeemkloktijd; stel deze expliciet in als u de REST API rechtstreeks aanroept. |
|
If-Match |
string |
Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client. |
|
If-None-Match |
string |
Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client. |
|
If-Modified-Since |
string date-time-rfc1123 |
Een tijdstempel die de laatste wijzigingstijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource in de service sinds het opgegeven tijdstip is gewijzigd. |
|
If-Unmodified-Since |
string date-time-rfc1123 |
Een tijdstempel die de laatste wijzigingstijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource in de service niet is gewijzigd sinds het opgegeven tijdstip. |
Aanvraagbody
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
nodeList | True |
string[] |
Een lijst met de id's van de rekenknooppunten die uit de opgegeven pool moeten worden verwijderd. |
nodeDeallocationOption |
Bepaalt wat er moet worden gedaan met een rekenknooppunt en de actieve taak(en) nadat deze is geselecteerd voor deallocatie. |
||
resizeTimeout |
string |
De time-out voor het verwijderen van rekenknooppunten naar de pool. |
Antwoorden
Name | Type | Description |
---|---|---|
202 Accepted |
De aanvraag voor de Batch-service is geslaagd. Kopteksten
|
|
Other Status Codes |
De fout van de Batch-service. |
Beveiliging
azure_auth
Microsoft Entra OAuth 2.0-verificatiecodestroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Authorization
Type:
apiKey
In:
header
Voorbeelden
Pool remove nodes
Voorbeeldaanvraag
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"
]
}
Voorbeeldrespons
Definities
Name | Description |
---|---|
Batch |
Een foutbericht ontvangen van de Azure Batch-service. |
Batch |
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie. |
Compute |
Bepaalt wat er moet worden gedaan met een rekenknooppunt en de actieve taak(en) nadat deze is geselecteerd voor deallocatie. |
Error |
Een foutbericht ontvangen in een Azure Batch foutbericht. |
Node |
Opties voor het verwijderen van rekenknooppunten uit een pool. |
BatchError
Een foutbericht ontvangen van de Azure Batch-service.
Name | Type | Description |
---|---|---|
code |
string |
Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt. |
message |
Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface. |
|
values |
Een verzameling sleutel-waardeparen met aanvullende informatie over de fout. |
BatchErrorDetail
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
Name | Type | Description |
---|---|---|
key |
string |
Een id die de betekenis van de eigenschap Value aangeeft. |
value |
string |
De aanvullende informatie die is opgenomen in de foutreactie. |
ComputeNodeDeallocationOption
Bepaalt wat er moet worden gedaan met een rekenknooppunt en de actieve taak(en) nadat deze is geselecteerd voor deallocatie.
Name | Type | Description |
---|---|---|
requeue |
string |
Beëindig actieve taakprocessen en plaats de taken opnieuw. De taken worden opnieuw uitgevoerd wanneer er een rekenknooppunt beschikbaar is. Rekenknooppunten verwijderen zodra taken zijn beëindigd. |
retaineddata |
string |
Sta taken die momenteel worden uitgevoerd toe en wacht totdat alle bewaarperioden voor taakgegevens zijn verlopen. Geen nieuwe taken plannen tijdens het wachten. Rekenknooppunten verwijderen wanneer alle retentieperioden voor taken zijn verlopen. |
taskcompletion |
string |
Sta taken die momenteel worden uitgevoerd toe om te voltooien. Geen nieuwe taken plannen tijdens het wachten. Rekenknooppunten verwijderen wanneer alle taken zijn voltooid. |
terminate |
string |
Actieve taken beëindigen. De taken worden voltooid met failureInfo die aangeeft dat ze zijn beëindigd en niet opnieuw worden uitgevoerd. Rekenknooppunten verwijderen zodra taken zijn beëindigd. |
ErrorMessage
Een foutbericht ontvangen in een Azure Batch foutbericht.
Name | Type | Description |
---|---|---|
lang |
string |
De taalcode van het foutbericht |
value |
string |
De tekst van het bericht. |
NodeRemoveParameter
Opties voor het verwijderen van rekenknooppunten uit een pool.
Name | Type | Description |
---|---|---|
nodeDeallocationOption |
Bepaalt wat er moet worden gedaan met een rekenknooppunt en de actieve taak(en) nadat deze is geselecteerd voor deallocatie. |
|
nodeList |
string[] |
Een lijst met de id's van de rekenknooppunten die uit de opgegeven pool moeten worden verwijderd. |
resizeTimeout |
string |
De time-out voor het verwijderen van rekenknooppunten naar de pool. |