Job - Add

참조

서비스:: Batch Service

API 버전:: 2024-07-01.20.0

지정된 계정에 작업을 추가합니다.
Batch 서비스는 작업의 일부로 수행된 작업을 제어하는 두 가지 방법을 지원합니다. 첫 번째 방법에서 사용자는 작업 관리자 작업을 지정합니다. Batch 서비스는 작업을 시작할 준비가 되면 이 작업을 시작합니다. 작업 관리자 태스크는 작업 API를 사용하여 이 작업에서 실행되는 다른 모든 작업을 제어합니다. 두 번째 방법에서 사용자는 작업 API를 사용하여 활성 작업에서 태스크 실행을 직접 제어합니다. 또한 작업 이름을 지정할 때 사용자 이름 또는 비밀 프로젝트 이름과 같은 중요한 정보를 포함하지 않도록 합니다. 이 정보는 Microsoft 지원 엔지니어가 액세스할 수 있는 원격 분석 로그에 나타날 수 있습니다.

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

선택적 매개 변수:

POST {batchUrl}/jobs?timeout={timeout}&api-version=2024-07-01.20.0

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
api-version	query	True	string	클라이언트 API 버전입니다.
timeout	query		integer int32	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다. 값이 30보다 크면 기본값이 대신 사용됩니다.

요청 헤더

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

Name	형식	Description
client-request-id	string uuid	9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같은 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id	boolean	서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date	string date-time-rfc1123	요청이 발급된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name	필수	형식	Description
id	True	string	계정 내에서 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 계정 내에 대/소문자만 다른 ID가 두 개 없을 수 있음).
poolInfo	True	PoolInformation	Batch 서비스가 작업의 작업을 실행하는 풀입니다.
allowTaskPreemption		boolean	우선 순위가 높은 다른 작업에서 이 작업의 작업을 선점할 수 있는지 여부 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다.
commonEnvironmentSettings		EnvironmentSetting[]	일반적인 환경 변수 설정 목록입니다. 이러한 환경 변수는 작업의 모든 작업(작업 관리자, 작업 준비 및 작업 릴리스 작업 포함)에 대해 설정됩니다. 개별 작업은 동일한 설정 이름을 다른 값으로 지정하여 여기에 지정된 환경 설정을 재정의할 수 있습니다.
constraints		JobConstraints	작업에 대한 실행 제약 조건입니다. 작업에 대한 실행 제약 조건입니다.
displayName		string	작업의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
jobManagerTask		JobManagerTask	작업이 시작될 때 시작할 작업 관리자 작업의 세부 정보입니다. 작업에서 작업 관리자 태스크를 지정하지 않으면 사용자가 작업에 작업을 명시적으로 추가해야 합니다. 작업에서 작업 관리자 태스크를 지정하는 경우 Batch 서비스는 작업을 만들 때 작업 관리자 태스크를 만들고 작업에서 다른 작업을 예약하기 전에 작업 관리자 태스크를 예약하려고 합니다. 작업 관리자 태스크의 일반적인 목적은 작업 실행을 제어 및/또는 모니터링하는 것입니다. 예를 들어 실행할 추가 작업을 결정하고, 작업이 완료된 시기를 결정하는 등의 작업을 수행합니다. 그러나 작업 관리자 작업은 이러한 활동으로 제한되지 않습니다. 이는 시스템의 본격적인 작업이며 작업에 필요한 모든 작업을 수행합니다. 예를 들어 작업 관리자 태스크는 매개 변수로 지정된 파일을 다운로드하고, 해당 파일의 내용을 분석하고, 해당 내용을 기반으로 추가 작업을 제출할 수 있습니다.
jobPreparationTask		JobPreparationTask	작업 준비 태스크입니다. 작업에 작업 준비 태스크가 있는 경우 Batch 서비스는 해당 컴퓨팅 노드에서 해당 작업의 작업을 시작하기 전에 노드에서 작업 준비 태스크를 실행합니다.
jobReleaseTask		JobReleaseTask	작업 릴리스 태스크입니다. 작업에 대한 작업 준비 태스크도 지정하지 않고는 작업 해제 작업을 지정할 수 없습니다. Batch 서비스는 작업 준비 태스크를 실행한 노드에서 작업 릴리스 태스크를 실행합니다. 작업 릴리스 태스크의 주요 목적은 작업 준비 태스크에서 수행한 컴퓨팅 노드의 변경 내용을 실행 취소하는 것입니다. 예를 들어 로컬 파일을 삭제하거나 작업 준비의 일부로 시작된 서비스를 종료하는 작업이 있습니다.
maxParallelTasks		integer	작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 지정된 경우 -1 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다.
metadata		MetadataItem[]	작업과 메타데이터로 연결된 이름-값 쌍의 목록입니다. Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
networkConfiguration		JobNetworkConfiguration	작업에 대한 네트워크 구성입니다.
onAllTasksComplete		OnAllTasksComplete	작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 작업에 태스크가 없으면 모든 작업이 완료된 것으로 간주됩니다. 따라서 이 옵션은 작업 관리자 작업에서 가장 일반적으로 사용됩니다. 작업 관리자 없이 자동 작업 종료를 사용하려면 처음에는 OnAllTasksComplete를 noaction으로 설정하고 작업 속성을 업데이트하여 작업을 추가한 후 onAllTasksComplete를 종료하도록 설정해야 합니다. 기본값은 noaction입니다.
onTaskFailure		OnTaskFailure	작업의 태스크가 실패할 때 Batch 서비스에서 수행해야 하는 작업입니다. FailInfo가 있는 경우 태스크가 실패한 것으로 간주됩니다. 다시 시도 횟수를 소진한 후 태스크가 0이 아닌 종료 코드로 완료되거나, 예를 들어 리소스 파일 다운로드 오류로 인해 작업을 시작하는 동안 오류가 발생한 경우 failureInfo가 설정됩니다. 기본값은 noaction입니다.
priority		integer	작업의 우선 순위입니다. 우선 순위 값은 -1000 범위에서 1000까지 다양할 수 있으며 -1000 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 기본값은 0입니다.
usesTaskDependencies		boolean	작업의 태스크가 서로 종속성을 정의할 수 있는지 여부입니다. 기본값은 false입니다.

