Job - Get

Service:

Batch Service

API Version:

2023-11-01.18.0

지정된 작업에 대한 정보를 가져옵니다.

GET {batchUrl}/jobs/{jobId}?api-version=2023-11-01.18.0

With optional parameters:

GET {batchUrl}/jobs/{jobId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2023-11-01.18.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 절입니다.
$select	query		string	OData $select 절입니다.
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	클라이언트에 알려진 리소스의 마지막으로 수정된 시간을 나타내는 타임스탬프입니다. 지정된 시간 이후 서비스의 리소스가 수정되지 않은 경우에만 작업이 수행됩니다.

응답

Name	형식	Description
200 OK	CloudJob	작업이 포함된 응답입니다. Headers client-request-id: string request-id: string ETag: string Last-Modified: 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

예제

Job get

Sample Request

HTTP

GET account.region.batch.azure.com/jobs/jobId?api-version=2023-11-01.18.0

Sample Response

Status code:

200

{
  "id": "jobId",
  "url": "https://account.region.batch.azure.com/jobs/jobId",
  "eTag": "0x8D4100FC49F0278",
  "lastModified": "2016-11-19T00:05:27.5391608Z",
  "creationTime": "2016-11-19T00:05:25.311915Z",
  "state": "completed",
  "stateTransitionTime": "2016-11-19T00:05:27.578581Z",
  "previousState": "active",
  "previousStateTransitionTime": "2016-11-19T00:05:27.2137716Z",
  "priority": 0,
  "maxParallelTasks": -1,
  "allowTaskPreemption": false,
  "usesTaskDependencies": false,
  "constraints": {
    "maxWallClockTime": "P10675199DT2H48M5.4775807S",
    "maxTaskRetryCount": 0
  },
  "poolInfo": {
    "poolId": "poolId"
  },
  "executionInfo": {
    "startTime": "2016-11-19T00:05:25.3309105Z",
    "endTime": "2016-11-19T00:05:27.578581Z",
    "poolId": "poolId",
    "terminateReason": "UserTerminate"
  },
  "onAllTasksComplete": "noaction",
  "onTaskFailure": "noaction"
}

정의

Name	Description
AccessScope	토큰이 액세스 권한을 부여하는 Batch 리소스입니다.
ApplicationPackageReference	컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.
AuthenticationTokenSettings	태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.
AutoPoolSpecification	임시 '자동 풀'의 특성을 지정합니다. Batch 서비스는 작업이 제출될 때 이 자동 풀을 만듭니다.
AutoUserScope	자동 사용자에 대한 scope
AutoUserSpecification	Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
AzureBlobFileSystemConfiguration	Blobfuse를 사용하여 Azure Storage 컨테이너에 연결하는 데 사용되는 정보입니다.
AzureFileShareConfiguration	Azure Fileshare에 연결하는 데 사용되는 정보입니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
CachingType	디스크에 사용할 캐싱 유형입니다.
CertificateReference	풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.
CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.
CertificateVisibility	컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.
CIFSMountConfiguration	CIFS 파일 시스템에 연결하는 데 사용되는 정보입니다.
CloudJob	Azure Batch 작업입니다.
CloudServiceConfiguration	Azure Cloud Services 플랫폼을 기반으로 풀의 컴퓨팅 노드에 대한 구성입니다.
ComputeNodeFillType	풀의 컴퓨팅 노드에 태스크를 분산하는 방법.
ComputeNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
ContainerConfiguration	컨테이너 사용 풀에 대한 구성입니다.
ContainerRegistry	프라이빗 컨테이너 레지스트리.
ContainerType	사용할 컨테이너 기술입니다.
ContainerWorkingDirectory	컨테이너 작업 작업 디렉터리의 위치입니다.
DataDisk	풀의 컴퓨팅 노드에 연결된 데이터 디스크에서 사용할 설정입니다. 연결된 데이터 디스크를 사용하는 경우 VM 내에서 디스크를 탑재하고 포맷하여 사용해야 합니다.
DiffDiskPlacement	풀의 모든 컴퓨팅 노드(VM)에 대한 운영 체제 디스크의 임시 디스크 배치를 지정합니다.
DiffDiskSettings	컴퓨팅 노드(VM)에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
DiskEncryptionConfiguration	풀의 컴퓨팅 노드에 적용되는 디스크 암호화 구성입니다. Azure Compute Gallery 이미지로 만든 Linux 풀에서는 디스크 암호화 구성이 지원되지 않습니다.
DiskEncryptionTarget	Batch 서비스가 컴퓨팅 노드에서 암호화할 디스크 대상 목록입니다.
DynamicVNetAssignmentScope	동적 vnet 할당의 scope.
ElevationLevel	사용자의 권한 상승 수준입니다.
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ErrorCategory	오류의 범주입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
HttpHeader	HTTP 헤더 이름-값 쌍
ImageReference	Azure Virtual Machines Marketplace 이미지 또는 Azure Compute Gallery 이미지에 대한 참조입니다. Azure Batch 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.
InboundEndpointProtocol	엔드포인트의 프로토콜입니다.
InboundNATPool	외부적으로 Batch 풀의 컴퓨팅 노드에서 특정 포트를 처리하는 데 사용할 수 있는 인바운드 NAT 풀입니다.
IPAddressProvisioningType	풀의 공용 IP 주소에 대한 프로비저닝 유형입니다.
JobConstraints	작업에 대한 실행 제약 조건입니다.
JobExecutionInformation	Azure Batch 서비스에서 작업의 실행에 대한 정보를 포함합니다.
JobManagerTask	작업 관리자 작업의 세부 정보를 지정합니다.
JobNetworkConfiguration	작업에 대한 네트워크 구성입니다.
JobPreparationTask	지정된 컴퓨팅 노드에서 작업의 태스크 앞에 실행할 작업 준비 태스크입니다.
JobReleaseTask	작업이 실행된 컴퓨팅 노드에서 작업 완료 시 실행할 작업 릴리스 작업입니다.
JobSchedulingError	작업을 예약할 때 Batch 서비스에서 발생한 오류입니다.
JobState	작업의 상태입니다.
JobStatistics	작업에 대한 리소스 사용 통계입니다.
LinuxUserConfiguration	Linux 컴퓨팅 노드에서 사용자 계정을 만드는 데 사용되는 속성입니다.
LoginMode	사용자의 로그인 모드
ManagedDisk
MetadataItem	Batch 서비스 리소스와 연결된 이름-값 쌍입니다.
MountConfiguration	각 노드에 탑재할 파일 시스템입니다.
NameValuePair	이름-값 쌍을 나타냅니다.
NetworkConfiguration	풀에 대한 네트워크 구성입니다.
NetworkSecurityGroupRule	인바운드 엔드포인트에 적용할 네트워크 보안 그룹 규칙입니다.
NetworkSecurityGroupRuleAccess	지정된 IP 주소, 서브넷 범위 또는 태그에 대해 수행해야 하는 작업입니다.
NFSMountConfiguration	NFS 파일 시스템에 연결하는 데 사용되는 정보입니다.
NodeCommunicationMode	풀이 Batch 서비스와 통신하는 방법을 결정합니다.
NodePlacementConfiguration	풀에 대한 노드 배치 구성입니다.
NodePlacementPolicyType	풀에서 노드를 할당하기 위한 배치 정책입니다.
OnAllTasksComplete	작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다.
OnTaskFailure	작업의 태스크가 실패할 때 Batch 서비스에서 수행해야 하는 작업입니다.
OSDisk	컴퓨팅 노드(VM)의 운영 체제 디스크에 대한 설정입니다.
OutputFile	Batch 서비스가 작업 프로세스 실행을 완료한 후 Azure Batch 컴퓨팅 노드에서 다른 위치로 파일을 업로드하기 위한 사양입니다.
OutputFileBlobContainerDestination	Azure Blob Storage 컨테이너 내에서 파일 업로드 대상을 지정합니다.
OutputFileDestination	파일을 업로드할 대상입니다.
OutputFileUploadCondition	작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다.
OutputFileUploadOptions	업로드를 수행할 조건을 포함하여 출력 파일 업로드 작업에 대한 세부 정보입니다.
PoolEndpointConfiguration	풀에 대한 엔드포인트 구성입니다.
PoolInformation	풀에 작업을 할당하는 방법을 지정합니다.
PoolLifetimeOption	생성된 자동 풀의 최소 수명 및 일정에 따라 여러 작업이 풀에 할당되는 방식입니다.
PoolSpecification	새 풀을 만들기 위한 사양입니다.
PublicIPAddressConfiguration	풀의 네트워킹 구성에 대한 공용 IP 주소 구성입니다.
ResourceFile	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
SecurityProfile	가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다.
SecurityTypes	가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다.
ServiceArtifactReference	'최신' 이미지 버전을 사용할 때 확장 집합의 모든 가상 머신에 대해 동일한 이미지 버전을 설정하는 데 사용되는 서비스 아티팩트 참조 ID를 지정합니다.
StartTask	노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.
StorageAccountType	데이터 디스크 또는 OS 디스크를 만드는 데 사용할 스토리지 계정 유형입니다.
TaskConstraints	작업에 적용할 실행 제약 조건입니다.
TaskContainerSettings	작업에 대한 컨테이너 설정입니다.
TaskSchedulingPolicy	컴퓨팅 노드에 태스크를 분산하는 방법을 지정합니다.
UefiSettings	가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다.
UserAccount	Azure Batch 컴퓨팅 노드에서 작업을 실행하는 데 사용되는 사용자를 만드는 데 사용되는 속성입니다.
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다.
VirtualMachineConfiguration	Azure Virtual Machines 인프라를 기반으로 풀의 컴퓨팅 노드에 대한 구성입니다.
VMExtension	가상 머신 확장에 대한 구성입니다.
WindowsConfiguration	가상 머신에 적용할 Windows 운영 체제 설정입니다.
WindowsUserConfiguration	Windows 컴퓨팅 노드에서 사용자 계정을 만드는 데 사용되는 속성입니다.

AccessScope

토큰이 액세스 권한을 부여하는 Batch 리소스입니다.

Name	형식	Description
job	string	작업을 포함하는 작업에 대한 모든 작업을 수행할 수 있는 액세스 권한을 부여합니다.

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 서비스 작업 집합에 대한 액세스 권한을 부여합니다. 현재 access 속성에 대해 지원되는 유일한 값은 'job'이며, 이 값은 작업이 포함된 작업과 관련된 모든 작업에 대한 액세스 권한을 부여합니다.

AutoPoolSpecification

임시 '자동 풀'의 특성을 지정합니다. Batch 서비스는 작업이 제출될 때 이 자동 풀을 만듭니다.

Name	형식	Description
autoPoolIdPrefix	string	풀이 자동으로 만들어질 때 고유 식별자에 추가할 접두사입니다. Batch 서비스는 각 자동 풀을 만들 때 고유 식별자를 할당합니다. 다양한 용도로 만든 풀을 구분하기 위해 이 요소를 지정하여 할당된 ID에 접두사를 추가할 수 있습니다. 접두사는 최대 20자까지 지정할 수 있습니다.
keepAlive	boolean	수명이 만료된 후 자동 풀을 활성 상태로 유지할지 여부입니다. false이면 Batch 서비스는 수명이 만료되면(poolLifetimeOption 설정에 의해 결정됨) 풀을 삭제합니다. 즉, 작업 또는 작업 일정이 완료되는 경우입니다. true이면 Batch 서비스에서 풀을 자동으로 삭제하지 않습니다. 이 옵션을 사용하여 만든 자동 풀을 삭제하는 것은 사용자에게 달려 있습니다.
pool	PoolSpecification	자동 풀의 풀 사양입니다.
poolLifetimeOption	PoolLifetimeOption	생성된 자동 풀의 최소 수명 및 일정에 따라 여러 작업이 풀에 할당되는 방식입니다.

AutoUserScope

자동 사용자에 대한 scope

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

AutoUserSpecification

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

Name	형식	Description
elevationLevel	ElevationLevel	자동 사용자의 권한 상승 수준입니다. 기본값은 nonAdmin입니다.
scope	AutoUserScope	자동 사용자에 대한 scope 기본값은 풀입니다. 풀이 Windows를 실행하는 경우 작업 간에 더 엄격한 격리가 필요한 경우 Task 값을 지정해야 합니다. 예를 들어 태스크가 다른 작업에 영향을 미칠 수 있는 방식으로 레지스트리를 변경하거나 일반 작업에서 액세스할 수 없지만 StartTasks에서 액세스할 수 있어야 하는 풀에 인증서를 지정한 경우입니다.

AzureBlobFileSystemConfiguration

Blobfuse를 사용하여 Azure Storage 컨테이너에 연결하는 데 사용되는 정보입니다.

Name	형식	Description
accountKey	string	Azure Storage 계정 키입니다. 이 속성은 sasKey 및 ID와 함께 사용할 수 없습니다. 정확히 하나만 지정해야 합니다.
accountName	string	Azure Storage 계정 이름입니다.
blobfuseOptions	string	탑재 명령에 전달할 추가 명령줄 옵션입니다. 다음은 Windows의 '순 사용' 옵션과 Linux의 '탑재' 옵션입니다.
containerName	string	Azure Blob Storage 컨테이너 이름입니다.
identityReference	ComputeNodeIdentityReference	containerName에 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. 이 속성은 accountKey 및 sasKey와 함께 사용할 수 없습니다. 정확히 하나만 지정해야 합니다.
relativeMountPath	string	파일 시스템이 탑재될 컴퓨팅 노드의 상대 경로 모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.
sasKey	string	Azure Storage SAS 토큰입니다. 이 속성은 accountKey 및 ID와 함께 사용할 수 없습니다. 정확히 하나만 지정해야 합니다.

AzureFileShareConfiguration

Azure Fileshare에 연결하는 데 사용되는 정보입니다.

Name	형식	Description
accountKey	string	Azure Storage 계정 키입니다.
accountName	string	Azure Storage 계정 이름입니다.
azureFileUrl	string	Azure Files URL입니다. 'https://{account}.file.core.windows.net/' 형식입니다.
mountOptions	string	탑재 명령에 전달할 추가 명령줄 옵션입니다. 다음은 Windows의 '순 사용' 옵션과 Linux의 '탑재' 옵션입니다.
relativeMountPath	string	파일 시스템이 탑재될 컴퓨팅 노드의 상대 경로 모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.

BatchError

Azure Batch 서비스에서 받은 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
message	ErrorMessage	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values	BatchErrorDetail[]	오류에 대한 추가 세부 정보를 포함하는 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.

Name	형식	Description
key	string	Value 속성의 의미를 지정하는 식별자입니다.
value	string	오류 응답에 포함된 추가 정보입니다.

CachingType

디스크에 사용할 캐싱 유형입니다.

Name	형식	Description
none	string	디스크에 대한 캐싱 모드를 사용할 수 없습니다.
readonly	string	디스크의 캐싱 모드는 읽기 전용입니다.
readwrite	string	디스크의 캐싱 모드는 읽고 씁니다.

CertificateReference

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

Name	형식	Description
storeLocation	CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다. 기본값은 currentuser입니다. 이 속성은 Windows 컴퓨팅 노드로 구성된 풀(즉, cloudServiceConfiguration으로 생성되거나 Windows 이미지 참조를 사용하여 virtualMachineConfiguration을 사용하여 만든 풀)에만 적용됩니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 환경 변수 AZ_BATCH_CERTIFICATES_DIR 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.
storeName	string	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 이름입니다. 이 속성은 Windows 컴퓨팅 노드로 구성된 풀(즉, 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	인증서는 작업 작업이 실행되는 사용자 계정에 표시되어야 합니다.

CIFSMountConfiguration

CIFS 파일 시스템에 연결하는 데 사용되는 정보입니다.

Name	형식	Description
mountOptions	string	탑재 명령에 전달할 추가 명령줄 옵션입니다. 다음은 Windows의 '순 사용' 옵션과 Linux의 '탑재' 옵션입니다.
password	string	CIFS 파일 시스템에 대한 인증에 사용할 암호입니다.
relativeMountPath	string	파일 시스템이 탑재될 컴퓨팅 노드의 상대 경로 모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.
source	string	탑재할 파일 시스템의 URI입니다.
username	string	CIFS 파일 시스템에 대한 인증에 사용할 사용자입니다.

CloudJob

Azure Batch 작업입니다.

Name	형식	기본값	Description
allowTaskPreemption	boolean		이 작업의 작업을 다른 우선 순위가 높은 작업에서 선점할 수 있는지 여부 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다.
commonEnvironmentSettings	EnvironmentSetting[]		일반적인 환경 변수 설정 목록입니다. 이러한 환경 변수는 작업의 모든 작업(작업 관리자, 작업 준비 및 작업 릴리스 작업 포함)에 대해 설정됩니다. 개별 작업은 동일한 설정 이름을 다른 값으로 지정하여 여기에 지정된 환경 설정을 재정의할 수 있습니다.
constraints	JobConstraints		작업에 대한 실행 제약 조건입니다.
creationTime	string		작업의 생성 시간입니다.
displayName	string		작업의 표시 이름입니다.
eTag	string		작업의 ETag입니다. 불투명 문자열입니다. 이를 사용하여 요청 간에 작업이 변경되었는지 여부를 검색할 수 있습니다. 특히 작업을 업데이트할 때 ETag를 전달하여 그 동안 아무도 작업을 수정하지 않은 경우에만 변경 내용이 적용되도록 지정할 수 있습니다.
executionInfo	JobExecutionInformation		작업에 대한 실행 정보입니다.
id	string		계정 내에서 작업을 고유하게 식별하는 문자열입니다. ID는 대/소문자를 구분하지 않습니다(즉, 계정 내에 대/소문자만 다른 두 개의 ID가 없을 수 있음).
jobManagerTask	JobManagerTask		작업이 시작될 때 시작할 작업 관리자 작업의 세부 정보입니다. 작업이 만들어지면 작업 관리자 작업이 자동으로 시작됩니다. Batch 서비스는 작업의 다른 작업 앞에 작업 관리자 작업을 예약하려고 합니다. 풀을 축소할 때 Batch 서비스는 작업 관리자 작업이 가능한 한 오랫동안 실행되는 노드를 유지하려고 시도합니다(즉, 작업 관리자 작업을 실행하는 컴퓨팅 노드 전에 '정상' 작업을 실행하는 컴퓨팅 노드가 제거됨). 작업 관리자 태스크가 실패하고 다시 시작해야 하는 경우 시스템은 가장 높은 우선 순위로 예약을 시도합니다. 사용 가능한 유휴 컴퓨팅 노드가 없는 경우 시스템은 풀에서 실행 중인 작업 중 하나를 종료하고 작업 관리자 태스크를 다시 시작할 공간을 확보하기 위해 큐로 반환할 수 있습니다. 한 작업의 작업 관리자 태스크는 다른 작업의 작업보다 우선 순위가 없습니다. 작업 전체에서 작업 수준 우선 순위만 관찰됩니다. 예를 들어 우선 순위 0 작업의 작업 관리자를 다시 시작해야 하는 경우 우선 순위 1 작업의 태스크를 대체하지 않습니다. Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(하지만 제한되지 않음)가 있습니다. 복구 작업으로 인한 재시도는 독립적이며 maxTaskRetryCount에 대해 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업은 손상 또는 중복 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점 지정을 사용하는 것입니다.
jobPreparationTask	JobPreparationTask		작업 준비 태스크입니다. 작업 준비 태스크는 작업의 다른 작업 전에 각 컴퓨팅 노드에서 실행되는 특별한 작업입니다.
jobReleaseTask	JobReleaseTask		작업 해제 작업입니다. 작업 해제 태스크는 작업의 다른 작업을 실행한 각 컴퓨팅 노드의 작업 끝에서 실행되는 특수 작업입니다.
lastModified	string		작업의 마지막 수정 시간입니다. 작업 상태 또는 우선 순위와 같은 작업 수준 데이터가 마지막으로 변경된 시간입니다. 새 작업 추가 또는 작업 변경 상태와 같은 작업 수준 변경은 고려하지 않습니다.
maxParallelTasks	integer	-1	작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 -1이거나 지정된 경우 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 만든 작업의 maxParallelTasks를 업데이트할 수 있습니다.
metadata	MetadataItem[]		작업과 메타데이터로 연결된 이름-값 쌍의 목록입니다. Batch 서비스는 메타데이터에 의미를 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
networkConfiguration	JobNetworkConfiguration		작업에 대한 네트워크 구성입니다.
onAllTasksComplete	OnAllTasksComplete		작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 기본값은 noaction입니다.
onTaskFailure	OnTaskFailure		작업의 태스크가 실패할 때 Batch 서비스에서 수행해야 하는 작업입니다. FailureInfo가 있는 경우 작업이 실패한 것으로 간주됩니다. failureInfo는 재시도 횟수를 소진한 후 태스크가 0이 아닌 종료 코드로 완료되거나, 예를 들어 리소스 파일 다운로드 오류로 인해 작업을 시작하는 동안 오류가 발생한 경우 설정됩니다. 기본값은 noaction입니다.
poolInfo	PoolInformation		작업과 연결된 풀 설정입니다.
previousState	JobState		작업의 이전 상태입니다. 작업이 초기 활성 상태이면 이 속성이 설정되지 않습니다.
previousStateTransitionTime	string		작업이 이전 상태로 진입한 시간입니다. 작업이 초기 활성 상태이면 이 속성이 설정되지 않습니다.
priority	integer		작업의 우선 순위입니다. 우선 순위 값의 범위는 -1000~1000이며 -1000이 가장 낮은 우선 순위이고 1000이 가장 높은 우선 순위입니다. 기본값은 0입니다.
state	JobState		작업의 현재 상태입니다.
stateTransitionTime	string		작업이 현재 상태를 입력한 시간입니다.
stats	JobStatistics		작업의 전체 수명에 대한 리소스 사용 통계입니다. 이 속성은 CloudJob이 'stats' 특성을 포함한 expand 절로 검색된 경우에만 채워집니다. 그렇지 않으면 null입니다. 통계를 즉시 사용할 수 없습니다. Batch 서비스는 통계의 주기적인 롤업을 수행합니다. 일반적인 지연 시간은 약 30분입니다.
url	string		작업의 URL입니다.
usesTaskDependencies	boolean		작업의 태스크가 서로 종속성을 정의할 수 있는지 여부입니다. 기본값은 false입니다.

CloudServiceConfiguration

Azure Cloud Services 플랫폼을 기반으로 풀의 컴퓨팅 노드에 대한 구성입니다.

Name	형식	Description
osFamily	string	풀의 가상 머신에 설치할 Azure 게스트 OS 제품군입니다. 가능한 값은 Windows Server 2008 R2 SP1과 동일한 2 - OS 제품군 2입니다. 3 - OS 제품군 3, Windows Server 2012 해당. 4 - OS 제품군 4, Windows Server 2012 R2와 동일합니다. 5 - OS 제품군 5, Windows Server 2016 해당. 6 - OS 제품군 6, Windows Server 2019와 동일합니다. 자세한 내용은 Azure 게스트 OS 릴리스(https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases)를 참조하세요.
osVersion	string	풀의 가상 머신에 설치할 Azure 게스트 OS 버전입니다. 기본값은 지정된 OS 제품군의 최신 운영 체제 버전을 지정하는 *입니다.

ComputeNodeFillType

풀의 컴퓨팅 노드에 태스크를 분산하는 방법.

Name	형식	Description
pack	string	풀의 다음 컴퓨팅 노드에 태스크가 할당되기 전에 가능한 한 많은 작업(taskSlotsPerNode)을 풀의 각 컴퓨팅 노드에 할당해야 합니다.
spread	string	풀의 모든 컴퓨팅 노드에서 태스크를 균등하게 할당해야 합니다.

ComputeNodeIdentityReference

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

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

ContainerConfiguration

컨테이너 사용 풀에 대한 구성입니다.

Name	형식	Description
containerImageNames	string[]	컨테이너 이미지 이름의 컬렉션입니다. "docker pull"에 지정된 것처럼 전체 이미지 참조입니다. 이미지가 대체 레지스트리로 정규화되지 않는 한 이미지는 기본 Docker 레지스트리에서 원본이 됩니다.
containerRegistries	ContainerRegistry[]	컨테이너를 끌어올 수 있는 추가 프라이빗 레지스트리입니다. 자격 증명이 필요한 프라이빗 레지스트리에서 이미지를 다운로드해야 하는 경우 해당 자격 증명을 여기에 제공해야 합니다.
type	ContainerType	사용할 컨테이너 기술입니다.

ContainerRegistry

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

Name	형식	Description
identityReference	ComputeNodeIdentityReference	사용자 이름 및 암호 대신 Azure Container Registry 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다. 컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
password	string	레지스트리 서버에 로그인할 암호입니다.
registryServer	string	레지스트리 URL입니다. 생략하면 기본값은 "docker.io"입니다.
username	string	레지스트리 서버에 로그인할 사용자 이름입니다.

ContainerType

사용할 컨테이너 기술입니다.

Name	형식	Description
criCompatible	string	CRI 기반 기술은 컨테이너를 시작하는 데 사용됩니다.
dockerCompatible	string	Docker 호환 컨테이너 기술을 사용하여 컨테이너를 시작합니다.

ContainerWorkingDirectory

컨테이너 작업 작업 디렉터리의 위치입니다.

Name	형식	Description
containerImageDefault	string	컨테이너 이미지에 정의된 작업 디렉터리를 사용합니다. 이 디렉터리에 Batch에서 다운로드한 리소스 파일이 포함되지 않도록 주의하세요.
taskWorkingDirectory	string	Batch로 채워진 작업 리소스 파일을 포함하는 표준 Batch 서비스 작업 디렉터리를 사용합니다.

DataDisk

풀의 컴퓨팅 노드에 연결된 데이터 디스크에서 사용할 설정입니다. 연결된 데이터 디스크를 사용하는 경우 VM 내에서 디스크를 탑재하고 포맷하여 사용해야 합니다.

Name	형식	Description
caching	CachingType	데이터 디스크에 사용할 캐싱 유형입니다. 캐싱의 기본값은 readwrite입니다. 캐싱 옵션에 대한 자세한 내용은 을 참조하세요 https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	초기 디스크 크기(기가바이트)입니다.
lun	integer	논리 단위 번호입니다. lun은 각 데이터 디스크를 고유하게 식별하는 데 사용됩니다. 여러 디스크를 연결하는 경우 각 디스크에는 고유한 lun이 있어야 합니다. 값은 0에서 63 사이여야 합니다( 포함).
storageAccountType	StorageAccountType	데이터 디스크에 사용할 스토리지 계정 유형입니다. 생략하면 기본값은 "standard_lrs"입니다.

DiffDiskPlacement

풀의 모든 컴퓨팅 노드(VM)에 대한 운영 체제 디스크의 임시 디스크 배치를 지정합니다.

Name	형식	Description
CacheDisk	string	임시 OS 디스크는 VM 캐시에 저장됩니다.

DiffDiskSettings

컴퓨팅 노드(VM)에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.

Name	형식	Description
placement	DiffDiskPlacement	풀의 모든 VM에 대한 운영 체제 디스크의 임시 디스크 배치를 지정합니다. 이 속성은 요청의 사용자가 임시 OS 디스크 프로비저닝을 위한 캐시 디스크 공간과 같은 위치를 선택하는 데 사용할 수 있습니다. 임시 OS 디스크 크기 요구 사항에 대한 자세한 내용은 의 Windows VM 및 Linux VM https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirementshttps://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements에 대한 임시 OS 디스크 크기 요구 사항을 참조하세요.

DiskEncryptionConfiguration

풀의 컴퓨팅 노드에 적용되는 디스크 암호화 구성입니다. Azure Compute Gallery 이미지로 만든 Linux 풀에서는 디스크 암호화 구성이 지원되지 않습니다.

Name	형식	Description
targets	DiskEncryptionTarget[]	Batch 서비스가 컴퓨팅 노드에서 암호화할 디스크 대상 목록입니다. 생략하면 풀의 컴퓨팅 노드에 있는 디스크가 암호화되지 않습니다. Linux 풀에서는 "TemporaryDisk"만 지원됩니다. Windows 풀에서 "OsDisk" 및 "TemporaryDisk"를 지정해야 합니다.

DiskEncryptionTarget

Batch 서비스가 컴퓨팅 노드에서 암호화할 디스크 대상 목록입니다.

Name	형식	Description
osdisk	string	컴퓨팅 노드의 OS 디스크가 암호화됩니다.
temporarydisk	string	컴퓨팅 노드의 임시 디스크가 암호화됩니다. Linux에서 이 암호화는 부팅 시 암호화가 발생할 때 다른 파티션(예: 탑재된 데이터 디스크의 파티션)에 적용됩니다.

DynamicVNetAssignmentScope

동적 vnet 할당의 scope.

Name	형식	Description
job	string	동적 VNet 할당은 작업별로 수행됩니다.
none	string	동적 VNet 할당을 사용할 수 없습니다.

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

HttpHeader

HTTP 헤더 이름-값 쌍

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

ImageReference

Azure Virtual Machines Marketplace 이미지 또는 Azure Compute Gallery 이미지에 대한 참조입니다. Azure Batch 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.

Name	형식	Description
exactVersion	string	노드를 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 특정 버전입니다. 이 읽기 전용 필드는 풀을 만들 때 'version'에 지정된 값이 'latest'인 경우에만 'version'과 다릅니다.
offer	string	Azure Virtual Machines Marketplace 이미지의 제품 유형입니다. 예를 들어 UbuntuServer 또는 WindowsServer입니다.
publisher	string	Azure Virtual Machines Marketplace 이미지의 게시자입니다. 예를 들어 Canonical 또는 MicrosoftWindowsServer입니다.
sku	string	Azure Virtual Machines Marketplace 이미지의 SKU입니다. 예를 들어 18.04-LTS 또는 2019-Datacenter입니다.
version	string	Azure Virtual Machines Marketplace 이미지의 버전입니다. 'latest' 값을 지정하여 최신 버전의 이미지를 선택할 수 있습니다. 생략하면 기본값은 'latest'입니다.
virtualMachineImageId	string	Azure Compute Gallery 이미지의 ARM 리소스 식별자입니다. 풀의 컴퓨팅 노드는 이 이미지 ID를 사용하여 만들어집니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} 형식입니다. 또는 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}은 항상 최신 이미지 버전으로 기본 설정됩니다. 이 속성은 다른 ImageReference 속성과 함께 사용할 수 없습니다. Azure Compute Gallery 이미지는 동일한 지역에 복제본이 있어야 하며 Azure Batch 계정과 동일한 구독에 있어야 합니다. imageId에 이미지 버전을 지정하지 않으면 최신 버전이 사용됩니다. Batch 서비스와 통신하는 Batch Compute Node 에이전트의 방화벽 설정에 대한 자세한 내용은 을 참조하세요 https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

