Penerapan Versi REST API Layanan Batch

Operasi yang disediakan oleh REST API layanan Batch mungkin memiliki beberapa versi untuk kompatibilitas mundur seiring berkembangnya API dari waktu ke waktu. Anda harus menentukan versi operasi mana yang ingin Anda gunakan saat dipanggil dengan memberikan versi dengan panggilan REST Anda. Jika aplikasi Anda memanggil versi operasi yang lebih lama, Anda dapat memilih untuk terus memanggil versi yang lebih lama, atau mengubah kode Anda untuk memanggil versi yang lebih baru. Jika versi tidak ditentukan atau versi yang salah ditentukan, maka kesalahan akan ditampilkan.

Untuk menentukan versi operasi mana yang akan digunakan, atur parameter kueri versi api. Versinya berformat Group.Major.Minor di mana Group dalam format YYYY-MM-DD dan Major adalah bilangan bulat dan Minor adalah bilangan bulat.

Versi terbaru: 2025-06-01

Versi Sebelumnya

Versi sebelumnya meliputi:

Versi: 2024-07-01.20.0

  • Menambahkan dealokasi simpul komputasi dan memulai operasi:
    • Menambahkan operasi baru ComputeNode_Deallocate (POST /pools/{poolId}/nodes/{nodeId}/deallocate) untuk membatalkan alokasi simpul komputasi yang menganggur atau sedang berjalan.
    • Menambahkan operasi baru ComputeNode_Start (POST /pools/{poolId}/nodes/{nodeId}/start) untuk memulai ulang simpul komputasi yang sebelumnya dibatalkan alokasinya.
    • Menambahkan model baru NodeDeallocateParameter dengan properti yang nodeDeallocateOption menentukan apa yang harus dilakukan dengan tugas yang sedang berjalan selama pembatalan alokasi.
  • [Pecah] Operasi yang dihapus ComputeNode_GetRemoteDesktop (GET /pools/{poolId}/nodes/{nodeId}/rdp). Operasi ini hanya berlaku untuk kumpulan konfigurasi Cloud Service.
  • [Pecah] Dukungan kumpulan Konfigurasi Layanan Cloud yang dihapus:
    • Model yang dihapus CloudServiceConfiguration .
    • Properti yang dihapus cloudServiceConfiguration dari CloudPool, PoolAddParameter, dan PoolSpecification.
  • [Pecah] Properti yang dihapus applicationLicenses dari CloudPool, PoolAddParameter, dan PoolSpecification.
  • Menambahkan dukungan pemasangan ikatan kontainer untuk tugas:
    • Menambahkan model baru ContainerHostBatchBindMountEntry dengan source dan isReadOnly properti.
    • Menambahkan enum baru ContainerHostDataPath dengan nilai Shared, Startup, VfsMounts, TaskJobPrep, , dan Applications.
    • Menambahkan properti baru containerHostBatchBindMounts ke TaskContainerSettings.
  • Menambahkan dukungan VM Rahasia:
    • Menambahkan model baru VMDiskSecurityProfile dengan properti securityEncryptionType .
    • Menambahkan properti baru securityProfile ke ManagedDisk.
    • Ditambahkan confidentialVM sebagai nilai baru untuk SecurityProfile.securityType.
  • Ditambahkan deallocated dan deallocating sebagai nilai baru untuk ComputeNodeState.
  • Menambahkan persyaratan deallocated dan deallocating properti baru ke NodeCounts.
  • Menambahkan dukungan referensi gambar Galeri Bersama dan Galeri Komunitas:
    • Ditambahkan sharedGalleryImageId dan communityGalleryImageId properti ke ImageReference.
  • Menambahkan skipWithdrawFromVNet properti ke JobNetworkConfiguration untuk mengontrol apakah simpul tetap bergabung ke VNet setelah pekerjaan berakhir.
  • Menambahkan networkConfiguration properti ke JobPatchParameter.
  • Kemampuan patching pool yang diperluas: Menambahkan displayName, vmSize, taskSlotsPerNode, taskSchedulingPolicy, enableInterNodeCommunication, mountConfigurationvirtualMachineConfigurationuserAccountsupgradePolicynetworkConfigurationdan resourceTags properti ke .PoolPatchParameter Properti yang memengaruhi topologi kumpulan hanya dapat diperbarui saat kumpulan kosong.
  • Menambahkan force parameter kueri boolean ke Job_Delete, Job_Terminate, , JobSchedule_Deletedan JobSchedule_Terminate operasi untuk memaksa operasi.

Versi: 2024-02-01.19.0

  • Menambahkan dukungan kebijakan peningkatan OS untuk kumpulan VM:
    • Menambahkan model baru UpgradePolicy dengan properti mode, automaticOSUpgradePolicy, dan rollingUpgradePolicy. Properti mode (UpgradeMode) menerima nilai automatic, manual, dan rolling.
    • Menambahkan model baru AutomaticOSUpgradePolicy dengan properti disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, dan osRollingUpgradeDeferral.
    • Menambahkan model baru RollingUpgradePolicy dengan properti enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatchesprioritizeUnhealthyInstances, dan rollbackFailedInstancesOnPolicyBreach.
    • Menambahkan properti baru upgradePolicy ke CloudPool, PoolAddParameter, dan PoolSpecification.
  • Ditambahkan upgradingos sebagai nilai baru untuk ComputeNodeState.
  • Menambahkan properti baru yang diperlukan upgradingOS untuk NodeCounts melaporkan jumlah simpul di upgradingos negara bagian.