응답

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

Name

형식

Description

201 Created

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

헤더

client-request-id: string
request-id: string
ETag: string
Last-Modified: string
DataServiceId: string

Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

Microsoft Entra OAuth 2.0 인증 코드 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

Authorization

형식: apiKey
In(다음 안에): header

예제

Add a basic job

Add a complex job

Add a basic job

샘플 요청

HTTP

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



{
  "id": "jobId",
  "priority": 0,
  "poolInfo": {
    "poolId": "poolId"
  }
}

샘플 응답

상태 코드:: 201

Add a complex job

샘플 요청

HTTP

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



{
  "id": "jobId",
  "priority": 100,
  "constraints": {
    "maxWallClockTime": "PT1H",
    "maxTaskRetryCount": -1
  },
  "jobManagerTask": {
    "id": "taskId",
    "commandLine": "myprogram.exe",
    "resourceFiles": [
      {
        "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram.exe?sas",
        "filePath": "myprogram.exe"
      },
      {
        "storageContainerUrl": "http://mystorage1.blob.core.windows.net/data?sas",
        "filePath": "datafolder"
      }
    ],
    "environmentSettings": [
      {
        "name": "myvariable",
        "value": "myvalue"
      }
    ],
    "constraints": {
      "maxWallClockTime": "PT1H",
      "maxTaskRetryCount": 0,
      "retentionTime": "PT1H"
    },
    "requiredSlots": 2,
    "killJobOnCompletion": false,
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "admin"
      }
    },
    "runExclusive": true
  },
  "poolInfo": {
    "autoPoolSpecification": {
      "autoPoolIdPrefix": "mypool",
      "poolLifetimeOption": "job",
      "pool": {
        "vmSize": "STANDARD_D2S_V3",
        "virtualMachineConfiguration": {
          "imageReference": {
            "publisher": "MicrosoftWindowsServer",
            "offer": "WindowsServer",
            "sku": "2016-datacenter-smalldisk",
            "version": "latest"
          },
          "nodeAgentSKUId": "batch.node.windows amd64",
          "windowsConfiguration": {
            "enableAutomaticUpdates": false
          },
          "nodePlacementConfiguration": {
            "policy": "zonal"
          }
        },
        "resizeTimeout": "PT15M",
        "targetDedicatedNodes": 3,
        "targetLowPriorityNodes": 0,
        "taskSlotsPerNode": 2,
        "taskSchedulingPolicy": {
          "nodeFillType": "spread"
        },
        "enableAutoScale": false,
        "enableInterNodeCommunication": true,
        "startTask": {
          "commandLine": "myprogram2.exe",
          "resourceFiles": [
            {
              "httpUrl": "http://mystorage1.blob.core.windows.net/scripts/myprogram2.exe?sas",
              "filePath": "myprogram2.exe"
            }
          ],
          "environmentSettings": [
            {
              "name": "myvariable",
              "value": "myvalue"
            }
          ],
          "userIdentity": {
            "autoUser": {
              "scope": "task",
              "elevationLevel": "admin"
            }
          },
          "maxTaskRetryCount": 2,
          "waitForSuccess": true
        },
        "certificateReferences": [
          {
            "thumbprint": "0123456789abcdef0123456789abcdef01234567",
            "thumbprintAlgorithm": "sha1",
            "storeLocation": "localmachine",
            "storeName": "Root",
            "visibility": [
              "task"
            ]
          }
        ],
        "metadata": [
          {
            "name": "myproperty",
            "value": "myvalue"
          }
        ],
        "targetNodeCommunicationMode": "default"
      }
    }
  },
  "metadata": [
    {
      "name": "myproperty",
      "value": "myvalue"
    }
  ]
}

샘플 응답

상태 코드:: 201

정의

