Azure SDK for Java (March 2026)

The Azure SDK team is pleased to announce our March 2026 client library releases.

71 packages released this month.

Stable Packages (15)

Content Understanding
Cosmos Spark 3.4
Cosmos Spark 3.5
Cosmos Spark 4.0
OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API
Resource Management
Resource Management - Disconnected Operations
Resource Management - Durable Task
Resource Management - Elastic
Resource Management - Elastic SAN
Resource Management - NetApp Files
Resource Management - Network Function
Resource Management - Power BI Dedicated
Resource Management - Provider Hub
Resource Management - Service Fabric Managed Clusters

Patch Updates (12)

Azure Blob Storage Checkpoint Store
Communication Call Automation
Cosmos Spark 3.4
Cosmos Spark 3.5
Cosmos Spark 4.0
OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API
Resource Management - Compute
Resource Management - Container Instances
SDK - Bill of Materials
Storage - Blobs Batch
Storage - Blobs Cryptography
Storage - Internal Avro

Beta Packages (24)

AI Agents
AI Projects
Compute Batch
Identity
Resource Management - Commerce
Resource Management - Computebulkactions
Resource Management - Connected Cache
Resource Management - Cosmos DB for PostgreSQL
Resource Management - Maintenance
Resource Management - Managed Ops
Resource Management - New Relic Observability
Resource Management - PostgreSQL Flexible Server
Resource Management - Self Help
Storage - Blobs
Storage - Blobs Batch
Storage - Blobs Changefeed
Storage - Blobs Cryptography
Storage - Blobs NIO
Storage - Common
Storage - Files Data Lake
Storage - Files Share
Storage - Internal Avro
Storage - Queues
Voice Live

Release highlights

AI Agents 2.0.0-beta.2 Changelog

Features Added

Added buildOpenAIClient() and buildOpenAIAsyncClient() methods to AgentsClientBuilder for simplified creation of OpenAI clients with default Azure setup
Added new agent tool samples: CodeInterpreterAgent, FileSearchAgent, FunctionCallAgent, McpAgent, and WebSearchAgent (sync and async variants)
Added action property to ImageGenTool with new ImageGenActionEnum (values: GENERATE, EDIT, AUTO).
Added GPT_IMAGE_1_5 to ImageGenToolModel.
Added container skill types: ContainerSkill, ContainerSkillType, ContainerAutoParam, ContainerNetworkPolicyParam, and related network policy types (ContainerNetworkPolicyAllowlistParam, ContainerNetworkPolicyDisabledParam, ContainerNetworkPolicyDomainSecretParam, ContainerNetworkPolicyParamType).
Added environment configuration for FunctionShellToolParameter and InputItemFunctionShellCallItemParam via new FunctionShellToolParamEnvironment, FunctionShellCallItemParamEnvironment, and related container/local environment parameter types. InputItemFunctionShellCallItemParam, FunctionShellCallItemParamEnvironment, and related types moved to implementation/models (internal).
Added MessageContent and MessageContentType model types; subsequently moved to implementation/models (internal).
Added skill parameter types: InlineSkillParam, InlineSkillSourceParam, LocalSkillParam, SkillReferenceParam.

Bugs Fixed

Fixed Memory Stores long-running operations (e.g. beginUpdateMemories) failing because the required Foundry-Features header was not included in poll requests, and custom LRO terminal states ("completed", "superseded") were not mapped to standard LongRunningOperationStatus values, causing pollers to hang indefinitely.
Fixed request parameter name from "agent" to "agent_reference" in ResponsesClient and ResponsesAsyncClient methods createWithAgent and createWithAgentConversation

Breaking Changes