Versi: 2023-11-01.18.0

  • Menambahkan dukungan Peluncuran Tepercaya / profil keamanan untuk kumpulan VM:
    • Menambahkan model baru SecurityProfile dengan properti encryptionAtHost, securityType, dan uefiSettings.
    • Menambahkan model baru UefiSettings dengan properti secureBootEnabled dan vTpmEnabled.
    • Menambahkan properti baru securityProfile ke VirtualMachineConfiguration.
  • Menambahkan dukungan referensi artefak layanan untuk set skala:
    • Menambahkan model baru ServiceArtifactReference dengan properti yang diperlukan id (ID sumber daya ARM).
    • Menambahkan properti baru serviceArtifactReference untuk VirtualMachineConfiguration mengatur versi gambar yang sama untuk semua VM dalam set skala saat menggunakan latest versi gambar.
  • Konfigurasi disk OS yang ditingkatkan:
    • Menambahkan model baru ManagedDisk dengan properti storageAccountType .
    • Menambahkan properti baru ke OSDisk: caching, diskSizeGB, , managedDiskdan writeAcceleratorEnabled.
  • Ditambahkan StandardSSDLRS (standardssd_lrs) sebagai nilai baru untuk StorageAccountType.
  • Menambahkan properti resourceTags baru ke CloudPool, PoolAddParameter, dan PoolSpecification untuk memungkinkan tag yang ditentukan pengguna disebarkan ke sumber daya Azure pendukung. Hanya berlaku ketika poolAllocationModeUserSubscription.
  • Menambahkan properti baru scaleSetVmResourceId untuk VirtualMachineInfo mengekspos ID sumber daya VM Set Skala Komputer Virtual simpul komputasi saat ini. Hanya ditentukan ketika Akun Batch poolAllocationMode adalah UserSubscription.

Versi: 2023-05-01.17.0

  • [Pecah] Menghapus API Statistik Masa Pakai Batch/Kumpulan: lifetimejobstats dan lifetimepoolstats.
  • Menambahkan properti enableAcceleratedNetworking boolean ke NetworkConfiguration.
    • Properti ini menentukan apakah kumpulan ini harus mengaktifkan jaringan yang dipercepat, dengan nilai default sebagai False.
    • Apakah fitur ini dapat diaktifkan juga terkait dengan apakah sistem operasi/instans VM didukung, yang harus selaras dengan Kebijakan AcceleratedNetworking.
  • Menambahkan properti enableAutomaticUpgrade boolean ke VMExtension.
    • Properti ini menentukan apakah ekstensi harus ditingkatkan secara otomatis jika ada versi ekstensi yang lebih baru yang tersedia.
  • Properti typeContainerConfiguration, yang sekarang mendukung dua nilai: DockerCompatible dan CriCompatible.

Versi: 2022-10-01.16.0

  • Menambahkan properti baru NodeCommunicationMode yang menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch
  • Menambahkan properti baru currentNodeCommunicationMode dari jenis CloudPool ke NodeCommunicationMode model untuk merujuk ke status mode komunikasi kumpulan saat ini.
  • Menambahkan properti baru targetNodeCommunicationMode dari jenis ke NodeCommunicationMode model berikut untuk merujuk ke mode komunikasi simpul yang diinginkan untuk kumpulan:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Versi: 2022-01-01.15.0

  • Menambahkan properti baru uploadHeaders ke OutputFileBlobContainerDestination model untuk memungkinkan pengguna mengatur header HTTP kustom pada upload file resource.
  • Menambahkan properti baru allowTaskPreemption ke model berikut untuk mendukung pendahuluan tugas untuk tugas prioritas yang lebih tinggi (memerlukan Comms-Enabled atau Kumpulan Penyewa Tunggal):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Versi: 2021-06-01.14.0

  • Menambahkan kemampuan untuk menetapkan identitas terkelola yang ditetapkan pengguna ke CloudPool. Identitas ini tersedia di setiap simpul dalam kumpulan, dan dapat digunakan untuk mengakses berbagai sumber daya.
  • Menambahkan identityReference properti ke model berikut untuk mendukung akses sumber daya melalui identitas terkelola:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Menambahkan properti baru extensions ke VirtualMachineConfiguration untuk CloudPool menentukan ekstensi komputer virtual untuk simpul
  • Menambahkan kemampuan untuk menentukan zona ketersediaan menggunakan properti nodePlacementConfiguration baru di VirtualMachineConfiguration
  • Menambahkan properti baru osDisk ke VirtualMachineConfiguration, yang berisi pengaturan untuk disk sistem operasi Mesin Virtual.
    • Properti placement pada DiffDiskSettings menentukan penempatan disk sementara untuk disk sistem operasi untuk semua VM di kumpulan. Mengaturnya ke "CacheDisk" untuk menyimpan disk OS sementara di cache VM.
  • Menambahkan maxParallelTasks properti untuk CloudJob mengontrol jumlah maksimum tugas yang dapat berjalan secara bersamaan per pekerjaan (default ke -1 berarti tidak terbatas). Properti ini saat ini dalam pratinjau pribadi.
  • Menambahkan virtualMachineInfo properti yang ComputeNode berisi informasi tentang status komputer virtual saat ini, termasuk versi persis dari gambar pasar yang digunakan VM.
  • Menambahkan recurrenceInterval properti untuk Schedule mengontrol interval antara waktu mulai dua pekerjaan berturut-turut di bawah jadwal pekerjaan.

