Job Schedule - List

지정된 계정의 모든 작업 일정을 나열합니다.

GET {batchUrl}/jobschedules?api-version=2022-01-01.15.0
GET {batchUrl}/jobschedules?$filter={$filter}&$select={$select}&$expand={$expand}&maxresults={maxresults}&timeout={timeout}&api-version=2022-01-01.15.0

URI 매개 변수

Name In Required Type Description
batchUrl
path True
  • string

모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.

api-version
query True
  • string

클라이언트 API 버전입니다.

$expand
query
  • string

OData $expand 절입니다.

$filter
query
  • string

OData $filter 절입니다. 이 필터를 생성하는 방법에 대한 자세한 내용은 다음을 참조하세요 https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-job-schedules.

$select
query
  • string

OData $select 절입니다.

maxresults
query
  • integer
int32

응답에서 반환할 최대 항목 수입니다. 최대 1,000개의 작업 일정을 반환할 수 있습니다.

timeout
query
  • integer
int32

서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다.

요청 헤더

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

Name Required Type Description
client-request-id
  • string
uuid

호출자가 생성한 요청 ID(예: 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0)와 같은 장식이 없는 GUID 형식입니다.

return-client-request-id
  • boolean

서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.

ocp-date
  • string
date-time-rfc1123

요청이 발급된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

응답

Name Type Description
200 OK

작업 일정 목록이 포함된 응답입니다.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

Batch 서비스의 오류입니다.

보안

azure_auth

OAuth2 Flow Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

Authorization

Type: apiKey
In: header

예제

JobSchedule list

Sample Request

GET account.region.batch.azure.com/jobschedules?api-version=2022-01-01.15.0


Sample Response

{
  "value": [
    {
      "id": "jobSchedule1",
      "url": "https://account.region.batch.azure.com/jobschedules/jobSchedule1",
      "eTag": "0x8D40FFD2E10996A",
      "lastModified": "2016-11-18T21:52:24.0064874Z",
      "creationTime": "2016-11-18T21:52:22.5431125Z",
      "state": "active",
      "stateTransitionTime": "2016-11-18T21:52:24.0064874Z",
      "previousState": "disabled",
      "previousStateTransitionTime": "2016-11-18T21:52:23.6471782Z",
      "jobSpecification": {
        "priority": 0,
        "maxParallelTasks": -1,
        "allowTaskPreemption": false,
        "usesTaskDependencies": false,
        "onAllTasksComplete": "noaction",
        "onTaskFailure": "noaction",
        "constraints": {
          "maxWallClockTime": "P10675199DT2H48M5.4775807S",
          "maxTaskRetryCount": 0
        },
        "poolInfo": {
          "poolId": "poolId"
        }
      },
      "executionInfo": {
        "recentJob": {
          "url": "https://account.region.batch.azure.com/jobs/jobSchedule1:job-1",
          "id": "jobSchedule1:job-1"
        }
      }
    },
    {
      "id": "jobSchedule2",
      "url": "https://account.region.batch.azure.com/jobschedules/jobSchedule2",
      "eTag": "0x8D40FFCFF760B51",
      "lastModified": "2016-11-18T21:51:05.8184017Z",
      "creationTime": "2016-11-18T21:51:05.8184017Z",
      "state": "active",
      "stateTransitionTime": "2016-11-18T21:51:05.8184017Z",
      "schedule": {
        "doNotRunUntil": "2020-01-01T12:30:00Z"
      },
      "jobSpecification": {
        "priority": 0,
        "maxParallelTasks": -1,
        "usesTaskDependencies": false,
        "onAllTasksComplete": "noaction",
        "onTaskFailure": "noaction",
        "constraints": {
          "maxWallClockTime": "P10675199DT2H48M5.4775807S",
          "maxTaskRetryCount": 0
        },
        "poolInfo": {
          "poolId": "testPool2"
        }
      },
      "executionInfo": {
        "nextRunTime": "2020-01-01T12:30:00Z"
      }
    }
  ]
}

정의

ApplicationPackageReference

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

AuthenticationTokenSettings

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

AutoPoolSpecification

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

AutoUserScope

자동 사용자에 대한 범위

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

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

AzureFileShareConfiguration

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

BatchError

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

BatchErrorDetail

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

CachingType

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

CertificateReference

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

CertificateStoreLocation

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

CIFSMountConfiguration

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

CloudJobSchedule

작업을 실행할 시기와 각 작업을 만드는 데 사용되는 사양을 지정하여 되풀이 작업을 허용하는 작업 일정입니다.

CloudJobScheduleListResult

계정에 작업 일정을 나열한 결과입니다.

CloudServiceConfiguration

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

ComputeNodeFillType

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

ComputeNodeIdentityReference

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

ContainerConfiguration

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

ContainerRegistry

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

ContainerType

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

ContainerWorkingDirectory

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

DataDisk

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

DiffDiskPlacement

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

DiffDiskSettings

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

DiskEncryptionConfiguration

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

DynamicVNetAssignmentScope

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

ElevationLevel

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

EnvironmentSetting

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

ErrorMessage

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

HttpHeader

HTTP 헤더 이름-값 쌍

ImageReference

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

InboundEndpointProtocol

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

InboundNATPool

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

IPAddressProvisioningType

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

JobConstraints

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

JobManagerTask

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

JobNetworkConfiguration

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

JobPreparationTask

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

JobReleaseTask

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

JobScheduleExecutionInformation

작업 일정에 따라 실행되고 실행될 작업에 대한 정보를 포함합니다.

JobScheduleState

작업 일정의 상태입니다.

JobScheduleStatistics

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

JobSpecification

일정에 따라 만들 작업의 세부 정보를 지정합니다.

LinuxUserConfiguration

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

LoginMode

사용자의 로그인 모드

MetadataItem

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

MountConfiguration

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

NetworkConfiguration

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

NetworkSecurityGroupRule

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

NetworkSecurityGroupRuleAccess

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

NFSMountConfiguration

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

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 주소 구성입니다.

RecentJob

작업 일정에 따라 실행할 가장 최근 작업에 대한 정보입니다.

ResourceFile

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

Schedule

작업을 만들 일정입니다. 모든 시간은 각각 UTC로 고정되며 일광 절약 시간제의 영향을 받지 않습니다.

StartTask

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

StorageAccountType

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

TaskConstraints

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

TaskContainerSettings

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

TaskSchedulingPolicy

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

UserAccount

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

UserIdentity

태스크가 실행되는 사용자 ID의 정의입니다.

VirtualMachineConfiguration

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

VMExtension

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

WindowsConfiguration

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

WindowsUserConfiguration

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

ApplicationPackageReference

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

Name Type Description
applicationId
  • string

배포할 애플리케이션의 ID입니다.

version
  • string

배포할 애플리케이션의 버전입니다. 생략하면 기본 버전이 배포됩니다.
풀에서 생략되고 이 애플리케이션에 대해 기본 버전이 지정되지 않은 경우 오류 코드 InvalidApplicationPackageReferences 및 HTTP 상태 코드 409와 함께 요청이 실패합니다. 이 작업이 작업에서 생략되고 이 애플리케이션에 대해 기본 버전이 지정되지 않은 경우 태스크가 사전 처리 오류와 함께 실패합니다.

AuthenticationTokenSettings

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

Name Type Description
access
  • string[]

토큰이 액세스 권한을 부여하는 Batch 리소스입니다.
인증 토큰은 제한된 Batch 서비스 작업 집합에 대한 액세스 권한을 부여합니다. 현재 액세스 속성에 대해 지원되는 유일한 값은 'job'이며, 이 값은 작업을 포함하는 작업과 관련된 모든 작업에 대한 액세스 권한을 부여합니다.

AutoPoolSpecification

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

Name Type Description
autoPoolIdPrefix
  • string

풀이 자동으로 만들어질 때 고유 식별자에 추가할 접두사입니다.
Batch 서비스는 생성할 때 각 자동 풀에 고유 식별자를 할당합니다. 다른 용도로 만든 풀을 구분하기 위해 이 요소를 지정하여 할당된 ID에 접두사 추가를 수행할 수 있습니다. 접두사는 최대 20자까지 지정할 수 있습니다.

keepAlive
  • boolean

수명이 만료된 후 자동 풀을 활성 상태로 유지할지 여부입니다.
false이면 Batch 서비스는 수명이 만료되면(poolLifetimeOption 설정에 의해 결정됨) 풀을 삭제합니다. 즉, 작업 또는 작업 일정이 완료되는 경우입니다. true이면 Batch 서비스가 풀을 자동으로 삭제하지 않습니다. 이 옵션을 사용하여 만든 자동 풀을 삭제하는 것은 사용자의 달려 있습니다.

