Pool - Patch

Service:

Batch Service

API Version:

2023-11-01.18.0

지정된 풀의 속성을 업데이트.
요청에 지정된 풀 속성만 바꿉니다. 예를 들어 풀에 연결된 StartTask가 있고 요청이 StartTask 요소를 지정하지 않는 경우 Pool은 기존 StartTask를 유지합니다.

PATCH {batchUrl}/pools/{poolId}?api-version=2023-11-01.18.0

With optional parameters:

PATCH {batchUrl}/pools/{poolId}?timeout={timeout}&api-version=2023-11-01.18.0

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
poolId	path	True	string	업데이트할 풀의 ID입니다.
api-version	query	True	string	클라이언트 API 버전.
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를 직접 호출하는 경우 명시적으로 설정합니다.
If-Match		string	클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확히 일치하는 경우에만 수행됩니다.
If-None-Match		string	클라이언트에 알려진 리소스의 버전과 연결된 ETag 값입니다. 이 작업은 서비스에서 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치하지 않는 경우에만 수행됩니다.
If-Modified-Since		string date-time-rfc1123	클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정된 경우에만 작업이 수행됩니다.
If-Unmodified-Since		string date-time-rfc1123	클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.

요청 본문

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

Name	형식	Description
applicationPackageReferences	ApplicationPackageReference[]	풀의 각 컴퓨팅 노드에 설치할 패키지 목록입니다. 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅되거나 이미지로 다시 설치될 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 이 요소가 있으면 기존 패키지 참조를 대체합니다. 빈 컬렉션을 지정하면 모든 패키지 참조가 풀에서 제거됩니다. 생략하면 기존 패키지 참조는 변경되지 않은 상태로 유지됩니다.
certificateReferences	CertificateReference[]	풀의 각 컴퓨팅 노드에 설치할 인증서 목록입니다. 이 요소가 있는 경우 풀에 구성된 기존 인증서 참조를 대체합니다. 생략하면 기존 인증서 참조는 변경되지 않은 상태로 유지됩니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 환경 변수 AZ_BATCH_CERTIFICATES_DIR 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.
metadata	MetadataItem[]	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다. 이 요소가 있는 경우 풀에 구성된 기존 메타데이터를 대체합니다. 빈 컬렉션을 지정하면 풀에서 메타데이터가 제거됩니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다.
startTask	StartTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행할 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다. 이 요소가 있으면 기존 StartTask를 덮어씁니다. 생략하면 기존 StartTask는 변경되지 않은 상태로 유지됩니다.
targetNodeCommunicationMode	NodeCommunicationMode	풀에 대해 원하는 노드 통신 모드입니다. 이 요소가 있는 경우 풀에 구성된 기존 targetNodeCommunicationMode를 대체합니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다.

응답

Name	형식	Description
200 OK		Batch 서비스에 대한 요청이 성공했습니다. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: 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

예제

Patch the Pool

Sample Request

HTTP

PATCH account.region.batch.azure.com/pools/poolId?api-version=2023-11-01.18.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  }
}

Sample Response

Status code:

200

정의

Name	Description
ApplicationPackageReference	컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.
AutoUserScope	자동 사용자에 대한 scope
AutoUserSpecification	Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
CertificateReference	풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.
CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.
CertificateVisibility	컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.
ComputeNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
ContainerRegistry	프라이빗 컨테이너 레지스트리.
ContainerWorkingDirectory	컨테이너 작업 디렉터리의 위치입니다.
ElevationLevel	사용자의 권한 상승 수준입니다.
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
MetadataItem	Batch 서비스 리소스와 연결된 이름-값 쌍입니다.
NodeCommunicationMode	풀이 Batch 서비스와 통신하는 방법을 결정합니다.
PoolPatchParameter	풀에 적용할 변경 내용 집합입니다.
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
StartTask	노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.
TaskContainerSettings	작업에 대한 컨테이너 설정입니다.
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다.

ApplicationPackageReference

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

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

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	오류 응답에 포함된 추가 정보입니다.

CertificateReference

풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.

Name	형식	Description
storeLocation	CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다. 기본값은 currentuser입니다. 이 속성은 Windows Compute 노드로 구성된 풀(즉, cloudServiceConfiguration으로 생성되거나 Windows 이미지 참조를 사용하여 virtualMachineConfiguration을 사용하여 만든 풀)에만 적용됩니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수가 이 위치를 쿼리하기 위해 작업에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.
storeName	string	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 이름입니다. 이 속성은 Windows Compute 노드로 구성된 풀(즉, cloudServiceConfiguration으로 생성되거나 Windows 이미지 참조를 사용하여 virtualMachineConfiguration을 사용하여 만든 풀)에만 적용됩니다. 일반적인 저장소 이름은 My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook을 포함하지만 사용자 지정 저장소 이름도 사용할 수 있습니다. 기본값은 My입니다.
thumbprint	string	인증서의 지문입니다.
thumbprintAlgorithm	string	지문이 연결된 알고리즘입니다. sha1이어야 합니다.
visibility	CertificateVisibility[]	컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다. 이 컬렉션에서 둘 이상의 표시 유형을 지정할 수 있습니다. 기본값은 모든 계정입니다.

CertificateStoreLocation

인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.

Name	형식	Description
currentuser	string	인증서는 CurrentUser 인증서 저장소에 설치해야 합니다.
localmachine	string	인증서는 LocalMachine 인증서 저장소에 설치해야 합니다.

CertificateVisibility

컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.