Name	Description
AccessScope	토큰이 액세스 권한을 부여하는 Batch 리소스입니다.
ApplicationPackageReference	컴퓨팅 노드에 배포할 패키지에 대한 참조입니다.
AuthenticationTokenSettings	태스크가 Batch 서비스 작업을 수행하는 데 사용할 수 있는 인증 토큰에 대한 설정입니다.
AutomaticOSUpgradePolicy	자동 OS 업그레이드를 수행하는 데 사용되는 구성 매개 변수입니다.
AutoPoolSpecification	임시 '자동 풀'의 특성을 지정합니다. Batch 서비스는 작업이 제출될 때 이 자동 풀을 만듭니다.
AutoUserScope	자동 사용자에 대한 범위
AutoUserSpecification	Batch 서비스에서 작업을 실행하는 자동 사용자에 대한 매개 변수를 지정합니다.
AzureBlobFileSystemConfiguration	Blobfuse를 사용하여 Azure Storage 컨테이너에 연결하는 데 사용되는 정보입니다.
AzureFileShareConfiguration	Azure Fileshare에 연결하는 데 사용되는 정보입니다.
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
CachingType	디스크에 사용할 캐싱 유형입니다.
CertificateReference	풀의 컴퓨팅 노드에 설치할 인증서에 대한 참조입니다.
CertificateStoreLocation	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.
CertificateVisibility	컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.
CIFSMountConfiguration	CIFS 파일 시스템에 연결하는 데 사용되는 정보입니다.
ComputeNodeFillType	풀의 컴퓨팅 노드에 태스크를 분산하는 방법
ComputeNodeIdentityReference	컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.
ContainerConfiguration	컨테이너 사용 풀에 대한 구성입니다.
ContainerHostBatchBindMountEntry	작업 컨테이너에 탑재할 경로 및 탑재 모드의 항목입니다.
ContainerHostDataPath	컨테이너 태스크의 컨테이너에 탑재될 경로입니다.
ContainerRegistry	프라이빗 컨테이너 레지스트리입니다.
ContainerType	사용할 컨테이너 기술입니다.
ContainerWorkingDirectory	컨테이너 작업 디렉터리의 위치입니다.
DataDisk	풀의 컴퓨팅 노드에 연결된 데이터 디스크에서 사용할 설정입니다. 연결된 데이터 디스크를 사용하는 경우 디스크를 사용하려면 VM 내에서 디스크를 탑재하고 포맷해야 합니다.
DiffDiskPlacement	풀의 모든 컴퓨팅 노드(VM)에 대한 운영 체제 디스크의 임시 디스크 배치를 지정합니다.
DiffDiskSettings	컴퓨팅 노드(VM)에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
DiskEncryptionConfiguration	풀의 컴퓨팅 노드에 적용된 디스크 암호화 구성입니다. Azure Compute 갤러리 이미지로 만든 Linux 풀에서는 디스크 암호화 구성이 지원되지 않습니다.
DiskEncryptionTarget	Batch 서비스가 컴퓨팅 노드에서 암호화할 디스크 대상 목록입니다.
DynamicVNetAssignmentScope	동적 vnet 할당의 범위입니다.
ElevationLevel	사용자의 권한 상승 수준입니다.
EnvironmentSetting	작업 프로세스에서 설정할 환경 변수입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
HttpHeader	HTTP 헤더 이름-값 쌍
ImageReference	Azure Virtual Machines Marketplace 이미지 또는 Azure Compute 갤러리 이미지에 대한 참조입니다. Azure Batch에서 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.
InboundEndpointProtocol	엔드포인트의 프로토콜입니다.
InboundNATPool	외부적으로 Batch 풀의 컴퓨팅 노드에서 특정 포트를 처리하는 데 사용할 수 있는 인바운드 NAT 풀입니다.
IPAddressProvisioningType	풀의 공용 IP 주소에 대한 프로비저닝 유형입니다.
JobAddParameter	추가할 Azure Batch 작업입니다.
JobConstraints	작업에 대한 실행 제약 조건입니다.
JobManagerTask	작업 관리자 작업의 세부 정보를 지정합니다.
JobNetworkConfiguration	작업에 대한 네트워크 구성입니다.
JobPreparationTask	지정된 컴퓨팅 노드에서 작업의 태스크 앞에 실행할 작업 준비 태스크입니다.
JobReleaseTask	작업이 실행된 컴퓨팅 노드에서 작업 완료 시 실행할 작업 릴리스 작업입니다.
LinuxUserConfiguration	Linux 컴퓨팅 노드에서 사용자 계정을 만드는 데 사용되는 속성입니다.
LoginMode	사용자의 로그인 모드
ManagedDisk
MetadataItem	Batch 서비스 리소스와 연결된 이름-값 쌍입니다.
MountConfiguration	각 노드에 탑재할 파일 시스템입니다.
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	컴퓨팅 노드에 다운로드할 단일 파일 또는 여러 파일입니다.
RollingUpgradePolicy	롤링 업그레이드를 수행하는 동안 사용되는 구성 매개 변수입니다.
SecurityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob의 암호화를 위해 VMGuestStateOnly로 설정되고, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있으며 기밀 VM을 사용할 때 필요합니다.
SecurityProfile	가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다.
SecurityTypes	가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다.
ServiceArtifactReference	'최신' 이미지 버전을 사용할 때 확장 집합의 모든 가상 머신에 대해 동일한 이미지 버전을 설정하는 데 사용되는 서비스 아티팩트 참조 ID를 지정합니다.
StartTask	노드가 Azure Batch 서비스에서 풀에 조인하거나 컴퓨팅 노드를 다시 부팅하거나 이미지로 다시 설치할 때 실행되는 작업입니다.
StorageAccountType	데이터 디스크 또는 OS 디스크를 만드는 데 사용할 스토리지 계정 유형입니다.
TaskConstraints	작업에 적용할 실행 제약 조건입니다.
TaskContainerSettings	작업에 대한 컨테이너 설정입니다.
TaskSchedulingPolicy	컴퓨팅 노드 간에 태스크를 분산하는 방법을 지정합니다.
UefiSettings	가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다.
UpgradeMode	확장 집합에서 가상 머신으로 업그레이드하는 모드를 지정합니다. 가능한 값은 다음과 같습니다. 수동 - 확장 집합에서 가상 머신에 대한 업데이트의 애플리케이션을 제어합니다. manualUpgrade 작업을 사용하여 이 작업을 수행합니다. 자동 - 확장 집합의 모든 가상 머신이 동시에 자동으로 업데이트됩니다. 롤링 - 확장 집합은 그 사이에 선택적 일시 중지 시간으로 일괄 업데이트를 수행합니다.
UpgradePolicy	자동, 수동 또는 롤링과 같은 업그레이드 정책에 대해 설명합니다.
UserAccount	Azure Batch 컴퓨팅 노드에서 작업을 실행하는 데 사용되는 사용자를 만드는 데 사용되는 속성입니다.
UserIdentity	작업이 실행되는 사용자 ID의 정의입니다.
VirtualMachineConfiguration	Azure Virtual Machines 인프라를 기반으로 풀의 컴퓨팅 노드에 대한 구성입니다.
VMDiskSecurityProfile	관리 디스크에 대한 보안 프로필 설정을 지정합니다. 참고: 기밀 VM에 대해서만 설정할 수 있으며 기밀 VM을 사용하는 경우에만 필요합니다.
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 서비스 작업 집합에 대한 액세스 권한을 부여합니다. 현재 액세스 속성에 대해 지원되는 유일한 값은 'job'이며, 이 값은 작업을 포함하는 작업과 관련된 모든 작업에 대한 액세스 권한을 부여합니다.

AutomaticOSUpgradePolicy

자동 OS 업그레이드를 수행하는 데 사용되는 구성 매개 변수입니다.

