CloudPool interface

패키지:

@azure/batch

CloudPool을 나타내는 인터페이스입니다.

속성

allocationState	풀의 크기 조정 여부입니다. 가능한 값은 'steady', 'resizing', 'stopping'입니다.
allocationStateTransitionTime	풀이 현재 할당 상태를 입력한 시간입니다.
applicationLicenses	Batch 서비스가 풀의 각 컴퓨팅 노드에서 사용할 수 있도록 하는 애플리케이션 라이선스 목록입니다. 애플리케이션 라이선스 목록은 사용 가능한 Batch 서비스 애플리케이션 라이선스의 하위 집합이어야 합니다. 지원되지 않는 라이선스가 요청되면 풀 만들기가 실패합니다.
applicationPackageReferences	풀의 각 컴퓨팅 노드에 설치할 패키지 목록입니다. 패키지 참조에 대한 변경 내용은 풀에 조인하는 모든 새 노드에 영향을 주지만 다시 부팅하거나 이미지로 다시 설치할 때까지 풀에 이미 있는 컴퓨팅 노드에는 영향을 미치지 않습니다. 지정된 풀에는 최대 10개의 패키지 참조가 있습니다.
autoScaleEvaluationInterval	자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. 이 속성은 풀이 자동으로 크기 조정되는 경우에만 설정됩니다. 즉 enableAutoScale이 true입니다.
autoScaleFormula	풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. 이 속성은 풀이 자동으로 크기 조정되는 경우에만 설정됩니다. 즉 enableAutoScale이 true입니다.
autoScaleRun	자동 크기 조정 수식의 마지막 실행 결과 및 오류입니다. 이 속성은 풀이 자동으로 크기 조정되는 경우에만 설정됩니다. 즉 enableAutoScale이 true입니다.
certificateReferences	풀의 각 컴퓨팅 노드에 설치할 인증서 목록입니다. Windows 노드의 경우 Batch 서비스는 지정된 인증서 저장소 및 위치에 인증서를 설치합니다. Linux 컴퓨팅 노드의 경우 인증서는 작업 작업 디렉터리 내의 디렉터리에 저장되고 AZ_BATCH_CERTIFICATES_DIR 환경 변수는 이 위치를 쿼리하기 위해 태스크에 제공됩니다. 'remoteUser'의 표시 유형이 있는 인증서의 경우 사용자의 홈 디렉터리(예: /home/{user-name}/certs)에 'certs' 디렉터리가 만들어지고 인증서가 해당 디렉터리에 배치됩니다.
cloudServiceConfiguration	풀에 대한 클라우드 서비스 구성입니다. 이 속성과 virtualMachineConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다. Batch 계정이 poolAllocationMode 속성을 'UserSubscription'으로 설정하여 만든 경우 이 속성을 지정할 수 없습니다.
creationTime	풀의 생성 시간입니다.
currentDedicatedNodes	현재 풀에 있는 전용 컴퓨팅 노드 수입니다.
currentLowPriorityNodes	현재 풀에 있는 우선 순위가 낮은 컴퓨팅 노드의 수입니다. 선점된 우선 순위가 낮은 컴퓨팅 노드가 이 수에 포함됩니다.
displayName	풀의 표시 이름입니다. 표시 이름은 고유할 필요가 없으며 최대 길이 1024까지 유니코드 문자를 포함할 수 있습니다.
enableAutoScale	풀 크기가 시간에 따라 자동으로 조정되어야 하는지 여부입니다. false이면 targetDedicateNodes 및 targetLowPriorityNodes 중 하나 이상을 지정해야 합니다. true이면 autoScaleFormula 속성이 필요하며 수식에 따라 풀의 크기가 자동으로 조정됩니다. 기본값은 false입니다.
enableInterNodeCommunication	풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 이렇게 하면 풀에 컴퓨팅 노드를 할당할 수 있는 제한이 적용됩니다. 이 값을 지정하면 요청된 컴퓨팅 노드 수가 풀에 할당될 가능성을 줄일 수 있습니다.
eTag	풀의 ETag입니다. 불투명 문자열입니다. 이를 사용하여 요청 간에 풀이 변경되었는지 여부를 검색할 수 있습니다. 특히 풀을 업데이트할 때 ETag를 전달하여 그 동안 풀을 수정한 사람이 없는 경우에만 변경 내용이 적용되도록 지정할 수 있습니다.
id	계정 내에서 풀을 고유하게 식별하는 문자열입니다. ID는 하이픈과 밑줄을 포함한 영숫자 문자의 조합을 포함할 수 있으며 64자를 초과할 수 없습니다. ID는 대/소문자를 구분하지 않습니다( 즉, 계정 내에 대/소문자만 다른 ID가 두 개 없을 수 있음).
lastModified	풀의 마지막으로 수정된 시간입니다. targetDedicatedNodes 또는 enableAutoscale 설정과 같은 풀 수준 데이터가 마지막으로 변경된 시간입니다. 컴퓨팅 노드 변경 상태와 같은 노드 수준 변경은 고려하지 않습니다.
metadata	풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다.
mountConfiguration	풀의 각 노드에 탑재할 파일 시스템 목록입니다. Azure Files, NFS, CIFS/SMB 및 Blobfuse를 지원합니다.
networkConfiguration	풀에 대한 네트워크 구성입니다.
resizeErrors	풀에서 마지막 크기 조정을 수행하는 동안 발생한 오류 목록입니다. 이 속성은 마지막 풀 크기 조정 중에 하나 이상의 오류가 발생한 경우에만 설정되며 Pool allocationState가 Steady인 경우에만 설정됩니다.
resizeTimeout	풀에 컴퓨팅 노드를 할당하기 위한 시간 제한입니다. 가장 최근의 크기 조정 작업에 대한 시간 제한입니다. (풀을 만들 때의 초기 크기 조정은 크기 조정으로 계산됩니다.) 기본값은 15분입니다.
startTask	풀에 조인할 때 각 컴퓨팅 노드에서 실행되도록 지정된 작업입니다.
state	풀의 현재 상태입니다. 가능한 값은 'active', 'deleting'입니다.
stateTransitionTime	풀이 현재 상태로 진입한 시간입니다.
stats	풀의 전체 수명 동안의 사용률 및 리소스 사용 통계입니다. 이 속성은 CloudPool이 'stats' 특성을 포함한 expand 절로 검색된 경우에만 채워집니다. 그렇지 않으면 null입니다. 통계를 즉시 사용할 수 없습니다. Batch 서비스는 통계의 주기적인 롤업을 수행합니다. 일반적인 지연 시간은 약 30분입니다.
targetDedicatedNodes	풀에서 원하는 전용 컴퓨팅 노드 수입니다.
targetLowPriorityNodes	풀에서 우선 순위가 낮은 컴퓨팅 노드의 원하는 수입니다.
taskSchedulingPolicy	풀의 컴퓨팅 노드에 태스크를 분산하는 방법 지정하지 않으면 기본값이 분산됩니다.
taskSlotsPerNode	풀의 단일 컴퓨팅 노드에서 동시 작업을 실행하는 데 사용할 수 있는 작업 슬롯 수입니다. 기본값은 1입니다. 최대값은 풀의 vmSize 코어 수의 4배 또는 256의 작은 값입니다.
url	풀의 URL입니다.
userAccounts	풀의 각 컴퓨팅 노드에 만들 사용자 계정 목록입니다.
virtualMachineConfiguration	풀에 대한 가상 머신 구성입니다. 이 속성과 cloudServiceConfiguration은 함께 사용할 수 없으며 속성 중 하나를 지정해야 합니다.
vmSize	풀의 가상 머신 크기입니다. 풀의 모든 가상 머신 크기는 동일합니다. 풀에서 사용 가능한 가상 머신 크기에 대한 자세한 내용은 Azure Batch 풀(https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes)에서 컴퓨팅 노드에 대한 VM 크기 선택을 참조하세요.

