다음을 통해 공유

배치 서비스 REST API 버전 관리

배치 서비스 REST API가 제공하는 작업은 API가 시간이 지남에 따라 진화함에 따라 하위 호환성을 위해 여러 버전을 가질 수 있습니다. 호출 시 REST 호출에 해당 버전을 제공함으로써 사용할 연산의 버전을 지정해야 합니다. 애플리케이션이 구버전 연산을 호출하면, 이전 버전을 계속 호출하거나 코드를 수정해 최신 버전을 호출할 수 있습니다. 버전이 명시되지 않거나 잘못된 버전이 지정되면 오류가 반환됩니다.

어떤 버전의 연산을 사용할지 지정하려면 api-version 쿼리 매개변수를 설정하세요. 이 버전은 Group.Major.Minor라는 형식으로, 그룹이 이 형식 YYYY-MM-DD 이고 Major는 정수, Minor는 정수입니다.

최신 버전: 2025-06-01

이전 버전

이전 버전들은 다음과 같습니다:

버전: 2024-07-01.20.0

  • 컴퓨트 노드 해제 및 시작 연산 추가:
    • 유휴 또는 실행 중인 컴퓨트 노드를 할당 해제하는 새로운 ComputeNode_Deallocate 연산(POST /pools/{poolId}/nodes/{nodeId}/deallocate)을 추가했습니다.
    • 이전에 할당된 컴퓨트 노드를 재시작하기 위한 새로운 ComputeNode_Start 연산(POST /pools/{poolId}/nodes/{nodeId}/start)을 추가했습니다.
    • 딜로배션 중 작업 실행 방식을 명시하는 속성이 nodeDeallocateOption 있는 새로운 NodeDeallocateParameter 모델을 추가했습니다.
  • [브레이크 소리] 제거된 연산(ComputeNode_GetRemoteDesktopGET /pools/{poolId}/nodes/{nodeId}/rdp). 이 작업은 클라우드 서비스 구성 풀에만 적용되었습니다.
  • [브레이크 소리] 클라우드 서비스 구성 풀 지원 제거:
    • 모델 제거 CloudServiceConfiguration .
    • 에서 CloudPoolPoolAddParameter제거 cloudServiceConfiguration 된 속성 , , .PoolSpecification
  • [브레이크 소리] 에서 CloudPoolPoolAddParameter제거 applicationLicenses 된 속성 , , .PoolSpecification
  • 작업에 대한 컨테이너 바인드 마운트 지원 추가:
    • 새 모델과 속성 isReadOnly 추가 ContainerHostBatchBindMountEntrysource.
    • 값, SharedStartup, TaskVfsMountsJobPrep와 Applications함께 새로운 ContainerHostDataPath 열거자를 추가했습니다.
    • 에 새 containerHostBatchBindMounts 속성이 추가되었습니다 TaskContainerSettings.
  • 기밀 VM 지원 추가:
    • 새 모델을 추가하고 부동산을 securityEncryptionType 추가 VMDiskSecurityProfile 했습니다.
    • 에 새 securityProfile 속성이 추가되었습니다 ManagedDisk.
    • 에 새로운 값SecurityProfile.securityType으로 추가됨confidentialVM.
  • 에 새로운 값ComputeNodeState으로 더해졌습니다.deallocateddeallocating
  • 에 새로운 필요 및 deallocateddeallocating 속성을 추가했습니다 NodeCounts.
  • 공유 갤러리 및 커뮤니티 갤러리 이미지 참고 지원 추가:
    • 더하고 communityGalleryImageId 속성은 .sharedGalleryImageIdImageReference
  • 작업이 끝난 후 노드가 VNet에 계속 연결되어 있는지 제어하는 속성을 JobNetworkConfiguration 추가 skipWithdrawFromVNet 했습니다.
  • 에 속성을 JobPatchParameter추가했습니다networkConfiguration.
  • 확장 풀 패치 기능: , 그리고 속성이 추가displayNametaskSlotsPerNodevmSizetaskSchedulingPolicyuserAccountsupgradePolicynetworkConfigurationvirtualMachineConfigurationmountConfigurationenableInterNodeCommunication되었습니다.PoolPatchParameterresourceTags 풀 토폴로지에 영향을 주는 속성은 풀이 비어 있을 때만 업데이트할 수 있습니다.
  • 연산을 강제하기 위해 불리언 쿼리 매개변수를 Job_DeleteJob_Terminate, , JobSchedule_TerminateJobSchedule_Delete에 추가 force 했습니다.

버전: 2024-02-01.19.0

  • VM 풀에 대한 OS 업그레이드 정책 지원 추가:
    • 속성 mode, automaticOSUpgradePolicy, 를 rollingUpgradePolicy가진 새 UpgradePolicy 모델을 추가했습니다. 속성 (UpgradeMode)는 mode , automaticmanual, , 를 rolling받아들입니다.
    • 속성 , enableAutomaticOSUpgrade, useRollingUpgradePolicy, osRollingUpgradeDeferral를 가진 disableAutomaticRollback새로운 AutomaticOSUpgradePolicy 모델을 추가했습니다.
    • 속성 , maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercentprioritizeUnhealthyInstancespauseTimeBetweenBatches를 rollbackFailedInstancesOnPolicyBreach포함한 enableCrossZoneUpgrade새로운 RollingUpgradePolicy 모델을 추가했습니다.
    • , , PoolSpecification에 새로운 upgradePolicy 속성을 CloudPoolPoolAddParameter추가했습니다.
  • 에 새로운 값ComputeNodeState으로 추가됨upgradingos.
  • 주 내 upgradingos 노드 수를 보고할 NodeCounts 수 있는 새로운 필수 upgradingOS 속성을 추가했습니다.