엔드포인트의 프로토콜입니다.

Name	형식	Description
tcp	string	엔드포인트에 TCP를 사용합니다.
udp	string	엔드포인트에 UDP를 사용합니다.

InboundNATPool

외부적으로 Batch 풀의 컴퓨팅 노드에서 특정 포트를 처리하는 데 사용할 수 있는 인바운드 NAT 풀입니다.

Name	형식	Description
backendPort	integer	컴퓨팅 노드의 포트 번호입니다. 일괄 처리 풀 내에서 고유해야 합니다. 허용되는 값은 22, 3389, 29876 및 29877을 제외하고 1에서 65535 사이입니다. 예약된 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다.
frontendPortRangeEnd	integer	개별 컴퓨팅 노드의 backendPort에 대한 인바운드 액세스를 제공하는 데 사용할 외부 포트 범위의 마지막 포트 번호입니다. 허용되는 값은 Batch 서비스에서 예약한 포트 50000에서 55000을 제외하고 1에서 65534 사이입니다. 풀 내의 모든 범위는 고유해야 하며 겹칠 수 없습니다. 각 범위에는 40개 이상의 포트가 포함되어야 합니다. 예약되거나 겹치는 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다.
frontendPortRangeStart	integer	개별 컴퓨팅 노드의 backendPort에 대한 인바운드 액세스를 제공하는 데 사용할 외부 포트 범위의 첫 번째 포트 번호입니다. 허용되는 값은 예약된 포트 50000에서 55000을 제외하고 1에서 65534 사이입니다. 풀 내의 모든 범위는 고유해야 하며 겹칠 수 없습니다. 각 범위에는 40개 이상의 포트가 포함되어야 합니다. 예약되거나 겹치는 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다.
name	string	엔드포인트의 이름입니다. 이름은 Batch 풀 내에서 고유해야 하며 문자, 숫자, 밑줄, 마침표 및 하이픈을 포함할 수 있습니다. 이름은 문자 또는 숫자로 시작해야 하고 문자, 숫자 또는 밑줄로 끝나야 하며 77자를 초과할 수 없습니다. 잘못된 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다.
networkSecurityGroupRules	NetworkSecurityGroupRule[]	엔드포인트에 적용할 네트워크 보안 그룹 규칙 목록입니다. Batch 풀의 모든 엔드포인트에서 지정할 수 있는 최대 규칙 수는 25개입니다. 네트워크 보안 그룹 규칙을 지정하지 않으면 지정된 backendPort에 대한 인바운드 액세스를 허용하는 기본 규칙이 만들어집니다. 최대 네트워크 보안 그룹 규칙 수를 초과하는 경우 HTTP 상태 코드 400으로 인해 요청이 실패합니다.
protocol	InboundEndpointProtocol	엔드포인트의 프로토콜입니다.

