Azure SDK for Java (December 2025)

The Azure SDK team is pleased to announce our December 2025 client library releases.

17 packages released this month.

Stable Packages (1)

Resource Management - PostgreSQL Flexible Server

Beta Packages (9)

Azure AI Search
Azure SDK Template
Azure SDK Template Three
Azure SDK Template Two
Identity
Resource Management - Computelimit
Resource Management - Container Registry
Resource Management - DNS Resolver
Resource Management - IoT Hub

Release highlights

Azure AI Search 11.9.0-beta.1 Changelog

Features Added

Added back all service preview features dropped in 2025-09-01 service version release.
Added optional parameter x-ms-enable-elevated-read for elevated read access that bypasses document-level permission checks.
Added statistical aggregation properties to FacetResult: avg, min, max, and cardinality for enhanced analytics.
Added support for new Azure OpenAI models: gpt-5, gpt-5-mini, and gpt-5-nano.
Added support for sharepoint data source type in SearchIndexerDataSourceType.
Added support for new KnowledgeSourceKind types: web, remoteSharePoint, indexedSharePoint, and indexedOneLake.
Added purviewEnabled property to SearchIndex for Microsoft Purview integration.
Added maxCumulativeIndexerRuntimeSeconds property to ServiceLimits for runtime monitoring.
Added required runtime property to SearchIndexerStatus and indexersRuntime property to ServiceStatistics.
Added product enum value to ScoringFunctionAggregation.
Added enhanced knowledge source parameters: sourceDataFields, searchFields, semanticConfigurationName in SearchIndexKnowledgeSourceParameters.
Added Azure Data Lake Storage Gen2 support with isADLSGen2 and ingestionParameters in AzureBlobKnowledgeSourceParameters.
Added partial content response support (HTTP 206) for knowledge base operations.
Added error property to KnowledgeBaseActivityRecord for enhanced error handling.
Added enhanced knowledge source parameters: includeReferences, includeReferenceSourceData, alwaysQuerySource, rerankerThreshold in SearchIndexKnowledgeSourceParams.

Bugs Fixed

Fixed a bug where multiple iterations / subscriptions of SearchPagedFlux and SearchPagedIterable would return the same first page result of the initial iteration / subscription.

Breaking Changes

Knowledge Agent to Knowledge Base Migration: Complete API rename from Knowledge Agent to Knowledge Base.
All KnowledgeAgent* classes renamed to KnowledgeBase* (e.g., KnowledgeAgent → KnowledgeBase).
API paths changed from /agents to /knowledgebases.
Client parameter AgentNameParameter renamed to KnowledgeBaseNameParameter.
All agent-related activity record types updated with new naming convention
Removed deprecated Knowledge Agent classes: KnowledgeAgentOutputConfiguration, KnowledgeAgentRequestLimits, KnowledgeAgentModel, KnowledgeAgentModelKind, KnowledgeAgentAzureOpenAIModel.
Removed properties from KnowledgeSourceReference:includeReferences,includeReferenceSourceData,alwaysQuerySource,maxSubQueries,rerankerThreshold
Removed sourceDataSelect property from SearchIndexKnowledgeSourceParameters.
Removed properties from AzureBlobKnowledgeSourceParameters: identity, embeddingModel, chatCompletionModel, ingestionSchedule, disableImageVerbalization.
Updated RescoringOptions to match what was changed in 11.8.0 release.
isEnableRescoring -> isRescoringEnabled
setEnableRescoring -> setRescoringEnabled
Changed RankingOrder.RE_RANKER_SCORE to RankingOrder.RERANKER_SCORE.
Changed SearchOptions.getDebug and .setDebug to .getDebugMode and .setDebugMode.
Default SearchServiceVersion changed from 2025_09_01 to V2025_08_01_PREVIEW.

Azure AI Search 11.9.0-beta.1 Changelog

Features Added

Added back all service preview features dropped in 2025-09-01 service version release.
Added optional parameter x-ms-enable-elevated-read for elevated read access that bypasses document-level permission checks.
Added statistical aggregation properties to FacetResult: avg, min, max, and cardinality for enhanced analytics.
Added support for new Azure OpenAI models: gpt-5, gpt-5-mini, and gpt-5-nano.
Added support for sharepoint data source type in SearchIndexerDataSourceType.
Added support for new KnowledgeSourceKind types: web, remoteSharePoint, indexedSharePoint, and indexedOneLake.
Added purviewEnabled property to SearchIndex for Microsoft Purview integration.
Added maxCumulativeIndexerRuntimeSeconds property to ServiceLimits for runtime monitoring.
Added required runtime property to SearchIndexerStatus and indexersRuntime property to ServiceStatistics.
Added product enum value to ScoringFunctionAggregation.
Added enhanced knowledge source parameters: sourceDataFields, searchFields, semanticConfigurationName in SearchIndexKnowledgeSourceParameters.
Added Azure Data Lake Storage Gen2 support with isADLSGen2 and ingestionParameters in AzureBlobKnowledgeSourceParameters.
Added partial content response support (HTTP 206) for knowledge base operations.
Added error property to KnowledgeBaseActivityRecord for enhanced error handling.
Added enhanced knowledge source parameters: includeReferences, includeReferenceSourceData, alwaysQuerySource, rerankerThreshold in SearchIndexKnowledgeSourceParams.

Bugs Fixed

Fixed a bug where multiple iterations / subscriptions of SearchPagedFlux and SearchPagedIterable would return the same first page result of the initial iteration / subscription.

Breaking Changes