Removed ContainerAppAgentDefinition class and AgentKind.CONTAINER_APP enum value. The container_app agent kind is no longer supported.
Removed CONTAINER_AGENTS_V1_PREVIEW from AgentDefinitionOptInKeys and FoundryFeaturesOptInKeys. The ContainerAgents=V1Preview feature flag is no longer valid.
Renamed computer action classes to use Param suffix and moved to implementation/models (internal):
Drag → DragParam
DragPoint → CoordParam
Move → MoveParam
Screenshot → ScreenshotParam
Scroll → ScrollParam
Type → TypeParam
Wait → WaitParam
CodeInterpreterContainerAuto renamed to AutoCodeInterpreterToolParam.
Summary renamed to SummaryTextContent and moved to implementation/models (internal).
Moved ~100 model classes from com.azure.ai.agents.models to com.azure.ai.agents.implementation.models, removing them from the public API surface. This includes InputItem and all subtypes, Annotation, output content types, and related types.
Removed public methods from MemoryStoresClient/MemoryStoresAsyncClient: searchMemoriesWithResponse and beginUpdateMemories (protocol methods accepting BinaryData), searchMemories(name, scope) (minimal convenience overload), and searchMemories/beginUpdateMemories overloads accepting List<ResponseInputItem>.
Renamed model classes for naming consistency:
AgentObjectVersions renamed to AgentDetailsVersions
OpenAIError renamed to ApiError
AzureFunctionDefinitionFunction renamed to AzureFunctionDefinitionDetails
Renamed tool classes from *Param suffix to *Parameter:
ApplyPatchToolParam renamed to ApplyPatchToolParameter
CustomGrammarFormatParam renamed to CustomGrammarFormatParameter
CustomToolParam renamed to CustomToolParameter
FunctionShellToolParam renamed to FunctionShellToolParameter
LocalShellToolParam renamed to LocalShellToolParameter
OpenApiFunctionDefinition: getDefaultParams() and setDefaultParams() renamed to getDefaultParameters() and setDefaultParameters()

AI Agents 2.0.0-beta.1 Changelog

Features Added

New MemorySearchAgent sample was added demonstrating memory search functionality
Tests for MemoryStoresClient and MemoryStoresAsyncClient
Various documentation updates
Using unified HttpClient setup for Azure specifics and openai client library wrapping methods
Added new ComputerUse samples demonstrating Computer Use tool integration (sync and async)
Added new tool models: ApplyPatchToolParam, CustomToolParam, FunctionShellToolParam, McpTool, WebSearchTool, and related types
Added HybridSearchOptions for file search configuration
Added new input item types for tool call outputs (e.g., InputItemFunctionCallOutputItemParam, InputItemComputerCallOutputItemParam, InputItemApplyPatchToolCallItemParam)
Added status enums for output items (e.g., OutputItemCodeInterpreterToolCallStatus, OutputItemFunctionToolCallStatus, OutputItemWebSearchToolCallStatus)

Bugs Fixed

Fixed base URL construction in AgentsClientBuilder to append /openai/v1 directly, removing dependency on AzureOpenAIServiceVersion and AzureUrlPathMode for URL path resolution

Breaking Changes

MemoryStoreObject was renamed to MemoryStoreDetails
Service version changed from date-based versions (V2025_05_01, V2025_05_15_PREVIEW, V2025_11_15_PREVIEW) to V1
ListAgentsRequestOrder was renamed to PageOrder
Widespread model renaming to align with the latest API spec. Key patterns include:
Tool classes renamed to use Tool or PreviewTool suffix (e.g., AzureAISearchAgentTool → AzureAISearchTool, BingGroundingAgentTool → BingGroundingTool, SharepointAgentTool → SharepointPreviewTool, MemorySearchTool → MemorySearchPreviewTool)
Computer action classes simplified (e.g., ComputerActionClick → ClickParam, ComputerActionScroll → Scroll, ComputerActionScreenshot → Screenshot, ComputerActionKeyPress → KeyPressAction)
Item content classes renamed (e.g., ItemContentInputText → InputContentInputTextContent, ItemContentOutputText → OutputMessageContentOutputTextContent, ItemContentRefusal → OutputMessageContentRefusalContent)
Tool call item param classes renamed to InputItem* pattern (e.g., FunctionToolCallItemParam → InputItemFunctionToolCall, ComputerToolCallItemParam → InputItemComputerToolCall)
Annotation classes renamed (e.g., AnnotationFileCitation → FileCitationBody, AnnotationUrlCitation → UrlCitationBody, AnnotationFilePath → FilePath)
Error renamed to OpenAIError
DeleteMemoryStoreResponse renamed to DeleteMemoryStoreResult
ImageGenToolSize enum values renamed (e.g., SIZE_1024X1024 → RESOLUTION_1024_X_1024)
Several models were removed: AgentId, ImageBasedHostedAgentDefinition, MCPTool, MCPToolAllowedTools, MCPToolRequireApprovalAlways, MCPToolRequireApprovalNever, ResponsesMessageItemParam and its role-specific subclasses
ItemReferenceItemParam and ResponsesMessageRole moved to internal implementation package

