Compute Node - Upload Batch Service Logs

참조

Service:: Batch Service

API Version:: 2023-11-01.18.0

지정된 컴퓨팅 노드에서 Azure Batch 서비스 로그 파일을 업로드하여 Azure Blob Storage.
이는 오류가 발생하고 Azure 지원 에스컬레이션하려는 경우 컴퓨팅 노드에서 자동화된 방식으로 Azure Batch 서비스 로그 파일을 수집하기 위한 것입니다. Azure Batch 서비스 로그 파일을 Azure 지원 공유하여 Batch 서비스의 디버깅 문제를 지원해야 합니다.

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

With optional parameters:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
nodeId	path	True	string	Azure Batch 서비스 로그 파일을 업로드할 컴퓨팅 노드의 ID입니다.
poolId	path	True	string	컴퓨팅 노드를 포함하는 풀의 ID입니다.
api-version	query	True	string	클라이언트 API 버전.
timeout	query		integer int32	서버가 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다.

요청 헤더

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

Name	형식	Description
client-request-id	string uuid	9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같은 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id	boolean	서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date	string date-time-rfc1123	요청이 실행된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name	필수	형식	Description
containerUrl	True	string	Batch 서비스 로그 파일을 업로드할 Azure Blob Storage 내 컨테이너의 URL입니다. 사용자가 할당한 관리 ID를 사용하지 않는 경우 URL에는 컨테이너에 쓰기 권한을 부여하는 SAS(공유 액세스 서명)가 포함되어야 합니다. SAS 기간은 업로드가 완료되는 데 충분한 시간을 허용해야 합니다. SAS의 시작 시간은 선택 사항이며 지정하지 않는 것이 좋습니다.
startTime	True	string	Batch 서비스 로그 파일을 업로드할 시간 범위의 시작입니다. 시간 범위의 로그 메시지를 포함하는 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되므로 작업이 요청된 것보다 더 많은 로그를 검색할 수 있지만 작업이 요청된 것보다 적은 로그를 검색하면 안 됩니다.
endTime		string	Batch 서비스 로그 파일을 업로드할 시간 범위의 끝입니다. 시간 범위의 로그 메시지를 포함하는 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되므로 작업이 요청된 것보다 더 많은 로그를 검색할 수 있지만 작업이 요청된 것보다 적은 로그를 검색하면 안 됩니다. 생략하면 기본값은 startTime 이후에 사용 가능한 모든 로그를 업로드하는 것입니다.
identityReference		ComputeNodeIdentityReference	containerUrl에서 지정한 Azure Blob Storage 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. ID는 Azure Blob Storage 컨테이너에 대한 쓰기 권한이 있어야 합니다.

응답

Name	형식	Description
200 OK	UploadBatchServiceLogsResult	Batch 서비스에 대한 요청이 성공했습니다. Headers client-request-id: string request-id: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

200 OK

UploadBatchServiceLogsResult

Batch 서비스에 대한 요청이 성공했습니다.

Headers

client-request-id: string
request-id: string

Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

OAuth 2.0 인증 코드 흐름 Microsoft Entra

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

Scopes

Name	Description
user_impersonation	사용자 계정 가장

Authorization

Type: apiKey
In: header

예제

Upload BatchService Logs

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/uploadbatchservicelogs?api-version=2023-11-01.18.0



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

Sample Response

Status code:: 200

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

정의

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

BatchError

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

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
message	ErrorMessage	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values	BatchErrorDetail[]	오류에 대한 추가 세부 정보가 포함된 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

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

Name	형식	Description
key	string	Value 속성의 의미를 지정하는 식별자입니다.
value	string	오류 응답에 포함된 추가 정보입니다.

ComputeNodeIdentityReference

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

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

ErrorMessage

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

Name	형식	Description
lang	string	오류 메시지의 언어 코드
value	string	메시지의 텍스트입니다.

UploadBatchServiceLogsConfiguration

Azure Batch 서비스 로그 파일은 컴퓨팅 노드에 대한 구성을 업로드합니다.

Name	형식	Description
containerUrl	string	Batch 서비스 로그 파일을 업로드할 Azure Blob Storage 내 컨테이너의 URL입니다. 사용자가 할당한 관리 ID를 사용하지 않는 경우 URL에는 컨테이너에 쓰기 권한을 부여하는 SAS(공유 액세스 서명)가 포함되어야 합니다. SAS 기간은 업로드가 완료되는 데 충분한 시간을 허용해야 합니다. SAS의 시작 시간은 선택 사항이며 지정하지 않는 것이 좋습니다.
endTime	string	Batch 서비스 로그 파일을 업로드할 시간 범위의 끝입니다. 시간 범위의 로그 메시지를 포함하는 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되므로 작업이 요청된 것보다 더 많은 로그를 검색할 수 있지만 작업이 요청된 것보다 적은 로그를 검색하면 안 됩니다. 생략하면 기본값은 startTime 이후에 사용 가능한 모든 로그를 업로드하는 것입니다.
identityReference	ComputeNodeIdentityReference	containerUrl에서 지정한 Azure Blob Storage 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. ID는 Azure Blob Storage 컨테이너에 대한 쓰기 권한이 있어야 합니다.
startTime	string	Batch 서비스 로그 파일을 업로드할 시간 범위의 시작입니다. 시간 범위의 로그 메시지를 포함하는 모든 로그 파일이 업로드됩니다. 즉, 전체 로그 파일이 항상 업로드되므로 작업이 요청된 것보다 더 많은 로그를 검색할 수 있지만 작업이 요청된 것보다 적은 로그를 검색하면 안 됩니다.

UploadBatchServiceLogsResult

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

Name	형식	Description
numberOfFilesUploaded	integer	업로드할 로그 파일의 수입니다.
virtualDirectoryName	string	Batch 서비스 로그 파일을 업로드할 Azure Blob Storage 컨테이너 내의 가상 디렉터리입니다. 가상 디렉터리 이름은 업로드된 각 로그 파일에 대한 Blob 이름의 일부이며 poolId, nodeId 및 고유 식별자를 기반으로 빌드됩니다.

다음을 통해 공유

Compute Node - Upload Batch Service Logs

URI 매개 변수

요청 헤더

요청 본문

응답

보안

azure_auth

Scopes

Authorization

예제

Upload BatchService Logs

Sample Request

Sample Response

정의

BatchError

BatchErrorDetail

ComputeNodeIdentityReference

ErrorMessage

UploadBatchServiceLogsConfiguration

UploadBatchServiceLogsResult

추가 리소스