IPAddressProvisioningType

풀의 공용 IP 주소에 대한 프로비저닝 유형입니다.

Name	형식	Description
batchmanaged	string	공용 IP는 Batch에서 만들고 관리합니다. 풀의 크기에 따라 여러 공용 IP가 있을 수 있습니다.
nopublicipaddresses	string	공용 IP 주소가 만들어지지 않습니다.
usermanaged	string	공용 IP는 사용자가 제공하며 컴퓨팅 노드를 프로비전하는 데 사용됩니다.

JobConstraints

작업에 대한 실행 제약 조건입니다.

Name	형식	Description
maxTaskRetryCount	integer	각 작업이 다시 시도될 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(초기 시도 1회, 다시 시도 3회)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스는 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1이면 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 기본값은 0(재시도 안 함)입니다.
maxWallClockTime	string	작업이 생성되는 시간부터 측정된 작업이 실행될 수 있는 최대 경과 시간입니다. 작업이 시간 제한 내에서 완료되지 않으면 Batch 서비스에서 작업을 종료하고 여전히 실행 중인 모든 작업을 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다.

JobExecutionInformation

Azure Batch 서비스에서 작업의 실행에 대한 정보를 포함합니다.

Name	형식	Description
endTime	string	작업의 완료 시간입니다. 이 속성은 작업이 완료된 상태인 경우에만 설정됩니다.
poolId	string	이 작업이 할당된 풀의 ID입니다. 이 요소에는 작업이 할당된 실제 풀이 포함됩니다. 서비스에서 작업 세부 정보를 가져올 때 job이 추가되거나 업데이트되었을 때의 풀 구성 데이터가 포함된 poolInfo 요소도 포함됩니다. 해당 poolInfo 요소에는 poolId 요소도 포함될 수 있습니다. 이 경우 두 ID는 동일합니다. 그렇지 않으면 작업이 자동 풀에서 실행되고 이 속성에 해당 자동 풀의 ID가 포함됩니다.
schedulingError	JobSchedulingError	작업을 시작할 때 서비스에서 발생한 오류에 대한 세부 정보입니다. 작업을 시작하는 동안 오류가 없으면 이 속성이 설정되지 않습니다.
startTime	string	작업의 시작 시간입니다. 작업이 만들어진 시간입니다.
terminateReason	string	작업이 종료된 이유를 설명하는 문자열입니다. 이 속성은 작업이 완료된 상태인 경우에만 설정됩니다. Batch 서비스가 작업을 종료하면 JMComplete - 작업 관리자 작업이 완료되고 killJobOnCompletion이 true로 설정된 이유를 다음과 같이 설정합니다. MaxWallClockTimeExpiry - 작업이 maxWallClockTime 제약 조건에 도달했습니다. TerminateJobSchedule - 작업이 일정의 일부로 실행되고 일정이 종료되었습니다. AllTasksComplete - 작업의 onAllTasksComplete 특성이 terminatejob으로 설정되고 작업의 모든 작업이 완료됩니다. TaskFailed - 작업의 onTaskFailure 특성이exitOptionsJobAction을 수행하도록 설정되었으며 작업에서 task가 terminatejob의 jobAction을 지정한 종료 조건으로 실패했습니다. 다른 문자열은 '작업 종료' 작업에 대한 호출에 지정된 사용자 정의 이유입니다.