AI Projects 2.0.0-beta.2 Changelog

Breaking Changes

Renamed Index model to AIProjectIndex across the SDK; all IndexesClient and IndexesAsyncClient methods now use AIProjectIndex instead of Index
Replaced DayOfWeek custom enum (com.azure.ai.projects.models.DayOfWeek) with the JDK standard java.time.DayOfWeek in WeeklyRecurrenceSchedule
Removed CONTAINER_AGENTS_V1_PREVIEW, HOSTED_AGENTS_V1_PREVIEW, and WORKFLOW_AGENTS_V1_PREVIEW constants from FoundryFeaturesOptInKeys (agent-specific feature flags moved to azure-ai-agents)

AI Projects 2.0.0-beta.1 Changelog

Features Added

Added getOpenAIClient methods to obtain an instance of the Stainless OpenAI client
Added documentation on how to get an AgentsClient
Added buildOpenAIClient() and buildOpenAIAsyncClient() methods to AIProjectClientBuilder for directly obtaining an OpenAI client instance
Added FoundryFeaturesOptInKeys enum for preview feature opt-in flags (e.g., EVALUATIONS_V1_PREVIEW, SCHEDULES_V1_PREVIEW, RED_TEAMS_V1_PREVIEW, INSIGHTS_V1_PREVIEW, MEMORY_STORES_V1_PREVIEW)
Added ModelSamplingParams and AzureAIModelTarget models

Bugs Fixed

Fixed base URL construction in AIProjectClientBuilder to append /openai/v1 directly, removing dependency on AzureOpenAIServiceVersion and AzureUrlPathMode for URL path resolution

Breaking Changes

Updated service version from 2025-11-15-preview to v1
Renamed AgenticIdentityCredentials to AgenticIdentityPreviewCredentials
Renamed AgentClusterInsightsRequest to AgentClusterInsightRequest
ConnectionType.REMOTE_TOOL value changed to RemoteTool_Preview
CredentialType.AGENTIC_IDENTITY renamed to AGENTIC_IDENTITY_PREVIEW
ConnectionType.APIKEY renamed to API_KEY
EvaluationsClient.getOpenAIClient() renamed to getEvalService()
BlobReference.getBlobUri() renamed to getBlobUrl()
HumanEvaluationRuleAction renamed to HumanEvaluationPreviewRuleAction
EvaluationComparisonRequest renamed to EvaluationComparisonInsightRequest; EvaluationCompareReport renamed to EvaluationComparisonInsightResult
EvaluationRunClusterInsightsRequest renamed to EvaluationRunClusterInsightRequest
Credential model classes dropped the plural suffix (e.g., ApiKeyCredentials → ApiKeyCredential, EntraIdCredentials → EntraIdCredential, SasCredentials → SasCredential, BaseCredentials → BaseCredential, NoAuthenticationCredentials → NoAuthenticationCredential)
Methods across sub-clients were renamed to include the resource name for disambiguation:
DeploymentsClient: get() → getDeployment(), list() → listDeployments()
InsightsClient: generate() → generateInsight(), get() → getInsight(), list() → listInsights()
RedTeamsClient: get() → getRedTeam(), list() → listRedTeams(), create() → createRedTeamRun()
SchedulesClient: delete() → deleteSchedule(), createOrUpdate() → createOrUpdateSchedule(), getRun() → getScheduleRun(), listRuns() → listScheduleRuns()
EvaluationRulesClient: get() → getEvaluationRule(), list() → listEvaluationRules(), delete() → deleteEvaluationRule(), createOrUpdate() → createOrUpdateEvaluationRule()
EvaluationTaxonomiesClient: get() → getEvaluationTaxonomy(), list() → listEvaluationTaxonomies(), create() → createEvaluationTaxonomy(), update() → updateEvaluationTaxonomy(), delete() → deleteEvaluationTaxonomy()
IndexesClient: createOrUpdate() → createOrUpdateVersion()
DatasetsClient: listLatest() → listLatestVersion()

