Task - List

지정된 작업과 연결된 모든 작업을 나열합니다.
다중 instance 작업의 경우 affinityId, executionInfo 및 nodeInfo와 같은 정보는 기본 작업을 참조하세요. 목록 하위 작업 API를 사용하여 하위 작업에 대한 정보를 검색합니다.

GET {batchUrl}/jobs/{jobId}/tasks?api-version=2023-11-01.18.0
GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2023-11-01.18.0

URI 매개 변수

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

string

모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.

jobId
path True

string

작업의 ID입니다.

api-version
query True

string

클라이언트 API 버전.

$expand
query

string

OData $expand 절입니다.

$filter
query

string

OData $filter 절입니다. 이 필터를 생성하는 방법에 대한 자세한 내용은 을 참조하세요 https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks.

$select
query

string

OData $select 절입니다.

maxresults
query

integer

int32

응답에서 반환할 최대 항목 수입니다. 최대 1000 태스크를 반환할 수 있습니다.

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

응답

Name 형식 Description
200 OK

CloudTaskListResult

작업 목록을 포함하는 응답입니다.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: 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

예제

Task list

Sample Request

GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2023-11-01.18.0


Sample Response

{
  "value": [
    {
      "id": "task1",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task1",
      "eTag": "0x8D4125FD1A825A4",
      "creationTime": "2016-11-21T22:43:31.4733476Z",
      "lastModified": "2016-11-21T22:43:31.4733476Z",
      "state": "active",
      "stateTransitionTime": "2016-11-21T22:43:31.4733476Z",
      "commandLine": "cmd /c echo task1",
      "userIdentity": {
        "autoUser": {
          "scope": "task",
          "elevationLevel": "nonadmin"
        }
      },
      "constraints": {
        "maxWallClockTime": "P10675199DT2H48M5.4775807S",
        "retentionTime": "P10675199DT2H48M5.4775807S",
        "maxTaskRetryCount": 0
      },
      "requiredSlots": 2,
      "executionInfo": {
        "retryCount": 0,
        "requeueCount": 0
      }
    },
    {
      "id": "task2",
      "url": "https://account.region.batch.azure.com/jobs/jobId/tasks/task2",
      "eTag": "0x8D4125FD2153345",
      "creationTime": "2016-11-21T22:43:31.6736345Z",
      "lastModified": "2016-11-21T22:43:32.1880389Z",
      "state": "active",
      "stateTransitionTime": "2016-11-21T22:43:31.6736345Z",
      "commandLine": "cmd /c echo task2",
      "userIdentity": {
        "autoUser": {
          "scope": "task",
          "elevationLevel": "nonadmin"
        }
      },
      "constraints": {
        "maxWallClockTime": "P10675199DT2H48M5.4775807S",
        "retentionTime": "P10675199DT2H48M5.4775807S",
        "maxTaskRetryCount": 3
      },
      "requiredSlots": 2,
      "executionInfo": {
        "retryCount": 0,
        "requeueCount": 0
      }
    }
  ]
}

정의

Name Description
AccessScope

토큰이 액세스 권한을 부여하는 Batch 리소스입니다.

AffinityInformation

Batch 서비스에서 작업을 시작할 컴퓨팅 노드를 선택하는 데 사용할 수 있는 지역성 힌트입니다.

ApplicationPackageReference

컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.

AuthenticationTokenSettings

태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.

AutoUserScope

자동 사용자에 대한 scope

AutoUserSpecification

Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.

BatchError

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

BatchErrorDetail

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

CloudTask

Azure Batch 작업입니다.

CloudTaskListResult

작업에 작업을 나열한 결과입니다.

ComputeNodeIdentityReference

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

ComputeNodeInformation

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

ContainerRegistry

프라이빗 컨테이너 레지스트리.

ContainerWorkingDirectory

컨테이너 작업 디렉터리의 위치입니다.

DependencyAction

Batch 서비스가 이 작업에 의존하는 작업에 대해 수행하는 작업입니다.

ElevationLevel

사용자의 권한 상승 수준입니다.

EnvironmentSetting

작업 프로세스에서 설정할 환경 변수입니다.

ErrorCategory

오류의 범주입니다.

ErrorMessage

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

ExitCodeMapping

태스크가 특정 종료 코드로 종료되는 경우 Batch 서비스가 응답하는 방법입니다.

ExitCodeRangeMapping

종료 코드 범위 및 Batch 서비스가 해당 범위 내의 종료 코드에 응답하는 방법.

ExitConditions

태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다.

ExitOptions

Batch 서비스가 특정 종료 조건에 응답하는 방법을 지정합니다.

HttpHeader

HTTP 헤더 이름-값 쌍

JobAction

태스크가 지정된 종료 조건으로 완료되고 Job의 onTaskFailed 속성이 'performExitOptionsJobAction'인 경우 태스크가 포함된 작업에 대해 수행할 작업입니다.

MultiInstanceSettings

다중 instance 작업을 실행하는 방법을 지정하는 설정입니다.

NameValuePair

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

OutputFile

Batch 서비스가 작업 프로세스 실행을 완료한 후 Azure Batch Compute Node에서 다른 위치로 파일을 업로드하기 위한 사양입니다.

OutputFileBlobContainerDestination

Azure Blob Storage 컨테이너 내에서 파일 업로드 대상을 지정합니다.

OutputFileDestination

파일을 업로드할 대상입니다.

OutputFileUploadCondition

작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다.

OutputFileUploadOptions

