Tasks - Create Task

서비스:

Batch Service

API 버전:

2025-06-01

지정된 작업에 대한 작업을 생성합니다.
과제의 최대 수명은 추가부터 완료까지 180일입니다. 작업이 추가된 후 180일 이내에 완료되지 않으면 배치 서비스에 의해 종료되어 그 시점의 상태로 유지됩니다.

POST {endpoint}/jobs/{jobId}/tasks?api-version=2025-06-01

선택적 매개 변수:

POST {endpoint}/jobs/{jobId}/tasks?api-version=2025-06-01&timeOut={timeOut}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	Batch 계정 엔드포인트(예: https://batchaccount.eastus2.batch.azure.com).
jobId	path	True	string	태스크가 생성될 작업의 ID입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.
timeOut	query		integer (int32)	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 만약 값이 30보다 크면 기본값이 대신 사용됩니다."라고 말했습니다.

요청 헤더

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

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

요청 본문

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

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

응답

Name	형식	Description
201 Created		요청이 성공했고 결과적으로 새 리소스가 생성되었습니다. 헤더 DataServiceId: string 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

예제

Creates a basic task

Creates a task with container settings

Creates a task with container settings with data isolation

Creates a task with container settings with duplicate source

Creates a task with exit conditions

Creates a task with extra slot requirement

Creates a basic task

샘플 요청

HTTP

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

샘플 응답

상태 코드:

201

Creates a task with container settings

샘플 요청

HTTP

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

샘플 응답

상태 코드:

201

Creates a task with container settings with data isolation

샘플 요청

HTTP

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

샘플 응답

상태 코드:

201

Creates a task with container settings with duplicate source

샘플 요청

HTTP

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



{
  "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

Creates a task with exit conditions

샘플 요청

HTTP

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

샘플 응답

상태 코드:

201

Creates a task with extra slot requirement

샘플 요청

HTTP

POST {endpoint}/jobs/jobId/tasks?api-version=2025-06-01



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

샘플 응답

상태 코드:

201

정의

Name	Description
AuthenticationTokenSettings	태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.
AutoUserScope	AutoUserScope 열거
AutoUserSpecification	Azure Batch 작업을 실행하는 자동 사용자에 대한 옵션을 지정합니다.
BatchAccessScope	BatchAccessScope 열거
BatchAffinityInfo	Batch 서비스에서 작업을 시작할 컴퓨팅 노드를 선택하는 데 사용할 수 있는 지역성 힌트입니다.
BatchApplicationPackageReference	컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchJobActionKind	BatchJobAction 열거
BatchNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
BatchTaskConstraints	작업에 적용할 실행 제약 조건입니다.
BatchTaskContainerSettings	작업에 대한 컨테이너 설정입니다.
BatchTaskCreateOptions	Azure Batch 작업을 만들기 위한 매개 변수입니다.
BatchTaskDependencies	작업의 종속성을 지정합니다. 종속 작업이 예약되기 전에 명시적으로 지정되거나 종속성 범위 내에 있는 모든 작업이 완료되어야 합니다.
BatchTaskIdRange	범위의 시작과 끝은 포함됩니다. 예를 들어 범위가 시작 9와 끝 12이면 작업 '9', '10', '11' 및 '12'를 나타냅니다.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistryReference	프라이빗 컨테이너 레지스트리입니다.
ContainerWorkingDirectory	ContainerWorkingDirectory enums
DependencyAction	DependencyAction 열거
ElevationLevel	고도 수준 열거
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ExitCodeMapping	태스크가 특정 종료 코드로 종료되는 경우 Batch 서비스가 응답하는 방식입니다.
ExitCodeRangeMapping	종료 코드의 범위와 Batch 서비스가 해당 범위 내의 종료 코드에 응답하는 방법입니다.
ExitConditions	태스크가 완료되면 Batch 서비스가 응답하는 방법을 지정합니다.
ExitOptions	Batch 서비스가 특정 종료 조건에 응답하는 방법을 지정합니다.
MultiInstanceSettings	다중 인스턴스 작업은 일반적으로 MPI 작업을 지원하는 데 사용됩니다. MPI의 경우 하위 작업이 실패하는 경우(예: 0이 아닌 종료 코드로 인해) 전체 다중 인스턴스 작업이 실패합니다. 그런 다음 다중 인스턴스 태스크가 종료되고 재시도 한도까지 다시 시도됩니다.
OutputFile	모든 파일 업로드에서 Batch 서비스는 컴퓨팅 노드 'fileuploadout.txt' 및 'fileuploaderr.txt'에 두 개의 로그 파일을 씁니다. 이러한 로그 파일은 특정 오류에 대해 자세히 알아보는 데 사용됩니다.
OutputFileBlobContainerDestination	Azure Blob Storage 컨테이너 내에서 파일 업로드 대상을 지정합니다.
OutputFileDestination	파일을 업로드할 대상입니다.
OutputFileUploadCondition	OutputFileUploadCondition의 열거
OutputFileUploadConfig	업로드를 수행할 조건을 포함하여 출력 파일 업로드 작업에 대한 옵션입니다.
OutputFileUploadHeader	HTTP 헤더 이름-값 쌍
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다. userName 또는 autoUser 속성을 지정하지만 둘 다 지정하지는 않습니다.

AuthenticationTokenSettings

Object

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

Name	형식	Description
access	BatchAccessScope[]	토큰이 접근 권한을 부여하는 배치 자원입니다. 인증 토큰은 제한된 배치 서비스 연산 집합에 대한 접근을 부여합니다. 현재 접근 속성에 지원되는 유일한 값은 'job'으로, 이는 작업을 포함하는 작업과 관련된 모든 작업에 대한 접근 권한을 부여합니다.

AutoUserScope

열거형

AutoUserScope 열거

값	Description
task	서비스가 해당 작업에 대해 새로운 사용자를 생성하도록 명시합니다.
pool	작업이 풀 내 모든 컴퓨트 노드에서 생성되는 공통 자동 사용자 계정으로 실행되도록 지정합니다.

AutoUserSpecification

Object

Azure Batch 작업을 실행하는 자동 사용자에 대한 옵션을 지정합니다.

Name	형식	Description
elevationLevel	ElevationLevel	자동 사용자의 권한 상승 수준입니다. 기본값은 nonAdmin입니다.
scope	AutoUserScope	자동 사용자에 대한 범위입니다. 기본값은 풀입니다. 풀이 Windows를 실행하는 경우 작업 간에 더 엄격한 격리가 필요한 경우 작업 값을 지정해야 합니다. 예를 들어 작업이 다른 작업에 영향을 줄 수 있는 방식으로 레지스트리를 변경하는 경우입니다.

BatchAccessScope

열거형

BatchAccessScope 열거

값	Description
job	작업이 포함된 작업에 대해 모든 작업을 수행할 수 있는 접근 권한을 부여합니다.

BatchAffinityInfo

Object

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

Name	형식	Description
affinityId	string	이전에 실행된 컴퓨트 노드 또는 작업의 위치를 나타내는 불투명 문자열입니다. 어떤 노드의 affinityId를 전달하여 이 작업이 해당 컴퓨트 노드에서 실행되어야 함을 나타낼 수 있습니다. 이것은 단지 부드러운 선호도입니다. 작업이 예약될 때 대상 컴퓨팅 노드가 사용 중이거나 사용할 수 없는 경우 작업은 다른 곳에서 예약됩니다.

BatchApplicationPackageReference

Object

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

Name	형식	Description
applicationId	string	배포할 애플리케이션의 ID입니다. 풀을 만들 때 패키지의 애플리케이션 ID는 정규화되어야 합니다(/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}).
version	string	배포할 애플리케이션의 버전입니다. 생략하면 기본 버전이 배포됩니다. 풀에서 이 기능이 생략되고 이 애플리케이션에 대한 기본 버전이 지정되지 않으면, 요청은 InvalidApplicationPackageReferences와 HTTP 상태 코드 409로 오류 코드가 발생하며 실패합니다. 만약 이 기능이 태스크에서 누락되어 있고 해당 애플리케이션에 대한 기본 버전이 지정되어 있지 않으면, 작업은 전처리 오류로 실패합니다.

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

BatchJobActionKind

열거형

BatchJobAction 열거

값	Description
none	아무 작업도 수행하지 않습니다.
disable	일을 비활성화하세요. 이는 disableTasks 값을 requeue로 사용하여 disable Job API를 호출하는 것과 같습니다.
terminate	일자리를 해고하세요. 작업 실행 정보의 terminationReason은 "TaskFailed"로 설정되어 있습니다.

BatchNodeIdentityReference

Object

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

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

BatchTaskConstraints

Object

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

Name	형식	Description
maxTaskRetryCount	integer (int32)	작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 0이 아닌 종료 코드로 인해 작업 실행 파일의 재시도 횟수를 특별히 제어한다는 점에 유의하세요. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이라면, 배치 서비스는 첫 번째 시도 이후에는 작업을 재시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 됨)입니다.
maxWallClockTime	string (duration)	작업이 시작된 시점부터 측정한 최대 경과 시간입니다. 작업이 시간 내에 완료되지 않으면 배치 서비스가 종료합니다. 이 부분이 명시되지 않으면, 작업이 진행될 수 있는 시간 제한이 없습니다.
retentionTime	string (duration)	실행 완료 시점부터 실행 중인 컴퓨트 노드에서 작업 디렉터리를 유지하는 최소 시간입니다. 이 시간 이후에는 배치 서비스가 작업 디렉터리와 그 모든 내용을 삭제할 수 있습니다. 기본값은 7일로, Compute Node가 제거되거나 작업이 삭제되지 않는 한 작업 디렉터리는 7일간 유지됩니다.