JobManagerTask

작업 관리자 작업의 세부 정보를 지정합니다.

Name	형식	Description
allowLowPriorityNode	boolean	작업 관리자 태스크가 스폿/우선 순위가 낮은 컴퓨팅 노드에서 실행할 수 있는지 여부입니다. 기본값은 true입니다.
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/en-us/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가 해당 파일에 액세스할 수 없습니다.
displayName	string	작업 관리자 작업의 표시 이름입니다. 고유할 필요는 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
environmentSettings	EnvironmentSetting[]	작업 관리자 태스크에 대한 환경 변수 설정 목록입니다.
id	string	작업 내에서 작업 관리자 태스크를 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다.
killJobOnCompletion	boolean	작업 관리자 태스크 완료가 전체 작업의 완료를 나타내는지 여부입니다. true이면 작업 관리자 태스크가 완료되면 Batch 서비스에서 작업을 완료로 표시합니다. 현재 작업 릴리스 이외의 작업이 계속 실행 중인 경우 해당 작업이 종료됩니다. false이면 작업 관리자 태스크 완료가 작업 상태 영향을 주지 않습니다. 이 경우 onAllTasksComplete 특성을 사용하여 작업을 종료하거나 클라이언트 또는 사용자가 작업을 명시적으로 종료하도록 해야 합니다. 예를 들어 작업 관리자가 작업 집합을 만든 다음 실행에서 더 이상 역할을 수행하지 않는 경우입니다. 기본값은 true입니다. onAllTasksComplete 및 onTaskFailure 특성을 사용하여 작업 수명을 제어하고 작업 관리자 태스크를 사용하여 작업에 대한 작업만 만드는 경우(진행률을 모니터링하지 않음) killJobOnCompletion을 false로 설정하는 것이 중요합니다.
outputFiles	OutputFile[]	명령줄을 실행한 후 Batch 서비스가 컴퓨팅 노드에서 업로드할 파일 목록입니다. 다중 instance 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.
requiredSlots	integer	태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 instance 작업의 경우 이 속성은 지원되지 않으며 지정해서는 안 됩니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
runExclusive	boolean	작업 관리자 태스크가 실행되는 컴퓨팅 노드를 단독으로 사용해야 하는지 여부입니다. true이면 작업 관리자가 실행되는 동안 동일한 노드에서 다른 작업이 실행되지 않습니다. false이면 컴퓨팅 노드의 작업 관리자와 동시에 다른 작업을 실행할 수 있습니다. 작업 관리자 태스크는 일반적으로 컴퓨팅 노드의 동시 작업 제한에 대해 계산되므로 컴퓨팅 노드에서 여러 동시 작업을 허용하는 경우에만 관련이 있습니다. 기본값은 true입니다.
userIdentity	UserIdentity	작업 관리자 태스크가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

JobNetworkConfiguration

작업에 대한 네트워크 구성입니다.