업로드를 수행할 조건을 포함하여 출력 파일 업로드 작업에 대한 세부 정보입니다.

ResourceFile

컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.

TaskConstraints

작업에 적용할 실행 제약 조건입니다.

TaskContainerExecutionInformation

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

TaskContainerSettings

작업에 대한 컨테이너 설정입니다.

TaskDependencies

작업의 종속성을 지정합니다. 명시적으로 지정되었거나 종속성 범위 내에 있는 모든 작업은 종속 작업이 예약되기 전에 완료되어야 합니다.

TaskExecutionInformation

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

TaskExecutionResult

작업 실행의 결과입니다.

TaskFailureInformation

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

TaskIdRange

태스크가 의존할 수 있는 작업 ID의 범위입니다. 범위의 ID가 있는 모든 작업은 종속 작업을 예약하기 전에 성공적으로 완료되어야 합니다.

TaskState

태스크의 상태입니다.

TaskStatistics

작업에 대한 리소스 사용 통계입니다.

UserIdentity

작업이 실행되는 사용자 ID의 정의입니다.

AccessScope

토큰이 액세스 권한을 부여하는 Batch 리소스입니다.

Name 형식 Description
job

string

작업을 포함하는 작업에 대한 모든 작업을 수행할 수 있는 액세스 권한을 부여합니다.

AffinityInformation

Batch 서비스에서 작업을 시작할 컴퓨팅 노드를 선택하는 데 사용할 수 있는 지역성 힌트입니다.

Name 형식 Description
affinityId

string

이전에 실행된 컴퓨팅 노드 또는 태스크의 위치를 나타내는 불투명 문자열입니다.
노드의 affinityId를 전달하여 이 작업이 해당 컴퓨팅 노드에서 실행되어야 함을 나타낼 수 있습니다. 이는 소프트 선호도일 뿐입니다. 작업이 예약될 때 대상 컴퓨팅 노드가 사용 중이거나 사용할 수 없는 경우 작업은 다른 곳에서 예약됩니다.

ApplicationPackageReference

컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.

Name 형식 Description
applicationId

string

배포할 애플리케이션의 ID입니다.
풀을 만들 때 패키지의 애플리케이션 ID는 정규화되어야 합니다(/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).

version

string

배포할 애플리케이션의 버전입니다. 생략하면 기본 버전이 배포됩니다.
풀에서 생략되고 이 애플리케이션에 대한 기본 버전이 지정되지 않은 경우 오류 코드 InvalidApplicationPackageReferences 및 HTTP 상태 코드 409와 함께 요청이 실패합니다. 작업에서 생략되고 이 애플리케이션에 대한 기본 버전이 지정되지 않은 경우 태스크가 사전 처리 오류와 함께 실패합니다.

AuthenticationTokenSettings

태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.

Name 형식 Description
access

AccessScope[]

토큰이 액세스 권한을 부여하는 Batch 리소스입니다.
인증 토큰은 제한된 Batch 서비스 작업 집합에 대한 액세스 권한을 부여합니다. 현재 access 속성에 대해 지원되는 유일한 값은 'job'이며, 이 값은 작업이 포함된 작업과 관련된 모든 작업에 대한 액세스 권한을 부여합니다.

AutoUserScope

자동 사용자에 대한 scope

Name 형식 Description
pool

string

태스크가 풀의 모든 컴퓨팅 노드에서 생성되는 공통 자동 사용자 계정으로 실행되도록 지정합니다.

task

string

서비스에서 작업에 대한 새 사용자를 만들게 지정합니다.

AutoUserSpecification

Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.

Name 형식 Description
elevationLevel

ElevationLevel

자동 사용자의 권한 상승 수준입니다.
기본값은 nonAdmin입니다.

scope

AutoUserScope

자동 사용자에 대한 scope
기본값은 풀입니다. 풀이 Windows를 실행하는 경우 작업 간에 더 엄격한 격리가 필요한 경우 작업 값을 지정해야 합니다. 예를 들어 태스크가 다른 작업에 영향을 줄 수 있는 방식으로 레지스트리를 변경하거나 일반 태스크에서 액세스할 수 없지만 StartTasks에서 액세스할 수 있어야 하는 풀에 인증서를 지정한 경우입니다.

BatchError

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

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

message

ErrorMessage

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

values

BatchErrorDetail[]

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

BatchErrorDetail

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

Name 형식 Description
key

string

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

value

string

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

CloudTask

Azure Batch 작업입니다.

Name 형식 Description
affinityInfo

AffinityInformation

Batch 서비스에서 새 작업을 시작할 컴퓨팅 노드를 선택하는 데 사용할 수 있는 지역성 힌트입니다.

applicationPackageReferences

ApplicationPackageReference[]

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 배포할 패키지 목록입니다.
애플리케이션 패키지는 다운로드되어 작업 작업 디렉터리가 아닌 공유 디렉터리에 배포됩니다. 따라서 참조된 패키지가 노드에 이미 있고 최신 상태이면 다시 다운로드되지 않습니다. 컴퓨팅 노드의 기존 복사본이 사용됩니다. 참조된 패키지를 설치할 수 없는 경우(예: 패키지가 삭제되었거나 다운로드가 실패했기 때문에) 작업이 실패합니다.

authenticationTokenSettings

AuthenticationTokenSettings

