Nodes - Get Node Remote Login Settings

Otrzymuje ustawienia wymagane do zdalnego logowania do węzła obliczeniowego.
Zanim będziesz mógł zdalnie zalogować się do węzła obliczeniowego za pomocą zdalnych ustawień logowania, musisz utworzyć konto użytkownika na węźle obliczeniowym i skonfigurować porty dostępu dla SSH i RDP. Aby uzyskać więcej informacji, zobacz https://learn.microsoft.com/azure/batch/pool-endpoint-configuration

GET {endpoint}/pools/{poolId}/nodes/{nodeId}/remoteloginsettings?api-version=2025-06-01
GET {endpoint}/pools/{poolId}/nodes/{nodeId}/remoteloginsettings?api-version=2025-06-01&timeOut={timeOut}

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
endpoint
path True

string (uri)

Punkt końcowy konta usługi Batch (na przykład: https://batchaccount.eastus2.batch.azure.com).

nodeId
path True

string

ID węzła obliczeniowego, dla którego można uzyskać zdalne ustawienia logowania.

poolId
path True

string

Identyfikator puli zawierającej węzeł obliczeniowy.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

timeOut
query

integer (int32)

Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta domyślna wersja domyślna.".

Nagłówek żądania

Nazwisko Wymagane Typ Opis
client-request-id

string

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

return-client-request-id

boolean

Czy serwer powinien zwrócić identyfikator żądania klienta w odpowiedzi.

ocp-date

string (date-time-rfc7231)

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.

Odpowiedzi

Nazwisko Typ Opis
200 OK

BatchNodeRemoteLoginSettings

Żądanie zakończyło się pomyślnie.

Nagłówki

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

BatchError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

OAuth2Auth

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Zakresy

Nazwisko Opis
https://batch.core.windows.net//.default

Przykłady

Get batch node Dual Stack Networking Remote
Node get remote login settings

Get batch node Dual Stack Networking Remote

Przykładowe żądanie

GET {endpoint}/pools/dualstackpool/nodes/tvmps_5d8adec89961dcc011329b38df999a841f6cc815a5710678b741f04b33556ed2_d/remoteloginsettings?api-version=2025-06-01


Przykładowa odpowiedź

{
  "remoteLoginIPAddress": "1.1.1.1",
  "remoteLoginPort": 40000,
  "ipv6RemoteLoginIPAddress": "fd00::1",
  "ipv6RemoteLoginPort": 40000
}

Node get remote login settings

Przykładowe żądanie

GET {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/remoteloginsettings?api-version=2025-06-01


Przykładowa odpowiedź

{
  "remoteLoginIPAddress": "1.1.1.1",
  "remoteLoginPort": 50000
}

Definicje

Nazwisko Opis
BatchError

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

BatchErrorDetail

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

BatchErrorMessage

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

BatchNodeRemoteLoginSettings

Ustawienia logowania zdalnego dla węzła obliczeniowego.

BatchError

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

Nazwisko Typ Opis
code

string

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

message

BatchErrorMessage

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 usługi Azure Batch.

Nazwisko Typ Opis
key

string

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

value

string

Dodatkowe informacje zawarte w odpowiedzi na błąd.

BatchErrorMessage

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

Nazwisko Typ Opis
lang

string

Kod językowy komunikatu o błędzie.

value

string

Tekst wiadomości.

BatchNodeRemoteLoginSettings

Ustawienia logowania zdalnego dla węzła obliczeniowego.

Nazwisko Typ Opis
ipv6RemoteLoginIPAddress

string

Adres IPv6 używany do zdalnego logowania do węzła obliczeniowego.

ipv6RemoteLoginPort

integer (int32)

Port używany do zdalnego logowania do węzła obliczeniowego.

remoteLoginIPAddress

string

Adres IP używany do zdalnego logowania do węzła obliczeniowego.

remoteLoginPort

integer (int32)

Port używany do zdalnego logowania do węzła obliczeniowego.