일괄 처리 서비스 REST API 버전 관리

API는 지속적으로 개선되므로 일괄 처리 서비스 REST API에서 제공하는 작업에는 이전 버전과의 호환성을 위해 여러 버전이 포함될 수 있습니다. REST 호출에서 버전을 제공하여 작업 호출 시 사용하려는 작업 버전을 지정해야 합니다. 응용 프로그램이 이전 버전의 작업을 호출하는 경우 이전 버전을 계속 호출하도록 선택하거나 코드를 수정하여 새 버전을 호출하도록 선택할 수 있습니다. 버전이 지정되지 않았거나 잘못된 버전을 지정하면 오류가 반환됩니다.

사용할 작업의 버전을 지정하려면 api-version 쿼리 매개 변수를 설정합니다. 버전은 Group.Major.Minor 형식이며, 여기서 Group은 'YYYY-MM-DD' 형식이고 Major와 Minor는 정수입니다.

최신 버전: 2023-05-01.17.0

  • [호환성이 손상되는] Batch 작업/풀 수명 통계 API: lifetimejobstatslifetimepoolstats가 제거되었습니다.
  • 에 부울 속성 enableAcceleratedNetworkingNetworkConfiguration추가되었습니다.
    • 이 속성은 이 풀이 기본값을 False로 사용하여 가속화된 네트워킹을 사용하도록 설정해야 하는지 여부를 결정합니다.
    • 이 기능을 사용할 수 있는지 여부는 AcceleratedNetworking 정책에 부합해야 하는 운영 체제/VM instance 지원되는지 여부와도 관련이 있습니다.
  • 에 부울 속성 enableAutomaticUpgradeVMExtension추가되었습니다.
    • 이 속성은 사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 결정합니다.
  • 의 속성 typeContainerConfiguration으로, 이제 및 CriCompatible의 두 값을 DockerCompatible 지원합니다.

이전 버전

이전 버전은 다음과 같습니다.

버전: 2022-10-01.16.0

  • 풀이 Batch 서비스와 통신하는 방법을 결정하는 새 NodeCommunicationMode 속성이 추가됨
  • 풀 통신 모드의 NodeCommunicationMode 현재 상태를 참조하는 형식 CloudPool 의 새 currentNodeCommunicationMode 속성을 모델에 추가했습니다.
  • 풀에 NodeCommunicationMode 대해 원하는 노드 통신 모드를 참조하기 위해 형식의 새 targetNodeCommunicationMode 속성을 다음 모델에 추가했습니다.

버전: 2022-01-01.15.0

버전: 2021-06-01.14.0

  • 사용자 할당 관리 ID를 에 할당하는 CloudPool기능을 추가합니다. 이러한 ID는 풀의 각 노드에서 사용할 수 있으며 다양한 리소스에 액세스하는 데 사용할 수 있습니다.
  • 관리 ID를 통해 리소스에 액세스할 수 있도록 다음 모델에 속성을 추가 identityReference 했습니다.
  • 노드에 대한 가상 머신 확장을 지정하기 위해 VirtualMachineConfigurationCloudPoolextensions 속성이 추가됨
  • VirtualMachineConfiguration에서 새 속성을 nodePlacementConfiguration 사용하여 가용성 영역을 지정하는 기능이 추가되었습니다.
  • VirtualMachineConfiguration에 가상 머신의 운영 체제 디스크에 대한 설정을 포함하는 새 osDisk 속성이 추가되었습니다.
    • DiffDiskSettings 속성은 placement 풀의 모든 VM에 대한 운영 체제 디스크의 임시 디스크 배치를 지정합니다. "CacheDisk"로 설정하면 VM 캐시에 임시 OS 디스크가 저장됩니다.
  • 에 속성을 CloudJob 추가하여 maxParallelTasks 작업당 동시에 실행할 수 있는 최대 작업 수를 제어합니다(기본적으로 -1은 무제한임). 이 속성은 현재 프라이빗 미리 보기로 제공됩니다.
  • VM에서 ComputeNode 사용하는 마켓플레이스 이미지의 정확한 버전을 포함하여 가상 머신의 현재 상태에 대한 정보를 포함하는 속성이 추가 virtualMachineInfo 되었습니다.
  • 작업 일정에 따라 두 연속 작업의 시작 시간 사이의 간격을 제어하기 위해 에 속성을 Schedule 추가 recurrenceInterval 했습니다.