pool

자동 풀의 풀 사양입니다.

poolLifetimeOption

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

AutoUserScope

자동 사용자에 대한 범위

Name Type Description
pool
  • string

태스크가 풀의 모든 컴퓨팅 노드에서 생성되는 일반적인 자동 사용자 계정으로 실행되도록 지정합니다.

task
  • string

서비스에서 작업에 대한 새 사용자를 만들게 지정합니다.

AutoUserSpecification

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

Name Type Description
elevationLevel

자동 사용자의 권한 상승 수준입니다.
기본값은 nonAdmin입니다.

scope

자동 사용자에 대한 범위
기본값은 풀입니다. 풀이 실행되고 Windows 작업 간에 더 엄격한 격리가 필요한 경우 Task 값을 지정해야 합니다. 예를 들어 태스크가 다른 작업에 영향을 줄 수 있는 방식으로 레지스트리를 변경하거나 일반 작업에서 액세스할 수 없지만 StartTasks에서 액세스할 수 있어야 하는 풀에 인증서를 지정한 경우입니다.

AzureBlobFileSystemConfiguration

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

Name Type Description
accountKey
  • string

Azure Storage 계정 키입니다.
이 속성은 sasKey 및 ID와 함께 사용할 수 없습니다. 정확히 하나만 지정해야 합니다.

accountName
  • string

Azure Storage 계정 이름입니다.

blobfuseOptions
  • string

탑재 명령에 전달할 추가 명령줄 옵션입니다.
Linux의 Windows 및 '탑재' 옵션의 '순 사용' 옵션입니다.

containerName
  • string

Azure Blob Storage 컨테이너 이름입니다.

identityReference

containerName에 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
이 속성은 accountKey와 sasKey 모두와 함께 사용할 수 없습니다. 정확히 하나를 지정해야 합니다.

relativeMountPath
  • string

파일 시스템이 탑재될 컴퓨팅 노드의 상대 경로
모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.

sasKey
  • string

Azure Storage SAS 토큰입니다.
이 속성은 accountKey 및 ID와 함께 사용할 수 없습니다. 정확히 하나만 지정해야 합니다.

AzureFileShareConfiguration

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

Name Type Description
accountKey
  • string

Azure Storage 계정 키입니다.

accountName
  • string

Azure Storage 계정 이름입니다.

azureFileUrl
  • string

Azure Files URL입니다.
'https://{account}.file.core.windows.net/' 형식입니다.

mountOptions
  • string

탑재 명령에 전달할 추가 명령줄 옵션입니다.
Linux의 Windows 및 '탑재' 옵션의 '순 사용' 옵션입니다.

relativeMountPath
  • string

파일 시스템을 탑재할 컴퓨팅 노드의 상대 경로
모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.

BatchError

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

Name Type Description
code
  • string

오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.

message

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

values

오류에 대한 추가 세부 정보를 포함하는 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

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

Name Type Description
key
  • string

Value 속성의 의미를 지정하는 식별자입니다.

value
  • string

오류 응답에 포함된 추가 정보입니다.

CachingType

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

Name Type Description
none
  • string

디스크에 대한 캐싱 모드를 사용할 수 없습니다.

readonly
  • string

디스크의 캐싱 모드는 읽기 전용입니다.

readwrite
  • string

디스크의 캐싱 모드는 읽고 씁니다.

CertificateReference

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

Name Type Description
storeLocation

인증서를 설치할 컴퓨팅 노드의 인증서 저장소 위치입니다.
기본값은 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
  • string[]

컴퓨팅 노드의 사용자 계정이 인증서의 프라이빗 데이터에 액세스할 수 있어야 합니다.
이 컬렉션에서 둘 이상의 표시 유형을 지정할 수 있습니다. 기본값은 모든 계정입니다.

CertificateStoreLocation

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

Name Type Description
currentuser
  • string

인증서는 CurrentUser 인증서 저장소에 설치해야 합니다.

localmachine
  • string

인증서는 LocalMachine 인증서 저장소에 설치해야 합니다.

CIFSMountConfiguration

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

Name Type Description
mountOptions
  • string

탑재 명령에 전달할 추가 명령줄 옵션입니다.
Linux의 Windows 및 '탑재' 옵션의 '순 사용' 옵션입니다.

password
  • string

CIFS 파일 시스템에 대한 인증에 사용할 암호입니다.

relativeMountPath
  • string

파일 시스템을 탑재할 컴퓨팅 노드의 상대 경로
모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.

source
  • string

탑재할 파일 시스템의 URI입니다.

username
  • string

CIFS 파일 시스템에 대한 인증에 사용할 사용자입니다.

CloudJobSchedule

작업을 실행할 시기와 각 작업을 만드는 데 사용되는 사양을 지정하여 되풀이 작업을 허용하는 작업 일정입니다.

Name Type Description
creationTime
  • string

작업 일정의 생성 시간입니다.

displayName
  • string

일정의 표시 이름입니다.

eTag
  • string

작업 일정의 ETag입니다.
불투명 문자열입니다. 이를 사용하여 요청 간에 작업 일정이 변경되었는지 여부를 검색할 수 있습니다. 특히 업데이트 작업 일정 요청과 함께 ETag를 전달하여 그 동안 아무도 일정을 수정하지 않은 경우에만 변경 내용을 적용하도록 지정할 수 있습니다.

executionInfo

이 일정에 따라 실행되고 실행될 작업에 대한 정보입니다.

id
  • string

계정 내에서 일정을 고유하게 식별하는 문자열입니다.

jobSpecification

이 일정에 따라 만들 작업의 세부 정보입니다.

lastModified
  • string

작업 일정의 마지막으로 수정된 시간입니다.
작업 사양 또는 되풀이 정보와 같은 일정 수준 데이터가 마지막으로 변경된 시간입니다. 새 작업을 만들거나 작업 변경 상태와 같은 작업 수준 변경은 고려하지 않습니다.

metadata

일정과 메타데이터로 연결된 이름-값 쌍의 목록입니다.
Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.

previousState

작업 일정의 이전 상태입니다.
작업 일정이 초기 활성 상태이면 이 속성이 없습니다.

previousStateTransitionTime
  • string

작업 일정이 이전 상태로 진입한 시간입니다.
작업 일정이 초기 활성 상태이면 이 속성이 없습니다.

schedule

작업을 만들 일정입니다.
모든 시간은 각각 UTC로 고정되며 일광 절약 시간제의 영향을 받지 않습니다.

state

작업 일정의 현재 상태입니다.

stateTransitionTime
  • string

작업 일정이 현재 상태로 들어온 시간입니다.

stats

작업 일정에 대한 수명 리소스 사용 통계입니다. 통계를 즉시 사용할 수 없습니다. Batch 서비스는 주기적인 통계 롤업을 수행합니다. 일반적인 지연 시간은 약 30분입니다.

url
  • string

작업 일정의 URL입니다.

CloudJobScheduleListResult

계정에 작업 일정을 나열한 결과입니다.

Name Type Description
odata.nextLink
  • string

다음 결과 집합을 가져올 URL입니다.

value

작업 일정 목록입니다.

CloudServiceConfiguration

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

Name Type Description
osFamily
  • string

풀의 가상 머신에 설치할 Azure 게스트 OS 제품군입니다.
가능한 값은 2 - OS 제품군 2이며 Windows Server 2008 R2 SP1과 동일합니다. 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 Type Description
pack
  • string

풀의 다음 컴퓨팅 노드에 태스크를 할당하기 전에 풀의 각 컴퓨팅 노드에 가능한 한 많은 작업(taskSlotsPerNode)을 할당해야 합니다.

spread
  • string

풀의 모든 컴퓨팅 노드에서 태스크를 균등하게 할당해야 합니다.

ComputeNodeIdentityReference

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

Name Type Description
resourceId
  • string

사용자 할당 ID의 ARM 리소스 ID입니다.

ContainerConfiguration

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

Name Type Description
containerImageNames
  • string[]

컨테이너 이미지 이름의 컬렉션입니다.
"docker pull"에 지정된 것처럼 전체 이미지 참조입니다. 이미지가 대체 레지스트리로 정규화되지 않는 한 이미지는 기본 Docker 레지스트리에서 원본이 됩니다.

containerRegistries

컨테이너를 끌어올 수 있는 추가 프라이빗 레지스트리입니다.
자격 증명이 필요한 개인 레지스트리에서 이미지를 다운로드해야 하는 경우 해당 자격 증명을 여기에 제공해야 합니다.