BatchTaskContainerSettings

Object

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

Name	형식	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	컨테이너 작업에 탑재할 경로입니다. 이 배열이 null이거나 없는 경우 컨테이너 작업은 전체 임시 디스크 드라이브를 창에 탑재합니다(또는 Linux의 AZ_BATCH_NODE_ROOT_DIR). 이 배열이 비어 있는 것으로 설정된 경우 데이터 경로를 컨테이너에 탑재하지 않습니다.
containerRunOptions	string	컨테이너 만들기 명령에 대한 추가 옵션입니다. 이러한 추가 옵션은 Batch 서비스에서 제어하는 옵션 외에도 "docker create" 명령에 대한 인수로 제공됩니다.
imageName	string	Task가 실행될 컨테이너를 생성하는 데 사용할 이미지입니다. 이것이 "docker pull"에 명시된 전체 이미지 참조입니다. 이미지 이름에 태그가 제공되지 않은 경우, 기본값으로 ":latest" 태그가 사용됩니다.
registry	ContainerRegistryReference	컨테이너 이미지를 포함하는 개인 레지스트리입니다. 이 설정은 풀 생성 시 이미 제공되어 있다면 생략할 수 있습니다.
workingDirectory	ContainerWorkingDirectory	컨테이너 작업 작업 디렉터리의 위치입니다. 기본값은 'taskWorkingDirectory'입니다.