Name	형식	Description
subnetId	string	작업에서 작업을 실행하는 컴퓨팅 노드가 작업 기간 동안 조인할 가상 네트워크 서브넷의 ARM 리소스 식별자입니다. VirtualMachineConfiguration 풀에서만 작동합니다. 가상 네트워크는 Azure Batch 계정과 동일한 지역 및 구독에 있어야 합니다. 지정된 서브넷에는 작업에서 작업을 실행할 컴퓨팅 노드 수를 수용할 수 있는 충분한 IP 주소가 있어야 합니다. 풀의 컴퓨팅 노드 수까지 가능합니다. 'MicrosoftAzureBatch' 서비스 주체에는 지정된 VNet에 대한 '클래식 가상 머신 기여자' Role-Based Access Control(RBAC) 역할이 있어야 Azure Batch 서비스가 노드에서 작업을 예약할 수 있습니다. 지정된 VNet에 연결된 NSG(네트워크 보안 그룹)가 있는지 확인하여 확인할 수 있습니다. NSG에서 지정된 서브넷의 노드에 대한 통신이 거부되면 Batch 서비스는 컴퓨팅 노드의 상태를 사용할 수 없음으로 설정합니다. /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}형식입니다. 지정된 VNet에 연결된 NSG(네트워크 보안 그룹)가 있는 경우 Azure Batch 서비스의 인바운드 통신에 대해 몇 가지 예약된 시스템 포트를 사용하도록 설정해야 합니다. Virtual Machine 구성을 사용하여 만든 풀의 경우 29876 및 29877 포트와 Linux용 포트 22 및 Windows용 포트 3389를 사용하도록 설정합니다. 또한 Azure Storage에 대한 통신을 위해 아웃바운드 연결을 위해 포트 443을 열어야 합니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

JobPreparationTask

지정된 컴퓨팅 노드에서 작업의 태스크 앞에 실행할 작업 준비 태스크입니다.

Name	형식	Description
commandLine	string	작업 준비 태스크의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: Windows에서 "cmd /c MyCommand"를 사용하거나 Linux에서 "/bin/sh -c MyCommand"). 명령줄이 파일 경로를 참조하는 경우 상대 경로(작업 작업 디렉터리를 기준으로)를 사용하거나 Batch 제공 환경 변수(https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables)를 사용해야 합니다.
constraints	TaskConstraints	작업 준비 태스크에 적용되는 제약 조건입니다.
containerSettings	TaskContainerSettings	작업 준비 태스크가 실행되는 컨테이너에 대한 설정입니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
environmentSettings	EnvironmentSetting[]	작업 준비 태스크에 대한 환경 변수 설정 목록입니다.
id	string	작업 내에서 작업 준비 태스크를 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. 이 속성을 지정하지 않으면 Batch 서비스에서 기본값 'jobpreparation'을 할당합니다. 작업의 다른 태스크는 작업 준비 태스크와 동일한 ID를 가질 수 없습니다. 동일한 ID로 작업을 제출하려고 하면 Batch 서비스에서 TaskIdSameAsJobPreparationTask 오류 코드로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 409(충돌)입니다.
rerunOnNodeRebootAfterSuccess	boolean	컴퓨팅 노드가 다시 부팅된 후 Batch 서비스가 작업 준비 태스크를 다시 실행해야 하는지 여부입니다. 컴퓨팅 노드가 이미지로 다시 설치되거나 작업 준비 태스크가 완료되지 않은 경우(예: 작업이 실행되는 동안 다시 부팅이 발생했기 때문에) 작업 준비 태스크가 항상 다시 실행됩니다. 따라서 항상 작업 준비 태스크를 멱등 상태로 작성하고 여러 번 실행하는 경우 올바르게 동작해야 합니다. 기본값은 true입니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
userIdentity	UserIdentity	작업 준비 태스크가 실행되는 사용자 ID입니다. 생략하면 작업은 Windows 컴퓨팅 노드의 태스크에 고유한 비관리 사용자 또는 Linux 컴퓨팅 노드의 풀에 고유한 비관리 사용자로 실행됩니다.
waitForSuccess	boolean	Batch 서비스가 컴퓨팅 노드에서 작업의 다른 작업을 예약하기 전에 작업 준비 태스크가 성공적으로 완료될 때까지 기다려야 하는지 여부입니다. 작업 준비 태스크가 종료 코드 0으로 종료되면 성공적으로 완료되었습니다. true이고 작업 준비 태스크가 노드에서 실패하면 Batch 서비스는 작업 준비 태스크를 최대 재시도 횟수까지 다시 시도합니다(제약 조건 요소에 지정된 대로). 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 작업의 작업을 노드로 예약하지 않습니다. 노드는 활성 상태로 유지되며 다른 작업의 작업을 실행할 수 있습니다. false이면 Batch 서비스는 작업 준비 태스크가 완료될 때까지 기다리지 않습니다. 이 경우 작업 준비 태스크가 계속 실행되는 동안 다른 작업 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. 작업 준비 태스크가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다.

JobReleaseTask

작업이 실행된 컴퓨팅 노드에서 작업 완료 시 실행할 작업 릴리스 작업입니다.

Name	형식	Description
commandLine	string	작업 릴리스 태스크의 명령줄입니다. 명령줄은 셸에서 실행되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용하려면 명령줄에서 셸을 호출해야 합니다(예: 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	작업 릴리스 태스크가 실행되는 컨테이너에 대한 설정입니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.
environmentSettings	EnvironmentSetting[]	작업 릴리스 태스크에 대한 환경 변수 설정 목록입니다.
id	string	작업 내에서 작업 릴리스 태스크를 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. 이 속성을 지정하지 않으면 Batch 서비스에서 기본값 'jobrelease'를 할당합니다. 작업의 다른 태스크는 작업 릴리스 태스크와 동일한 ID를 가질 수 없습니다. 동일한 ID로 작업을 제출하려고 하면 Batch 서비스에서 TaskIdSameAsJobReleaseTask 오류 코드로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 409(충돌)입니다.
maxWallClockTime	string	작업 릴리스 태스크가 지정된 컴퓨팅 노드에서 실행될 수 있는 최대 경과 시간(태스크 시작 시간부터 측정)입니다. 태스크가 시간 제한 내에서 완료되지 않으면 Batch 서비스에서 종료합니다. 기본값은 15분입니다. 15분보다 긴 시간 제한을 지정할 수 없습니다. 이렇게 하면 Batch 서비스에서 오류와 함께 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다.
retentionTime	string	컴퓨팅 노드의 작업 릴리스 태스크에 대한 작업 디렉터리를 유지하는 최소 시간입니다. 이 시간이 지나면 Batch 서비스에서 작업 디렉터리와 모든 내용을 삭제할 수 있습니다. 기본값은 7일입니다. 즉, 컴퓨팅 노드가 제거되거나 작업이 삭제되지 않는 한 작업 디렉터리가 7일 동안 유지됩니다.
userIdentity	UserIdentity	작업 릴리스 태스크가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

JobSchedulingError

작업을 예약할 때 Batch 서비스에서 발생한 오류입니다.

Name	형식	Description
category	ErrorCategory	작업 예약 오류의 범주입니다.
code	string	작업 예약 오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
details	NameValuePair[]	예약 오류와 관련된 추가 오류 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 작업 예약 오류를 설명하는 메시지입니다.

JobState

작업의 상태입니다.

Name	형식	Description
active	string	작업을 예약할 수 있습니다.
completed	string	모든 작업이 종료되었으며 시스템은 더 이상 작업 또는 작업에 대한 추가 변경 내용을 허용하지 않습니다.
deleting	string	사용자가 작업을 삭제해 달라고 요청했지만 삭제 작업이 아직 진행 중입니다(예: 시스템이 실행 중인 작업을 종료하고 있기 때문).
disabled	string	사용자가 작업을 사용하지 않도록 설정했습니다. 실행 중인 작업이 없고 새 작업이 예약되지 않습니다.
disabling	string	사용자가 작업을 사용하지 않도록 요청했지만 사용 안 함 작업이 아직 진행 중입니다(예: 작업이 종료될 때까지 대기).
enabling	string	사용자가 작업을 사용하도록 요청했지만 사용 작업은 아직 진행 중입니다.
terminating	string	작업 관리자 작업이 완료되었거나 사용자가 작업을 종료했기 때문에 작업이 완료되려고 하지만 종료 작업이 아직 진행 중입니다(예: 작업 릴리스 작업이 실행 중이기 때문).

JobStatistics

작업에 대한 리소스 사용 통계입니다.

Name	형식	Description
kernelCPUTime	string	작업의 모든 태스크에서 사용하는 총 커널 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합산)입니다.
lastUpdateTime	string	통계가 마지막으로 업데이트된 시간입니다. 모든 통계는 startTime과 lastUpdateTime 사이의 범위로 제한됩니다.
numFailedTasks	integer	지정된 시간 범위 동안 실패한 작업의 총 작업 수입니다. 태스크는 종료 코드 0을 반환하지 않고 최대 재시도 횟수를 소모하는 경우 실패합니다.
numSucceededTasks	integer	지정된 시간 범위 동안 작업에서 완료된 총 작업 수입니다. 종료 코드 0을 반환하면 작업이 성공적으로 완료됩니다.
numTaskRetries	integer	지정된 시간 범위 동안 작업의 모든 작업에 대한 총 재시도 횟수입니다.
readIOGiB	number	작업의 모든 작업에서 디스크에서 읽은 GiB의 총 데이터 양입니다.
readIOps	integer	작업의 모든 태스크에서 수행한 총 디스크 읽기 작업 수입니다.
startTime	string	통계에서 다루는 시간 범위의 시작 시간입니다.
url	string	통계의 URL입니다.
userCPUTime	string	작업의 모든 태스크에서 사용하는 총 사용자 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합산)입니다.
waitTime	string	작업에 있는 모든 작업의 총 대기 시간입니다. 태스크 대기 시간은 작업 만들기와 작업 실행 시작 사이의 경과된 시간으로 정의됩니다. (오류로 인해 태스크를 다시 시도하는 경우 대기 시간은 가장 최근 작업 실행까지의 시간입니다.) 이 값은 계정 수명 통계에서만 보고됩니다. 작업 통계에 포함되지 않습니다.
wallClockTime	string	작업에 있는 모든 작업의 총 벽 클록 시간입니다. 벽시계 시간은 태스크가 컴퓨팅 노드에서 실행되기 시작한 시점부터 완료된 시점(또는 통계가 업데이트된 마지막 시간까지, 작업이 그때까지 완료되지 않은 경우)까지 경과된 시간입니다. 작업을 다시 시도하면 모든 작업 재시도의 벽시계 시간이 포함됩니다.
writeIOGiB	number	작업의 모든 태스크에서 디스크에 기록된 GiB의 총 데이터 양입니다.
writeIOps	integer	작업의 모든 태스크에서 수행한 총 디스크 쓰기 작업 수입니다.

LinuxUserConfiguration

Linux 컴퓨팅 노드에서 사용자 계정을 만드는 데 사용되는 속성입니다.