Name	형식	Description
disableAutomaticRollback	boolean	OS 이미지 롤백 기능을 사용하지 않도록 설정해야 하는지 여부입니다.
enableAutomaticOSUpgrade	boolean	최신 버전의 OS 이미지를 사용할 수 있게 되면 OS 업그레이드를 롤링 방식으로 확장 집합 인스턴스에 자동으로 적용해야 하는지 여부를 나타냅니다. Windows 기반 풀에 대해 true로 설정된 경우 WindowsConfiguration.enableAutomaticUpdates true로 설정할 수 없습니다.
osRollingUpgradeDeferral	boolean	작업을 실행하는 경우 TVM에서 OS 업그레이드를 연기합니다.
useRollingUpgradePolicy	boolean	자동 OS 업그레이드 중에 롤링 업그레이드 정책을 사용해야 하는지 여부를 나타냅니다. VMSS에 정의된 정책이 없는 경우 자동 OS 업그레이드가 기본 정책으로 대체됩니다.

AutoPoolSpecification

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

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

AutoUserScope

자동 사용자에 대한 범위

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

AutoUserSpecification

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

Name	형식	Description
elevationLevel	ElevationLevel	자동 사용자의 권한 상승 수준입니다. 기본값은 nonAdmin입니다.
scope	AutoUserScope	자동 사용자에 대한 범위 기본값은 풀입니다. 풀이 Windows를 실행하는 경우 작업 간에 더 엄격한 격리가 필요한 경우 작업 값을 지정해야 합니다. 예를 들어 태스크가 다른 작업에 영향을 미칠 수 있는 방식으로 레지스트리를 변경하거나 일반 작업에서 액세스할 수 없지만 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 컴퓨팅 노드로 구성된 풀에만 적용됩니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.
storeName	string	인증서를 설치할 컴퓨팅 노드의 인증서 저장소 이름입니다. 이 속성은 Windows 컴퓨팅 노드로 구성된 풀에만 적용됩니다. 일반적인 저장소 이름에는 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 파일 시스템에 대한 인증에 사용할 사용자입니다.

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	사용할 컨테이너 기술입니다.

ContainerHostBatchBindMountEntry

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

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

ContainerHostDataPath

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

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

ContainerRegistry

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

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

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 디스크 크기 요구 사항에 대한 자세한 내용은 https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements Windows VM 및 https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirementsLinux VM에 대한 임시 OS 디스크 크기 요구 사항을 참조하세요.

DiskEncryptionConfiguration

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

Name	형식	Description
targets	DiskEncryptionTarget[]	Batch 서비스가 컴퓨팅 노드에서 암호화할 디스크 대상 목록입니다. Batch 서비스가 컴퓨팅 노드에서 암호화할 디스크 대상 목록입니다.

DiskEncryptionTarget

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

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

DynamicVNetAssignmentScope

동적 vnet 할당의 범위입니다.

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

ElevationLevel

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

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

EnvironmentSetting

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

Name	형식	Description
name	string	환경 변수의 이름입니다.
value	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 갤러리 이미지에 대한 참조입니다. Azure Batch에서 확인된 모든 Azure Marketplace 이미지 참조 목록을 보려면 '지원되는 이미지 나열' 작업을 참조하세요.

Name	형식	Description
communityGalleryImageId	string	커뮤니티 갤러리 이미지 고유 식별자 이 속성은 다른 속성과 함께 사용할 수 없으며 커뮤니티 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
exactVersion	string	노드를 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 특정 버전입니다. 이 읽기 전용 필드는 풀을 만들 때 'version'에 지정된 값이 'latest'인 경우에만 'version'와 다릅니다.
offer	string	Azure Virtual Machines Marketplace 이미지의 제품 유형입니다. 예를 들어 UbuntuServer 또는 WindowsServer입니다.
publisher	string	Azure Virtual Machines Marketplace 이미지의 게시자입니다. 예를 들어 Canonical 또는 MicrosoftWindowsServer입니다.
sharedGalleryImageId	string	공유 갤러리 이미지 고유 식별자 이 속성은 다른 속성과 함께 사용할 수 없으며 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
sku	string	Azure Virtual Machines Marketplace 이미지의 SKU입니다. 예를 들어 18.04-LTS 또는 2019-Datacenter입니다.
version	string	Azure Virtual Machines Marketplace 이미지의 버전입니다. 'latest' 값을 지정하여 최신 버전의 이미지를 선택할 수 있습니다. 생략하면 기본값은 'latest'입니다.
virtualMachineImageId	string	Azure Compute 갤러리 이미지의 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 갤러리 이미지는 동일한 지역에 복제본이 있어야 하며 Azure Batch 계정과 동일한 구독에 있어야 합니다. imageId에 이미지 버전을 지정하지 않으면 최신 버전이 사용됩니다. Batch 컴퓨팅 노드 에이전트가 Batch 서비스와 통신하는 방화벽 설정에 대한 자세한 내용은 https://docs.microsoft.com/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	컴퓨팅 노드의 포트 번호입니다. Batch 풀 내에서 고유해야 합니다. 허용되는 값은 22, 3389, 29876 및 29877을 제외하고 1에서 65535 사이입니다. 예약된 값이 제공되면 HTTP 상태 코드 400으로 요청이 실패합니다.
frontendPortRangeEnd	integer	개별 컴퓨팅 노드의 백 엔드포트에 대한 인바운드 액세스를 제공하는 데 사용할 외부 포트 범위의 마지막 포트 번호입니다. 허용되는 값 범위는 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는 사용자가 제공하며 컴퓨팅 노드를 프로비전하는 데 사용됩니다.

JobAddParameter

추가할 Azure Batch 작업입니다.