속성 세부 정보

allocationState

풀의 크기 조정 여부입니다. 가능한 값은 'steady', 'resizing', 'stopping'입니다.

allocationState?: AllocationState

속성 값

AllocationState

allocationStateTransitionTime

풀이 현재 할당 상태를 입력한 시간입니다.

allocationStateTransitionTime?: Date

속성 값

Date

applicationLicenses

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

applicationLicenses?: string[]

속성 값

string[]

applicationPackageReferences

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

applicationPackageReferences?: ApplicationPackageReference[]

속성 값

ApplicationPackageReference[]

autoScaleEvaluationInterval

자동 크기 조정 수식에 따라 풀 크기를 자동으로 조정할 시간 간격입니다. 이 속성은 풀이 자동으로 크기 조정되는 경우에만 설정됩니다. 즉 enableAutoScale이 true입니다.

autoScaleEvaluationInterval?: string

속성 값

string

autoScaleFormula

풀에서 원하는 수의 컴퓨팅 노드 수에 대한 수식입니다. 이 속성은 풀이 자동으로 크기 조정되는 경우에만 설정됩니다. 즉 enableAutoScale이 true입니다.

autoScaleFormula?: string

속성 값

string

autoScaleRun

자동 크기 조정 수식의 마지막 실행 결과 및 오류입니다. 이 속성은 풀이 자동으로 크기 조정되는 경우에만 설정됩니다. 즉 enableAutoScale이 true입니다.