태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.
이 속성을 설정하면 Batch 서비스는 계정 액세스 키를 요구하지 않고 Batch 서비스 작업을 인증하는 데 사용할 수 있는 인증 토큰을 Task에 제공합니다. 토큰은 AZ_BATCH_AUTHENTICATION_TOKEN 환경 변수를 통해 제공됩니다. 태스크가 토큰을 사용하여 수행할 수 있는 작업은 설정에 따라 달라집니다. 예를 들어 태스크는 작업에 다른 작업을 추가하거나 작업 또는 작업 아래의 다른 작업의 상태 검사 위해 작업 권한을 요청할 수 있습니다.

commandLine

string

작업의 명령줄입니다.
다중 instance 작업의 경우 기본 작업 및 모든 하위 작업이 조정 명령줄 실행을 완료한 후 명령줄이 기본 작업으로 실행됩니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.

constraints

TaskConstraints

이 작업에 적용되는 실행 제약 조건입니다.

containerSettings

TaskContainerSettings

태스크가 실행되는 컨테이너에 대한 설정입니다.
이 작업을 실행할 풀에 containerConfiguration이 설정된 경우 이 설정도 설정해야 합니다. 이 작업을 실행할 풀에 containerConfiguration이 설정되어 있지 않으면 설정하면 안 됩니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.

creationTime

string

작업의 생성 시간입니다.

dependsOn

TaskDependencies

이 태스크가 사용하는 작업입니다.
이 작업은 의존하는 모든 작업이 성공적으로 완료될 때까지 예약되지 않습니다. 이러한 작업이 실패하고 재시도 횟수가 소진되는 경우 이 작업은 예약되지 않습니다.

displayName

string

작업의 표시 이름입니다.
표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.

eTag

string

작업의 ETag입니다.
불투명 문자열입니다. 이를 사용하여 요청 간에 태스크가 변경되었는지 여부를 검색할 수 있습니다. 특히 작업을 업데이트할 때 ETag를 전달하여 그 동안 다른 사람이 작업을 수정하지 않은 경우에만 변경 내용이 적용되도록 지정할 수 있습니다.

environmentSettings

EnvironmentSetting[]

작업에 대한 환경 변수 설정 목록입니다.

executionInfo

TaskExecutionInformation

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

exitConditions

ExitConditions

태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다.
태스크가 완료되면 Batch 서비스가 응답하는 방식입니다.

id

string

작업 내에서 작업을 고유하게 식별하는 문자열입니다.
ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다.

lastModified

string

작업의 마지막 수정 시간입니다.

multiInstanceSettings

MultiInstanceSettings

Task가 다중 instance 작업임을 나타내고 다중 instance 작업을 실행하는 방법에 대한 정보를 포함하는 개체입니다.
다중 instance 작업은 일반적으로 MPI 작업을 지원하는 데 사용됩니다. MPI의 경우 하위 작업이 실패하는 경우(예: 0이 아닌 종료 코드로 인해) 전체 다중 instance 작업이 실패합니다. 그런 다음 다중 instance 작업이 종료되고 재시도 한도까지 다시 시도됩니다.

nodeInfo

ComputeNodeInformation

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

outputFiles

OutputFile[]

명령줄을 실행한 후 Batch 서비스가 컴퓨팅 노드에서 업로드할 파일 목록입니다.
다중 instance 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.

previousState

TaskState

작업의 이전 상태입니다.
Task가 초기 활성 상태이면 이 속성이 설정되지 않습니다.

previousStateTransitionTime

string

태스크가 이전 상태로 진입한 시간입니다.
Task가 초기 활성 상태이면 이 속성이 설정되지 않습니다.

requiredSlots

integer

태스크를 실행하는 데 필요한 예약 슬롯 수입니다.
기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 instance 작업의 경우 1이어야 합니다.

resourceFiles

ResourceFile[]

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다.
다중 instance 작업의 경우 리소스 파일은 주 작업이 실행되는 컴퓨팅 노드에만 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.

state

TaskState

작업의 현재 상태입니다.

stateTransitionTime

string

태스크가 현재 상태를 입력한 시간입니다.

stats

TaskStatistics

작업에 대한 리소스 사용 통계입니다.

url

string

작업의 URL입니다.

userIdentity

UserIdentity

태스크가 실행되는 사용자 ID입니다.
생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

CloudTaskListResult

작업에 작업을 나열한 결과입니다.

Name 형식 Description
odata.nextLink

string

다음 결과 집합을 가져올 URL입니다.

value

CloudTask[]

작업 목록입니다.

ComputeNodeIdentityReference

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

Name 형식 Description
resourceId

string

사용자 할당 ID의 ARM 리소스 ID입니다.

ComputeNodeInformation

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

Name 형식 Description
affinityId

string

태스크가 실행된 노드에 대한 식별자이며, 태스크를 추가할 때 이 컴퓨팅 노드에서 태스크를 예약하도록 요청할 때 전달할 수 있습니다.

nodeId

string

태스크가 실행된 컴퓨팅 노드의 ID입니다.

nodeUrl

string

태스크가 실행된 컴퓨팅 노드의 URL입니다.

poolId

string

태스크가 실행된 풀의 ID입니다.

taskRootDirectory

string

컴퓨팅 노드에 있는 작업의 루트 디렉터리입니다.

taskRootDirectoryUrl

string

컴퓨팅 노드에서 태스크의 루트 디렉터리에 대한 URL입니다.

ContainerRegistry

프라이빗 컨테이너 레지스트리.

Name 형식 Description
identityReference

ComputeNodeIdentityReference

사용자 이름 및 암호 대신 Azure Container Registry 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.