Name	형식	Default value	Description
allowTaskPreemption	boolean		우선 순위가 높은 다른 작업에서 이 작업의 작업을 선점할 수 있는지 여부 값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다.
commonEnvironmentSettings	EnvironmentSetting[]		일반적인 환경 변수 설정 목록입니다. 이러한 환경 변수는 작업의 모든 작업(작업 관리자, 작업 준비 및 작업 릴리스 작업 포함)에 대해 설정됩니다. 개별 작업은 동일한 설정 이름을 다른 값으로 지정하여 여기에 지정된 환경 설정을 재정의할 수 있습니다.
constraints	JobConstraints		작업에 대한 실행 제약 조건입니다. 작업에 대한 실행 제약 조건입니다.
displayName	string		작업의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
id	string		계정 내에서 작업을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 계정 내에 대/소문자만 다른 ID가 두 개 없을 수 있음).
jobManagerTask	JobManagerTask		작업이 시작될 때 시작할 작업 관리자 작업의 세부 정보입니다. 작업에서 작업 관리자 태스크를 지정하지 않으면 사용자가 작업에 작업을 명시적으로 추가해야 합니다. 작업에서 작업 관리자 태스크를 지정하는 경우 Batch 서비스는 작업을 만들 때 작업 관리자 태스크를 만들고 작업에서 다른 작업을 예약하기 전에 작업 관리자 태스크를 예약하려고 합니다. 작업 관리자 태스크의 일반적인 목적은 작업 실행을 제어 및/또는 모니터링하는 것입니다. 예를 들어 실행할 추가 작업을 결정하고, 작업이 완료된 시기를 결정하는 등의 작업을 수행합니다. 그러나 작업 관리자 작업은 이러한 활동으로 제한되지 않습니다. 이는 시스템의 본격적인 작업이며 작업에 필요한 모든 작업을 수행합니다. 예를 들어 작업 관리자 태스크는 매개 변수로 지정된 파일을 다운로드하고, 해당 파일의 내용을 분석하고, 해당 내용을 기반으로 추가 작업을 제출할 수 있습니다.
jobPreparationTask	JobPreparationTask		작업 준비 태스크입니다. 작업에 작업 준비 태스크가 있는 경우 Batch 서비스는 해당 컴퓨팅 노드에서 해당 작업의 작업을 시작하기 전에 노드에서 작업 준비 태스크를 실행합니다.
jobReleaseTask	JobReleaseTask		작업 릴리스 태스크입니다. 작업에 대한 작업 준비 태스크도 지정하지 않고는 작업 해제 작업을 지정할 수 없습니다. Batch 서비스는 작업 준비 태스크를 실행한 노드에서 작업 릴리스 태스크를 실행합니다. 작업 릴리스 태스크의 주요 목적은 작업 준비 태스크에서 수행한 컴퓨팅 노드의 변경 내용을 실행 취소하는 것입니다. 예를 들어 로컬 파일을 삭제하거나 작업 준비의 일부로 시작된 서비스를 종료하는 작업이 있습니다.
maxParallelTasks	integer	-1	작업에 대해 병렬로 실행할 수 있는 최대 작업 수입니다. maxParallelTasks 값은 지정된 경우 -1 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 maxParallelTasks를 업데이트할 수 있습니다.
metadata	MetadataItem[]		작업과 메타데이터로 연결된 이름-값 쌍의 목록입니다. Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
networkConfiguration	JobNetworkConfiguration		작업에 대한 네트워크 구성입니다.
onAllTasksComplete	OnAllTasksComplete		작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다. 작업에 태스크가 없으면 모든 작업이 완료된 것으로 간주됩니다. 따라서 이 옵션은 작업 관리자 작업에서 가장 일반적으로 사용됩니다. 작업 관리자 없이 자동 작업 종료를 사용하려면 처음에는 OnAllTasksComplete를 noaction으로 설정하고 작업 속성을 업데이트하여 작업을 추가한 후 onAllTasksComplete를 종료하도록 설정해야 합니다. 기본값은 noaction입니다.
onTaskFailure	OnTaskFailure		작업의 태스크가 실패할 때 Batch 서비스에서 수행해야 하는 작업입니다. FailInfo가 있는 경우 태스크가 실패한 것으로 간주됩니다. 다시 시도 횟수를 소진한 후 태스크가 0이 아닌 종료 코드로 완료되거나, 예를 들어 리소스 파일 다운로드 오류로 인해 작업을 시작하는 동안 오류가 발생한 경우 failureInfo가 설정됩니다. 기본값은 noaction입니다.
poolInfo	PoolInformation		Batch 서비스가 작업의 작업을 실행하는 풀입니다.
priority	integer		작업의 우선 순위입니다. 우선 순위 값은 -1000 범위에서 1000까지 다양할 수 있으며 -1000 가장 낮은 우선 순위이고 1000은 가장 높은 우선 순위입니다. 기본값은 0입니다.
usesTaskDependencies	boolean		작업의 태스크가 서로 종속성을 정의할 수 있는지 여부입니다. 기본값은 false입니다.

JobConstraints

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

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

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/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 서비스가 Compute 노드에서 업로드할 파일 목록입니다. 다중 인스턴스 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.
requiredSlots	integer	태스크를 실행하는 데 필요한 예약 슬롯 수입니다. 기본값은 1입니다. 노드에 사용 가능한 여유 일정 슬롯이 충분한 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 지정해서는 안 됩니다.
resourceFiles	ResourceFile[]	명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
runExclusive	boolean	작업 관리자 태스크가 실행되는 컴퓨팅 노드를 단독으로 사용해야 하는지 여부입니다. true이면 작업 관리자가 실행되는 동안 동일한 노드에서 다른 작업이 실행되지 않습니다. false이면 컴퓨팅 노드의 작업 관리자와 동시에 다른 작업을 실행할 수 있습니다. 작업 관리자 태스크는 일반적으로 컴퓨팅 노드의 동시 작업 제한에 대해 계산되므로 컴퓨팅 노드에서 여러 동시 작업을 허용하는 경우에만 관련이 있습니다. 기본값은 true입니다.
userIdentity	UserIdentity	작업 관리자 태스크가 실행되는 사용자 ID입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

JobNetworkConfiguration

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

