PoolAddParameter interface

패키지:

@azure/batch

PoolAddParameter를 나타내는 인터페이스입니다.

속성

applicationLicenses	Batch 서비스가 풀의 각 컴퓨팅 노드에서 사용할 수 있도록 하는 애플리케이션 라이선스 목록입니다. 애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다.
applicationPackageReferences	풀의 각 컴퓨팅 노드에 설치할 패키지 목록입니다. 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다.
autoScaleEvaluationInterval	자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. 기본값은 15분입니다. 최소값과 최대값은 각각 5분 및 168시간입니다. 5분 미만 또는 168시간보다 큰 값을 지정하면 Batch 서비스가 오류를 반환합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
autoScaleFormula	풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. enableAutoScale이 false로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 true로 설정된 경우 필요합니다. 풀을 만들기 전에 수식이 유효성을 검사합니다. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 'Azure Batch 풀에서 자동으로 컴퓨팅 노드 크기 조정'(https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/)을 참조하세요.
certificateReferences	풀의 각 컴퓨팅 노드에 설치할 인증서 목록입니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.
cloudServiceConfiguration	풀에 대한 클라우드 서비스 구성입니다. 이 속성과 virtualMachineConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다. Batch 계정이 poolAllocationMode 속성을 'UserSubscription'으로 설정하여 만든 경우 이 속성을 지정할 수 없습니다.
displayName	풀의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
enableAutoScale	풀 크기가 시간에 따라 자동으로 조정되어야 하는지 여부입니다. false이면 targetDedicateNodes 및 targetLowPriorityNodes 중 하나 이상을 지정해야 합니다. true이면 autoScaleFormula 속성이 필요하며 수식에 따라 풀의 크기가 자동으로 조정됩니다. 기본값은 false입니다.
enableInterNodeCommunication	풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 노드 간 통신을 사용하도록 설정하면 풀의 컴퓨팅 노드에 대한 배포 제한으로 인해 풀의 최대 크기가 제한됩니다. 이로 인해 풀이 원하는 크기에 도달하지 못할 수 있습니다. 기본값은 false입니다.
id	계정 내에서 풀을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 대/소문자만 다른 계정 내에 풀 ID가 두 개 없을 수 있음).
metadata	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다. Batch 서비스는 메타데이터에 어떤 의미도 할당하지 않습니다. 사용자 코드를 사용하기 위한 것입니다.
mountConfiguration	풀의 전체 수명 동안 지정된 파일 시스템을 사용하여 스토리지를 탑재합니다. Azure 파일 공유, NFS, CIFS 또는 Blobfuse 기반 파일 시스템을 사용하여 스토리지를 탑재합니다.
networkConfiguration	풀에 대한 네트워크 구성입니다.
resizeTimeout	풀에 컴퓨팅 노드를 할당하기 위한 시간 제한입니다. 이 시간 제한은 수동 크기 조정에만 적용됩니다. enableAutoScale이 true로 설정된 경우에는 효과가 없습니다. 기본값은 15분입니다. 최소값은 5분입니다. 5분 미만의 값을 지정하면 Batch 서비스에서 오류가 반환됩니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다.
startTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행되도록 지정된 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다.
targetDedicatedNodes	풀에서 원하는 전용 컴퓨팅 노드 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.
targetLowPriorityNodes	풀에서 우선 순위가 낮은 컴퓨팅 노드의 원하는 수입니다. enableAutoScale이 true로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 false로 설정된 경우 targetDedicatedNodes, targetLowPriorityNodes 또는 둘 다를 설정해야 합니다.
taskSchedulingPolicy	풀의 컴퓨팅 노드에 태스크를 분산하는 방법 지정하지 않으면 기본값이 분산됩니다.
taskSlotsPerNode	풀의 단일 컴퓨팅 노드에서 동시 작업을 실행하는 데 사용할 수 있는 작업 슬롯 수입니다. 기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256의 작은 값입니다.
userAccounts	풀의 각 컴퓨팅 노드에 만들 사용자 계정 목록입니다.
virtualMachineConfiguration	풀에 대한 가상 머신 구성입니다. 이 속성과 cloudServiceConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다.
vmSize	풀의 가상 머신 크기입니다. 풀의 모든 가상 머신 크기는 동일합니다. Cloud Services 풀에 사용 가능한 가상 머신 크기(cloudServiceConfiguration으로 만든 풀)에 대한 자세한 내용은 Cloud Services 크기(https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/)를 참조하세요. Batch는 ExtraSmall, A1V2 및 A2V2를 제외한 모든 Cloud Services VM 크기를 지원합니다. Virtual Machines Marketplace(virtualMachineConfiguration으로 만든 풀)의 이미지를 사용하여 풀에 사용할 수 있는 VM 크기에 대한 자세한 내용은 Virtual Machines 크기(linux)(https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) 또는 Virtual Machines(Windows)의 크기(https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)를 참조하세요. Batch는 STANDARD_A0 및 Premium Storage(STANDARD_GS, STANDARD_DS 및 STANDARD_DSV2 시리즈)를 제외한 모든 Azure VM 크기를 지원합니다.