password

string

레지스트리 서버에 로그인할 암호입니다.

registryServer

string

레지스트리 URL입니다.
생략하면 기본값은 "docker.io"입니다.

username

string

레지스트리 서버에 로그인할 사용자 이름입니다.

ContainerWorkingDirectory

컨테이너 작업 디렉터리의 위치입니다.

Name 형식 Description
containerImageDefault

string

컨테이너 이미지에 정의된 작업 디렉터리를 사용합니다. 이 디렉터리에 Batch에서 다운로드한 리소스 파일이 포함되지 않도록 주의하세요.

taskWorkingDirectory

string

Batch로 채워진 작업 리소스 파일을 포함하는 표준 Batch 서비스 작업 디렉터리를 사용합니다.

DependencyAction

Batch 서비스가 이 작업에 의존하는 작업에 대해 수행하는 작업입니다.

Name 형식 Description
block

string

이 작업을 기다리는 작업을 차단하여 예약되지 않도록 합니다.

satisfy

string

이 작업을 기다리는 작업을 충족합니다. 모든 종속성이 충족되면 작업이 실행되도록 예약됩니다.

ElevationLevel

사용자의 권한 상승 수준입니다.

Name 형식 Description
admin

string

사용자는 관리자 권한이 높은 사용자이며 전체 관리자 권한으로 작동합니다.

nonadmin

string

사용자는 상승된 액세스 권한이 없는 표준 사용자입니다.

EnvironmentSetting

작업 프로세스에서 설정할 환경 변수입니다.

Name 형식 Description
name

string

환경 변수의 이름입니다.

value

string

환경 변수의 값입니다.

ErrorCategory

오류의 범주입니다.

Name 형식 Description
servererror

string

이 오류는 내부 서버 문제로 인해 발생합니다.

usererror

string

오류는 잘못된 구성과 같은 사용자 문제로 인해 발생합니다.

ErrorMessage

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

Name 형식 Description
lang

string

오류 메시지의 언어 코드

value

string

메시지의 텍스트입니다.

ExitCodeMapping

태스크가 특정 종료 코드로 종료되는 경우 Batch 서비스가 응답하는 방법입니다.

Name 형식 Description
code

integer

프로세스 종료 코드입니다.

exitOptions

ExitOptions

이 종료 코드로 태스크가 종료되는 경우 Batch 서비스가 응답하는 방식입니다.

ExitCodeRangeMapping

종료 코드 범위 및 Batch 서비스가 해당 범위 내의 종료 코드에 응답하는 방법.

Name 형식 Description
end

integer

범위의 마지막 종료 코드입니다.

exitOptions

ExitOptions

범위의 종료 코드가 있는 태스크가 종료되는 경우 Batch 서비스가 종료되는 방식(포함).

start

integer

범위의 첫 번째 종료 코드입니다.

ExitConditions

태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다.

Name 형식 Description
default

ExitOptions

다른 속성이 적용되지 않는 종료 조건으로 인해 작업이 실패할 경우 Batch 서비스가 응답하는 방식
이 값은 task가 exitCodes 또는 exitCodeRanges 컬렉션에 나열되지 않은 0이 아닌 종료 코드와 함께 종료되고 preProcessingError 속성이 없는 경우 사전 처리 오류가 발생하거나 fileUploadError 속성이 없는 경우 파일 업로드 오류가 있는 경우에 사용됩니다. 종료 코드 0에서 기본이 아닌 동작을 원하는 경우 exitCodes 또는 exitCodeRanges 컬렉션을 사용하여 명시적으로 나열해야 합니다.

exitCodeRanges

ExitCodeRangeMapping[]

작업 종료 코드 범위 목록 및 Batch 서비스가 이에 응답하는 방법.

exitCodes

ExitCodeMapping[]

개별 작업 종료 코드 목록 및 Batch 서비스가 이에 응답하는 방법

fileUploadError

ExitOptions

파일 업로드 오류가 발생하는 경우 Batch 서비스가 응답하는 방법
exitCodes 또는 exitCodeRanges를 통해 지정된 종료 코드로 태스크를 종료한 다음 파일 업로드 오류가 발생한 경우 종료 코드에서 지정한 작업이 우선합니다.

preProcessingError

ExitOptions

오류로 인해 태스크를 시작하지 못하는 경우 Batch 서비스가 응답하는 방식입니다.

ExitOptions

Batch 서비스가 특정 종료 조건에 응답하는 방법을 지정합니다.

Name 형식 Description
dependencyAction

DependencyAction

Batch 서비스가 이 작업에 의존하는 작업에 대해 수행하는 작업입니다.
가능한 값은 '만족'(종속 작업이 진행되도록 허용) 및 'block'입니다(종속 작업은 계속 대기). Batch는 종속 작업의 취소를 아직 지원하지 않습니다.

jobAction

JobAction

태스크가 지정된 종료 조건으로 완료되고 Job의 onTaskFailed 속성이 'performExitOptionsJobAction'인 경우 태스크가 포함된 작업에 대해 수행할 작업입니다.
기본값은 종료 코드 0에 대해 없음이며 다른 모든 종료 조건에 대해 종료됩니다. Job의 onTaskFailed 속성이 noaction이면 이 속성을 지정하면 오류가 반환되고 작업 추가 요청이 잘못된 속성 값 오류와 함께 실패합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

HttpHeader

HTTP 헤더 이름-값 쌍

Name 형식 Description
name

string