Azure Blob Storage Checkpoint Store 1.21.4 Changelog

Other Changes

Dependency Updates

Upgraded azure-storage-blob from 12.33.0 to version 12.33.2.
Upgraded azure-messaging-eventhubs from 5.21.3 to version 5.22.0-beta.1.

Communication Call Automation 1.6.1 Changelog

Other Changes

Dependency Updates

Upgraded azure-communication-common from 1.4.4 to version 1.4.5.

Compute Batch 1.0.0-beta.6 Changelog

Features Added

Added Models:
Added BatchJobDefaultOrder
Added BatchPoolIdentityReference
Added DiskCustomerManagedKey
Added DiskEncryptionSetParameters
Added HostEndpointSettings
Added HostEndpointSettingsModeTypes
Added IPFamily
Added IpTag
Added ProxyAgentSettings
Added Properties:
Added ipv6Address to BatchNode
Added Ipv6RemoteLoginIpAddress and Ipv6RemoteLoginPort to BatchNodeRemoteLoginSettings
Added IpFamilies and IpTags to BatchPublicAddressConfiguration
Added JobDefaultOder to BatchTaskSchedulingPolicy
Added ManagedDisk to DataDisk
Added CustomerManagedKey to DiskEncryptionConfiguration
Added DiskEncryptionSet to ManagedDisk
Added DiskWithVMGuestStateValue to SecurityEncryptionTypes
Added ProxyAgentSetting to SecurityProfile

Breaking Changes

Removed Certificate operations and properties
createCertificate
getCertificate
listCertificates
beginDeleteCertificate
cancelCertificateDeletion Please migrate to use Azure Key Vault. For more information, see Migrate Batch account certificates to Azure Key Vault
Removed models:
BatchCertificate
BatchCertificateDeleteError
BatchCertificateFormat
BatchCertificateReference
BatchCertificateState
BatchCertificateStoreLocation
BatchCertificateVisibility
BatchNodeCommunicationMode Transition Batch pools to the Simplified compute node communication model
Removed properties:
Removed CertificateReferences from BatchNode
Removed ResourceTags and CertificateReferences from BatchPool
Removed CertificateReferences, ResourceTags, and TargetNodeCommunicationMode from BatchPoolCreateOptions
Removed CertificateReferences and TargetNodeCommunicationMode from BatchPoolReplaceOptions
Removed CertificateReferences, ResourceTags, and TargetNodeCommunicationMode from BatchPoolSpecifications
Removed CertificateReferences, ResourceTags, and TargetNodeCommunicationMode from BatchPoolUpdateOptions
Removed CertificateReferences, ResourceTags, and TargetNodeCommunicationMode from ComputeBatchModelFactory

Content Understanding 1.0.0 Changelog

Features Added

Initial GA release of the Azure Content Understanding client library for Java.
Support for creating, getting, listing, and deleting analyzers.
Support for analyzing content with beginAnalyze long-running operations.
Support for getting and deleting analysis results.
Synchronous and asynchronous client support via ContentUnderstandingClient and ContentUnderstandingAsyncClient.
Builder pattern for client construction with ContentUnderstandingClientBuilder.

Cosmos Spark 3.4 4.45.0 Changelog

Features Added

Added vectorEmbeddingPolicy support in Spark catalog TBLPROPERTIES for creating vector-search-enabled containers. - See PR 48349

Cosmos Spark 3.4 4.44.2 Changelog

Other Changes

Changed azure-resourcemanager-cosmos usage to a pinned version which is deployed across all public and non-public clouds - PR 48268

Cosmos Spark 3.4 4.44.1 Changelog

Other Changes

Reduced noisy warning logs in Gateway mode - PR 48189

Cosmos Spark 3.4 4.44.0 Changelog

Features Added

Added config entry spark.cosmos.account.azureEnvironment.management.scope to allow specifying the Entra ID scope/audience to be used when retrieving tokens to authenticate against the ARM/management endpoint of non-public clouds. - See PR 48137

Cosmos Spark 3.4 4.43.1 Changelog

Bugs Fixed

Fixed an issue where TransientIOErrorsRetryingIterator would trigger extra query during retries and on close. - See PR 47996

