Job - Get

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

GET {batchUrl}/jobs/{jobId}?api-version=2020-09-01.12.0
GET {batchUrl}/jobs/{jobId}?$select={$select}&$expand={$expand}&timeout={timeout}&api-version=2020-09-01.12.0

URI 매개 변수

Name In Required Type Description
batchUrl
path True
  • string

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

jobId
path True
  • string

작업의 ID입니다.

api-version
query True
  • string

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

$expand
query
  • string

OData $expand 절입니다.

$select
query
  • string

OData $select 절입니다.

timeout
query
  • integer
int32

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

요청 헤더

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

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

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

return-client-request-id
  • boolean

서버에서 응답의 클라이언트 요청 id를 반환 해야 하는지 여부를 나타냅니다.

ocp-date
  • string
date-time-rfc1123

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

If-Match
  • string

클라이언트에 알려진 리소스의 버전과 연결 된 ETag 값입니다. 서비스의 리소스의 현재 ETag가 클라이언트에서 지정한 값과 정확 하 게 일치 하는 경우에만 작업이 수행 됩니다.

If-None-Match
  • string

클라이언트에 알려진 리소스의 버전과 연결 된 ETag 값입니다. 서비스의 리소스의 현재 ETag가 클라이언트에서 지정한 값과 일치 하지 않는 경우에만 작업이 수행 됩니다.

If-Modified-Since
  • string
date-time-rfc1123

클라이언트에 알려진 리소스의 마지막 수정 시간을 나타내는 타임 스탬프입니다. 지정 된 시간 이후 서비스의 리소스가 수정 된 경우에만 작업이 수행 됩니다.

If-Unmodified-Since
  • string
date-time-rfc1123

클라이언트에 알려진 리소스의 마지막 수정 시간을 나타내는 타임 스탬프입니다. 지정 된 시간 이후 서비스의 리소스가 수정 되지 않은 경우에만 작업이 수행 됩니다.

응답

Name Type Description
200 OK

작업을 포함 하는 응답입니다.

Headers

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

일괄 처리 서비스에서 발생 한 오류입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

Authorization

Type: apiKey
In: header

예제

Job get

Sample Request

GET account.region.batch.azure.com/jobs/jobId?api-version=2020-09-01.12.0
client-request-id: 00000000-0000-0000-0000-000000000000
ocp-date: Fri, 17 Feb 2017 00:00:00 GMT

Sample Response

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

정의

ApplicationPackageReference

계산 노드에 배포할 패키지에 대 한 참조입니다.

AuthenticationTokenSettings

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

AutoPoolSpecification

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

AutoUserScope

자동 사용자의 범위입니다.

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

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

AzureFileShareConfiguration

Azure 파일 공유에 연결 하는 데 사용 되는 정보입니다.

BatchError

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

BatchErrorDetail

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

CachingType

디스크에 대해 사용 하도록 설정할 캐싱 유형입니다.

CertificateReference

풀의 계산 노드에 설치할 인증서에 대 한 참조입니다.

CertificateStoreLocation

인증서를 설치할 계산 노드에 있는 인증서 저장소의 위치입니다.

CIFSMountConfiguration

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

CloudJob

Azure Batch 작업입니다.

CloudServiceConfiguration

Azure Cloud Services 플랫폼을 기반으로 하는 풀의 계산 노드에 대 한 구성입니다.

ComputeNodeFillType

풀의 계산 노드 간에 태스크를 분산 하는 방법입니다.

ContainerConfiguration

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

ContainerRegistry

개인 컨테이너 레지스트리

ContainerType

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

ContainerWorkingDirectory

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

DataDisk

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

DiskEncryptionConfiguration

풀의 계산 노드에 적용 되는 디스크 암호화 구성입니다. 공유 이미지 갤러리 이미지를 사용 하 여 만든 Linux 풀에서는 디스크 암호화 구성이 지원 되지 않습니다.

DynamicVNetAssignmentScope

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

ElevationLevel

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

EnvironmentSetting

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

ErrorCategory

오류의 범주입니다.

ErrorMessage

Azure Batch 오류 응답에서 수신 된 오류 메시지입니다.

ImageReference

Azure Virtual Machines Marketplace 이미지 또는 공유 이미지 갤러리 이미지에 대 한 참조입니다. Azure Batch에서 확인 한 모든 Azure Marketplace 이미지 참조 목록을 가져오려면 ' 지원 되는 이미지 나열 ' 작업을 참조 하세요.

InboundEndpointProtocol

끝점의 프로토콜입니다.

InboundNATPool

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

IPAddressProvisioningType

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

JobConstraints

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

JobExecutionInformation

Azure Batch 서비스에서 작업을 실행 하는 방법에 대 한 정보를 포함 합니다.

JobManagerTask

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

JobNetworkConfiguration

작업의 네트워크 구성입니다.

JobPreparationTask

지정 된 계산 노드에서 작업의 작업을 수행 하기 전에 실행할 작업 준비 태스크입니다.

JobReleaseTask

작업이 실행 된 모든 계산 노드에서 작업을 완료 하는 데 실행할 작업 릴리스 작업입니다.

JobSchedulingError

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

JobState

작업의 상태입니다.

JobStatistics

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

LinuxUserConfiguration

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

LoginMode

사용자에 대 한 로그인 모드

MetadataItem

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

MountConfiguration

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

NameValuePair

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

NetworkConfiguration

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

NetworkSecurityGroupRule

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

NetworkSecurityGroupRuleAccess

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

NFSMountConfiguration

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

OnAllTasksComplete

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

OnTaskFailure

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

OutputFile

일괄 처리 서비스에서 작업 프로세스 실행을 완료 한 후 Azure Batch 계산 노드에서 다른 위치로 파일을 업로드 하는 사양입니다.

OutputFileBlobContainerDestination

Azure blob 저장소 컨테이너 내에서 파일 업로드 대상을 지정 합니다.

OutputFileDestination

파일이 업로드 되어야 하는 대상입니다.

OutputFileUploadCondition

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

OutputFileUploadOptions

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

PoolEndpointConfiguration

풀에 대 한 끝점 구성입니다.

PoolInformation

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

PoolLifetimeOption

만든 자동 풀의 최소 수명과 일정에 대 한 여러 작업이 풀에 할당 되는 방법입니다.

PoolSpecification

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

PublicIPAddressConfiguration

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

ResourceFile

계산 노드에 다운로드할 단일 파일이 나 여러 파일입니다.

StartTask

노드가 Azure Batch 서비스의 풀을 조인 하거나 계산 노드가 다시 부팅 되거나 이미지로 다시 설치 때 실행 되는 작업입니다.

StorageAccountType

데이터 디스크를 만드는 데 사용 하는 저장소 계정 유형입니다.

TaskConstraints

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

TaskContainerSettings

태스크에 대 한 컨테이너 설정입니다.

TaskSchedulingPolicy

계산 노드 간에 작업을 분산 하는 방법을 지정 합니다.

UserAccount

Azure Batch Compute 노드에서 태스크를 실행 하는 데 사용 되는 사용자를 만드는 데 사용 되는 속성입니다.

UserIdentity

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

