Task - List

참조

서비스:: Batch Service

API 버전:: 2024-07-01.20.0

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

GET {batchUrl}/jobs/{jobId}/tasks?api-version=2024-07-01.20.0

선택적 매개 변수:

GET {batchUrl}/jobs/{jobId}/tasks?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.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://zcusa.951200.xyz/rest/api/batchservice/odata-filters-in-batch#list-tasks참조하세요.
$select	query		string	OData $select 절입니다.
maxresults	query		integer int32	응답에 반환할 최대 항목 수입니다. 최대 1,000 태스크를 반환할 수 있습니다.
timeout	query		integer int32	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 값이 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	작업 목록을 포함하는 응답입니다. 헤더 client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

200 OK

CloudTaskListResult

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

헤더

client-request-id: string
request-id: string
ETag: string
Last-Modified: string

Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

Microsoft Entra OAuth 2.0 인증 코드 흐름

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

범위

Name	Description
user_impersonation	사용자 계정 가장

Authorization

형식: apiKey
In(다음 안에): header

예제

Task list

샘플 요청

HTTP

GET account.region.batch.azure.com/jobs/jobId/tasks?api-version=2024-07-01.20.0

샘플 응답

상태 코드:: 200

{
  "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	자동 사용자에 대한 범위
AutoUserSpecification	Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
CloudTask	Azure Batch 작업입니다.
CloudTaskListResult	작업의 작업을 나열한 결과입니다.
ComputeNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
ComputeNodeInformation	태스크가 실행된 컴퓨팅 노드에 대한 정보입니다.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistry	프라이빗 컨테이너 레지스트리입니다.
ContainerWorkingDirectory	컨테이너 작업 디렉터리의 위치입니다.
DependencyAction	Batch 서비스가 이 작업에 의존하는 태스크에 대해 수행하는 작업입니다.
ElevationLevel	사용자의 권한 상승 수준입니다.
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ErrorCategory	오류의 범주입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
ExitCodeMapping	태스크가 특정 종료 코드로 종료되는 경우 Batch 서비스가 응답하는 방식입니다.
ExitCodeRangeMapping	종료 코드의 범위와 Batch 서비스가 해당 범위 내의 종료 코드에 응답하는 방법입니다.
ExitConditions	태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다.
ExitOptions	Batch 서비스가 특정 종료 조건에 응답하는 방법을 지정합니다.
HttpHeader	HTTP 헤더 이름-값 쌍
JobAction	태스크가 지정된 종료 조건으로 완료되고 작업의 onTaskFailed 속성이 'performExitOptionsJobAction'인 경우 태스크가 포함된 작업에 대해 수행할 작업입니다.
MultiInstanceSettings	다중 인스턴스 작업을 실행하는 방법을 지정하는 설정입니다.
NameValuePair	이름-값 쌍을 나타냅니다.
OutputFile	Batch 서비스가 작업 프로세스 실행을 완료한 후 Azure Batch 컴퓨팅 노드에서 다른 위치로 파일을 업로드하기 위한 사양입니다.
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 서비스 작업 집합에 대한 액세스 권한을 부여합니다. 현재 액세스 속성에 대해 지원되는 유일한 값은 'job'이며, 이 값은 작업을 포함하는 작업과 관련된 모든 작업에 대한 액세스 권한을 부여합니다.

AutoUserScope

자동 사용자에 대한 범위

Name	형식	Description
pool	string	태스크가 풀의 모든 컴퓨팅 노드에서 생성되는 공통 자동 사용자 계정으로 실행되도록 지정합니다.
task	string	서비스에서 Task에 대한 새 사용자를 만들어야 임을 지정합니다.

AutoUserSpecification

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

Name	형식	Description
elevationLevel	ElevationLevel	자동 사용자의 권한 상승 수준입니다. 기본값은 nonAdmin입니다.
scope	AutoUserScope	자동 사용자에 대한 범위 기본값은 풀입니다. 풀이 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	작업의 명령줄입니다. 다중 인스턴스 작업의 경우 기본 작업 및 모든 하위 작업이 조정 명령줄 실행을 완료한 후 명령줄이 기본 작업으로 실행됩니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://zcusa.951200.xyz/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	태스크가 다중 인스턴스 작업임을 나타내고 다중 인스턴스 작업을 실행하는 방법에 대한 정보를 포함하는 개체입니다. 다중 인스턴스 작업은 일반적으로 MPI 작업을 지원하는 데 사용됩니다. MPI의 경우 하위 작업이 실패하는 경우(예: 0이 아닌 종료 코드로 인해) 전체 다중 인스턴스 작업이 실패합니다. 그런 다음 다중 인스턴스 태스크가 종료되고 재시도 한도까지 다시 시도됩니다.
nodeInfo	ComputeNodeInformation	태스크가 실행된 컴퓨팅 노드에 대한 정보입니다.
outputFiles	OutputFile[]	명령줄을 실행한 후 Batch 서비스가 Compute 노드에서 업로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.
previousState	TaskState	작업의 이전 상태입니다. 이 속성은 작업이 초기 활성 상태이면 설정되지 않습니다.
previousStateTransitionTime	string	태스크가 이전 상태를 입력한 시간입니다. 이 속성은 작업이 초기 활성 상태이면 설정되지 않습니다.
requiredSlots	integer	태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 1이어야 합니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 리소스 파일은 주 태스크가 실행되는 컴퓨팅 노드에만 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 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입니다.

ContainerHostBatchBindMountEntry

작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.

Name	형식	Description
isReadOnly	boolean	이 원본 경로를 읽기 전용 모드로 탑재합니다. 기본값은 false(읽기/쓰기 모드)입니다. Linux의 경우 이 경로를 읽기/쓰기 모드로 탑재하는 경우 컨테이너의 모든 사용자가 경로에 대한 읽기/쓰기 액세스 권한을 가지는 것은 아니며 호스트 VM의 액세스에 따라 달라집니다. 이 경로가 읽기 전용으로 탑재된 경우 컨테이너 내의 모든 사용자가 경로를 수정할 수 없습니다.
source	ContainerHostDataPath	컨테이너 고객에게 탑재할 경로는 선택할 수 있습니다.

ContainerHostDataPath

컨테이너 태스크의 컨테이너에 탑재될 경로입니다.

Name	형식	Description
Applications	string	애플리케이션 경로입니다.
JobPrep	string	작업 준비 작업 경로입니다.
Shared	string	파일을 공유하는 다중 인스턴스 작업의 경로입니다.
Startup	string	시작 작업의 경로입니다.
Task	string	작업 경로입니다.
VfsMounts	string	경로에는 이 노드에 탑재된 모든 가상 파일 시스템이 포함됩니다.

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 서비스가 이 작업에 의존하는 태스크에 대해 수행하는 작업입니다. 가능한 값은 '만족'(종속 작업이 진행되도록 허용) 및 '차단'(종속 작업은 계속 대기)입니다. Batch는 종속 작업의 취소를 아직 지원하지 않습니다.
jobAction	JobAction	태스크가 지정된 종료 조건으로 완료되고 작업의 onTaskFailed 속성이 'performExitOptionsJobAction'인 경우 태스크가 포함된 작업에 대해 수행할 작업입니다. 기본값은 종료 코드 0에 대해 없음이며 다른 모든 종료 조건에 대해 종료됩니다. 작업의 onTaskFailed 속성이 noaction이면 이 속성을 지정하면 오류가 반환되고 작업 추가 요청이 실패하고 잘못된 속성 값 오류가 발생합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

HttpHeader

HTTP 헤더 이름-값 쌍

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

JobAction

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

Name	형식	Description
disable	string	작업을 사용하지 않도록 설정합니다. 이는 disableTasks 값이 다시 큐에 추가된 사용 안 함 작업 API를 호출하는 것과 같습니다.
none	string	아무 조치도 취하지 않습니다.
terminate	string	작업을 종료합니다. 작업의 executionInfo에서 terminateReason이 "TaskFailed"로 설정됩니다.

MultiInstanceSettings

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

Name	형식	Description
commonResourceFiles	ResourceFile[]	Batch 서비스가 조정 명령줄을 실행하기 전에 다운로드할 파일 목록입니다. 일반적인 리소스 파일과 작업 리소스 파일의 차이점은 주 리소스 파일을 포함한 모든 하위 작업에 대해 일반 리소스 파일이 다운로드되는 반면 작업 리소스 파일은 주 리소스 파일에 대해서만 다운로드된다는 점입니다. 또한 이러한 리소스 파일은 작업 작업 디렉터리에 다운로드되지 않고 작업 루트 디렉터리(작업 디렉터리 위의 디렉터리 하나)로 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
coordinationCommandLine	string	주 작업 명령을 실행할 때 모든 컴퓨팅 노드에서 실행할 명령줄입니다. 일반적인 조정 명령줄은 백그라운드 서비스를 시작하고 서비스가 노드 간 메시지를 처리할 준비가 되었다는 것을 확인합니다.
numberOfInstances	integer	작업에 필요한 컴퓨팅 노드 수입니다. 생략하면 기본값은 1입니다.

NameValuePair

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

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

OutputFile

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

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이 특정 파일(즉, 와일드카드를 포함하지 않음)을 참조하는 경우 경로는 해당 파일을 업로드할 Blob의 이름입니다. filePattern에 하나 이상의 와일드카드(따라서 여러 파일과 일치할 수 있음)가 포함된 경우 경로는 파일을 업로드할 Blob 가상 디렉터리(각 Blob 이름 앞에 추가됨)의 이름입니다. 생략하면 파일 이름이 파일 이름과 일치하는 Blob 이름으로 컨테이너의 루트에 업로드됩니다.
uploadHeaders	HttpHeader[]	출력 파일 업로드에 사용할 헤더의 이름-값 쌍 목록 이러한 헤더는 Azure Storage에 파일을 업로드할 때 지정됩니다. Blob을 업로드할 때 허용되는 헤더에 대한 공식 문서: https://zcusa.951200.xyz/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	작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다. 기본값은 작업 완성입니다.

ResourceFile

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

Name	형식	Description
autoStorageContainerName	string	자동 스토리지 계정의 스토리지 컨테이너 이름입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다.
blobPrefix	string	Azure Storage 컨테이너에서 Blob을 다운로드할 때 사용할 Blob 접두사입니다. 이름이 지정된 접두사로 시작하는 Blob만 다운로드됩니다. 이 속성은 autoStorageContainerName 또는 storageContainerUrl을 사용하는 경우에만 유효합니다. 이 접두사는 부분 파일 이름 또는 하위 디렉터리일 수 있습니다. 접두사를 지정하지 않으면 컨테이너의 모든 파일이 다운로드됩니다.
fileMode	string	8진수 형식의 파일 사용 권한 모드 특성입니다. 이 속성은 Linux 컴퓨팅 노드에 다운로드되는 파일에만 적용됩니다. Windows 컴퓨팅 노드에 다운로드할 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
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	컨테이너 작업에 탑재할 경로입니다. 이 배열이 null이거나 없는 경우 컨테이너 작업은 전체 임시 디스크 드라이브를 창에 탑재합니다(또는 Linux의 AZ_BATCH_NODE_ROOT_DIR). 이 배열이 비어 있는 것으로 설정된 경우 데이터 경로를 컨테이너에 탑재하지 않습니다.
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 컬렉션은 총 64000자로 제한됩니다(예: 모든 작업 ID의 결합된 길이). taskIds 컬렉션이 최대 길이를 초과하면 작업 추가 요청이 오류 코드 TaskDependencyListTooLong과 함께 실패합니다. 이 경우 작업 ID 범위를 대신 사용하는 것이 좋습니다.

TaskExecutionInformation

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

Name	형식	Description
containerInfo	TaskContainerExecutionInformation	태스크가 실행 중인 컨테이너에 대한 정보입니다. 이 속성은 태스크가 컨테이너 컨텍스트에서 실행되는 경우에만 설정됩니다.
endTime	string	태스크가 완료된 시간입니다. 이 속성은 작업이 완료된 상태인 경우에만 설정됩니다.
exitCode	integer	작업 명령줄에 지정된 프로그램의 종료 코드입니다. 이 속성은 작업이 완료된 상태인 경우에만 설정됩니다. 일반적으로 프로세스의 종료 코드는 해당 프로세스에 대해 애플리케이션 개발자가 구현한 특정 규칙을 반영합니다. 종료 코드 값을 사용하여 코드에서 결정을 내리는 경우 애플리케이션 프로세스에서 사용하는 종료 코드 규칙을 알고 있어야 합니다. 그러나 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	Task에서 디스크에서 읽은 총 기비바이트입니다.
readIOps	integer	Task에서 수행한 총 디스크 읽기 작업 수입니다.
startTime	string	통계에서 다루는 시간 범위의 시작 시간입니다.
url	string	통계의 URL입니다.
userCPUTime	string	작업에서 사용하는 총 사용자 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합산)입니다.
waitTime	string	작업의 총 대기 시간입니다. 태스크 대기 시간은 작업 만들기와 작업 실행 시작 사이의 경과 시간으로 정의됩니다. (오류로 인해 태스크를 다시 시도하면 대기 시간이 가장 최근 작업 실행까지의 시간입니다.)
wallClockTime	string	작업의 총 벽 시계 시간입니다. 벽시계 시간은 태스크가 컴퓨팅 노드에서 실행되기 시작한 시점부터 완료된 시점(또는 통계가 업데이트된 마지막 시간까지, 태스크가 그때까지 완료되지 않은 경우)까지 경과된 시간입니다. 작업을 다시 시도하면 모든 작업 재시도의 벽시계 시간이 포함됩니다.
writeIOGiB	number	Task에서 디스크에 쓴 총 기비바이트입니다.
writeIOps	integer	Task에서 수행한 총 디스크 쓰기 작업 수입니다.