Cosmos Spark 3.5 4.45.0 Changelog

Features Added

Added vectorEmbeddingPolicy support in Spark catalog TBLPROPERTIES for creating vector-search-enabled containers. - See PR 48349

Cosmos Spark 3.5 4.44.2 Changelog

Other Changes

Changed azure-resourcemanager-cosmos usage to a pinned version which is deployed across all public and non-public clouds - PR 48268

Cosmos Spark 3.5 4.44.1 Changelog

Other Changes

Reduced noisy warning logs in Gateway mode - PR 48189

Cosmos Spark 3.5 4.44.0 Changelog

Features Added

Added config entry spark.cosmos.account.azureEnvironment.management.scope to allow specifying the Entra ID scope/audience to be used when retrieving tokens to authenticate against the ARM/management endpoint of non-public clouds. - See PR 48137

Cosmos Spark 3.5 4.43.1 Changelog

Bugs Fixed

Fixed an issue where TransientIOErrorsRetryingIterator would trigger extra query during retries and on close. - See PR 47996

Cosmos Spark 3.5 4.45.0 Changelog

Features Added

Added vectorEmbeddingPolicy support in Spark catalog TBLPROPERTIES for creating vector-search-enabled containers. - See PR 48349

Cosmos Spark 3.5 4.44.2 Changelog

Other Changes

Changed azure-resourcemanager-cosmos usage to a pinned version which is deployed across all public and non-public clouds - PR 48268

Cosmos Spark 3.5 4.44.1 Changelog

Other Changes

Reduced noisy warning logs in Gateway mode - PR 48189

Cosmos Spark 3.5 4.44.0 Changelog

Features Added

Added config entry spark.cosmos.account.azureEnvironment.management.scope to allow specifying the Entra ID scope/audience to be used when retrieving tokens to authenticate against the ARM/management endpoint of non-public clouds. - See PR 48137

Cosmos Spark 3.5 4.43.1 Changelog

Bugs Fixed

Fixed an issue where TransientIOErrorsRetryingIterator would trigger extra query during retries and on close. - See PR 47996

Cosmos Spark 4.0 4.45.0 Changelog

Features Added

Added vectorEmbeddingPolicy support in Spark catalog TBLPROPERTIES for creating vector-search-enabled containers. - See PR 48349

Cosmos Spark 4.0 4.44.2 Changelog

Other Changes

Changed azure-resourcemanager-cosmos usage to a pinned version which is deployed across all public and non-public clouds - PR 48268

Cosmos Spark 4.0 4.44.1 Changelog

Other Changes

Reduced noisy warning logs in Gateway mode - PR 48189

Cosmos Spark 4.0 4.44.0 Changelog

Features Added

Added config entry spark.cosmos.account.azureEnvironment.management.scope to allow specifying the Entra ID scope/audience to be used when retrieving tokens to authenticate against the ARM/management endpoint of non-public clouds. - See PR 48137

Cosmos Spark 4.0 4.43.1 Changelog

Bugs Fixed

Fixed an issue where TransientIOErrorsRetryingIterator would trigger extra query during retries and on close. - See PR 47996

Identity 1.19.0-beta.2 Changelog

Bugs Fixed

Fixed NullPointerException in IdentityClientOptions when running in GraalVM native images (e.g., Quarkus applications). Replaced reflection-dependent AzureIdentityEnvVars enum usage with direct string literal to ensure compatibility with native compilation.
Fixed logging for token authentication errors to include full stack traces with inner exceptions. Previously, error logs referenced “inner exceptions” but only logged the error message, making debugging difficult.

Breaking Changes

Renamed enableAzureTokenProxy() method in WorkloadIdentityCredentialBuilder to enableAzureProxy(). These changes only affect code written against beta version 1.19.0-beta.1.

OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API 4.45.0 Changelog

Features Added

Added vectorEmbeddingPolicy support in Spark catalog TBLPROPERTIES for creating vector-search-enabled containers. - See PR 48349

OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API 4.44.2 Changelog

Other Changes

Changed azure-resourcemanager-cosmos usage to a pinned version which is deployed across all public and non-public clouds - PR 48268

OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API 4.44.1 Changelog

Other Changes