출력 파일을 업로드하는 동안 사용할 헤더의 대/소문자를 구분하지 않는 이름입니다.

value

string

출력 파일을 업로드하는 동안 사용할 헤더의 값입니다.

JobAction

태스크가 지정된 종료 조건으로 완료되고 Job의 onTaskFailed 속성이 'performExitOptionsJobAction'인 경우 태스크가 포함된 작업에 대해 수행할 작업입니다.

Name 형식 Description
disable

string

작업을 사용하지 않도록 설정합니다. 이는 disableTasks 값이 다시 큐에 포함된 disable Job API를 호출하는 것과 같습니다.

none

string

아무 조치도 취하지 않습니다.

terminate

string

작업을 종료합니다. 작업 실행Info의 terminateReason이 "TaskFailed"로 설정됩니다.

MultiInstanceSettings

다중 instance 작업을 실행하는 방법을 지정하는 설정입니다.

Name 형식 Description
commonResourceFiles

ResourceFile[]

조정 명령줄을 실행하기 전에 Batch 서비스에서 다운로드할 파일 목록입니다.
일반적인 리소스 파일과 작업 리소스 파일의 차이점은 주 리소스를 포함한 모든 하위 작업에 대해 일반적인 리소스 파일이 다운로드되는 반면 작업 리소스 파일은 주 리소스에 대해서만 다운로드된다는 점입니다. 또한 이러한 리소스 파일은 작업 작업 디렉터리에 다운로드되지 않고 작업 루트 디렉터리(작업 디렉터리 위의 하나의 디렉터리)에 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.

coordinationCommandLine

string

모든 컴퓨팅 노드에서 실행하여 주 노드가 기본 Task 명령을 실행할 때 이를 조정할 수 있도록 하는 명령줄입니다.
일반적인 조정 명령줄은 백그라운드 서비스를 시작하고 서비스가 노드 간 메시지를 처리할 준비가 되었다는 것을 확인합니다.

numberOfInstances

integer

작업에 필요한 컴퓨팅 노드 수입니다.
생략하면 기본값은 1입니다.

NameValuePair

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

Name 형식 Description
name

string

이름-값 쌍의 이름입니다.

value

string

이름-값 쌍의 값입니다.

OutputFile

Batch 서비스가 작업 프로세스 실행을 완료한 후 Azure Batch Compute Node에서 다른 위치로 파일을 업로드하기 위한 사양입니다.

Name 형식 Description
destination

OutputFileDestination

출력 파일의 대상입니다.

filePattern

string

업로드할 파일을 나타내는 패턴입니다.
상대 경로와 절대 경로가 모두 지원됩니다. 상대 경로는 작업 작업 디렉터리를 기준으로 합니다. 다음 와일드카드가 지원됩니다. * 는 0개 이상의 문자와 일치합니다(예: abc* 패턴은 abc 또는 abcdef와 일치함), **는 모든 디렉터리를 일치합니다. ? 는 모든 단일 문자와 일치하고[abc]는 대괄호 안에 있는 한 문자와 일치하고 [a-c]는 범위의 한 문자와 일치합니다. 대괄호는 지정되지 않은 문자와 일치하도록 부정을 포함할 수 있습니다(예: [!abc]는 a, b 또는 c를 제외한 모든 문자와 일치함). 파일 이름이 "."로 시작하는 경우 기본적으로 무시되지만 명시적으로 지정하여 일치시킬 수 있습니다(예: .gif .a.gif 일치하지 않지만.gif). 간단한 예: ***.txt '.'에서 시작되지 않고 작업 작업 디렉터리 또는 하위 디렉터리의 .txt 끝나는 파일과 일치합니다. 파일 이름에 와일드카드 문자가 포함된 경우 대괄호를 사용하여 이스케이프할 수 있습니다(예: abc[]는 abc라는 파일과 일치함). \ 및 /는 모두 Windows에서 디렉터리 구분 기호로 처리되지만 / 만 Linux에 있습니다. 환경 변수(Windows의 경우 %var% 또는 Linux의 $var)는 패턴이 적용되기 전에 확장됩니다.

uploadOptions

OutputFileUploadOptions

업로드를 수행할 조건을 포함하여 업로드 작업에 대한 추가 옵션입니다.

OutputFileBlobContainerDestination

Azure Blob Storage 컨테이너 내에서 파일 업로드 대상을 지정합니다.

Name 형식 Description
containerUrl

string

파일을 업로드할 Azure Blob Storage 내 컨테이너의 URL입니다.
관리 ID를 사용하지 않는 경우 URL에는 컨테이너에 쓰기 권한을 부여하는 SAS(공유 액세스 서명)가 포함되어야 합니다.

identityReference

ComputeNodeIdentityReference

containerUrl에서 지정한 Azure Blob Storage 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
ID에 Azure Blob Storage 컨테이너에 대한 쓰기 권한이 있어야 합니다.

path

string

Azure Storage 컨테이너 내의 대상 Blob 또는 가상 디렉터리입니다.
filePattern이 특정 파일(예: 와일드카드를 포함하지 않음)을 참조하는 경우 path는 해당 파일을 업로드할 Blob의 이름입니다. filePattern에 하나 이상의 와일드카드가 포함되어 있으면(따라서 여러 파일과 일치할 수 있음) path는 파일을 업로드할 Blob 가상 디렉터리(각 Blob 이름 앞에 추가됨)의 이름입니다. 생략하면 파일 이름이 해당 파일 이름과 일치하는 Blob 이름으로 컨테이너의 루트에 업로드됩니다.