VirtualMachineConfiguration

Azure Virtual Machines 인프라를 기반으로 하는 풀의 계산 노드에 대 한 구성입니다.

WindowsConfiguration

가상 컴퓨터에 적용할 Windows 운영 체제 설정입니다.

WindowsUserConfiguration

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

ApplicationPackageReference

계산 노드에 배포할 패키지에 대 한 참조입니다.

Name Type Description
applicationId
  • string

배포할 응용 프로그램의 ID입니다.

version
  • string

배포할 응용 프로그램의 버전입니다. 생략 하면 기본 버전이 배포 됩니다.
풀에서이를 생략 하 고이 응용 프로그램에 대해 기본 버전을 지정 하지 않으면 요청이 실패 하 고 오류 코드 InvalidApplicationPackageReferences 및 HTTP 상태 코드 409이 발생 합니다. 작업에서이 작업을 생략 하 고이 응용 프로그램에 대해 기본 버전을 지정 하지 않은 경우 전처리 오류가 발생 하 여 태스크가 실패 합니다.

AuthenticationTokenSettings

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

Name Type Description
access
  • string[]

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

AutoPoolSpecification

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

Name Type Description
autoPoolIdPrefix
  • string

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

keepAlive
  • boolean

수명이 만료 된 후 자동 풀을 활성 상태로 유지할지 여부입니다.
False 이면 poolLifetimeOption 설정에 따라 결정 된 대로 해당 수명이 만료 되 면 Batch 서비스에서 풀을 삭제 하 고, 즉, 작업 또는 작업 일정이 완료 될 때입니다. True 이면 일괄 처리 서비스가 풀을 자동으로 삭제 하지 않습니다. 사용자는이 옵션을 사용 하 여 만든 자동 풀을 삭제 해야 합니다.

pool

자동 풀에 대 한 풀 사양입니다.

poolLifetimeOption

만든 자동 풀의 최소 수명과 일정에 대 한 여러 작업이 풀에 할당 되는 방법입니다.

AutoUserScope

자동 사용자의 범위입니다.

Name Type Description
pool
  • string

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

task
  • string

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

AutoUserSpecification

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

Name Type Description
elevationLevel

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

scope

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

AzureBlobFileSystemConfiguration

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

Name Type Description
accountKey
  • string

Azure Storage 계정 키입니다.
이 속성은 sasKey와 함께 사용할 수 없으며 하나를 지정 해야 합니다.

accountName
  • string

Azure Storage 계정 이름입니다.

blobfuseOptions
  • string

Mount 명령에 전달할 추가 명령줄 옵션입니다.
이러한 옵션은 Windows의 ' net use ' 옵션 및 Linux의 ' 탑재 ' 옵션입니다.

containerName
  • string

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

relativeMountPath
  • string

파일 시스템이 탑재 될 계산 노드의 상대 경로입니다.
모든 파일 시스템은 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있는 Batch 탑재 디렉터리에 대해 탑재 됩니다.

sasKey
  • string

Azure Storage SAS 토큰입니다.
이 속성은 accountKey와 함께 사용할 수 없으며 하나를 지정 해야 합니다.

AzureFileShareConfiguration

Azure 파일 공유에 연결 하는 데 사용 되는 정보입니다.

Name Type Description
accountKey
  • string

Azure Storage 계정 키입니다.

accountName
  • string

Azure Storage 계정 이름입니다.

azureFileUrl
  • string

Azure Files URL입니다.
' Https://{account}. w i n. w o w s. w o w s.

mountOptions
  • string

Mount 명령에 전달할 추가 명령줄 옵션입니다.
이러한 옵션은 Windows의 ' net use ' 옵션 및 Linux의 ' 탑재 ' 옵션입니다.

relativeMountPath
  • string

파일 시스템이 탑재 될 계산 노드의 상대 경로입니다.
모든 파일 시스템은 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있는 Batch 탑재 디렉터리에 대해 탑재 됩니다.

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)에 ' 인증서 ' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치 됩니다.

storeName
  • string

인증서를 설치할 계산 노드에 있는 인증서 저장소의 이름입니다.
이 속성은 Windows 계산 노드 (즉, cloudServiceConfiguration를 사용 하 여 만든 또는 Windows 이미지 참조를 사용 하 여 virtualMachineConfiguration)로 구성 된 풀에만 적용할 수 있습니다. 공용 저장소 이름에는 다음이 포함 됩니다. My, Root, CA, Trust, 허용 안 함, 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

Mount 명령에 전달할 추가 명령줄 옵션입니다.
이러한 옵션은 Windows의 ' net use ' 옵션 및 Linux의 ' 탑재 ' 옵션입니다.

password
  • string

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

relativeMountPath
  • string

파일 시스템이 탑재 될 계산 노드의 상대 경로입니다.
모든 파일 시스템은 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있는 Batch 탑재 디렉터리에 대해 탑재 됩니다.

source
  • string

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

username
  • string

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

CloudJob

Azure Batch 작업입니다.

Name Type Description
commonEnvironmentSettings

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

constraints

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

creationTime
  • string

작업을 만든 시간입니다.

displayName
  • string

작업의 표시 이름입니다.

eTag
  • string

작업의 ETag입니다.
불투명 문자열입니다. 이를 사용 하 여 요청 간에 작업이 변경 되었는지 여부를 검색할 수 있습니다. 특히 작업을 업데이트할 때 ETag를 전달 하 여 다른 사람이 작업을 수정한 경우에만 변경 내용이 적용 되도록 지정할 수 있습니다.

executionInfo

작업에 대 한 실행 정보입니다.

id
  • string

계정 내에서 작업을 고유 하 게 식별 하는 문자열입니다.
ID는 대/소문자를 유지 하 고 대/소문자를 구분 하지 않습니다. 즉, 계정에는 대/소문자만 다른 두 개의 Id가 있을 수 없습니다.

jobManagerTask

작업이 시작 될 때 시작할 작업 관리자 태스크의 세부 정보입니다.
작업 관리자 태스크는 작업을 만들 때 자동으로 시작 됩니다. Batch 서비스는 작업의 다른 작업 이전에 작업 관리자 태스크를 예약 하려고 합니다. 풀을 축소할 때 Batch 서비스는 작업 관리자 태스크가 실행 되는 노드를 가능한 한 오랫동안 보존 하려고 합니다. 즉, ' normal ' 작업을 실행 하는 계산 노드는 작업 관리자 태스크를 실행 하는 계산 노드 전에 제거 됩니다. 작업 관리자 태스크가 실패 하 여 다시 시작 해야 하는 경우 시스템은 가장 높은 우선 순위로 예약 하려고 합니다. 사용 가능한 유휴 계산 노드가 없는 경우 시스템은 풀에서 실행 중인 작업 중 하나를 종료 하 고 작업 관리자 태스크를 다시 시작 하기 위한 공간을 만들기 위해 큐에 반환할 수 있습니다. 한 작업의 작업 관리자 태스크는 다른 작업의 태스크 보다 우선 순위가 없습니다. 작업 간에는 작업 수준 우선 순위만 관찰 됩니다. 예를 들어 우선 순위 0 작업의 작업 관리자를 다시 시작 해야 하는 경우 우선 순위 1 작업의 작업을 다시 시작 하지 않습니다. 일괄 처리는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도 합니다. 복구 작업의 예에는 비정상 노드가 다시 부팅 되거나 호스트 오류로 인해 계산 노드가 사라질 때 (이에 제한 되지 않음)이 포함 됩니다. 복구 작업으로 인 한 재시도는와 독립적 이며 maxTaskRetryCount 계산 되지 않습니다. MaxTaskRetryCount가 0 인 경우에도 복구 작업으로 인 한 내부 재시도는 발생할 수 있습니다. 이로 인해 모든 작업은 idempotent 되어야 합니다. 이는 손상이 나 중복 데이터를 발생 시 키 지 않고 중단 및 다시 시작을 허용 해야 하는 작업을 의미 합니다. 장기 실행 태스크에 대 한 모범 사례는 일종의 검사점을 사용 하는 것입니다.