Versi: 2020-09-01.12.0

  • [Pecah] Mengganti properti maxTasksPerNode dengan taskSlotsPerNode di kolam renang. Menggunakan tugas properti ini dalam pekerjaan dapat menggunakan sejumlah slot dinamis yang memungkinkan kontrol yang lebih terperinci atas konsumsi sumber daya.
  • [Pecah] Mengubah jenis GetTaskCounts respons to return TaskCountsResult, yang merupakan objek kompleks yang berisi objek sebelumnya TaskCounts dan objek baru TaskSlotCounts yang memberikan informasi serupa dalam konteks slot yang digunakan.
  • Menambahkan properti requiredSlots ke tugas yang memungkinkan pengguna untuk menentukan berapa banyak slot pada node yang harus digunakan.

Versi: 2020-03-01.11.0

  • Menambahkan kemampuan untuk mengenkripsi drive disk ComputeNode menggunakan properti VirtualMachineConfigurationbaru DiskEncryptionConfiguration .
  • [Pecah] Properti virtualMachineImageId dari ImageReference sekarang hanya dapat merujuk ke gambar Shared Image Gallery.
  • [Pecah] Properti password isi Add Certificate operasi permintaan bersifat opsional untuk sertifikat berformat PFX.
  • [Pecah] Kumpulan sekarang dapat disediakan tanpa IP publik menggunakan properti NetworkConfigurationbaru PublicIPAddressConfiguration .
  • [Pecah] Properti publicIPs telah NetworkConfiguration berganti nama menjadi dan ipAddressIds pindah ke PublicIPAddressConfiguration juga. Properti ini hanya dapat ditentukan jika provision properti adalah usermanaged.

Versi: 2019-08-01.10.0

  • Menambahkan kemampuan untuk menentukan kumpulan IP publik melalui NetworkConfiguration properti baru publicIPs di kumpulan. Ini menjamin simpul dalam kumpulan memiliki IP dari daftar IP yang disediakan pengguna.
  • Menambahkan kemampuan untuk memasang sistem file jarak jauh pada setiap node kumpulan melalui MountConfiguration properti.
  • Gambar Shared Image Gallery sekarang dapat ditentukan pada properti virtualMachineImageIdImageReference dengan mereferensikan gambar melalui ID Azure Resource Manager-nya.
  • [Pecah] Jika tidak ditentukan, nilai default untuk waitForSuccess on StartTask adalah true (sebelumnya, itu adalah false).
  • [Pecah] Jika tidak ditentukan, nilai default untuk scope pada AutoUserSpecification sekarang selalu Pool (sebelumnya, itu adalah Task pada Windows node dan Pool pada node Linux).
  • Memperbaiki berbagai dokumen yang membingungkan atau tidak lengkap.

Versi: 2019-06-01.9.0

  • [Pecah] Diganti ListNodeAgentSKUs dengan ListSupportedImages. ListSupportedImages berisi semua informasi yang sama yang awalnya tersedia dalam ListNodeAgentSKUs tetapi dalam format yang lebih jelas. Gambar baru yang tidak diverifikasi juga sekarang dikembalikan. Informasi tambahan tentang Capabilities dan BatchSupportEndOfLife dapat diakses melalui ImageInformation.

  • Sekarang mendukung aturan keamanan jaringan yang memblokir akses jaringan ke a CloudPool berdasarkan port sumber lalu lintas. Aturan ini dilakukan melalui properti SourcePortRanges di NetworkSecurityGroupRule.

  • Saat menjalankan kontainer, Batch sekarang mendukung pelaksanaan tugas di direktori kerja kontainer atau di direktori kerja tugas Batch. Ini dikendalikan oleh WorkingDirectory properti pada TaskContainerSettings.

  • Memperbaiki berbagai dokumen yang membingungkan atau tidak lengkap.