버전: 2023-11-01.18.0

  • VM 풀에 대한 신뢰 실행 / 보안 프로필 지원 추가:
    • 속성 encryptionAtHost, securityType, 를 uefiSettings가진 새 SecurityProfile 모델을 추가했습니다.
    • 속성 secureBootEnabledvTpmEnabled과 를 가진 새 UefiSettings 모델을 추가했습니다.
    • 에 새 securityProfile 속성이 추가되었습니다 VirtualMachineConfiguration.
  • 스케일 세트에 대한 서비스 아티팩트 참조 지원 추가:
    • 필수 id 속성(ARM 리소스 ID)이 있는 새 ServiceArtifactReference 모델을 추가했습니다.
    • 이미지 버전을 사용할 latest 때 모든 VM에 동일한 이미지 버전을 스케일 세트로 설정할 수 있는 새로운 serviceArtifactReference 속성을 VirtualMachineConfiguration 추가했습니다.
  • 향상된 OS 디스크 구성:
    • 새 모델을 추가하고 부동산을 storageAccountType 추가 ManagedDisk 했습니다.
    • 에 새로운 속성OSDisk이 추가되었습니다: , diskSizeGBcaching, managedDisk, 그리고 writeAcceleratorEnabled.
  • 에 새로운 값StorageAccountType으로 ()을 추가하여 .StandardSSDLRSstandardssd_lrs
  • CloudPool, PoolAddParameter, PoolSpecification에 새로운 resourceTags 속성을 추가하여 사용자 정의 태그를 백Azure 리소스로 전파할 수 있게 했습니다. poolAllocationMode UserSubscription경우에만 적용됩니다.
  • 컴퓨트 노드의 현재 가상 머신 Scale Set VM의 리소스 ID를 노출하는 새로운 scaleSetVmResourceId 속성을 VirtualMachineInfo 추가했습니다. 배치 계정이 poolAllocationMode . UserSubscription일 때만 정의됩니다.

버전: 2023-05-01.17.0

  • [브레이크 소리] 배치 작업/풀 수명 통계 API를 삭제했습니다: lifetimejobstats 그리고 lifetimepoolstats.
  • 에 불리언 속성을 enableAcceleratedNetworkingNetworkConfiguration추가했습니다.
    • 이 속성은 이 풀이 가속 네트워킹을 활성화해야 하는지 여부를 결정하며, 기본값은 False입니다.
    • 이 기능을 활성화할 수 있는지는 운영체제/VM 인스턴스가 지원되는지와도 관련이 있으며, 이는 AcceleratedNetworking 정책과 일치해야 합니다.
  • 에 불리언 속성을 enableAutomaticUpgradeVMExtension추가했습니다.
    • 이 특성은 연장선의 최신 버전이 있을 경우 자동으로 업그레이드할지 여부를 결정합니다.
  • 의 성질 typeContainerConfiguration은 이제 두 가지 값을 지지합니다: DockerCompatible 와 CriCompatible.

버전: 2022-10-01.16.0

  • 풀이 배치 서비스와 어떻게 통신하는지를 결정하는 새로운 NodeCommunicationMode 속성이 추가되었습니다
  • 풀 통신 모드의 현재 상태를 참조할 수 있는 타입의 NodeCommunicationMode 새로운 currentNodeCommunicationMode 속성을 모델에 CloudPool 추가했습니다.
  • 다음 모델들에 대해 풀의 원하는 노드 통신 모드를 참조하는 타입의 NodeCommunicationMode 새로운 targetNodeCommunicationMode 속성을 추가했습니다:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

버전: 2022-01-01.15.0

  • 사용자가 리소스 파일 업로드에 대해 사용자 지정 HTTP 헤더를 설정할 수 있도록 모델에 OutputFileBlobContainerDestination 새로운 uploadHeaders 속성을 추가했습니다.
  • 다음 모델에 새로운 allowTaskPreemption 속성이 추가되어 우선순위가 높은 작업에 대한 작업 선점 기능을 지원했습니다(Comms-Enabled 또는 단일 테넌트 풀 필요):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

