Udostępnij za pośrednictwem


Compute Node - Reboot

Uruchamia ponownie określony węzeł obliczeniowy.
Węzeł obliczeniowy można uruchomić ponownie tylko wtedy, gdy jest w stanie bezczynności lub uruchomienia.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?timeout={timeout}&api-version=2023-11-01.18.0

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
batchUrl
path True

string

Podstawowy adres URL dla wszystkich żądań obsługi Azure Batch.

nodeId
path True

string

Identyfikator węzła obliczeniowego, który chcesz ponownie uruchomić.

poolId
path True

string

Identyfikator puli zawierającej węzeł obliczeniowy.

api-version
query True

string

Wersja interfejsu API klienta.

timeout
query

integer

int32

Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund.

Nagłówek żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa Wymagane Typ Opis
client-request-id

string

uuid

Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takich jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Określa, czy serwer powinien zwrócić wartość client-request-id w odpowiedzi.

ocp-date

string

date-time-rfc1123

Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Treść żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa Typ Opis
nodeRebootOption

ComputeNodeRebootOption

Kiedy należy ponownie uruchomić węzeł obliczeniowy i co zrobić z aktualnie uruchomionymi zadaniami.
Wartość domyślna to ponowne kolejki.

Odpowiedzi

Nazwa Typ Opis
202 Accepted

Żądanie do usługi Batch zakończyło się pomyślnie.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Błąd usługi Batch.

Zabezpieczenia

azure_auth

przepływ kodu uwierzytelniania OAuth 2.0 Microsoft Entra

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa Opis
user_impersonation Personifikuj konto użytkownika

Authorization

Type: apiKey
In: header

Przykłady

Node reboot

Sample Request

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reboot?api-version=2023-11-01.18.0



{
  "nodeRebootOption": "terminate"
}

Sample Response

Definicje

Nazwa Opis
BatchError

Odebrano odpowiedź o błędzie z usługi Azure Batch.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd Azure Batch.

ComputeNodeRebootOption

Kiedy należy ponownie uruchomić węzeł obliczeniowy i co zrobić z aktualnie uruchomionymi zadaniami.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

NodeRebootParameter

Opcje ponownego uruchamiania węzła obliczeniowego.

BatchError

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

message

ErrorMessage

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

values

BatchErrorDetail[]

Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Element dodatkowych informacji zawartych w odpowiedzi na błąd Azure Batch.

Nazwa Typ Opis
key

string

Identyfikator określający znaczenie właściwości Value.

value

string

Dodatkowe informacje zawarte w odpowiedzi na błąd.

ComputeNodeRebootOption

Kiedy należy ponownie uruchomić węzeł obliczeniowy i co zrobić z aktualnie uruchomionymi zadaniami.

Nazwa Typ Opis
requeue

string

Zakończ uruchamianie procesów zadań i ponownie w kolejce zadania. Zadania zostaną uruchomione ponownie po udostępnieniu węzła obliczeniowego. Uruchom ponownie węzeł obliczeniowy, gdy tylko zadania zostały zakończone.

retaineddata

string

Zezwalaj na ukończenie aktualnie uruchomionych zadań, a następnie poczekaj na wygaśnięcie wszystkich okresów przechowywania danych zadania. Zaplanuj brak nowych zadań podczas oczekiwania. Uruchom ponownie węzeł obliczeniowy, gdy wszystkie okresy przechowywania zadań wygasły.

taskcompletion

string

Zezwalaj na ukończenie aktualnie uruchomionych zadań. Zaplanuj brak nowych zadań podczas oczekiwania. Uruchom ponownie węzeł obliczeniowy po zakończeniu wszystkich zadań.

terminate

string

Zakończ uruchomione zadania. Zadania zostaną ukończone z informacją o niepowodzeniu wskazującym, że zostały zakończone i nie zostaną uruchomione ponownie. Uruchom ponownie węzeł obliczeniowy, gdy tylko zadania zostały zakończone.

ErrorMessage

Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.

Nazwa Typ Opis
lang

string

Kod języka komunikatu o błędzie

value

string

Tekst wiadomości.

NodeRebootParameter

Opcje ponownego uruchamiania węzła obliczeniowego.

Nazwa Typ Opis
nodeRebootOption

ComputeNodeRebootOption

Kiedy należy ponownie uruchomić węzeł obliczeniowy i co zrobić z aktualnie uruchomionymi zadaniami.
Wartość domyślna to ponowne kolejki.