Versi: 2018-12-01.8.0

  • [Pecah] Dukungan untuk upgradeos pada cloudServiceConfiguration kumpulan dihapus.

    • Dihapus upgradeos.
    • Diganti namanya targetOSVersion menjadi osVersion dan dihapus currentOSVersion pada CloudPool.
    • Dihapus upgrading dari PoolState.

  • [Pecah] Dihapus dataEgressGiB dan dataIngressGiB dari poolusagemetrics. Properti ini tidak lagi didukung.

  • [Pecah]ResourceFile Peningkatan

    • Menambahkan kemampuan menentukan seluruh kontainer Azure Storage di ResourceFile. Sekarang ada tiga mode yang didukung untuk ResourceFile:
      • httpUrl membuat ResourceFile penunjuk ke satu URL HTTP.
      • storageContainerUrl membuat ResourceFile yang menunjuk ke wadah Azure Blob Storage.
      • autoStorageContainerName membuat ResourceFile yang menunjuk ke kontainer Azure Blob Storage di akun penyimpanan otomatis terdaftar Batch.
    • URL yang diberikan melalui ResourceFile metode sekarang httpUrl dapat berupa URL HTTP apa pun. Sebelumnya, URL ini harus berupa URL Azure Blob Storage.
    • blobPrefix dapat digunakan untuk memfilter unduhan dari kontainer penyimpanan hanya ke yang cocok dengan awalan.

  • [Pecah] Properti yang dihapus osDisk dari VirtualMachineConfiguration. Properti ini tidak lagi didukung.

  • Kumpulan yang mengatur dynamicVNetAssignmentScope pada NetworkConfiguration menjadi job sekarang dapat secara dinamis menetapkan Virtual Network ke setiap simpul jobs tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Nota

    Fitur ini dalam tahap pratinjau publik. Ini dinonaktifkan untuk semua akun Batch kecuali bagi mereka yang telah menghubungi kami dan meminta untuk berada di percontohan.

  • Masa pakai maksimum tugas sekarang adalah 180 hari (sebelumnya adalah 7).

  • Menambahkan dukungan pada kumpulan Windows untuk membuat pengguna dengan mode login tertentu (baik batch atau interactive) melalui LoginMode.

  • Waktu retensi tugas default untuk semua tugas sekarang tujuh hari, sebelumnya tidak terbatas.

Versi 2018-08-01.7.0

Fitur baru dalam versi 2018-08-01.7.0 meliputi:

  • Lihat versi Agen Node Azure Batch, melalui properti NodeAgentInfo baru di ComputeNode.
  • Menambahkan kemampuan untuk menentukan pada FilterResult tugas. Lihat di sini untuk detail selengkapnya.
    • Ini memungkinkan skenario yang sering diminta untuk melakukan kueri sisi server untuk menemukan semua tugas yang gagal.
  • [Pecah] Menghapus ValidationStatus properti dari TaskCounts.
  • [Pecah] Jenis caching default untuk DataDisk dan OSDisk sekarang ReadWrite adalah alih-alih None.
  • [Pecah] Mengganti nama satu-satunya nilai ContainerType dari docker menjadi dockerCompatible.

Versi 2018-03-01.6.1

Fitur baru dalam versi 2018-03-01.6.1 meliputi:

  • Jumlah simpul kumpulan berdasarkan status: Versi ini menambahkan kemampuan untuk mengkueri jumlah simpul kumpulan berdasarkan status, melalui operasi ListPoolNodeCounts baru. Operasi ini memberi Anda kemampuan untuk mengkueri semua kumpulan dalam akun Batch untuk status simpul.
  • Log agen simpul: Versi ini menambahkan kemampuan untuk mengunggah log agen simpul Azure Batch dari simpul tertentu, melalui operasi UploadBatchServiceLogs. Log ini dimaksudkan untuk digunakan dalam penelusuran kesalahan oleh Microsoft Support jika terjadi masalah pada simpul.

Versi 2017-09-01.6.0

  • Manfaat Penggunaan Hibrid Azure: Anda sekarang dapat membuat kumpulan VM Batch Windows yang menentukan bahwa lisensi Azure Hybrid Use Benefit digunakan. Saat lisensi ini digunakan, diskon diterapkan ke harga VM. Gunakan properti LicenseType baru di VirtualMachineConfiguration.

  • Kumpulan disk data VM: Anda dapat melampirkan satu atau beberapa disk data kosong ke kumpulan VM dengan menggunakan konfigurasi disk data baru yang merupakan bagian dari konfigurasi komputer virtual. Gunakan properti DataDisks di VirtualMachineConfiguration.

  • (Perubahan terobosan ) Gambar kustom sekarang dibuat dan disebarkan menggunakan sumber daya gambar Azure Resource Manager alih-alih file VHD blob. Batch sekarang menggunakan disk terkelola untuk membuat VM kumpulan dan oleh karena itu menggunakan sumber daya Gambar . Sekarang tidak ada batasan jumlah VM dalam kumpulan yang dibuat menggunakan gambar kustom; juga, beberapa salinan blob VHD untuk kumpulan besar tidak lagi diperlukan. Oleh karena itu, kumpulan gambar kustom jauh lebih mudah dibuat dan diskalakan. Untuk informasi selengkapnya, lihat Menggunakan gambar kustom untuk membuat kumpulan komputer virtual.

    • Properti VirtualMachineImageId baru pada ImageReference berisi referensi ke Image, dan OSDisk.ImageUris tidak ada lagi.

    • Karena perubahan ini, ImageReference sekarang menjadi properti wajib dari VirtualMachineConfiguration.

  • (Perubahan pecah) Tugas multi-instans (dibuat menggunakan MultiInstanceSettings) sekarang harus menentukan CoordinationCommandLine, dan NumberOfInstances sekarang bersifat opsional dan default ke 1.

  • Menambahkan dukungan untuk tugas yang dijalankan menggunakan kontainer Docker. Untuk menjalankan tugas menggunakan kontainer Docker, Anda harus menentukan ContainerConfiguration pada VirtualMachineConfiguration untuk kumpulan, lalu menambahkan TaskContainerSettings pada Task.