버전: 2021-06-01.14.0

  • 사용자 할당 관리 신원 CloudPool을 할당할 수 있는 기능을 추가합니다. 이 아이덴티티는 풀 내 각 노드에 제공되며, 다양한 자원에 접근할 수 있습니다.
  • 관리된 신원을 통한 자원 접근을 지원하기 위해 다음 모델에 속성이 추가 identityReference 되었습니다:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • 노드에 대한 가상 머신 확장 기능을 지정하는 VirtualMachineConfiguration 설정 CloudPool 에 새로운 extensions 속성을 추가했습니다
  • VirtualMachineConfiguration에서 새로운 속성을 nodePlacementConfiguration 사용하여 가용성 존을 지정할 수 있는 기능을 추가했습니다
  • 가상 머신의 운영 체제 디스크 설정을 포함하는 VirtualMachineConfiguration에 새로운 osDisk 속성을 추가했습니다.
    • 의 DiffDiskSettings 속성은 placement 풀 내 모든 VM의 운영체제 디스크에 대한 임시 디스크 배치를 지정합니다. 임시 OS 디스크를 VM 캐시에 저장하기 위해 "CacheDisk"로 설정했습니다.
  • 작업당 동시에 실행할 수 있는 최대 작업 수를 제어하는 속성을 CloudJob 추가 maxParallelTasks 했습니다(기본값은 -1, 즉 무제한). 이 부동산은 현재 비공개 미리보기 중입니다.
  • 추가 virtualMachineInfo 된 속성 ComputeNode 에는 가상 머신의 현재 상태에 대한 정보, 즉 VM이 사용하는 마켓플레이스 이미지의 정확한 버전이 포함되어 있습니다.
  • 작업 일정 하에서 두 작업 시작 시간 간격을 제어하는 속성을 Schedule 추가 recurrenceInterval 했습니다.

버전: 2020-09-01.12.0

  • [브레이크 소리] 수영장 부지 maxTasksPerNode 로 부동산을 taskSlotsPerNode 교체했습니다. 이 특성 작업을 사용하면 작업에서 동적 슬롯 수를 소모할 수 있어 자원 소비에 대한 세밀한 제어가 가능합니다.
  • [브레이크 소리] 응답 유형을 GetTaskCounts 반환(return TaskCountsResult)으로 변경했는데, 이는 이전 TaskCounts 객체와 사용 중인 슬롯 맥락에서 유사한 정보를 제공하는 새로운 TaskSlotCounts 객체를 포함하는 복합 객체입니다.
  • 사용자가 노드에서 차지할 슬롯 수를 지정할 수 있는 속성 requiredSlots 이 추가되었습니다.

버전: 2020-03-01.11.0

  • ComputeNode 디스크 드라이브 DiskEncryptionConfiguration 를 암호화할 수 있는 새로운 속성 VirtualMachineConfiguration.
  • [브레이크 소리] ImageReference의 virtualMachineImageId 속성은 이제 Shared Image Gallery 이미지만 참조할 수 있습니다.
  • [브레이크 소리] 요청 동작 본문의 Add Certificate 속성은 password PFX 형식 인증서에 대해 선택 사항입니다.
  • [브레이크 소리] 이제 새로운 PublicIPAddressConfiguration 속성 NetworkConfiguration인 .
  • [브레이크 소리] 부동산도 publicIPsNetworkConfiguration 이름이 변경 ipAddressIds 되어 이사했습니다.PublicIPAddressConfiguration 이 속성은 속성이 필요할 usermanaged때 provision 만 명시할 수 있다.

버전: 2019-08-01.10.0

  • 풀의 새 publicIPs 속성을 통해 공 NetworkConfiguration 인 IP 집합을 지정할 수 있는 기능이 추가되었습니다. 이렇게 하면 풀 내 노드들이 사용자가 제공한 IP의 IP를 갖게 됩니다.
  • 속성을 통해 MountConfiguration 풀의 각 노드에 원격 파일 시스템을 마운트할 수 있는 기능이 추가되었습니다.
  • Shared Image Gallery 이미지는 이제 ImageReference의 virtualMachineImageId 속성에 따라 Azure Resource Manager ID를 통해 이미지를 참조하여 지정할 수 있습니다.
  • [브레이크 소리] 명시하지 않은 경우, 의 기본값 waitForSuccess 은 (true이전에는 그랬습니다false).StartTask
  • [브레이크 소리] 명시되지 않은 경우, AutoUserSpecification에서 scope의 기본 값은 이제 항상 Pool가 됩니다(이전에는 Windows 노드에서는 Task, 리눅스 노드에서는 Pool였습니다).
  • 혼란스럽거나 불완전한 여러 문서들을 개선했습니다.

버전: 2019-06-01.9.0

  • [브레이크 소리] .로 ListSupportedImages대체됨.ListNodeAgentSKUs ListSupportedImages 원래 제공된 ListNodeAgentSKUs 모든 정보를 더 명확한 형식으로 포함하고 있습니다. 새로운 검증되지 않은 이미지도 이제 반환됩니다. 추가 정보는 Capabilities 를 BatchSupportEndOfLife 통해 ImageInformation접근 가능합니다.

  • 이제 트래픽의 소스 포트를 기반으로 네트워크 접근 CloudPool 을 차단하는 네트워크 보안 규칙을 지원합니다. 이 규칙은 에 대한 NetworkSecurityGroupRule속성을 통해 SourcePortRanges 수행됩니다.

  • 컨테이너를 실행할 때 Batch는 이제 컨테이너 작업 디렉터리 또는 Batch 작업 디렉터리에서 태스크 실행을 지원합니다. 이는 .WorkingDirectory의 속성에 TaskContainerSettings 의해 제어됩니다.

  • 혼란스럽거나 불완전한 여러 문서들을 개선했습니다.