Reduced noisy warning logs in Gateway mode - PR 48189

OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API 4.44.0 Changelog

Features Added

Added config entry spark.cosmos.account.azureEnvironment.management.scope to allow specifying the Entra ID scope/audience to be used when retrieving tokens to authenticate against the ARM/management endpoint of non-public clouds. - See PR 48137

OLTP Spark 3.3 Connector for Azure Cosmos DB SQL API 4.43.1 Changelog

Bugs Fixed

Fixed an issue where TransientIOErrorsRetryingIterator would trigger extra query during retries and on close. - See PR 47996

Resource Management 2.60.0 Changelog

Resource Management - Commerce 1.0.0-beta.3 Changelog

Resource Management - Compute 2.56.2 Changelog

Resource Management - Computebulkactions 1.0.0-beta.1 Changelog

Resource Management - Connected Cache 1.0.0-beta.2 Changelog

Resource Management - Container Instances 2.53.8 Changelog

Resource Management - Cosmos DB for PostgreSQL 1.1.0-beta.3 Changelog

Resource Management - Disconnected Operations 1.0.0 Changelog

Resource Management - Durable Task 1.1.0 Changelog

Resource Management - Elastic 1.2.0 Changelog

Resource Management - Elastic SAN 1.2.0 Changelog

Resource Management - Maintenance 1.1.0-beta.3 Changelog

Resource Management - Managed Ops 1.0.0-beta.2 Changelog

Resource Management - Managed Ops 1.0.0-beta.1 Changelog

Resource Management - NetApp Files 2.1.0 Changelog

Resource Management - Network Function 1.0.0 Changelog

Resource Management - New Relic Observability 1.3.0-beta.2 Changelog

Resource Management - PostgreSQL Flexible Server 2.1.0-beta.1 Changelog

Resource Management - Power BI Dedicated 1.1.0 Changelog

Resource Management - Provider Hub 2.1.0 Changelog

Resource Management - Self Help 1.1.0-beta.6 Changelog

Resource Management - Service Fabric Managed Clusters 1.1.0 Changelog

SDK - Bill of Materials 1.3.5 Changelog

Dependency Updates

Updated Azure SDK dependency versions to the latest releases.
Added a new libary entry to the BOM:
azure-ai-contentunderstanding

Storage - Blobs 12.34.0-beta.1 Changelog

Features Added

Added support for specifying a source customer-provided encryption key when using AppendBlobClient.appendBlockFromUrl(), BlockBlobClient.stageBlockFromUrl(), BlockBlobClient.uploadFromUrl(), and PageBlobClient.uploadPagesFromUrl() APIs.
Added support for AccessTierIfModifiedSince and AccessTierIfUnmodifiedSince to conditionally perform BlobClient.delete operations.
Added support for missing SKU names STANDARD_GZRS, STANDARD_RAGZRS and PREMIUM_ZRS when using getAccountInfo() API.
Added support for error code INCREMENTAL_COPY_OF_EARLIER_SNAPSHOT_NOT_ALLOWED. This replaces INCREMENTAL_COPY_OF_EARLIER_VERSION_SNAPSHOT_NOT_ALLOWED which has been deprecated.
Added support for Dynamic User Delegation SAS.
Added cross-tenant support for principal bound delegation SAS.
Added support for service version 2026-04-06.

Storage - Blobs Batch 12.29.2 Changelog

Other Changes

Dependency Updates

Upgraded azure-storage-blob from 12.33.1 to version 12.34.0-beta.2.

Storage - Blobs Batch 12.30.0-beta.1 Changelog

Features Added

Added support for service version 2026-04-06.

Storage - Blobs Changefeed 12.0.0-beta.35 Changelog

Features Added

Added support for service version 2026-04-06.

Storage - Blobs Cryptography 12.32.2 Changelog

Other Changes

Dependency Updates

Upgraded azure-storage-blob from 12.33.1 to version 12.34.0-beta.2.

Storage - Blobs Cryptography 12.33.0-beta.1 Changelog

Features Added

Added support for service version 2026-04-06.

Storage - Blobs NIO 12.0.0-beta.36 Changelog

Features Added

Added support for service version 2026-04-06.

Storage - Common 12.33.0-beta.1 Changelog

Features Added