jobPreparationTask

작업 준비 태스크입니다.
작업 준비 태스크는 작업의 다른 작업 보다 먼저 각 계산 노드에서 실행 되는 특수 작업입니다.

jobReleaseTask

작업 릴리스 작업입니다.
작업 릴리스 태스크는 작업의 다른 작업을 실행 하는 각 계산 노드의 작업 끝에서 실행 되는 특수 작업입니다.

lastModified
  • string

작업을 마지막으로 수정한 시간입니다.
작업 상태 또는 우선 순위와 같은 작업 수준 데이터가 마지막으로 변경 된 시간입니다. 새 작업을 추가 하거나 상태를 변경 하는 등의 작업 수준 변경에는 영향을 주지 않습니다.

metadata

작업에 메타 데이터로 연결 된 이름-값 쌍의 목록입니다.
Batch 서비스는 메타 데이터에 의미를 할당 하지 않습니다. 사용자 코드를 사용 하는 용도로만 사용 됩니다.

networkConfiguration

작업의 네트워크 구성입니다.

onAllTasksComplete

작업의 모든 태스크가 완료 된 상태일 때 Batch 서비스에서 수행할 동작입니다.
기본값은 noaction입니다.

onTaskFailure

작업의 태스크가 실패할 때 Batch 서비스에서 수행할 동작입니다.
에 failureInfo가 있으면 태스크가 실패 한 것으로 간주 됩니다. 작업이 다시 시도 횟수를 초과 하 여 0이 아닌 종료 코드를 사용 하 여 완료 되는 경우 또는 리소스 파일 다운로드 오류 등으로 인해 작업을 시작 하는 동안 오류가 발생 한 경우 failureInfo가 설정 됩니다. 기본값은 noaction입니다.

poolInfo

작업과 연결 된 풀 설정입니다.

previousState

작업의 이전 상태입니다.
작업이 초기 활성 상태인 경우에는이 속성이 설정 되지 않습니다.

previousStateTransitionTime
  • string

작업이 이전 상태로 입력 된 시간입니다.
작업이 초기 활성 상태인 경우에는이 속성이 설정 되지 않습니다.

priority
  • integer

작업의 우선 순위입니다.
우선 순위 값의 범위는 -1000~1000이며 -1000이 가장 낮은 우선 순위이고 1000이 가장 높은 우선 순위입니다. 기본값은 0입니다.

state

작업의 현재 상태입니다.

stateTransitionTime
  • string

작업이 현재 상태로 입력 된 시간입니다.

stats

작업 전체 수명에 대 한 리소스 사용 통계입니다.
이 속성은 CloudJob이 ' stats ' 특성을 포함 하는 expand 절을 사용 하 여 검색 된 경우에만 채워집니다. 그렇지 않으면 null입니다. 통계를 즉시 사용할 수 없는 경우도 있습니다. Batch 서비스는 통계의 주기적인 롤업을 수행 합니다. 일반적인 지연은 약 30 분입니다.

url
  • string

작업의 URL입니다.

usesTaskDependencies
  • boolean

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

CloudServiceConfiguration

Azure Cloud Services 플랫폼을 기반으로 하는 풀의 계산 노드에 대 한 구성입니다.

Name Type Description
osFamily
  • string

풀의 가상 머신에 설치할 Azure 게스트 OS 제품군입니다.
가능한 값은 다음과 같습니다. 2-OS 제품군 2는 Windows Server 2008 R2 s p 1에 해당 합니다. 3-OS 제품군 3-Windows Server 2012에 해당 합니다. 4-OS 제품군 4, Windows Server 2012 r 2와 동일 합니다. 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

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

ContainerConfiguration

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

Name Type Description
containerImageNames
  • string[]

컨테이너 이미지 이름의 컬렉션입니다.
이는 "docker pull"로 지정 된 전체 이미지 참조입니다. 이미지가 대체 레지스트리로 정규화 되지 않은 경우 기본 Docker 레지스트리에서 이미지를 원본으로 지정 합니다.

containerRegistries

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

type

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

ContainerRegistry

개인 컨테이너 레지스트리

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

초기 디스크 크기 (gb)입니다.

lun
  • integer

논리 단위 번호입니다.
Lun은 각 데이터 디스크를 고유 하 게 식별 하는 데 사용 됩니다. 여러 디스크를 연결 하는 경우 각각에 고유한 lun이 있어야 합니다. 값은 0에서 63 (포함) 사이 여야 합니다.

storageAccountType

데이터 디스크에 사용할 저장소 계정 유형입니다.
생략 하는 경우 기본값은 "standard_lrs"입니다.

DiskEncryptionConfiguration

풀의 계산 노드에 적용 되는 디스크 암호화 구성입니다. 공유 이미지 갤러리 이미지를 사용 하 여 만든 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

환경 변수의 값입니다.

ErrorCategory

오류의 범주입니다.

Name Type Description
servererror
  • string

내부 서버 문제로 인해 오류가 발생 했습니다.

usererror
  • string

오류는 잘못 된 구성 등의 사용자 문제로 인 한 것입니다.

ErrorMessage

Azure Batch 오류 응답에서 수신 된 오류 메시지입니다.

Name Type Description
lang
  • string

오류 메시지의 언어 코드입니다.

value
  • string

메시지의 텍스트입니다.

ImageReference

Azure Virtual Machines Marketplace 이미지 또는 공유 이미지 갤러리 이미지에 대 한 참조입니다. Azure Batch에서 확인 한 모든 Azure Marketplace 이미지 참조 목록을 가져오려면 ' 지원 되는 이미지 나열 ' 작업을 참조 하세요.

Name Type Description
offer
  • string

Azure Virtual Machines Marketplace 이미지의 제품 유형입니다.
예: UbuntuServer 또는 WindowsServer.

publisher
  • string

Azure Virtual Machines Marketplace 이미지의 게시자입니다.
예를 들어 정식 또는 MicrosoftWindowsServer입니다.

sku
  • string

Azure Virtual Machines Marketplace 이미지의 SKU입니다.
예: 18.04-LTS 또는 2019-Datacenter.

version
  • string