버전: 2018-12-01.8.0

  • [브레이크 소리] on cloudServiceConfiguration pools 지원 upgradeos 제거.

    • upgradeos가 제거되었습니다.
    • 이름이 osVersion 변경 targetOSVersion 되고 삭제 currentOSVersionCloudPool됨.
    • 에서 upgrading제거되었습니다PoolState.

  • [브레이크 소리] 삭제되었 dataEgressGiB 고 dataIngressGiB .poolusagemetrics 이 부동산들은 더 이상 지원되지 않습니다.

  • [브레이크 소리]ResourceFile 개선 사항

    • ResourceFile에서 전체 Azure Storage 컨테이너를 지정할 수 있는 기능을 추가했습니다. 현재 ResourceFile에는 세 가지 지원되는 모드가 있습니다:
      • httpUrl 단일 HTTP URL을 가리키는 역할을 생성합니다 ResourceFile .
      • storageContainerUrl는 Azure Blob Storage 컨테이너를 가리키는 ResourceFile를 생성합니다.
      • autoStorageContainerName는 배치 등록된 자동 저장 계정의 Azure Blob Storage 컨테이너를 가리키는 ResourceFile를 생성합니다.
    • 메서드를 통해 httpUrl 제공되는 ResourceFile URL은 이제 어떤 HTTP URL이든 될 수 있습니다. 이전에는 이 URL들이 Azure Blob Storage URL이어야 했습니다.
    • blobPrefix 스토리지 컨테이너에서 다운로드를 접두사와 일치하는 파일만으로 필터링하는 데 사용할 수 있습니다.

  • [브레이크 소리] 에서 제거 osDisk 된 속성 VirtualMachineConfiguration 이 부동산은 더 이상 지원되지 않습니다.

  • NetworkConfiguration에서 dynamicVNetAssignmentScope를 job로 설정한 풀은 이제 각 노드에 Virtual Network을 동적으로 할당할 수 있습니다. 작업s tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'

    비고

    이 기능은 공개 미리 보기로 제공됩니다. 파일럿 참여를 요청한 모든 배치 계정에서는 비활성화되어 있습니다.

  • 작업의 최대 수명은 이제 180일(이전에는 7일)입니다.

  • 특정 로그인 모드(batch 또는 interactive)를 LoginMode를 통해 사용자를 생성할 수 있는 Windows 풀 지원을 추가했습니다.

  • 모든 작업에 대한 기본 작업 유지 시간은 이제 7일로, 이전에는 무한대였습니다.

버전 2018-08-01.7.0

2018-08-01.7.0 버전의 새로운 기능은 다음과 같습니다:

  • ComputeNode의 새로운 NodeAgentInfo 속성을 통해 Azure Batch Node Agent 버전을 확인하세요.
  • 작업의 a FilterResult 를 지정할 수 있는 기능이 추가되었습니다. 자세한 내용은 여기를 참조하세요.
    • 이로 인해 서버 측 쿼리를 수행하라는 자주 요청되는 시나리오가 실패한 모든 작업을 찾아낼 수 있습니다.
  • [브레이크 소리] TaskCounts에서 해당 ValidationStatus 속성을 제거했습니다.
  • [브레이크 소리] DataDisk와 OSDisk의 기본 캐싱 유형은 이제 ReadWriteNone. 대신
  • [브레이크 소리] ContainerType docker 의 유일한 값을 에서 . 로 이름 변경했습니다.dockerCompatible

버전 2018-03-01.6.1

버전 2018-03-01.6.1의 새로운 기능은 다음과 같습니다:

  • 풀 노드 상태별 카운트: 이 버전은 새로운 ListPoolNodeCounts 연산을 통해 풀 노드 카운트를 주별로 쿼리할 수 있는 기능을 추가했습니다. 이 연산을 통해 배치 계정 내 모든 풀에서 노드 상태를 조회할 수 있습니다.
  • Node agent logs: 이 버전은 UploadBatchServiceLogs 작업을 통해 특정 노드에서 Azure Batch 노드 에이전트 로그를 업로드할 수 있는 기능을 추가합니다. 이 로그는 노드에서 문제가 발생할 경우 Microsoft Support가 디버깅에 사용하기 위해 작성되었습니다.

버전 2017-09-01.6.0

  • Azure 하이브리드 사용 혜택: 이제 Azure 하이브리드 사용 혜택 라이선스를 지정한 배치 Windows VM 풀을 생성할 수 있습니다. 이 라이선스가 사용될 경우 VM 가격에 할인이 적용됩니다. VirtualMachineConfiguration에서 새로운 LicenseType 속성을 사용하세요.

  • 풀 VM 데이터 디스크: 가상 머신 구성의 일부인 새로운 데이터 디스크 구성을 사용하여 빈 데이터 디스크 하나 이상을 VM 풀에 연결할 수 있습니다. VirtualMachineConfiguration에서 DataDisks 속성을 사용하세요.

  • (변화 깨기) 커스텀 이미지는 이제 블롭 VHD 파일 대신 Azure Resource Manager 이미지 리소스를 사용해 생성 및 배포됩니다. 배치는 이제 관리 디스크를 사용해 풀 VM을 생성하므로 이미지 자원을 사용합니다. 이제 커스텀 이미지를 사용해 풀 내에서 생성되는 VM 수에 제한이 없습니다; 또한, 대규모 풀을 위한 VHD 블롭 복사본을 여러 개 더 이상 필요하지 않습니다. 따라서 커스텀 이미지 풀은 생성과 확장이 훨씬 쉽습니다. 자세한 내용은 '사용자 지정 이미지 사용으로 가상 머신 풀을 생성하기'를 참조하세요.

    • ImageReference의 새로운 VirtualMachineImageId 속성에는 이미지에 대한 참조가 포함되어 있으며, OSDisk.ImageUris 는 더 이상 존재하지 않습니다.

    • 이 변화로 인해 ImageReference는 이제 VirtualMachineConfiguration의 필수 속성이 되었습니다.

  • (동전 깨는 소리) 멀티 인스턴스 작업(MultiInstanceSettings를 사용해 생성됨)은 이제 CoordinationCommandLine을 지정해야 하며, CountOfInstances 는 선택 사항이며 기본값은 1입니다.

  • Docker 컨테이너를 사용해 실행되는 작업에 대한 추가 지원. Docker 컨테이너를 사용해 작업을 실행하려면, VirtualMachineConfiguration에서 풀에 ContainerConfiguration 을 지정한 후 작업에 TaskContainerSettings를 추가해야 합니다.

