다음을 통해 공유

Nodes - Get Node Remote Login Settings

서비스:
Batch Service
API 버전:
2025-06-01

컴퓨트 노드에 원격 로그인하는 데 필요한 설정을 얻습니다.
원격 로그인 설정을 통해 컴퓨트 노드에 원격으로 로그인하기 전에, 컴퓨트 노드에서 사용자 계정을 만들고 SSH와 RDP용 접근 포트를 설정해야 합니다. 자세한 내용은 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}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
endpoint
 path True

string (uri)

Batch 계정 엔드포인트(예: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

원격 로그인 설정을 얻기 위한 컴퓨트 노드의 ID입니다.
poolId
 path True

string

컴퓨팅 노드를 포함하는 풀의 ID입니다.
api-version
 query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.
timeOut
 query

integer (int32)

서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 만약 값이 30보다 크면 기본값이 대신 사용됩니다."라고 말했습니다.

요청 헤더

Name 필수 형식 Description
client-request-id

string

9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같은 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id

boolean

서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date

string (date-time-rfc7231)

요청이 발급된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

응답

Name 형식 Description
200 OK

BatchNodeRemoteLoginSettings

요청이 성공했습니다.

헤더

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

BatchError

예기치 않은 오류 응답입니다.

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

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

예제

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

Get batch node Dual Stack Networking Remote

샘플 요청

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

샘플 응답

상태 코드:
200 
{
  "remoteLoginIPAddress": "１.1.1.1",
  "remoteLoginPort": 40000,
  "ipv6RemoteLoginIPAddress": "fd00::1",
  "ipv6RemoteLoginPort": 40000
}

Node get remote login settings

샘플 요청

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

샘플 응답

상태 코드:
200 
{
  "remoteLoginIPAddress": "1.1.1.1",
  "remoteLoginPort": 50000
}

정의

Name Description
BatchError

Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage

Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchNodeRemoteLoginSettings

컴퓨팅 노드에 대한 원격 로그인 설정입니다.

BatchError

Object

Azure Batch 서비스에서 받은 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
message

BatchErrorMessage

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values

BatchErrorDetail[]

오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

Object

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.

Name 형식 Description
key

string

Value 속성의 의미를 지정하는 식별자입니다.
value

string

오류 응답에 포함된 추가 정보입니다.

BatchErrorMessage

Object

Azure Batch 오류 응답에서 받은 오류 메시지입니다.

Name 형식 Description
lang

string

오류 메시지의 언어 코드입니다.
value

string

메시지의 텍스트입니다.

BatchNodeRemoteLoginSettings

Object

컴퓨팅 노드에 대한 원격 로그인 설정입니다.

Name 형식 Description
ipv6RemoteLoginIPAddress

string

컴퓨팅 노드에 대한 원격 로그인에 사용되는 IPv6 주소입니다.
ipv6RemoteLoginPort

integer (int32)

컴퓨팅 노드에 원격 로그인하는 데 사용되는 포트입니다.
remoteLoginIPAddress

string

컴퓨팅 노드에 원격 로그인하는 데 사용되는 IP 주소입니다.
remoteLoginPort

integer (int32)

컴퓨팅 노드에 원격 로그인하는 데 사용되는 포트입니다.