Task - Add

참조

서비스:: Batch Service

API 버전:: 2024-07-01.20.0

지정된 작업에 작업을 추가합니다.
완료까지 작업의 최대 수명은 180일입니다. 작업이 추가된 후 180일 이내에 완료되지 않은 경우 Batch 서비스에 의해 종료되고 해당 시점에 있던 상태로 남게 됩니다.

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

선택적 매개 변수:

POST {batchUrl}/jobs/{jobId}/tasks?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 버전입니다.
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를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name	필수	형식	Description
commandLine	True	string	작업의 명령줄입니다. 다중 인스턴스 작업의 경우 기본 작업 및 모든 하위 작업이 조정 명령줄 실행을 완료한 후 명령줄이 기본 작업으로 실행됩니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
id	True	string	작업 내에서 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않으며 대/소문자를 구분하지 않습니다. 즉, 대/소문자만 다른 작업 내에 두 개의 ID가 없을 수 있습니다.
affinityInfo		AffinityInformation	Batch 서비스에서 새 작업을 시작할 컴퓨팅 노드를 선택하는 데 사용할 수 있는 지역성 힌트입니다.
applicationPackageReferences		ApplicationPackageReference[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 배포할 패키지 목록입니다. 애플리케이션 패키지는 작업 디렉터리가 아닌 공유 디렉터리에 다운로드되고 배포됩니다. 따라서 참조된 패키지가 노드에 이미 있고 최신 상태이면 다시 다운로드되지 않습니다. 컴퓨팅 노드의 기존 복사본이 사용됩니다. 예를 들어 패키지가 삭제되었거나 다운로드에 실패하여 참조된 패키지를 설치할 수 없는 경우 작업이 실패합니다.
authenticationTokenSettings		AuthenticationTokenSettings	태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다. 이 속성이 설정된 경우 Batch 서비스는 계정 액세스 키를 요구하지 않고 Batch 서비스 작업을 인증하는 데 사용할 수 있는 인증 토큰을 Task에 제공합니다. 토큰은 AZ_BATCH_AUTHENTICATION_TOKEN 환경 변수를 통해 제공됩니다. 태스크가 토큰을 사용하여 수행할 수 있는 작업은 설정에 따라 달라집니다. 예를 들어 태스크는 작업에 다른 작업을 추가하거나 작업 또는 작업 아래의 다른 작업의 상태를 확인하기 위해 작업 권한을 요청할 수 있습니다.
constraints		TaskConstraints	이 작업에 적용되는 실행 제약 조건입니다. 제약 조건을 지정하지 않으면 maxTaskRetryCount는 작업에 지정된 maxTaskRetryCount이고 maxWallClockTime은 무한하며 retentionTime은 7일입니다.
containerSettings		TaskContainerSettings	태스크가 실행되는 컨테이너에 대한 설정입니다. 이 작업을 실행할 풀에 containerConfiguration 집합이 있는 경우 이 설정도 설정해야 합니다. 이 작업을 실행할 풀에 containerConfiguration이 설정되어 있지 않으면 설정하면 안 됩니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
dependsOn		TaskDependencies	이 태스크가 사용하는 작업입니다. 이 작업은 의존하는 모든 작업이 성공적으로 완료될 때까지 예약되지 않습니다. 이러한 작업이 실패하고 재시도 횟수가 소진되는 경우 이 작업은 예약되지 않습니다. Job에 usesTaskDependencies가 true로 설정되어 있지 않고 이 요소가 있으면 오류 코드 TaskDependenciesNotSpecifiedOnJob과 함께 요청이 실패합니다.
displayName		string	작업의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
environmentSettings		EnvironmentSetting[]	작업에 대한 환경 변수 설정 목록입니다.
exitConditions		ExitConditions	태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다. 태스크가 완료되면 Batch 서비스가 응답하는 방식입니다.
multiInstanceSettings		MultiInstanceSettings	태스크가 다중 인스턴스 작업임을 나타내고 다중 인스턴스 작업을 실행하는 방법에 대한 정보를 포함하는 개체입니다. 다중 인스턴스 작업은 일반적으로 MPI 작업을 지원하는 데 사용됩니다. MPI의 경우 하위 작업이 실패하는 경우(예: 0이 아닌 종료 코드로 인해) 전체 다중 인스턴스 작업이 실패합니다. 그런 다음 다중 인스턴스 태스크가 종료되고 재시도 한도까지 다시 시도됩니다.
outputFiles		OutputFile[]	명령줄을 실행한 후 Batch 서비스가 Compute 노드에서 업로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.
requiredSlots		integer	태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 1이어야 합니다.
resourceFiles		ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 리소스 파일은 주 태스크가 실행되는 컴퓨팅 노드에만 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
userIdentity		UserIdentity	태스크가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

응답

Name	형식	Description
201 Created		Batch 서비스에 대한 요청이 성공했습니다. 헤더 client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

201 Created

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

헤더

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

예제

Add a basic task

Add a container task with container data isolation

Add a container task with container data isolation bad request duplicate sources

Add a task with container settings

Add a task with exit conditions

Add a task with extra slot requirement

Add a basic task

샘플 요청

HTTP

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



{
  "id": "task1",
  "commandLine": "cmd /c echo task1"
}

샘플 응답

상태 코드:: 201

Add a container task with container data isolation

샘플 요청

HTTP

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



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerHostBatchBindMounts": [
      {
        "source": "Task",
        "isReadOnly": true
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

샘플 응답

상태 코드:: 201

Add a container task with container data isolation bad request duplicate sources

샘플 요청

HTTP

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



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerHostBatchBindMounts": [
      {
        "source": "Task",
        "isReadOnly": true
      },
      {
        "source": "Task",
        "isReadOnly": true
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

샘플 응답

상태 코드:: 201

Add a task with container settings

샘플 요청

HTTP

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



{
  "id": "taskId",
  "commandLine": "bash -c 'echo hello'",
  "containerSettings": {
    "imageName": "ubuntu",
    "containerRunOptions": "--rm"
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

샘플 응답

상태 코드:: 201

Add a task with exit conditions

샘플 요청

HTTP

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



{
  "id": "taskId",
  "commandLine": "cmd /c exit 3",
  "exitConditions": {
    "exitCodeRanges": [
      {
        "start": 2,
        "end": 4,
        "exitOptions": {
          "jobAction": "terminate"
        }
      }
    ]
  },
  "userIdentity": {
    "autoUser": {
      "scope": "task",
      "elevationLevel": "nonadmin"
    }
  }
}

샘플 응답

상태 코드:: 201

Add a task with extra slot requirement

샘플 요청

HTTP

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



{
  "id": "task1",
  "requiredSlots": 2,
  "commandLine": "cmd /c echo task1"
}

샘플 응답

상태 코드:: 201

정의

Name	Description
AccessScope	토큰이 액세스 권한을 부여하는 Batch 리소스입니다.
AffinityInformation	Batch 서비스에서 작업을 시작할 컴퓨팅 노드를 선택하는 데 사용할 수 있는 지역성 힌트입니다.
ApplicationPackageReference	컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.
AuthenticationTokenSettings	태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.
AutoUserScope	자동 사용자에 대한 범위
AutoUserSpecification	Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
ComputeNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistry	프라이빗 컨테이너 레지스트리입니다.
ContainerWorkingDirectory	컨테이너 작업 디렉터리의 위치입니다.
DependencyAction	Batch 서비스가 이 작업에 의존하는 태스크에 대해 수행하는 작업입니다.
ElevationLevel	사용자의 권한 상승 수준입니다.
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
ExitCodeMapping	태스크가 특정 종료 코드로 종료되는 경우 Batch 서비스가 응답하는 방식입니다.
ExitCodeRangeMapping	종료 코드의 범위와 Batch 서비스가 해당 범위 내의 종료 코드에 응답하는 방법입니다.
ExitConditions	태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다.
ExitOptions	Batch 서비스가 특정 종료 조건에 응답하는 방법을 지정합니다.
HttpHeader	HTTP 헤더 이름-값 쌍
JobAction	태스크가 지정된 종료 조건으로 완료되고 작업의 onTaskFailed 속성이 'performExitOptionsJobAction'인 경우 태스크가 포함된 작업에 대해 수행할 작업입니다.
MultiInstanceSettings	다중 인스턴스 작업을 실행하는 방법을 지정하는 설정입니다.
OutputFile	Batch 서비스가 작업 프로세스 실행을 완료한 후 Azure Batch 컴퓨팅 노드에서 다른 위치로 파일을 업로드하기 위한 사양입니다.
OutputFileBlobContainerDestination	Azure Blob Storage 컨테이너 내에서 파일 업로드 대상을 지정합니다.
OutputFileDestination	파일을 업로드할 대상입니다.
OutputFileUploadCondition	작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다.
OutputFileUploadOptions	업로드를 수행할 조건을 포함하여 출력 파일 업로드 작업에 대한 세부 정보입니다.
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
TaskAddParameter	추가할 Azure Batch 작업입니다.
TaskConstraints	작업에 적용할 실행 제약 조건입니다.
TaskContainerSettings	작업에 대한 컨테이너 설정입니다.
TaskDependencies	작업의 종속성을 지정합니다. 종속 작업이 예약되기 전에 명시적으로 지정되거나 종속성 범위 내에 있는 모든 작업이 완료되어야 합니다.
TaskIdRange	태스크가 의존할 수 있는 작업 ID의 범위입니다. 범위에 ID가 있는 모든 작업은 종속 작업을 예약하기 전에 완료해야 합니다.
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	오류 응답에 포함된 추가 정보입니다.

ComputeNodeIdentityReference

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

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

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	환경 변수의 값입니다.

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입니다.

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://docs.microsoft.com/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을 설정합니다.

TaskAddParameter

추가할 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://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
constraints	TaskConstraints	이 작업에 적용되는 실행 제약 조건입니다. 제약 조건을 지정하지 않으면 maxTaskRetryCount는 작업에 지정된 maxTaskRetryCount이고 maxWallClockTime은 무한하며 retentionTime은 7일입니다.
containerSettings	TaskContainerSettings	태스크가 실행되는 컨테이너에 대한 설정입니다. 이 작업을 실행할 풀에 containerConfiguration 집합이 있는 경우 이 설정도 설정해야 합니다. 이 작업을 실행할 풀에 containerConfiguration이 설정되어 있지 않으면 설정하면 안 됩니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
dependsOn	TaskDependencies	이 태스크가 사용하는 작업입니다. 이 작업은 의존하는 모든 작업이 성공적으로 완료될 때까지 예약되지 않습니다. 이러한 작업이 실패하고 재시도 횟수가 소진되는 경우 이 작업은 예약되지 않습니다. Job에 usesTaskDependencies가 true로 설정되어 있지 않고 이 요소가 있으면 오류 코드 TaskDependenciesNotSpecifiedOnJob과 함께 요청이 실패합니다.
displayName	string	작업의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
environmentSettings	EnvironmentSetting[]	작업에 대한 환경 변수 설정 목록입니다.
exitConditions	ExitConditions	태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다. 태스크가 완료되면 Batch 서비스가 응답하는 방식입니다.
id	string	작업 내에서 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않으며 대/소문자를 구분하지 않습니다. 즉, 대/소문자만 다른 작업 내에 두 개의 ID가 없을 수 있습니다.
multiInstanceSettings	MultiInstanceSettings	태스크가 다중 인스턴스 작업임을 나타내고 다중 인스턴스 작업을 실행하는 방법에 대한 정보를 포함하는 개체입니다. 다중 인스턴스 작업은 일반적으로 MPI 작업을 지원하는 데 사용됩니다. MPI의 경우 하위 작업이 실패하는 경우(예: 0이 아닌 종료 코드로 인해) 전체 다중 인스턴스 작업이 실패합니다. 그런 다음 다중 인스턴스 태스크가 종료되고 재시도 한도까지 다시 시도됩니다.
outputFiles	OutputFile[]	명령줄을 실행한 후 Batch 서비스가 Compute 노드에서 업로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.
requiredSlots	integer	태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 1이어야 합니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 리소스 파일은 주 태스크가 실행되는 컴퓨팅 노드에만 다운로드됩니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
userIdentity	UserIdentity	태스크가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

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일 동안 유지됩니다.

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 범위를 대신 사용하는 것이 좋습니다.

TaskIdRange

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

Name	형식	Description
end	integer	범위의 마지막 작업 ID입니다.
start	integer	범위의 첫 번째 작업 ID입니다.

UserIdentity

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

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

다음을 통해 공유

Task - Add

URI 매개 변수

요청 헤더

요청 본문

응답

보안

azure_auth

범위

Authorization

예제

Add a basic task

샘플 요청

샘플 응답

Add a container task with container data isolation

샘플 요청

샘플 응답

Add a container task with container data isolation bad request duplicate sources

샘플 요청

샘플 응답

Add a task with container settings

샘플 요청

샘플 응답

Add a task with exit conditions

샘플 요청

샘플 응답

Add a task with extra slot requirement

샘플 요청

샘플 응답

정의

AccessScope

AffinityInformation

ApplicationPackageReference

AuthenticationTokenSettings

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

ComputeNodeIdentityReference

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistry

ContainerWorkingDirectory

DependencyAction

ElevationLevel

EnvironmentSetting

ErrorMessage

ExitCodeMapping

ExitCodeRangeMapping

ExitConditions

ExitOptions

HttpHeader

JobAction

MultiInstanceSettings

OutputFile

OutputFileBlobContainerDestination

OutputFileDestination

OutputFileUploadCondition

OutputFileUploadOptions

ResourceFile

TaskAddParameter

TaskConstraints

TaskContainerSettings

TaskDependencies

TaskIdRange

UserIdentity

추가 리소스