Versi 2017-06-01.5.1

Versi Batch API yang dijelaskan di sini adalah 2017-06-01.5.1. Menggunakan versi terbaru disarankan jika memungkinkan.

Fitur baru dalam versi 2017-06-01.5.1 meliputi:

  • Dukungan untuk penghitungan tugas yang efisien melalui operasi Dapatkan Hitungan Tugas yang baru. Dengan memanggil operasi Dapatkan Jumlah Tugas, Anda bisa mendapatkan hitungan tugas aktif, berjalan, dan selesai, serta tugas yang berhasil atau gagal. Untuk informasi selengkapnya, lihat Menghitung tugas untuk pekerjaan berdasarkan status (Pratinjau).
  • Dukungan untuk menentukan titik akhir masuk pada simpul komputasi kumpulan, melalui properti poolEndpointConfiguration baru. Dengan mengatur properti ini, Anda dapat menangani port tertentu pada simpul secara eksternal.

Versi 2017-05-01.5.0

Bagian berikut menguraikan fitur baru dan yang diubah dalam versi 2017-05-01.5.0.

Penting

Versi 2017-05-01.5.0 mencakup beberapa perubahan yang melanggar. Tinjau perubahan yang melanggar dan perbarui kode Anda untuk memanggil versi 2017-05-01.5.0.

Simpul komputasi prioritas rendah

Azure Batch sekarang menawarkan simpul komputasi prioritas rendah untuk mengurangi biaya beban kerja Batch. VM prioritas rendah memungkinkan jenis beban kerja Batch baru dengan menyediakan daya komputasi dalam jumlah besar yang juga ekonomis.

Ada beberapa perubahan pada REST API untuk simpul prioritas rendah:

  • (Perubahan pecah) Properti targetDedicated dan currentDedicated dari spesifikasi kumpulan atau kumpulan telah diganti namanya menjadi targetDedicatedNodes dan currentComputeNodes.
  • (Perubahan pecah) Properti resizeError kumpulan sekarang menjadi koleksi yang disebut resizeErrors.
  • Simpul komputasi memiliki properti isDedicated baru. Properti ini berlaku untuk simpul khusus, dan salah untuk simpul prioritas rendah.
  • Tugas Job Manager memiliki properti allowLowPriorityNode baru. Jika properti ini benar, tugas Job Manager dapat berjalan pada simpul prioritas rendah. Jika salah, maka tugas Job Manager berjalan pada simpul komputasi khusus.

Pengguna bernama di Linux

Azure Batch sekarang menawarkan dukungan tambahan untuk membuat pengguna bernama di simpul Linux.

  • Properti linuxUserConfiguration baru mendukung penentuan uid (ID pengguna) dan gid (ID grup) saat membuat pengguna Linux.
  • (Perubahan pecah) Properti sshPrivateKey telah dipindahkan dari properti userAccount ke properti linuxUserConfiguration baru. Properti linuxUserConfiguration itu sendiri merupakan properti dari properti userAccount.

Untuk informasi selengkapnya tentang akun pengguna bernama, lihat Menjalankan tugas di bawah akun pengguna di Batch.

File keluaran untuk data tugas

Anda sekarang dapat menentukan file output untuk mengunggah data tugas setelah tugas selesai.

  • Properti outputFiles baru mendukung penentuan file tugas untuk diunggah ke Azure Storage.
  • Properti fileUploadError baru dari properti exitConditions mendukung tindakan yang menentukan yang harus diambil berdasarkan status unggahan file output.

Pelaporan kesalahan tugas

Beberapa perubahan telah dilakukan untuk meningkatkan pelaporan untuk kesalahan tugas.

  • Properti hasil baru dari properti executionInfo menunjukkan apakah tugas berhasil atau gagal.
  • (Perubahan pecah) Properti schedulingError dari properti executionInfo telah diganti namanya menjadi failureInfo. Properti failureInfo dikembalikan setiap kali ada kegagalan tugas. Ini termasuk semua kasus kesalahan penjadwalan sebelumnya, semua kasus di mana kode keluar tugas bukan nol ditampilkan, dan kegagalan pengunggahan file apa pun.
  • (Perubahan pecah) Properti schedulingError dari properti exitConditions telah diganti namanya menjadi preProcessingError untuk mengklarifikasi kapan kesalahan terjadi dalam siklus hidup tugas.
  • (Perubahan pecah) Properti schedulingErrorCateogry telah diganti namanya menjadi errorCategory.

Lisensi aplikasi

Anda sekarang dapat meminta agar lisensi aplikasi disediakan ke kumpulan Anda, melalui properti applicationLicenses baru pada spesifikasi kumpulan atau kumpulan.

Versi 2017-01-01.4.0