버전 2017-06-01.5.1

여기서 설명한 배치 API 버전은 2017-06-01.5.1입니다. 가능한 한 최신 버전을 사용하는 것을 권장합니다.

2017-06-01.5.1 버전의 새로운 기능은 다음과 같습니다:

  • 새로운 작업 수 가져오기 운영을 통한 효율적인 작업 수를 지원합니다. 작업 수 가져오기 연산을 호출하면 활성 중이거나 실행 중이거나 완료된 작업과 성공 또는 실패한 작업의 수를 확인할 수 있습니다. 자세한 내용은 '주별 작업 계산(미리보기)'을 참조하세요.
  • poolCompute node에서 inbound 엔드포인트를 지정하는 지원은 새로운 poolEndpointConfiguration 속성을 통해 이루어졌습니다. 이 속성을 설정하면 노드의 특정 포트를 외부에서 지정할 수 있습니다.

버전 2017-05-01.5.0

다음 섹션들은 버전 2017-05-01.5.0의 새로운 기능과 변경된 기능을 개략적으로 설명합니다.

중요합니다

버전 2017-05-01.5.0에는 여러 가지 획기적인 변경 사항이 포함되어 있습니다. 변경 사항이 발생한 내용을 검토하고 코드를 업데이트하여 버전 2017-05-01.5.0으로 호출하세요.

저우선순위 컴퓨트 노드

Azure Batch는 이제 배치 작업 비용을 줄이기 위해 저우선순위 컴퓨트 노드를 제공합니다. 저우선순위 VM은 경제적인 컴퓨팅 파워를 제공함으로써 새로운 유형의 배치 워크로드를 가능하게 합니다.

저우선순위 노드를 위한 REST API에는 여러 가지 변경 사항이 있습니다:

  • (동전 깨는 소리) 풀이나 풀 명세의 targetDedicated와 currentDedicated 속성은 targetDedicatedNodes와 currentComputeNodes로 이름이 변경되었습니다.
  • (동전 깨는 소리) 풀의 resizeError 속성은 이제 resizeErrors라는 집합체가 되었습니다.
  • 컴퓨트 노드는 새로운 isDedicated 속성을 갖게 되었습니다. 이 속성은 전용 노드에서는 참 이고, 저우선순위 노드에서는 거짓 입니다.
  • 작업 관리자 작업에는 새로운 allowLowPriorityNode 속성이 생겼습니다. 이 속성이 성립한다면, 작업 관리자 작업은 낮은 우선순위 노드에서 실행될 수 있습니다. 만약 false라면, 작업 관리자 작업은 전용 컴퓨트 노드에서 실행됩니다.

리눅스의 이름 있는 사용자

Azure Batch는 이제 Linux 노드에서 이름 있는 사용자 생성에 대한 추가 지원을 제공합니다.

  • 새로운 linuxUserConfiguration 속성은 리눅스 사용자를 생성할 때 uid (사용자 ID)와 gid (그룹 ID)를 지정할 수 있도록 지원합니다.
  • (동전 깨는 소리) sshPrivateKey 속성이 userAccount 속성에서 새로운 linuxUserConfiguration 속성으로 이동되었습니다. linuxUserConfiguration 속성 자체가 userAccount 속성의 속성입니다.

이름 있는 사용자 계정에 대한 자세한 내용은 배치 내 사용자 계정 내 작업 실행을 참조하세요.

작업 데이터용 출력 파일

이제 작업 완료 후 출력 파일을 업로드할 수 있습니다.

  • 새로운 outputFiles 속성은 작업 파일을 Azure Storage에 업로드할 수 있도록 지원합니다.
  • exitConditions 속성의 새로운 fileUploadError 속성은 출력 파일의 업로드 상태를 기반으로 취할 행동을 지정할 수 있도록 지원합니다.

작업 오류 보고

작업 오류 보고를 개선하기 위해 여러 가지 변경이 이루어졌습니다.

  • executeInfo 속성의 새로운 결과 속성은 작업이 성공했는지 실패했는지를 나타냅니다.
  • (동전 깨는 소리) executeInfo 속성의 schedulelingError 속성이 failInfo로 이름이 변경되었습니다. failInfo 속성은 작업 실패가 발생할 때마다 반환됩니다. 여기에는 이전의 모든 스케줄링 오류 사례, 0이 아닌 작업 종료 코드가 반환된 모든 경우, 그리고 파일 업로드 실패가 포함됩니다.
  • (동전 깨는 소리) exitConditions 속성의 schedulingError 속성은 작업이 작업 수명주기 내에서 발생한 시기를 명확히 하기 위해 preProcessingError로 이름이 변경되었습니다.
  • (동전 깨는 소리) schedulelingErrorCateogry 속성이 errorCategory로 이름이 변경되었습니다.

