Manajemen Batch REST API Versioning

Operasi yang disediakan oleh Batch Management REST API 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 YYYY-MM-DD.

Versi terbaru: 2025-06-01

• Tingkat pekerjaan FIFO

  • Jenis tambahan JobDefaultOrder .
  • Diperluas TaskSchedulingPolicy dengan properti baru jobDefaultOrder untuk mendukung penjadwalan FIFO tingkat pekerjaan.

• Dukungan CMK di Kumpulan

  • Ditambahkan DiskCustomerManagedKey untuk dukungan kunci yang dikelola pelanggan (CMK) pada kumpulan.
  • Diperluas DiskEncryptionConfiguration dengan properti baru customerManagedKey .
  • Diperluas ManagedDisk dengan properti baru diskEncryptionSet .
  • Ditambahkan DiskEncryptionSetParameters untuk mereferensikan set enkripsi disk.

• Dukungan IPv6 di Kumpulan

  • Jenis tambahan IPFamily .
  • Diperluas PublicIPAddressConfiguration dengan baru ipFamilies dan ipTags properti.

• Dukungan Protokol Keamanan Metadata pada Kumpulan

  • Ditambahkan HostEndpointSettings dan HostEndpointSettingsModeTypes.
  • Ditambahkan ProxyAgentSettings.
  • Diperluas SecurityProfile dengan properti baru proxyAgentSettings untuk dukungan protokol keamanan metadata.

• Dukungan Tag IP

  • Jenis tambahan IPTag .
  • Diperluas PublicIPAddressConfiguration dengan properti baru ipTags untuk dukungan tag IP.

• [Pecah] Dukungan untuk sertifikat yang dihapus:

  • API Sertifikat yang Dihapus: Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, , dan Certificate_CancelDeletion.
  • Model Sertifikat yang Dihapus: Certificate, CertificateCreateOrUpdateParametersCertificateBasePropertiesCertificateCreateOrUpdatePropertiesCertificatePropertiesCertificateFormatCertificateProvisioningStateCertificateReferenceCertificateStoreLocationCertificateVisibilityDeleteCertificateError
  • Properti yang dihapus certificates dari Pool.

• [Pecah] Menghapus NodeCommunicationMode model dan properti targetNodeCommunicationMode dan currentNodeCommunicationMode dari Pool.

• [Pecah] Properti yang dihapus applicationLicenses dari Pool.

• [Pecah] Dihapus storageAccountType dari DataDisk. Gunakan ManagedDisk.storageAccountType sebagai gantinya.

• [Pecah] Dihapus resourceTags dari Pool.

Versi Sebelumnya

Versi sebelumnya meliputi:

• 2024-07-01
• 2024-02-01
• 2023-11-01
• 2023-05-01
• 2022-10-01
• 2022-06-01
• 2022-01-01
• 2021-06-01
• 2021-01-01
• 2020-09-01
• 2020-05-01
• 2020-03-01
• 2019-08-01
• 2019-04-01
• 2018-12-01
• 2017-09-01
• 2017-05-01
• 2017-01-01
• 2015-12-01

Versi: 2024-07-01

• Menambahkan dukungan Network Security Perimeter (NSP):

  • Menambahkan NetworkSecurityPerimeter_ListConfigurations operasi untuk mencantumkan semua konfigurasi NSP di akun Batch.
  • Menambahkan NetworkSecurityPerimeter_GetConfiguration operasi untuk mendapatkan konfigurasi NSP tertentu.
  • Menambahkan NetworkSecurityPerimeter_ReconcileConfiguration operasi untuk merekonsiliasi konfigurasi NSP.
  • Nilai tambah SecuredByPerimeter untuk PublicNetworkAccessType enum.

• Menambahkan dukungan VM Rahasia:

  • Menambahkan VMDiskSecurityProfile model dengan properti securityEncryptionType .
  • Menambahkan securityProfile properti ke ManagedDisk.
  • Ditambahkan confidentialVM sebagai nilai baru untuk SecurityTypes enum.

• Menambahkan dukungan referensi gambar Galeri Bersama dan Galeri Komunitas:

  • Ditambahkan sharedGalleryImageId dan communityGalleryImageId properti ke ImageReference.