Rilis versi ini memperluas semua dukungan dari versi sebelumnya, 2016-07-01.3.1. Selain itu, ini mendukung kemampuan berikut:

  • Jalankan tugas di bawah identitas pengguna yang ditentukan.

    Anda sekarang dapat menjalankan tugas atau kumpulan tugas di bawah salah satu identitas pengguna berikut, yang ditentukan melalui properti userIdentity baru pada sumber daya tugas:

    • Akun pengguna dengan nama yang Anda tentukan.

    • Akun pengguna yang dibuat secara otomatis (pengguna otomatis). Pengguna otomatis dapat berjalan sebagai pengguna administratif atau sebagai pengguna nonadministratif. Secara default, pengguna otomatis berjalan sebagai pengguna nonadministratif.

      Penting

      Properti userIdentity , dengan properti elevationLevel-nya , menggantikan properti runElevated dalam permintaan yang menambahkan tugas atau kumpulan tugas, dan dalam respons yang mendapatkan informasi tentang tugas atau tugas yang mencantumkan.

      Jika Anda membuat permintaan yang menyertakan properti runElevated ke versi 2017-01-01.4.0 dari layanan Batch, permintaan gagal.

      Untuk berjalan sebagai pengguna administratif, perbarui aplikasi Anda untuk menggunakan properti userIdentity , mengatur properti elevationLevel ke admin.

      Untuk berjalan sebagai pengguna nonadministratif, perbarui aplikasi Anda untuk menggunakan properti userIdentity , mengatur properti elevationLevel ke nonAdmin. Karena pengaturan ini adalah default, Anda juga dapat menghilangkan pengaturan.

  • Tentukan akun pengguna di semua simpul dalam kumpulan.

    Anda sekarang dapat menjalankan tugas atau kumpulan tugas di bawah akun pengguna yang Anda tentukan pada sumber daya kumpulan. Tentukan akun pengguna melalui properti userAccounts baru dalam permintaan untuk Menambahkan Kumpulan. Saat menentukan akun, Anda dapat menentukan nama akun, kata sandi, tingkat elevasi (admin atau nonadmin), dan kunci pribadi SSH (untuk kumpulan Linux).

    Setelah menentukan akun pengguna, Anda dapat menentukan akun pengguna tersebut untuk properti userIdentity dalam permintaan yang menambahkan tugas atau kumpulan tugas.

  • Berikan tugas dengan token untuk mengautentikasi ke layanan Batch saat tugas berjalan.

    Layanan Batch sekarang dapat memberikan token autentikasi ke tugas saat berjalan. Token autentikasi memungkinkan tugas untuk mengeluarkan permintaan yang terkait dengan pekerjaan ke layanan Batch, tanpa kunci akun Batch. Token disediakan melalui variabel lingkungan AZ_BATCH_AUTHENTICATION_TOKEN.

    Saat ini token autentikasi didukung untuk memanggil operasi pada sumber daya pekerjaan saja. Token autentikasi memberikan akses ke semua operasi pada pekerjaan yang berisi tugas.

    Agar layanan Batch menyediakan token autentikasi, tentukan properti authenticationTokenSettings baru, bersama dengan properti aksesnya , dalam permintaan untuk Menambahkan Tugas atau Menambahkan Kumpulan Tugas.

  • Tentukan tindakan yang akan diambil pada dependensi tugas jika tugas gagal.

    Anda sekarang dapat menentukan bahwa tugas dependen dilanjutkan meskipun tugas yang mereka andalkan gagal. Atur properti dependencyAction baru dari sumber daya tugas untuk memuaskan menjalankan tugas dependen meskipun tugas induk gagal. Sebagai alternatif, atur dependencyAction ke memblokir untuk mencegah menjalankan tugas dependen jika tugas induk gagal.

    Tentukan properti dependencyAction dalam permintaan untuk Menambahkan Tugas atau Menambahkan Kumpulan Tugas.

    Untuk informasi selengkapnya tentang menggunakan tindakan dependensi, lihat Tindakan dependensi.

  • Gunakan gambar disk OS kustom saat membuat kumpulan.

    Anda sekarang dapat menggunakan gambar disk OS kustom untuk membuat kumpulan.

    Untuk melakukannya, Anda harus menentukan saat membuat akun Batch bahwa kumpulan akan disediakan dalam langganan pengguna, bukan dalam langganan yang dikelola oleh layanan Batch. Dalam panggilan ke Membuat Akun, atur properti poolAllocationMode ke UserSubscription. Kemudian gunakan properti osDisk untuk menentukan referensi ke gambar disk dalam permintaan untuk Menambahkan Kumpulan.

    Penting

    Saat Anda membuat akun Batch, jika Anda menentukan bahwa kumpulan akan disediakan dalam langganan pengguna, maka Anda harus menggunakan autentikasi berbasis Azure Active Directory untuk semua permintaan yang dibuat melalui akun tersebut.

  • Gunakan autentikasi berbasis Azure Active Directory untuk permintaan ke layanan Batch.

    Azure Active Directory (Azure AD) sekarang didukung untuk mengautentikasi panggilan ke layanan Batch.

    Jika akun Batch Anda disiapkan untuk menyediakan kumpulan dalam langganan pengguna, maka menggunakan autentikasi Azure Active Directory diperlukan.

