Gestione batch Versioning REST API

Le operazioni fornite dall'API REST per la gestione dei batti possono avere più versioni per compatibilità retrocompatibile man mano che l'API evolve nel tempo. Devi specificare quale versione di un'operazione vuoi utilizzare quando viene chiamata, fornendo la versione con la tua chiamata REST. Se la tua applicazione chiama una versione più vecchia di un'operazione, puoi scegliere di continuare a chiamare la versione precedente o modificare il codice per chiamare una versione più recente. Se la versione non viene specificata o viene specificata una versione errata, viene restituito un errore.

Per specificare quale versione di un'operazione utilizzare, imposta il parametro di query di api-version . La versione è del formato YYYY-MM-DD.

Ultima versione: 2025-06-01

• Livello lavorativo FIFO

  • Tipo aggiunto JobDefaultOrder .
  • Ampliato TaskSchedulingPolicy con una nuova jobDefaultOrder proprietà per supportare la pianificazione FIFO a livello di lavoro.

• Supporto CMK sui pool

  • Aggiunto DiskCustomerManagedKey per il supporto delle chiavi gestite dal cliente (CMK) nei pool.
  • Ampliato DiskEncryptionConfiguration con una nuova customerManagedKey proprietà.
  • Ampliato ManagedDisk con una nuova diskEncryptionSet proprietà.
  • Aggiunto DiskEncryptionSetParameters per il riferimento ai set di crittografia dei dischi.

• Supporto IPv6 sui pool

  • Tipo aggiunto IPFamily .
  • Ampliato PublicIPAddressConfiguration con nuove ipFamilies proprietà ipTags e proprietà.

• Supporto ai protocolli di sicurezza dei metadati nei pool

  • Aggiunto HostEndpointSettings e HostEndpointSettingsModeTypes.
  • Aggiunto ProxyAgentSettings.
  • Esteso SecurityProfile con una nuova proxyAgentSettings proprietà per il supporto ai protocolli di sicurezza dei metadati.

• Supporto ai tag IP

  • Tipo aggiunto IPTag .
  • Esteso PublicIPAddressConfiguration con nuove ipTags proprietà per il supporto ai tag IP.

• [Rottura] Supporto rimosso per i certificati:

  • API di certificato rimosse: Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, e Certificate_CancelDeletion.
  • Modelli di certificato rimossi: Certificate, CertificateCreateOrUpdateParameters, CertificateBasePropertiesCertificateCreateOrUpdateProperties, , CertificatePropertiesCertificateFormat, , CertificateProvisioningState, CertificateReferenceCertificateStoreLocation, CertificateVisibility, e DeleteCertificateError.
  • Rimossi certificates proprietà da Pool.

• [Rottura] Rimossi NodeCommunicationMode il modello e le proprietà targetNodeCommunicationMode e currentNodeCommunicationMode dal Pool.

• [Rottura] Rimossi applicationLicenses proprietà da Pool.

• [Rottura] Rimosso storageAccountType da DataDisk. Utilizzare invece ManagedDisk.storageAccountType.

• [Rottura] Rimosso resourceTags dal Pool.

Versioni precedenti

Le versioni precedenti includono:

• 2024-07-01
• 2024-02-01
• 2023-11-01
• 2023-05-01
• 2022-10-01
• 2022-06-01
• 01-01-2022
• 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

Versione: 2024-07-01

• Supporto aggiunto per il Perimetro di Sicurezza di Rete (NSP):

  • Aggiunta NetworkSecurityPerimeter_ListConfigurations un'operazione per elencare tutte le configurazioni NSP in un account Batch.
  • Aggiunta NetworkSecurityPerimeter_GetConfiguration un'operazione per ottenere una configurazione specifica del NSP.
  • Aggiunta NetworkSecurityPerimeter_ReconcileConfiguration un'operazione per riconciliare una configurazione NSP.
  • Valore aggiunto SecuredByPerimeter a PublicNetworkAccessType Enum.

• Supporto Confidential VM aggiunto:

  • Modello aggiunto VMDiskSecurityProfile con una securityEncryptionType proprietà.
  • Proprietà aggiunte securityProfile a ManagedDisk.
  • Aggiunto confidentialVM come nuovo valore per SecurityTypes enum.

• Aggiunta la Galleria Condivisa e il supporto per i riferimenti delle immagini della Galleria Comunitaria:

  • Proprietà e sharedGalleryImageId aggiunte communityGalleryImageId a ImageReference.