Name	형식	Description
gid	integer	사용자 계정의 그룹 ID입니다. uid 및 gid 속성은 함께 지정하거나 지정하지 않아야 합니다. 지정하지 않으면 기본 운영 체제가 gid를 선택합니다.
sshPrivateKey	string	사용자 계정에 대한 SSH 프라이빗 키입니다. 프라이빗 키는 암호로 보호되어서는 안 됩니다. 프라이빗 키는 풀의 enableInterNodeCommunication 속성이 true일 때 Linux 풀의 컴퓨팅 노드 간에 SSH에 대한 비대칭 키 기반 인증을 자동으로 구성하는 데 사용됩니다(enableInterNodeCommunication이 false이면 무시됨). 이 작업은 키 쌍을 사용자의 .ssh 디렉터리에 배치하여 수행합니다. 지정하지 않으면 컴퓨팅 노드 간에 암호 없는 SSH가 구성되지 않습니다(사용자의 .ssh 디렉터리를 수정하지 않음).
uid	integer	사용자 계정의 사용자 ID입니다. uid 및 gid 속성은 함께 지정하거나 지정하지 않아야 합니다. 지정하지 않으면 기본 운영 체제가 uid를 선택합니다.

LoginMode

사용자의 로그인 모드

Name	형식	Description
batch	string	LOGON32_LOGON_BATCH Win32 로그인 모드입니다. 일괄 처리 로그인 모드는 장기 실행 병렬 프로세스에 권장됩니다.
interactive	string	LOGON32_LOGON_INTERACTIVE Win32 로그인 모드입니다. UAC는 Windows VirtualMachineConfiguration 풀에서 사용하도록 설정됩니다. 이 옵션을 Windows VirtualMachineConfiguration 풀에서 관리자 권한으로 사용하는 경우 작업 명령줄에서 실행되는 애플리케이션이 항상 관리 권한을 요구하거나 항상 최대 권한을 요구하도록 구성되지 않는 한 사용자 세션은 상승되지 않습니다.

ManagedDisk

Name	형식	Description
storageAccountType	StorageAccountType	관리 디스크의 스토리지 계정 유형입니다.

MetadataItem

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

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

MountConfiguration

각 노드에 탑재할 파일 시스템입니다.

Name	형식	Description
azureBlobFileSystemConfiguration	AzureBlobFileSystemConfiguration	각 노드에서 Blob FUSE를 사용하여 탑재할 Azure Storage 컨테이너입니다. 이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.
azureFileShareConfiguration	AzureFileShareConfiguration	각 노드에 탑재할 Azure 파일 공유입니다. 이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.
cifsMountConfiguration	CIFSMountConfiguration	각 노드에 탑재할 CIFS/SMB 파일 시스템입니다. 이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.
nfsMountConfiguration	NFSMountConfiguration	각 노드에 탑재할 NFS 파일 시스템입니다. 이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

NameValuePair

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

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

NetworkConfiguration

풀에 대한 네트워크 구성입니다.

Name	형식	Description
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	동적 vnet 할당의 scope.
enableAcceleratedNetworking	boolean	이 풀이 가속화된 네트워킹을 사용하도록 설정해야 하는지 여부입니다. 가속화된 네트워킹을 사용하면 VM에 대한 SR-IOV(단일 루트 I/O 가상화)가 가능하므로 네트워킹 성능이 향상될 수 있습니다. 자세한 내용은 https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview 를 참조하세요.
endpointConfiguration	PoolEndpointConfiguration	Batch 풀의 컴퓨팅 노드에 있는 엔드포인트에 대한 구성입니다. 풀 엔드포인트 구성은 virtualMachineConfiguration 속성이 있는 풀에서만 지원됩니다.
publicIPAddressConfiguration	PublicIPAddressConfiguration	Batch 풀의 컴퓨팅 노드에 대한 공용 IPAddress 구성입니다. 공용 IP 구성 속성은 virtualMachineConfiguration 속성이 있는 풀에서만 지원됩니다.
subnetId	string	풀의 컴퓨팅 노드가 조인할 가상 네트워크 서브넷의 ARM 리소스 식별자입니다. /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}형식입니다. 가상 네트워크는 Azure Batch 계정과 동일한 지역 및 구독에 있어야 합니다. 지정된 서브넷에는 풀의 컴퓨팅 노드 수를 수용할 수 있는 충분한 사용 가능한 IP 주소가 있어야 합니다. 서브넷에 사용 가능한 IP 주소가 충분하지 않으면 풀이 노드를 부분적으로 할당하고 크기 조정 오류가 발생합니다. 'MicrosoftAzureBatch' 서비스 주체에는 지정된 VNet에 대한 '클래식 가상 머신 기여자' Role-Based Access Control(RBAC) 역할이 있어야 합니다. 지정된 서브넷은 노드에서 작업을 예약할 수 있도록 Azure Batch 서비스의 통신을 허용해야 합니다. 지정된 VNet에 연결된 NSG(네트워크 보안 그룹)가 있는지 확인하여 확인할 수 있습니다. 지정된 서브넷의 노드에 대한 통신이 NSG에서 거부되면 Batch 서비스는 컴퓨팅 노드의 상태를 사용할 수 없도록 설정합니다. virtualMachineConfiguration으로 만든 풀의 경우 ARM 가상 네트워크('Microsoft.Network/virtualNetworks')만 지원되지만 cloudServiceConfiguration으로 만든 풀의 경우 ARM 및 클래식 가상 네트워크가 모두 지원됩니다. 지정된 VNet에 연결된 NSG(네트워크 보안 그룹)가 있는 경우 인바운드 통신에 대해 몇 개의 예약된 시스템 포트를 사용할 수 있어야 합니다. 가상 머신 구성을 사용하여 만든 풀의 경우 29876 및 29877 포트와 Linux용 포트 22 및 Windows용 포트 3389를 사용하도록 설정합니다. 클라우드 서비스 구성을 사용하여 만든 풀의 경우 포트 10100, 20100 및 30100을 사용하도록 설정합니다. 또한 포트 443에서 Azure Storage에 대한 아웃바운드 연결을 사용하도록 설정합니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

인바운드 엔드포인트에 적용할 네트워크 보안 그룹 규칙입니다.

Name	형식	Description
access	NetworkSecurityGroupRuleAccess	지정된 IP 주소, 서브넷 범위 또는 태그에 대해 수행해야 하는 작업입니다.
priority	integer	이 규칙의 우선 순위입니다. 풀 내의 우선 순위는 고유해야 하며 우선 순위 순서대로 평가됩니다. 번호가 낮을수록 우선순위가 높습니다. 예를 들어 순서 번호가 150, 250 및 350인 규칙을 지정할 수 있습니다. 순서 번호가 150인 규칙이 순서가 250인 규칙보다 우선합니다. 허용되는 우선 순위는 150~4096입니다. 예약된 값 또는 중복 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다.
sourceAddressPrefix	string	규칙에 일치시킬 원본 주소 접두사 또는 태그입니다. 유효한 값은 단일 IP 주소(예: 10.10.10.10), IP 서브넷(예: 192.168.1.0/24), 기본 태그 또는 *(모든 주소의 경우)입니다. 다른 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다.
sourcePortRanges	string[]	규칙과 일치할 원본 포트 범위입니다. 유효한 값은 ''(모든 포트 0 - 65535), 특정 포트(즉, 22) 또는 포트 범위(예: 100-200)입니다. 포트는 0에서 65535 범위여야 합니다. 이 컬렉션의 각 항목은 다른 항목(범위 또는 개별 포트)과 겹치지 않아야 합니다. 다른 값이 제공되면 요청이 HTTP 상태 코드 400으로 실패합니다. 기본값은 ''입니다.

NetworkSecurityGroupRuleAccess

지정된 IP 주소, 서브넷 범위 또는 태그에 대해 수행해야 하는 작업입니다.

Name	형식	Description
allow	string	액세스를 허용합니다.
deny	string	액세스를 거부합니다.

NFSMountConfiguration

NFS 파일 시스템에 연결하는 데 사용되는 정보입니다.

Name	형식	Description
mountOptions	string	탑재 명령에 전달할 추가 명령줄 옵션입니다. 다음은 Windows의 '순 사용' 옵션과 Linux의 '탑재' 옵션입니다.
relativeMountPath	string	파일 시스템이 탑재될 컴퓨팅 노드의 상대 경로 모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.
source	string	탑재할 파일 시스템의 URI입니다.

NodeCommunicationMode

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

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

NodePlacementConfiguration

풀에 대한 노드 배치 구성입니다.

Name	형식	Description
policy	NodePlacementPolicyType	Batch 풀의 노드 배치 정책 유형입니다. Batch 서비스에서 노드를 프로비전하는 데 사용하는 할당 정책입니다. 지정하지 않으면 Batch는 지역 정책을 사용합니다.

NodePlacementPolicyType

풀에서 노드를 할당하기 위한 배치 정책입니다.

Name	형식	Description
regional	string	풀의 모든 노드는 동일한 지역에 할당됩니다.
zonal	string	풀의 노드는 최상의 분산을 통해 다양한 가용성 영역에 분산됩니다.

OnAllTasksComplete

작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다.

Name	형식	Description
noaction	string	아무 작업도 하지 않습니다. 다른 수단으로 종료되거나 사용하지 않도록 설정되지 않은 한 작업은 활성 상태로 유지됩니다.
terminatejob	string	작업을 종료합니다. 작업의 terminateReason이 'AllTasksComplete'로 설정됩니다.

OnTaskFailure

작업의 태스크가 실패할 때 Batch 서비스에서 수행해야 하는 작업입니다.

Name	형식	Description
noaction	string	아무 작업도 하지 않습니다. 다른 수단으로 종료되거나 사용하지 않도록 설정되지 않은 한 작업은 활성 상태로 유지됩니다.
performexitoptionsjobaction	string	Task의 exitConditions 컬렉션에서 작업 종료 조건과 연결된 작업을 수행합니다. (작업에서 지정한 경우 아무 작업도 수행되지 않을 수 있습니다.)

OSDisk

컴퓨팅 노드(VM)의 운영 체제 디스크에 대한 설정입니다.