• Menambahkan dukungan pemasangan ikatan kontainer untuk tugas:

  • Menambahkan ContainerHostBatchBindMountEntry model dengan source dan isReadOnly properti.
  • Menambahkan ContainerHostDataPath enum dengan nilai Shared, Startup, VfsMounts, Task, JobPrep, dan Applications.
  • Menambahkan containerHostBatchBindMounts properti ke TaskContainerSettings.

• [Pecah] Dukungan kumpulan Konfigurasi Layanan Cloud yang dihapus:

  • Model yang dihapus CloudServiceConfiguration .
  • Properti yang dihapus cloudServiceConfiguration dari DeploymentConfiguration.
  • Operasi yang dihapus Location_ListSupportedCloudServiceSkus .

Versi: 2024-02-01

• Menambahkan dukungan kebijakan peningkatan OS untuk kumpulan VM:

  • Menambahkan UpgradePolicy model dengan properti mode, automaticOSUpgradePolicy, dan rollingUpgradePolicy.
  • Menambahkan AutomaticOSUpgradePolicy model dengan properti disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, dan osRollingUpgradeDeferral.
  • Menambahkan RollingUpgradePolicy model dengan properti enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatchesprioritizeUnhealthyInstances, dan rollbackFailedInstancesOnPolicyBreach.
  • Menambahkan upgradePolicy properti ke Pool.
  • Menambahkan UpgradeMode enum dengan nilai automatic, manual, dan rolling.

• Menambahkan batchSupportEndOfLife properti ke SupportedSku.

Versi: 2023-11-01

• Menambahkan dukungan Peluncuran Tepercaya / profil keamanan untuk kumpulan VM:

  • Menambahkan SecurityProfile model dengan properti encryptionAtHost, securityType, dan uefiSettings.
  • Menambahkan UefiSettings model dengan properti secureBootEnabled dan vTpmEnabled.
  • Menambahkan SecurityTypes enum dengan nilai trustedLaunch.
  • Menambahkan securityProfile properti ke VirtualMachineConfiguration.

• Menambahkan dukungan referensi artefak layanan untuk set skala:

  • Menambahkan ServiceArtifactReference model dengan properti yang diperlukan id .
  • Menambahkan serviceArtifactReference properti ke VirtualMachineConfiguration.

• Konfigurasi disk OS yang ditingkatkan:

  • Menambahkan ManagedDisk model dengan properti storageAccountType .
  • Ditambahkan caching, diskSizeGB, managedDisk, dan writeAcceleratorEnabled properti ke OSDisk.

• Ditambahkan StandardSSD_LRS sebagai nilai baru untuk StorageAccountType.

• Menambahkan resourceTags properti ke Kumpulan untuk memungkinkan tag yang ditentukan pengguna disebarkan ke sumber daya Azure yang mendukung. Hanya berlaku ketika poolAllocationModeUserSubscription.

Versi: 2023-05-01

• 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 sekarang mendukung dua nilai: DockerCompatible dan CriCompatible.

Versi: 2022-10-01

• Menambahkan NodeCommunicationMode enum dengan nilai Default, Classic, dan Simplified untuk menentukan bagaimana kumpulan berkomunikasi dengan layanan Batch.
• Menambahkan currentNodeCommunicationMode properti ke Kumpulan untuk merujuk ke status mode komunikasi kumpulan saat ini.
• Menambahkan targetNodeCommunicationMode properti ke Pool untuk merujuk ke mode komunikasi simpul yang diinginkan untuk kumpulan.

Versi: 2022-06-01

• Menambahkan PrivateEndpointConnection_Delete operasi untuk menghapus koneksi titik akhir privat.
• Menambahkan allowedAuthenticationModes properti ke BatchAccountCreateProperties dan BatchAccountUpdateProperties untuk mengontrol mode autentikasi.
• Ditambahkan TaskAuthenticationToken sebagai nilai baru untuk AuthenticationMode enum.

Versi: 2022-01-01

• Menambahkan Location_ListSupportedVirtualMachineSkus operasi untuk mencantumkan SKU VM yang didukung di lokasi tertentu.
• Menambahkan SupportedSku model dengan properti name, familyName, dan capabilities.
• Model tambahan SupportedSkusResult .
• Model tambahan SkuCapability .

Versi: 2021-06-01