Name	형식	Description
remoteuser	string	인증서는 사용자가 컴퓨팅 노드에 원격으로 액세스하는 사용자 계정에 표시됩니다.
starttask	string	인증서는 StartTask가 실행되는 사용자 계정에 표시됩니다. AutoUser 범위가 StartTask 및 작업 모두에 대한 풀인 경우 이 인증서도 작업에 표시됩니다.
task	string	인증서는 작업 작업이 실행되는 사용자 계정에 표시되어야 합니다.

ComputeNodeIdentityReference

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

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

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 서비스 작업 디렉터리를 사용합니다.

ElevationLevel

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

Name	형식	Description
admin	string	사용자는 관리자 권한이 높은 사용자이며 전체 관리자 권한으로 작동합니다.
nonadmin	string	사용자는 상승된 액세스 권한이 없는 표준 사용자입니다.

EnvironmentSetting

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

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

ErrorMessage

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

Name	형식	Description
lang	string	오류 메시지의 언어 코드
value	string	메시지의 텍스트입니다.

MetadataItem

Batch 서비스 리소스와 연결된 이름-값 쌍입니다.

Name	형식	Description
name	string	메타데이터 항목의 이름입니다.
value	string	메타데이터 항목의 값입니다.

NodeCommunicationMode

풀이 Batch 서비스와 통신하는 방법을 결정합니다.

Name	형식	Description
classic	string	클래식 통신 모드를 사용하는 노드에는 "BatchNodeManagement"의 포트 29876 및 29877에서 인바운드 TCP 통신이 필요합니다. {region}" 서비스 태그 및 포트 443에서 "Storage.region" 및 "BatchNodeManagement"로의 아웃바운드 TCP 통신 {region}" 서비스 태그.
default	string	노드 통신 모드는 Batch 서비스에 의해 자동으로 설정됩니다.
simplified	string	간소화된 통신 모드를 사용하는 노드에는 포트 443에서 "BatchNodeManagement"로 아웃바운드 TCP 통신이 필요합니다. {region}" 서비스 태그. 열려 있는 인바운드 포트는 필요하지 않습니다.

PoolPatchParameter

풀에 적용할 변경 내용 집합입니다.

Name	형식	Description
applicationPackageReferences	ApplicationPackageReference[]	풀의 각 컴퓨팅 노드에 설치할 패키지 목록입니다. 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 이 요소가 있는 경우 기존 패키지 참조를 대체합니다. 빈 컬렉션을 지정하면 모든 패키지 참조가 풀에서 제거됩니다. 생략하면 기존 패키지 참조는 변경되지 않은 상태로 유지됩니다.
certificateReferences	CertificateReference[]	풀의 각 컴퓨팅 노드에 설치할 인증서 목록입니다. 이 요소가 있는 경우 풀에 구성된 기존 인증서 참조를 대체합니다. 생략하면 기존 인증서 참조는 변경되지 않은 상태로 유지됩니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수가 이 위치를 쿼리하기 위해 작업에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.
metadata	MetadataItem[]	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다. 이 요소가 있는 경우 풀에 구성된 기존 메타데이터를 대체합니다. 빈 컬렉션을 지정하면 모든 메타데이터가 풀에서 제거됩니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다.
startTask	StartTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행할 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다. 이 요소가 있으면 기존 StartTask를 덮어씁니다. 생략하면 기존 StartTask는 변경되지 않은 상태로 유지됩니다.
targetNodeCommunicationMode	NodeCommunicationMode	풀에 대해 원하는 노드 통신 모드입니다. 이 요소가 있는 경우 풀에 구성된 기존 targetNodeCommunicationMode를 대체합니다. 생략하면 기존 메타데이터는 변경되지 않은 상태로 유지됩니다.

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을 설정합니다.

StartTask

노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.

Name	형식	Description
commandLine	string	StartTask의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
containerSettings	TaskContainerSettings	StartTask가 실행되는 컨테이너에 대한 설정입니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
environmentSettings	EnvironmentSetting[]	StartTask에 대한 환경 변수 설정 목록입니다.
maxTaskRetryCount	integer	작업이 다시 시도될 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(초기 시도 1회, 다시 시도 3회)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스에서 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 함)입니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다.
userIdentity	UserIdentity	StartTask가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.
waitForSuccess	boolean	Batch 서비스가 Compute 노드에서 작업을 예약하기 전에 StartTask가 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료). true이고 StartTask가 노드에서 실패하면 Batch 서비스는 StartTask를 최대 재시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 아직 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 오류 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다.

TaskContainerSettings

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

Name	형식	Description
containerRunOptions	string	컨테이너 만들기 명령에 대한 추가 옵션입니다. 이러한 추가 옵션은 Batch 서비스에서 제어하는 옵션 외에도 "docker create" 명령에 대한 인수로 제공됩니다.
imageName	string	작업을 실행할 컨테이너를 만드는 데 사용할 이미지입니다. "docker pull"에 지정된 것처럼 전체 이미지 참조입니다. 이미지 이름의 일부로 태그가 제공되지 않으면 ":latest" 태그가 기본값으로 사용됩니다.
registry	ContainerRegistry	컨테이너 이미지를 포함하는 프라이빗 레지스트리입니다. 풀을 만들 때 이미 제공된 경우 이 설정을 생략할 수 있습니다.
workingDirectory	ContainerWorkingDirectory	컨테이너 작업 작업 디렉터리의 위치입니다. 기본값은 'taskWorkingDirectory'입니다.

UserIdentity

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

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