Nodes - Upload Node Logs

서비스:: Batch Service

API 버전:: 2025-06-01

지정된 컴퓨트 노드에서 Azure Blob 저장소로 Azure 배치 서비스 로그 파일을 업로드하세요.
이는 오류가 발생하고 Azure 지원으로 에스컬레이션하고 싶을 때 컴퓨트 노드에서 Azure 배치 서비스 로그 파일을 자동화하여 수집하기 위한 것입니다. Batch 서비스의 디버깅 문제를 지원하기 위해 Azure Batch 서비스 로그 파일을 Azure 지원과 공유해야 합니다.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?api-version=2025-06-01

선택적 매개 변수:

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/uploadbatchservicelogs?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보다 크면 기본값이 대신 사용됩니다."라고 말했습니다.

요청 헤더

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

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를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name	필수	형식	Description
containerUrl	True	string (uri)	배치 서비스 로그 파일을 업로드할 컨테이너의 URL 주소입니다. 사용자 할당된 관리 신원이 사용되지 않는 경우, URL에 컨테이너에 쓰기 권한을 부여하는 공유 접근 서명(SAS)이 포함되어야 합니다. SAS 시간은 업로드가 완료될 충분한 시간을 확보해야 합니다. SAS의 시작 시간은 선택 사항이며 지정하지 않는 것이 권장됩니다.
startTime	True	string (date-time)	배치 서비스 로그 파일을 업로드할 수 있는 시작 시간의 범위입니다. 시간 범위 내 로그 메시지가 포함된 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되기 때문에 작업은 요청된 것보다 더 많은 로그를 가져올 수 있지만, 요청된 것보다 적은 로그를 가져와서는 안 됩니다.
endTime		string (date-time)	배치 서비스 로그 파일을 업로드할 수 있는 시간 범위 내에 있습니다. 시간 범위 내 로그 메시지가 포함된 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되기 때문에 작업은 요청된 것보다 더 많은 로그를 가져올 수 있지만, 요청된 것보다 적은 로그를 가져와서는 안 됩니다. 생략할 경우, 기본 설정은 시작 시간 이후 사용 가능한 모든 로그를 업로드하는 것입니다.
identityReference		BatchNodeIdentityReference	containerUrl이 지정한 Azure Blob 저장소에 접근하기 위해 사용하는 사용자 지정 아이덴티티에 대한 참조입니다. 신원은 Azure Blob Storage 컨테이너에 쓰기 권한이 있어야 합니다.

응답

Name	형식	Description
200 OK	UploadBatchServiceLogsResult	요청이 성공했습니다. 헤더 ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

UploadBatchServiceLogsResult

요청이 성공했습니다.

헤더

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

예제

Upload BatchService Logs

샘플 요청

HTTP

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



{
  "containerUrl": "https://somestorageacct.blob.core.windows.net/batch-compute-node-logs?se=2025-12-09T18%3A51%3A00Z&sp=w&sv=2025-05-31&sr=c&sig",
  "startTime": "2025-11-27T00:00:00Z"
}

샘플 응답

상태 코드:: 200

{
  "virtualDirectoryName": "poolId/tvm-1695681911-1-20161121t182739z/0795539d-82fe-48e3-bbff-2964905b6de0",
  "numberOfFilesUploaded": 8
}

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
UploadBatchServiceLogsOptions	Azure Batch 서비스 로그 파일은 컴퓨팅 노드에 대한 매개 변수를 업로드합니다.
UploadBatchServiceLogsResult	특정 컴퓨팅 노드에서 Batch 서비스 로그 파일을 업로드한 결과입니다.

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	메시지의 텍스트입니다.

BatchNodeIdentityReference

Object

컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.

Name	형식	Description
resourceId	string (arm-id)	사용자 할당 ID의 ARM 리소스 ID입니다.

UploadBatchServiceLogsOptions

Object

Azure Batch 서비스 로그 파일은 컴퓨팅 노드에 대한 매개 변수를 업로드합니다.

Name	형식	Description
containerUrl	string (uri)	배치 서비스 로그 파일을 업로드할 컨테이너의 URL 주소입니다. 사용자 할당된 관리 신원이 사용되지 않는 경우, URL에 컨테이너에 쓰기 권한을 부여하는 공유 접근 서명(SAS)이 포함되어야 합니다. SAS 시간은 업로드가 완료될 충분한 시간을 확보해야 합니다. SAS의 시작 시간은 선택 사항이며 지정하지 않는 것이 권장됩니다.
endTime	string (date-time)	배치 서비스 로그 파일을 업로드할 수 있는 시간 범위 내에 있습니다. 시간 범위 내 로그 메시지가 포함된 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되기 때문에 작업은 요청된 것보다 더 많은 로그를 가져올 수 있지만, 요청된 것보다 적은 로그를 가져와서는 안 됩니다. 생략할 경우, 기본 설정은 시작 시간 이후 사용 가능한 모든 로그를 업로드하는 것입니다.
identityReference	BatchNodeIdentityReference	containerUrl이 지정한 Azure Blob 저장소에 접근하기 위해 사용하는 사용자 지정 아이덴티티에 대한 참조입니다. 신원은 Azure Blob Storage 컨테이너에 쓰기 권한이 있어야 합니다.
startTime	string (date-time)	배치 서비스 로그 파일을 업로드할 수 있는 시작 시간의 범위입니다. 시간 범위 내 로그 메시지가 포함된 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되기 때문에 작업은 요청된 것보다 더 많은 로그를 가져올 수 있지만, 요청된 것보다 적은 로그를 가져와서는 안 됩니다.

UploadBatchServiceLogsResult

Object

특정 컴퓨팅 노드에서 Batch 서비스 로그 파일을 업로드한 결과입니다.

Name	형식	Description
numberOfFilesUploaded	integer (int32)	업로드될 로그 파일의 수.
virtualDirectoryName	string	배치 서비스 로그 파일이 업로드될 Azure Blob Storage 컨테이너 내의 가상 디렉터리입니다. 가상 디렉터리 이름은 업로드되는 각 로그 파일의 블롭 이름의 일부이며, poolId, nodeId, 고유 식별자를 기반으로 구축됩니다.

다음을 통해 공유

Nodes - Upload Node Logs

URI 매개 변수

요청 헤더

요청 본문

응답

보안

OAuth2Auth

범위

예제

Upload BatchService Logs

샘플 요청

샘플 응답

정의

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeIdentityReference

UploadBatchServiceLogsOptions

UploadBatchServiceLogsResult