autoScaleRun?: AutoScaleRun

속성 값

AutoScaleRun

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

creationTime

풀의 생성 시간입니다.

creationTime?: Date

속성 값

Date

currentDedicatedNodes

현재 풀에 있는 전용 컴퓨팅 노드 수입니다.

currentDedicatedNodes?: number

속성 값

number

currentLowPriorityNodes

현재 풀에 있는 우선 순위가 낮은 컴퓨팅 노드의 수입니다. 선점된 우선 순위가 낮은 컴퓨팅 노드가 이 수에 포함됩니다.

currentLowPriorityNodes?: number

속성 값

number

displayName

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

displayName?: string

속성 값

string

enableAutoScale

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

enableAutoScale?: boolean

속성 값

boolean

enableInterNodeCommunication

풀이 컴퓨팅 노드 간의 직접 통신을 허용하는지 여부입니다. 이렇게 하면 풀에 컴퓨팅 노드를 할당할 수 있는 제한이 적용됩니다. 이 값을 지정하면 요청된 컴퓨팅 노드 수가 풀에 할당될 가능성을 줄일 수 있습니다.

enableInterNodeCommunication?: boolean

속성 값

boolean

eTag

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

eTag?: string

속성 값

string

id

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

id?: string

속성 값

string

lastModified

풀의 마지막으로 수정된 시간입니다. targetDedicatedNodes 또는 enableAutoscale 설정과 같은 풀 수준 데이터가 마지막으로 변경된 시간입니다. 컴퓨팅 노드 변경 상태와 같은 노드 수준 변경은 고려하지 않습니다.

lastModified?: Date

속성 값

Date

metadata

풀과 메타데이터로 연결된 이름-값 쌍의 목록입니다.

metadata?: MetadataItem[]

속성 값

MetadataItem[]

mountConfiguration

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

mountConfiguration?: MountConfiguration[]

속성 값

MountConfiguration[]

networkConfiguration

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

networkConfiguration?: NetworkConfiguration

속성 값

NetworkConfiguration

resizeErrors

풀에서 마지막 크기 조정을 수행하는 동안 발생한 오류 목록입니다. 이 속성은 마지막 풀 크기 조정 중에 하나 이상의 오류가 발생한 경우에만 설정되며 Pool allocationState가 Steady인 경우에만 설정됩니다.

resizeErrors?: ResizeError[]

속성 값

ResizeError[]

resizeTimeout

풀에 컴퓨팅 노드를 할당하기 위한 시간 제한입니다. 가장 최근의 크기 조정 작업에 대한 시간 제한입니다. (풀을 만들 때의 초기 크기 조정은 크기 조정으로 계산됩니다.) 기본값은 15분입니다.

resizeTimeout?: string

속성 값

string

startTask

풀에 조인할 때 각 컴퓨팅 노드에서 실행되도록 지정된 작업입니다.

startTask?: StartTask

속성 값

StartTask

state

풀의 현재 상태입니다. 가능한 값은 'active', 'deleting'입니다.

state?: PoolState

속성 값

PoolState

stateTransitionTime

풀이 현재 상태로 진입한 시간입니다.

stateTransitionTime?: Date

속성 값

Date

stats

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

stats?: PoolStatistics

속성 값

PoolStatistics

targetDedicatedNodes

풀에서 원하는 전용 컴퓨팅 노드 수입니다.

targetDedicatedNodes?: number

속성 값

number

targetLowPriorityNodes

풀에서 우선 순위가 낮은 컴퓨팅 노드의 원하는 수입니다.

targetLowPriorityNodes?: number

속성 값

number

taskSchedulingPolicy

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

taskSchedulingPolicy?: TaskSchedulingPolicy

속성 값

TaskSchedulingPolicy

taskSlotsPerNode

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

taskSlotsPerNode?: number

속성 값

number

url

풀의 URL입니다.

url?: string

속성 값

string

userAccounts

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

userAccounts?: UserAccount[]

속성 값

UserAccount[]

virtualMachineConfiguration

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

virtualMachineConfiguration?: VirtualMachineConfiguration

속성 값

VirtualMachineConfiguration

vmSize

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

vmSize?: string

속성 값

string