uploadHeaders

HttpHeader[]

출력 파일 업로드에 사용할 헤더의 이름-값 쌍 목록
이러한 헤더는 Azure Storage에 파일을 업로드할 때 지정됩니다. Blob을 업로드할 때 허용되는 헤더에 대한 공식 문서: https://docs.microsoft.com/en-us/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

파일을 업로드할 대상입니다.

Name 형식 Description
container

OutputFileBlobContainerDestination

파일이 업로드되는 Azure Blob Storage의 위치입니다.

OutputFileUploadCondition

작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다.

Name 형식 Description
taskcompletion

string

종료 코드가 무엇인지에 관계없이 작업 프로세스가 종료된 후 파일을 업로드합니다.

taskfailure

string

0이 아닌 종료 코드를 사용하여 작업 프로세스가 종료된 후에만 파일을 업로드합니다.

tasksuccess

string

종료 코드가 0인 작업 프로세스가 종료된 후에만 파일을 업로드합니다.

OutputFileUploadOptions

업로드를 수행할 조건을 포함하여 출력 파일 업로드 작업에 대한 세부 정보입니다.

Name 형식 Description
uploadCondition

OutputFileUploadCondition

작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다.
기본값은 taskcompletion입니다.

ResourceFile

컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.

Name 형식 Description
autoStorageContainerName

string

자동 스토리지 계정의 스토리지 컨테이너 이름입니다.
autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다.

blobPrefix

string

Azure Storage 컨테이너에서 Blob을 다운로드할 때 사용할 Blob 접두사입니다. 이름이 지정된 접두사로 시작하는 Blob만 다운로드됩니다.
속성은 autoStorageContainerName 또는 storageContainerUrl을 사용하는 경우에만 유효합니다. 이 접두사는 부분 파일 이름 또는 하위 디렉터리일 수 있습니다. 접두사를 지정하지 않으면 컨테이너의 모든 파일이 다운로드됩니다.

fileMode

string

8진수 형식의 파일 권한 모드 특성입니다.
이 속성은 Linux 컴퓨팅 노드에 다운로드되는 파일에만 적용됩니다. Windows Compute 노드에 다운로드할 resourceFile에 대해 지정된 경우 무시됩니다. Linux 컴퓨팅 노드에 대해 이 속성을 지정하지 않으면 기본값인 0770이 파일에 적용됩니다.

filePath

string

작업의 작업 디렉터리를 기준으로 파일을 다운로드할 컴퓨팅 노드의 위치입니다.
httpUrl 속성을 지정하면 filePath가 필요하며 파일 이름을 포함하여 파일이 다운로드될 경로를 설명합니다. 그렇지 않으면 autoStorageContainerName 또는 storageContainerUrl 속성이 지정된 경우 filePath는 선택 사항이며 파일을 다운로드할 디렉터리입니다. filePath가 디렉터리로 사용되는 경우 입력 데이터와 이미 연결된 모든 디렉터리 구조가 완전히 유지되고 지정된 filePath 디렉터리에 추가됩니다. 지정된 상대 경로는 작업의 작업 디렉터리에서 분리할 수 없습니다(예: '..'을 사용).

httpUrl

string

다운로드할 파일의 URL입니다.
autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다. URL이 Azure Blob Storage 가리키는 경우 컴퓨팅 노드에서 읽을 수 있어야 합니다. Azure Storage에서 Blob에 대한 이러한 URL을 가져오는 방법에는 Blob에 대한 읽기 권한을 부여하는 SAS(공유 액세스 서명)를 포함하거나, 읽기 권한이 있는 관리 ID를 사용하거나, 공용 액세스를 허용하도록 Blob 또는 해당 컨테이너에 대한 ACL을 설정하는 세 가지 방법이 있습니다.

identityReference

ComputeNodeIdentityReference

storageContainerUrl 또는 httpUrl에서 지정한 Azure Blob Storage 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.

storageContainerUrl

string

Azure Blob Storage 내 Blob 컨테이너의 URL입니다.
autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다. 이 URL은 컴퓨팅 노드에서 읽을 수 있고 나열할 수 있어야 합니다. Azure Storage에서 컨테이너에 대한 이러한 URL을 가져오는 세 가지 방법이 있습니다. 여기에는 컨테이너에 대한 읽기 및 목록 권한을 부여하는 SAS(공유 액세스 서명)를 포함하거나, 읽기 및 목록 권한이 있는 관리 ID를 사용하거나, 공용 액세스를 허용하도록 컨테이너에 대한 ACL을 설정합니다.

TaskConstraints

작업에 적용할 실행 제약 조건입니다.

Name 형식 Description
maxTaskRetryCount

integer

작업이 다시 시도될 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다.
이 값은 특히 0이 아닌 종료 코드로 인해 작업 실행 파일에 대한 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(초기 시도 1회, 다시 시도 3회)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스는 첫 번째 시도 후에 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 함)입니다.

maxWallClockTime

string

태스크가 시작될 때까지 측정된 태스크가 실행될 수 있는 최대 경과 시간입니다. 태스크가 시간 제한 내에서 완료되지 않으면 Batch 서비스에서 종료합니다.
지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다.

retentionTime

string

실행이 완료된 시점부터 실행된 컴퓨팅 노드에서 작업 디렉터리를 유지하는 최소 시간입니다. 이 시간이 지나면 Batch 서비스에서 작업 디렉터리와 모든 내용을 삭제할 수 있습니다.
기본값은 7일입니다. 즉, 컴퓨팅 노드가 제거되거나 작업이 삭제되지 않는 한 작업 디렉터리가 7일 동안 유지됩니다.