버전: 2020-09-01.12.0

  • [호환성이 손상되는] 풀에서 속성을 maxTasksPerNodetaskSlotsPerNode 대체했습니다. 작업에서 이 속성 작업을 사용하면 동적 수의 슬롯을 사용할 수 있으므로 리소스 소비를 보다 세분화하여 제어할 수 있습니다.
  • [호환성이 손상되는] 이전 TaskCounts 개체를 포함하는 복잡한 개체이고 사용 중인 슬롯의 컨텍스트에서 유사한 정보를 제공하는 새 TaskSlotCounts 개체인 를 반환TaskCountsResult하도록 의 응답 형식 GetTaskCounts 을 변경했습니다.
  • 태스크에 속성 requiredSlots 이 추가되어 사용자가 수행해야 하는 노드의 슬롯 수를 지정할 수 있습니다.

버전: 2020-03-01.11.0

  • VirtualMachineConfigurationDiskEncryptionConfiguration 속성을 사용하여 ComputeNode 디스크 드라이브를 암호화하는 기능이 추가되었습니다.
  • [호환성이 손상되는] 이제 의 ImageReference 속성은 virtualMachineImageId Shared Image Gallery 이미지만 참조할 수 있습니다.
  • [호환성이 손상되는] 작업 요청 본문의 Add Certificate 속성은 password PFX 형식 인증서에 대한 선택 사항입니다.
  • [호환성이 손상되는] 이제 의 새 PublicIPAddressConfiguration 속성을 NetworkConfiguration사용하여 공용 IP 없이 풀을 프로비전할 수 있습니다.
  • [호환성이 손상되는] publicIPsNetworkConfiguration 속성은 로 ipAddressIds 이름이 바뀌었고 로 PublicIPAddressConfiguration 도 이동되었습니다. 이 속성은 속성usermanaged이 인 경우에만 provision 지정할 수 있습니다.

버전: 2019-08-01.10.0

  • 풀의 새 publicIPs 속성을 통해 에서 NetworkConfiguration 공용 IP 컬렉션을 지정하는 기능이 추가되었습니다. 이렇게 하면 풀의 노드에 사용자가 제공한 IP 목록의 IP가 보장됩니다.
  • 속성을 통해 풀의 각 노드에 원격 파일 시스템을 탑재하는 기능이 추가되었습니다 MountConfiguration .
  • 이제 Azure Resource Manager ID를 통해 이미지를 참조하여 의 속성 ImageReferencevirtualMachineImageId Shared Image Gallery 이미지를 지정할 수 있습니다.
  • [호환성이 손상되는] 지정하지 않으면 의 기본값 waitForSuccess 은 입니다 true (이전에는 이었습니다falseStartTask).
  • [호환성이 손상되는] 지정하지 않으면 의 AutoUserSpecification 기본값 scope 은 항상 Pool 입니다(이전에는 Windows 노드 및 Pool Linux 노드에 있음Task).
  • 다양한 혼란스럽거나 불완전한 문서가 개선되었습니다.

버전: 2019-06-01.9.0

  • [호환성이 손상되는] 로 대체되었습니다 ListNodeAgentSKUsListSupportedImages. ListSupportedImages 에는 원래 사용할 수 있었지만 더 명확한 형식의 동일한 정보가 모두 포함되어 있습니다 ListNodeAgentSKUs . 이제 확인되지 않은 새 이미지도 반환됩니다. 및 에 대한 Capabilities 추가 정보는 를 통해 ImageInformation액세스할 수 BatchSupportEndOfLife 있습니다.

  • 이제 트래픽의 원본 포트에 따라 에 대한 네트워크 액세스를 CloudPool 차단하는 네트워크 보안 규칙을 지원합니다. 이 작업은 NetworkSecurityGroupRule에서 SourcePortRanges 속성을 통해 수행됩니다.

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

  • 다양한 혼란스럽거나 불완전한 문서가 개선되었습니다.