Knowledge Agent to Knowledge Base Migration: Complete API rename from Knowledge Agent to Knowledge Base.
All KnowledgeAgent* classes renamed to KnowledgeBase* (e.g., KnowledgeAgent → KnowledgeBase).
API paths changed from /agents to /knowledgebases.
Client parameter AgentNameParameter renamed to KnowledgeBaseNameParameter.
All agent-related activity record types updated with new naming convention
Removed deprecated Knowledge Agent classes: KnowledgeAgentOutputConfiguration, KnowledgeAgentRequestLimits, KnowledgeAgentModel, KnowledgeAgentModelKind, KnowledgeAgentAzureOpenAIModel.
Removed properties from KnowledgeSourceReference:includeReferences,includeReferenceSourceData,alwaysQuerySource,maxSubQueries,rerankerThreshold
Removed sourceDataSelect property from SearchIndexKnowledgeSourceParameters.
Removed properties from AzureBlobKnowledgeSourceParameters: identity, embeddingModel, chatCompletionModel, ingestionSchedule, disableImageVerbalization.
Updated RescoringOptions to match what was changed in 11.8.0 release.
isEnableRescoring -> isRescoringEnabled
setEnableRescoring -> setRescoringEnabled
Changed RankingOrder.RE_RANKER_SCORE to RankingOrder.RERANKER_SCORE.
Changed SearchOptions.getDebug and .setDebug to .getDebugMode and .setDebugMode.
Default SearchServiceVersion changed from 2025_09_01 to V2025_08_01_PREVIEW.

Azure SDK Template 1.0.1-beta.5657548 Changelog

Azure SDK Template 1.0.1-beta.5656397 Changelog

Azure SDK Template 1.0.1-beta.5656223 Changelog

Azure SDK Template Three 1.0.0-beta.5657548 Changelog

Azure SDK Template Two 1.0.0-beta.5657548 Changelog

Azure SDK Template Two 1.0.0-beta.5656223 Changelog

Identity 1.19.0-beta.1 Changelog

Features Added

Added enableAzureTokenProxy() method to WorkloadIdentityCredentialBuilder to enable custom token proxy support for Azure Kubernetes clusters. When enabled, the credential attempts to use a custom token proxy configured through environment variables (AZURE_KUBERNETES_TOKEN_PROXY, AZURE_KUBERNETES_CA_FILE, AZURE_KUBERNETES_CA_DATA, AZURE_KUBERNETES_SNI_NAME).

Identity 1.19.0-beta.1 Changelog

Features Added

Added enableAzureTokenProxy() method to WorkloadIdentityCredentialBuilder to enable custom token proxy support for Azure Kubernetes clusters. When enabled, the credential attempts to use a custom token proxy configured through environment variables (AZURE_KUBERNETES_TOKEN_PROXY, AZURE_KUBERNETES_CA_FILE, AZURE_KUBERNETES_CA_DATA, AZURE_KUBERNETES_SNI_NAME).

Resource Management - Computelimit 1.0.0-beta.1 Changelog

Resource Management - Container Registry 2.55.0-beta.1 Changelog

Resource Management - DNS Resolver 1.2.0-beta.1 Changelog

Resource Management - IoT Hub 1.4.0-beta.1 Changelog

Resource Management - PostgreSQL Flexible Server 2.0.0 Changelog

Need help

For reference documentation visit the Azure SDK for Java documentation.
For tutorials, samples, quick starts and other documentation, visit Azure for Java Developers.
For build reports on code quality, test coverage, etc, visit Azure Java SDK.
File an issue via Github Issues.
Check previous questions or ask new ones on StackOverflow using azure-java-sdk tag.

Latest Releases

View all the latest versions of Java packages here.

Installation Instructions

To use the GA and beta libraries, refer to the Maven dependency information below, which may be copied into your projects Maven pom.xml file as appropriate. If you are using a different build tool, refer to its documentation on how to specify dependencies.

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-identity</artifactId>
  <version>1.19.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-computelimit</artifactId>
  <version>1.0.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-containerregistry</artifactId>
  <version>2.55.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-dnsresolver</artifactId>
  <version>1.2.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-iothub</artifactId>
  <version>1.4.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>azure-resourcemanager-postgresqlflexibleserver</artifactId>
  <version>2.0.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-search-documents</artifactId>
  <version>11.9.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-identity</artifactId>
  <version>1.19.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-search-documents</artifactId>
  <version>11.9.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-containerregistry</artifactId>
  <version>2.55.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-postgresqlflexibleserver</artifactId>
  <version>2.0.0</version>
</dependency>

<dependency>
  <groupId>com.azure.v2</groupId>
  <artifactId>com.azure.v2+azure-sdk-template</artifactId>
  <version>1.0.1-beta.5657548</version>
</dependency>

<dependency>
  <groupId>com.azure.v2</groupId>
  <artifactId>com.azure.v2+azure-sdk-template</artifactId>
  <version>1.0.1-beta.5656397</version>
</dependency>

<dependency>
  <groupId>com.azure.v2</groupId>
  <artifactId>com.azure.v2+azure-sdk-template</artifactId>
  <version>1.0.1-beta.5656223</version>
</dependency>

<dependency>
  <groupId>com.azure.v2</groupId>
  <artifactId>com.azure.v2+azure-sdk-template-three</artifactId>
  <version>1.0.0-beta.5657548</version>
</dependency>

<dependency>
  <groupId>com.azure.v2</groupId>
  <artifactId>com.azure.v2+azure-sdk-template-two</artifactId>
  <version>1.0.0-beta.5657548</version>
</dependency>

<dependency>
  <groupId>com.azure.v2</groupId>
  <artifactId>com.azure.v2+azure-sdk-template-two</artifactId>
  <version>1.0.0-beta.5656223</version>
</dependency>

Feedback

If you have a bug or feature request for one of the libraries, please post an issue to GitHub.