Azure Virtual Machines Marketplace 이미지의 버전입니다.
최신 버전의 이미지를 선택 하려면 ' 최신 ' 값을 지정할 수 있습니다. 생략 하는 경우 기본값은 ' 최신 '입니다.

virtualMachineImageId
  • string

공유 이미지 갤러리 이미지의 ARM 리소스 식별자입니다. 풀의 계산 노드는이 이미지 Id를 사용 하 여 생성 됩니다. 이는 항상 최신 이미지 버전을 기본값으로/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} 또는/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} 형식입니다.
이 속성은 다른 ImageReference 속성과 함께 사용할 수 없습니다. 공유 이미지 갤러리 이미지는 동일한 지역에 복제본이 있어야 하 고 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

계산 노드의 포트 번호입니다.
일괄 처리 풀 내에서 고유 해야 합니다. 허용 되는 값은 예약 된 값 이므로 22, 3389, 29876 및 29877을 제외 하 고 1에서 65535 사이입니다. 예약 된 값이 제공 되 면 요청이 실패 하 고 HTTP 상태 코드 400가 발생 합니다.

frontendPortRangeEnd
  • integer

개별 계산 노드에 있는 backendPort에 대 한 인바운드 액세스를 제공 하는 데 사용 되는 외부 포트 범위의 마지막 포트 번호입니다.
허용 되는 값의 범위는 65534에서 5만 사이에 있는 포트 55000를 제외 하 고 Batch 서비스에서 예약 된 포트입니다. 풀 내의 모든 범위는 고유 해야 하며 겹칠 수 없습니다. 각 범위에는 최소 40의 포트가 포함 되어야 합니다. 예약 되거나 겹치는 값이 제공 되는 경우 요청이 실패 하 고 HTTP 상태 코드 400가 발생 합니다.

frontendPortRangeStart
  • integer

개별 계산 노드에 있는 backendPort에 대 한 인바운드 액세스를 제공 하는 데 사용 되는 외부 포트 범위의 첫 번째 포트 번호입니다.
허용 되는 값은 5만에서 55000 사이의 포트를 제외한 1에서 65534 사이의 범위입니다. 풀 내의 모든 범위는 고유 해야 하며 겹칠 수 없습니다. 각 범위에는 최소 40의 포트가 포함 되어야 합니다. 예약 되거나 겹치는 값이 제공 되는 경우 요청이 실패 하 고 HTTP 상태 코드 400가 발생 합니다.

name
  • string

엔드포인트의 이름입니다.
이름은 일괄 처리 풀 내에서 고유 해야 하며, 문자, 숫자, 밑줄, 마침표 및 하이픈을 포함할 수 있습니다. 이름은 문자 또는 숫자로 시작 해야 하 고, 문자, 숫자 또는 밑줄로 끝나야 하며, 77 자를 초과할 수 없습니다. 잘못 된 값이 제공 되는 경우 요청이 실패 하 고 HTTP 상태 코드 400이 발생 합니다.

networkSecurityGroupRules

끝점에 적용 되는 네트워크 보안 그룹 규칙의 목록입니다.
일괄 처리 풀의 모든 끝점에서 지정할 수 있는 최대 규칙 수는 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

각 작업을 다시 시도할 수 있는 최대 횟수입니다. 일괄 처리 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도 합니다.
이 값은 구체적으로 재시도 횟수를 제어합니다. Batch 서비스는 각 작업을 한 번 시도 하 고이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 다시 시도 횟수가 3 인 경우 Batch는 최대 4 회 (초기 시도 1 회 및 3 번 재시도) 작업을 시도 합니다. 최대 재시도 횟수가 0 이면 Batch 서비스는 작업을 다시 시도 하지 않습니다. 최대 재시도 횟수가-1 인 경우 Batch 서비스는 제한 없이 작업을 다시 시도 합니다. 기본값은 0(재시도 안 함)입니다.

maxWallClockTime
  • string

작업이 실행 될 수 있는 최대 경과 시간으로, 작업이 생성 된 시간부터 측정 됩니다.
작업이 시간 제한 내에 완료 되지 않으면 Batch 서비스는이를 종료 하 고 아직 실행 중인 작업을 종료 합니다. 이 경우 종료 이유는 MaxWallClockTimeExpiry가 됩니다. 이 속성을 지정 하지 않으면 작업 실행 시간에 대 한 시간 제한이 없습니다.

JobExecutionInformation

Azure Batch 서비스에서 작업을 실행 하는 방법에 대 한 정보를 포함 합니다.

Name Type Description
endTime
  • string

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

poolId
  • string

이 작업이 할당 된 풀의 ID입니다.
이 요소는 작업이 할당 된 실제 풀을 포함 합니다. 서비스에서 작업 세부 정보를 가져오면 작업을 추가 하거나 업데이트할 때의 풀 구성 데이터가 포함 된 poolInfo 요소도 포함 됩니다. PoolInfo 요소에는 poolId 요소가 포함 될 수도 있습니다. 이 경우 두 Id는 동일 합니다. 그렇지 않으면 작업이 자동 풀에서 실행 되 고이 속성에 해당 자동 풀의 ID가 포함 되어 있음을 의미 합니다.

schedulingError

서비스에서 작업을 시작 하는 동안 발생 한 오류에 대 한 세부 정보입니다.
작업을 시작 하는 동안 오류가 발생 하지 않은 경우에는이 속성이 설정 되지 않습니다.

startTime
  • string

작업의 시작 시간입니다.
작업이 생성 된 시간입니다.

terminateReason
  • string

작업이 종료 된 이유를 설명 하는 문자열입니다.
이 속성은 작업이 완료 된 상태인 경우에만 설정 됩니다. Batch 서비스에서 작업을 종료 하는 경우 다음과 같이 이유를 설정 합니다. JMComplete-작업 관리자 태스크가 완료 되었고 killJobOnCompletion가 true로 설정 되었습니다. MaxWallClockTimeExpiry-작업이 maxWallClockTime 제약 조건에 도달 했습니다. TerminateJobSchedule-작업이 일정의 일부로 실행 되 고 일정이 종료 되었습니다. Alltasks 완료-작업의 onAllTasksComplete 특성이 terminatejob으로 설정로 설정 되 고 작업의 모든 작업이 완료 됩니다. TaskFailed-작업의 onTaskFailure 특성이 performExitOptionsJobAction로 설정 되어 있고 작업의 작업이 jobAction의 terminatejob으로 설정를 지정 하는 종료 조건으로 인해 실패 했습니다. 다른 모든 문자열은 ' 작업 종료 ' 작업 호출에 지정 된 사용자 정의 이유입니다.

JobManagerTask

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

Name Type Description
allowLowPriorityNode
  • boolean

작업 관리자 태스크가 우선 순위가 낮은 계산 노드에서 실행 될 수 있는지 여부를 나타냅니다.
기본값은 true입니다.

applicationPackageReferences

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

authenticationTokenSettings