버전: 2018-12-01.8.0

  • [호환성이 손상되는] 풀에 대한 upgradeoscloudServiceConfiguration 지원이 제거되었습니다.

    • upgradeos가 제거되었습니다.
    • 의 이름을 로 osVersion 변경 targetOSVersion 하고 에서 CloudPool제거했습니다currentOSVersion.
    • PoolState에서 upgrading이 제거되었습니다.
  • [호환성이 손상되는] 에서 및 dataIngressGiBpoolusagemetrics제거되었습니다dataEgressGiB. 이러한 속성은 더 이상 지원되지 않습니다.

  • [호환성이 손상되는]ResourceFile 개선

    • ResourceFile에서 전체 Azure Storage 컨테이너를 지정하는 기능이 추가되었습니다. 이제 ResourceFile에 대해 지원되는 세 가지 모드가 있습니다.
      • httpUrlResourceFile 단일 HTTP URL을 가리키는 을 만듭니다.
      • storageContainerUrlResourceFile Azure Blob Storage 컨테이너를 가리키는 을 만듭니다.
      • autoStorageContainerNameResourceFile Batch 등록 자동 저장소 계정에서 Azure Blob Storage 컨테이너를 가리키는 을 만듭니다.
    • 메서드를 ResourceFile 통해 에 제공된 URL은 httpUrl 이제 모든 HTTP URL이 될 수 있습니다. 이전에는 Azure Blob Storage URL이어야 했습니다.
    • blobPrefix 는 스토리지 컨테이너에서 접두사와 일치하는 다운로드로만 다운로드를 필터링하는 데 사용할 수 있습니다.
  • [호환성이 손상되는] 에서 VirtualMachineConfiguration속성을 제거했습니다osDisk. 이 속성은 더 이상 지원되지 않습니다.

  • NetworkConfigurationjob 로 설정한 dynamicVNetAssignmentScope 풀은 이제 작업의 작업이 실행되는 각 노드에 Virtual Network 동적으로 할당할 수 있습니다. 노드를 조인할 특정 Virtual Network 및 JobSpecification의 새 JobNetworkConfiguration 속성에 CloudJob 지정됩니다.

    참고

    이 기능은 공개 미리 보기 상태입니다. Microsoft에 연락하여 파일럿에 포함하도록 요청한 계정을 제외한 모든 Batch 계정에 대해 사용하지 않도록 설정됩니다.

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

  • 을 통해 LoginMode특정 로그인 모드(batch또는 interactive)를 사용하여 사용자를 만들기 위한 Windows 풀에 대한 지원이 추가되었습니다.

  • 모든 작업에 대한 기본 작업 보존 시간은 이제 7일이며 이전에는 무한했습니다.

버전 2018-08-01.7.0

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

  • ComputeNode의 새 NodeAgentInfo 속성을 통해 Azure Batch 노드 에이전트의 버전을 봅니다.
  • 작업의 에 ResultFilter 지정하는 기능이 추가되었습니다. 자세한 내용은 여기를 참조하세요.
    • 이렇게 하면 서버 쪽 쿼리를 수행하는 자주 요청되는 시나리오에서 실패한 모든 작업을 찾을 수 있습니다.
  • [호환성이 손상되는]ValidationStatusTaskCounts에서 속성을 제거했습니다.
  • [호환성이 손상되는]DataDisk 및 OSDisk 의 기본 캐싱 형식은 이제 ReadWrite 대신 None입니다.
  • [호환성이 손상되는]ContainerType 의 유일한 값 이름을 에서 로 dockerdockerCompatible변경했습니다.

버전 2018-03-01.6.1

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

  • 상태별 풀 노드 수: 이 버전은 새 ListPoolNodeCounts 작업을 통해 상태별로 풀 노드 수를 쿼리하는 기능을 추가합니다. 이 작업을 통해 Batch 계정의 모든 풀에서 만들기, 유휴, 오프라인, 선점, 다시 부팅, 이미지 다시 만들기, 시작 등의 노드 상태를 쿼리할 수 있습니다.
  • 노드 에이전트 로그: 이 버전은 UploadBatchServiceLogs 작업을 통해 특정 노드에서 Azure Batch 노드 에이전트 로그를 업로드하는 기능을 추가합니다. 노드에서 문제가 발생하는 경우 Microsoft 지원 디버깅에 사용하기 위한 것입니다.