type

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

ContainerRegistry

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

Name Type Description
identityReference

사용자 이름 및 암호 대신 Azure Container Registry 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
컴퓨팅 노드에서 사용할 Batch 풀과 연결된 사용자 할당 ID에 대한 참조입니다.

password
  • string

레지스트리 서버에 로그인할 암호입니다.

registryServer
  • string

레지스트리 URL입니다.
생략하면 기본값은 "docker.io"입니다.

username
  • string

레지스트리 서버에 로그인할 사용자 이름입니다.

ContainerType

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

Name Type Description
dockerCompatible
  • string

Docker 호환 컨테이너 기술은 컨테이너를 시작하는 데 사용됩니다.

ContainerWorkingDirectory

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

Name Type Description
containerImageDefault
  • string

컨테이너 이미지에 정의된 작업 디렉터리를 사용합니다. 이 디렉터리에 Batch에서 다운로드한 리소스 파일이 포함되지 않도록 주의하세요.

taskWorkingDirectory
  • string

Batch로 채워진 작업 리소스 파일을 포함하는 표준 Batch 서비스 작업 디렉터리를 사용합니다.

DataDisk

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

Name Type Description
caching

데이터 디스크에 사용할 캐싱 유형입니다.
캐싱의 기본값은 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

데이터 디스크에 사용할 스토리지 계정 유형입니다.
생략하면 기본값은 "standard_lrs"입니다.

DiffDiskPlacement

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

Name Type Description
CacheDisk
  • string

임시 OS 디스크는 VM 캐시에 저장됩니다.

DiffDiskSettings

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

Name Type Description
placement

풀의 모든 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

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

Name Type Description
targets
  • string[]

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

DynamicVNetAssignmentScope

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

Name Type Description
job
  • string

동적 VNet 할당은 작업별로 수행됩니다.

none
  • string

동적 VNet 할당을 사용할 수 없습니다.

ElevationLevel

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

Name Type Description
admin
  • string

사용자는 상승된 액세스 권한을 가진 사용자이며 전체 관리자 권한으로 작동합니다.

nonadmin
  • string

사용자는 상승된 액세스 권한이 없는 표준 사용자입니다.

EnvironmentSetting

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

Name Type Description
name
  • string

환경 변수의 이름입니다.

value
  • string

환경 변수의 값입니다.

ErrorMessage

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

Name Type Description
lang
  • string

오류 메시지의 언어 코드

value
  • string

메시지의 텍스트입니다.

HttpHeader

HTTP 헤더 이름-값 쌍

Name Type Description
name
  • string

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

value
  • string

출력 파일을 업로드하는 동안 사용할 헤더의 값입니다.

ImageReference

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

Name Type 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

Shared Image 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 속성과 함께 사용할 수 없습니다. Shared Image Gallery 이미지는 동일한 지역에 복제본이 있어야 하며 Azure Batch 계정과 동일한 구독에 있어야 합니다. imageId에 이미지 버전이 지정되지 않은 경우 최신 버전이 사용됩니다. Batch 컴퓨팅 노드 에이전트가 Batch 서비스와 통신하기 위한 방화벽 설정에 대한 자세한 내용은 다음을 참조하세요 https://docs.microsoft.com/en-us/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

InboundEndpointProtocol

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

Name Type Description
tcp
  • string

엔드포인트에 TCP를 사용합니다.

udp
  • string

엔드포인트에 UDP를 사용합니다.

InboundNATPool

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

Name Type Description
backendPort
  • integer

컴퓨팅 노드의 포트 번호입니다.
Batch 풀 내에서 고유해야 합니다. 허용되는 값은 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

엔드포인트에 적용될 네트워크 보안 그룹 규칙 목록입니다.
Batch 풀의 모든 엔드포인트에서 지정할 수 있는 최대 규칙 수는 25개입니다. 네트워크 보안 그룹 규칙을 지정하지 않으면 지정된 backendPort에 대한 인바운드 액세스를 허용하는 기본 규칙이 만들어집니다. 최대 네트워크 보안 그룹 규칙 수를 초과하는 경우 HTTP 상태 코드 400으로 요청이 실패합니다.

protocol

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

IPAddressProvisioningType

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

Name Type Description
batchmanaged
  • string

공용 IP는 Batch에서 만들고 관리합니다. 풀의 크기에 따라 여러 공용 IP가 있을 수 있습니다.

nopublicipaddresses
  • string

공용 IP 주소는 만들어지지 않습니다.

usermanaged
  • string

공용 IP는 사용자가 제공하며 컴퓨팅 노드를 프로비전하는 데 사용됩니다.

JobConstraints

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

Name Type Description
maxTaskRetryCount
  • integer

각 작업을 재시도할 수 있는 최대 횟수입니다. Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다.
이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 작업을 최대 4번(초기 시도 1회, 재시도 3회)을 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스에서 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 안 됨)입니다.

maxWallClockTime
  • string

작업이 실행될 수 있는 최대 경과 시간이며, 작업이 만들어진 시간부터 측정됩니다.
작업이 시간 제한 내에 완료되지 않으면 Batch 서비스는 작업을 종료하고 여전히 실행 중인 태스크를 종료합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry입니다. 이 속성을 지정하지 않으면 작업이 실행될 수 있는 기간에 대한 시간 제한이 없습니다.

JobManagerTask

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

Name Type Description
allowLowPriorityNode
  • boolean

작업 관리자 태스크가 스폿/낮은 우선 순위의 컴퓨팅 노드에서 실행할 수 있는지 여부입니다.
기본값은 true입니다.

applicationPackageReferences

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 배포할 애플리케이션 패키지 목록입니다.
애플리케이션 패키지는 다운로드되어 작업 디렉터리가 아닌 공유 디렉터리에 배포됩니다. 따라서 참조된 애플리케이션 패키지가 컴퓨팅 노드에 이미 있고 최신 상태이면 다시 다운로드되지 않습니다. 컴퓨팅 노드의 기존 복사본이 사용됩니다. 참조된 애플리케이션 패키지를 설치할 수 없는 경우(예: 패키지가 삭제되었거나 다운로드가 실패했기 때문에) 작업이 실패합니다.

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

작업 관리자 태스크에 적용되는 제약 조건입니다.

containerSettings

작업 관리자 태스크가 실행되는 컨테이너에 대한 설정입니다.
이 작업을 실행할 풀에 containerConfiguration 집합이 있는 경우 이 설정도 설정해야 합니다. 이 작업을 실행할 풀에 containerConfiguration이 설정되어 있지 않으면 설정하면 안 됩니다. 이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 태스크 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.

displayName
  • string

작업 관리자 태스크의 표시 이름입니다.
고유할 필요는 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.

environmentSettings

작업 관리자 태스크에 대한 환경 변수 설정 목록입니다.

id
  • string

작업 내에서 작업 관리자 태스크를 고유하게 식별하는 문자열입니다.
ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다.

killJobOnCompletion
  • boolean

작업 관리자 태스크 완료가 전체 작업의 완료를 나타내는지 여부입니다.
true이면 작업 관리자 태스크가 완료되면 Batch 서비스에서 작업을 완료로 표시합니다. 작업 릴리스가 아닌 현재 실행 중인 태스크가 있으면 해당 작업이 종료됩니다. false이면 작업 관리자 태스크 완료가 작업 상태에 영향을 주지 않습니다. 이 경우 onAllTasksComplete 특성을 사용하여 작업을 종료하거나 클라이언트 또는 사용자가 작업을 명시적으로 종료하도록 해야 합니다. 예를 들어 작업 관리자가 작업 집합을 만든 다음 실행에서 더 이상 역할을 수행하지 않는 경우입니다. 기본값은 true입니다. onAllTasksComplete 및 onTaskFailure 특성을 사용하여 작업 수명을 제어하고 작업 관리자 태스크를 사용하여 작업 태스크를 만드는 경우(진행률을 모니터링하지 않음) killJobOnCompletion을 false로 설정하는 것이 중요합니다.

outputFiles

명령줄을 실행한 후 Batch 서비스가 컴퓨팅 노드에서 업로드할 파일 목록입니다.
다중 인스턴스 작업의 경우 파일은 주 작업이 실행되는 컴퓨팅 노드에서만 업로드됩니다.

requiredSlots
  • integer

태스크를 실행하기 위해 필요한 예약 슬롯의 수입니다.
기본값은 1입니다. 노드에 사용 가능한 충분한 예약 슬롯이 있는 경우에만 컴퓨팅 노드에서 작업을 실행하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 이 속성은 지원되지 않으며 지정해서는 안 됩니다.