BatchTaskCreateOptions

Object

Azure Batch 작업을 만들기 위한 매개 변수입니다.

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

BatchTaskDependencies

Object

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

Name	형식	Description
taskIdRanges	BatchTaskIdRange[]	이 작업이 의존하는 작업 ID 범위 목록입니다. 모든 범위의 모든 작업이 성공적으로 완료되어야 의존 작업이 스케줄링될 수 있습니다.
taskIds	string[]	이 작업이 의존하는 작업 ID 목록입니다. 이 목록의 모든 작업이 성공적으로 완료되어야 의존 작업이 예약될 수 있습니다. taskIds 컬렉션은 총 64,000자(즉, 모든 작업 ID의 합산 길이)로 제한됩니다. taskIds 컬렉션이 최대 길이를 초과하면 Task 추가 요청이 실패하며 오류 코드 TaskDependencyListTooLong이 발생합니다. 이 경우 작업 ID 범위를 사용하는 것을 고려해 보세요.

BatchTaskIdRange

Object

범위의 시작과 끝은 포함됩니다. 예를 들어 범위가 시작 9와 끝 12이면 작업 '9', '10', '11' 및 '12'를 나타냅니다.

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

ContainerHostBatchBindMountEntry

Object

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

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

ContainerHostDataPath

열거형

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

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

