Tasks - List Sub Tasks

서비스:: Batch Service

API 버전:: 2025-06-01

지정된 다중 인스턴스 작업과 연관된 모든 하위 작업을 나열합니다.
만약 작업이 다중 인스턴스 작업이 아니라면, 빈 컬렉션을 반환합니다.

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/subtasksinfo?api-version=2025-06-01

선택적 매개 변수:

GET {endpoint}/jobs/{jobId}/tasks/{taskId}/subtasksinfo?api-version=2025-06-01&timeOut={timeOut}&$select={$select}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	Batch 계정 엔드포인트(예: https://batchaccount.eastus2.batch.azure.com).
jobId	path	True	string	그 일의 신분증.
taskId	path	True	string	과제의 ID.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
$select	query		string[]	OData $select 절입니다.
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	BatchTaskListSubtasksResult	요청이 성공했습니다. 헤더 ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

BatchTaskListSubtasksResult

요청이 성공했습니다.

헤더

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

예제

Task list subtasks

샘플 요청

HTTP

GET {endpoint}/jobs/jobId/tasks/taskId/subtasksinfo?api-version=2025-06-01

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "id": 1,
      "startTime": "2025-09-06T06:59:16.3139271Z",
      "endTime": "2025-09-06T06:59:20.0242024Z",
      "state": "completed",
      "stateTransitionTime": "2025-09-06T06:59:20.0242024Z",
      "previousState": "running",
      "previousStateTransitionTime": "2025-09-06T06:59:16.3139271Z",
      "exitCode": 0,
      "nodeInfo": {
        "affinityId": "TVM:tvm-2544493925_3-20160905t051718z",
        "nodeUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_3-20160905t051718z",
        "poolId": "mpiPool",
        "nodeId": "tvm-2544493925_3-20160905t051718z",
        "taskRootDirectory": "\\workitems\\jobId\\job-1\\taskId\\1",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_3-20160905t051718z/files//workitems/jobId/job-1/taskId/1"
      }
    },
    {
      "id": 2,
      "startTime": "2025-09-06T06:59:16.9702844Z",
      "state": "running",
      "stateTransitionTime": "2025-09-06T06:59:16.9702844Z",
      "nodeInfo": {
        "affinityId": "TVM:tvm-2544493925_2-20160905t051718z",
        "nodeUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_2-20160905t051718z",
        "poolId": "mpiPool",
        "nodeId": "tvm-2544493925_2-20160905t051718z",
        "taskRootDirectory": "\\workitems\\jobId\\job-1\\taskId\\2",
        "taskRootDirectoryUrl": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-2544493925_2-20160905t051718z/files//workitems/jobId/job-1/taskId/2"
      }
    }
  ]
}

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchErrorSourceCategory	배치 오류출처 카테고리 열거
BatchNodeInfo	태스크가 실행된 컴퓨팅 노드에 대한 정보입니다.
BatchSubtask	Azure Batch 하위 작업에 대한 정보입니다.
BatchSubtaskState	배치 SubtaskState 열거
BatchTaskContainerExecutionInfo	태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다.
BatchTaskExecutionResult	BatchTaskExecutionResult는 열거됩니다
BatchTaskFailureInfo	작업 실패에 대한 정보입니다.
BatchTaskListSubtasksResult	작업의 하위 작업을 나열한 결과입니다.
NameValuePair	이름-값 쌍을 나타냅니다.

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

BatchErrorSourceCategory

열거형

배치 오류출처 카테고리 열거

값	Description
usererror	이 오류는 설정 오류와 같은 사용자 문제에서 비롯됩니다.
servererror	이 오류는 내부 서버 문제로 인해 발생했습니다.

BatchNodeInfo

Object

태스크가 실행된 컴퓨팅 노드에 대한 정보입니다.

Name	형식	Description
affinityId	string	작업이 실행되는 노드의 식별자로, 작업을 추가할 때 이 컴퓨팅 노드에서 작업을 스케줄링하도록 요청할 때 전달할 수 있습니다.
nodeId	string	작업이 실행되는 컴퓨트 노드의 ID입니다.
nodeUrl	string (uri)	작업이 실행되는 컴퓨트 노드의 URL.
poolId	string	태스크가 진행되는 풀의 ID입니다.
taskRootDirectory	string	컴퓨트 노드에 있는 작업의 루트 디렉터리입니다.
taskRootDirectoryUrl	string (uri)	컴퓨트 노드에 있는 작업 루트 디렉터리의 URL입니다.

BatchSubtask

Object

Azure Batch 하위 작업에 대한 정보입니다.

