Delen via

Nodes - Get Node Remote Login Settings

Service:
Batch Service
API-versie:
2025-06-01

Haalt de instellingen op die nodig zijn voor remote login naar een Compute Node.
Voordat je op afstand kunt inloggen op een Compute Node met de remote login-instellingen, moet je een gebruikersaccount aanmaken op de Compute Node en toegangspoorten configureren voor SSH en RDP. Zie https://learn.microsoft.com/azure/batch/pool-endpoint-configuration voor meer informatie

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

URI-parameters

Name In Vereist Type Description
endpoint
 path True

string (uri)

Batch-accounteindpunt (bijvoorbeeld: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

De ID van de Compute Node waarvoor de instellingen voor externe login worden verworven.
poolId
 path True

string

De id van de pool die het rekenknooppunt bevat.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.
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. Als de waarde groter is dan 30, wordt de standaard in plaats daarvan gebruikt."

Aanvraagkoptekst

Name Vereist Type Description
client-request-id

string

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 clientaanvraag-id in het antwoord moet retourneren.
ocp-date

string (date-time-rfc7231)

Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept.

Antwoorden

Name Type Description
200 OK

BatchNodeRemoteLoginSettings

De aanvraag is voltooid.

Kopteksten

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

BatchError

Een onverwachte foutreactie.

Beveiliging

OAuth2Auth

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Bereiken

Name Description
https://batch.core.windows.net//.default

Voorbeelden

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

Get batch node Dual Stack Networking Remote

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
200 
{
  "remoteLoginIPAddress": "１.1.1.1",
  "remoteLoginPort": 40000,
  "ipv6RemoteLoginIPAddress": "fd00::1",
  "ipv6RemoteLoginPort": 40000
}

Node get remote login settings

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
BatchError

Er is een foutbericht ontvangen van de Azure Batch-service.
BatchErrorDetail

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
BatchErrorMessage

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.
BatchNodeRemoteLoginSettings

De instellingen voor externe aanmelding voor een rekenknooppunt.

BatchError

Object

Er is 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

BatchErrorMessage

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
values

BatchErrorDetail[]

Een verzameling sleutel-waardeparen met aanvullende informatie over de fout.

BatchErrorDetail

Object

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 Waarde aangeeft.
value

string

De aanvullende informatie die is opgenomen in het foutbericht.

BatchErrorMessage

Object

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

Name Type Description
lang

string

De taalcode van het foutbericht.
value

string

De tekst van het bericht.

BatchNodeRemoteLoginSettings

Object

De instellingen voor externe aanmelding voor een rekenknooppunt.

Name Type Description
ipv6RemoteLoginIPAddress

string

Het IPv6-adres dat wordt gebruikt voor het extern inloggen op de Compute Node.
ipv6RemoteLoginPort

integer (int32)

De poort die wordt gebruikt voor externe aanmelding bij het rekenknooppunt.
remoteLoginIPAddress

string

Het IP-adres dat wordt gebruikt voor externe aanmelding bij het rekenknooppunt.
remoteLoginPort

integer (int32)

De poort die wordt gebruikt voor externe aanmelding bij het rekenknooppunt.