Versi 2016-07-01.3.1

Rilis versi ini memperluas semua dukungan dari versi sebelumnya, 2016-02-01.3.0. Selain itu, ini mendukung kemampuan berikut:

  • Kemampuan untuk membuat kumpulan dan kumpulan otomatis dengan konfigurasi Jaringan

    • Properti baru networkConfiguration telah ditambahkan ke sumber daya kumpulan dan kumpulan otomatis. Properti ini dapat digunakan untuk menentukan simpul komputasi kumpulans network configuration, such as the subnet in which the pooldibuat.

  • Akhiri pekerjaan secara otomatis setelah semua tugas selesai.

    • Properti baru onAllTasksComplete telah ditambahkan ke sumber daya pekerjaan. Anda dapat menentukan properti ini saat membuat atau memperbarui pekerjaan.

  • Hentikan atau nonaktifkan tugas secara otomatis saat tugas gagal.

    • Properti baru onTaskFailure telah ditambahkan ke sumber daya pekerjaan, dan properti baru exitConditions telah ditambahkan ke sumber daya tugas. Pengaturan pekerjaan onTaskFailure menunjukkan apakah kegagalan tugas mungkin memiliki dampak tingkat pekerjaan, dan properti tugas exitConditions memungkinkan tugas menyesuaikan dampak tingkat pekerjaan dengan sifat kegagalan.

  • Kaitkan paket aplikasi dengan tugas dan kumpulan.

    • Properti baru applicationPackageReferences ditambahkan ke sumber daya tugas dan ke pengaturan job jobManagerTask. Properti ini memungkinkan paket aplikasi disebarkan sesuai permintaan karena tugas memerlukannya daripada mengharuskannya ditentukan pada waktu pembuatan kumpulan. Properti ini sangat berharga untuk kolam berumur panjang yang mungkin dipanggil untuk menjalankan berbagai jenis pekerjaan atau versi aplikasi yang berbeda selama masa pakainya.

  • Kemampuan untuk mengaktifkan kembali tugas yang gagal.

    • Operasi baru Aktifkan kembali tugas telah ditambahkan untuk mengatur ulang status tugas yang gagal menjadi aktif. Hal ini memungkinkan kegagalan untuk dicoba ulang, misalnya jika kegagalan bersifat sementara atau jika Anda dapat memperbaiki penyebab kegagalan, tanpa membuat ulang tugas.

Versi 2016-02-01.3.0

Rilis versi ini memperluas semua dukungan dari versi sebelumnya, 2015-12-01.2.2. Selain itu, ini mendukung kemampuan berikut:

  • Kemampuan untuk membuat kumpulan dan kumpulan otomatis dengan konfigurasi VM IaaS

    • Properti osFamilyyang ada , targetOSVersion dan currentOSVersion dipindahkan dari properti tingkat atas sumber daya Kumpulan dan Kumpulan Otomatis dan dipindahkan ke dalam properti baru yang disebut cloudServiceConfiguration.

    • Properti virtualMachineConfiguration baru ditambahkan ke sumber daya Kumpulan dan Kumpulan Otomatis. Properti ini dapat ditentukan untuk mengonfigurasi kumpulan/kumpulan otomatis dengan VM IaaS.

    • API baru ditambahkan untuk mendapatkan informasi tentang semua SKU agen simpul yang didukung oleh layanan Batch. Lihat Daftar SKU agen simpul yang didukung.

    • API baru ditambahkan untuk mendapatkan pengaturan login jarak jauh yang dapat digunakan untuk masuk dari jarak jauh ke simpul komputasi yang dibuat dengan konfigurasi VM IaaS. Lihat Mendapatkan pengaturan login jarak jauh untuk simpul.

    • API baru ditambahkan untuk menambahkan kumpulan tugas ke pekerjaan. Lihat Menambahkan kumpulan tugas ke pekerjaan.

    • Properti sshPublicKey opsional baru ditambahkan ke sumber daya Pengguna yang dapat digunakan untuk menambahkan/memperbarui pengguna pada simpul komputasi Linux.

    • Dua properti totalTasksSucceeded baru dan runningTasksCount ditambahkan ke sumber daya Node. Properti ini dapat diperoleh melalui Dapatkan informasi tentang simpul atau Mencantumkan simpul komputasi dalam kumpulan.

    • Properti fileMode baru ditambahkan ke ResourceFile jenis kompleks. Properti ini hanya diterapkan pada simpul komputasi Linux dan diabaikan untuk simpul komputasi Windows.

    • Properti fileMode baru ditambahkan ke FileProperties jenis kompleks. Properti ini dikembalikan oleh layanan Batch untuk simpul komputasi Linux sebagai bagian dari API GetFileProperties atau ListFileProperties. Selain itu, properti creationTime yang ada di bawah FileProperties jenis kompleks diubah menjadi properti opsional karena properti ini tidak akan dikembalikan untuk simpul komputasi Linux.

    • Tipe data properti yang ada visibility di dalam CertificateReference jenis kompleks dimodifikasi dari string dengan nilai yang dipisahkan koma menjadi kumpulan string. Juga salah satu nilai visibilitas yang ada diganti namanya dari "rdp" menjadi "remoteuser".

  • URL API berikut diubah untuk menggantikan nama tindakan "?" menjadi "/":

    • Mengganti properti kumpulan

    • Menonaktifkan penskalaan otomatis pada kumpulan

    • Mengaktifkan penskalaan otomatis pada kumpulan

    • Mengevaluasi rumus penskalaan otomatis

    • Mengubah ukuran kumpulan

    • Berhenti mengubah ukuran kolam

    • Meningkatkan sistem operasi simpul komputasi dalam kumpulan

    • Menghapus simpul komputasi dari kumpulan

    • Nyalakan ulang node

    • Gambar ulang simpul

    • Menonaktifkan penjadwalan tugas pada node

    • Mengaktifkan penjadwalan tugas pada simpul

    • Menonaktifkan jadwal pekerjaan

    • Mengaktifkan jadwal pekerjaan

    • Mengakhiri jadwal pekerjaan

    • Menonaktifkan pekerjaan

    • Mengaktifkan pekerjaan

    • Mengakhiri pekerjaan

    • Mengakhiri tugas

    • Membatalkan penghapusan sertifikat