버전 2017-09-01.6.0

  • Azure 하이브리드 사용 혜택: 이제 Azure 하이브리드 사용 혜택 라이선스를 사용하도록 지정하는 Batch Windows VM 풀을 만들 수 있습니다. 이 라이선스를 사용하면 VM 가격에 할인이 적용됩니다. VirtualMachineConfiguration에서 새 LicenseType 속성을 사용합니다.

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

  • (호환성이 손상되는 변경) 이제 사용자 지정 이미지가 Blob VHD 파일 대신 Azure Resource Manager 이미지 리소스를 사용하여 만들어지고 배포됩니다. 이제 Batch는 관리 디스크를 사용하여 풀 VM을 만들므로 이미지 리소스를 사용합니다. 이제 사용자 지정 이미지를 사용하여 만든 풀의 VM 수에는 제한이 없습니다. 또한 큰 풀에 대한 VHD Blob의 여러 복사본은 더 이상 필요하지 않습니다. 따라서 사용자 지정 이미지 풀을 만들고 크기 조정하는 것이 훨씬 쉽습니다. 자세한 내용은 사용자 지정 이미지를 사용하여 가상 머신 풀 만들기를 참조하세요.

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

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

  • (호환성이 손상되는 변경) 다중 instance 작업(MultiInstanceSettings를 사용하여 생성됨)은 이제 CoordinationCommandLine을 지정해야 하며 NumberOfInstances는 이제 선택 사항이며 기본값은 1입니다.

  • Docker 컨테이너를 사용하여 실행되는 작업에 대한 지원이 추가되었습니다. Docker 컨테이너를 사용하여 작업을 실행하려면 풀의 VirtualMachineConfiguration에서 ContainerConfiguration을 지정한 다음 태스크에 TaskContainerSettings를 추가해야 합니다.

버전 2017-06-01.5.1

여기에 설명된 Batch API 버전은 2017-06-01.5.1입니다. 가능하면 최신 버전을 사용하는 것이 좋습니다.

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

  • 새 작업 수 가져오기 작업을 통해 효율적인 작업 수를 지원합니다 . 작업 수 가져오기 작업을 호출하면 활성, 실행 및 완료된 작업 수와 성공 또는 실패한 작업의 수를 가져올 수 있습니다. 자세한 내용은 상태별 작업 계수(미리 보기)를 참조하세요.
  • poolEndpointConfiguration 속성을 통해 풀 컴퓨팅 노드에서 인바운드 엔드포인트를 지정할 수 있습니다. 이 속성을 설정하면 노드의 특정 포트를 외부에서 해결할 수 있습니다.

버전 2017-05-01.5.0

다음 섹션에서는 버전 2017-05-01.5.0의 새로운 기능과 변경된 기능을 간략하게 설명합니다.

중요

버전 2017-05-01.5.0에는 몇 가지 주요 변경 내용이 포함되어 있습니다. 버전 2017-05-01.5.0을 호출하려면 아래에 명시된 호환성이 손상되는 변경 내용을 검토하고 코드를 업데이트하세요.

우선 순위가 낮은 컴퓨팅 노드

이제 Azure Batch Batch 워크로드 비용을 줄이기 위해 우선 순위가 낮은 컴퓨팅 노드를 제공합니다. 우선 순위가 낮은 VM은 경제적 측면도 있는 대량의 Compute 성능을 제공하여 새로운 유형의 Batch 워크로드를 가능하게 합니다.

우선 순위가 낮은 노드에 대한 REST API에는 다음과 같은 몇 가지 변경 사항이 있습니다.

  • (호환성이 손상되는 변경) 풀 또는 풀 사양의 targetDedicatedcurrentDedicated 속성의 이름이 targetDedicatedNodescurrentComputeNodes로 바뀌었습니다.
  • (호환성이 손상되는 변경) 풀의 resizeError 속성은 이제 resizeErrors라는 컬렉션입니다.
  • 컴퓨팅 노드에는 새 isDedicated 속성이 있습니다. 이 속성은 전용 노드의 경우 true 이고 우선 순위가 낮은 노드의 경우 false 입니다.
  • 작업 관리자 작업에는 새 allowLowPriorityNode 속성이 있습니다. 이 속성이 true이면 우선 순위가 낮은 노드에서 작업 관리자 작업을 실행할 수 있습니다. false이면 작업 관리자 작업이 전용 컴퓨팅 노드에서 실행됩니다.

Linux에서 명명된 사용자