Name	형식	Description
skipWithdrawFromVNet	boolean	작업이 종료되거나 삭제될 때 가상 네트워크에서 DNC로 컴퓨팅 노드를 철회할지 여부입니다. true이면 노드가 가상 네트워크에 DNC에 조인된 상태로 유지됩니다. false이면 작업이 종료되면 노드가 자동으로 철회됩니다. 기본값은 false입니다.
subnetId	string	작업에서 작업을 실행하는 컴퓨팅 노드가 작업 기간 동안 조인할 가상 네트워크 서브넷의 ARM 리소스 식별자입니다. 가상 네트워크는 Azure Batch 계정과 동일한 지역 및 구독에 있어야 합니다. 지정된 서브넷에는 작업에서 작업을 실행할 컴퓨팅 노드 수를 수용할 수 있는 충분한 사용 가능한 IP 주소가 있어야 합니다. 풀의 컴퓨팅 노드 수까지 가능합니다. Azure Batch 서비스가 노드에서 작업을 예약할 수 있도록 'MicrosoftAzureBatch' 서비스 주체에는 지정된 VNet에 대한 '클래식 가상 머신 기여자' Role-Based RBAC(액세스 제어) 역할이 있어야 합니다. 지정된 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/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/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/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입니다. 생략하면 태스크가 작업에 고유한 비관리 사용자로 실행됩니다.

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 풀에서 사용하도록 설정됩니다. 이 옵션을 Windows 풀에서 관리자 권한으로 사용하는 경우 작업 명령줄에서 실행하는 애플리케이션이 항상 관리 권한을 요구하거나 항상 최대 권한을 요구하도록 구성되지 않는 한 사용자 세션은 상승되지 않습니다.

ManagedDisk

Name	형식	Description
securityProfile	VMDiskSecurityProfile	관리 디스크에 대한 보안 프로필 설정을 지정합니다. 관리 디스크에 대한 보안 프로필 설정을 지정합니다. 참고: 기밀 VM에 대해서만 설정할 수 있으며 기밀 VM을 사용하는 경우에만 필요합니다.
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 파일 시스템입니다. 이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

NetworkConfiguration

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

Name	형식	Description
dynamicVNetAssignmentScope	DynamicVNetAssignmentScope	동적 vnet 할당의 범위입니다.
enableAcceleratedNetworking	boolean	이 풀이 가속화된 네트워킹을 사용하도록 설정해야 하는지 여부입니다. 가속화된 네트워킹을 사용하면 VM에 대한 단일 루트 I/O 가상화(SR-IOV)가 가능하므로 네트워킹 성능이 향상될 수 있습니다. 자세한 내용은 다음을 참조하세요. https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.
endpointConfiguration	PoolEndpointConfiguration	Batch 풀의 컴퓨팅 노드에 있는 엔드포인트에 대한 구성입니다.
publicIPAddressConfiguration	PublicIPAddressConfiguration	Batch 풀의 컴퓨팅 노드에 대한 공용 IPAddress 구성입니다. 풀의 네트워킹 구성에 대한 공용 IP 주소 구성입니다.
subnetId	string	풀의 컴퓨팅 노드가 조인할 가상 네트워크 서브넷의 ARM 리소스 식별자입니다. /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}형식입니다. 가상 네트워크는 Azure Batch 계정과 동일한 지역 및 구독에 있어야 합니다. 지정된 서브넷에는 풀의 컴퓨팅 노드 수를 수용할 수 있는 충분한 사용 가능한 IP 주소가 있어야 합니다. 서브넷에 사용 가능한 IP 주소가 충분하지 않으면 풀에서 노드를 부분적으로 할당하고 크기 조정 오류가 발생합니다. 'MicrosoftAzureBatch' 서비스 주체에는 지정된 VNet에 대한 '클래식 가상 머신 기여자' Role-Based RBAC(Access Control) 역할이 있어야 합니다. 지정된 서브넷은 Azure Batch 서비스의 통신이 노드에서 작업을 예약할 수 있도록 허용해야 합니다. 지정된 VNet에 연결된 NSG(네트워크 보안 그룹)가 있는지 확인하여 확인할 수 있습니다. 지정된 서브넷의 노드에 대한 통신이 NSG에 의해 거부되면 Batch 서비스는 컴퓨팅 노드의 상태를 사용할 수 없도록 설정합니다. ARM 가상 네트워크('Microsoft.Network/virtualNetworks')만 지원됩니다. 지정된 VNet에 연결된 NSG(네트워크 보안 그룹)가 있는 경우 인바운드 통신에 대해 몇 가지 예약된 시스템 포트를 사용하도록 설정해야 합니다. 포트 29876 및 29877 및 Linux용 포트 22 및 Windows용 포트 3389를 사용하도록 설정합니다. 또한 포트 443에서 Azure Storage에 대한 아웃바운드 연결을 사용하도록 설정합니다. 자세한 내용은 다음을 참조하세요. https://docs.microsoft.com/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이 특정 파일(즉, 와일드카드를 포함하지 않음)을 참조하는 경우 경로는 해당 파일을 업로드할 Blob의 이름입니다. filePattern에 하나 이상의 와일드카드(따라서 여러 파일과 일치할 수 있음)가 포함된 경우 경로는 파일을 업로드할 Blob 가상 디렉터리(각 Blob 이름 앞에 추가됨)의 이름입니다. 생략하면 파일 이름이 파일 이름과 일치하는 Blob 이름으로 컨테이너의 루트에 업로드됩니다.
uploadHeaders	HttpHeader[]	출력 파일 업로드에 사용할 헤더의 이름-값 쌍 목록 이러한 헤더는 Azure Storage에 파일을 업로드할 때 지정됩니다. Blob을 업로드할 때 허용되는 헤더에 대한 공식 문서: https://docs.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileDestination

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

Name	형식	Description
container	OutputFileBlobContainerDestination	파일이 업로드되는 Azure Blob Storage의 위치입니다.

OutputFileUploadCondition

작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다.

Name	형식	Description
taskcompletion	string	종료 코드에 관계없이 작업 프로세스가 종료된 후 파일을 업로드합니다.
taskfailure	string	0이 아닌 종료 코드를 사용하여 작업 프로세스가 종료된 후에만 파일을 업로드합니다.
tasksuccess	string	종료 코드가 0인 작업 프로세스가 종료된 후에만 파일을 업로드합니다.