resourceFiles

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다.
이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.

runExclusive
  • boolean

작업 관리자 태스크가 실행되는 컴퓨팅 노드를 단독으로 사용해야 하는지 여부입니다.
true이면 작업 관리자가 실행되는 동안 동일한 노드에서 다른 작업이 실행되지 않습니다. false이면 컴퓨팅 노드의 작업 관리자와 동시에 다른 작업을 실행할 수 있습니다. 작업 관리자 태스크는 일반적으로 컴퓨팅 노드의 동시 작업 제한에 대해 계산되므로 컴퓨팅 노드에서 여러 동시 작업을 허용하는 경우에만 관련이 있습니다. 기본값은 true입니다.

userIdentity

작업 관리자 태스크가 실행되는 사용자 ID입니다.
생략하면 태스크는 작업에 고유한 비관리 사용자로 실행됩니다.

JobNetworkConfiguration

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

Name Type 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 Type 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

작업 준비 태스크에 적용되는 제약 조건입니다.

containerSettings

작업 준비 태스크가 실행되는 컨테이너에 대한 설정입니다.
이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 태스크 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.

environmentSettings

작업 준비 태스크에 대한 환경 변수 설정 목록입니다.

id
  • string

작업 내에서 작업 준비 태스크를 고유하게 식별하는 문자열입니다.
ID는 하이픈과 밑줄을 포함하여 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. 이 속성을 지정하지 않으면 Batch 서비스에서 기본값인 'jobpreparation'을 할당합니다. 작업의 다른 태스크는 작업 준비 태스크와 동일한 ID를 가질 수 없습니다. 동일한 ID를 가진 작업을 제출하려고 하면 Batch 서비스는 TaskIdSameAsJobPreparationTask 오류 코드로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 409(충돌)입니다.

rerunOnNodeRebootAfterSuccess
  • boolean

컴퓨팅 노드가 다시 부팅된 후 Batch 서비스가 작업 준비 태스크를 다시 실행해야 하는지 여부입니다.
컴퓨팅 노드가 이미지로 다시 설치되거나 작업 준비 태스크가 완료되지 않은 경우(예: 태스크가 실행되는 동안 다시 부팅이 발생했기 때문에) 작업 준비 태스크가 항상 다시 실행됩니다. 따라서 멱등원으로 작업 준비 태스크를 작성하고 여러 번 실행하는 경우 올바르게 동작해야 합니다. 기본값은 true입니다.

resourceFiles

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다.
이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.

userIdentity

작업 준비 태스크가 실행되는 사용자 ID입니다.
생략하면 태스크는 Windows 컴퓨팅 노드의 태스크에 고유한 비관리 사용자 또는 Linux 컴퓨팅 노드의 풀에 고유한 비관리 사용자로 실행됩니다.

waitForSuccess
  • boolean

Batch 서비스가 컴퓨팅 노드에서 작업의 다른 작업을 예약하기 전에 작업 준비 태스크가 성공적으로 완료될 때까지 기다려야 하는지 여부입니다. 작업 준비 태스크가 종료 코드 0과 함께 종료되면 성공적으로 완료되었습니다.
True이고 작업 준비 태스크가 노드에서 실패하면 Batch 서비스는 최대 재시도 횟수까지 작업 준비 태스크를 다시 시도합니다(제약 조건 요소에 지정된 대로). 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 작업의 태스크를 노드로 예약하지 않습니다. 노드는 활성 상태로 유지되며 다른 작업의 작업을 실행할 수 있습니다. false이면 Batch 서비스는 작업 준비 태스크가 완료될 때까지 기다리지 않습니다. 이 경우 작업 준비 태스크가 계속 실행되는 동안 다른 작업 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. 작업 준비 태스크가 실패하더라도 새 작업은 컴퓨팅 노드에서 계속 예약됩니다. 기본값은 true입니다.

JobReleaseTask

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

Name Type 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

작업 릴리스 태스크가 실행되는 컨테이너에 대한 설정입니다.
이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 태스크 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부의 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.

environmentSettings

작업 릴리스 태스크에 대한 환경 변수 설정 목록입니다.

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

명령줄을 실행하기 전에 Batch 서비스가 컴퓨팅 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드는 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles 컬렉션의 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다.

retentionTime
  • string

컴퓨팅 노드의 작업 릴리스 태스크에 대한 작업 디렉터리를 유지하는 최소 시간입니다. 이 시간 후에 Batch 서비스는 작업 디렉터리와 모든 내용을 삭제할 수 있습니다.
기본값은 7일입니다. 즉, 컴퓨팅 노드가 제거되거나 작업이 삭제되지 않는 한 작업 디렉터리가 7일 동안 유지됩니다.

userIdentity

작업 릴리스 태스크가 실행되는 사용자 ID입니다.
생략하면 태스크는 작업에 고유한 비관리 사용자로 실행됩니다.

JobScheduleExecutionInformation

작업 일정에 따라 실행되고 실행될 작업에 대한 정보를 포함합니다.

Name Type Description
endTime
  • string

일정이 종료된 시간입니다.
이 속성은 작업 일정이 완료된 상태인 경우에만 설정됩니다.

nextRunTime
  • string

다음에 이 일정에 따라 작업을 만들 때입니다.
이 속성은 시간이 올 때 일정이 활성 상태인 경우에만 의미가 있습니다. 예를 들어 일정을 사용하지 않도록 설정하면 그 전에 작업을 사용하도록 설정하지 않으면 nextRunTime에 작업이 만들어지지 않습니다.

recentJob

작업 일정에서 가장 최근 작업에 대한 정보입니다.
이 속성은 하나 이상의 작업이 일정에 따라 실행된 경우에만 존재합니다.

JobScheduleState

작업 일정의 상태입니다.

Name Type Description
active
  • string

작업 일정이 활성 상태이며 일정에 따라 작업을 만듭니다.

completed
  • string

작업 일정은 종료 시간에 도달하거나 사용자가 명시적으로 종료하여 종료되었습니다.

deleting
  • string

사용자가 작업 일정을 삭제해 달라고 요청했지만 삭제 작업은 아직 진행 중입니다. 스케줄러는 이 작업 일정에 대한 새 작업을 시작하지 않으며 활성 작업을 포함하여 작업 일정에 따라 기존 작업 및 작업을 삭제합니다. 작업 일정 아래의 모든 작업 및 작업이 삭제되면 작업 일정이 삭제됩니다.

disabled
  • string

사용자가 작업 일정을 사용하지 않도록 설정했습니다. 스케줄러는 이 일정에 따라 새 작업을 시작하지 않지만 기존 활성 작업은 계속 실행됩니다.

terminating
  • string

작업 일정에 수행할 작업이 더 이상 없거나 사용자가 명시적으로 종료했지만 종료 작업은 아직 진행 중입니다. 스케줄러는 이 작업 일정에 대한 새 작업을 시작하지 않으며 기존 작업이 활성 상태가 아닙니다.

JobScheduleStatistics

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

Name Type Description
kernelCPUTime
  • string

일정에 따라 생성된 모든 작업의 모든 태스크에서 사용하는 총 커널 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합계)입니다.

lastUpdateTime
  • string

통계가 마지막으로 업데이트된 시간입니다. 모든 통계는 startTime과 lastUpdateTime 사이의 범위로 제한됩니다.

numFailedTasks
  • integer

일정에 따라 생성된 작업의 지정된 시간 범위 동안 실패한 총 작업 수입니다. 종료 코드 0을 반환하지 않고 최대 재시도 횟수가 소진되면 태스크가 실패합니다.

numSucceededTasks
  • integer

일정에 따라 만들어진 작업의 지정된 시간 범위 동안 완료된 총 작업 수입니다. 종료 코드 0을 반환하면 작업이 성공적으로 완료됩니다.

numTaskRetries
  • integer

일정에 따라 생성된 모든 작업의 모든 작업에 대해 지정된 시간 범위 동안의 총 재시도 횟수입니다.

readIOGiB
  • number

일정에 따라 생성된 모든 작업의 모든 작업에서 디스크에서 읽은 총 기비바이트입니다.

readIOps
  • integer

일정에 따라 생성된 모든 작업의 모든 작업에서 수행한 디스크 읽기 작업의 총 수입니다.

startTime
  • string

통계에서 다루는 시간 범위의 시작 시간입니다.

url
  • string

통계의 URL입니다.

userCPUTime
  • string