Name	형식	Description
caching	CachingType	캐싱 요구 사항을 지정합니다. 가능한 값은 None, ReadOnly, ReadWrite입니다. 기본값은 표준 스토리지의 경우 없음입니다. Premium Storage용 ReadOnly. 캐싱의 기본값은 none입니다. 캐싱 옵션에 대한 자세한 내용은 을 참조하세요 https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
diskSizeGB	integer	새 OS 디스크를 만들 때의 초기 디스크 크기(GB)입니다.
ephemeralOSDiskSettings	DiffDiskSettings	컴퓨팅 노드(VM)에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
managedDisk	ManagedDisk	관리 디스크 매개 변수입니다.
writeAcceleratorEnabled	boolean	디스크에서 writeAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

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

PoolEndpointConfiguration

풀에 대한 엔드포인트 구성입니다.

Name	형식	Description
inboundNATPools	InboundNATPool[]	개별 컴퓨팅 노드의 특정 포트를 외부에서 처리하는 데 사용할 수 있는 인바운드 NAT 풀 목록입니다. Batch 풀당 최대 인바운드 NAT 풀 수는 5개입니다. 최대 인바운드 NAT 풀 수를 초과하는 경우 HTTP 상태 코드 400으로 인해 요청이 실패합니다. IPAddressProvisioningType이 NoPublicIPAddresses이면 지정할 수 없습니다.

PoolInformation

풀에 작업을 할당하는 방법을 지정합니다.

Name	형식	Description
autoPoolSpecification	AutoPoolSpecification	임시 '자동 풀'의 특징입니다. Batch 서비스는 작업이 제출될 때 이 자동 풀을 만듭니다. 자동 풀 만들기에 실패하면 Batch 서비스가 작업을 완료된 상태로 이동하고 풀 만들기 오류가 작업의 예약 오류 속성에 설정됩니다. Batch 서비스는 자동 풀의 수명(keepAlive를 지정하지 않는 한 생성 및 삭제 모두)을 관리합니다. 작업이 활성 상태인 동안 자동 풀의 수명에 영향을 주는 모든 사용자 작업은 예기치 않은 동작을 발생합니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.
poolId	string	기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다. 이 속성에서 참조하는 풀이 있는지 확인해야 합니다. Batch 서비스가 작업을 예약하려고 할 때 풀이 없으면 해당 ID가 있는 풀을 만들 때까지 작업에 대한 태스크가 실행되지 않습니다. Batch 서비스는 작업 요청을 거부하지 않습니다. 풀이 존재할 때까지 작업을 실행하지 않습니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.

PoolLifetimeOption

생성된 자동 풀의 최소 수명 및 일정에 따라 여러 작업이 풀에 할당되는 방식입니다.

Name	형식	Description
job	string	풀은 전용인 작업의 수명 동안 존재합니다. Batch 서비스는 작업을 만들 때 풀을 만듭니다. 'job' 옵션이 작업 일정에 적용되는 경우 Batch 서비스는 일정에 따라 생성된 모든 작업에 대해 새 자동 풀을 만듭니다.
jobschedule	string	풀은 작업 일정의 수명 동안 존재합니다. Batch 서비스는 일정에 따라 첫 번째 작업을 만들 때 풀을 만듭니다. 이 옵션은 작업이 아닌 작업 일정에만 적용할 수 있습니다.

PoolSpecification

새 풀을 만들기 위한 사양입니다.

Name	형식	Description
applicationLicenses	string[]	Batch 서비스가 풀의 각 컴퓨팅 노드에서 사용할 수 있도록 하는 애플리케이션 라이선스 목록입니다. 애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다. 풀에서 사용할 수 있는 허용된 라이선스는 'maya', 'vray', '3dsmax', 'arnold'입니다. 풀에 추가된 각 애플리케이션 라이선스에 대해 추가 요금이 적용됩니다.
applicationPackageReferences	ApplicationPackageReference[]	풀의 각 컴퓨팅 노드에 설치할 패키지 목록입니다. 풀을 만들 때 패키지의 애플리케이션 ID는 정규화되어야 합니다(/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅되거나 이미지로 다시 설치될 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다.
autoScaleEvaluationInterval	string	자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. 기본값은 15분입니다. 최소값과 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하는 경우 Batch 서비스는 잘못된 속성 값 오류로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
autoScaleFormula	string	풀에서 원하는 컴퓨팅 노드 수에 대한 수식입니다. enableAutoScale이 false로 설정된 경우 이 속성을 지정하면 안 됩니다. enableAutoScale이 true로 설정된 경우 필요합니다. 풀을 만들기 전에 수식이 유효한지 확인합니다. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다.
certificateReferences	CertificateReference[]	풀의 각 컴퓨팅 노드에 설치할 인증서 목록입니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 환경 변수 AZ_BATCH_CERTIFICATES_DIR 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다. 경고: 이 속성은 더 이상 사용되지 않으며 2024년 2월 이후에 제거됩니다. 대신 Azure KeyVault 확장을 사용하세요.
cloudServiceConfiguration	CloudServiceConfiguration	풀에 대한 클라우드 서비스 구성입니다. 풀을 Azure PaaS VM으로 만들어야 하는 경우 이 속성을 지정해야 합니다. 이 속성과 virtualMachineConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다. 둘 다 지정하지 않으면 Batch 서비스가 오류를 반환합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. Batch 계정이 poolAllocationMode 속성을 'UserSubscription'으로 설정하여 만든 경우 이 속성을 지정할 수 없습니다.
displayName	string	풀의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
enableAutoScale	boolean	풀 크기가 시간에 따라 자동으로 조정되어야 하는지 여부입니다. false이면 targetDedicatedNodes 및 targetLowPriorityNodes 중 하나 이상을 지정해야 합니다. true이면 autoScaleFormula 요소가 필요합니다. 풀은 수식에 따라 자동으로 크기가 조정됩니다. 기본값은 false입니다.
enableInterNodeCommunication	boolean	풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 노드 간 통신을 사용하도록 설정하면 풀의 컴퓨팅 노드에 대한 배포 제한으로 인해 풀의 최대 크기가 제한됩니다. 이로 인해 풀이 원하는 크기에 도달하지 못할 수 있습니다. 기본값은 false입니다.
metadata	MetadataItem[]	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다. Batch 서비스는 메타데이터에 의미를 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
mountConfiguration	MountConfiguration[]	풀의 각 노드에 탑재할 파일 시스템 목록입니다. Azure Files, NFS, CIFS/SMB 및 Blobfuse를 지원합니다.
networkConfiguration	NetworkConfiguration	풀에 대한 네트워크 구성입니다. 풀에 대한 네트워크 구성입니다.
resizeTimeout	string	풀에 컴퓨팅 노드를 할당하기 위한 시간 제한입니다. 이 시간 제한은 수동 크기 조정에만 적용됩니다. enableAutoScale이 true로 설정된 경우에는 아무런 효과가 없습니다. 기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스는 오류와 함께 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
resourceTags	object	풀과 연결된 사용자 지정 태그입니다. Azure Batch 풀과 연결할 사용자 정의 태그입니다. 지정된 경우 이러한 태그는 풀과 연결된 지원 Azure 리소스로 전파됩니다. 이 속성은 PoolAllocationMode 속성이 'UserSubscription'으로 설정된 Batch 계정을 만든 경우에만 지정할 수 있습니다.
startTask	StartTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행할 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다. Batch는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도합니다. 복구 작업의 예로는 비정상 노드가 다시 부팅되거나 호스트 오류로 인해 컴퓨팅 노드가 사라진 경우(하지만 제한되지 않음)가 있습니다. 복구 작업으로 인한 재시도는 독립적이며 maxTaskRetryCount에 대해 계산되지 않습니다. maxTaskRetryCount가 0이더라도 복구 작업으로 인한 내부 재시도가 발생할 수 있습니다. 이 때문에 모든 작업은 idempotent여야 합니다. 즉, 작업은 손상 또는 중복 데이터를 유발하지 않고 중단되고 다시 시작되는 것을 허용해야 합니다. 장기 실행 작업의 모범 사례는 일종의 검사점 지정을 사용하는 것입니다. 경우에 따라 컴퓨팅 노드가 다시 부팅되지 않았더라도 StartTask가 다시 실행될 수 있습니다. 중단 프로세스를 만들거나 StartTask 작업 디렉터리에서 서비스를 설치/시작하는 StartTasks를 방지하기 위해 특별히 주의해야 합니다. 이렇게 하면 Batch가 StartTask를 다시 실행할 수 없도록 차단됩니다.
targetDedicatedNodes	integer	풀에서 원하는 전용 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.
targetLowPriorityNodes	integer	풀에서 원하는 스폿/낮은 우선 순위 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.
targetNodeCommunicationMode	NodeCommunicationMode	풀에 대해 원하는 노드 통신 모드입니다. 생략하면 기본값은 Default입니다.
taskSchedulingPolicy	TaskSchedulingPolicy	풀의 컴퓨팅 노드에 태스크를 분산하는 방법. 지정하지 않으면 기본값이 분산됩니다.
taskSlotsPerNode	integer	풀의 단일 컴퓨팅 노드에서 동시 태스크를 실행하는 데 사용할 수 있는 태스크 슬롯의 수입니다. 기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256의 작은 값입니다.
userAccounts	UserAccount[]	풀의 각 컴퓨팅 노드에 만들 사용자 계정 목록입니다.
virtualMachineConfiguration	VirtualMachineConfiguration	풀에 대한 가상 머신 구성입니다. 풀을 Azure IaaS VM으로 만들어야 하는 경우 이 속성을 지정해야 합니다. 이 속성과 cloudServiceConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다. 둘 다 지정하지 않으면 Batch 서비스가 오류를 반환합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
vmSize	string	풀에 있는 가상 머신의 크기입니다. 풀의 모든 가상 머신 크기는 동일합니다. 풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀에서 컴퓨팅 노드에 대한 VM 크기 선택(https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes)을 참조하세요.

PublicIPAddressConfiguration

풀의 네트워킹 구성에 대한 공용 IP 주소 구성입니다.

Name	형식	Description
ipAddressIds	string[]	컴퓨팅 노드를 프로비전할 때 Batch 서비스에서 사용할 공용 IP 목록입니다. 여기에 지정된 IP 수는 풀의 최대 크기를 제한합니다. 각 공용 IP에 대해 100개의 전용 노드 또는 100개의 스폿/낮은 우선 순위 노드를 할당할 수 있습니다. 예를 들어 250개의 전용 VM이 필요한 풀에는 3개 이상의 공용 IP가 지정되어 있어야 합니다. 이 컬렉션의 각 요소는 /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}형식입니다.
provision	IPAddressProvisioningType	풀의 공용 IP 주소에 대한 프로비저닝 유형입니다. 기본값은 BatchManaged입니다.

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