Added support for service version 2026-04-06.

Storage - Files Data Lake 12.27.0-beta.1 Changelog

Features Added

Added support for Dynamic User Delegation SAS.
Added cross-tenant support for principal bound delegation SAS.
Added support for service version 2026-04-06.

Features Added

Added support for improved error handling for file share provisioning.
Added cross-tenant support for principal bound delegation SAS.
Added support for service version 2026-04-06.

Storage - Internal Avro 12.18.2 Changelog

Other Changes

Dependency Updates

Upgraded azure-storage-common from 12.32.1 to version 12.33.0-beta.2.

Storage - Internal Avro 12.19.0-beta.1 Changelog

Features Added

Added support for service version 2026-04-06.

Storage - Queues 12.29.0-beta.1 Changelog

Features Added

Added cross-tenant support for principal bound delegation SAS.
Added support for service version 2026-04-06.

Voice Live 1.0.0-beta.5 Changelog

Features Added

Added AgentSessionConfig class for configuring Azure AI Foundry agent sessions:
Constructor takes required agentName and projectName parameters
Fluent setters for optional parameters: setAgentVersion(), setConversationId(), setAuthenticationIdentityClientId(), setFoundryResourceOverride()
toQueryParameters() method for converting configuration to WebSocket query parameters
Added new startSession(AgentSessionConfig) overload to VoiceLiveAsyncClient for connecting directly to Azure AI Foundry agents
Added startSession(AgentSessionConfig, VoiceLiveRequestOptions) overload for agent sessions with custom request options
Added Scene class for configuring avatar’s zoom level, position, rotation and movement amplitude in the video frame
Added scene property to AvatarConfiguration for avatar scene configuration
Added outputAuditAudio property to AvatarConfiguration to enable audit audio forwarding via WebSocket for review/debugging purposes
Added ServerEventWarning and ServerEventWarningDetails classes for non-interrupting warning events
Added ServerEventType.WARNING enum value
Added interim response configuration for handling latency and tool calls (replaces filler response):
InterimResponseConfigBase base class for interim response configurations
StaticInterimResponseConfig for static/random text interim responses
LlmInterimResponseConfig for LLM-generated context-aware interim responses
InterimResponseConfigType enum (static_interim_response, llm_interim_response)
InterimResponseTrigger enum for trigger conditions (latency, tool)
Added interimResponse property to VoiceLiveSessionOptions and VoiceLiveSessionResponse

Breaking Changes

Changed token authentication scope from https://cognitiveservices.azure.com/.default to https://ai.azure.com/.default
Removed FoundryAgentTool class - use AgentSessionConfig with startSession(AgentSessionConfig) for direct agent connections instead
Removed FoundryAgentContextType enum
Removed ResponseFoundryAgentCallItem class
Removed Foundry agent call lifecycle server events: ServerEventResponseFoundryAgentCallArgumentsDelta, ServerEventResponseFoundryAgentCallArgumentsDone, ServerEventResponseFoundryAgentCallInProgress, ServerEventResponseFoundryAgentCallCompleted, ServerEventResponseFoundryAgentCallFailed
Removed ItemType.FOUNDRY_AGENT_CALL enum value
Removed ToolType.FOUNDRY_AGENT enum value
Removed ServerEventType.MCP_APPROVAL_REQUEST and ServerEventType.MCP_APPROVAL_RESPONSE enum values
Renamed filler response API to interim response:
FillerResponseConfigBase → InterimResponseConfigBase
BasicFillerResponseConfig → StaticInterimResponseConfig
LlmFillerResponseConfig → LlmInterimResponseConfig
FillerResponseConfigType → InterimResponseConfigType
FillerTrigger → InterimResponseTrigger
VoiceLiveSessionOptions.getFillerResponse()/setFillerResponse() → getInterimResponse()/setInterimResponse()
Type values changed: static_filler → static_interim_response, llm_filler → llm_interim_response

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>com.azure+azure-ai-agents</artifactId>
  <version>2.0.0-beta.2</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-ai-agents</artifactId>
  <version>2.0.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-ai-contentunderstanding</artifactId>
  <version>1.0.0</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-ai-projects</artifactId>
  <version>2.0.0-beta.2</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-ai-projects</artifactId>
  <version>2.0.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-ai-voicelive</artifactId>
  <version>1.0.0-beta.5</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-communication-callautomation</artifactId>
  <version>1.6.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-compute-batch</artifactId>
  <version>1.0.0-beta.6</version>