• Aggiunta la compatibilità per il montaggio di binding dei contenitori per i compiti:

  • Ho aggiunto ContainerHostBatchBindMountEntry il modello con source proprietà e isReadOnly proprietà.
  • Aggiungeva ContainerHostDataPath enum con valori Shared, Startup, VfsMounts, Task, JobPrep, e Applications.
  • Proprietà aggiunte containerHostBatchBindMounts a TaskContainerSettings.

• [Rottura] Rimosso il supporto per pool di configurazione dei servizi cloud:

  • Modello rimosso CloudServiceConfiguration .
  • Proprietà rimossa cloudServiceConfiguration da DeploymentConfiguration.
  • Operazione rimossa Location_ListSupportedCloudServiceSkus .

Versione: 2024-02-01

• Aggiunta la policy di aggiornamento del sistema operativo per pool VM:

  • Aggiunta UpgradePolicy la modellazione con proprietà mode, automaticOSUpgradePolicy, e rollingUpgradePolicy.
  • Aggiunta AutomaticOSUpgradePolicy un modello con proprietà disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, e osRollingUpgradeDeferral.
  • Ha aggiunto RollingUpgradePolicy il modello con proprietà enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatches, prioritizeUnhealthyInstances, e rollbackFailedInstancesOnPolicyBreach.
  • Aggiunta upgradePolicy proprietà al Pool.
  • Aggiungeva UpgradeMode enum con valori automatic, manual, e rolling.

• Proprietà aggiunte batchSupportEndOfLife a SupportedSku.

Versione: 2023-11-01

• Aggiunta la compatibilità di Trusted Launch/profili di sicurezza per pool di VM:

  • Aggiunta SecurityProfile la modellazione con proprietà encryptionAtHost, securityType, e uefiSettings.
  • Aggiunta UefiSettings un modello con proprietà secureBootEnabled e vTpmEnabled.
  • Aggiunto SecurityTypes enum con valori trustedLaunch.
  • Proprietà aggiunte securityProfile a VirtualMachineConfiguration.

• Aggiunta del supporto per il riferimento agli artefatti di servizio per scale set:

  • Modello aggiunto ServiceArtifactReference con una proprietà obbligatoria id .
  • Proprietà aggiunte serviceArtifactReference a VirtualMachineConfiguration.

• Configurazione migliorata del disco del sistema operativo:

  • Modello aggiunto ManagedDisk con una storageAccountType proprietà.
  • Aggiungendo caching, diskSizeGB, managedDisk, e writeAcceleratorEnabled proprietà a OSDisk.

• Aggiunto StandardSSD_LRS come nuovo valore per StorageAccountType.

• Aggiunta resourceTags di proprietà al Pool per permettere di propagare i tag definiti dall'utente alle risorse Azure di supporto. Applicabile solo quando poolAllocationMode è UserSubscription.

Versione: 01-05-2023

• Aggiunta proprietà enableAcceleratedNetworking booleana a NetworkConfiguration.

  • Questa proprietà determina se questo pool dovrebbe abilitare la rete accelerata, con il valore predefinito come falso.
  • Se questa funzione può essere abilitata dipende anche dal fatto che un'istanza di sistema operativo/VM sia supportata, il che dovrebbe essere in linea con la AcceleratedNetworking Policy.

• Aggiunta proprietà enableAutomaticUpgrade booleana a VMExtension.

  • Questa proprietà determina se l'estensione debba essere aggiornata automaticamente se esiste una versione più recente dell'estensione disponibile.

• La proprietà type di ContainerConfiguration ora supporta due valori: DockerCompatible e CriCompatible.

Versione: 2022-10-01

• Aggiungeva NodeCommunicationMode enum con valori Default, Classic, e Simplified per determinare come un pool comunica con il servizio Batch.
• Proprietà aggiunte currentNodeCommunicationMode a Pool per riferirsi allo stato attuale della modalità di comunicazione del pool.
• Aggiunta targetNodeCommunicationMode una proprietà al pool per riferirsi alla modalità di comunicazione desiderata per il pool.

Versione: 01-06-2022

• Aggiunta PrivateEndpointConnection_Delete un'operazione per eliminare una connessione endpoint privata.
• Aggiunta allowedAuthenticationModes proprietà a BatchAccountCreateProperties e BatchAccountUpdateProperties per controllare le modalità di autenticazione.
• Aggiunto TaskAuthenticationToken come nuovo valore per AuthenticationMode enum.

Versione: 2022-01-01