응용 라이선스

이제 풀이나 풀 명세의 새로운 applicationLicenses 속성을 통해 애플리케이션 라이선스를 풀에 프로비저닝할 것을 요청할 수 있습니다.

버전 2017-01-01.4.0

이번 버전 릴리스는 이전 버전인 2016-07-01.3.1의 모든 지원을 확장한 것입니다. 또한 다음과 같은 기능을 지원합니다:

  • 지정된 사용자 신원으로 작업을 실행하세요.

    이제 작업 자원의 new userIdentity 속성을 통해 다음 사용자 식별 중 하나로 작업 또는 작업 컬렉션을 실행할 수 있습니다:

    • 사용자가 정의한 이름이 있는 사용자 계정입니다.

    • 자동으로 생성되는 사용자 계정(autouser)입니다. 오토유저는 관리자 사용자로 실행될 수도 있고, 비관리자 사용자로도 실행될 수 있습니다. 기본적으로 autouser는 비관리자 사용자로 실행됩니다.

      중요합니다

      userIdentity 속성은 elevationLevel 속성을 포함해, 작업이나 작업 집합을 추가하는 요청과 작업 정보 또는 작업 목록을 제공하는 응답에서 runElevated 속성을 대체합니다.

      런 Elevated 속성을 배치 서비스 버전 2017-01-01.4.0에 포함하는 요청을 하면 요청이 실패합니다.

      관리자 사용자로 실행하려면 애플리케이션을 userIdentity 속성을 사용하도록 업데이트하고, elevationLevel 속성을 관리자로 설정하세요.

      비관리자 사용자로 실행하려면, 애플리케이션을 userIdentity 속성을 사용하도록 업데이트하고, elevationLevel 속성을 nonAdmin으로 설정하세요. 이 설정이 기본값이기 때문에 이 설정을 생략할 수도 있습니다.

  • 풀 내 모든 노드에 걸쳐 사용자 계정을 정의하세요.

    이제 풀 리소스에서 정의한 사용자 계정으로 작업 또는 작업 수집을 실행할 수 있습니다. Requests to Add Pool에서 new userAccounts 속성을 통해 사용자 계정을 정의하세요. 계정을 정의할 때 계정 이름, 비밀번호, 권한 수준(관리자 또는 비관리자), 그리고 SSH 개인 키(리눅스 풀용)를 지정할 수 있습니다.

    사용자 계정을 정의한 후, 작업이나 작업 컬렉션을 추가하는 요청에서 userIdentity 속성에 대해 해당 사용자 계정을 지정할 수 있습니다.

  • 작업이 실행될 때 배치 서비스에 인증할 수 있는 토큰을 태스크에 제공합니다.

    배치 서비스는 이제 작업이 실행될 때 인증 토큰을 제공할 수 있습니다. 인증 토큰은 작업 관련 요청을 배치 계정 키 없이도 배치 서비스에 보낼 수 있게 합니다. 토큰은 AZ_BATCH_AUTHENTICATION_TOKEN 환경 변수를 통해 제공됩니다.

    현재 인증 토큰은 작업 자원에 대한 호출 작업에만 지원되고 있습니다. 인증 토큰은 해당 작업이 포함된 작업의 모든 작업에 대한 접근 권한을 부여합니다.

    배치 서비스가 인증 토큰을 제공하려면, 작업 추가(Add Task) 또는 작업 컬렉션 추가(Add Task Collection) 요청에서 새로운 authenticationTokenSettings 속성과 그 접근 속성을 지정하세요.

  • 작업이 실패할 경우 작업의 의존성에 대해 취할 행동을 지정하세요.

    이제 의존하는 작업이 실패하더라도 의존 작업이 진행되도록 지정할 수 있습니다. 작업 자원의 새로운 dependencyAction 속성을 satif(만족 )로 설정하여 부모 작업이 실패하더라도 의존 작업을 실행하도록 설정하세요. 또는 parent task가 실패할 경우 dependence 작업이 실행되지 않도록 dependencyAction 을 차단 하도록 설정하세요.

    작업 추가(Add Task) 또는 작업 컬렉션 추가(Add Task Collection) 요청에서 DependencyAction 속성을 지정하세요.

    의존성 행동 사용에 대한 자세한 내용은 의존성 행동을 참조하세요.

  • 풀을 만들 때 커스텀 OS 디스크 이미지를 사용하세요.

    이제 커스텀 OS 디스크 이미지를 사용해 풀을 만들 수 있습니다.

    이를 위해 배치 계정을 생성할 때 풀이 배치 서비스가 관리하는 구독이 아닌 사용자 구독에 할당되도록 지정해야 합니다. 계정 생성 호출에서 poolAllocationMode 속성을 UserSubscription으로 설정하세요. 그 다음 osDisk 속성을 사용하여 Add Pool 요청에서 디스크 이미지에 대한 참조를 지정하세요.

    중요합니다

    배치 계정을 생성할 때, 사용자 구독에서 풀을 프로비저닝할 것을 지정했다면, 해당 계정을 통해 이루어지는 모든 요청에 대해 Azure Active Directory 기반 인증을 사용해야 합니다.

  • 배치 서비스에 대한 요청에 대해 Azure Active Directory 기반 인증을 사용하세요.

    Azure Active Directory (Azure AD)는 이제 배치 서비스에 대한 호출 인증에 지원됩니다.

    만약 배치 계정이 사용자 구독에서 풀을 프로비저닝하도록 설정되어 있다면, Azure AD 인증이 필요합니다.