Versi 2015-12-01.2.2

Rilis versi ini memperluas semua dukungan dari versi sebelumnya, 2015-11-01.2.1. Selain itu, ini mendukung kemampuan berikut:

  • Aplikasi sekarang dapat disebarkan ke simpul komputasi menggunakan paket aplikasi, bukan sebagai file sumber daya.

    • API baru disediakan bagi klien untuk menelusuri daftar aplikasi dan versi yang tersedia, misalnya untuk menampilkan pemilih di antarmuka pengguna.

    • API terkait kumpulan diubah untuk memungkinkan kumpulan menentukan paket aplikasi yang akan diunduh ke semua simpul dalam kumpulan tersebut.

  • Tugas sekarang dapat dibuat bergantung pada tugas lain. Tugas dependen tidak akan dimulai sampai semua tugas yang bergantung padanya berhasil diselesaikan.

Rilis versi ini mencakup perubahan lain berikut:

  • Batas waktu pengubahan ukuran kumpulan default telah berubah menjadi 15 menit.

Versi 2015-11-01.2.1

Rilis versi ini memperluas semua dukungan dari versi sebelumnya 2015-06-01.2.0. Selain itu, ini mendukung kemampuan berikut:

  • Kemampuan untuk menambahkan dan menjalankan tugas multi-instans (misalnya, MPI)

    • Properti multiInstanceSettings opsional baru ditambahkan ke sumber daya Tugas yang dapat disertakan secara opsional dalam API Tambahkan Tugas, Dapatkan Tugas, Daftar Tugas.

    • API baru Daftar subtugas tugas ditambahkan untuk mendapatkan informasi tentang subtugas.

    • Properti subtaskId opsional baru ditambahkan untuk recentTasks Compute Node. Properti ini dikembalikan sebagai bagian dari Dapatkan Node Komputasi dan Daftar Node Komputasi

  • Kemampuan untuk menonaktifkan atau mengaktifkan penjadwalan tugas pada simpul komputasi

    • Dua API baru Nonaktifkan penjadwalan tugas pada simpul dan Aktifkan penjadwalan tugas pada simpul ditambahkan pada sumber daya simpul komputasi.

    • Status offline simpul komputasi baru ditambahkan. Untuk versi API yang lebih lama, status ini dipetakan ke unusable.

    • Properti schedulingState baru ditambahkan ke sumber daya simpul komputasi. Nilai yang mungkin untuk enabled dan disabled.

  • Kemampuan untuk menentukan interval evaluasi -scale otomatis pada kumpulan/kumpulan otomatis

    • Properti autoScaleEvaluationInterval baru ditambahkan ke sumber daya kumpulan. Properti ini dapat disertakan dalam API Tambahkan Kumpulan, Dapatkan Kumpulan, Aktifkan Skala Otomatis, dan Daftar Kumpulan.

    • Demikian pula, untuk kumpulan otomatis, properti autoScaleEvaluationInterval baru ditambahkan ke autoPoolSpecification properti. Properti ini dapat disertakan dalam Tambahkan Pekerjaan, Dapatkan Pekerjaan, Daftar Pekerjaan, Tambahkan Jadwal Pekerjaan, Dapatkan Jadwal Pekerjaan, Perbarui Jadwal Pekerjaan, Daftar Jadwal Pekerjaan, dan Daftar Pekerjaan di API Jadwal Pekerjaan.

  • Penyempurnaan API Tugas untuk mengembalikan direktori akar tugas pada simpul komputasi.

    • Dua properti taskRootDirectory baru dan taskRootDirectoryUrl ditambahkan ke sumber daya Tugas yang dapat diperoleh sebagai bagian dari Dapatkan informasi tentang tugas, Daftar API Tugas

    • Properti taskRootDirectory baru ditambahkan jobPreparationTaskExecutionInfo dan jobReleaseTaskExecutionInfo dapat diperoleh melalui Daftar status tugas persiapan pekerjaan dan rilis pekerjaan untuk API pekerjaan.

  • Last updated on