ContainerRegistryReference

Object

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

Name	형식	Description
identityReference	BatchNodeIdentityReference	사용자 이름 및 암호 대신 Azure Container Registry에 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
password	string (password)	레지스트리 서버에 로그인할 암호입니다.
registryServer	string (uri)	레지스트리 URL입니다. 생략하면 기본값은 "docker.io"입니다.
username	string	레지스트리 서버에 로그인할 사용자 이름입니다.

ContainerWorkingDirectory

열거형

ContainerWorkingDirectory enums

값	Description
taskWorkingDirectory	표준 배치 서비스 작업 작업 디렉터리를 사용하세요. 이 디렉터리에는 배치가 채워진 작업 자원 파일을 포함할 것입니다.
containerImageDefault	컨테이너 이미지에 정의된 작업 디렉터리를 사용하세요. 이 디렉터리에는 배치가 다운로드한 자원 파일이 포함되지 않을 수 있으니 주의하세요.

DependencyAction

열거형

DependencyAction 열거

값	Description
satisfy	이 작업을 기다리고 있는 작업을 만족시키고; 모든 의존성이 충족되면 작업이 실행되도록 스케줄링됩니다.
block	이 작업을 대기 중으로 차단하여 일정에 맞춰지지 못하게 합니다.

ElevationLevel

열거형

고도 수준 열거

값	Description
nonadmin	사용자는 상승된 액세스 권한이 없는 표준 사용자입니다.
admin	사용자는 상승된 액세스 권한을 가진 사용자이며 전체 관리자 권한으로 작동합니다.

EnvironmentSetting

Object

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

Name	형식	Description
name	string	환경 변수의 이름입니다.
value	string	환경 변수의 값입니다.

ExitCodeMapping

Object

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

Name	형식	Description
code	integer (int32)	프로세스 종료 코드입니다.
exitOptions	ExitOptions	작업이 이 종료 코드로 종료될 때 배치 서비스가 어떻게 반응해야 하는지에 대한 질문입니다.

ExitCodeRangeMapping

Object

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

Name	형식	Description
end	integer (int32)	범위 내 마지막 출구 코드.
exitOptions	ExitOptions	작업이 시작 후 종료 범위(포함) 범위 내에서 종료 코드가 있을 때 배치 서비스가 어떻게 반응해야 하는지에 대해 말입니다.
start	integer (int32)	범위 내 첫 번째 출구 코드입니다.

ExitConditions

Object

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

Name	형식	Description
default	ExitOptions	작업이 종료 조건으로 실패할 때 배치 서비스가 어떻게 반응해야 하는지에 대한 질문입니다. 이 값은 작업이 exitCodes 또는 exitCodeRanges 컬렉션에 나열되지 않은 0이 아닌 종료 코드가 있을 때 사용되며, preProcessingError 속성이 없으면 전처리 오류가 발생하며, fileUploadError 속성이 없으면 파일 업로드 오류가 발생할 때 사용됩니다. 출구 코드 0에 비기본 동작을 원한다면, exitCodes 또는 exitCodeRanges 컬렉션을 사용해 명시적으로 명시해야 합니다.
exitCodeRanges	ExitCodeRangeMapping[]	작업 종료 코드 범위와 배치 서비스가 이에 어떻게 반응해야 하는지 목록입니다.
exitCodes	ExitCodeMapping[]	개별 작업 종료 코드 목록과 배치 서비스가 이에 어떻게 반응해야 하는지에 대한 설명입니다.
fileUploadError	ExitOptions	파일 업로드 오류가 발생했을 때 배치 서비스가 어떻게 대응해야 하는지에 대한 설명입니다. 작업이 exitCodes 또는 exitCodeRanges를 통해 지정한 종료 코드로 종료되었고, 이후 파일 업로드 오류가 발생하면, 종료 코드로 지정된 작업이 우선권을 가집니다.
preProcessingError	ExitOptions	작업이 오류로 시작되지 않을 때 배치 서비스가 어떻게 반응해야 하는지에 대한 질문입니다.

ExitOptions

Object

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