버전 2016-07-01.3.1

이번 버전 릴리스는 이전 버전인 2016-02-01.3.0의 모든 지원을 확장합니다. 또한 다음과 같은 기능을 지원합니다:

  • 네트워크 구성으로 풀과 오토풀을 생성할 수 있는 기능

    • 새로운 속성 네트워크: 풀과 오토풀 자원 모두에 구성이 추가되었습니다. 이 속성은 생성된 풀s network configuration, such as the subnet in which the pool의 컴퓨트 노드를 지정하는 데 사용할 수 있습니다.

  • 모든 작업이 완료되면 자동으로 작업을 종료하세요.

    • onAllTasksComplete 라는 새로운 속성이 작업 자원에 추가되었습니다. 작업을 생성하거나 업데이트할 때 이 속성을 지정할 수 있습니다.

  • 작업이 실패하면 자동으로 작업을 종료하거나 비활성화합니다.

    • 작업 자원에 새로운 속성 onTaskFailure가 추가되었고, 작업 자원에는 새로운 속성 exitConditions가 추가되었습니다. onTaskFailure 설정은 작업 실패가 작업 수준에 영향을 미칠 수 있는지 여부를 나타내며, 작업 exitConditions 속성은 작업이 실패의 성격에 맞게 작업 수준 영향을 조정할 수 있게 합니다.

  • 애플리케이션 패키지를 작업 및 풀과 연관시키세요.

    • 새로운 속성인 applicationPackageReferences가 작업 자원과 jobManagerTask 설정에 추가되었습니다. 이 특성은 애플리케이션 패키지를 풀 생성 시점에 지정하지 않고 작업이 요구하는 대로 필요에 따라 배포할 수 있게 합니다. 이 특성은 수명 동안 다양한 작업이나 애플리케이션 버전을 실행해야 하는 장기 저장 풀에 특히 가치가 있습니다.

  • 실패한 작업을 재활성화할 수 있는 능력.

    • 실패한 작업의 상태를 활성화로 초기화하는 새로운 작업 재활성화 작업이 추가되었습니다. 예를 들어, 실패가 일시적이었거나 원인을 수정할 수 있었다면 작업을 다시 창조하지 않고도 실패를 다시 시도할 수 있습니다.

버전 2016-02-01.3.0

이번 버전 릴리스는 이전 버전인 2015-12-01.2.2의 모든 지원을 확장한 것입니다. 또한 다음과 같은 기능을 지원합니다:

  • IaaS VM 구성으로 풀과 오토풀을 생성할 수 있는 기능

    • 기존 속성 osFamily, 는 targetOSVersioncurrentOSVersion 풀 및 오토풀 자원의 최상위 속성에서 이동되어 새로운 속성인 cloudServiceConfiguration.

    • 새로운 부동산 virtualMachineConfiguration 이 풀과 오토풀 자원 모두에 추가됩니다. 이 속성은 IaaS VM과 함께 풀/자동 풀을 구성할 수 있도록 지정할 수 있습니다.

    • 배치 서비스가 지원하는 모든 노드 에이전트 SKU에 대한 정보를 얻기 위한 새로운 API가 추가되었습니다. 지원되는 노드 에이전트 SKU를 참조하세요.

    • IaaS VM 구성으로 생성된 컴퓨트 노드에 원격 로그인할 수 있는 원격 로그인 설정을 얻는 새로운 API가 추가되었습니다. 노드의 원격 로그인 설정을 확인하세요.

    • 새로운 API가 추가되어 작업에 작업 모음을 추가합니다. 작업에 작업 모음 추가를 참조하세요.

    • 사용자 자원에는 Linux 컴퓨팅 노드에서 사용자 추가/업데이트를 위한 새로운 선택적 속성 sshPublicKey 이 추가됩니다.

    • 노드 자원에 두 개의 새로운 속성 totalTasksSucceeded 와 runningTasksCount 가 추가됩니다. 이러한 속성은 '노드에 대한 정보 얻기(Get about a node)' 또는 'List the compute nodes in a pool(풀 내 컴퓨트 노드 목록)'를 통해 얻을 수 있습니다.

    • 복소체 타입에 ResourceFile 새로운 속성 fileMode 이 추가됩니다. 이 속성은 리눅스 컴퓨트 노드에만 적용되며 Windows 컴퓨트 노드에서는 무시됩니다.

    • 복소체 타입에 FileProperties 새로운 속성 fileMode 이 추가됩니다. 이 속성은 리눅스 컴퓨트 노드의 배치 서비스에서 GetFileProperties 또는 ListFileProperties API의 일부로 반환됩니다. 또한, 복잡한 타입 하에 FileProperties 있던 기존 속성 creationTime 은 선택 사항으로 변경되는데, 이는 Linux 컴퓨트 노드에 대해 반환되지 않기 때문입니다.

    • 복합체 타입 내 CertificateReference 기존 속성 visibility 의 데이터 타입은 쉼표 구분된 값의 문자열에서 문자열 집합으로 수정됩니다. 또한 기존 가시성 값 중 하나가 "rdp"에서 "remoteuser"로 이름이 변경되었습니다.

  • 다음 API의 URL은 액션 이름의 "?"를 "/"로 변경했습니다:

    • 풀의 속성을 대체한다

    • 풀에서 자동 스케일링을 비활성화하세요

    • 풀에서 자동 스케일링 활성화

    • 자동 스케일링 공식을 평가합니다

    • 수영장 크기 변경

    • 수영장 크기 변경을 멈추세요

    • 풀 내 컴퓨트 노드의 운영 체제를 업그레이드합니다

    • 풀에서 컴퓨트 노드를 제거하기

    • 노드 재부팅

    • 노드 재이미지

    • 노드에서 작업 스케줄링을 비활성화하세요

    • 노드에서 작업 스케줄링 활성화

    • 작업 일정을 비활성화하세요

    • 작업 일정을 활성화하세요

    • 직무 일정 종료

    • 작업 비활성화

    • 직무 활성화

    • 직무 종료

    • 작업 종료

    • 인증서 삭제 취소