• Menambahkan kemampuan untuk menetapkan identitas terkelola yang ditetapkan pengguna ke BatchPoolIdentity.
• Menambahkan identityReference properti ke AzureBlobFileSystemConfiguration, ContainerRegistry, dan ResourceFile untuk mendukung akses sumber daya melalui identitas terkelola.
• Menambahkan dukungan Ekstensi VM:
  • Menambahkan extensions properti ke VirtualMachineConfiguration.
  • Model tambahan VMExtension .
• Menambahkan kemampuan untuk menentukan zona ketersediaan menggunakan properti nodePlacementConfiguration baru di VirtualMachineConfiguration.
  • Menambahkan NodePlacementConfiguration model dengan properti policy .
  • Menambahkan NodePlacementPolicyType enum dengan nilai Regional dan Zonal.
• Menambahkan osDisk properti ke VirtualMachineConfiguration dengan dukungan disk OS sementara melalui DiffDiskSettings.

Versi: 2021-01-01

• Menambahkan kemampuan untuk mengenkripsi data pelanggan dengan kunci yang dikelola pelanggan:
  • Menambahkan EncryptionProperties model dengan keySource dan keyVaultProperties.
  • Menambahkan KeySource enum.
  • Model tambahan KeyVaultProperties .
  • Menambahkan encryption properti ke BatchAccountCreateProperties dan BatchAccountProperties.
• Menambahkan BatchAccountIdentity model yang mendukung SystemAssigned, UserAssigned, dan None jenis identitas.
• Menambahkan identity properti ke BatchAccountCreateParameters dan BatchAccountUpdateParameters.
• Menambahkan allowedAuthenticationModes properti ke BatchAccountProperties.
• Menambahkan ListOutboundNetworkDependenciesEndpoints operasi untuk mencantumkan titik akhir yang dapat dipanggil oleh simpul komputasi Batch.

Versi: 2020-09-01

• Menambahkan taskSlotsPerNode properti ke Pool, menggantikan perilaku task-per-node tetap.
• Ditambahkan BatchAccountProperties.publicNetworkAccess untuk mengontrol akses jaringan publik.
• Menambahkan NetworkProfile model untuk mengontrol aturan akses jaringan per titik akhir.

Versi: 2020-05-01

• Menambahkan dukungan Private Link:

  • Operasi tambahan PrivateEndpointConnection_ListByBatchAccount .
  • Operasi tambahan PrivateEndpointConnection_Get .
  • Operasi tambahan PrivateEndpointConnection_Update .
  • Operasi tambahan PrivateLinkResource_ListByBatchAccount .
  • Operasi tambahan PrivateLinkResource_Get .
  • Ditambahkan PrivateEndpointConnection, PrivateEndpoint, , PrivateLinkResourcedan PrivateLinkServiceConnectionState model.

• Menambahkan publicNetworkAccess properti ke BatchAccountCreateProperties.

Versi: 2020-03-01

• Menambahkan kemampuan untuk mengenkripsi drive disk node komputasi menggunakan DiskEncryptionConfiguration properti VirtualMachineConfiguration.
• Menambahkan PublicIPAddressConfiguration model untuk NetworkConfiguration mendukung kumpulan tanpa IP publik.
  • Menambahkan IPAddressProvisioningType enum dengan nilai BatchManaged, UserManaged, dan NoPublicIPAddresses.
  • Menambahkan ipAddressIds properti ke PublicIPAddressConfiguration.

Versi: 2019-08-01

• Menambahkan kemampuan untuk menentukan kumpulan IP publik melalui NetworkConfiguration properti publicIPs .
• Menambahkan kemampuan untuk memasang sistem file jarak jauh pada setiap node kumpulan melalui MountConfiguration:
  • Ditambahkan AzureBlobFileSystemConfiguration, NFSMountConfiguration, , CIFSMountConfigurationdan AzureFileShareConfiguration model.
  • Menambahkan mountConfiguration properti ke Pool.

Versi: 2019-04-01

• Menambahkan Location_CheckNameAvailability operasi untuk memeriksa apakah nama akun Batch tersedia.
• Ditambahkan CheckNameAvailabilityParameters dan CheckNameAvailabilityResult model.
• Dukungan tambahan DetectorResponse :
  • Operasi tambahan BatchAccount_ListDetectors .
  • Operasi tambahan BatchAccount_GetDetector .

Versi: 2018-12-01