TaskContainerExecutionInformation

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

Name 형식 Description
containerId

string

컨테이너의 ID입니다.

error

string

컨테이너에 대한 자세한 오류 정보입니다.
가능한 경우 Docker 서비스의 자세한 오류 문자열입니다. 이는 "docker inspect"에서 반환된 오류 필드와 동일합니다.

state

string

컨테이너의 상태입니다.
Docker 서비스에 따라 컨테이너의 상태입니다. 이는 "docker inspect"에서 반환되는 상태 필드와 동일합니다.

TaskContainerSettings

작업에 대한 컨테이너 설정입니다.

Name 형식 Description
containerRunOptions

string

컨테이너 만들기 명령에 대한 추가 옵션입니다.
이러한 추가 옵션은 Batch 서비스에서 제어하는 옵션 외에도 "docker create" 명령에 대한 인수로 제공됩니다.

imageName

string

작업을 실행할 컨테이너를 만드는 데 사용할 이미지입니다.
"docker pull"에 지정된 것처럼 전체 이미지 참조입니다. 이미지 이름의 일부로 태그가 제공되지 않으면 ":latest" 태그가 기본값으로 사용됩니다.

registry

ContainerRegistry

컨테이너 이미지를 포함하는 프라이빗 레지스트리입니다.
풀을 만들 때 이미 제공된 경우 이 설정을 생략할 수 있습니다.

workingDirectory

ContainerWorkingDirectory

컨테이너 작업 작업 디렉터리의 위치입니다.
기본값은 'taskWorkingDirectory'입니다.

TaskDependencies

작업의 종속성을 지정합니다. 명시적으로 지정되었거나 종속성 범위 내에 있는 모든 작업은 종속 작업이 예약되기 전에 완료되어야 합니다.

Name 형식 Description
taskIdRanges

TaskIdRange[]

이 작업이 의존하는 작업 ID 범위의 목록입니다. 종속 작업을 예약하기 전에 모든 범위의 모든 작업이 성공적으로 완료되어야 합니다.

taskIds

string[]

이 작업이 의존하는 작업 ID 목록입니다. 이 목록의 모든 작업은 종속 작업을 예약하기 전에 성공적으로 완료되어야 합니다.
taskIds 컬렉션은 총 64,000자로 제한됩니다(즉, 모든 작업 ID의 결합 길이). taskIds 컬렉션이 최대 길이를 초과하면 작업 추가 요청이 오류 코드 TaskDependencyListTooLong과 함께 실패합니다. 이 경우 작업 ID 범위를 대신 사용하는 것이 좋습니다.

TaskExecutionInformation

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

Name 형식 Description
containerInfo

TaskContainerExecutionInformation

태스크가 실행 중인 컨테이너에 대한 정보입니다.
이 속성은 태스크가 컨테이너 컨텍스트에서 실행되는 경우에만 설정됩니다.

endTime

string

작업이 완료된 시간입니다.
이 속성은 작업이 완료됨 상태인 경우에만 설정됩니다.

exitCode

integer

작업 명령줄에 지정된 프로그램의 종료 코드입니다.
이 속성은 Task가 완료된 상태인 경우에만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 규칙을 반영합니다. 종료 코드 값을 사용 하 여 코드에서 결정을 내릴 수 하는 경우 애플리케이션 프로세스에서 사용 하는 종료 코드 규칙을 알고 있다고 해야 합니다. 그러나 Batch 서비스가 작업을 종료하는 경우(시간 제한 또는 API를 통한 사용자 종료로 인해) 운영 체제 정의 종료 코드가 표시될 수 있습니다.

failureInfo

TaskFailureInformation

작업 실패(있는 경우)를 설명하는 정보입니다.
이 속성은 작업이 완료된 상태이고 오류가 발생한 경우에만 설정됩니다.

lastRequeueTime

string

사용자 요청의 결과로 Batch 서비스에서 태스크를 다시 큐에 추가한 가장 최근 시간입니다.
이 속성은 requeueCount가 0이 아닌 경우에만 설정됩니다.

lastRetryTime

string

작업의 재시도가 실행되기 시작한 가장 최근의 시간입니다.
이 요소는 Task가 다시 시도된 경우에만 존재합니다(예: retryCount가 0이 아닌 경우). 있는 경우 일반적으로 startTime과 동일하지만 재시도 이외의 이유로 작업이 다시 시작된 경우 다를 수 있습니다. 예를 들어 다시 시도하는 동안 컴퓨팅 노드가 다시 부팅된 경우 startTime은 업데이트되지만 lastRetryTime은 업데이트되지 않습니다.

requeueCount

integer

사용자 요청의 결과로 Batch 서비스에서 작업을 다시 큐에 추가한 횟수입니다.
사용자가 풀의 크기를 조정/축소하여 풀에서 컴퓨팅 노드를 제거하거나 작업을 사용하지 않도록 설정한 경우 사용자는 컴퓨팅 노드에서 실행 중인 작업을 실행하기 위해 다시 큐에 추가되도록 지정할 수 있습니다. 이 개수는 이러한 이유로 작업이 다시 큐에 포함된 횟수를 추적합니다.

result

TaskExecutionResult

작업 실행의 결과입니다.
값이 'failed'이면 failureInfo 속성에서 오류 세부 정보를 찾을 수 있습니다.