버전 2015-12-01.2.2

이번 버전 릴리스는 이전 버전인 2015-11-01.2.1에서 모든 지원을 확장한 것입니다. 또한 다음과 같은 기능을 지원합니다:

  • 애플리케이션은 이제 리소스 파일 대신 애플리케이션 패키지를 사용하여 컴퓨팅 노드에 배포할 수 있습니다.

    • 클라이언트가 사용 가능한 애플리케이션 및 버전 목록을 탐색할 수 있는 새로운 API가 제공되었으며, 예를 들어 사용자 인터페이스에서 셀렉터를 표시하는 기능이 있습니다.

    • 풀 관련 API는 풀이 해당 풀 내 모든 노드에 다운로드할 애플리케이션 패키지를 지정할 수 있도록 변경됩니다.

  • 이제 작업은 다른 작업에 의존하도록 설정할 수 있습니다. 의존 작업은 해당 작업에 의존하는 모든 작업이 성공적으로 완료될 때까지 시작되지 않습니다.

이번 버전 릴리스에는 다음과 같은 추가 변경 사항이 포함되어 있습니다:

  • 기본 풀 크기 변경 타임아웃이 15분으로 변경되었습니다.

버전 2015-11-01.2.1

이번 버전 릴리스는 이전 버전 2015-06-01.2.0에서 모든 지원을 확장한 것입니다. 또한 다음과 같은 기능을 지원합니다:

  • 다중 인스턴스 작업 추가 및 실행 기능(예: MPI)

    • 새로운 선택 속성이 작업 자원에 추가되며, 이 속성 multiInstanceSettings 은 작업 추가, 작업 가져오기, 작업 목록 API 중 선택적으로 포함할 수 있습니다.

    • 새로운 API 작업의 하위 작업을 나열하여 하위 작업에 대한 정보를 얻습니다.

    • 컴퓨트 노드에 새로운 선택적 속성 subtaskId 이 추가 recentTasks 되었습니다. 이 속성은 Get Compute Node와 List Compute Nodes의 일부로 반환됩니다

  • 컴퓨트 노드에서 작업 스케줄링을 비활성화하거나 활성화할 수 있는 기능

    • 컴퓨트 노드 리소스에 두 가지 새로운 API, 노드에 대한 작업 스케줄링 비활성화와 작업 스케줄링 활성화가 추가되었습니다.

    • 새로운 컴퓨트 노드 상태 offline 가 추가됩니다. 구형 API 버전에서는 이 상태가 에 매핑 unusable됩니다.

    • 컴퓨트 노드 자원에 새로운 속성 schedulingState 이 추가됩니다. 와 disabled에 대한 enabled 가능한 값들.

  • 풀/오토풀에서 자동 -scale 평가 간격을 지정할 수 있는 기능

    • 새로운 부동산 autoScaleEvaluationInterval 이 풀 자원에 추가됩니다. 이 속성은 Pool 추가, 풀 가져오기, 자동 확장 활성화, List 풀 API에 포함될 수 있습니다.

    • 마찬가지로 자동차 풀의 경우, 새로운 부동산 autoScaleEvaluationInterval 이 부동산에 autoPoolSpecification 추가됩니다. 이 속성은 작업 계획 API의 작업 추가, 작업 가져오기, 작업 목록, 작업 일정 추가, 작업 일정 가져오기, 작업 일정 업데이트, 작업 일정 목록, 작업 목록 등 다양한 기능에 포함될 수 있습니다.

  • 작업 API의 향상으로 컴퓨팅 노드에서 작업의 루트 디렉터리를 반환합니다.

    • 두 가지 새로운 속성 taskRootDirectory 이 taskRootDirectoryUrl 추가되었으며, 작업 자원은 작업 정보 얻기, 작업 목록 API의 일부로 얻을 수 있습니다

    • 새로운 속성 taskRootDirectory 이 추가 jobPreparationTaskExecutionInfo 되며, jobReleaseTaskExecutionInfo 이는 작업 API의 작업 준비 및 작업 해제 작업 상태 목록을 통해 얻을 수 있습니다.

  • Last updated on