Name	형식	Description
dependencyAction	DependencyAction	배치 서비스가 이 작업에 의존하는 작업에 대해 수행하는 동작입니다. 가능한 값은 'satisfy'(의존 작업 진행 허용)와 'block'(의존 작업 계속 대기)입니다. 배치는 아직 의존 작업 취소를 지원하지 않습니다.
jobAction	BatchJobActionKind	작업이 완료된 종료 조건과 작업의 onTaskFailed 속성이 'performExitOptionsJobAction'일 때 수행할 수 있는 액션입니다. 기본 설정은 출구 코드 0에 대해 '없음'이며, 다른 모든 출구 조건에서는 종료됩니다. 작업의 onTaskFailed 속성이 noaction이라면, 이 속성을 지정하면 오류가 발생하고 add Task 요청이 잘못된 속성 값 오류와 함께 실패합니다; REST API를 직접 호출할 경우 HTTP 상태 코드는 400(Bad Request)입니다.

MultiInstanceSettings

Object

다중 인스턴스 작업은 일반적으로 MPI 작업을 지원하는 데 사용됩니다. MPI의 경우 하위 작업이 실패하는 경우(예: 0이 아닌 종료 코드로 인해) 전체 다중 인스턴스 작업이 실패합니다. 그런 다음 다중 인스턴스 태스크가 종료되고 재시도 한도까지 다시 시도됩니다.

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

OutputFile

Object

모든 파일 업로드에서 Batch 서비스는 컴퓨팅 노드 'fileuploadout.txt' 및 'fileuploaderr.txt'에 두 개의 로그 파일을 씁니다. 이러한 로그 파일은 특정 오류에 대해 자세히 알아보는 데 사용됩니다.

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	OutputFileUploadConfig	업로드 작업을 위한 추가 옵션, 어떤 조건에서 업로드를 수행할지에 대한 등.

OutputFileBlobContainerDestination

Object

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

Name	형식	Description
containerUrl	string (uri)	파일을 업로드할 수 있는 Azure Blob Storage 내 컨테이너의 URL. 관리 신원을 사용하지 않는 경우, URL에 컨테이너에 쓰기 권한을 부여하는 공유 접근 서명(SAS)이 포함되어야 합니다.
identityReference	BatchNodeIdentityReference	containerUrl이 지정한 Azure Blob 저장소에 접근하기 위해 사용하는 사용자 지정 아이덴티티에 대한 참조입니다. 신원은 Azure Blob Storage 컨테이너에 쓰기 권한이 있어야 합니다.
path	string	Azure Storage 컨테이너 내의 목적지 블롭 또는 가상 디렉터리입니다. filePattern이 특정 파일(즉, 와일드카드가 없는 파일)을 가리킨다면, path는 해당 파일을 업로드할 blob의 이름입니다. filePattern에 하나 이상의 와일드카드가 포함되어 있을 경우(따라서 여러 파일이 일치할 수 있음), path는 파일을 업로드할 수 있는 블롭 가상 디렉터리(각 블롭 이름 앞에 붙음)의 이름입니다. 생략할 경우, 파일들은 파일 이름과 일치하는 블롭 이름으로 컨테이너의 루트에 업로드됩니다.
uploadHeaders	OutputFileUploadHeader[]	출력 파일 업로드에 사용되는 헤더의 이름-값 쌍 목록입니다. 이 헤더들은 Azure 스토리지에 파일을 업로드할 때 지정됩니다. 블롭 업로드 시 허용되는 헤더에 관한 공식 문서: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types.

OutputFileDestination

Object

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

Name	형식	Description
container	OutputFileBlobContainerDestination	파일이 업로드되는 Azure 블롭 저장소 내 위치입니다.

OutputFileUploadCondition

열거형

OutputFileUploadCondition의 열거

값	Description
tasksuccess	작업 프로세스가 종료된 후에만 종료 코드가 0인 파일(들)을 업로드하세요.
taskfailure	작업 프로세스가 종료된 후에만 파일을 업로드하세요. 종료 코드는 0이 아닌 상태입니다.
taskcompletion	작업 프로세스가 종료된 후에, 종료 코드가 무엇이든 파일을 업로드하세요.