Azure Batch 이제 Linux 노드에서 명명된 사용자를 만들기 위한 추가 지원을 제공합니다.

  • linuxUserConfiguration 속성은 Linux 사용자를 만들 때 uid (사용자 ID) 및 gid (그룹 ID)를 지정하는 것을 지원합니다.
  • (호환성이 손상되는 변경) sshPrivateKey 속성이 userAccount 속성에서 새 linuxUserConfiguration 속성으로 이동되었습니다. linuxUserConfiguration 속성 자체는 userAccount 속성의 속성입니다.

명명된 사용자 계정에 대한 자세한 내용은 Batch의 사용자 계정에서 작업 실행을 참조하세요.

작업 데이터에 대한 출력 파일

이제 작업이 완료된 후 작업 데이터를 업로드할 출력 파일을 지정할 수 있습니다.

  • outputFiles 속성은 Azure Storage에 업로드할 작업 파일 지정을 지원합니다.
  • exitConditions 속성의 새 fileUploadError 속성은 출력 파일의 업로드 상태 따라 수행할 작업을 지정할 수 있습니다.

작업 오류 보고

작업 오류에 대한 보고를 개선하기 위해 몇 가지 변경이 수행되었습니다.

  • executionInfo 속성의 새 결과 속성은 작업이 성공했는지 실패했는지 여부를 나타냅니다.
  • (호환성이 손상되는 변경) executionInfo 속성의 schedulingError 속성 이름이 failureInfo로 바뀌었습니다. failureInfo 속성은 태스크 오류가 발생할 때마다 반환됩니다. 여기에는 모든 이전 예약 오류 사례, 0이 아닌 작업 종료 코드가 반환되는 모든 경우 및 파일 업로드 실패가 포함됩니다.
  • (호환성이 손상되는 변경) exitConditions 속성의 schedulingError 속성의 이름이 preProcessingError로 변경되어 작업 수명 주기에서 오류가 발생한 시기를 명확히 합니다.
  • (호환성이 손상되는 변경) schedulingErrorCateogry 속성의 이름이 errorCategory로 변경되었습니다.

애플리케이션 라이선스

이제 풀 또는 풀 사양의 새 applicationLicenses 속성을 통해 애플리케이션 라이선스를 풀에 프로비전하도록 요청할 수 있습니다.