• Aggiunta Location_ListSupportedVirtualMachineSkus l'operazione per elencare le VM SKU supportate in una determinata posizione.
• Aggiunta SupportedSku la modellazione con proprietà name, familyName, e capabilities.
• Modello aggiunto SupportedSkusResult .
• Modello aggiunto SkuCapability .

Versione: 2021-06-01

• Aggiunta la possibilità di assegnare identità gestite assegnate dagli utenti a BatchPoolIdentity.
• Proprietà aggiunte identityReference a AzureBlobFileSystemConfiguration, ContainerRegistry, e ResourceFile per supportare l'accesso alle risorse tramite identità gestita.
• Aggiunta del supporto per le estensioni VM:
  • Proprietà aggiunte extensions a VirtualMachineConfiguration.
  • Modello aggiunto VMExtension .
• Aggiunta la possibilità di specificare le zone di disponibilità usando una nuova proprietà nodePlacementConfiguration su VirtualMachineConfiguration.
  • Modello aggiunto NodePlacementConfiguration con una policy proprietà.
  • Aggiunto NodePlacementPolicyType enum con valori Regional e Zonal.
• Aggiunta osDisk proprietà a VirtualMachineConfiguration con il supporto del disco del sistema operativo effimero tramite DiffDiskSettings.

Versione: 2021-01-01

• Possibilità aggiuntiva di cifrare i dati dei clienti con chiavi gestite dal cliente:
  • Aggiunta EncryptionProperties la modellazione con keySource e keyVaultProperties.
  • Aggiunto KeySource enum.
  • Modello aggiunto KeyVaultProperties .
  • Proprietà aggiunte encryption a BatchAccountCreateProperties e BatchAccountProperties.
• Aggiunta BatchAccountIdentity la funzione di modello che supporta SystemAssigned, UserAssigned, e None tipi di identità.
• Proprietà aggiunte identity a BatchAccountCreateParameters e BatchAccountUpdateParameters.
• Proprietà aggiunte allowedAuthenticationModes a BatchAccountProperties.
• Aggiunta ListOutboundNetworkDependenciesEndpoints un'operazione per elencare gli endpoint che un nodo di calcolo Batch può chiamare.

Versione: 01-09-2020

• Aggiunta taskSlotsPerNode proprietà al Pool, sostituendo il comportamento fisso del compito per nodo.
• Aggiunto BatchAccountProperties.publicNetworkAccess per controllare l'accesso pubblico alla rete.
• Aggiunto NetworkProfile un modello per controllare le regole di accesso alla rete per endpoint.

Versione: 2020-05-01

• Supporto per link privati aggiunto:

  • Operazione aggiunta PrivateEndpointConnection_ListByBatchAccount .
  • Operazione aggiunta PrivateEndpointConnection_Get .
  • Operazione aggiunta PrivateEndpointConnection_Update .
  • Operazione aggiunta PrivateLinkResource_ListByBatchAccount .
  • Operazione aggiunta PrivateLinkResource_Get .
  • Aggiunte PrivateEndpointConnection, PrivateEndpoint, PrivateLinkResource, e PrivateLinkServiceConnectionState modelli.

• Proprietà aggiunte publicNetworkAccess a BatchAccountCreateProperties.

Versione: 2020-03-01

• Aggiunta la possibilità di cifrare i dischi di calcolo dei nodi utilizzando la DiskEncryptionConfiguration proprietà di VirtualMachineConfiguration.
• Aggiunto PublicIPAddressConfiguration un modello per NetworkConfiguration supportare pool senza IP pubblici.
  • Aggiungeva IPAddressProvisioningType enum con valori BatchManaged, UserManaged, e NoPublicIPAddresses.
  • Proprietà aggiunte ipAddressIds a PublicIPAddressConfiguration.

Versione: 01-08-2019

• Aggiunta la possibilità di specificare una raccolta di IP pubblici tramite NetworkConfiguration la publicIPs proprietà.
• Possibilità aggiuntiva di montare file system remoti su ogni nodo di un pool tramite MountConfiguration:
  • Aggiunte AzureBlobFileSystemConfiguration, NFSMountConfiguration, CIFSMountConfiguration, e AzureFileShareConfiguration modelli.
  • Aggiunta mountConfiguration proprietà al Pool.

Versione: 01-04-2019

• Aggiunta Location_CheckNameAvailability un'operazione per verificare se è disponibile un nome account Batch.
• Aggiunto CheckNameAvailabilityParameters e CheckNameAvailabilityResult modelli.
• Supporto aggiuntivo DetectorResponse :
  • Operazione aggiunta BatchAccount_ListDetectors .
  • Operazione aggiunta BatchAccount_GetDetector .