UserIdentity

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

Name	형식	Description
autoUser	AutoUserSpecification	작업이 실행되는 자동 사용자입니다. userName 및 autoUser 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않습니다.
username	string	작업이 실행되는 사용자 ID의 이름입니다. userName 및 autoUser 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않습니다.

다음을 통해 공유

Task - List

URI 매개 변수

요청 헤더

응답

보안

azure_auth

범위

Authorization

예제

Task list

샘플 요청

샘플 응답

정의

AccessScope

AffinityInformation

ApplicationPackageReference

AuthenticationTokenSettings

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

CloudTask

CloudTaskListResult

ComputeNodeIdentityReference

ComputeNodeInformation

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistry

ContainerWorkingDirectory

DependencyAction

ElevationLevel

EnvironmentSetting

ErrorCategory

ErrorMessage

ExitCodeMapping

ExitCodeRangeMapping

ExitConditions

ExitOptions

HttpHeader

JobAction

MultiInstanceSettings

NameValuePair

OutputFile

OutputFileBlobContainerDestination

OutputFileDestination

OutputFileUploadCondition

OutputFileUploadOptions

ResourceFile

TaskConstraints

TaskContainerExecutionInformation

TaskContainerSettings

TaskDependencies

TaskExecutionInformation

TaskExecutionResult

TaskFailureInformation

TaskIdRange

TaskState

TaskStatistics

UserIdentity

추가 리소스