</dependency>

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

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-messaging-eventhubs-checkpointstore-blob</artifactId>
  <version>1.21.4</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-sdk-bom</artifactId>
  <version>1.3.5</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob</artifactId>
  <version>12.34.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob-batch</artifactId>
  <version>12.29.2</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob-batch</artifactId>
  <version>12.30.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob-changefeed</artifactId>
  <version>12.0.0-beta.35</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob-cryptography</artifactId>
  <version>12.32.2</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob-cryptography</artifactId>
  <version>12.33.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-blob-nio</artifactId>
  <version>12.0.0-beta.36</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-common</artifactId>
  <version>12.33.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-file-datalake</artifactId>
  <version>12.27.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-file-share</artifactId>
  <version>12.30.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-internal-avro</artifactId>
  <version>12.18.2</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-internal-avro</artifactId>
  <version>12.19.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>com.azure+azure-storage-queue</artifactId>
  <version>12.29.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-3_2-12</artifactId>
  <version>4.45.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-3_2-12</artifactId>
  <version>4.44.2</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-3_2-12</artifactId>
  <version>4.44.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-3_2-12</artifactId>
  <version>4.44.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-3_2-12</artifactId>
  <version>4.43.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-4_2-12</artifactId>
  <version>4.45.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-4_2-12</artifactId>
  <version>4.44.2</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-4_2-12</artifactId>
  <version>4.44.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-4_2-12</artifactId>
  <version>4.44.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-4_2-12</artifactId>
  <version>4.43.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-12</artifactId>
  <version>4.45.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-12</artifactId>
  <version>4.44.2</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-12</artifactId>
  <version>4.44.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-12</artifactId>
  <version>4.44.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-12</artifactId>
  <version>4.43.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-13</artifactId>
  <version>4.45.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-13</artifactId>
  <version>4.44.2</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-13</artifactId>
  <version>4.44.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-13</artifactId>
  <version>4.44.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_3-5_2-13</artifactId>
  <version>4.43.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_4-0_2-13</artifactId>
  <version>4.45.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_4-0_2-13</artifactId>
  <version>4.44.2</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_4-0_2-13</artifactId>
  <version>4.44.1</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_4-0_2-13</artifactId>
  <version>4.44.0</version>
</dependency>

<dependency>
  <groupId>com.azure.cosmos.spark</groupId>
  <artifactId>com.azure.cosmos.spark+azure-cosmos-spark_4-0_2-13</artifactId>
  <version>4.43.1</version>
</dependency>

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

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-commerce</artifactId>
  <version>1.0.0-beta.3</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-compute</artifactId>
  <version>2.56.2</version>
</dependency>

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

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-connectedcache</artifactId>
  <version>1.0.0-beta.2</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-containerinstance</artifactId>
  <version>2.53.8</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-cosmosdbforpostgresql</artifactId>
  <version>1.1.0-beta.3</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-disconnectedoperations</artifactId>
  <version>1.0.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-durabletask</artifactId>
  <version>1.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-elastic</artifactId>
  <version>1.2.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-elasticsan</artifactId>
  <version>1.2.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-maintenance</artifactId>
  <version>1.1.0-beta.3</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-managedops</artifactId>
  <version>1.0.0-beta.2</version>
</dependency>

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

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-netapp</artifactId>
  <version>2.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-networkfunction</artifactId>
  <version>1.0.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-newrelicobservability</artifactId>
  <version>1.3.0-beta.2</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-postgresqlflexibleserver</artifactId>
  <version>2.1.0-beta.1</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-powerbidedicated</artifactId>
  <version>1.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-providerhub</artifactId>
  <version>2.1.0</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-selfhelp</artifactId>
  <version>1.1.0-beta.6</version>
</dependency>

<dependency>
  <groupId>com.azure.resourcemanager</groupId>
  <artifactId>com.azure.resourcemanager+azure-resourcemanager-servicefabricmanagedclusters</artifactId>
  <version>1.1.0</version>
</dependency>

Feedback

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