Pools - Replace Pool Properties

서비스:

Batch Service

API 버전:

2025-06-01

지정된 풀의 속성을 업데이트합니다.
이로써 풀의 모든 업데이트 가능한 속성이 완전히 대체됩니다. 예를 들어, 풀에 StartTask가 연결되어 있고 이 요청에 StartTask가 지정되어 있지 않으면, 배치 서비스는 기존의 StartTask를 제거합니다.

POST {endpoint}/pools/{poolId}/updateproperties?api-version=2025-06-01

선택적 매개 변수:

POST {endpoint}/pools/{poolId}/updateproperties?api-version=2025-06-01&timeOut={timeOut}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string (uri)	Batch 계정 엔드포인트(예: https://batchaccount.eastus2.batch.azure.com).
poolId	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
applicationPackageReferences	True	BatchApplicationPackageReference[]	풀의 각 컴퓨팅 노드에 설치할 애플리케이션 패키지 목록입니다. 이 목록은 풀의 기존 애플리케이션 패키지 참조를 대체합니다. 애플리케이션 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 컴퓨팅 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 애플리케이션 패키지 참조가 있습니다. 생략하거나 빈 컬렉션을 지정하는 경우 기존 애플리케이션 패키지 참조가 풀에서 제거됩니다. 지정된 풀에 최대 10개의 참조를 지정할 수 있습니다.
metadata	True	BatchMetadataItem[]	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다. 이 목록은 풀에 구성된 기존 메타데이터를 대체합니다. 생략하거나 빈 컬렉션을 지정하는 경우 풀에서 기존 메타데이터가 제거됩니다.
startTask		BatchStartTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행할 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다. 이 요소가 있으면 기존 StartTask를 덮어씁니다. 생략하면 기존 StartTask가 풀에서 제거됩니다.

응답

Name	형식	Description
204 No Content		이 요청에 대해 보낼 콘텐츠는 없지만 헤더가 유용할 수 있습니다. 헤더 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

예제

Pool update

샘플 요청

HTTP

POST {endpoint}/pools/poolId/updateproperties?api-version=2025-06-01



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "applicationPackageReferences": [],
  "metadata": []
}

샘플 응답

상태 코드:

204

정의

Name	Description
AutoUserScope	AutoUserScope 열거
AutoUserSpecification	Azure Batch 작업을 실행하는 자동 사용자에 대한 옵션을 지정합니다.
BatchApplicationPackageReference	컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
BatchErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
BatchMetadataItem	Batch 서비스는 이 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
BatchNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
BatchPoolReplaceOptions	Azure Batch 풀의 속성을 바꾸기 위한 매개 변수입니다.
BatchStartTask	Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(제한되지 않음) 등이 있습니다. 복구 작업으로 인한 재시도는 maxTaskRetryCount와 독립적이며 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업이 손상되거나 중복된 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점을 사용하는 것입니다. 경우에 따라 컴퓨팅 노드가 다시 부팅되지 않은 경우에도 StartTask가 다시 실행될 수 있습니다. 중단 프로세스를 만들거나 StartTask 작업 디렉터리에서 서비스를 설치/시작하는 StartTasks를 방지하기 위해 특별히 주의해야 합니다. 이렇게 하면 Batch가 StartTask를 다시 실행할 수 없게 됩니다.
BatchTaskContainerSettings	작업에 대한 컨테이너 설정입니다.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistryReference	프라이빗 컨테이너 레지스트리입니다.
ContainerWorkingDirectory	ContainerWorkingDirectory enums
ElevationLevel	고도 수준 열거
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다. userName 또는 autoUser 속성을 지정하지만 둘 다 지정하지는 않습니다.

AutoUserScope

열거형

AutoUserScope 열거

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

AutoUserSpecification

Object

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

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

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

BatchMetadataItem

Object

Batch 서비스는 이 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.

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

BatchNodeIdentityReference

Object

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

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

BatchPoolReplaceOptions

Object

Azure Batch 풀의 속성을 바꾸기 위한 매개 변수입니다.

Name	형식	Description
applicationPackageReferences	BatchApplicationPackageReference[]	풀의 각 컴퓨팅 노드에 설치할 애플리케이션 패키지 목록입니다. 이 목록은 풀의 기존 애플리케이션 패키지 참조를 대체합니다. 애플리케이션 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 컴퓨팅 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 애플리케이션 패키지 참조가 있습니다. 생략하거나 빈 컬렉션을 지정하는 경우 기존 애플리케이션 패키지 참조가 풀에서 제거됩니다. 지정된 풀에 최대 10개의 참조를 지정할 수 있습니다.
metadata	BatchMetadataItem[]	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다. 이 목록은 풀에 구성된 기존 메타데이터를 대체합니다. 생략하거나 빈 컬렉션을 지정하는 경우 풀에서 기존 메타데이터가 제거됩니다.
startTask	BatchStartTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행할 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다. 이 요소가 있으면 기존 StartTask를 덮어씁니다. 생략하면 기존 StartTask가 풀에서 제거됩니다.

BatchStartTask

Object

Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(제한되지 않음) 등이 있습니다. 복구 작업으로 인한 재시도는 maxTaskRetryCount와 독립적이며 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업이 손상되거나 중복된 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점을 사용하는 것입니다. 경우에 따라 컴퓨팅 노드가 다시 부팅되지 않은 경우에도 StartTask가 다시 실행될 수 있습니다. 중단 프로세스를 만들거나 StartTask 작업 디렉터리에서 서비스를 설치/시작하는 StartTasks를 방지하기 위해 특별히 주의해야 합니다. 이렇게 하면 Batch가 StartTask를 다시 실행할 수 없게 됩니다.

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

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

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	컨테이너 이미지에 정의된 작업 디렉터리를 사용하세요. 이 디렉터리에는 배치가 다운로드한 자원 파일이 포함되지 않을 수 있으니 주의하세요.

ElevationLevel

열거형

고도 수준 열거

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

EnvironmentSetting

Object

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

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 속성은 상호 배타적입니다. 둘 다 지정해야 하지만 둘 다 지정하지는 않습니다.