SecurityProfile

가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다.

Name	형식	Description
encryptionAtHost	boolean	이 속성은 요청의 사용자가 가상 머신 또는 가상 머신 확장 집합에 대한 호스트 암호화를 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다. 이렇게 하면 호스트 자체의 리소스/임시 디스크를 비롯한 모든 디스크에 대한 암호화가 활성화됩니다.
securityType	SecurityTypes	가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다.
uefiSettings	UefiSettings	가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다. 가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다.

SecurityTypes

가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다.

Name	형식	Description
trustedLaunch	string	신뢰할 수 있는 시작은 지속적인 고급 공격 기술로부터 보호합니다.

ServiceArtifactReference

'최신' 이미지 버전을 사용할 때 확장 집합의 모든 가상 머신에 대해 동일한 이미지 버전을 설정하는 데 사용되는 서비스 아티팩트 참조 ID를 지정합니다.

Name	형식	Description
id	string	ServiceArtifactReference의 서비스 아티팩트 참조 ID /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} 형식의 서비스 아티팩트 참조 ID입니다.

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	작업을 재시도할 수 있는 최대 횟수입니다. 종료 코드가 0이 아닌 경우 Batch 서비스는 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스는 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 함)입니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다. 이 요소 아래에 나열된 파일은 작업의 작업 디렉터리에 있습니다.
userIdentity	UserIdentity	StartTask가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.
waitForSuccess	boolean	컴퓨팅 노드에서 작업을 예약하기 전에 Batch 서비스가 StartTask가 성공적으로 완료될 때까지 기다려야 하는지 여부(즉, 종료 코드 0으로 종료). true이고 Node에서 StartTask가 실패하면 Batch 서비스는 StartTask를 최대 재시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 실패 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 컴퓨팅 노드에서 새 작업이 계속 예약됩니다. 기본값은 true입니다.

StorageAccountType

데이터 디스크 또는 OS 디스크를 만드는 데 사용할 스토리지 계정 유형입니다.

Name	형식	Description
premium_lrs	string	데이터 디스크/OS 디스크는 프리미엄 로컬 중복 스토리지를 사용해야 합니다.
standard_lrs	string	데이터 디스크/OS 디스크는 표준 로컬 중복 스토리지를 사용해야 합니다.
standardssd_lrs	string	데이터 디스크/OS 디스크는 표준 SSD 로컬 중복 스토리지를 사용해야 합니다.

TaskConstraints

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

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

TaskContainerSettings

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

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

TaskSchedulingPolicy

컴퓨팅 노드에 태스크를 분산하는 방법을 지정합니다.

Name	형식	Description
nodeFillType	ComputeNodeFillType	풀의 컴퓨팅 노드에 태스크를 분산하는 방법. 지정하지 않으면 기본값이 분산됩니다.

UefiSettings

가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다.

Name	형식	Description
secureBootEnabled	boolean	가상 머신에서 보안 부팅을 사용하도록 설정할지 여부를 지정합니다.
vTpmEnabled	boolean	가상 머신에서 vTPM을 사용하도록 설정할지 여부를 지정합니다.

UserAccount

Azure Batch 컴퓨팅 노드에서 작업을 실행하는 데 사용되는 사용자를 만드는 데 사용되는 속성입니다.

Name	형식	Description
elevationLevel	ElevationLevel	사용자 계정의 권한 상승 수준입니다. 기본값은 nonAdmin입니다.
linuxUserConfiguration	LinuxUserConfiguration	사용자 계정에 대한 Linux 관련 사용자 구성입니다. 이 속성은 Windows 풀에 지정된 경우 무시됩니다. 지정하지 않으면 기본 옵션을 사용하여 사용자가 만들어집니다.
name	string	사용자 계정의 이름입니다. 이름은 최대 길이가 20인 유니코드 문자를 포함할 수 있습니다.
password	string	사용자 계정의 암호입니다.
windowsUserConfiguration	WindowsUserConfiguration	사용자 계정에 대한 Windows 관련 사용자 구성입니다. 이 속성은 사용자가 Windows 풀에 있는 경우에만 지정할 수 있습니다. 를 지정하지 않으면 Windows 풀에서 사용자가 기본 옵션을 사용하여 만들어집니다.

UserIdentity

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

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

VirtualMachineConfiguration

Azure Virtual Machines 인프라를 기반으로 풀의 컴퓨팅 노드에 대한 구성입니다.

Name	형식	Description
containerConfiguration	ContainerConfiguration	풀에 대한 컨테이너 구성입니다. 지정된 경우 작업이 컨테이너에서 실행되도록 풀의 각 컴퓨팅 노드에서 설치가 수행됩니다. 이 풀에서 실행되는 모든 일반 작업 및 작업 관리자 작업은 containerSettings 속성을 지정해야 하며 다른 모든 작업에서 지정할 수 있습니다.
dataDisks	DataDisk[]	풀의 컴퓨팅 노드에 연결된 데이터 디스크에 대한 구성입니다. 풀의 컴퓨팅 노드에 빈 데이터 디스크가 연결되어 있어야 하는 경우 이 속성을 지정해야 합니다. 업데이트할 수 없습니다. 각 컴퓨팅 노드는 자체 디스크를 가져옵니다(디스크는 파일 공유가 아님). 기존 디스크는 연결할 수 없으며 연결된 각 디스크는 비어 있습니다. 컴퓨팅 노드가 풀에서 제거되면 디스크와 연결된 모든 데이터도 삭제됩니다. 연결한 후 디스크의 형식이 지정되지 않았으므로 사용하기 전에 포맷해야 합니다. 자세한 내용은 및 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine를 참조하세요https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux.
diskEncryptionConfiguration	DiskEncryptionConfiguration	풀에 대한 디스크 암호화 구성입니다. 지정된 경우 노드 프로비저닝 중에 풀의 각 노드에서 암호화가 수행됩니다.
extensions	VMExtension[]	풀에 대한 가상 머신 확장입니다. 지정된 경우 이 구성에 언급된 확장이 각 노드에 설치됩니다.
imageReference	ImageReference	사용할 Azure Virtual Machines Marketplace 이미지 또는 사용자 지정 Virtual Machine 이미지에 대한 참조입니다.
licenseType	string	운영 체제를 배포할 때 사용할 온-프레미스 라이선스 유형입니다. 이는 Windows 운영 체제를 포함하는 이미지에만 적용되며 배포될 컴퓨팅 노드에 유효한 온-프레미스 라이선스를 보유하는 경우에만 사용해야 합니다. 생략하면 온-프레미스 라이선스 할인이 적용되지 않습니다. 값은 다음과 같습니다. Windows_Server - 온-프레미스 라이선스는 Windows Server용입니다. Windows_Client - 온-프레미스 라이선스는 Windows 클라이언트용입니다.
nodeAgentSKUId	string	풀의 컴퓨팅 노드에 프로비전할 Batch Compute Node 에이전트의 SKU입니다. Batch Compute Node 에이전트는 풀의 각 컴퓨팅 노드에서 실행되는 프로그램이며 컴퓨팅 노드와 Batch 서비스 간의 명령 및 제어 인터페이스를 제공합니다. 다양한 운영 체제에 대해 SKU라고 하는 컴퓨팅 노드 에이전트의 구현이 다릅니다. 선택한 이미지 참조와 일치하는 컴퓨팅 노드 에이전트 SKU를 지정해야 합니다. 확인된 이미지 참조 목록과 함께 지원되는 컴퓨팅 노드 에이전트 SKU 목록을 얻으려면 '지원되는 컴퓨팅 노드 에이전트 SKU 나열' 작업을 참조하세요.
nodePlacementConfiguration	NodePlacementConfiguration	풀에 대한 노드 배치 구성입니다. 이 구성은 풀의 노드를 물리적으로 할당하는 방법에 대한 규칙을 지정합니다.
osDisk	OSDisk	Virtual Machine의 운영 체제 디스크에 대한 설정입니다.
securityProfile	SecurityProfile	가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다. 가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다.
serviceArtifactReference	ServiceArtifactReference	'최신' 이미지 버전을 사용할 때 확장 집합의 모든 가상 머신에 대해 동일한 이미지 버전을 설정하는 데 사용되는 서비스 아티팩트 참조 ID를 지정합니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} 형식의 서비스 아티팩트 참조 ID입니다.
windowsConfiguration	WindowsConfiguration	가상 머신의 Windows 운영 체제 설정입니다. imageReference 속성이 Linux OS 이미지를 지정하는 경우 이 속성을 지정해서는 안 됩니다.

VMExtension

가상 머신 확장에 대한 구성입니다.

Name	형식	Description
autoUpgradeMinorVersion	boolean	배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.
enableAutomaticUpgrade	boolean	사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 나타냅니다.
name	string	가상 머신 확장의 이름입니다.
protectedSettings	object	확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 없습니다.
provisionAfterExtensions	string[]	확장 이름의 컬렉션입니다. 이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.
publisher	string	확장 처리기 게시자의 이름입니다.
settings	object	확장에 대한 JSON 형식의 공용 설정입니다.
type	string	확장의 형식입니다.
typeHandlerVersion	string	스크립트 처리기의 버전입니다.

WindowsConfiguration

가상 머신에 적용할 Windows 운영 체제 설정입니다.

Name	형식	Description
enableAutomaticUpdates	boolean	가상 머신에서 자동 업데이트를 사용할 수 있는지 여부입니다. 생략하면 기본값은 true입니다.

WindowsUserConfiguration

Windows 컴퓨팅 노드에서 사용자 계정을 만드는 데 사용되는 속성입니다.

Name	형식	Description
loginMode	LoginMode	사용자의 로그인 모드 VirtualMachineConfiguration 풀의 기본값은 'batch'이며 CloudServiceConfiguration 풀의 경우 '대화형'입니다.