Name	형식	Description
containerInfo	BatchTaskContainerExecutionInfo	작업이 실행되는 컨테이너에 대한 정보입니다. 이 속성은 작업이 컨테이너 컨텍스트에서 실행될 때만 설정됩니다.
endTime	string (date-time)	하위 작업이 완료된 시간입니다. 이 속성은 서브태스크가 완료 상태일 때만 설정됩니다.
exitCode	integer (int32)	서브태스크 명령줄에 지정된 프로그램의 종료 코드입니다. 이 속성은 서브태스크가 완료된 상태일 때만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 관례를 반영합니다. 출구 코드 값을 사용해 코드를 결정할 때는 애플리케이션 프로세스에서 사용하는 출구 코드 규칙을 반드시 알고 있어야 합니다. 하지만 배치 서비스가 타임아웃이나 API를 통한 사용자 종료로 인해 하위 작업을 종료할 경우, 운영체제에서 정의한 종료 코드를 볼 수 있습니다.
failureInfo	BatchTaskFailureInfo	작업 실패에 대한 정보가 있다면. 이 속성은 작업이 완료 상태에 있고 실패를 겪었을 때만 설정됩니다.
id	integer (int32)	하위 작업의 ID.
nodeInfo	BatchNodeInfo	하위 작업이 실행되는 컴퓨트 노드에 대한 정보입니다.
previousState	BatchSubtaskState	서브태스크의 이전 상태. 이 속성은 서브태스크가 초기 실행 상태일 때는 설정되지 않습니다.
previousStateTransitionTime	string (date-time)	서브태스크가 이전 상태에 들어간 시점입니다. 이 속성은 서브태스크가 초기 실행 상태일 때는 설정되지 않습니다.
result	BatchTaskExecutionResult	과제 실행의 결과입니다. 값이 '실패'라면, 실패 세부 사항은 failureInfo 속성에서 확인할 수 있습니다.
startTime	string (date-time)	서브태스크가 실행되기 시작한 시간. 서브태스크가 재시작되거나 재시도된 경우, 이는 서브태스크가 실행을 시작한 가장 최근 시점입니다.
state	BatchSubtaskState	현재 하위 임무의 상태입니다.
stateTransitionTime	string (date-time)	서브태스크가 현재 상태에 들어간 시점입니다.

BatchSubtaskState

열거형

배치 SubtaskState 열거

값	Description
preparing	작업은 컴퓨트 노드에 할당되었지만, 컴퓨트 노드에서 필요한 작업 준비 작업이 완료되기를 기다리고 있습니다. 작업 준비 작업이 성공하면 작업은 실행 단계로 넘어갑니다. 작업 준비 작업이 실패하면 작업은 다시 활성 상태로 돌아가 다른 컴퓨트 노드에 할당될 자격이 생깁니다.
running	이 작업은 컴퓨트 노드에서 실행됩니다. 여기에는 리소스 파일 다운로드나 작업에 지정된 패키지 배포와 같은 작업 수준의 준비가 포함되며, 반드시 작업 명령줄이 실행을 시작했다는 의미는 아닙니다.
completed	과제는 더 이상 실행 자격이 없는데, 이는 보통 과제가 성공적으로 완료되었거나, 실패한 후 재시도 한도를 모두 소진했기 때문입니다. 작업 실행 중 오류가 발생하거나 작업이 종료되었을 때도 완료로 표시됩니다.

BatchTaskContainerExecutionInfo

Object

태스크가 실행 중인 컨테이너에 대한 정보를 포함합니다.

Name	형식	Description
containerId	string	컨테이너의 ID입니다.
error	string	컨테이너에 대한 자세한 오류 정보. 이 문자열은 Docker 서비스에서 제공하는 상세한 오류 문자열입니다. 이는 "docker inspect"에서 반환되는 오류 필드와 동등합니다.
state	string	컨테이너 상태. 이것이 Docker 서비스에 따른 컨테이너 상태입니다. 이는 "docker inspect"에서 반환되는 상태 필드와 동등합니다.

BatchTaskExecutionResult

열거형

BatchTaskExecutionResult는 열거됩니다

값	Description
success	과제는 성공적으로 진행되었다.
failure	과제 처리 중에 오류가 발생했습니다. 실패는 작업 프로세스가 실행되기 전, 실행 중이거나 작업 프로세스가 종료된 후에 발생했을 수 있습니다.

BatchTaskFailureInfo

Object

작업 실패에 대한 정보입니다.

Name	형식	Description
category	BatchErrorSourceCategory	작업 오류의 범주.
code	string	작업 오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	NameValuePair[]	오류와 관련된 추가 세부사항 목록입니다.
message	string	작업 오류를 설명하는 메시지로, 사용자 인터페이스에서 표시하기에 적합하도록 설계되었습니다.

BatchTaskListSubtasksResult

Object

작업의 하위 작업을 나열한 결과입니다.

Name	형식	Description
odata.nextLink	string (uri)	다음 결과 집합을 가져올 URL입니다.
value	BatchSubtask[]	하위 작업 목록.

NameValuePair

Object

이름-값 쌍을 나타냅니다.

Name	형식	Description
name	string	이름-값 쌍 안에 있는 이름.
value	string	이름-값 쌍의 값입니다.

다음을 통해 공유

Tasks - List Sub Tasks

URI 매개 변수

요청 헤더

응답

보안

OAuth2Auth

범위

예제

Task list subtasks

샘플 요청

샘플 응답

정의

BatchError

BatchErrorDetail

BatchErrorMessage

BatchErrorSourceCategory

BatchNodeInfo

BatchSubtask

BatchSubtaskState

BatchTaskContainerExecutionInfo

BatchTaskExecutionResult

BatchTaskFailureInfo

BatchTaskListSubtasksResult

NameValuePair