OutputFileUploadConfig

Object

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

Name	형식	Description
uploadCondition	OutputFileUploadCondition	작업 출력 파일 또는 파일 집합이 업로드되어야 하는 조건들. 기본값은 작업 완료입니다.

OutputFileUploadHeader

Object

HTTP 헤더 이름-값 쌍

Name	형식	Description
name	string	출력 파일을 업로드할 때 사용할 헤더의 대문자 구분 이름입니다.
value	string	출력 파일을 업로드할 때 사용할 헤더의 값입니다.

ResourceFile

Object

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

Name	형식	Description
autoStorageContainerName	string	자동 저장 계정의 저장 컨테이너 이름입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다.
blobPrefix	string	Azure Storage 컨테이너에서 Blob을 다운로드할 때 사용할 Blob 접두사입니다. 이름이 지정된 접두사로 시작하는 Blob만 다운로드됩니다. 이 속성은 autoStorageContainerName 또는 storageContainerUrl을 사용하는 경우에만 유효합니다. 이 접두사는 부분 파일 이름 또는 하위 디렉터리일 수 있습니다. 접두사를 지정하지 않으면 컨테이너의 모든 파일이 다운로드됩니다.
fileMode	string	8진수 형식의 파일 사용 권한 모드 특성입니다. 이 속성은 Linux Compute Nodes에 다운로드되는 파일에만 적용됩니다. 리소스파일이 Windows 컴퓨트 노드에 다운로드되는 경우에는 무시됩니다. 이 속성이 Linux 컴퓨트 노드에 명시되어 있지 않으면, 파일에 기본값 0770이 적용됩니다.
filePath	string	작업을 수행하는 디렉터리에 대해 파일을 다운로드할 컴퓨트 노드의 위치입니다. httpUrl 속성을 지정하면 filePath가 필요하며 파일 이름을 포함하여 파일을 다운로드할 경로를 설명합니다. 그렇지 않으면 autoStorageContainerName 또는 storageContainerUrl 속성이 지정된 경우 filePath는 선택 사항이며 파일을 다운로드할 디렉터리입니다. filePath가 디렉터리로 사용되는 경우 입력 데이터와 이미 연결된 모든 디렉터리 구조가 전체로 유지되고 지정된 filePath 디렉터리에 추가됩니다. 지정된 상대 경로는 작업의 작업 디렉터리를 벗어날 수 없습니다(예: '..' 사용).
httpUrl	string (uri)	다운로드할 파일의 URL입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다. URL이 Azure Blob Storage를 가리키는 경우 컴퓨팅 노드에서 읽을 수 있어야 합니다. Azure Storage에서 Blob에 대한 이러한 URL을 가져오는 세 가지 방법이 있습니다. Blob에 대한 읽기 권한을 부여하는 SAS(공유 액세스 서명)를 포함하거나, 읽기 권한이 있는 관리 ID를 사용하거나, 공용 액세스를 허용하도록 Blob 또는 해당 컨테이너에 대한 ACL을 설정합니다.
identityReference	BatchNodeIdentityReference	storageContainerUrl 또는 httpUrl로 지정한 Azure Blob 저장소에 접근하기 위해 사용하는 사용자 지정 신원에 대한 참조입니다.
storageContainerUrl	string (uri)	Azure Blob Storage 내 Blob 컨테이너의 URL입니다. autoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 상호 배타적이며 그 중 하나를 지정해야 합니다. 이 URL은 컴퓨팅 노드에서 읽을 수 있고 나열할 수 있어야 합니다. Azure Storage에서 컨테이너에 대한 이러한 URL을 가져오는 세 가지 방법이 있습니다. 컨테이너에 대한 읽기 및 목록 권한을 부여하는 SAS(공유 액세스 서명)를 포함하거나, 읽기 및 목록 권한이 있는 관리 ID를 사용하거나, 공용 액세스를 허용하도록 컨테이너에 대한 ACL을 설정합니다.

UserIdentity

Object

작업이 실행되는 사용자 ID의 정의입니다. userName 또는 autoUser 속성을 지정하지만 둘 다 지정하지는 않습니다.

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