retryCount

integer

Batch 서비스에서 작업을 다시 시도한 횟수입니다.
작업 애플리케이션 오류(0이 아닌 종료 코드)가 다시 시도되고, 사전 처리 오류(작업을 실행할 수 없음) 및 파일 업로드 오류가 다시 시도되지 않습니다. Batch 서비스는 제약 조건에 지정된 제한까지 작업을 다시 시도합니다.

startTime

string

태스크가 실행되기 시작한 시간입니다.
'실행 중'은 실행 중 상태에 해당하므로 태스크에서 리소스 파일 또는 패키지를 지정하는 경우 시작 시간은 태스크가 이러한 파일을 다운로드하거나 배포하기 시작한 시간을 반영합니다. 작업이 다시 시작되거나 다시 시도된 경우 태스크가 실행되기 시작한 가장 최근의 시간입니다. 이 속성은 실행 중이거나 완료된 상태에 있는 작업에만 존재합니다.

TaskExecutionResult

작업 실행의 결과입니다.

Name 형식 Description
failure

string

작업을 처리하는 동안 오류가 발생했습니다. 태스크 프로세스가 실행 중이거나 작업 프로세스가 종료된 후 작업 프로세스가 시작되기 전에 오류가 발생했을 수 있습니다.

success

string

작업이 성공적으로 실행되었습니다.

TaskFailureInformation

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

Name 형식 Description
category

ErrorCategory

작업 오류의 범주입니다.

code

string

작업 오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

details

NameValuePair[]

오류와 관련된 추가 세부 정보 목록입니다.

message

string

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

TaskIdRange

태스크가 의존할 수 있는 작업 ID의 범위입니다. 범위의 ID가 있는 모든 작업은 종속 작업을 예약하기 전에 성공적으로 완료되어야 합니다.

Name 형식 Description
end

integer

범위의 마지막 작업 ID입니다.

start

integer

범위의 첫 번째 작업 ID입니다.

TaskState

태스크의 상태입니다.

Name 형식 Description
active

string

작업이 큐에 대기되고 실행할 수 있지만 현재 컴퓨팅 노드에 할당되지 않았습니다. 작업이 만들어지면, 사용하지 않도록 설정한 후 사용하도록 설정되거나, 실행 실패 후 재시도를 기다리는 경우 이 상태가 됩니다.

completed

string

태스크가 성공적으로 완료되었거나 작업이 성공적으로 완료되고 재시도 한도가 소진되었으므로 태스크를 더 이상 실행할 수 없습니다. 태스크를 시작하는 동안 오류가 발생했거나 작업이 종료된 경우에도 작업이 완료된 것으로 표시됩니다.

preparing

string

태스크가 컴퓨팅 노드에 할당되었지만 컴퓨팅 노드에서 필요한 작업 준비 태스크가 완료되길 기다리고 있습니다. 작업 준비 태스크가 성공하면 태스크가 실행 중으로 이동합니다. 작업 준비 태스크가 실패하면 태스크가 활성 상태로 돌아와 다른 컴퓨팅 노드에 할당될 수 있습니다.

running

string

작업이 컴퓨팅 노드에서 실행되고 있습니다. 여기에는 리소스 파일 다운로드 또는 태스크에 지정된 패키지 배포와 같은 작업 수준 준비가 포함됩니다. 반드시 작업 명령줄이 실행되기 시작했다는 의미는 아닙니다.

TaskStatistics

작업에 대한 리소스 사용 통계입니다.

Name 형식 Description
kernelCPUTime

string

태스크에서 사용하는 총 커널 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합산)입니다.

lastUpdateTime

string

통계가 마지막으로 업데이트된 시간입니다. 모든 통계는 startTime과 lastUpdateTime 사이의 범위로 제한됩니다.

readIOGiB

number

작업에서 디스크에서 읽은 총 기비바이트입니다.

readIOps

integer

작업에서 수행한 디스크 읽기 작업의 총 수입니다.

startTime

string

통계에서 다루는 시간 범위의 시작 시간입니다.

url

string

통계의 URL입니다.

userCPUTime

string

작업에서 사용하는 총 사용자 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합산)입니다.

waitTime

string

작업의 총 대기 시간입니다. 태스크 대기 시간은 작업 만들기와 작업 실행 시작 사이의 경과된 시간으로 정의됩니다. (오류로 인해 태스크를 다시 시도하는 경우 대기 시간은 가장 최근 작업 실행까지의 시간입니다.)

wallClockTime

string

작업의 총 벽 클록 시간입니다.
벽시계 시간은 태스크가 컴퓨팅 노드에서 실행되기 시작한 시점부터 완료될 때까지(또는 통계가 업데이트된 마지막 시간까지 태스크가 그때까지 완료되지 않은 경우) 경과된 시간입니다. 작업을 다시 시도하면 모든 작업 재시도의 벽시계 시간이 포함됩니다.

writeIOGiB

number

작업에서 디스크에 쓴 총 기비바이트입니다.

writeIOps

integer

작업에서 수행한 총 디스크 쓰기 작업 수입니다.

UserIdentity

작업이 실행되는 사용자 ID의 정의입니다.

Name 형식 Description
autoUser

AutoUserSpecification

작업이 실행되는 자동 사용자입니다.
userName 및 autoUser 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않아야 합니다.

username

string

작업이 실행되는 사용자 ID의 이름입니다.
userName 및 autoUser 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않아야 합니다.