버전 2017-01-01.4.0

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

  • 지정된 사용자 ID에서 작업을 실행합니다.

    이제 작업 리소스의 새 userIdentity 속성을 통해 지정된 다음 사용자 ID 중 하나에서 작업 또는 작업 컬렉션을 실행할 수 있습니다.

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

    • 자동으로 만들어지는 사용자 계정(자동 사용자)입니다. 자동 사용자는 관리 사용자 또는 비관리 사용자로 실행할 수 있습니다. 기본적으로 자동 사용자는 비관리 사용자로 실행됩니다.

      중요

      userIdentity 속성은 elevationLevel 속성으로 작업 또는 작업 컬렉션을 추가하는 요청과 태스크에 대한 정보를 얻거나 작업을 나열하는 응답에서 runElevated 속성을 대체합니다.

      Batch 서비스의 버전 2017-01-01.4.0에 대한 runElevated 속성을 포함하는 요청을 수행하면 요청이 실패합니다.

      관리자 권한으로 실행하려면 userIdentity 속성을 사용하도록 애플리케이션을 업데이트하고 elevationLevel 속성을 admin으로 설정합니다.

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

  • 풀의 모든 노드에서 사용자 계정을 정의합니다.

    이제 풀 리소스에서 정의하는 사용자 계정으로 작업 또는 작업 컬렉션을 실행할 수 있습니다. 풀 추가 요청에서 새 userAccounts 속성을 통해 사용자 계정을 정의합니다. 계정을 정의할 때 계정 이름, 암호, 권한 상승 수준(관리자 또는 비관리자) 및 SSH 프라이빗 키(Linux 풀의 경우)를 지정할 수 있습니다.

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

  • 태스크가 실행되면 Batch 서비스에 인증할 토큰을 태스크에 제공합니다.

    이제 Batch 서비스가 실행 시 태스크에 인증 토큰을 제공할 수 있습니다. 인증 토큰을 사용하면 태스크가 Batch 계정 키 없이 작업과 관련된 요청을 Batch 서비스에 발급할 수 있습니다. 토큰은 AZ_BATCH_AUTHENTICATION_TOKEN 환경 변수를 통해 제공됩니다.

    현재 인증 토큰은 작업 리소스에 대한 호출 작업에 대해서만 지원됩니다. 인증 토큰은 작업이 포함된 작업의 모든 작업에 대한 액세스 권한을 부여합니다.

    Batch 서비스가 인증 토큰을 제공하도록 하려면 작업 추가 또는 작업 컬렉션 추가 요청에서 액세스 속성과 함께 새 authenticationTokenSettings 속성을 지정합니다.

  • 작업이 실패할 경우 태스크의 종속성에 대해 수행할 작업을 지정합니다.

    종속 작업이 실패하더라도 종속 작업이 진행되도록 지정할 수 있습니다. 부모 작업이 실패하더라도 종속 작업을 실행하도록 작업 리소스의 새 dependencyAction 속성을 충족 하도록 설정합니다. 또는 부모 작업이 실패할 경우 종속 태스크의 실행을 방지하도록 dependencyAction차단 하도록 설정합니다.

    작업 추가 또는 작업 컬렉션 추가 요청에 dependencyAction 속성을 지정합니다.

    종속성 작업 사용에 대한 자세한 내용은 종속성 작업을 참조하세요.

  • 풀을 만들 때 사용자 지정 OS 디스크 이미지를 사용합니다.

    이제 사용자 지정 OS 디스크 이미지를 사용하여 풀을 만들 수 있습니다.

    이렇게 하려면 Batch 서비스에서 관리하는 구독이 아닌 사용자 구독에서 풀을 프로비전할 Batch 계정을 만들 때 지정해야 합니다. 계정 만들기 호출에서 poolAllocationMode 속성을 UserSubscription으로 설정합니다. 그런 다음 osDisk 속성을 사용하여 풀 추가 요청에서 디스크 이미지에 대한 참조를 지정합니다.

    중요

    Batch 계정을 만들 때 사용자 구독에서 풀을 프로비전하도록 지정하는 경우 해당 계정을 통해 이루어진 모든 요청에 대해 Azure Active Directory 기반 인증을 사용해야 합니다.

  • Batch 서비스에 대한 요청에 Azure Active Directory 기반 인증을 사용합니다.

    이제 Azure AD(Azure Active Directory)가 Batch 서비스에 대한 호출을 인증하는 데 지원됩니다.

    Batch 계정이 사용자 구독에서 풀을 프로비전하도록 설정된 경우 Azure AD 인증을 사용해야 합니다.

버전 2016-07-01.3.1

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

  • 네트워크 구성을 사용하여 풀 및 자동 풀을 만드는 기능

    • 풀 및 자동 풀 리소스 모두에 새 속성 networkConfiguration 이 추가되었습니다. 이 속성을 사용하여 풀의 컴퓨팅 노드가 만들어진 서브넷과 같은 풀의 네트워크 구성을 지정할 수 있습니다.
  • 모든 작업이 완료되면 작업을 자동으로 종료합니다.

    • AllTasksComplete의 새 속성이 작업 리소스에 추가되었습니다. 작업을 만들거나 업데이트할 때 지정할 수 있습니다.
  • 작업이 실패하면 작업을 자동으로 종료하거나 사용하지 않도록 설정합니다.

    • 작업 리소스 에 새 속성 onTaskFailure 가 추가되었으며 새 속성 exitConditions 가 작업 리소스에 추가되었습니다. 작업 onTaskFailure 설정은 작업 실패가 작업 수준 영향을 미칠 수 있는지 여부를 나타내며 작업 exitConditions 속성을 사용하면 태스크가 작업 수준 영향을 오류의 특성에 맞게 조정할 수 있습니다.
  • 애플리케이션 패키지를 작업 및 풀과 연결합니다.

    • 새 속성 applicationPackageReferences 가 작업 리소스 및 작업 jobManagerTask 설정에 추가되었습니다. 이렇게 하면 풀을 만들 때 지정하도록 요구하지 않고 태스크에 필요하므로 애플리케이션 패키지를 요청 시 배포할 수 있습니다. 이는 수명 동안 다른 종류의 작업 또는 다른 애플리케이션 버전을 실행하기 위해 호출될 수 있는 수명이 긴 풀 또는 모든 작업에 필요하지 않은 대규모 애플리케이션 패키지가 있는 경우에 특히 유용합니다.
  • 실패한 작업을 다시 활성화하는 기능입니다.

    • 실패한 작업의 상태를 활성 상태로 다시 설정하기 위해 새 작업 다시 활성화 작업이 추가되었습니다. 이렇게 하면 오류를 다시 시도(예: 오류가 일시적이거나 작업을 다시 만들지 않고 오류의 원인을 해결할 수 있는 경우)할 수 있습니다.