일정에 따라 생성된 모든 작업의 모든 태스크에서 사용하는 총 사용자 모드 CPU 시간(모든 코어 및 모든 컴퓨팅 노드에서 합계)입니다.

waitTime
  • string

일정에 따라 생성된 모든 작업의 총 대기 시간입니다. 태스크에 대한 대기 시간은 작업 만들기와 작업 실행 시작 사이의 경과 시간으로 정의됩니다. (오류로 인해 태스크를 다시 시도하면 대기 시간이 가장 최근 작업 실행 시간입니다.)
이 값은 계정 수명 통계에서만 보고됩니다. 작업 통계에 포함되지 않습니다.

wallClockTime
  • string

일정에 따라 생성된 모든 작업의 총 벽 시계 시간입니다.
벽시계 시간은 태스크가 컴퓨팅 노드에서 실행되기 시작한 시점부터 완료된 시간(또는 통계가 업데이트된 마지막 시간(그때까지 작업이 완료되지 않은 경우)까지 경과된 시간입니다. 작업을 다시 시도하면 모든 작업 재시도의 벽시계 시간이 포함됩니다.

writeIOGiB
  • number

일정에 따라 생성된 모든 작업의 모든 작업에서 디스크에 쓴 총 기비바이트입니다.

writeIOps
  • integer

일정에 따라 생성된 모든 작업의 모든 작업에서 수행한 디스크 쓰기 작업의 총 수입니다.

JobSpecification

일정에 따라 만들 작업의 세부 정보를 지정합니다.

Name Type Default Value Description
allowTaskPreemption
  • boolean

다른 우선 순위가 높은 작업에서 이 작업의 태스크를 선점할 수 있는지 여부
값이 True로 설정된 경우 시스템에 제출된 다른 우선 순위가 높은 작업이 우선적으로 적용되며 이 작업에서 작업을 다시 큐에 추가할 수 있습니다. 업데이트 작업 API를 사용하여 작업을 만든 후 작업의 allowTaskPreemption을 업데이트할 수 있습니다.

commonEnvironmentSettings

일반적인 환경 변수 설정 목록입니다. 이러한 환경 변수는 이 일정에 따라 생성된 작업의 모든 작업(작업 관리자, 작업 준비 및 작업 릴리스 작업 포함)에 대해 설정됩니다.
개별 작업은 다른 값으로 동일한 설정 이름을 지정하여 여기에 지정된 환경 설정을 재정의할 수 있습니다.

constraints

이 일정에 따라 만든 작업에 대한 실행 제약 조건입니다.

displayName
  • string

이 일정에 따라 만든 작업의 표시 이름입니다.
이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.

jobManagerTask

이 일정에 따라 작업을 시작할 때 시작할 작업 관리자 태스크의 세부 정보입니다.
작업이 작업 관리자 태스크를 지정하지 않는 경우 사용자는 작업 API를 사용하여 작업에 작업을 명시적으로 추가해야 합니다. 작업이 작업 관리자 태스크를 지정하는 경우 Batch 서비스는 작업을 만들 때 작업 관리자 태스크를 만들고 작업의 다른 작업을 예약하기 전에 작업 관리자 태스크를 예약하려고 합니다.

jobPreparationTask

이 일정에 따라 만든 작업에 대한 작업 준비 태스크입니다.
작업에 작업 준비 태스크가 있는 경우 Batch 서비스는 해당 컴퓨팅 노드에서 해당 작업의 태스크를 시작하기 전에 노드에서 작업 준비 태스크를 실행합니다.

jobReleaseTask

이 일정에 따라 만든 작업에 대한 작업 릴리스 태스크입니다.
작업 해제 태스크의 주요 목적은 작업 준비 태스크에서 수행한 노드의 변경 내용을 실행 취소하는 것입니다. 예제 작업에는 로컬 파일 삭제 또는 작업 준비의 일부로 시작된 서비스 종료가 포함됩니다. 작업에 대한 작업 준비 태스크도 지정하지 않고는 작업 해제 태스크를 지정할 수 없습니다. Batch 서비스는 작업 준비 태스크를 실행한 컴퓨팅 노드에서 작업 릴리스 태스크를 실행합니다.

maxParallelTasks
  • integer
-1

작업에 대해 병렬로 실행할 수 있는 최대 태스크 수입니다.
maxParallelTasks 값은 -1이거나 지정된 경우 0보다 커야 합니다. 지정하지 않으면 기본값은 -1입니다. 즉, 한 번에 실행할 수 있는 작업 수에는 제한이 없습니다. 업데이트 작업 API를 사용하여 작업의 maxParallelTasks를 만든 후에 업데이트할 수 있습니다.

metadata

이 일정에 따라 메타데이터로 만든 각 작업과 연결된 이름-값 쌍의 목록입니다.
Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.

networkConfiguration

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

onAllTasksComplete

이 일정에 따라 만든 작업의 모든 작업이 완료된 상태일 때 Batch 서비스에서 수행해야 하는 작업입니다.
작업에 태스크가 없으면 모든 작업이 완료된 것으로 간주됩니다. 따라서 이 옵션은 작업 관리자 작업에서 가장 일반적으로 사용됩니다. 작업 관리자 없이 자동 작업 종료를 사용하려면 처음에 OnAllTasksComplete를 noaction으로 설정하고 작업 속성을 업데이트하여 작업 추가가 완료되면AllTasksComplete를 종료하도록 설정해야 합니다. 기본값은 noaction입니다.

onTaskFailure

이 일정에 따라 만든 작업에서 태스크가 실패할 때 Batch 서비스가 수행해야 하는 작업입니다. 오류가 발생한 경우 작업이 실패한 것으로 간주됩니다. 다시 시도 횟수를 소진한 후 태스크가 0이 아닌 종료 코드로 완료되거나, 예를 들어 리소스 파일 다운로드 오류로 인해 작업을 시작하는 동안 오류가 발생한 경우 failureInfo가 설정됩니다.
기본값은 noaction입니다.

poolInfo

Batch 서비스가 이 일정에 따라 만든 작업의 작업을 실행하는 풀입니다.

priority
  • integer

이 일정에 따라 만든 작업의 우선 순위입니다.
우선 순위 값의 범위는 -1000~1000이며 -1000이 가장 낮은 우선 순위이고 1000이 가장 높은 우선 순위입니다. 기본값은 0입니다. 이 우선 순위는 작업 일정에 따라 모든 작업의 기본값으로 사용됩니다. 업데이트 작업 API를 사용하여 작업 우선 순위를 만든 후에 업데이트할 수 있습니다.

usesTaskDependencies
  • boolean

작업의 태스크가 서로 종속성을 정의할 수 있는지 여부입니다. 기본값은 false입니다.

LinuxUserConfiguration

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

Name Type Description
gid
  • integer

사용자 계정의 그룹 ID입니다.
uid 및 gid 속성을 함께 지정하거나 지정하지 않아야 합니다. 지정하지 않으면 기본 운영 체제에서 gid를 선택합니다.

sshPrivateKey
  • string

사용자 계정에 대한 SSH 프라이빗 키입니다.
프라이빗 키는 암호로 보호되어서는 안 됩니다. 프라이빗 키는 풀의 enableInterNodeCommunication 속성이 true일 때 Linux 풀의 컴퓨팅 노드 간에 SSH에 대한 비대칭 키 기반 인증을 자동으로 구성하는 데 사용됩니다(enableInterNodeCommunication이 false이면 무시됨). 이 작업은 키 쌍을 사용자의 .ssh 디렉터리에 배치하여 수행합니다. 지정하지 않으면 Compute 노드 간에 암호 없는 SSH가 구성되지 않습니다(사용자의 .ssh 디렉터리를 수정하지 않음).

uid
  • integer

사용자 계정의 사용자 ID입니다.
uid 및 gid 속성을 함께 지정하거나 지정하지 않아야 합니다. 지정하지 않으면 기본 운영 체제가 uid를 선택합니다.

LoginMode

사용자의 로그인 모드

Name Type Description
batch
  • string

LOGON32_LOGON_BATCH Win32 로그인 모드입니다. 일괄 처리 로그인 모드는 장기 실행 병렬 프로세스에 권장됩니다.

interactive
  • string

LOGON32_LOGON_INTERACTIVE Win32 로그인 모드입니다. UAC는 Windows VirtualMachineConfiguration 풀에서 사용하도록 설정됩니다. 이 옵션을 Windows VirtualMachineConfiguration 풀에서 관리자 권한으로 사용하는 경우 작업 명령줄에서 실행되는 애플리케이션이 항상 관리 권한을 요구하거나 항상 최대 권한을 요구하도록 구성되지 않는 한 사용자 세션은 상승되지 않습니다.

MetadataItem

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

Name Type Description
name
  • string

메타데이터 항목의 이름입니다.

value
  • string

메타데이터 항목의 값입니다.

MountConfiguration

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

Name Type Description
azureBlobFileSystemConfiguration

각 노드에서 Blob FUSE를 사용하여 탑재할 Azure Storage 컨테이너입니다.
이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

azureFileShareConfiguration

각 노드에 탑재할 Azure 파일 공유입니다.
이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

cifsMountConfiguration

각 노드에 탑재할 CIFS/SMB 파일 시스템입니다.
이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

nfsMountConfiguration

각 노드에 탑재할 NFS 파일 시스템입니다.
이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

NetworkConfiguration

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

Name Type Description
dynamicVNetAssignmentScope

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

endpointConfiguration

Batch 풀의 컴퓨팅 노드에 있는 엔드포인트에 대한 구성입니다.
풀 엔드포인트 구성은 virtualMachineConfiguration 속성이 있는 풀에서만 지원됩니다.

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 Type Description
access

지정된 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 Type Description
allow
  • string

액세스를 허용합니다.

deny
  • string

액세스를 거부합니다.

NFSMountConfiguration

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

Name Type Description
mountOptions
  • string

탑재 명령에 전달할 추가 명령줄 옵션입니다.
Linux의 Windows 및 '탑재' 옵션의 '순 사용' 옵션입니다.

relativeMountPath
  • string

파일 시스템을 탑재할 컴퓨팅 노드의 상대 경로
모든 파일 시스템은 Batch 탑재 디렉터리를 기준으로 탑재되며 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있습니다.

source
  • string

탑재할 파일 시스템의 URI입니다.

NodePlacementConfiguration

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

Name Type Description
policy

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

NodePlacementPolicyType

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

Name Type Description
regional
  • string

풀의 모든 노드는 동일한 지역에 할당됩니다.

zonal
  • string

풀의 노드는 최상의 균형 조정을 통해 여러 가용성 영역에 분산됩니다.

OnAllTasksComplete

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

Name Type Description
noaction
  • string

아무 작업도 하지 않습니다. 다른 수단으로 종료되거나 사용하지 않도록 설정되지 않은 한 작업은 활성 상태로 유지됩니다.

terminatejob
  • string

작업을 종료합니다. 작업의 terminateReason이 'AllTasksComplete'로 설정됩니다.

OnTaskFailure

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

Name Type Description
noaction
  • string

아무 작업도 하지 않습니다. 다른 수단으로 종료되거나 사용하지 않도록 설정되지 않은 한 작업은 활성 상태로 유지됩니다.

performexitoptionsjobaction
  • string

Task의 exitConditions 컬렉션에서 작업 종료 조건과 연결된 작업을 수행합니다. (작업에서 지정한 경우 아무 작업도 수행되지 않을 수 있습니다.)

OSDisk

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

Name Type Description
ephemeralOSDiskSettings

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

OutputFile

Batch 서비스가 작업 프로세스 실행을 완료한 후 Azure Batch 컴퓨팅 노드에서 다른 위치로 파일을 업로드하기 위한 사양입니다.

Name Type Description
destination

출력 파일의 대상입니다.

filePattern
  • string

업로드할 파일을 나타내는 패턴입니다.
상대 경로와 절대 경로가 모두 지원됩니다. 상대 경로는 작업 작업 디렉터리를 기준으로 합니다. 다음 와일드카드가 지원됩니다. * 0개 이상의 문자와 일치합니다(예: 패턴 abc*는 abc 또는 abcdef와 일치함), ** 모든 디렉터리를 일치합니다. ? 는 모든 단일 문자와 일치하고[abc]는 대괄호 안의 한 문자와 일치하며 [a-c]는 범위의 한 문자와 일치합니다. 대괄호는 지정되지 않은 문자와 일치하도록 부정을 포함할 수 있습니다(예: [!abc]는 a, b 또는 c를 제외한 모든 문자와 일치함). 파일 이름이 "."로 시작하는 경우 기본적으로 무시되지만 명시적으로 지정하여 일치시킬 수 있습니다(예: .gif .a.gif 일치하지 않지만 ..gif). 간단한 예: ***.txt '.'에서 시작하지 않고 Task 작업 디렉터리 또는 하위 디렉터리의 .txt 끝나는 모든 파일과 일치합니다. 파일 이름에 와일드카드 문자가 포함되어 있으면 대괄호를 사용하여 이스케이프할 수 있습니다(예: abc[]는 abc라는 파일과 일치함). \ 및/는 모두 Windows 디렉터리 구분 기호로 처리되지만 Linux에만/입니다. 환경 변수(Windows%var% 또는 Linux의 $var)는 패턴이 적용되기 전에 확장됩니다.

uploadOptions

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

OutputFileBlobContainerDestination

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

Name Type Description
containerUrl
  • string

파일을 업로드할 Azure Blob Storage 내 컨테이너의 URL입니다.
관리 ID를 사용하지 않는 경우 URL에는 컨테이너에 쓰기 권한을 부여하는 SAS(공유 액세스 서명)가 포함되어야 합니다.

identityReference

containerUrl에서 지정한 Azure Blob Storage 액세스하는 데 사용할 사용자 할당 ID에 대한 참조입니다.
ID는 Azure Blob Storage 컨테이너에 대한 쓰기 권한이 있어야 합니다.

path
  • string

Azure Storage 컨테이너 내의 대상 Blob 또는 가상 디렉터리입니다.
filePattern이 특정 파일(예: 와일드카드를 포함하지 않음)을 참조하는 경우 경로는 해당 파일을 업로드할 Blob의 이름입니다. filePattern에 하나 이상의 와일드카드가 포함되어 있는 경우(따라서 여러 파일과 일치할 수 있음) 경로는 파일을 업로드할 Blob 가상 디렉터리(각 Blob 이름 앞에 추가됨)의 이름입니다. 생략하면 파일이 파일 이름과 일치하는 Blob 이름을 사용하여 컨테이너의 루트에 업로드됩니다.

uploadHeaders

출력 파일 업로드에 사용할 헤더의 이름-값 쌍 목록
이러한 헤더는 Azure Storage 파일을 업로드할 때 지정됩니다. 자세한 내용은 요청 헤더(모든 Blob 형식)를 참조하세요.

OutputFileDestination

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

Name Type Description
container

파일이 업로드되는 Azure Blob Storage의 위치입니다.

OutputFileUploadCondition

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

Name Type Description
taskcompletion
  • string

종료 코드가 무엇이든 태스크 프로세스가 종료된 후 파일을 업로드.

taskfailure
  • string

0이 아닌 종료 코드를 사용하여 작업 프로세스가 종료된 후에만 파일을 업로드.

tasksuccess
  • string

종료 코드가 0인 작업 프로세스가 종료된 후에만 파일을 업로드.

OutputFileUploadOptions

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

Name Type Description
uploadCondition

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

PoolEndpointConfiguration

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

Name Type Description
inboundNATPools

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

PoolInformation

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

Name Type Description
autoPoolSpecification

임시 '자동 풀'의 특징입니다. Batch 서비스는 작업이 제출될 때 이 자동 풀을 만듭니다.
자동 풀 만들기가 실패하면 Batch 서비스는 작업을 완료된 상태로 이동하고 풀 만들기 오류는 작업의 예약 오류 속성에 설정됩니다. Batch 서비스는 자동 풀의 수명(keepAlive가 지정되지 않은 경우 생성 및 삭제)을 관리합니다. 작업이 활성 상태인 동안 자동 풀의 수명에 영향을 주는 모든 사용자 작업은 예기치 않은 동작을 발생합니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.

poolId
  • string

기존 풀의 ID입니다. 작업의 모든 작업은 지정된 풀에서 실행됩니다.
이 속성에서 참조하는 풀이 있는지 확인해야 합니다. Batch 서비스가 작업을 예약하려고 할 때 풀이 없는 경우 해당 ID가 있는 풀을 만들 때까지 작업에 대한 태스크가 실행되지 않습니다. Batch 서비스는 작업 요청을 거부하지 않습니다. 풀이 존재할 때까지 작업을 실행하지 않습니다. 풀 ID 또는 자동 풀 사양을 지정해야 하지만 둘 다 지정하지는 않습니다.

PoolLifetimeOption

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

Name Type Description
job
  • string

풀은 전용인 작업의 수명 동안 존재합니다. Batch 서비스는 작업을 만들 때 풀을 만듭니다. 'job' 옵션이 작업 일정에 적용되는 경우 Batch 서비스는 일정에 따라 생성된 모든 작업에 대해 새 자동 풀을 만듭니다.

jobschedule
  • string

풀은 작업 일정의 수명 동안 존재합니다. Batch 서비스는 일정에 따라 첫 번째 작업을 만들 때 풀을 만듭니다. 이 옵션은 작업 일정에만 적용할 수 있으며 작업에는 적용할 수 없습니다.

PoolSpecification

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

Name Type Description
applicationLicenses
  • string[]

Batch 서비스가 풀의 각 컴퓨팅 노드에서 사용할 수 있도록 하는 애플리케이션 라이선스 목록입니다.
애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다. 풀에서 사용할 수 있는 허용된 라이선스는 'maya', 'vray', '3dsmax', 'arnold'입니다. 풀에 추가된 각 애플리케이션 라이선스에 대해 추가 요금이 적용됩니다.

applicationPackageReferences

풀의 각 컴퓨팅 노드에 설치할 패키지 목록입니다.
패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅되거나 이미지로 다시 설치될 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다.

autoScaleEvaluationInterval
  • string

자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다.
기본값은 15분입니다. 최소값과 최대값은 각각 5분과 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하는 경우 Batch 서비스는 잘못된 속성 값 오류로 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

autoScaleFormula
  • string

풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다.
enableAutoScale이 false로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 true로 설정된 경우 필요합니다. 풀을 만들기 전에 수식이 유효한지 확인합니다. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다.

certificateReferences

풀의 각 컴퓨팅 노드에 설치할 인증서 목록입니다.
Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 이 위치를 쿼리하기 위해 태스크에 환경 변수 AZ_BATCH_CERTIFICATES_DIR 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.

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

풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다.
Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.

mountConfiguration

풀의 각 노드에 탑재할 파일 시스템 목록입니다.
Azure Files, NFS, CIFS/SMB 및 Blobfuse를 지원합니다.

networkConfiguration

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

resizeTimeout
  • string

풀에 컴퓨팅 노드를 할당하기 위한 시간 제한입니다.
이 시간 제한은 수동 크기 조정에만 적용됩니다. enableAutoScale이 true로 설정된 경우에는 효과가 없습니다. 기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스는 오류와 함께 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

startTask

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

targetDedicatedNodes
  • integer

풀에서 원하는 전용 컴퓨팅 노드 수입니다.
enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

targetLowPriorityNodes
  • integer

풀에서 원하는 스폿/우선 순위가 낮은 컴퓨팅 노드 수입니다.
enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.

taskSchedulingPolicy

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

taskSlotsPerNode
  • integer

풀의 단일 컴퓨팅 노드에서 동시 태스크를 실행하는 데 사용할 수 있는 태스크 슬롯의 수입니다.
기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256개입니다.

userAccounts

풀의 각 컴퓨팅 노드에 만들 사용자 계정 목록입니다.

virtualMachineConfiguration

풀에 대한 가상 머신 구성입니다.
풀을 Azure IaaS VM으로 만들어야 하는 경우 이 속성을 지정해야 합니다. 이 속성과 cloudServiceConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다. 둘 다 지정하지 않으면 Batch 서비스가 오류를 반환합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

vmSize
  • string

풀에 있는 가상 머신의 크기입니다. 풀의 모든 가상 머신 크기는 동일합니다.
풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀(https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes)에서 컴퓨팅 노드에 대한 VM 크기 선택을 참조하세요.

PublicIPAddressConfiguration

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

Name Type Description
ipAddressIds
  • string[]

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

provision

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

RecentJob

작업 일정에 따라 실행할 가장 최근 작업에 대한 정보입니다.

Name Type Description
id
  • string

작업의 ID입니다.

url
  • string

작업의 URL입니다.

ResourceFile

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

Name Type 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

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

Schedule

작업을 만들 일정입니다. 모든 시간은 각각 UTC로 고정되며 일광 절약 시간제의 영향을 받지 않습니다.

Name Type Description
doNotRunAfter
  • string

이 작업 일정에 따라 작업이 만들어지지 않는 시간입니다. 이 최종 기한이 지났고 이 작업 일정에 활성 작업이 없는 즉시 일정이 완료된 상태로 이동합니다.
doNotRunAfter 시간을 지정하지 않고 되풀이 작업 일정을 만드는 경우 명시적으로 종료할 때까지 작업 일정이 활성 상태로 유지됩니다.

doNotRunUntil
  • string

이 작업 일정에 따라 작업을 만들 수 있는 가장 빠른 시간입니다.
doNotRunUntil 시간을 지정하지 않으면 일정이 작업을 즉시 만들 준비가 됩니다.

recurrenceInterval
  • string

작업 일정에 따라 연속된 두 작업의 시작 시간 사이의 시간 간격입니다. 작업 일정은 지정된 시간에 하나 이상의 활성 작업을 가질 수 있습니다.
작업 일정은 지정된 시간에 하나 이상의 활성 작업을 가질 수 있기 때문에 작업 일정에 따라 새 작업을 만들 시간이지만 이전 작업이 계속 실행 중인 경우 Batch 서비스는 이전 작업이 완료될 때까지 새 작업을 만들지 않습니다. 이전 작업이 새 recurrenceInterval의 startWindow 기간 내에 완료되지 않으면 해당 간격에 대해 새 작업이 예약되지 않습니다. 되풀이 작업의 경우 일반적으로 jobSpecification에서 jobManagerTask를 지정해야 합니다. jobManagerTask를 사용하지 않는 경우 작업을 만들 때 모니터링할 외부 프로세스가 필요하고, 작업에 작업을 추가하고, 다음 되풀이를 위해 준비된 작업을 종료해야 합니다. 기본값은 일정이 되풀이되지 않는다는 것입니다. doNotRunUntil 시간 이후에 startWindow 내에 하나의 작업이 생성되고 해당 작업이 완료되는 즉시 일정이 완료됩니다. 최소값은 1분입니다. 더 낮은 값을 지정하면 Batch 서비스는 오류와 함께 일정을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

startWindow
  • string

일정이 작업을 만들어야 하며 작업을 만들어야 하는 시점부터 시작하는 시간 간격입니다.
startWindow 간격 내에 작업이 만들어지지 않으면 'opportunity'가 손실됩니다. 일정이 다음 되풀이될 때까지 작업이 만들어지지 않습니다. 일정이 되풀이되고 startWindow가 되풀이 간격보다 긴 경우 하나의 recurrenceInterval에서 '기한'인 작업이 다음 되풀이 간격으로 전달되지 않으므로 무한 startWindow와 동일합니다. 기본값은 무한대입니다. 최소값은 1분입니다. 더 낮은 값을 지정하면 Batch 서비스는 오류와 함께 일정을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.

StartTask

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

Name Type 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

StartTask가 실행되는 컨테이너에 대한 설정입니다.
이 옵션을 지정하면 AZ_BATCH_NODE_ROOT_DIR 아래의 모든 디렉터리(노드의 Azure Batch 디렉터리 루트)가 컨테이너에 매핑되고, 모든 작업 환경 변수가 컨테이너에 매핑되고, 작업 명령줄이 컨테이너에서 실행됩니다. AZ_BATCH_NODE_ROOT_DIR 외부 컨테이너에서 생성된 파일은 호스트 디스크에 반영되지 않을 수 있습니다. 즉, Batch 파일 API가 해당 파일에 액세스할 수 없습니다.

environmentSettings

StartTask에 대한 환경 변수 설정 목록입니다.

maxTaskRetryCount
  • integer

태스크가 다시 시도될 수 있는 최대 횟수입니다.
Batch 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도합니다. 이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 작업을 한 번 시도한 다음 이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 재시도 횟수가 3인 경우 Batch는 태스크를 최대 4번(초기 시도 1회, 재시도 3회)으로 시도합니다. 최대 재시도 횟수가 0이면 Batch 서비스에서 작업을 다시 시도하지 않습니다. 최대 재시도 횟수가 -1인 경우 Batch 서비스는 제한 없이 작업을 다시 시도합니다. 그러나 시작 작업이나 작업에는 권장되지 않습니다. 기본값은 0(재시도 없음)입니다.

resourceFiles

명령줄을 실행하기 전에 Batch 서비스가 Compute 노드에 다운로드할 파일 목록입니다. 리소스 파일 목록에 대한 최대 크기가 있습니다. 최대 크기를 초과하면 요청이 실패하고 응답 오류 코드가 RequestEntityTooLarge가 됩니다. 이 경우 ResourceFiles의 컬렉션 크기를 줄여야 합니다. 이 작업은 .zip 파일, 애플리케이션 패키지 또는 Docker 컨테이너를 사용하여 수행할 수 있습니다.
이 요소 아래에 나열된 파일은 Task의 작업 디렉터리에 있습니다.

userIdentity

StartTask가 실행되는 사용자 ID입니다.
생략하면 태스크는 작업에 고유한 비관리 사용자로 실행됩니다.

waitForSuccess
  • boolean

Batch 서비스가 Compute 노드에서 작업을 예약하기 전에 StartTask가 성공적으로 완료될 때까지 대기해야 하는지 여부(즉, 종료 코드 0으로 종료).
True이고 StartTask가 노드에서 실패하는 경우 Batch 서비스는 StartTask를 최대 재시도 횟수(maxTaskRetryCount)까지 다시 시도합니다. 모든 재시도 후에도 작업이 성공적으로 완료되지 않은 경우 Batch 서비스는 노드를 사용할 수 없음으로 표시하고 작업을 예약하지 않습니다. 이 조건은 컴퓨팅 노드 상태 및 오류 정보 세부 정보를 통해 검색할 수 있습니다. false이면 Batch 서비스는 StartTask가 완료될 때까지 기다리지 않습니다. 이 경우 StartTask가 계속 실행되는 동안 다른 태스크가 컴퓨팅 노드에서 실행을 시작할 수 있습니다. StartTask가 실패하더라도 새 작업은 컴퓨팅 노드에서 계속 예약됩니다. 기본값은 true입니다.

StorageAccountType

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

Name Type Description
premium_lrs
  • string

데이터 디스크는 프리미엄 로컬 중복 스토리지를 사용해야 합니다.

standard_lrs
  • string

데이터 디스크는 표준 로컬 중복 스토리지를 사용해야 합니다.

TaskConstraints

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

Name Type 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 Type Description
containerRunOptions
  • string

컨테이너 만들기 명령에 대한 추가 옵션입니다.
이러한 추가 옵션은 Batch 서비스에서 제어하는 옵션 외에도 "docker create" 명령에 대한 인수로 제공됩니다.

imageName
  • string

태스크가 실행될 컨테이너를 만드는 데 사용할 이미지입니다.
"docker pull"에 지정된 것처럼 전체 이미지 참조입니다. 이미지 이름의 일부로 태그가 제공되지 않으면 ":latest" 태그가 기본값으로 사용됩니다.

registry

컨테이너 이미지를 포함하는 프라이빗 레지스트리입니다.
풀을 만들 때 이미 제공된 경우 이 설정을 생략할 수 있습니다.

workingDirectory

컨테이너 작업 디렉터리의 위치입니다.
기본값은 'taskWorkingDirectory'입니다.

TaskSchedulingPolicy

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

Name Type Description
nodeFillType

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

UserAccount

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

Name Type Description
elevationLevel

사용자 계정의 권한 상승 수준입니다.
기본값은 nonAdmin입니다.

linuxUserConfiguration

사용자 계정에 대한 Linux 관련 사용자 구성입니다.
이 속성은 Windows 풀에 지정된 경우 무시됩니다. 지정하지 않으면 기본 옵션을 사용하여 사용자를 만듭니다.

name
  • string

사용자 계정의 이름입니다.

password
  • string

사용자 계정의 암호입니다.

windowsUserConfiguration

사용자 계정에 대한 Windows 특정 사용자 구성입니다.
이 속성은 사용자가 Windows 풀에 있는 경우에만 지정할 수 있습니다. 지정하지 않은 경우 Windows 풀에서 기본 옵션을 사용하여 사용자를 만듭니다.

UserIdentity

태스크가 실행되는 사용자 ID의 정의입니다.

Name Type Description
autoUser

작업이 실행되는 자동 사용자입니다.
userName 및 autoUser 속성은 함께 사용할 수 없습니다. 둘 다 지정해야 하지만 둘 다 지정하지 않아야 합니다.

username
  • string

태스크가 실행되는 사용자 ID의 이름입니다.
userName 및 autoUser 속성은 함께 사용할 수 없습니다. 둘 다 지정해야 하지만 둘 다 지정하지 않아야 합니다.

VirtualMachineConfiguration

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

Name Type Description
containerConfiguration

풀에 대한 컨테이너 구성입니다.
지정된 경우 태스크가 컨테이너에서 실행되도록 풀의 각 컴퓨팅 노드에서 설치가 수행됩니다. 이 풀에서 실행되는 모든 일반 작업 및 작업 관리자 작업은 containerSettings 속성을 지정해야 하며, 다른 모든 작업에서 지정할 수 있습니다.

dataDisks

풀의 컴퓨팅 노드에 연결된 데이터 디스크에 대한 구성입니다.
풀의 컴퓨팅 노드에 빈 데이터 디스크가 연결되어 있어야 하는 경우 이 속성을 지정해야 합니다. 업데이트할 수 없습니다. 각 컴퓨팅 노드는 자체 디스크를 가져옵니다(디스크는 파일 공유가 아님). 기존 디스크는 연결할 수 없으며 연결된 각 디스크는 비어 있습니다. 컴퓨팅 노드가 풀에서 제거되면 디스크와 연결된 모든 데이터도 삭제됩니다. 디스크는 연결 후 포맷되지 않으며 사용하기 전에 포맷해야 합니다. 자세한 내용은 다음을 참조하세요 https://docs.microsoft.com/en-us/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linuxhttps://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

풀에 대한 디스크 암호화 구성입니다.
지정된 경우 노드 프로비전 중에 풀의 각 노드에서 암호화가 수행됩니다.

extensions

풀에 대한 가상 머신 확장입니다.
지정된 경우 이 구성에 언급된 확장이 각 노드에 설치됩니다.

imageReference

사용할 Azure Virtual Machines Marketplace 이미지 또는 사용자 지정 Virtual Machine 이미지에 대한 참조입니다.

licenseType
  • string

운영 체제를 배포할 때 사용할 온-프레미스 라이선스의 유형입니다.
이는 Windows 운영 체제를 포함하는 이미지에만 적용되며 배포될 컴퓨팅 노드에 대한 유효한 온-프레미스 라이선스를 보유하는 경우에만 사용해야 합니다. 생략하면 온-프레미스 라이선스 할인이 적용되지 않습니다. 값은 다음과 같습니다.

Windows_Server - 온-프레미스 라이선스는 Windows Server용입니다. Windows_Client - 온-프레미스 라이선스는 Windows 클라이언트용입니다.

nodeAgentSKUId
  • string

풀의 컴퓨팅 노드에 프로비전할 Batch 컴퓨팅 노드 에이전트의 SKU입니다.
Batch Compute 노드 에이전트는 풀의 각 컴퓨팅 노드에서 실행되며 컴퓨팅 노드와 Batch 서비스 간의 명령 및 제어 인터페이스를 제공하는 프로그램입니다. 여러 운영 체제에 대해 SKU라고 하는 컴퓨팅 노드 에이전트의 구현이 서로 다릅니다. 선택한 이미지 참조와 일치하는 Compute Node 에이전트 SKU를 지정해야 합니다. 확인된 이미지 참조 목록과 함께 지원되는 Compute Node 에이전트 SKU 목록을 얻으려면 '지원되는 컴퓨팅 노드 에이전트 SKU 나열' 작업을 참조하세요.

nodePlacementConfiguration

풀에 대한 노드 배치 구성입니다.
이 구성은 풀의 노드를 물리적으로 할당하는 방법에 대한 규칙을 지정합니다.

osDisk

Virtual Machine의 운영 체제 디스크에 대한 설정.

windowsConfiguration

가상 머신에서 운영 체제 설정을 Windows.
imageReference 속성이 Linux OS 이미지를 지정하는 경우 이 속성을 지정해서는 안 됩니다.

VMExtension

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

Name Type Description
autoUpgradeMinorVersion
  • boolean

배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.

name
  • string

가상 머신 확장의 이름입니다.

protectedSettings
  • object

확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 있습니다.

provisionAfterExtensions
  • string[]

확장 이름의 컬렉션입니다.
이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.

publisher
  • string

확장 처리기 게시자의 이름입니다.

settings
  • object

확장에 대한 JSON 형식의 공용 설정입니다.

type
  • string

확장의 형식입니다.

typeHandlerVersion
  • string

스크립트 처리기의 버전입니다.

WindowsConfiguration

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

Name Type Description
enableAutomaticUpdates
  • boolean

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

WindowsUserConfiguration

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

Name Type Description
loginMode

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