• Menambahkan containerConfiguration properti ke VirtualMachineConfiguration untuk kumpulan yang diaktifkan kontainer.
  • Model tambahan ContainerConfiguration .
  • Model tambahan ContainerRegistry .
  • Model tambahan TaskContainerSettings .
• Menambahkan startTask properti ke Pool dengan dukungan model penuh StartTask .
• Menambahkan dataDisks properti ke VirtualMachineConfiguration untuk melampirkan disk data.
• Menambahkan licenseType properti ke VirtualMachineConfiguration untuk Azure Hybrid Use Benefit.
• Menambahkan AutoStorageAuthenticationMode enum dengan nilai StorageKeys dan BatchAccountManagedIdentity.
• Menambahkan nodeIdentityReference properti ke AutoStorageBaseProperties.
• Menambahkan NetworkConfiguration model dengan subnetId, endpointConfiguration, dan dynamicVnetAssignmentScope properti.
• Ditambahkan PoolEndpointConfiguration dan InboundNatPool model untuk menentukan titik akhir masuk.

Versi: 2017-09-01

• Menambahkan dukungan manajemen Pool melalui ARM:
  • Ditambahkan Pool_ListByBatchAccount, Pool_Get, , Pool_Create, Pool_Update, Pool_Delete operasi.
  • Ditambahkan Pool_DisableAutoScale dan Pool_StopResize operasi.
  • Menambahkan Pool model sumber daya dengan properti kumpulan yang komprehensif.
• Menambahkan manajemen Sertifikat melalui ARM:
  • Ditambahkan Certificate_ListByBatchAccount, Certificate_Get, , Certificate_Create, Certificate_Update, Certificate_Delete, operasi Certificate_CancelDeletion .
• Menambahkan manajemen Application dan ApplicationPackage:
  • Ditambahkan Application_List, Application_Get, , Application_Create, Application_Update, Application_Delete operasi.
  • Ditambahkan ApplicationPackage_List, ApplicationPackage_Get, , ApplicationPackage_Create, ApplicationPackage_Delete, ApplicationPackage_Activate operasi.
• Menambahkan VirtualMachineConfiguration model untuk konfigurasi kumpulan berbasis VM IaaS.
• Menambahkan ScaleSettings model dengan FixedScaleSettings dan AutoScaleSettings untuk mengontrol ukuran kolam.

Versi: 2017-05-01

• Menambahkan KeyVaultReference model untuk integrasi Azure Key Vault dengan akun Batch.
• Menambahkan poolAllocationMode properti ke BatchAccountCreateProperties mode with BatchService and .UserSubscription
• Ditambahkan dedicatedCoreQuotaPerVMFamily dan dedicatedCoreQuotaPerVMFamilyEnforced properti ke BatchAccountProperties.
• Menambahkan lowPriorityCoreQuota properti ke BatchAccountProperties.

Versi: 2017-01-01

• Menambahkan dukungan untuk akun penyimpanan yang ditetapkan pengguna melalui konfigurasi penyimpanan otomatis.
• Menambahkan storageAccountId properti ke AutoStorageBaseProperties.
• Menambahkan AutoStorageProperties model dengan lastKeySync properti.
• Operasi tambahan BatchAccount_SynchronizeAutoStorageKeys .

Versi: 2015-12-01

Ini adalah versi awal dari Batch Management REST API. Ini menyediakan kemampuan inti berikut:

• Manajemen Akun Batch:
  • BatchAccount_Create - Membuat akun Batch baru dengan parameter yang ditentukan.
  • BatchAccount_Update - Memperbarui properti akun Batch yang ada.
  • BatchAccount_Delete - Menghapus akun Batch yang ditentukan.
  • BatchAccount_Get - Mendapatkan informasi tentang akun Batch yang ditentukan.
  • BatchAccount_List - Mencantumkan semua akun Batch di bawah langganan.
  • BatchAccount_ListByResourceGroup - Mencantumkan semua akun Batch di bawah grup sumber daya.
  • BatchAccount_GetKeys - Mendapatkan kunci akun untuk akun Batch yang ditentukan.
  • BatchAccount_RegenerateKey - Membuat ulang kunci akun yang ditentukan untuk akun Batch.
• Operasi Lokasi:
  • Location_GetQuotas - Mendapatkan kuota layanan Batch untuk langganan yang ditentukan di lokasi yang diberikan.
• Operasi:
  • Operations_List - Mencantumkan operasi yang tersedia untuk penyedia Batch.