Versione: 2018-12-01

• Proprietà aggiunte containerConfiguration a VirtualMachineConfiguration per i pool abilitati al container.
  • Modello aggiunto ContainerConfiguration .
  • Modello aggiunto ContainerRegistry .
  • Modello aggiunto TaskContainerSettings .
• Aggiunta startTask proprietà al Pool con pieno StartTask supporto ai modelli.
• Aggiunta dataDisks proprietà a VirtualMachineConfiguration per l'attacco dei dischi dati.
• Aggiunta licenseType proprietà a VirtualMachineConfiguration Azure Hybrid Use Benefit.
• Aggiunto AutoStorageAuthenticationMode enum con valori StorageKeys e BatchAccountManagedIdentity.
• Proprietà aggiunte nodeIdentityReference a AutoStorageBaseProperties.
• Ha aggiunto NetworkConfiguration il modello con subnetId, endpointConfiguration, e dynamicVnetAssignmentScope proprietà.
• Aggiunti PoolEndpointConfiguration modelli InboundNatPool per specificare gli endpoint in entrata.

Versione: 2017-09-01

• Aggiunta del supporto per la gestione del pool tramite ARM:
  • Aggiunte Pool_ListByBatchAccount, Pool_Get, Pool_Create, Pool_Update, Pool_Delete operazioni.
  • Aggiunte Pool_DisableAutoScale e Pool_StopResize operazioni.
  • Modello di risorse aggiunto Pool con proprietà di piscina complete.
• Gestione dei certificati aggiunta tramite ARM:
  • Aggiunte Certificate_ListByBatchAccount, Certificate_Get, Certificate_Create, Certificate_Update, Certificate_Delete, , Certificate_CancelDeletion operazioni.
• Aggiuntiva gestione di applicazioni e pacchetti applicazioni:
  • Aggiunte Application_List, Application_Get, Application_Create, Application_Update, Application_Delete operazioni.
  • Aggiunte ApplicationPackage_List, ApplicationPackage_Get, ApplicationPackage_Create, ApplicationPackage_Delete, ApplicationPackage_Activate operazioni.
• Modello aggiunto VirtualMachineConfiguration per la configurazione del pool basato su VM IaaS.
• Modello aggiunto ScaleSettings con FixedScaleSettings e AutoScaleSettings per controllare la dimensione della piscina.

Versione: 2017-05-01

• Aggiunto KeyVaultReference modello per l'integrazione di Azure Key Vault con account batch.
• Aggiunta poolAllocationMode proprietà alle BatchAccountCreateProperties modalità con BatchService e UserSubscription .
• Proprietà e dedicatedCoreQuotaPerVMFamily aggiunte dedicatedCoreQuotaPerVMFamilyEnforced a BatchAccountProperties.
• Proprietà aggiunte lowPriorityCoreQuota a BatchAccountProperties.

Versione: 2017-01-01

• Aggiunta la compatibilità per account di archiviazione assegnati dagli utenti tramite configurazione di auto-storage.
• Proprietà aggiunte storageAccountId a AutoStorageBaseProperties.
• Modello aggiunto AutoStorageProperties con lastKeySync proprietà.
• Operazione aggiunta BatchAccount_SynchronizeAutoStorageKeys .

Versione: 2015-12-01

Questa è la versione iniziale dell'API REST per la gestione del batch. Fornisce le seguenti capacità fondamentali:

• Gestione batch degli account:
  • BatchAccount_Create - Crea un nuovo account batch con parametri specificati.
  • BatchAccount_Update - Aggiorna le proprietà di un account Batch esistente.
  • BatchAccount_Delete - Elimina l'account batch specificato.
  • BatchAccount_Get - Ottiene informazioni sull'account batch specificato.
  • BatchAccount_List - Elenca tutti gli account batch sotto abbonamento.
  • BatchAccount_ListByResourceGroup - Elenca tutti gli account batch sotto un gruppo di risorse.
  • BatchAccount_GetKeys - Ottiene le chiavi del conto per l'account Batch specificato.
  • BatchAccount_RegenerateKey - Rigenera la chiave di conto specificata per l'account Batch.
• Operazioni di localizzazione:
  • Location_GetQuotas - Ottiene le quote di servizio batch per l'abbonamento specificato nella sede indicata.
• Operazioni:
  • Operations_List - Elenca le operazioni disponibili per il fornitore di batch.