태스크가 일괄 처리 서비스 작업을 수행 하는 데 사용할 수 있는 인증 토큰에 대 한 설정입니다.
이 속성이 설정 되 면 Batch 서비스는 계정 액세스 키를 요구 하지 않고 Batch 서비스 작업을 인증 하는 데 사용할 수 있는 인증 토큰을 작업에 제공 합니다. 토큰은 AZ_BATCH_AUTHENTICATION_TOKEN 환경 변수를 통해 제공 됩니다. 태스크에서 토큰을 사용 하 여 수행할 수 있는 작업은 설정에 따라 달라 집니다. 예를 들어 작업은 작업에 다른 작업을 추가 하거나 작업의 작업 또는 다른 작업의 상태를 확인 하기 위해 작업 권한을 요청할 수 있습니다.

commandLine
  • string

작업 관리자 태스크의 명령줄입니다.
명령줄은 셸에서 실행 되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용 하려는 경우 명령줄에서 셸을 호출 해야 합니다. 예를 들어 Windows의 "cmd/c MyCommand" 또는 Linux의 "/bin/sh-c MyCommand"를 사용 합니다. 명령줄이 파일 경로를 참조 하는 경우에는 작업 (Task) 작업 디렉터리에 상대적인 상대 경로를 사용 하거나 제공 된 일괄 처리 환경 변수 (를 사용 해야 합니다 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 외부의 컨테이너에서 생성 된 파일은 호스트 디스크에 반영 되지 않을 수 있습니다. 즉, 배치 파일 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입니다. 노드에 사용 가능한 사용 가능한 일정 슬롯이 충분 한 경우에만 계산 노드에서 작업을 실행 하도록 예약할 수 있습니다. 다중 인스턴스 작업의 경우 1 이어야 합니다.

resourceFiles

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

runExclusive
  • boolean

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

userIdentity

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

JobNetworkConfiguration

작업의 네트워크 구성입니다.

Name Type Description
subnetId
  • string

작업에서 작업을 실행 하는 노드를 계산 하는 가상 네트워크 서브넷의 ARM 리소스 식별자는 작업 기간에 연결 됩니다. 이는 VirtualMachineConfiguration 풀 에서만 사용할 수 있습니다.
가상 네트워크는 Azure Batch 계정과 동일한 지역 및 구독에 있어야 합니다. 지정 된 서브넷에는 작업에서 작업을 실행 하는 계산 노드 수를 수용할 수 있는 충분 한 사용 가능한 IP 주소가 있어야 합니다. 이는 풀의 계산 노드 수에 따라 가능 합니다. Azure Batch 서비스가 노드에서 작업을 예약할 수 있도록 ' MicrosoftAzureBatch ' 서비스 사용자에 게 지정 된 VNet에 대 한 ' 클래식 가상 컴퓨터 참가자 ' 역할 기반 Access Control (RBAC) 역할이 있어야 합니다. 지정 된 VNet에 연결 된 NSG (네트워크 보안 그룹)가 있는지 확인 하 여이를 확인할 수 있습니다. 지정 된 서브넷의 노드에 대 한 통신을 NSG에서 거부 하는 경우 Batch 서비스는 계산 노드의 상태를 사용할 수 없음으로 설정 합니다. 이것은/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. 형식입니다. 지정 된 VNet에 연결 된 NSG (네트워크 보안 그룹)가 있는 경우 Azure Batch 서비스에서 인바운드 통신에 대해 몇 개의 예약 된 시스템 포트를 사용 하도록 설정 해야 합니다. 가상 컴퓨터 구성을 사용 하 여 만든 풀의 경우 포트 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"를 사용 합니다. 명령줄이 파일 경로를 참조 하는 경우에는 작업 (Task) 작업 디렉터리에 상대적인 상대 경로를 사용 하거나 제공 된 일괄 처리 환경 변수 (를 사용 해야 합니다 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 외부의 컨테이너에서 생성 된 파일은 호스트 디스크에 반영 되지 않을 수 있습니다. 즉, 배치 파일 Api는 이러한 파일에 액세스할 수 없습니다.

environmentSettings

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

id
  • string

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

rerunOnNodeRebootAfterSuccess
  • boolean

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

resourceFiles

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

userIdentity

작업 준비 태스크를 실행 하는 사용자 id입니다.
생략 하는 경우 작업은 Windows 계산 노드의 태스크에 고유한 비관리자 사용자 또는 Linux 계산 노드의 풀에 고유한 비관리자 사용자로 실행 됩니다.

waitForSuccess
  • boolean

계산 노드에서 작업의 다른 작업을 예약 하기 전에 일괄 처리 서비스가 작업 준비 태스크가 완료 될 때까지 기다릴지 여부를 지정 합니다. 종료 코드 0으로 작업 준비 태스크가 종료 되 면 성공적으로 완료 되었습니다.
True로 설정 된 경우 노드에 대해 작업 준비 태스크가 실패 하면 Batch 서비스에서 작업 준비 태스크를 최대 다시 시도 횟수 (constraints 요소에 지정)로 다시 시도 합니다. 다시 시도한 후에도 태스크가 성공적으로 완료 되지 않으면 Batch 서비스는 작업의 작업을 노드로 예약 하지 않습니다. 노드가 활성 상태로 유지 되 고 다른 작업의 태스크를 실행할 수 있습니다. False 이면 일괄 처리 서비스가 작업 준비 작업이 완료 될 때까지 기다리지 않습니다. 이 경우 작업 준비 태스크가 아직 실행 되 고 있는 동안에는 계산 노드에서 작업의 다른 작업 실행을 시작할 수 있습니다. 작업 준비 태스크가 실패 하더라도 새 작업은 계산 노드에서 계속 예약 됩니다. 기본값은 true입니다.

JobReleaseTask

작업이 실행 된 모든 계산 노드에서 작업을 완료 하는 데 실행할 작업 릴리스 작업입니다.

Name Type Description
commandLine
  • string

작업 해제 태스크의 명령줄입니다.
명령줄은 셸에서 실행 되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용 하려는 경우 명령줄에서 셸을 호출 해야 합니다. 예를 들어 Windows의 "cmd/c MyCommand" 또는 Linux의 "/bin/sh-c MyCommand"를 사용 합니다. 명령줄이 파일 경로를 참조 하는 경우에는 작업 (Task) 작업 디렉터리에 상대적인 상대 경로를 사용 하거나 제공 된 일괄 처리 환경 변수 (를 사용 해야 합니다 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 외부의 컨테이너에서 생성 된 파일은 호스트 디스크에 반영 되지 않을 수 있습니다. 즉, 배치 파일 Api는 이러한 파일에 액세스할 수 없습니다.

environmentSettings

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

id
  • string

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

maxWallClockTime
  • string

작업 해제 태스크가 지정 된 계산 노드에서 실행 될 수 있는 최대 경과 시간으로, 작업이 시작 된 시간부터 측정 됩니다. 제한 시간 내에 작업이 완료 되지 않으면 Batch 서비스에서 작업을 종료 합니다. 기본값은 15분입니다. 제한 시간을 15 분 보다 길게 지정 하지 못할 수 있습니다. 이렇게 하면 일괄 처리 서비스에서 오류가 발생 하 여 거부 합니다. REST API를 직접 호출 하는 경우 HTTP 상태 코드는 400 (잘못 된 요청)입니다.

resourceFiles

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

retentionTime
  • string

계산 노드에서 작업 해제 태스크에 대 한 작업 디렉터리를 유지 하는 최소 시간입니다. 이 시간이 지나면 Batch 서비스에서 작업 디렉터리와 해당 내용을 모두 삭제할 수 있습니다.
기본값은 7 일입니다. 즉, 계산 노드를 제거 하거나 작업을 삭제 하지 않는 한 태스크 디렉터리는 7 일 동안 보존 됩니다.

userIdentity

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

JobSchedulingError

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

Name Type Description
category

작업 예약 오류 범주입니다.

code
  • string

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

details

예약 오류와 관련 된 추가 오류 세부 정보 목록입니다.

message
  • string

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

JobState

작업의 상태입니다.

Name Type Description
active
  • string

작업은 예약 된 작업을 수행할 수 있습니다.

completed
  • string

모든 태스크가 종료 되었으며 시스템은 작업에 대 한 추가 변경 또는 추가 작업을 허용 하지 않습니다.

deleting
  • string

사용자가 작업을 삭제 하도록 요청 했지만 삭제 작업이 아직 진행 중입니다. 예를 들어 시스템에서 여전히 작업을 종료 하는 중입니다.

disabled
  • string

사용자가 작업을 사용 하지 않도록 설정 했습니다. 실행 중인 작업이 없으며 새 작업이 예약 되지 않습니다.

disabling
  • string

사용자가 작업을 사용 하지 않도록 설정 했지만 비활성화 작업이 아직 진행 되 고 있습니다 (예: 태스크가 종료 될 때까지 기다리는 중).

enabling
  • string

사용자가 작업을 사용할 수 있도록 요청 했지만 사용 작업이 아직 진행 중입니다.

terminating
  • string

작업 관리자 태스크가 완료 되었거나 사용자가 작업을 종료 했지만 종료 작업이 아직 진행 중입니다. (예를 들어 작업 릴리스 태스크가 실행 되 고 있기 때문에) 작업이 완료 됩니다.

JobStatistics

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

Name Type Description
kernelCPUTime
  • string

작업의 모든 태스크에서 사용 하는 총 커널 모드 CPU 시간 (모든 코어 및 모든 계산 노드에 걸친 합계)입니다.

lastUpdateTime
  • string

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

numFailedTasks
  • integer

지정 된 시간 범위 동안 실패 한 작업의 총 태스크 수입니다.
종료 코드 0을 반환 하지 않고 최대 다시 시도 횟수를 모두 사용 하는 경우 작업이 실패 합니다.

numSucceededTasks
  • integer

지정 된 시간 범위 동안 작업에서 성공적으로 완료 된 총 태스크 수입니다.
종료 코드 0을 반환 하는 경우 작업이 성공적으로 완료 됩니다.

numTaskRetries
  • integer

지정 된 시간 범위 동안 작업의 모든 태스크에 대 한 총 재시도 횟수입니다.

readIOGiB
  • number

GiB의 총 데이터 양은 작업의 모든 태스크에서 디스크를 읽습니다.

readIOps
  • integer

작업의 모든 태스크가 수행한 총 디스크 읽기 작업 수입니다.

startTime
  • string

통계가 적용 되는 시간 범위의 시작 시간입니다.

url
  • string

통계의 URL입니다.

userCPUTime
  • string

작업의 모든 태스크에서 사용 하는 총 사용자 모드 CPU 시간 (모든 코어 및 모든 계산 노드에 걸친 합계)입니다.

waitTime
  • string

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

wallClockTime
  • string

작업에 있는 모든 태스크의 총 벽 시계 시간입니다.
벽 시계 시간은 작업이 완료 될 때 (또는 작업이 완료 되지 않은 경우에는 통계가 마지막으로 업데이트 된 시간)에 대해 계산 노드에서 작업이 실행 되기 시작 하는 경과 시간입니다. 작업을 다시 시도 하는 경우 모든 태스크 다시 시도의 벽 시계 시간이 포함 됩니다.

writeIOGiB
  • number

GiB의 총 데이터 양은 작업의 모든 태스크에 의해 디스크에 기록 됩니다.

writeIOps
  • integer

작업의 모든 태스크가 수행한 총 디스크 쓰기 작업 수입니다.

LinuxUserConfiguration

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

Name Type Description
gid
  • integer

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

sshPrivateKey
  • string

사용자 계정에 대 한 SSH 개인 키입니다.
개인 키는 암호로 보호 되지 않아야 합니다. 개인 키는 풀의 enableInterNodeCommunication 속성이 true 인 경우 Linux 풀의 계산 노드 간에 SSH에 대 한 비대칭 키 기반 인증을 자동으로 구성 하는 데 사용 됩니다 (enableInterNodeCommunication가 false 인 경우 무시 됨). 사용자의. s s s 디렉터리에 키 쌍을 배치 하 여이를 수행 합니다. 지정 하지 않으면 계산 노드 간에 암호 없는 SSH가 구성 되지 않습니다. 사용자의. ssh 디렉터리가 수정 되지 않습니다.

uid
  • integer

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

LoginMode

사용자에 대 한 로그인 모드

Name Type Description
batch
  • string

LOGON32_LOGON_BATCH Win32 로그인 모드입니다. 장기 실행 병렬 프로세스의 경우 batch 로그인 모드를 권장 합니다.

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 퓨즈를 사용 하 여 탑재할 Azure Storage 컨테이너입니다.
이 속성은 다른 모든 속성과 함께 사용할 수 없습니다.

azureFileShareConfiguration

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

cifsMountConfiguration

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

nfsMountConfiguration

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

NameValuePair

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

Name Type Description
name
  • string

이름-값 쌍의 이름입니다.

value
  • string

이름-값 쌍의 값입니다.

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에 대 한 ' 클래식 가상 머신 참가자 ' RBAC (역할 기반 Access Control) 역할이 있어야 합니다. 지정 된 서브넷은 Azure Batch 서비스의 통신이 노드에서 작업을 예약할 수 있도록 허용 해야 합니다. 지정 된 VNet에 연결 된 NSG (네트워크 보안 그룹)가 있는지 확인 하 여이를 확인할 수 있습니다. 지정 된 서브넷의 노드에 대 한 통신을 NSG에서 거부 하는 경우 Batch 서비스는 계산 노드의 상태를 사용할 수 없음으로 설정 합니다. VirtualMachineConfiguration를 사용 하 여 만든 풀의 경우 ARM 가상 네트워크 ('/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

Mount 명령에 전달할 추가 명령줄 옵션입니다.
이러한 옵션은 Windows의 ' net use ' 옵션 및 Linux의 ' 탑재 ' 옵션입니다.

relativeMountPath
  • string

파일 시스템이 탑재 될 계산 노드의 상대 경로입니다.
모든 파일 시스템은 AZ_BATCH_NODE_MOUNTS_DIR 환경 변수를 통해 액세스할 수 있는 Batch 탑재 디렉터리에 대해 탑재 됩니다.

source
  • string

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

OnAllTasksComplete

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

Name Type Description
noaction
  • string

아무 작업도 하지 않습니다. 다른 방법으로 종료 되거나 사용 하지 않도록 설정 된 경우를 제외 하 고 작업은 활성 상태로 유지 됩니다.

terminatejob
  • string

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

OnTaskFailure

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

Name Type Description
noaction
  • string

아무 작업도 하지 않습니다. 다른 방법으로 종료 되거나 사용 하지 않도록 설정 된 경우를 제외 하 고 작업은 활성 상태로 유지 됩니다.

performexitoptionsjobaction
  • string

작업의 exitConditions 컬렉션에서 작업 종료 조건과 연결 된 작업을 수행 합니다. (작업에서 지정 하는 경우에도 작업을 수행할 수 없습니다.)

OutputFile

일괄 처리 서비스에서 작업 프로세스 실행을 완료 한 후 Azure Batch 계산 노드에서 다른 위치로 파일을 업로드 하는 사양입니다.

Name Type Description
destination

출력 파일의 대상입니다.

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

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

OutputFileBlobContainerDestination

Azure blob 저장소 컨테이너 내에서 파일 업로드 대상을 지정 합니다.

Name Type Description
containerUrl
  • string

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

path
  • string

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

OutputFileDestination

파일이 업로드 되어야 하는 대상입니다.

Name Type Description
container

파일이 업로드 되는 Azure blob 저장소의 위치입니다.

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 서비스는 자동 풀의 수명 (keepAlive이 지정 되지 않은 경우 생성 및 삭제)을 관리 합니다. 작업이 활성 상태인 동안 자동 풀의 수명에 영향을 주는 모든 사용자 동작은 예기치 않은 동작을 발생 합니다. 풀 ID 또는 자동 풀 사양 중 하나만 지정 해야 합니다.

poolId
  • string

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

PoolLifetimeOption

만든 자동 풀의 최소 수명과 일정에 대 한 여러 작업이 풀에 할당 되는 방법입니다.

Name Type Description
job
  • string

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

jobschedule
  • string

작업 일정의 수명 동안 풀이 있습니다. 일괄 처리 서비스는 일정에 첫 번째 작업을 만들 때 풀을 만듭니다. 이 옵션은 작업에만 적용 되는 작업 일정에만 적용할 수 있습니다.

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)에 ' 인증서 ' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치 됩니다.

cloudServiceConfiguration

풀에 대 한 클라우드 서비스 구성입니다.
Azure PaaS Vm을 사용 하 여 풀을 만들어야 하는 경우이 속성을 지정 해야 합니다. 이 속성과 virtualMachineConfiguration는 함께 사용할 수 없으며 속성 중 하나를 지정 해야 합니다. 둘 다 지정 하지 않으면 Batch 서비스에서 오류를 반환 합니다. REST API를 직접 호출 하는 경우 HTTP 상태 코드는 400 (잘못 된 요청)입니다. PoolAllocationMode 속성을 ' UserSubscription '로 설정 하 여 Batch 계정을 만든 경우에는이 속성을 지정할 수 없습니다.

displayName
  • string

풀에 대 한 표시 이름입니다.
표시 이름은 고유할 필요가 없으며 최대 길이 1024 까지의 유니코드 문자를 포함할 수 있습니다.

enableAutoScale
  • boolean

풀 크기를 시간에 따라 자동으로 조정 해야 하는지 여부입니다.
False 이면 targetDedicateNodes 및 targetLowPriorityNodes 중 하나 이상을 지정 해야 합니다. True 이면 autoScaleFormula 요소가 필요 합니다. 풀은 수식에 따라 자동으로 크기가 조정 됩니다. 기본값은 false입니다.

enableInterNodeCommunication
  • boolean

풀에서 계산 노드 간의 직접 통신을 허용 하는지 여부입니다.
노드 간 통신을 사용 하도록 설정 하면 풀의 계산 노드에 대 한 배포 제한으로 인해 풀의 최대 크기가 제한 됩니다. 이로 인해 풀이 원하는 크기에 도달 하지 못할 수 있습니다. 기본값은 false입니다.

metadata

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

mountConfiguration

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

networkConfiguration

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

resizeTimeout
  • string

풀에 계산 노드를 할당 하는 시간 제한입니다.
이 제한 시간은 수동 크기 조정에만 적용 됩니다. enableAutoScale 크기 조정이 true로 설정 된 경우에는 영향을 주지 않습니다. 기본값은 15분입니다. 최소 값은 5 분입니다. 5 분 보다 작은 값을 지정 하면 일괄 처리 서비스는 오류와 함께 요청을 거부 합니다. REST API를 직접 호출 하는 경우 HTTP 상태 코드는 400 (잘못 된 요청)입니다.

startTask

풀에 조인 될 때마다 각 계산 노드에서 실행할 작업입니다. 계산 노드가 풀에 추가 되거나 계산 노드가 다시 시작 될 때 태스크가 실행 됩니다.
일괄 처리는 노드에서 복구 작업이 트리거될 때 작업을 다시 시도 합니다. 복구 작업의 예에는 비정상 노드가 다시 부팅 되거나 호스트 오류로 인해 계산 노드가 사라질 때 (이에 제한 되지 않음)이 포함 됩니다. 복구 작업으로 인 한 재시도는와 독립적 이며 maxTaskRetryCount 계산 되지 않습니다. MaxTaskRetryCount가 0 인 경우에도 복구 작업으로 인 한 내부 재시도는 발생할 수 있습니다. 이로 인해 모든 작업은 idempotent 되어야 합니다. 이는 손상이 나 중복 데이터를 발생 시 키 지 않고 중단 및 다시 시작을 허용 해야 하는 작업을 의미 합니다. 장기 실행 태스크에 대 한 모범 사례는 일종의 검사점을 사용 하는 것입니다. 일부 경우에는 계산 노드를 다시 부팅 하지 않은 경우에도 StartTask를 다시 실행할 수 있습니다. Starttasks 작업 디렉터리에서 breakaway 프로세스를 만들거나 서비스를 설치/시작 하는 StartTasks를 방지 하기 위해 특별히 주의를 기울여야 합니다 .이는 일괄 처리에서 Starttasks를 다시 실행할 수 없도록 차단 하기 때문입니다.

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 풀에서 계산 노드에 대 한 VM 크기 선택 (을 참조 하세요 https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes) .

PublicIPAddressConfiguration

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

Name Type Description
ipAddressIds
  • string[]

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

provision

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

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 속성이 지정 된 경우 파일 경로는 필수 이며 파일 이름을 포함 하 여 파일이 다운로드 될 경로를 설명 합니다. 그렇지 않고 autoStorageContainerName 또는 storageContainerUrl 속성이 지정 된 경우 filePath는 선택 사항이 며 파일을 다운로드할 디렉터리입니다. FilePath를 디렉터리로 사용 하는 경우 입력 데이터와 이미 연결 된 모든 디렉터리 구조는 전체에 유지 되 고 지정 된 filePath 디렉터리에 추가 됩니다. 지정 된 상대 경로는 태스크의 작업 디렉터리에서 분리 될 수 없습니다 (예: '.. ' 사용).

httpUrl
  • string

다운로드할 파일의 URL입니다.
AutoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 함께 사용할 수 없으며 둘 중 하나를 지정 해야 합니다. URL이 Azure Blob Storage 가리키는 경우 익명 액세스를 사용 하 여 읽을 수 있어야 합니다. 즉, Batch 서비스는 blob을 다운로드할 때 자격 증명을 제공 하지 않습니다. Azure storage에서 blob에 대 한 URL을 가져오는 두 가지 방법이 있습니다. blob에 대 한 읽기 권한을 부여 하는 SAS (공유 액세스 서명)를 포함 하거나, blob 또는 해당 컨테이너에 대 한 ACL을 설정 하 여 공용 액세스를 허용 합니다.

storageContainerUrl
  • string

Azure Blob Storage 내의 blob 컨테이너 URL입니다.
AutoStorageContainerName, storageContainerUrl 및 httpUrl 속성은 함께 사용할 수 없으며 둘 중 하나를 지정 해야 합니다. 이 URL은 읽기 가능 해야 하며 익명 액세스를 사용 하 여 listable 이어야 합니다. 즉, 컨테이너에서 blob을 다운로드할 때 Batch 서비스는 자격 증명을 제공 하지 않습니다. Azure storage의 컨테이너에 대 한 URL을 가져오는 방법에는 SAS (공유 액세스 서명)를 포함 하 여 컨테이너에 대 한 읽기 및 목록 사용 권한을 부여 하거나, 컨테이너에 대 한 ACL을 설정 하 여 공용 액세스를 허용 하는 두 가지 방법이 있습니다.

StartTask

노드가 Azure Batch 서비스의 풀을 조인 하거나 계산 노드가 다시 부팅 되거나 이미지로 다시 설치 때 실행 되는 작업입니다.

Name Type Description
commandLine
  • string

StartTask의 명령줄입니다.
명령줄은 셸에서 실행 되지 않으므로 환경 변수 확장과 같은 셸 기능을 활용할 수 없습니다. 이러한 기능을 활용 하려는 경우 명령줄에서 셸을 호출 해야 합니다. 예를 들어 Windows의 "cmd/c MyCommand" 또는 Linux의 "/bin/sh-c MyCommand"를 사용 합니다. 명령줄이 파일 경로를 참조 하는 경우에는 작업 (Task) 작업 디렉터리에 상대적인 상대 경로를 사용 하거나 제공 된 일괄 처리 환경 변수 (를 사용 해야 합니다 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 외부의 컨테이너에서 생성 된 파일은 호스트 디스크에 반영 되지 않을 수 있습니다. 즉, 배치 파일 Api는 이러한 파일에 액세스할 수 없습니다.

environmentSettings

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

maxTaskRetryCount
  • integer

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

resourceFiles

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

userIdentity

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

waitForSuccess
  • boolean

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

StorageAccountType

데이터 디스크를 만드는 데 사용 하는 저장소 계정 유형입니다.

Name Type Description
premium_lrs
  • string

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

standard_lrs
  • string

데이터 디스크는 표준 로컬 중복 저장소를 사용 해야 합니다.

TaskConstraints

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

Name Type Description
maxTaskRetryCount
  • integer

태스크를 다시 시도할 수 있는 최대 횟수입니다. 일괄 처리 서비스는 종료 코드가 0이 아닌 경우 작업을 다시 시도 합니다.
이 값은 0이 아닌 종료 코드로 인 한 작업 실행 파일의 다시 시도 횟수를 구체적으로 제어 합니다. Batch 서비스는 작업을 한 번 시도 하 고이 제한까지 다시 시도할 수 있습니다. 예를 들어 최대 다시 시도 횟수가 3 인 경우 Batch는 최대 4 회 (초기 시도 1 회 및 3 회 재시도) 작업을 시도 합니다. 최대 재시도 횟수가 0 이면 일괄 처리 서비스는 첫 번째 시도 후 작업을 다시 시도 하지 않습니다. 최대 재시도 횟수가-1 인 경우 Batch 서비스는 제한 없이 작업을 다시 시도 합니다.

maxWallClockTime
  • string

태스크가 실행 될 수 있는 최대 경과 시간으로, 작업이 시작 된 시간부터 측정 됩니다. 제한 시간 내에 작업이 완료 되지 않으면 Batch 서비스에서 작업을 종료 합니다.
지정 하지 않으면 태스크가 실행 되는 기간에 대 한 시간 제한이 없습니다.

retentionTime
  • string

실행이 완료 된 시간부터 실행 된 계산 노드의 태스크 디렉터리를 유지 하는 최소 시간입니다. 이 시간이 지나면 Batch 서비스에서 작업 디렉터리와 해당 내용을 모두 삭제할 수 있습니다.
기본값은 7 일입니다. 즉, 계산 노드를 제거 하거나 작업을 삭제 하지 않는 한 태스크 디렉터리는 7 일 동안 보존 됩니다.

TaskContainerSettings

태스크에 대 한 컨테이너 설정입니다.

Name Type Description
containerRunOptions
  • string

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

imageName
  • string

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

registry

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

workingDirectory

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

TaskSchedulingPolicy

계산 노드 간에 작업을 분산 하는 방법을 지정 합니다.

Name Type Description
nodeFillType

풀의 계산 노드 간에 태스크를 분산 하는 방법입니다.
지정 하지 않으면 기본값은 스프레드입니다.

UserAccount

Azure Batch Compute 노드에서 태스크를 실행 하는 데 사용 되는 사용자를 만드는 데 사용 되는 속성입니다.

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-linux https://docs.microsoft.com/en-us/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine .

diskEncryptionConfiguration

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

imageReference

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

licenseType
  • string

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

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

nodeAgentSKUId
  • string

풀의 계산 노드에 프로 비전 될 일괄 처리 계산 노드 에이전트의 SKU입니다.
Batch 계산 노드 에이전트는 풀의 각 계산 노드에서 실행 되는 프로그램이 며 계산 노드와 Batch 서비스 간에 명령 및 컨트롤 인터페이스를 제공 합니다. 여러 운영 체제에 대해 Sku 라고 하는 계산 노드 에이전트의 구현이 다릅니다. 선택한 이미지 참조와 일치 하는 계산 노드 에이전트 SKU를 지정 해야 합니다. 지원 되는 계산 노드 에이전트 Sku 목록을 확인 된 이미지 참조 목록과 함께 가져오려면 ' 지원 되는 계산 노드 에이전트 Sku 나열 ' 작업을 참조 하세요.

windowsConfiguration

가상 컴퓨터의 Windows 운영 체제 설정
ImageReference 속성에서 Linux OS 이미지를 지정 하는 경우에는이 속성을 지정 하면 안 됩니다.

WindowsConfiguration

가상 컴퓨터에 적용할 Windows 운영 체제 설정입니다.

Name Type Description
enableAutomaticUpdates
  • boolean

가상 머신에서 자동 업데이트를 사용 하도록 설정할지 여부를 지정 합니다.
생략 하는 경우 기본값은 true입니다.

WindowsUserConfiguration

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

Name Type Description
loginMode

사용자에 대 한 로그인 모드
VirtualMachineConfiguration 풀의 기본값은 ' batch '이 고 CloudServiceConfiguration 풀의 기본값은 ' interactive '입니다.