OutputFileUploadOptions

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

Name	형식	Description
uploadCondition	OutputFileUploadCondition	작업 출력 파일 또는 파일 집합을 업로드해야 하는 조건입니다. 기본값은 작업 완성입니다.

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 서비스는 작업을 만들 때 풀을 만듭니다. '작업' 옵션이 작업 일정에 적용되는 경우 Batch 서비스는 일정에 따라 생성된 모든 작업에 대해 새 자동 풀을 만듭니다.
jobschedule	string	풀은 작업 일정의 수명 동안 존재합니다. Batch 서비스는 일정에 따라 첫 번째 작업을 만들 때 풀을 만듭니다. 이 옵션은 작업 일정이 아닌 작업 일정에만 적용할 수 있습니다.

PoolSpecification

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

Name	형식	Description
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 확장 사용하세요.
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의 작은 값입니다.
upgradePolicy	UpgradePolicy	풀에 대한 업그레이드 정책입니다. 자동, 수동 또는 롤링과 같은 업그레이드 정책에 대해 설명합니다.
userAccounts	UserAccount[]	풀의 각 컴퓨팅 노드에 만들 사용자 계정 목록입니다.
virtualMachineConfiguration	VirtualMachineConfiguration	풀에 대한 가상 머신 구성입니다. 이 속성을 지정해야 합니다.
vmSize	string	풀에 있는 가상 머신의 크기입니다. 풀의 모든 가상 머신 크기는 동일합니다. 풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀(https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes)에서 컴퓨팅 노드에 대한 VM 크기 선택을 참조하세요.

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

RollingUpgradePolicy

롤링 업그레이드를 수행하는 동안 사용되는 구성 매개 변수입니다.

Name	형식	Description
enableCrossZoneUpgrade	boolean	업그레이드 일괄 처리를 생성할 때 VMSS가 AZ 경계를 무시하도록 허용합니다. 업데이트 도메인 및 maxBatchInstancePercent를 고려하여 일괄 처리 크기를 확인합니다. 이 필드는 NodePlacementConfiguration을 영역으로 사용하는 경우에만 true 또는 false로 설정할 수 있습니다.
maxBatchInstancePercent	integer	롤링 업그레이드를 통해 동시에 업그레이드될 총 가상 머신 인스턴스의 최대 백분율입니다. 이는 이전 또는 이후 일괄 처리의 최대 비정상 인스턴스이므로 더 높은 안정성을 보장하기 위해 일괄 처리의 인스턴스 비율이 감소할 수 있습니다. 이 필드의 값은 5에서 100 사이여야 합니다. maxBatchInstancePercent와 maxUnhealthyInstancePercent가 모두 값으로 할당된 경우 maxBatchInstancePercent 값은 maxUnhealthyInstancePercent보다 작으면 안 됩니다.
maxUnhealthyInstancePercent	integer	업그레이드의 결과로 또는 롤링 업그레이드가 중단되기 전에 가상 머신 상태 검사에서 비정상 상태로 발견되어 동시에 비정상 상태가 될 수 있는 확장 집합의 총 가상 머신 인스턴스의 최대 비율입니다. 이 제약 조건은 일괄 처리를 시작하기 전에 확인됩니다. 이 필드의 값은 5에서 100 사이여야 합니다. maxBatchInstancePercent와 maxUnhealthyInstancePercent가 모두 값으로 할당된 경우 maxBatchInstancePercent 값은 maxUnhealthyInstancePercent보다 작으면 안 됩니다.
maxUnhealthyUpgradedInstancePercent	integer	비정상 상태인 것으로 확인될 수 있는 업그레이드된 가상 머신 인스턴스의 최대 비율입니다. 이 검사는 각 일괄 처리가 업그레이드된 후에 수행됩니다. 이 비율을 초과하면 롤링 업데이트가 중단됩니다. 이 필드의 값은 0에서 100 사이여야 합니다.
pauseTimeBetweenBatches	string	모든 가상 머신에 대한 업데이트를 한 일괄 처리로 완료하고 다음 일괄 처리를 시작하는 것 사이의 대기 시간입니다. 기간은 ISO 8601 형식으로 지정해야 합니다.
prioritizeUnhealthyInstances	boolean	확장 집합의 모든 비정상 인스턴스를 정상 인스턴스로 업그레이드합니다.
rollbackFailedInstancesOnPolicyBreach	boolean	롤링 업그레이드 정책을 위반하는 경우 인스턴스를 이전 모델로 롤백하지 못했습니다.

SecurityEncryptionTypes

관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob의 암호화를 위해 VMGuestStateOnly로 설정되고, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있으며 기밀 VM을 사용할 때 필요합니다.

Name	형식	Description
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

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

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

SecurityTypes

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

Name	형식	Description
confidentialVM	string	Azure 기밀 컴퓨팅은 보안 및 기밀성 요구 사항이 높은 테넌트용 기밀 VM을 제공합니다. 이러한 VM은 보안 요구 사항을 충족하는 데 도움이 되는 강력한 하드웨어 적용 경계를 제공합니다. 코드를 변경하지 않고 마이그레이션에 기밀 VM을 사용할 수 있으며 플랫폼은 VM의 상태를 읽거나 수정하지 않도록 보호합니다.
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/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입니다.

StorageAccountType

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

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

TaskConstraints

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

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

TaskContainerSettings

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

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

TaskSchedulingPolicy

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

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

UefiSettings

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

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

UpgradeMode

확장 집합에서 가상 머신으로 업그레이드하는 모드를 지정합니다.

가능한 값은 다음과 같습니다.

수동 - 확장 집합에서 가상 머신에 대한 업데이트의 애플리케이션을 제어합니다. manualUpgrade 작업을 사용하여 이 작업을 수행합니다.

자동 - 확장 집합의 모든 가상 머신이 동시에 자동으로 업데이트됩니다.

롤링 - 확장 집합은 그 사이에 선택적 일시 중지 시간으로 일괄 업데이트를 수행합니다.