버전 2016-02-01.3.0

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

버전 2015-12-01.2.2

이 버전 릴리스는 이전 버전 2015-11-01.2.1의 모든 지원을 확장합니다. 또한 다음과 같은 기능을 지원합니다.

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

    • 클라이언트가 사용 가능한 애플리케이션 및 버전 목록을 검색할 수 있도록 새 API가 제공됩니다(예: 사용자 인터페이스에 선택기를 표시하기 위해).

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

  • 이제 작업은 다른 작업에 따라 달라질 수 있습니다. 종속 작업이 종속된 모든 작업이 성공적으로 완료될 때까지 시작되지 않습니다.

이 버전 릴리스에는 다음과 같은 다른 변경 내용이 포함되어 있습니다.

  • 기본 풀 크기 조정 시간 제한이 15분으로 변경되었습니다.

버전 2015-11-01.2.1

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

  • 다중 instance 작업을 추가하고 실행하는 기능(예: MPI)

    • 선택적으로 작업 추가, 작업 가져오기, 작업 나열 API에 포함할 수 있는 새 선택적 속성 'multiInstanceSettings'가 작업 리소스에 추가됩니다.

    • 새 API 하위 작업에 대한 정보를 얻기 위해 작업의 하위 작업을 나열합니다.

    • 컴퓨팅 노드의 'recentTasks'에 새 선택적 속성 'subtaskId'가 추가됩니다. 이 속성은 컴퓨팅 노드 가져오기 및 컴퓨팅 노드 나열의 일부로 반환됩니다.

  • 컴퓨팅 노드에서 작업 예약을 사용하지 않도록 설정하거나 사용하도록 설정하는 기능

    • 두 개의 새 API 노드에서 작업 예약을 사용하지 않도록 설정하고 노드에서 작업 예약을 사용하도록 설정이 컴퓨팅 노드 리소스에 추가됩니다.

    • 새 컴퓨팅 노드 상태 '오프라인'이 추가됩니다. 이전 API 버전의 경우 이 상태는 '사용할 수 없음'에 매핑됩니다.

    • 새 속성 'schedulingState'가 컴퓨팅 노드 리소스에 추가됩니다. 'enabled' 및 'disabled'에 사용할 수 있는 값입니다.

  • 풀/자동 풀에서 자동 크기 조정 평가 간격을 지정하는 기능

    • 풀 리소스에 새 속성 'autoScaleEvaluationInterval'이 추가됩니다. 이 속성은 풀 추가, 풀 가져오기, 자동 크기 조정 사용 및 목록 풀 API에 포함될 수 있습니다.

    • 마찬가지로 자동 풀의 경우 새 속성 'autoScaleEvaluationInterval'이 'autoPoolSpecification' 속성에 추가됩니다. 이 속성은 작업 추가, 작업 가져오기, 작업 나열, 작업 일정 추가, 작업 일정 가져오기, 작업 일정 업데이트, 작업 일정 나열 및 작업 일정 API의 작업 나열에 포함될 수 있습니다.

  • 컴퓨팅 노드에서 태스크의 루트 디렉터리를 반환하도록 작업 API가 향상되었습니다.

    • 작업에 대한 정보 가져오기, 작업 API 나열의 일부로 가져올 수 있는 두 개의 새 속성 'taskRootDirectory' 및 'taskRootDirectoryUrl'이 작업 리소스에 추가됩니다.

    • 작업 API에 대한 작업 준비 및 작업 릴리스 작업의 상태 나열을 통해 가져올 수 있는 'jobPreparationTaskExecutionInfo' 및 'jobReleaseTaskExecutionInfo'에 새 속성 'taskRootDirectory'가 추가됩니다.