속성 세부 정보

applicationLicenses

Batch 서비스가 풀의 각 컴퓨팅 노드에서 사용할 수 있도록 하는 애플리케이션 라이선스 목록입니다. 애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다.

applicationLicenses?: string[]

속성 값

string[]

applicationPackageReferences

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

applicationPackageReferences?: ApplicationPackageReference[]

속성 값

ApplicationPackageReference[]

autoScaleEvaluationInterval

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

autoScaleEvaluationInterval?: string

속성 값

string

autoScaleFormula

풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. enableAutoScale이 false로 설정된 경우 이 속성을 지정해서는 안 됩니다. enableAutoScale이 true로 설정된 경우 필요합니다. 풀을 만들기 전에 수식이 유효성을 검사합니다. 수식이 유효하지 않으면 Batch 서비스는 자세한 오류 정보가 포함된 요청을 거부합니다. 이 수식을 지정하는 방법에 대한 자세한 내용은 'Azure Batch 풀에서 자동으로 컴퓨팅 노드 크기 조정'(https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/)을 참조하세요.

autoScaleFormula?: string

속성 값

string

certificateReferences

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

certificateReferences?: CertificateReference[]

속성 값

CertificateReference[]

cloudServiceConfiguration

풀에 대한 클라우드 서비스 구성입니다. 이 속성과 virtualMachineConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다. Batch 계정이 poolAllocationMode 속성을 'UserSubscription'으로 설정하여 만든 경우 이 속성을 지정할 수 없습니다.

cloudServiceConfiguration?: CloudServiceConfiguration

속성 값

CloudServiceConfiguration

displayName

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

displayName?: string

속성 값

string

enableAutoScale

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

enableAutoScale?: boolean

속성 값

boolean

enableInterNodeCommunication

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

enableInterNodeCommunication?: boolean

속성 값

boolean

id

계정 내에서 풀을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 대/소문자만 다른 계정 내에 풀 ID가 두 개 없을 수 있음).

id: string

속성 값

string

metadata

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

metadata?: MetadataItem[]

속성 값

MetadataItem[]

mountConfiguration

풀의 전체 수명 동안 지정된 파일 시스템을 사용하여 스토리지를 탑재합니다. Azure 파일 공유, NFS, CIFS 또는 Blobfuse 기반 파일 시스템을 사용하여 스토리지를 탑재합니다.

mountConfiguration?: MountConfiguration[]

속성 값

MountConfiguration[]

networkConfiguration

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

networkConfiguration?: NetworkConfiguration

속성 값

NetworkConfiguration

resizeTimeout

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

resizeTimeout?: string

속성 값

string

startTask

풀에 조인할 때 각 컴퓨팅 노드에서 실행되도록 지정된 작업입니다. 태스크는 컴퓨팅 노드가 풀에 추가되거나 컴퓨팅 노드가 다시 시작될 때 실행됩니다.

startTask?: StartTask

속성 값

StartTask

targetDedicatedNodes

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

targetDedicatedNodes?: number

속성 값

number

targetLowPriorityNodes

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

targetLowPriorityNodes?: number

속성 값

number

taskSchedulingPolicy

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

taskSchedulingPolicy?: TaskSchedulingPolicy

속성 값

TaskSchedulingPolicy

taskSlotsPerNode

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

taskSlotsPerNode?: number

속성 값

number

userAccounts

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

userAccounts?: UserAccount[]

속성 값

UserAccount[]

virtualMachineConfiguration

풀에 대한 가상 머신 구성입니다. 이 속성과 cloudServiceConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다.

virtualMachineConfiguration?: VirtualMachineConfiguration

속성 값

VirtualMachineConfiguration

vmSize

풀의 가상 머신 크기입니다. 풀의 모든 가상 머신 크기는 동일합니다. Cloud Services 풀에 사용 가능한 가상 머신 크기(cloudServiceConfiguration으로 만든 풀)에 대한 자세한 내용은 Cloud Services 크기(https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/)를 참조하세요. Batch는 ExtraSmall, A1V2 및 A2V2를 제외한 모든 Cloud Services VM 크기를 지원합니다. Virtual Machines Marketplace(virtualMachineConfiguration으로 만든 풀)의 이미지를 사용하여 풀에 사용할 수 있는 VM 크기에 대한 자세한 내용은 Virtual Machines 크기(linux)(https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) 또는 Virtual Machines(Windows)의 크기(https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/)를 참조하세요. Batch는 STANDARD_A0 및 Premium Storage(STANDARD_GS, STANDARD_DS 및 STANDARD_DSV2 시리즈)를 제외한 모든 Azure VM 크기를 지원합니다.

vmSize: string

속성 값

string