Name	형식	Description
automatic	string	확장 집합의 모든 가상 머신은 동시에 자동으로 업데이트됩니다.
manual	string	확장 집합에서 가상 머신에 대한 업데이트 애플리케이션을 제어합니다. manualUpgrade 작업을 사용하여 이 작업을 수행합니다.
rolling	string	확장 집합의 기존 인스턴스는 업그레이드할 일괄 처리로 중단됩니다. 업그레이드된 일괄 처리가 완료되면 인스턴스가 트래픽을 다시 복용하기 시작하고 다음 일괄 처리가 시작됩니다. 이 작업은 모든 인스턴스가 up-to-date를 가져올 때까지 계속됩니다.

UpgradePolicy

자동, 수동 또는 롤링과 같은 업그레이드 정책에 대해 설명합니다.

Name	형식	Description
automaticOSUpgradePolicy	AutomaticOSUpgradePolicy	자동 OS 업그레이드를 수행하는 데 사용되는 구성 매개 변수입니다. 자동 OS 업그레이드를 수행하는 데 사용되는 구성 매개 변수입니다.
mode	UpgradeMode	확장 집합에서 가상 머신으로 업그레이드하는 모드를 지정합니다. 가능한 값은 다음과 같습니다. 수동 - 확장 집합에서 가상 머신에 대한 업데이트의 애플리케이션을 제어합니다. manualUpgrade 작업을 사용하여 이 작업을 수행합니다. 자동 - 확장 집합의 모든 가상 머신이 동시에 자동으로 업데이트됩니다. 롤링 - 확장 집합은 그 사이에 선택적 일시 중지 시간으로 일괄 업데이트를 수행합니다.
rollingUpgradePolicy	RollingUpgradePolicy	롤링 업그레이드를 수행하는 동안 사용되는 구성 매개 변수입니다. 롤링 업그레이드를 수행하는 동안 사용되는 구성 매개 변수입니다.

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/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux 및 https://docs.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine참조하세요.
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 노드 에이전트의 SKU입니다. Batch Compute Node 에이전트는 풀의 각 컴퓨팅 노드에서 실행되는 프로그램이며 컴퓨팅 노드와 Batch 서비스 간에 명령 및 제어 인터페이스를 제공합니다. 여러 운영 체제에 대해 SKU라고 하는 컴퓨팅 노드 에이전트의 구현은 서로 다릅니다. 선택한 이미지 참조와 일치하는 컴퓨팅 노드 에이전트 SKU를 지정해야 합니다. 확인된 이미지 참조 목록과 함께 지원되는 컴퓨팅 노드 에이전트 SKU 목록을 얻으려면 '지원되는 컴퓨팅 노드 에이전트 SKU 나열' 작업을 참조하세요.
nodePlacementConfiguration	NodePlacementConfiguration	풀에 대한 노드 배치 구성입니다. 이 구성은 풀의 노드를 물리적으로 할당하는 방법에 대한 규칙을 지정합니다.
osDisk	OSDisk	Virtual Machine의 운영 체제 디스크에 대한 설정입니다.
securityProfile	SecurityProfile	가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다. 가상 머신 또는 가상 머신 확장 집합에 대한 보안 프로필 설정을 지정합니다.
serviceArtifactReference	ServiceArtifactReference	'최신' 이미지 버전을 사용할 때 확장 집합의 모든 가상 머신에 대해 동일한 이미지 버전을 설정하는 데 사용되는 서비스 아티팩트 참조 ID를 지정합니다. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} 형식의 서비스 아티팩트 참조 ID입니다.
windowsConfiguration	WindowsConfiguration	가상 머신의 Windows 운영 체제 설정입니다. imageReference 속성이 Linux OS 이미지를 지정하는 경우 이 속성을 지정해서는 안 됩니다.

VMDiskSecurityProfile

관리 디스크에 대한 보안 프로필 설정을 지정합니다. 참고: 기밀 VM에 대해서만 설정할 수 있으며 기밀 VM을 사용하는 경우에만 필요합니다.

Name	형식	Description
securityEncryptionType	SecurityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob의 암호화를 위해 VMGuestStateOnly로 설정되고, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있으며 기밀 VM을 사용할 때 필요합니다.

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	사용자의 로그인 모드 기본값은 'batch'입니다.

다음을 통해 공유

Job - Add

URI 매개 변수

요청 헤더

요청 본문

응답

보안

azure_auth

범위

Authorization

예제

Add a basic job

샘플 요청

샘플 응답

Add a complex job

샘플 요청

샘플 응답

정의

AccessScope

ApplicationPackageReference

AuthenticationTokenSettings

AutomaticOSUpgradePolicy

AutoPoolSpecification

AutoUserScope

AutoUserSpecification

AzureBlobFileSystemConfiguration

AzureFileShareConfiguration

BatchError

BatchErrorDetail

CachingType

CertificateReference

CertificateStoreLocation

CertificateVisibility

CIFSMountConfiguration

ComputeNodeFillType

ComputeNodeIdentityReference

ContainerConfiguration

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistry

ContainerType

ContainerWorkingDirectory

DataDisk

DiffDiskPlacement

DiffDiskSettings

DiskEncryptionConfiguration

DiskEncryptionTarget

DynamicVNetAssignmentScope

ElevationLevel

EnvironmentSetting

ErrorMessage

HttpHeader

ImageReference

InboundEndpointProtocol

InboundNATPool

IPAddressProvisioningType

JobAddParameter

JobConstraints

JobManagerTask

JobNetworkConfiguration

JobPreparationTask

JobReleaseTask

LinuxUserConfiguration

LoginMode

ManagedDisk

MetadataItem

MountConfiguration

NetworkConfiguration

NetworkSecurityGroupRule

NetworkSecurityGroupRuleAccess

NFSMountConfiguration

NodeCommunicationMode

NodePlacementConfiguration

NodePlacementPolicyType

OnAllTasksComplete

OnTaskFailure

OSDisk

OutputFile

OutputFileBlobContainerDestination

OutputFileDestination