diff --git a/docs-ref-mapping/reference-unified.yml b/docs-ref-mapping/reference-unified.yml
index 6d2e92f444240..4f4e48b900ce5 100644
--- a/docs-ref-mapping/reference-unified.yml
+++ b/docs-ref-mapping/reference-unified.yml
@@ -1550,7 +1550,6 @@
href: ~/docs-ref-services/{moniker}/messaging-eventgrid-readme.md
children:
- com.azure.messaging.eventgrid
- - com.azure.messaging.eventgrid.models
- com.azure.messaging.eventgrid.systemevents
- name: CloudNative CloudEvents with Event Grid (deprecated)
href: ~/docs-ref-services/{moniker}/messaging-eventgrid-cloudnative-cloudevents-readme.md
@@ -1564,10 +1563,8 @@
- name: System Events
href: ~/docs-ref-services/{moniker}/messaging-eventgrid-systemevents-readme.md
children:
- - com.azure.messaging.eventgrid
- com.azure.messaging.eventgrid.systemevents
- com.azure.messaging.eventgrid.systemevents.models
- - com.azure.messaging.eventgrid
- com.azure.messaging.eventgrid.systemevents
- com.azure.messaging.eventgrid.systemevents.models
- name: Management
@@ -2714,6 +2711,16 @@
children:
- com.azure.monitor.query
- com.azure.monitor.query.models
+ - name: Monitor Query Logs
+ href: ~/docs-ref-services/{moniker}/monitor-query-logs-readme.md
+ children:
+ - com.azure.monitor.query.logs
+ - com.azure.monitor.query.logs.models
+ - name: Monitor Query Metrics
+ href: ~/docs-ref-services/{moniker}/monitor-query-metrics-readme.md
+ children:
+ - com.azure.monitor.query.metrics
+ - com.azure.monitor.query.metrics.models
- name: OpenTelemetry Exporter (deprecated)
href: ~/docs-ref-services/{moniker}/opentelemetry-exporter-azuremonitor-readme.md
children:
diff --git a/docs-ref-services/latest/advisor.md b/docs-ref-services/latest/advisor.md
index aade2c553dd0f..ba593367eeda5 100644
--- a/docs-ref-services/latest/advisor.md
+++ b/docs-ref-services/latest/advisor.md
@@ -1,7 +1,7 @@
---
title: Azure Advisor SDK for Java
description: Reference for Azure Advisor SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: advisor
diff --git a/docs-ref-services/latest/api-center.md b/docs-ref-services/latest/api-center.md
index dc5c232792c78..25de2f80147c5 100644
--- a/docs-ref-services/latest/api-center.md
+++ b/docs-ref-services/latest/api-center.md
@@ -1,7 +1,7 @@
---
title: Azure API Center SDK for Java
description: Reference for Azure API Center SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: apicenter
diff --git a/docs-ref-services/latest/api-management.md b/docs-ref-services/latest/api-management.md
index 34c46d6614ba4..bcc002ce8be8d 100644
--- a/docs-ref-services/latest/api-management.md
+++ b/docs-ref-services/latest/api-management.md
@@ -1,7 +1,7 @@
---
title: Azure API Management SDK for Java
description: Reference for Azure API Management SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: apimanagement
diff --git a/docs-ref-services/latest/app-compliance-automation.md b/docs-ref-services/latest/app-compliance-automation.md
index 5c0961bf39940..1a648086fb976 100644
--- a/docs-ref-services/latest/app-compliance-automation.md
+++ b/docs-ref-services/latest/app-compliance-automation.md
@@ -1,7 +1,7 @@
---
title: Azure App Compliance Automation SDK for Java
description: Reference for Azure App Compliance Automation SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: appcomplianceautomation
diff --git a/docs-ref-services/latest/app-configuration.md b/docs-ref-services/latest/app-configuration.md
index 374adea4730b2..6422a0ef5948b 100644
--- a/docs-ref-services/latest/app-configuration.md
+++ b/docs-ref-services/latest/app-configuration.md
@@ -1,7 +1,7 @@
---
title: Azure App Configuration SDK for Java
description: Reference for Azure App Configuration SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: appconfiguration
diff --git a/docs-ref-services/latest/app-service.md b/docs-ref-services/latest/app-service.md
index 121502e2aa305..3591551403ed5 100644
--- a/docs-ref-services/latest/app-service.md
+++ b/docs-ref-services/latest/app-service.md
@@ -1,7 +1,7 @@
---
title: Azure App Service SDK for Java
description: Reference for Azure App Service SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: app-service
diff --git a/docs-ref-services/latest/application-insights.md b/docs-ref-services/latest/application-insights.md
index f84b2876f51ac..ed5790657e844 100644
--- a/docs-ref-services/latest/application-insights.md
+++ b/docs-ref-services/latest/application-insights.md
@@ -1,7 +1,7 @@
---
title: Azure Application Insights SDK for Java
description: Reference for Azure Application Insights SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/arc-data.md b/docs-ref-services/latest/arc-data.md
index a0c8d9b4caf4c..8cc3c3dce5da5 100644
--- a/docs-ref-services/latest/arc-data.md
+++ b/docs-ref-services/latest/arc-data.md
@@ -1,7 +1,7 @@
---
title: Azure Arc Data SDK for Java
description: Reference for Azure Arc Data SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/arize-ai.md b/docs-ref-services/latest/arize-ai.md
index 2e0cf664acc82..7a0aa3bbff522 100644
--- a/docs-ref-services/latest/arize-ai.md
+++ b/docs-ref-services/latest/arize-ai.md
@@ -1,7 +1,7 @@
---
title: Azure Arize AI SDK for Java
description: Reference for Azure Arize AI SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: arizeai
diff --git a/docs-ref-services/latest/attestation.md b/docs-ref-services/latest/attestation.md
index 9666811ed3873..d121e42d698c9 100644
--- a/docs-ref-services/latest/attestation.md
+++ b/docs-ref-services/latest/attestation.md
@@ -1,7 +1,7 @@
---
title: Azure Attestation SDK for Java
description: Reference for Azure Attestation SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: attestation
diff --git a/docs-ref-services/latest/authorization.md b/docs-ref-services/latest/authorization.md
index 6cc8c73238162..b95b08ac1a36f 100644
--- a/docs-ref-services/latest/authorization.md
+++ b/docs-ref-services/latest/authorization.md
@@ -1,7 +1,7 @@
---
title: Azure Authorization SDK for Java
description: Reference for Azure Authorization SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/automanage.md b/docs-ref-services/latest/automanage.md
index 0d6cf25ac6af9..c240d64ad4162 100644
--- a/docs-ref-services/latest/automanage.md
+++ b/docs-ref-services/latest/automanage.md
@@ -1,7 +1,7 @@
---
title: Azure Automanage SDK for Java
description: Reference for Azure Automanage SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: automanage
diff --git a/docs-ref-services/latest/automation.md b/docs-ref-services/latest/automation.md
index be66436122f3e..17a12faeb7483 100644
--- a/docs-ref-services/latest/automation.md
+++ b/docs-ref-services/latest/automation.md
@@ -1,7 +1,7 @@
---
title: Azure Automation SDK for Java
description: Reference for Azure Automation SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/azure-stack.md b/docs-ref-services/latest/azure-stack.md
index a3bad65838daa..3d1d6a74769a6 100644
--- a/docs-ref-services/latest/azure-stack.md
+++ b/docs-ref-services/latest/azure-stack.md
@@ -1,7 +1,7 @@
---
title: Azure Azure Stack SDK for Java
description: Reference for Azure Azure Stack SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/azure-vmware-solution.md b/docs-ref-services/latest/azure-vmware-solution.md
index 7874ebd581d56..522edf487a518 100644
--- a/docs-ref-services/latest/azure-vmware-solution.md
+++ b/docs-ref-services/latest/azure-vmware-solution.md
@@ -1,7 +1,7 @@
---
title: Azure Azure VMware Solution SDK for Java
description: Reference for Azure Azure VMware Solution SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azurevmwaresolution
diff --git a/docs-ref-services/latest/baremetal-infrastructure.md b/docs-ref-services/latest/baremetal-infrastructure.md
index 03a5f5a36b6dc..398b0dafe2965 100644
--- a/docs-ref-services/latest/baremetal-infrastructure.md
+++ b/docs-ref-services/latest/baremetal-infrastructure.md
@@ -1,7 +1,7 @@
---
title: Azure BareMetal Infrastructure SDK for Java
description: Reference for Azure BareMetal Infrastructure SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: baremetalinfrastructure
diff --git a/docs-ref-services/latest/batch.md b/docs-ref-services/latest/batch.md
index 4ab56e0ead364..986780c4f27ff 100644
--- a/docs-ref-services/latest/batch.md
+++ b/docs-ref-services/latest/batch.md
@@ -1,7 +1,7 @@
---
title: Azure Batch SDK for Java
description: Reference for Azure Batch SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: batch
diff --git a/docs-ref-services/latest/billing.md b/docs-ref-services/latest/billing.md
index 71549d193f2c7..c2af5516c5e8c 100644
--- a/docs-ref-services/latest/billing.md
+++ b/docs-ref-services/latest/billing.md
@@ -1,7 +1,7 @@
---
title: Azure Billing SDK for Java
description: Reference for Azure Billing SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: billing
diff --git a/docs-ref-services/latest/bot-service.md b/docs-ref-services/latest/bot-service.md
index 23b418b9efdfe..006b750337332 100644
--- a/docs-ref-services/latest/bot-service.md
+++ b/docs-ref-services/latest/bot-service.md
@@ -1,7 +1,7 @@
---
title: Azure Bot Service SDK for Java
description: Reference for Azure Bot Service SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: botservice
diff --git a/docs-ref-services/latest/carbonoptimization.md b/docs-ref-services/latest/carbonoptimization.md
index 85c6e52b12ff4..68128802c178e 100644
--- a/docs-ref-services/latest/carbonoptimization.md
+++ b/docs-ref-services/latest/carbonoptimization.md
@@ -1,7 +1,7 @@
---
title: Azure Carbonoptimization SDK for Java
description: Reference for Azure Carbonoptimization SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: carbonoptimization
diff --git a/docs-ref-services/latest/change-analysis.md b/docs-ref-services/latest/change-analysis.md
index 3978f050c7e27..3e6e9412b4add 100644
--- a/docs-ref-services/latest/change-analysis.md
+++ b/docs-ref-services/latest/change-analysis.md
@@ -1,7 +1,7 @@
---
title: Azure Change Analysis SDK for Java
description: Reference for Azure Change Analysis SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: changeanalysis
diff --git a/docs-ref-services/latest/chaos.md b/docs-ref-services/latest/chaos.md
index 081305af7953a..6540234dfcc74 100644
--- a/docs-ref-services/latest/chaos.md
+++ b/docs-ref-services/latest/chaos.md
@@ -1,7 +1,7 @@
---
title: Azure Chaos SDK for Java
description: Reference for Azure Chaos SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: chaos
diff --git a/docs-ref-services/latest/cognitive-services.md b/docs-ref-services/latest/cognitive-services.md
index f4da78694e02b..06e8b08cffe29 100644
--- a/docs-ref-services/latest/cognitive-services.md
+++ b/docs-ref-services/latest/cognitive-services.md
@@ -1,7 +1,7 @@
---
title: Azure Cognitive Services SDK for Java
description: Reference for Azure Cognitive Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cognitiveservices
diff --git a/docs-ref-services/latest/communication.md b/docs-ref-services/latest/communication.md
index 453cbe54f03d2..285f8bf7acbda 100644
--- a/docs-ref-services/latest/communication.md
+++ b/docs-ref-services/latest/communication.md
@@ -1,7 +1,7 @@
---
title: Azure Communication SDK for Java
description: Reference for Azure Communication SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: communication
diff --git a/docs-ref-services/latest/compute-fleet.md b/docs-ref-services/latest/compute-fleet.md
index 5da7751179802..6989a073eeb6b 100644
--- a/docs-ref-services/latest/compute-fleet.md
+++ b/docs-ref-services/latest/compute-fleet.md
@@ -1,7 +1,7 @@
---
title: Azure Compute Fleet SDK for Java
description: Reference for Azure Compute Fleet SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: computefleet
diff --git a/docs-ref-services/latest/compute-schedule.md b/docs-ref-services/latest/compute-schedule.md
index 29318ffce3043..081b71742db97 100644
--- a/docs-ref-services/latest/compute-schedule.md
+++ b/docs-ref-services/latest/compute-schedule.md
@@ -1,7 +1,7 @@
---
title: Azure Compute Schedule SDK for Java
description: Reference for Azure Compute Schedule SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: computeschedule
diff --git a/docs-ref-services/latest/compute.md b/docs-ref-services/latest/compute.md
index 9239bb04a2975..af520b54227c9 100644
--- a/docs-ref-services/latest/compute.md
+++ b/docs-ref-services/latest/compute.md
@@ -1,7 +1,7 @@
---
title: Azure Compute SDK for Java
description: Reference for Azure Compute SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: compute
diff --git a/docs-ref-services/latest/confidential-ledger.md b/docs-ref-services/latest/confidential-ledger.md
index 9f58569d158bd..f296e9bda4ca4 100644
--- a/docs-ref-services/latest/confidential-ledger.md
+++ b/docs-ref-services/latest/confidential-ledger.md
@@ -1,7 +1,7 @@
---
title: Azure Confidential Ledger SDK for Java
description: Reference for Azure Confidential Ledger SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: confidentialledger
diff --git a/docs-ref-services/latest/confluent.md b/docs-ref-services/latest/confluent.md
index 27119a7632a0b..ced1132ce5019 100644
--- a/docs-ref-services/latest/confluent.md
+++ b/docs-ref-services/latest/confluent.md
@@ -1,7 +1,7 @@
---
title: Azure Confluent SDK for Java
description: Reference for Azure Confluent SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: confluent
diff --git a/docs-ref-services/latest/connected-vmware.md b/docs-ref-services/latest/connected-vmware.md
index c608c3a9d601f..f12048fac23e4 100644
--- a/docs-ref-services/latest/connected-vmware.md
+++ b/docs-ref-services/latest/connected-vmware.md
@@ -1,7 +1,7 @@
---
title: Azure Connected VMware SDK for Java
description: Reference for Azure Connected VMware SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: connectedvmware
diff --git a/docs-ref-services/latest/consumption.md b/docs-ref-services/latest/consumption.md
index fa986b04d88c2..04b47fca77e8f 100644
--- a/docs-ref-services/latest/consumption.md
+++ b/docs-ref-services/latest/consumption.md
@@ -1,7 +1,7 @@
---
title: Azure Consumption SDK for Java
description: Reference for Azure Consumption SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: consumption
diff --git a/docs-ref-services/latest/container-apps.md b/docs-ref-services/latest/container-apps.md
index 4d7c2124aa874..a5e021f7e9675 100644
--- a/docs-ref-services/latest/container-apps.md
+++ b/docs-ref-services/latest/container-apps.md
@@ -1,7 +1,7 @@
---
title: Azure Container Apps SDK for Java
description: Reference for Azure Container Apps SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: containerapps
diff --git a/docs-ref-services/latest/container-instances.md b/docs-ref-services/latest/container-instances.md
index 6e71fc31263a9..4c836fdd3a77a 100644
--- a/docs-ref-services/latest/container-instances.md
+++ b/docs-ref-services/latest/container-instances.md
@@ -1,7 +1,7 @@
---
title: Azure Container Instances SDK for Java
description: Reference for Azure Container Instances SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: container-instances
diff --git a/docs-ref-services/latest/container-registry.md b/docs-ref-services/latest/container-registry.md
index a8719a22a9909..96589b86fe2bf 100644
--- a/docs-ref-services/latest/container-registry.md
+++ b/docs-ref-services/latest/container-registry.md
@@ -1,7 +1,7 @@
---
title: Azure Container Registry SDK for Java
description: Reference for Azure Container Registry SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: container-registry
diff --git a/docs-ref-services/latest/container-service-fleet.md b/docs-ref-services/latest/container-service-fleet.md
index fd2251db48c91..423e4298b84e2 100644
--- a/docs-ref-services/latest/container-service-fleet.md
+++ b/docs-ref-services/latest/container-service-fleet.md
@@ -1,7 +1,7 @@
---
title: Azure Container Service Fleet SDK for Java
description: Reference for Azure Container Service Fleet SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: containerservicefleet
diff --git a/docs-ref-services/latest/container-service.md b/docs-ref-services/latest/container-service.md
index 191c136f9562d..4f40e6c3cd0e6 100644
--- a/docs-ref-services/latest/container-service.md
+++ b/docs-ref-services/latest/container-service.md
@@ -1,10 +1,10 @@
---
title: Azure Container Service SDK for Java
description: Reference for Azure Container Service SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
-ms.service: containerservice
+ms.service: container-service
---
# Azure Container Service SDK for Java - latest
## Packages - latest
diff --git a/docs-ref-services/latest/content-delivery-network.md b/docs-ref-services/latest/content-delivery-network.md
index 23c2939c1fd8e..9e84b5cc41af3 100644
--- a/docs-ref-services/latest/content-delivery-network.md
+++ b/docs-ref-services/latest/content-delivery-network.md
@@ -1,7 +1,7 @@
---
title: Azure Content Delivery Network SDK for Java
description: Reference for Azure Content Delivery Network SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-cdn
diff --git a/docs-ref-services/latest/cosmos-db-for-postgresql.md b/docs-ref-services/latest/cosmos-db-for-postgresql.md
index 3ee54e458596c..7f2c6dec2ef26 100644
--- a/docs-ref-services/latest/cosmos-db-for-postgresql.md
+++ b/docs-ref-services/latest/cosmos-db-for-postgresql.md
@@ -1,7 +1,7 @@
---
title: Azure Cosmos DB for PostgreSQL SDK for Java
description: Reference for Azure Cosmos DB for PostgreSQL SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cosmosdbforpostgresql
diff --git a/docs-ref-services/latest/cosmos-db.md b/docs-ref-services/latest/cosmos-db.md
index 26c1cbc6e6b9f..481274583d42f 100644
--- a/docs-ref-services/latest/cosmos-db.md
+++ b/docs-ref-services/latest/cosmos-db.md
@@ -1,7 +1,7 @@
---
title: Azure Cosmos DB SDK for Java
description: Reference for Azure Cosmos DB SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cosmos-db
diff --git a/docs-ref-services/latest/cost-management.md b/docs-ref-services/latest/cost-management.md
index db7c49f47058a..18dfc7fcb07a2 100644
--- a/docs-ref-services/latest/cost-management.md
+++ b/docs-ref-services/latest/cost-management.md
@@ -1,7 +1,7 @@
---
title: Azure Cost Management SDK for Java
description: Reference for Azure Cost Management SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: costmanagement
diff --git a/docs-ref-services/latest/custom-image-search.md b/docs-ref-services/latest/custom-image-search.md
index 20b35af10860f..e9cbc7e2fa0f4 100644
--- a/docs-ref-services/latest/custom-image-search.md
+++ b/docs-ref-services/latest/custom-image-search.md
@@ -1,7 +1,7 @@
---
title: Azure Custom Image Search SDK for Java
description: Reference for Azure Custom Image Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: customimagesearch
diff --git a/docs-ref-services/latest/data-box-edge.md b/docs-ref-services/latest/data-box-edge.md
index 1b2e0b1694551..7404be7ef648a 100644
--- a/docs-ref-services/latest/data-box-edge.md
+++ b/docs-ref-services/latest/data-box-edge.md
@@ -1,7 +1,7 @@
---
title: Azure Data Box Edge SDK for Java
description: Reference for Azure Data Box Edge SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: databoxedge
diff --git a/docs-ref-services/latest/data-box.md b/docs-ref-services/latest/data-box.md
index 95e02fb6232a1..4dfa4eb379c2e 100644
--- a/docs-ref-services/latest/data-box.md
+++ b/docs-ref-services/latest/data-box.md
@@ -1,7 +1,7 @@
---
title: Azure Data Box SDK for Java
description: Reference for Azure Data Box SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: databox
diff --git a/docs-ref-services/latest/data-explorer.md b/docs-ref-services/latest/data-explorer.md
index aca13baf06682..0f422c2398bb1 100644
--- a/docs-ref-services/latest/data-explorer.md
+++ b/docs-ref-services/latest/data-explorer.md
@@ -1,7 +1,7 @@
---
title: Azure Data Explorer SDK for Java
description: Reference for Azure Data Explorer SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: dataexplorer
diff --git a/docs-ref-services/latest/data-factory.md b/docs-ref-services/latest/data-factory.md
index f3e251b51e73c..806874185474a 100644
--- a/docs-ref-services/latest/data-factory.md
+++ b/docs-ref-services/latest/data-factory.md
@@ -1,7 +1,7 @@
---
title: Azure Data Factory SDK for Java
description: Reference for Azure Data Factory SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: datafactory
diff --git a/docs-ref-services/latest/data-lake-analytics.md b/docs-ref-services/latest/data-lake-analytics.md
index c60424e511ab2..364ed222b48d5 100644
--- a/docs-ref-services/latest/data-lake-analytics.md
+++ b/docs-ref-services/latest/data-lake-analytics.md
@@ -1,12 +1,12 @@
---
title: Azure Data Lake Analytics SDK for Java
description: Reference for Azure Data Lake Analytics SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: datalakeanalytics
-manager: douge
keywords: Azure, Java, SDK, API, big data, data lake
+manager: douge
---
# Azure Data Lake Analytics libraries for Java
diff --git a/docs-ref-services/latest/data-lake-store.md b/docs-ref-services/latest/data-lake-store.md
index 1762528cbe205..f55adaf5018c0 100644
--- a/docs-ref-services/latest/data-lake-store.md
+++ b/docs-ref-services/latest/data-lake-store.md
@@ -1,7 +1,7 @@
---
title: Azure Data Lake Store SDK for Java
description: Reference for Azure Data Lake Store SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: datalakestore
diff --git a/docs-ref-services/latest/data-protection.md b/docs-ref-services/latest/data-protection.md
index e461226b9d210..d83eb33d99903 100644
--- a/docs-ref-services/latest/data-protection.md
+++ b/docs-ref-services/latest/data-protection.md
@@ -1,7 +1,7 @@
---
title: Azure Data Protection SDK for Java
description: Reference for Azure Data Protection SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: dataprotection
diff --git a/docs-ref-services/latest/database-migration-service.md b/docs-ref-services/latest/database-migration-service.md
index e1bae9839b363..27b504ce75b93 100644
--- a/docs-ref-services/latest/database-migration-service.md
+++ b/docs-ref-services/latest/database-migration-service.md
@@ -1,7 +1,7 @@
---
title: Azure Database Migration Service SDK for Java
description: Reference for Azure Database Migration Service SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: databasemigrationservice
diff --git a/docs-ref-services/latest/databricks.md b/docs-ref-services/latest/databricks.md
index 43e822826c538..1b70fa0662306 100644
--- a/docs-ref-services/latest/databricks.md
+++ b/docs-ref-services/latest/databricks.md
@@ -1,7 +1,7 @@
---
title: Azure Databricks SDK for Java
description: Reference for Azure Databricks SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: databricks
diff --git a/docs-ref-services/latest/datadog.md b/docs-ref-services/latest/datadog.md
index eaaaa90a300e9..0f2640e078391 100644
--- a/docs-ref-services/latest/datadog.md
+++ b/docs-ref-services/latest/datadog.md
@@ -1,7 +1,7 @@
---
title: Azure Datadog SDK for Java
description: Reference for Azure Datadog SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: datadog
diff --git a/docs-ref-services/latest/desktop-virtualization.md b/docs-ref-services/latest/desktop-virtualization.md
index 32936eaa144e3..81f74c1db97b7 100644
--- a/docs-ref-services/latest/desktop-virtualization.md
+++ b/docs-ref-services/latest/desktop-virtualization.md
@@ -1,7 +1,7 @@
---
title: Azure Desktop Virtualization SDK for Java
description: Reference for Azure Desktop Virtualization SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: desktopvirtualization
diff --git a/docs-ref-services/latest/dev-center.md b/docs-ref-services/latest/dev-center.md
index ce3850dddc1ca..eb0d7af021168 100644
--- a/docs-ref-services/latest/dev-center.md
+++ b/docs-ref-services/latest/dev-center.md
@@ -1,7 +1,7 @@
---
title: Azure Dev Center SDK for Java
description: Reference for Azure Dev Center SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: devcenter
diff --git a/docs-ref-services/latest/devops-infrastructure.md b/docs-ref-services/latest/devops-infrastructure.md
index 7634be00affbf..402938b0b817f 100644
--- a/docs-ref-services/latest/devops-infrastructure.md
+++ b/docs-ref-services/latest/devops-infrastructure.md
@@ -1,7 +1,7 @@
---
title: Azure DevOps Infrastructure SDK for Java
description: Reference for Azure DevOps Infrastructure SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: devopsinfrastructure
diff --git a/docs-ref-services/latest/devtest-labs.md b/docs-ref-services/latest/devtest-labs.md
index a804c289bfa2f..9b0672798901f 100644
--- a/docs-ref-services/latest/devtest-labs.md
+++ b/docs-ref-services/latest/devtest-labs.md
@@ -1,7 +1,7 @@
---
title: Azure DevTest Labs SDK for Java
description: Reference for Azure DevTest Labs SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: devtest-lab
diff --git a/docs-ref-services/latest/dns-resolver.md b/docs-ref-services/latest/dns-resolver.md
index ff7ced05995dd..9e1ee2ddcd030 100644
--- a/docs-ref-services/latest/dns-resolver.md
+++ b/docs-ref-services/latest/dns-resolver.md
@@ -1,7 +1,7 @@
---
title: Azure DNS Resolver SDK for Java
description: Reference for Azure DNS Resolver SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: dnsresolver
diff --git a/docs-ref-services/latest/dns.md b/docs-ref-services/latest/dns.md
index a446e2c5033b3..cee287d845212 100644
--- a/docs-ref-services/latest/dns.md
+++ b/docs-ref-services/latest/dns.md
@@ -1,7 +1,7 @@
---
title: Azure DNS SDK for Java
description: Reference for Azure DNS SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: dns
diff --git a/docs-ref-services/latest/dynatrace.md b/docs-ref-services/latest/dynatrace.md
index 27b37f26b5507..a774133b384f8 100644
--- a/docs-ref-services/latest/dynatrace.md
+++ b/docs-ref-services/latest/dynatrace.md
@@ -1,7 +1,7 @@
---
title: Azure Dynatrace SDK for Java
description: Reference for Azure Dynatrace SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: dynatrace
diff --git a/docs-ref-services/latest/edge-order.md b/docs-ref-services/latest/edge-order.md
index fdfe7cb3faa31..1fc64f59a5286 100644
--- a/docs-ref-services/latest/edge-order.md
+++ b/docs-ref-services/latest/edge-order.md
@@ -1,7 +1,7 @@
---
title: Azure Edge Order SDK for Java
description: Reference for Azure Edge Order SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: edgeorder
diff --git a/docs-ref-services/latest/elastic-san.md b/docs-ref-services/latest/elastic-san.md
index 3ec7234c3c80d..0b04d0b5acdf6 100644
--- a/docs-ref-services/latest/elastic-san.md
+++ b/docs-ref-services/latest/elastic-san.md
@@ -1,7 +1,7 @@
---
title: Azure Elastic SAN SDK for Java
description: Reference for Azure Elastic SAN SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: elasticsan
diff --git a/docs-ref-services/latest/elastic.md b/docs-ref-services/latest/elastic.md
index 5ff59abfb1eaa..16230cc2139b4 100644
--- a/docs-ref-services/latest/elastic.md
+++ b/docs-ref-services/latest/elastic.md
@@ -1,7 +1,7 @@
---
title: Azure Elastic SDK for Java
description: Reference for Azure Elastic SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: elastic
diff --git a/docs-ref-services/latest/event-grid.md b/docs-ref-services/latest/event-grid.md
index c66f7979af3b7..68b66114df988 100644
--- a/docs-ref-services/latest/event-grid.md
+++ b/docs-ref-services/latest/event-grid.md
@@ -1,7 +1,7 @@
---
title: Azure Event Grid SDK for Java
description: Reference for Azure Event Grid SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: eventgrid
diff --git a/docs-ref-services/latest/event-hubs.md b/docs-ref-services/latest/event-hubs.md
index 9f4d0c6ffa06d..89b0e09a79abe 100644
--- a/docs-ref-services/latest/event-hubs.md
+++ b/docs-ref-services/latest/event-hubs.md
@@ -1,7 +1,7 @@
---
title: Azure Event Hubs SDK for Java
description: Reference for Azure Event Hubs SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-event-hubs
diff --git a/docs-ref-services/latest/extended-location.md b/docs-ref-services/latest/extended-location.md
index 10a569c1e7085..fa51073bd1063 100644
--- a/docs-ref-services/latest/extended-location.md
+++ b/docs-ref-services/latest/extended-location.md
@@ -1,7 +1,7 @@
---
title: Azure Extended Location SDK for Java
description: Reference for Azure Extended Location SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: extendedlocation
diff --git a/docs-ref-services/latest/fabric.md b/docs-ref-services/latest/fabric.md
index 567da19200e7a..d9a683f119592 100644
--- a/docs-ref-services/latest/fabric.md
+++ b/docs-ref-services/latest/fabric.md
@@ -1,7 +1,7 @@
---
title: Azure Fabric SDK for Java
description: Reference for Azure Fabric SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: fabric
diff --git a/docs-ref-services/latest/fluid-relay.md b/docs-ref-services/latest/fluid-relay.md
index d8ca342645fe1..7165c611f9c43 100644
--- a/docs-ref-services/latest/fluid-relay.md
+++ b/docs-ref-services/latest/fluid-relay.md
@@ -1,7 +1,7 @@
---
title: Azure Fluid Relay SDK for Java
description: Reference for Azure Fluid Relay SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: fluidrelay
diff --git a/docs-ref-services/latest/front-door.md b/docs-ref-services/latest/front-door.md
index 6afc2bd6ad5e8..ef08ea652f243 100644
--- a/docs-ref-services/latest/front-door.md
+++ b/docs-ref-services/latest/front-door.md
@@ -1,7 +1,7 @@
---
title: Azure Front Door SDK for Java
description: Reference for Azure Front Door SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: frontdoor
diff --git a/docs-ref-services/latest/functions.md b/docs-ref-services/latest/functions.md
index 5955cc7984881..070db8270ca71 100644
--- a/docs-ref-services/latest/functions.md
+++ b/docs-ref-services/latest/functions.md
@@ -1,7 +1,7 @@
---
title: Azure Functions SDK for Java
description: Reference for Azure Functions SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: functions
diff --git a/docs-ref-services/latest/grafana.md b/docs-ref-services/latest/grafana.md
index 16ca03ec2fe2c..5cd2c68e74d2f 100644
--- a/docs-ref-services/latest/grafana.md
+++ b/docs-ref-services/latest/grafana.md
@@ -1,7 +1,7 @@
---
title: Azure Grafana SDK for Java
description: Reference for Azure Grafana SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: grafana
diff --git a/docs-ref-services/latest/graph-services.md b/docs-ref-services/latest/graph-services.md
index ead5226bb035a..723841713bfef 100644
--- a/docs-ref-services/latest/graph-services.md
+++ b/docs-ref-services/latest/graph-services.md
@@ -1,7 +1,7 @@
---
title: Azure Graph Services SDK for Java
description: Reference for Azure Graph Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: graphservices
diff --git a/docs-ref-services/latest/hardware-security-module.md b/docs-ref-services/latest/hardware-security-module.md
index 2ab2fcda9a0f1..abceddce44dcc 100644
--- a/docs-ref-services/latest/hardware-security-module.md
+++ b/docs-ref-services/latest/hardware-security-module.md
@@ -1,7 +1,7 @@
---
title: Azure Hardware Security Module SDK for Java
description: Reference for Azure Hardware Security Module SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hardwaresecuritymodule
diff --git a/docs-ref-services/latest/hdinsight.md b/docs-ref-services/latest/hdinsight.md
index 8505f5a0b0004..b4b2ba2655aef 100644
--- a/docs-ref-services/latest/hdinsight.md
+++ b/docs-ref-services/latest/hdinsight.md
@@ -1,7 +1,7 @@
---
title: Azure HDInsight SDK for Java
description: Reference for Azure HDInsight SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hdinsight
diff --git a/docs-ref-services/latest/health-bot.md b/docs-ref-services/latest/health-bot.md
index 6d917f0566a3b..af8beb3d67baf 100644
--- a/docs-ref-services/latest/health-bot.md
+++ b/docs-ref-services/latest/health-bot.md
@@ -1,7 +1,7 @@
---
title: Azure Health Bot SDK for Java
description: Reference for Azure Health Bot SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-ai-health-bot
diff --git a/docs-ref-services/latest/health-data-ai-services.md b/docs-ref-services/latest/health-data-ai-services.md
index fd7184f86aa4f..0a8e355483807 100644
--- a/docs-ref-services/latest/health-data-ai-services.md
+++ b/docs-ref-services/latest/health-data-ai-services.md
@@ -1,7 +1,7 @@
---
title: Azure Health Data AI Services SDK for Java
description: Reference for Azure Health Data AI Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: healthdataaiservices
diff --git a/docs-ref-services/latest/health-deidentification.md b/docs-ref-services/latest/health-deidentification.md
index 162332a7f9713..9744cc8d4e58e 100644
--- a/docs-ref-services/latest/health-deidentification.md
+++ b/docs-ref-services/latest/health-deidentification.md
@@ -1,7 +1,7 @@
---
title: Azure Health Deidentification SDK for Java
description: Reference for Azure Health Deidentification SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: healthdeidentification
diff --git a/docs-ref-services/latest/healthcare-apis.md b/docs-ref-services/latest/healthcare-apis.md
index 9e1af128c1c7c..74972fb0a7e6c 100644
--- a/docs-ref-services/latest/healthcare-apis.md
+++ b/docs-ref-services/latest/healthcare-apis.md
@@ -1,7 +1,7 @@
---
title: Azure Healthcare APIs SDK for Java
description: Reference for Azure Healthcare APIs SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: healthcareapis
diff --git a/docs-ref-services/latest/hybrid-compute.md b/docs-ref-services/latest/hybrid-compute.md
index c68921bc50652..84fb5864c3f68 100644
--- a/docs-ref-services/latest/hybrid-compute.md
+++ b/docs-ref-services/latest/hybrid-compute.md
@@ -1,7 +1,7 @@
---
title: Azure Hybrid Compute SDK for Java
description: Reference for Azure Hybrid Compute SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hybridcompute
diff --git a/docs-ref-services/latest/hybrid-connectivity.md b/docs-ref-services/latest/hybrid-connectivity.md
index 7697169d4d9c9..7d71d04e27be7 100644
--- a/docs-ref-services/latest/hybrid-connectivity.md
+++ b/docs-ref-services/latest/hybrid-connectivity.md
@@ -1,7 +1,7 @@
---
title: Azure Hybrid Connectivity SDK for Java
description: Reference for Azure Hybrid Connectivity SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hybridconnectivity
diff --git a/docs-ref-services/latest/hybrid-kubernetes.md b/docs-ref-services/latest/hybrid-kubernetes.md
index c10535c9b37af..04da7551c363a 100644
--- a/docs-ref-services/latest/hybrid-kubernetes.md
+++ b/docs-ref-services/latest/hybrid-kubernetes.md
@@ -1,7 +1,7 @@
---
title: Azure Hybrid Kubernetes SDK for Java
description: Reference for Azure Hybrid Kubernetes SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hybridkubernetes
diff --git a/docs-ref-services/latest/hybrid-network.md b/docs-ref-services/latest/hybrid-network.md
index 22b2ae3ebcff0..e45e6231edfde 100644
--- a/docs-ref-services/latest/hybrid-network.md
+++ b/docs-ref-services/latest/hybrid-network.md
@@ -1,7 +1,7 @@
---
title: Azure Hybrid Network SDK for Java
description: Reference for Azure Hybrid Network SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hybridnetwork
diff --git a/docs-ref-services/latest/identity.md b/docs-ref-services/latest/identity.md
index ce8dcdab502d3..a2272a8fa927c 100644
--- a/docs-ref-services/latest/identity.md
+++ b/docs-ref-services/latest/identity.md
@@ -1,7 +1,7 @@
---
title: Azure Identity SDK for Java
description: Reference for Azure Identity SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: entra-id
diff --git a/docs-ref-services/latest/image-builder.md b/docs-ref-services/latest/image-builder.md
index 9c0cba88d8007..6fbd2f4a3c08c 100644
--- a/docs-ref-services/latest/image-builder.md
+++ b/docs-ref-services/latest/image-builder.md
@@ -1,7 +1,7 @@
---
title: Azure Image Builder SDK for Java
description: Reference for Azure Image Builder SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: imagebuilder
diff --git a/docs-ref-services/latest/informatica-data-management.md b/docs-ref-services/latest/informatica-data-management.md
index 6d4dcd6b4db62..4e75ea428fd23 100644
--- a/docs-ref-services/latest/informatica-data-management.md
+++ b/docs-ref-services/latest/informatica-data-management.md
@@ -1,7 +1,7 @@
---
title: Azure Informatica Data Management SDK for Java
description: Reference for Azure Informatica Data Management SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: informaticadatamanagement
diff --git a/docs-ref-services/latest/iot.md b/docs-ref-services/latest/iot.md
index d1f52e870967e..ae1daf90dcecc 100644
--- a/docs-ref-services/latest/iot.md
+++ b/docs-ref-services/latest/iot.md
@@ -1,7 +1,7 @@
---
title: Azure IoT SDK for Java
description: Reference for Azure IoT SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: iot
diff --git a/docs-ref-services/latest/key-vault.md b/docs-ref-services/latest/key-vault.md
index 4d33574c32502..cbdfba7d573c5 100644
--- a/docs-ref-services/latest/key-vault.md
+++ b/docs-ref-services/latest/key-vault.md
@@ -1,7 +1,7 @@
---
title: Azure Key Vault SDK for Java
description: Reference for Azure Key Vault SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: keyvault
diff --git a/docs-ref-services/latest/kubernetes-configuration.md b/docs-ref-services/latest/kubernetes-configuration.md
index aa66415df5d00..b1bc1d0686618 100644
--- a/docs-ref-services/latest/kubernetes-configuration.md
+++ b/docs-ref-services/latest/kubernetes-configuration.md
@@ -1,7 +1,7 @@
---
title: Azure Kubernetes Configuration SDK for Java
description: Reference for Azure Kubernetes Configuration SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: kubernetesconfiguration
diff --git a/docs-ref-services/latest/lab-services.md b/docs-ref-services/latest/lab-services.md
index 31e8f910c798d..5006c55403434 100644
--- a/docs-ref-services/latest/lab-services.md
+++ b/docs-ref-services/latest/lab-services.md
@@ -1,10 +1,10 @@
---
title: Azure Lab Services SDK for Java
description: Reference for Azure Lab Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
-ms.service: labservices
+ms.service: lab-services
---
# Azure Lab Services SDK for Java - latest
## Packages - latest
diff --git a/docs-ref-services/latest/lambdatesthyperexecute.md b/docs-ref-services/latest/lambdatesthyperexecute.md
index 5c653e7ac7b51..ce6d69bf8dd58 100644
--- a/docs-ref-services/latest/lambdatesthyperexecute.md
+++ b/docs-ref-services/latest/lambdatesthyperexecute.md
@@ -1,7 +1,7 @@
---
title: Azure Lambdatesthyperexecute SDK for Java
description: Reference for Azure Lambdatesthyperexecute SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: lambdatesthyperexecute
diff --git a/docs-ref-services/latest/load-testing.md b/docs-ref-services/latest/load-testing.md
index 7074dbe871a8c..593ea0633e85d 100644
--- a/docs-ref-services/latest/load-testing.md
+++ b/docs-ref-services/latest/load-testing.md
@@ -1,7 +1,7 @@
---
title: Azure Load Testing SDK for Java
description: Reference for Azure Load Testing SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: load-testing
diff --git a/docs-ref-services/latest/log-analytics.md b/docs-ref-services/latest/log-analytics.md
index 7bcef42331b80..6f8bb215e1be2 100644
--- a/docs-ref-services/latest/log-analytics.md
+++ b/docs-ref-services/latest/log-analytics.md
@@ -1,7 +1,7 @@
---
title: Azure Log Analytics SDK for Java
description: Reference for Azure Log Analytics SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-monitor
diff --git a/docs-ref-services/latest/logic-apps.md b/docs-ref-services/latest/logic-apps.md
index 40eecdd26a56a..62f439f54059d 100644
--- a/docs-ref-services/latest/logic-apps.md
+++ b/docs-ref-services/latest/logic-apps.md
@@ -1,7 +1,7 @@
---
title: Azure Logic Apps SDK for Java
description: Reference for Azure Logic Apps SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: logicapps
diff --git a/docs-ref-services/latest/machine-learning.md b/docs-ref-services/latest/machine-learning.md
index f1a4cd4f64fbc..26771c2edc520 100644
--- a/docs-ref-services/latest/machine-learning.md
+++ b/docs-ref-services/latest/machine-learning.md
@@ -1,7 +1,7 @@
---
title: Azure Machine Learning SDK for Java
description: Reference for Azure Machine Learning SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: machinelearning
diff --git a/docs-ref-services/latest/maintenance.md b/docs-ref-services/latest/maintenance.md
index ac0c22560ca6f..77cbad6d98458 100644
--- a/docs-ref-services/latest/maintenance.md
+++ b/docs-ref-services/latest/maintenance.md
@@ -1,7 +1,7 @@
---
title: Azure Maintenance SDK for Java
description: Reference for Azure Maintenance SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: maintenance
diff --git a/docs-ref-services/latest/managed-applications.md b/docs-ref-services/latest/managed-applications.md
index 1e2c3693d4ca1..1fc47bb4effc7 100644
--- a/docs-ref-services/latest/managed-applications.md
+++ b/docs-ref-services/latest/managed-applications.md
@@ -1,7 +1,7 @@
---
title: Azure Managed Applications SDK for Java
description: Reference for Azure Managed Applications SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: managedapplications
diff --git a/docs-ref-services/latest/managed-network-fabric.md b/docs-ref-services/latest/managed-network-fabric.md
index a1d78c27c48a9..8c0a47975cb77 100644
--- a/docs-ref-services/latest/managed-network-fabric.md
+++ b/docs-ref-services/latest/managed-network-fabric.md
@@ -1,7 +1,7 @@
---
title: Azure Managed Network Fabric SDK for Java
description: Reference for Azure Managed Network Fabric SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: managednetworkfabric
diff --git a/docs-ref-services/latest/managed-service-identity.md b/docs-ref-services/latest/managed-service-identity.md
index 4aa7bcf25b9ab..d6130a36b0c6d 100644
--- a/docs-ref-services/latest/managed-service-identity.md
+++ b/docs-ref-services/latest/managed-service-identity.md
@@ -1,7 +1,7 @@
---
title: Azure Managed Service Identity SDK for Java
description: Reference for Azure Managed Service Identity SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/maps.md b/docs-ref-services/latest/maps.md
index bc691fb33ff55..e45e35893fd9a 100644
--- a/docs-ref-services/latest/maps.md
+++ b/docs-ref-services/latest/maps.md
@@ -1,7 +1,7 @@
---
title: Azure Maps SDK for Java
description: Reference for Azure Maps SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: maps
diff --git a/docs-ref-services/latest/mariadb.md b/docs-ref-services/latest/mariadb.md
index 5a5b82a30c2d6..ecbda67eaa7bf 100644
--- a/docs-ref-services/latest/mariadb.md
+++ b/docs-ref-services/latest/mariadb.md
@@ -1,7 +1,7 @@
---
title: Azure MariaDB SDK for Java
description: Reference for Azure MariaDB SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mariadb
diff --git a/docs-ref-services/latest/marketplace-ordering.md b/docs-ref-services/latest/marketplace-ordering.md
index a7ad30d8ebd72..57e04515eaa0b 100644
--- a/docs-ref-services/latest/marketplace-ordering.md
+++ b/docs-ref-services/latest/marketplace-ordering.md
@@ -1,7 +1,7 @@
---
title: Azure Marketplace Ordering SDK for Java
description: Reference for Azure Marketplace Ordering SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: marketplaceordering
diff --git a/docs-ref-services/latest/media-services.md b/docs-ref-services/latest/media-services.md
index 92027bf9061b1..2b2b14909a839 100644
--- a/docs-ref-services/latest/media-services.md
+++ b/docs-ref-services/latest/media-services.md
@@ -1,7 +1,7 @@
---
title: Azure Media Services SDK for Java
description: Reference for Azure Media Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mediaservices
diff --git a/docs-ref-services/latest/metrics-advisor.md b/docs-ref-services/latest/metrics-advisor.md
index 44e4051a47ce2..262b3c7b087ea 100644
--- a/docs-ref-services/latest/metrics-advisor.md
+++ b/docs-ref-services/latest/metrics-advisor.md
@@ -1,7 +1,7 @@
---
title: Azure Metrics Advisor SDK for Java
description: Reference for Azure Metrics Advisor SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: metricsadvisor
diff --git a/docs-ref-services/latest/mixed-reality.md b/docs-ref-services/latest/mixed-reality.md
index d3be86072e454..98b0f8c4db4ab 100644
--- a/docs-ref-services/latest/mixed-reality.md
+++ b/docs-ref-services/latest/mixed-reality.md
@@ -1,7 +1,7 @@
---
title: Azure Mixed Reality SDK for Java
description: Reference for Azure Mixed Reality SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mixedreality
diff --git a/docs-ref-services/latest/mobile-network.md b/docs-ref-services/latest/mobile-network.md
index 9d5cd76d0dcbe..e1f07ae39d028 100644
--- a/docs-ref-services/latest/mobile-network.md
+++ b/docs-ref-services/latest/mobile-network.md
@@ -1,7 +1,7 @@
---
title: Azure Mobile Network SDK for Java
description: Reference for Azure Mobile Network SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-monitor
diff --git a/docs-ref-services/latest/mongo-cluster.md b/docs-ref-services/latest/mongo-cluster.md
index 2787012a4171b..50fd04619b4c4 100644
--- a/docs-ref-services/latest/mongo-cluster.md
+++ b/docs-ref-services/latest/mongo-cluster.md
@@ -1,7 +1,7 @@
---
title: Azure Mongo Cluster SDK for Java
description: Reference for Azure Mongo Cluster SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mongocluster
diff --git a/docs-ref-services/latest/mongodbatlas.md b/docs-ref-services/latest/mongodbatlas.md
index 00ab9f4d08274..0b7af337f26ca 100644
--- a/docs-ref-services/latest/mongodbatlas.md
+++ b/docs-ref-services/latest/mongodbatlas.md
@@ -1,7 +1,7 @@
---
title: Azure Mongodbatlas SDK for Java
description: Reference for Azure Mongodbatlas SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mongodbatlas
diff --git a/docs-ref-services/latest/monitor-index.md b/docs-ref-services/latest/monitor-index.md
index 6bbe4ba52a176..9b6e1529680c1 100644
--- a/docs-ref-services/latest/monitor-index.md
+++ b/docs-ref-services/latest/monitor-index.md
@@ -3,4 +3,6 @@
|[Monitor Ingestion](monitor-ingestion-readme.md)|[azure-monitor-ingestion](https://repo1.maven.org/maven2/com/azure/azure-monitor-ingestion)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-ingestion)|
|[OpenTelemetry AutoConfigure](monitor-opentelemetry-autoconfigure-readme.md)|[azure-monitor-opentelemetry-autoconfigure](https://repo1.maven.org/maven2/com/azure/azure-monitor-opentelemetry-autoconfigure)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-opentelemetry-autoconfigure)|
|[Monitor Query](monitor-query-readme.md)|[azure-monitor-query](https://repo1.maven.org/maven2/com/azure/azure-monitor-query)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query)|
+|[Monitor Query Logs](monitor-query-logs-readme.md)|[azure-monitor-query-logs](https://repo1.maven.org/maven2/com/azure/azure-monitor-query-logs)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-logs)|
+|[Monitor Query Metrics](monitor-query-metrics-readme.md)|[azure-monitor-query-metrics](https://repo1.maven.org/maven2/com/azure/azure-monitor-query-metrics)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-metrics)|
|[Resource Management - Monitor](resourcemanager-monitor-readme.md)|[azure-resourcemanager-monitor](https://repo1.maven.org/maven2/com/azure/resourcemanager/azure-resourcemanager-monitor)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/azure-resourcemanager-monitor)|
diff --git a/docs-ref-services/latest/monitor.md b/docs-ref-services/latest/monitor.md
index e754e8474bd1b..93aac63160000 100644
--- a/docs-ref-services/latest/monitor.md
+++ b/docs-ref-services/latest/monitor.md
@@ -1,7 +1,7 @@
---
title: Azure Monitor SDK for Java
description: Reference for Azure Monitor SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: monitor
diff --git a/docs-ref-services/latest/mysql.md b/docs-ref-services/latest/mysql.md
index 834b78ac1c121..3d56d4ec48f2d 100644
--- a/docs-ref-services/latest/mysql.md
+++ b/docs-ref-services/latest/mysql.md
@@ -1,7 +1,7 @@
---
title: Azure MySQL SDK for Java
description: Reference for Azure MySQL SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mysql
diff --git a/docs-ref-services/latest/neon-postgres.md b/docs-ref-services/latest/neon-postgres.md
index fd2da35046504..9d65e81a3327b 100644
--- a/docs-ref-services/latest/neon-postgres.md
+++ b/docs-ref-services/latest/neon-postgres.md
@@ -1,7 +1,7 @@
---
title: Azure Neon Postgres SDK for Java
description: Reference for Azure Neon Postgres SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: neonpostgres
diff --git a/docs-ref-services/latest/netapp-files.md b/docs-ref-services/latest/netapp-files.md
index 902ae3205a94d..b49874921d6fe 100644
--- a/docs-ref-services/latest/netapp-files.md
+++ b/docs-ref-services/latest/netapp-files.md
@@ -1,7 +1,7 @@
---
title: Azure NetApp Files SDK for Java
description: Reference for Azure NetApp Files SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: netappfiles
diff --git a/docs-ref-services/latest/network.md b/docs-ref-services/latest/network.md
index d8b5dc79edcc3..42f2c2efad571 100644
--- a/docs-ref-services/latest/network.md
+++ b/docs-ref-services/latest/network.md
@@ -1,12 +1,12 @@
---
title: Azure Network SDK for Java
description: Reference for Azure Network SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: network-access
-manager: douge
keywords: Azure, Java, SDK, API, networking, load balancing, vnet , subnet
+manager: douge
---
# Azure Network libraries for Java
diff --git a/docs-ref-services/latest/new-relic-observability.md b/docs-ref-services/latest/new-relic-observability.md
index 90d0b79525fb7..5a95d83c36408 100644
--- a/docs-ref-services/latest/new-relic-observability.md
+++ b/docs-ref-services/latest/new-relic-observability.md
@@ -1,7 +1,7 @@
---
title: Azure New Relic Observability SDK for Java
description: Reference for Azure New Relic Observability SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: newrelicobservability
diff --git a/docs-ref-services/latest/nginx.md b/docs-ref-services/latest/nginx.md
index dee440121379c..8dfd35ede7265 100644
--- a/docs-ref-services/latest/nginx.md
+++ b/docs-ref-services/latest/nginx.md
@@ -1,7 +1,7 @@
---
title: Azure Nginx SDK for Java
description: Reference for Azure Nginx SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: nginx
diff --git a/docs-ref-services/latest/notification-hubs.md b/docs-ref-services/latest/notification-hubs.md
index def2e2b7655f0..6c8723f030545 100644
--- a/docs-ref-services/latest/notification-hubs.md
+++ b/docs-ref-services/latest/notification-hubs.md
@@ -1,7 +1,7 @@
---
title: Azure Notification Hubs SDK for Java
description: Reference for Azure Notification Hubs SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: notificationhubs
diff --git a/docs-ref-services/latest/operator-nexus---network-cloud.md b/docs-ref-services/latest/operator-nexus---network-cloud.md
index eaa6cbdaceec6..c162ff8bc7c9a 100644
--- a/docs-ref-services/latest/operator-nexus---network-cloud.md
+++ b/docs-ref-services/latest/operator-nexus---network-cloud.md
@@ -1,7 +1,7 @@
---
title: Azure Operator Nexus - Network Cloud SDK for Java
description: Reference for Azure Operator Nexus - Network Cloud SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: operatornexus-networkcloud
diff --git a/docs-ref-services/latest/oracle-database.md b/docs-ref-services/latest/oracle-database.md
index 8fcaac2178a68..40695b2764c33 100644
--- a/docs-ref-services/latest/oracle-database.md
+++ b/docs-ref-services/latest/oracle-database.md
@@ -1,7 +1,7 @@
---
title: Azure Oracle Database SDK for Java
description: Reference for Azure Oracle Database SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: oracledatabase
diff --git a/docs-ref-services/latest/orbital.md b/docs-ref-services/latest/orbital.md
index 753262c2d65a0..7dc29c7b20e87 100644
--- a/docs-ref-services/latest/orbital.md
+++ b/docs-ref-services/latest/orbital.md
@@ -1,7 +1,7 @@
---
title: Azure Orbital SDK for Java
description: Reference for Azure Orbital SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: orbital
diff --git a/docs-ref-services/latest/palo-alto-networks.md b/docs-ref-services/latest/palo-alto-networks.md
index eeef0c396692e..ec823d556a870 100644
--- a/docs-ref-services/latest/palo-alto-networks.md
+++ b/docs-ref-services/latest/palo-alto-networks.md
@@ -1,7 +1,7 @@
---
title: Azure Palo Alto Networks SDK for Java
description: Reference for Azure Palo Alto Networks SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: paloaltonetworks
diff --git a/docs-ref-services/latest/peering.md b/docs-ref-services/latest/peering.md
index 13ab6fdb233c8..a135f65a42f2a 100644
--- a/docs-ref-services/latest/peering.md
+++ b/docs-ref-services/latest/peering.md
@@ -1,7 +1,7 @@
---
title: Azure Peering SDK for Java
description: Reference for Azure Peering SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: peering
diff --git a/docs-ref-services/latest/playwright-testing.md b/docs-ref-services/latest/playwright-testing.md
index d96b50ccdbe92..cab8edfa0eb77 100644
--- a/docs-ref-services/latest/playwright-testing.md
+++ b/docs-ref-services/latest/playwright-testing.md
@@ -1,7 +1,7 @@
---
title: Azure Playwright Testing SDK for Java
description: Reference for Azure Playwright Testing SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: playwrighttesting
diff --git a/docs-ref-services/latest/policy-insights.md b/docs-ref-services/latest/policy-insights.md
index fe239de78c19a..cf826d87bdca7 100644
--- a/docs-ref-services/latest/policy-insights.md
+++ b/docs-ref-services/latest/policy-insights.md
@@ -1,7 +1,7 @@
---
title: Azure Policy Insights SDK for Java
description: Reference for Azure Policy Insights SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: policyinsights
diff --git a/docs-ref-services/latest/postgresql.md b/docs-ref-services/latest/postgresql.md
index f0661092b998a..da701ae36e10e 100644
--- a/docs-ref-services/latest/postgresql.md
+++ b/docs-ref-services/latest/postgresql.md
@@ -1,7 +1,7 @@
---
title: Azure PostgreSQL SDK for Java
description: Reference for Azure PostgreSQL SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: postgresql
diff --git a/docs-ref-services/latest/power-bi-dedicated.md b/docs-ref-services/latest/power-bi-dedicated.md
index 6d577952112af..bfe8de8bbb238 100644
--- a/docs-ref-services/latest/power-bi-dedicated.md
+++ b/docs-ref-services/latest/power-bi-dedicated.md
@@ -1,7 +1,7 @@
---
title: Azure Power BI Dedicated SDK for Java
description: Reference for Azure Power BI Dedicated SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: powerbidedicated
diff --git a/docs-ref-services/latest/private-dns.md b/docs-ref-services/latest/private-dns.md
index 1547ab12a3c25..40f381267f4ca 100644
--- a/docs-ref-services/latest/private-dns.md
+++ b/docs-ref-services/latest/private-dns.md
@@ -1,10 +1,10 @@
---
title: Azure Private DNS SDK for Java
description: Reference for Azure Private DNS SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
-ms.service: privatedns
+ms.service: dns
---
# Azure Private DNS SDK for Java - latest
## Packages - latest
diff --git a/docs-ref-services/latest/provider-hub.md b/docs-ref-services/latest/provider-hub.md
index fa368f15c24b7..5d14b59dce0ec 100644
--- a/docs-ref-services/latest/provider-hub.md
+++ b/docs-ref-services/latest/provider-hub.md
@@ -1,7 +1,7 @@
---
title: Azure Provider Hub SDK for Java
description: Reference for Azure Provider Hub SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: providerhub
diff --git a/docs-ref-services/latest/purestorageblock.md b/docs-ref-services/latest/purestorageblock.md
index f6940cb595f11..c143175ccbc10 100644
--- a/docs-ref-services/latest/purestorageblock.md
+++ b/docs-ref-services/latest/purestorageblock.md
@@ -1,7 +1,7 @@
---
title: Azure Purestorageblock SDK for Java
description: Reference for Azure Purestorageblock SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: purestorageblock
diff --git a/docs-ref-services/latest/purview.md b/docs-ref-services/latest/purview.md
index 2cbe807bcc0cb..e1753365e5d9c 100644
--- a/docs-ref-services/latest/purview.md
+++ b/docs-ref-services/latest/purview.md
@@ -1,7 +1,7 @@
---
title: Azure Purview SDK for Java
description: Reference for Azure Purview SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: purview
diff --git a/docs-ref-services/latest/qumulo.md b/docs-ref-services/latest/qumulo.md
index dfe3f622da1a1..d6fc1c567df11 100644
--- a/docs-ref-services/latest/qumulo.md
+++ b/docs-ref-services/latest/qumulo.md
@@ -1,7 +1,7 @@
---
title: Azure Qumulo SDK for Java
description: Reference for Azure Qumulo SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: qumulo
diff --git a/docs-ref-services/latest/quota.md b/docs-ref-services/latest/quota.md
index 34eb50ff1fc32..4228859cc1522 100644
--- a/docs-ref-services/latest/quota.md
+++ b/docs-ref-services/latest/quota.md
@@ -1,7 +1,7 @@
---
title: Azure Quota SDK for Java
description: Reference for Azure Quota SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: quota
diff --git a/docs-ref-services/latest/recovery-services.md b/docs-ref-services/latest/recovery-services.md
index 746f4aa254de2..6a9a00964b82d 100644
--- a/docs-ref-services/latest/recovery-services.md
+++ b/docs-ref-services/latest/recovery-services.md
@@ -1,7 +1,7 @@
---
title: Azure Recovery Services SDK for Java
description: Reference for Azure Recovery Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: recoveryservices
diff --git a/docs-ref-services/latest/redis.md b/docs-ref-services/latest/redis.md
index 6862d97cb17a6..e1540e772e934 100644
--- a/docs-ref-services/latest/redis.md
+++ b/docs-ref-services/latest/redis.md
@@ -1,10 +1,10 @@
---
title: Azure Redis SDK for Java
description: Reference for Azure Redis SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
-ms.service: redis-cache
+ms.service: redis
---
# Azure Redis SDK for Java - latest
## Packages - latest
diff --git a/docs-ref-services/latest/reservations.md b/docs-ref-services/latest/reservations.md
index ed6d0f5354430..889abd48e0558 100644
--- a/docs-ref-services/latest/reservations.md
+++ b/docs-ref-services/latest/reservations.md
@@ -1,7 +1,7 @@
---
title: Azure Reservations SDK for Java
description: Reference for Azure Reservations SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: reservations
diff --git a/docs-ref-services/latest/resource-connector.md b/docs-ref-services/latest/resource-connector.md
index b086a77cd6eea..8f01c81a0f63a 100644
--- a/docs-ref-services/latest/resource-connector.md
+++ b/docs-ref-services/latest/resource-connector.md
@@ -1,7 +1,7 @@
---
title: Azure Resource Connector SDK for Java
description: Reference for Azure Resource Connector SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resourceconnector
diff --git a/docs-ref-services/latest/resource-graph.md b/docs-ref-services/latest/resource-graph.md
index 6321a64acea8a..1bca6f6f2c044 100644
--- a/docs-ref-services/latest/resource-graph.md
+++ b/docs-ref-services/latest/resource-graph.md
@@ -1,7 +1,7 @@
---
title: Azure Resource Graph SDK for Java
description: Reference for Azure Resource Graph SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resourcegraph
diff --git a/docs-ref-services/latest/resource-health.md b/docs-ref-services/latest/resource-health.md
index d2abb9c3a2388..180713244a7d1 100644
--- a/docs-ref-services/latest/resource-health.md
+++ b/docs-ref-services/latest/resource-health.md
@@ -1,7 +1,7 @@
---
title: Azure Resource Health SDK for Java
description: Reference for Azure Resource Health SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resourcehealth
diff --git a/docs-ref-services/latest/resource-mover.md b/docs-ref-services/latest/resource-mover.md
index 445440b38e812..83a1bf6c50d24 100644
--- a/docs-ref-services/latest/resource-mover.md
+++ b/docs-ref-services/latest/resource-mover.md
@@ -1,7 +1,7 @@
---
title: Azure Resource Mover SDK for Java
description: Reference for Azure Resource Mover SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resourcemover
diff --git a/docs-ref-services/latest/resources-deploymentstacks.md b/docs-ref-services/latest/resources-deploymentstacks.md
index 67f8d679550b6..12bcd90994cfe 100644
--- a/docs-ref-services/latest/resources-deploymentstacks.md
+++ b/docs-ref-services/latest/resources-deploymentstacks.md
@@ -1,7 +1,7 @@
---
title: Azure Resources-Deploymentstacks SDK for Java
description: Reference for Azure Resources-Deploymentstacks SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resources-deploymentstacks
diff --git a/docs-ref-services/latest/resources.md b/docs-ref-services/latest/resources.md
index 5c447bbe7933f..b72d381518710 100644
--- a/docs-ref-services/latest/resources.md
+++ b/docs-ref-services/latest/resources.md
@@ -1,7 +1,7 @@
---
title: Azure Resources SDK for Java
description: Reference for Azure Resources SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/latest/schema-registry.md b/docs-ref-services/latest/schema-registry.md
index 05d4e896e056a..5e4910e7de583 100644
--- a/docs-ref-services/latest/schema-registry.md
+++ b/docs-ref-services/latest/schema-registry.md
@@ -1,10 +1,10 @@
---
title: Azure Schema Registry SDK for Java
description: Reference for Azure Schema Registry SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
-ms.service: schema-registry
+ms.service: schemaregistry
---
# Azure Schema Registry SDK for Java - latest
## Packages - latest
diff --git a/docs-ref-services/latest/search.md b/docs-ref-services/latest/search.md
index 7c17db85fbde5..ac23b5f7a4d5c 100644
--- a/docs-ref-services/latest/search.md
+++ b/docs-ref-services/latest/search.md
@@ -1,7 +1,7 @@
---
title: Azure Search SDK for Java
description: Reference for Azure Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cognitive-search
diff --git a/docs-ref-services/latest/security-insights.md b/docs-ref-services/latest/security-insights.md
index 1ec90411f91d7..748d5686b2c34 100644
--- a/docs-ref-services/latest/security-insights.md
+++ b/docs-ref-services/latest/security-insights.md
@@ -1,7 +1,7 @@
---
title: Azure Security Insights SDK for Java
description: Reference for Azure Security Insights SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: securityinsights
diff --git a/docs-ref-services/latest/security.md b/docs-ref-services/latest/security.md
index 37f216b2343c3..f6d07814e28c7 100644
--- a/docs-ref-services/latest/security.md
+++ b/docs-ref-services/latest/security.md
@@ -1,7 +1,7 @@
---
title: Azure Security SDK for Java
description: Reference for Azure Security SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: security
diff --git a/docs-ref-services/latest/self-help.md b/docs-ref-services/latest/self-help.md
index f230e7a979763..d06775bf7c5ef 100644
--- a/docs-ref-services/latest/self-help.md
+++ b/docs-ref-services/latest/self-help.md
@@ -1,7 +1,7 @@
---
title: Azure Self Help SDK for Java
description: Reference for Azure Self Help SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: selfhelp
diff --git a/docs-ref-services/latest/service-bus.md b/docs-ref-services/latest/service-bus.md
index 35cb4cdf0b772..754cf557a7ad2 100644
--- a/docs-ref-services/latest/service-bus.md
+++ b/docs-ref-services/latest/service-bus.md
@@ -1,7 +1,7 @@
---
title: Azure Service Bus SDK for Java
description: Reference for Azure Service Bus SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-service-bus
diff --git a/docs-ref-services/latest/service-fabric-managed-clusters.md b/docs-ref-services/latest/service-fabric-managed-clusters.md
index 2589cf8e44941..bb67b5288266d 100644
--- a/docs-ref-services/latest/service-fabric-managed-clusters.md
+++ b/docs-ref-services/latest/service-fabric-managed-clusters.md
@@ -1,7 +1,7 @@
---
title: Azure Service Fabric Managed Clusters SDK for Java
description: Reference for Azure Service Fabric Managed Clusters SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: servicefabricmanagedclusters
diff --git a/docs-ref-services/latest/service-fabric.md b/docs-ref-services/latest/service-fabric.md
index e40de7037ee26..68bbcb47df772 100644
--- a/docs-ref-services/latest/service-fabric.md
+++ b/docs-ref-services/latest/service-fabric.md
@@ -1,7 +1,7 @@
---
title: Azure Service Fabric SDK for Java
description: Reference for Azure Service Fabric SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: servicefabric
diff --git a/docs-ref-services/latest/service-linker.md b/docs-ref-services/latest/service-linker.md
index b0aef81719446..d3c804abd18f5 100644
--- a/docs-ref-services/latest/service-linker.md
+++ b/docs-ref-services/latest/service-linker.md
@@ -1,7 +1,7 @@
---
title: Azure Service Linker SDK for Java
description: Reference for Azure Service Linker SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: servicelinker
diff --git a/docs-ref-services/latest/service-networking.md b/docs-ref-services/latest/service-networking.md
index c97bfa091195a..4f5167730d378 100644
--- a/docs-ref-services/latest/service-networking.md
+++ b/docs-ref-services/latest/service-networking.md
@@ -1,7 +1,7 @@
---
title: Azure Service Networking SDK for Java
description: Reference for Azure Service Networking SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: servicenetworking
diff --git a/docs-ref-services/latest/signalr.md b/docs-ref-services/latest/signalr.md
index f76f635d406e0..313a29cb691c2 100644
--- a/docs-ref-services/latest/signalr.md
+++ b/docs-ref-services/latest/signalr.md
@@ -1,7 +1,7 @@
---
title: Azure SignalR SDK for Java
description: Reference for Azure SignalR SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: signalr
diff --git a/docs-ref-services/latest/sphere.md b/docs-ref-services/latest/sphere.md
index 49e705ea0b46e..a1cc97a36afbc 100644
--- a/docs-ref-services/latest/sphere.md
+++ b/docs-ref-services/latest/sphere.md
@@ -1,7 +1,7 @@
---
title: Azure Sphere SDK for Java
description: Reference for Azure Sphere SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: sphere
diff --git a/docs-ref-services/latest/spring-cloud.md b/docs-ref-services/latest/spring-cloud.md
index dbc2549d947f1..2d28f9f5b1ef4 100644
--- a/docs-ref-services/latest/spring-cloud.md
+++ b/docs-ref-services/latest/spring-cloud.md
@@ -1,7 +1,7 @@
---
title: Azure Spring Cloud SDK for Java
description: Reference for Azure Spring Cloud SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: springcloud
diff --git a/docs-ref-services/latest/sql.md b/docs-ref-services/latest/sql.md
index 9a1fddfb96d0c..f8c4f17070f51 100644
--- a/docs-ref-services/latest/sql.md
+++ b/docs-ref-services/latest/sql.md
@@ -1,7 +1,7 @@
---
title: Azure SQL SDK for Java
description: Reference for Azure SQL SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mysql
diff --git a/docs-ref-services/latest/standby-pool.md b/docs-ref-services/latest/standby-pool.md
index 6e7e04db74031..01eb6809f4342 100644
--- a/docs-ref-services/latest/standby-pool.md
+++ b/docs-ref-services/latest/standby-pool.md
@@ -1,7 +1,7 @@
---
title: Azure Standby Pool SDK for Java
description: Reference for Azure Standby Pool SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: standbypool
diff --git a/docs-ref-services/latest/storage.md b/docs-ref-services/latest/storage.md
index b8bf6e9630877..2cf39e2550e2e 100644
--- a/docs-ref-services/latest/storage.md
+++ b/docs-ref-services/latest/storage.md
@@ -1,7 +1,7 @@
---
title: Azure Storage SDK for Java
description: Reference for Azure Storage SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: storage
diff --git a/docs-ref-services/latest/stream-analytics.md b/docs-ref-services/latest/stream-analytics.md
index cee83599840e8..306aee9f1ab73 100644
--- a/docs-ref-services/latest/stream-analytics.md
+++ b/docs-ref-services/latest/stream-analytics.md
@@ -1,7 +1,7 @@
---
title: Azure Stream Analytics SDK for Java
description: Reference for Azure Stream Analytics SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: stream-analytics
diff --git a/docs-ref-services/latest/subscriptions.md b/docs-ref-services/latest/subscriptions.md
index a03fb11f3a3d4..39b22344fbd4b 100644
--- a/docs-ref-services/latest/subscriptions.md
+++ b/docs-ref-services/latest/subscriptions.md
@@ -1,7 +1,7 @@
---
title: Azure Subscriptions SDK for Java
description: Reference for Azure Subscriptions SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: subscriptions
diff --git a/docs-ref-services/latest/support.md b/docs-ref-services/latest/support.md
index dbc4a9392b098..e3c87138edc5a 100644
--- a/docs-ref-services/latest/support.md
+++ b/docs-ref-services/latest/support.md
@@ -1,7 +1,7 @@
---
title: Azure Support SDK for Java
description: Reference for Azure Support SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: support
diff --git a/docs-ref-services/latest/synapse.md b/docs-ref-services/latest/synapse.md
index 52767ca29a399..3062b4bc32b28 100644
--- a/docs-ref-services/latest/synapse.md
+++ b/docs-ref-services/latest/synapse.md
@@ -1,7 +1,7 @@
---
title: Azure Synapse SDK for Java
description: Reference for Azure Synapse SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: synapse-analytics
diff --git a/docs-ref-services/latest/system-center-virtual-machine-manager.md b/docs-ref-services/latest/system-center-virtual-machine-manager.md
index d93e992648d66..a9ca5df4faa07 100644
--- a/docs-ref-services/latest/system-center-virtual-machine-manager.md
+++ b/docs-ref-services/latest/system-center-virtual-machine-manager.md
@@ -1,7 +1,7 @@
---
title: Azure System Center Virtual Machine Manager SDK for Java
description: Reference for Azure System Center Virtual Machine Manager SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: systemcentervirtualmachinemanager
diff --git a/docs-ref-services/latest/tables.md b/docs-ref-services/latest/tables.md
index 1cf2873892c76..74062b0689b6e 100644
--- a/docs-ref-services/latest/tables.md
+++ b/docs-ref-services/latest/tables.md
@@ -1,7 +1,7 @@
---
title: Azure Tables SDK for Java
description: Reference for Azure Tables SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: tables
diff --git a/docs-ref-services/latest/traffic-manager.md b/docs-ref-services/latest/traffic-manager.md
index b166f23f57d88..c8a889412c56f 100644
--- a/docs-ref-services/latest/traffic-manager.md
+++ b/docs-ref-services/latest/traffic-manager.md
@@ -1,7 +1,7 @@
---
title: Azure Traffic Manager SDK for Java
description: Reference for Azure Traffic Manager SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: trafficmanager
diff --git a/docs-ref-services/latest/visual-search.md b/docs-ref-services/latest/visual-search.md
index e0bc99606e6c8..1338241d873ba 100644
--- a/docs-ref-services/latest/visual-search.md
+++ b/docs-ref-services/latest/visual-search.md
@@ -1,7 +1,7 @@
---
title: Azure Visual Search SDK for Java
description: Reference for Azure Visual Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: visualsearch
diff --git a/docs-ref-services/latest/web-pubsub.md b/docs-ref-services/latest/web-pubsub.md
index 08de088148479..8aaf0e2117282 100644
--- a/docs-ref-services/latest/web-pubsub.md
+++ b/docs-ref-services/latest/web-pubsub.md
@@ -1,7 +1,7 @@
---
title: Azure Web PubSub SDK for Java
description: Reference for Azure Web PubSub SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: webpubsub
diff --git a/docs-ref-services/latest/workloads.md b/docs-ref-services/latest/workloads.md
index 719b240670f64..a6bea0500310d 100644
--- a/docs-ref-services/latest/workloads.md
+++ b/docs-ref-services/latest/workloads.md
@@ -1,7 +1,7 @@
---
title: Azure Workloads SDK for Java
description: Reference for Azure Workloads SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: workloads
diff --git a/docs-ref-services/legacy/app-platform.md b/docs-ref-services/legacy/app-platform.md
index ef9405dd61e13..79817197c7401 100644
--- a/docs-ref-services/legacy/app-platform.md
+++ b/docs-ref-services/legacy/app-platform.md
@@ -1,7 +1,7 @@
---
title: Azure App Platform SDK for Java
description: Reference for Azure App Platform SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: spring-cloud
diff --git a/docs-ref-services/legacy/auto-suggest.md b/docs-ref-services/legacy/auto-suggest.md
index 2060e7e87e643..51a797a1212e8 100644
--- a/docs-ref-services/legacy/auto-suggest.md
+++ b/docs-ref-services/legacy/auto-suggest.md
@@ -1,7 +1,7 @@
---
title: Azure Auto Suggest SDK for Java
description: Reference for Azure Auto Suggest SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: autosuggest
diff --git a/docs-ref-services/legacy/azure-stack-hci.md b/docs-ref-services/legacy/azure-stack-hci.md
index 595902b260d40..c89cd553813b3 100644
--- a/docs-ref-services/legacy/azure-stack-hci.md
+++ b/docs-ref-services/legacy/azure-stack-hci.md
@@ -1,7 +1,7 @@
---
title: Azure Azure Stack HCI SDK for Java
description: Reference for Azure Azure Stack HCI SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azurestackhci
diff --git a/docs-ref-services/legacy/batch-ai.md b/docs-ref-services/legacy/batch-ai.md
index ea446cec75199..7ed737290cb26 100644
--- a/docs-ref-services/legacy/batch-ai.md
+++ b/docs-ref-services/legacy/batch-ai.md
@@ -1,7 +1,7 @@
---
title: Azure Batch AI SDK for Java
description: Reference for Azure Batch AI SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: batchai
diff --git a/docs-ref-services/legacy/batch.md b/docs-ref-services/legacy/batch.md
index 68916cd1422df..3fee802fed4e7 100644
--- a/docs-ref-services/legacy/batch.md
+++ b/docs-ref-services/legacy/batch.md
@@ -1,7 +1,7 @@
---
title: Azure Batch SDK for Java
description: Reference for Azure Batch SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: batch
diff --git a/docs-ref-services/legacy/cognitive-services.md b/docs-ref-services/legacy/cognitive-services.md
index 0f18d58ffbd7f..908e397607d95 100644
--- a/docs-ref-services/legacy/cognitive-services.md
+++ b/docs-ref-services/legacy/cognitive-services.md
@@ -1,7 +1,7 @@
---
title: Azure Cognitive Services SDK for Java
description: Reference for Azure Cognitive Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cognitiveservices
diff --git a/docs-ref-services/legacy/communication-index.md b/docs-ref-services/legacy/communication-index.md
index b6f4335460fa3..38e8429aca979 100644
--- a/docs-ref-services/legacy/communication-index.md
+++ b/docs-ref-services/legacy/communication-index.md
@@ -1,4 +1,4 @@
| Reference | Package | Source |
|---|---|---|
-|[Calling Server](communication-callingserver-readme.md)|[azure-communication-callingserver](https://repo1.maven.org/maven2/com/azure/azure-communication-callingserver)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/)|
+|[Calling Server](communication-callingserver-readme.md)|[azure-communication-callingserver](https://repo1.maven.org/maven2/com/azure/azure-communication-callingserver)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/communication/azure-communication-callingserver)|
|Communication Network Traversal|[azure-communication-networktraversal](https://repo1.maven.org/maven2/com/azure/azure-communication-networktraversal)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/communication/azure-communication-networktraversal)|
diff --git a/docs-ref-services/legacy/communication.md b/docs-ref-services/legacy/communication.md
index 76d45996e645a..b07cd2704b2ae 100644
--- a/docs-ref-services/legacy/communication.md
+++ b/docs-ref-services/legacy/communication.md
@@ -1,7 +1,7 @@
---
title: Azure Communication SDK for Java
description: Reference for Azure Communication SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: communication
diff --git a/docs-ref-services/legacy/container-instances.md b/docs-ref-services/legacy/container-instances.md
index e601cfe15f96b..888332ae2cec6 100644
--- a/docs-ref-services/legacy/container-instances.md
+++ b/docs-ref-services/legacy/container-instances.md
@@ -1,7 +1,7 @@
---
title: Azure Container Instances SDK for Java
description: Reference for Azure Container Instances SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: containerinstances
diff --git a/docs-ref-services/legacy/container-registry.md b/docs-ref-services/legacy/container-registry.md
index d09774ea36627..b9a2386607b3d 100644
--- a/docs-ref-services/legacy/container-registry.md
+++ b/docs-ref-services/legacy/container-registry.md
@@ -1,7 +1,7 @@
---
title: Azure Container Registry SDK for Java
description: Reference for Azure Container Registry SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: containerregistry
diff --git a/docs-ref-services/legacy/container-service.md b/docs-ref-services/legacy/container-service.md
index 284b20b6d44cb..2a83adf7c9fee 100644
--- a/docs-ref-services/legacy/container-service.md
+++ b/docs-ref-services/legacy/container-service.md
@@ -1,7 +1,7 @@
---
title: Azure Container Service SDK for Java
description: Reference for Azure Container Service SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: containerservice
diff --git a/docs-ref-services/legacy/content-delivery-network.md b/docs-ref-services/legacy/content-delivery-network.md
index da092db0be02e..31315a435348f 100644
--- a/docs-ref-services/legacy/content-delivery-network.md
+++ b/docs-ref-services/legacy/content-delivery-network.md
@@ -1,7 +1,7 @@
---
title: Azure Content Delivery Network SDK for Java
description: Reference for Azure Content Delivery Network SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: contentdeliverynetwork
diff --git a/docs-ref-services/legacy/cosmos-db.md b/docs-ref-services/legacy/cosmos-db.md
index 8cd35e117be8f..c0c74e1b951b0 100644
--- a/docs-ref-services/legacy/cosmos-db.md
+++ b/docs-ref-services/legacy/cosmos-db.md
@@ -1,7 +1,7 @@
---
title: Azure Cosmos DB SDK for Java
description: Reference for Azure Cosmos DB SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cosmosdb
diff --git a/docs-ref-services/legacy/custom-image-search.md b/docs-ref-services/legacy/custom-image-search.md
index 7346dbfa6a732..2370d408ad5ac 100644
--- a/docs-ref-services/legacy/custom-image-search.md
+++ b/docs-ref-services/legacy/custom-image-search.md
@@ -1,7 +1,7 @@
---
title: Azure Custom Image Search SDK for Java
description: Reference for Azure Custom Image Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: customimagesearch
diff --git a/docs-ref-services/legacy/custom-search.md b/docs-ref-services/legacy/custom-search.md
index feca2598b0ee0..76681c4d63e4b 100644
--- a/docs-ref-services/legacy/custom-search.md
+++ b/docs-ref-services/legacy/custom-search.md
@@ -1,7 +1,7 @@
---
title: Azure Custom Search SDK for Java
description: Reference for Azure Custom Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: customsearch
diff --git a/docs-ref-services/legacy/digital-twins.md b/docs-ref-services/legacy/digital-twins.md
index 77877a91b143e..950b18a4375ce 100644
--- a/docs-ref-services/legacy/digital-twins.md
+++ b/docs-ref-services/legacy/digital-twins.md
@@ -1,7 +1,7 @@
---
title: Azure Digital Twins SDK for Java
description: Reference for Azure Digital Twins SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: digitaltwins
diff --git a/docs-ref-services/legacy/dns.md b/docs-ref-services/legacy/dns.md
index a5ef1e4bb10ab..ee544e228e499 100644
--- a/docs-ref-services/legacy/dns.md
+++ b/docs-ref-services/legacy/dns.md
@@ -1,7 +1,7 @@
---
title: Azure DNS SDK for Java
description: Reference for Azure DNS SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: dns
diff --git a/docs-ref-services/legacy/entity-search.md b/docs-ref-services/legacy/entity-search.md
index e70c2767db800..1ffa5bb22b384 100644
--- a/docs-ref-services/legacy/entity-search.md
+++ b/docs-ref-services/legacy/entity-search.md
@@ -1,7 +1,7 @@
---
title: Azure Entity Search SDK for Java
description: Reference for Azure Entity Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: entitysearch
diff --git a/docs-ref-services/legacy/event-grid.md b/docs-ref-services/legacy/event-grid.md
index 24f34aefc7e0d..328c1433428a2 100644
--- a/docs-ref-services/legacy/event-grid.md
+++ b/docs-ref-services/legacy/event-grid.md
@@ -1,7 +1,7 @@
---
title: Azure Event Grid SDK for Java
description: Reference for Azure Event Grid SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-event-grid
diff --git a/docs-ref-services/legacy/graph-rbac.md b/docs-ref-services/legacy/graph-rbac.md
index b4e2cacfa603d..b8da8bc6b4b96 100644
--- a/docs-ref-services/legacy/graph-rbac.md
+++ b/docs-ref-services/legacy/graph-rbac.md
@@ -1,7 +1,7 @@
---
title: Azure Graph RBAC SDK for Java
description: Reference for Azure Graph RBAC SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: graphrbac
diff --git a/docs-ref-services/legacy/hybrid-compute.md b/docs-ref-services/legacy/hybrid-compute.md
index fd82f9d7fb135..9345b3a0d86d1 100644
--- a/docs-ref-services/legacy/hybrid-compute.md
+++ b/docs-ref-services/legacy/hybrid-compute.md
@@ -1,7 +1,7 @@
---
title: Azure Hybrid Compute SDK for Java
description: Reference for Azure Hybrid Compute SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: hybridcompute
diff --git a/docs-ref-services/legacy/image-search.md b/docs-ref-services/legacy/image-search.md
index 0046a1e1cc227..db53d7417fd11 100644
--- a/docs-ref-services/legacy/image-search.md
+++ b/docs-ref-services/legacy/image-search.md
@@ -1,7 +1,7 @@
---
title: Azure Image Search SDK for Java
description: Reference for Azure Image Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: imagesearch
diff --git a/docs-ref-services/legacy/key-vault.md b/docs-ref-services/legacy/key-vault.md
index f3f60b47cabb4..ba982344e8751 100644
--- a/docs-ref-services/legacy/key-vault.md
+++ b/docs-ref-services/legacy/key-vault.md
@@ -1,7 +1,7 @@
---
title: Azure Key Vault SDK for Java
description: Reference for Azure Key Vault SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: keyvault
diff --git a/docs-ref-services/legacy/load-testing.md b/docs-ref-services/legacy/load-testing.md
index e6ded0f69254e..a8c8613d976f7 100644
--- a/docs-ref-services/legacy/load-testing.md
+++ b/docs-ref-services/legacy/load-testing.md
@@ -1,7 +1,7 @@
---
title: Azure Load Testing SDK for Java
description: Reference for Azure Load Testing SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: load-testing
diff --git a/docs-ref-services/legacy/locks.md b/docs-ref-services/legacy/locks.md
index d8d12444752b5..710a6b788acbe 100644
--- a/docs-ref-services/legacy/locks.md
+++ b/docs-ref-services/legacy/locks.md
@@ -1,7 +1,7 @@
---
title: Azure Locks SDK for Java
description: Reference for Azure Locks SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: locks
diff --git a/docs-ref-services/legacy/logz.md b/docs-ref-services/legacy/logz.md
index 9c12a119b4eb5..e0d30b8fffb95 100644
--- a/docs-ref-services/legacy/logz.md
+++ b/docs-ref-services/legacy/logz.md
@@ -1,7 +1,7 @@
---
title: Azure Logz SDK for Java
description: Reference for Azure Logz SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: logz
diff --git a/docs-ref-services/legacy/machine-learning.md b/docs-ref-services/legacy/machine-learning.md
index 4a272698db6e0..a7640a0bfe456 100644
--- a/docs-ref-services/legacy/machine-learning.md
+++ b/docs-ref-services/legacy/machine-learning.md
@@ -1,7 +1,7 @@
---
title: Azure Machine Learning SDK for Java
description: Reference for Azure Machine Learning SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: machinelearning
diff --git a/docs-ref-services/legacy/managed-service-identity.md b/docs-ref-services/legacy/managed-service-identity.md
index fc1f04a300b01..e0e36c86e43e3 100644
--- a/docs-ref-services/legacy/managed-service-identity.md
+++ b/docs-ref-services/legacy/managed-service-identity.md
@@ -1,7 +1,7 @@
---
title: Azure Managed Service Identity SDK for Java
description: Reference for Azure Managed Service Identity SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: managedserviceidentity
diff --git a/docs-ref-services/legacy/maps.md b/docs-ref-services/legacy/maps.md
index acaaca8638e74..d5c48027fe163 100644
--- a/docs-ref-services/legacy/maps.md
+++ b/docs-ref-services/legacy/maps.md
@@ -1,7 +1,7 @@
---
title: Azure Maps SDK for Java
description: Reference for Azure Maps SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: maps
diff --git a/docs-ref-services/legacy/media-services.md b/docs-ref-services/legacy/media-services.md
index 92f1de364cf3c..8561ea7f2e8f7 100644
--- a/docs-ref-services/legacy/media-services.md
+++ b/docs-ref-services/legacy/media-services.md
@@ -1,7 +1,7 @@
---
title: Azure Media Services SDK for Java
description: Reference for Azure Media Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mediaservices
diff --git a/docs-ref-services/legacy/mixed-reality.md b/docs-ref-services/legacy/mixed-reality.md
index d8edcdd61d6ef..8fae438709cd3 100644
--- a/docs-ref-services/legacy/mixed-reality.md
+++ b/docs-ref-services/legacy/mixed-reality.md
@@ -1,7 +1,7 @@
---
title: Azure Mixed Reality SDK for Java
description: Reference for Azure Mixed Reality SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: mixedreality
diff --git a/docs-ref-services/legacy/monitor.md b/docs-ref-services/legacy/monitor.md
index 9026f3aeabaa6..792a65c8ce7b8 100644
--- a/docs-ref-services/legacy/monitor.md
+++ b/docs-ref-services/legacy/monitor.md
@@ -1,7 +1,7 @@
---
title: Azure Monitor SDK for Java
description: Reference for Azure Monitor SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: monitor
diff --git a/docs-ref-services/legacy/network-analytics.md b/docs-ref-services/legacy/network-analytics.md
index 523c366179e98..9130e45b21ec4 100644
--- a/docs-ref-services/legacy/network-analytics.md
+++ b/docs-ref-services/legacy/network-analytics.md
@@ -1,7 +1,7 @@
---
title: Azure Network Analytics SDK for Java
description: Reference for Azure Network Analytics SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: networkanalytics
diff --git a/docs-ref-services/legacy/network.md b/docs-ref-services/legacy/network.md
index 50f71935043a2..862ac792f0cb1 100644
--- a/docs-ref-services/legacy/network.md
+++ b/docs-ref-services/legacy/network.md
@@ -1,7 +1,7 @@
---
title: Azure Network SDK for Java
description: Reference for Azure Network SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: network
diff --git a/docs-ref-services/legacy/news-search.md b/docs-ref-services/legacy/news-search.md
index ba04a3afb8057..a91c43d66fa87 100644
--- a/docs-ref-services/legacy/news-search.md
+++ b/docs-ref-services/legacy/news-search.md
@@ -1,7 +1,7 @@
---
title: Azure News Search SDK for Java
description: Reference for Azure News Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: newssearch
diff --git a/docs-ref-services/legacy/operations-management.md b/docs-ref-services/legacy/operations-management.md
index 8b3fbc262141f..c675a1ccdf074 100644
--- a/docs-ref-services/legacy/operations-management.md
+++ b/docs-ref-services/legacy/operations-management.md
@@ -1,7 +1,7 @@
---
title: Azure Operations Management SDK for Java
description: Reference for Azure Operations Management SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: operationsmanagement
diff --git a/docs-ref-services/legacy/purview.md b/docs-ref-services/legacy/purview.md
index 4c8bb296c0ec2..696fbb8ad0488 100644
--- a/docs-ref-services/legacy/purview.md
+++ b/docs-ref-services/legacy/purview.md
@@ -1,7 +1,7 @@
---
title: Azure Purview SDK for Java
description: Reference for Azure Purview SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-monitor
diff --git a/docs-ref-services/legacy/redis.md b/docs-ref-services/legacy/redis.md
index 946e2b1c777c9..480aaa0132803 100644
--- a/docs-ref-services/legacy/redis.md
+++ b/docs-ref-services/legacy/redis.md
@@ -1,7 +1,7 @@
---
title: Azure Redis SDK for Java
description: Reference for Azure Redis SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: redis
diff --git a/docs-ref-services/legacy/resource-mover.md b/docs-ref-services/legacy/resource-mover.md
index a055fe5d8c5c2..790b1070b7b20 100644
--- a/docs-ref-services/legacy/resource-mover.md
+++ b/docs-ref-services/legacy/resource-mover.md
@@ -1,7 +1,7 @@
---
title: Azure Resource Mover SDK for Java
description: Reference for Azure Resource Mover SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resourcemover
diff --git a/docs-ref-services/legacy/resources.md b/docs-ref-services/legacy/resources.md
index a60359fea51cd..c495e0bb40972 100644
--- a/docs-ref-services/legacy/resources.md
+++ b/docs-ref-services/legacy/resources.md
@@ -1,7 +1,7 @@
---
title: Azure Resources SDK for Java
description: Reference for Azure Resources SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: resources
diff --git a/docs-ref-services/legacy/search.md b/docs-ref-services/legacy/search.md
index 052642c8afff3..267c2bacddba9 100644
--- a/docs-ref-services/legacy/search.md
+++ b/docs-ref-services/legacy/search.md
@@ -1,7 +1,7 @@
---
title: Azure Search SDK for Java
description: Reference for Azure Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cognitive-search
diff --git a/docs-ref-services/legacy/service-bus.md b/docs-ref-services/legacy/service-bus.md
index 7a36ebbda99ea..01282a1752289 100644
--- a/docs-ref-services/legacy/service-bus.md
+++ b/docs-ref-services/legacy/service-bus.md
@@ -1,7 +1,7 @@
---
title: Azure Service Bus SDK for Java
description: Reference for Azure Service Bus SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-service-bus
diff --git a/docs-ref-services/legacy/spring-cloud.md b/docs-ref-services/legacy/spring-cloud.md
index 8ea08cacec144..6d45fbf5fd14f 100644
--- a/docs-ref-services/legacy/spring-cloud.md
+++ b/docs-ref-services/legacy/spring-cloud.md
@@ -1,7 +1,7 @@
---
title: Azure Spring Cloud SDK for Java
description: Reference for Azure Spring Cloud SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: springcloud
diff --git a/docs-ref-services/legacy/sql.md b/docs-ref-services/legacy/sql.md
index 19e51d2751835..7e0ed1bf364db 100644
--- a/docs-ref-services/legacy/sql.md
+++ b/docs-ref-services/legacy/sql.md
@@ -1,7 +1,7 @@
---
title: Azure SQL SDK for Java
description: Reference for Azure SQL SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: sql
diff --git a/docs-ref-services/legacy/storage.md b/docs-ref-services/legacy/storage.md
index 6543d916c444e..e44828bad5db9 100644
--- a/docs-ref-services/legacy/storage.md
+++ b/docs-ref-services/legacy/storage.md
@@ -1,7 +1,7 @@
---
title: Azure Storage SDK for Java
description: Reference for Azure Storage SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: storage
diff --git a/docs-ref-services/legacy/support.md b/docs-ref-services/legacy/support.md
index 8b765ef481f23..473374c55892f 100644
--- a/docs-ref-services/legacy/support.md
+++ b/docs-ref-services/legacy/support.md
@@ -1,7 +1,7 @@
---
title: Azure Support SDK for Java
description: Reference for Azure Support SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: support
diff --git a/docs-ref-services/legacy/traffic-manager.md b/docs-ref-services/legacy/traffic-manager.md
index b08ff6ef3d25d..f2d33ba67bcbb 100644
--- a/docs-ref-services/legacy/traffic-manager.md
+++ b/docs-ref-services/legacy/traffic-manager.md
@@ -1,7 +1,7 @@
---
title: Azure Traffic Manager SDK for Java
description: Reference for Azure Traffic Manager SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: trafficmanager
diff --git a/docs-ref-services/legacy/video-analyzer.md b/docs-ref-services/legacy/video-analyzer.md
index 40d2e459e404c..14c35990f4d29 100644
--- a/docs-ref-services/legacy/video-analyzer.md
+++ b/docs-ref-services/legacy/video-analyzer.md
@@ -1,7 +1,7 @@
---
title: Azure Video Analyzer SDK for Java
description: Reference for Azure Video Analyzer SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: videoanalyzer
diff --git a/docs-ref-services/legacy/video-search.md b/docs-ref-services/legacy/video-search.md
index de9bdd6256eff..879e3cec13987 100644
--- a/docs-ref-services/legacy/video-search.md
+++ b/docs-ref-services/legacy/video-search.md
@@ -1,7 +1,7 @@
---
title: Azure Video Search SDK for Java
description: Reference for Azure Video Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: videosearch
diff --git a/docs-ref-services/legacy/visual-search.md b/docs-ref-services/legacy/visual-search.md
index 575ad3dec2ffe..30254f160f66c 100644
--- a/docs-ref-services/legacy/visual-search.md
+++ b/docs-ref-services/legacy/visual-search.md
@@ -1,7 +1,7 @@
---
title: Azure Visual Search SDK for Java
description: Reference for Azure Visual Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: visualsearch
diff --git a/docs-ref-services/legacy/web-search.md b/docs-ref-services/legacy/web-search.md
index d9fab6ab0268b..e82fb58f5cba9 100644
--- a/docs-ref-services/legacy/web-search.md
+++ b/docs-ref-services/legacy/web-search.md
@@ -1,7 +1,7 @@
---
title: Azure Web Search SDK for Java
description: Reference for Azure Web Search SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: websearch
diff --git a/docs-ref-services/preview/advisor.md b/docs-ref-services/preview/advisor.md
index ee38be9a40653..9227778b039fd 100644
--- a/docs-ref-services/preview/advisor.md
+++ b/docs-ref-services/preview/advisor.md
@@ -1,7 +1,7 @@
---
title: Azure Advisor SDK for Java
description: Reference for Azure Advisor SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: advisor
diff --git a/docs-ref-services/preview/agrifood.md b/docs-ref-services/preview/agrifood.md
index 19d09e93b2e77..90e386e38525e 100644
--- a/docs-ref-services/preview/agrifood.md
+++ b/docs-ref-services/preview/agrifood.md
@@ -1,7 +1,7 @@
---
title: Azure AgriFood SDK for Java
description: Reference for Azure AgriFood SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: agrifood
diff --git a/docs-ref-services/preview/ai-agents-persistent-readme.md b/docs-ref-services/preview/ai-agents-persistent-readme.md
index 8998d52649145..7fcbcc5ce5276 100644
--- a/docs-ref-services/preview/ai-agents-persistent-readme.md
+++ b/docs-ref-services/preview/ai-agents-persistent-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Agents client library for Java
keywords: Azure, java, SDK, API, azure-ai-agents-persistent, ai
-ms.date: 06/17/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: ai
---
-# Azure Agents client library for Java - version 1.0.0-beta.2
+# Azure Agents client library for Java - version 1.0.0-alpha.20250805.1
Azure Agents client library for Java.
@@ -71,7 +71,7 @@ Always ensure that the chosen API version is fully supported and operational for
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-agents-persistent_1.0.0-beta.2/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -84,5 +84,5 @@ For details on contributing to this repository, see the [contributing guide](htt
[docs]: https://azure.github.io/azure-sdk-for-java/
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-agents-persistent_1.0.0-beta.2/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
diff --git a/docs-ref-services/preview/ai-anomalydetector-readme.md b/docs-ref-services/preview/ai-anomalydetector-readme.md
new file mode 100644
index 0000000000000..6e365854d0270
--- /dev/null
+++ b/docs-ref-services/preview/ai-anomalydetector-readme.md
@@ -0,0 +1,254 @@
+---
+title: Azure Anomaly Detector client library for Java
+keywords: Azure, java, SDK, API, azure-ai-anomalydetector, anomalydetector
+ms.date: 08/05/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: anomalydetector
+---
+# Azure Anomaly Detector client library for Java - version 3.0.0-alpha.20250805.1
+
+
+[Anomaly Detector](https://learn.microsoft.com/azure/cognitive-services/Anomaly-Detector/overview) is an AI service with a set of APIs, which enables you to monitor and detect anomalies in your time series data with little machine learning (ML) knowledge, either batch validation or real-time inference.
+
+[Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][samples_readme]
+
+## Getting started
+
+### Prerequisites
+
+- A [Java Development Kit (JDK)][jdk_link], version 11 or later.
+- [Azure Subscription][azure_subscription]
+- An existing Cognitive Services or Anomaly Detector resource.
+
+For more information about creating the resource or how to get the location and sku information see
+[here][cognitive_resource_cli].
+
+### Include the Package
+
+[//]: # ({x-version-update-start;com.azure:azure-ai-anomalydetector;current})
+
+```xml
+
+ com.azure
+ azure-ai-anomalydetector
+ 3.0.0-beta.6
+
+```
+
+[//]: # ({x-version-update-end})
+
+### Authenticate the client
+
+In order to interact with the Anomaly Detector service, you'll need to create an instance of
+[`MultivariateClient`][multivariate_client_class], [`MultivariateAsyncClient`][multivariate_async_client_class],
+[`UnivariateClient`][univariate_client_class], or [`UnivariateAsyncClient`][univariate_async_client_class]. You will
+need an **endpoint** and an **API key** to instantiate a client object.
+
+#### Get API Key
+
+You can obtain the endpoint and API key from the resource information in the [Azure Portal][azure_portal].
+
+Alternatively, you can use the [Azure CLI][azure_cli] snippet below to get the API key from the Anomaly Detector resource.
+
+```bash
+az cognitiveservices account keys list --resource-group --name
+```
+
+#### Create AnomalyDetectorClient with Azure Active Directory Credential
+
+You can authenticate with Azure Active Directory using the [Azure Identity library][azure_identity]. Note that regional
+endpoints do not support AAD authentication. Create a [custom subdomain][custom_subdomain] for your resource in order
+to use this type of authentication.
+
+To use the [DefaultAzureCredential][DefaultAzureCredential] provider shown below, or other credential providers provided
+with the Azure SDK, please include the `azure-identity` package:
+
+[//]: # ({x-version-update-start;com.azure:azure-identity;dependency})
+
+```xml
+
+ com.azure
+ azure-identity
+ 1.15.3
+
+```
+
+You will also need to [register a new AAD application][register_aad_app] and [grant access][aad_grant_access] to
+Anomaly Detector by assigning the `"Cognitive Services User"` role to your service principal.
+
+Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
+AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.
+
+##### Sync client
+
+```java readme-sample-createAnomalyDetectorClient
+String endpoint = Configuration.getGlobalConfiguration().get("AZURE_ANOMALY_DETECTOR_ENDPOINT");
+String key = Configuration.getGlobalConfiguration().get("AZURE_ANOMALY_DETECTOR_API_KEY");
+
+MultivariateClient multivariateClient = new AnomalyDetectorClientBuilder()
+ .credential(new AzureKeyCredential(key))
+ .endpoint(endpoint)
+ .buildMultivariateClient();
+
+UnivariateClient univariateClient = new AnomalyDetectorClientBuilder()
+ .credential(new AzureKeyCredential(key))
+ .endpoint(endpoint)
+ .buildUnivariateClient();
+```
+
+## Key concepts
+
+With the Anomaly Detector, you can either detect anomalies in one variable using **Univariate Anomaly Detection**, or
+detect anomalies in multiple variables with **Multivariate Anomaly Detection**.
+
+|Feature |Description |
+|---------|---------|
+|Univariate Anomaly Detection | Detect anomalies in one variable, like revenue, cost, etc. The model was selected automatically based on your data pattern. |
+|Multivariate Anomaly Detection| Detect anomalies in multiple variables with correlations, which are usually gathered from equipment or other complex system. The underlying model used is Graph attention network.|
+
+### Univariate Anomaly Detection
+
+The Univariate Anomaly Detection API enables you to monitor and detect abnormalities in your time series data without
+having to know machine learning. The algorithms adapt by automatically identifying and applying the best-fitting models
+to your data, regardless of industry, scenario, or data volume. Using your time series data, the API determines
+boundaries for anomaly detection, expected values, and which data points are anomalies.
+
+Using the Anomaly Detector doesn't require any prior experience in machine learning, and the REST API enables you to
+easily integrate the service into your applications and processes.
+
+With the Univariate Anomaly Detection, you can automatically detect anomalies throughout your time series data, or as
+they occur in real-time.
+
+|Feature |Description |
+|---------|---------|
+| Streaming detection| Detect anomalies in your streaming data by using previously seen data points to determine if your latest one is an anomaly. This operation generates a model using the data points you send, and determines if the target point is an anomaly. By calling the API with each new data point you generate, you can monitor your data as it's created. |
+| Batch detection | Use your time series to detect any anomalies that might exist throughout your data. This operation generates a model using your entire time series data, with each point analyzed with the same model. |
+| Change points detection | Use your time series to detect any trend change points that exist in your data. This operation generates a model using your entire time series data, with each point analyzed with the same model. |
+
+### Multivariate Anomaly Detection
+
+The **Multivariate Anomaly Detection** APIs further enable developers by easily integrating advanced AI for detecting
+anomalies from groups of metrics, without the need for machine learning knowledge or labeled data. Dependencies and
+inter-correlations between up to 300 different signals are now automatically counted as key factors. This new
+capability helps you to proactively protect your complex systems such as software applications, servers, factory
+machines, spacecraft, or even your business, from failures.
+
+With the Multivariate Anomaly Detection, you can automatically detect anomalies throughout your time series data, or as
+they occur in real-time. There are three processes to use Multivariate Anomaly Detection.
+
+- **Training**: Use Train Model API to create and train a model, then use Get Model Status API to get the status and model metadata.
+- **Inference**:
+ - Use Async Inference API to trigger an asynchronous inference process and use Get Inference results API to get detection results on a batch of data.
+ - You could also use Sync Inference API to trigger a detection on one timestamp every time.
+- **Other operations**: List Model API and Delete Model API are supported in Multivariate Anomaly Detection model for model management.
+
+### Thread safety
+
+We guarantee that all client instance methods are thread-safe and independent of each other. This
+ensures that the recommendation of reusing client instances is always safe, even across threads.
+
+## Examples
+
+The following section provides several code snippets covering some of the most common Anomaly Detector service tasks,
+including:
+
+- [Univariate Anomaly Detection - Batch detection](#batch-detection)
+- [Univariate Anomaly Detection - Streaming detection](#streaming-detection)
+- [Univariate Anomaly Detection - Detect change points](#detect-change-points)
+- [Multivariate Anomaly Detection](#multivariate-anomaly-detection-sample)
+
+### Create client
+
+```java readme-sample-createAnomalyDetectorClient
+String endpoint = Configuration.getGlobalConfiguration().get("AZURE_ANOMALY_DETECTOR_ENDPOINT");
+String key = Configuration.getGlobalConfiguration().get("AZURE_ANOMALY_DETECTOR_API_KEY");
+
+MultivariateClient multivariateClient = new AnomalyDetectorClientBuilder()
+ .credential(new AzureKeyCredential(key))
+ .endpoint(endpoint)
+ .buildMultivariateClient();
+
+UnivariateClient univariateClient = new AnomalyDetectorClientBuilder()
+ .credential(new AzureKeyCredential(key))
+ .endpoint(endpoint)
+ .buildUnivariateClient();
+```
+
+### Batch detection
+
+For batch detection in univariate anomaly detection, please go to this sample for better understanding the workflow:
+[DetectAnomaliesEntireSeries.java](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/java/com/azure/ai/anomalydetector/DetectAnomaliesEntireSeries.java)
+
+### Streaming detection
+
+For streaming/last detection in univariate anomaly detection, please go to this sample for better understanding the
+workflow: [DetectAnomaliesLastPoint.java](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/java/com/azure/ai/anomalydetector/DetectAnomaliesLastPoint.java)
+
+### Detect change points
+
+For change points detection in univariate anomaly detection, please go to this sample for better understanding the
+workflow: [DetectChangePoints.java](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/java/com/azure/ai/anomalydetector/DetectChangePoints.java)
+
+### Multivariate Anomaly Detection Sample
+
+To see how to use Anomaly Detector library to conduct Multivariate Anomaly Detection, see this [MultivariateSample.java](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/java/com/azure/ai/anomalydetector/MultivariateSample.java).
+
+## Troubleshooting
+
+### Enabling Logging
+
+Azure SDKs for Java offer a consistent logging story to help aid in troubleshooting application errors and expedite
+their resolution. The logs produced will capture the flow of an application before reaching the terminal state to help
+locate the root issue. View the [logging][logging] wiki for guidance about enabling logging.
+
+## Next steps
+
+These code samples show common scenario operations with the Azure Anomaly Detector library. More samples can be found
+under the [samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/java/com/azure/ai/anomalydetector) directory.
+
+For more extensive documentation on Azure Anomaly Detector, see the [Anomaly Detector documentation](https://learn.microsoft.com/azure/cognitive-services/anomaly-detector/overview) on
+learn.microsoft.com.
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License
+Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution.
+For details, visit [cla.microsoft.com][cla].
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate
+the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to
+do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct][code_of_conduct]. For more information see the
+[Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
+
+
+[cla]: https://cla.microsoft.com
+[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
+[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
+[coc_contact]: mailto:opencode@microsoft.com
+[samples]: src/samples/java/com/azure/ai/anomalydetector
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src
+[samples_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/
+[azure_subscription]: https://azure.microsoft.com/free/
+[api_reference_doc]: https://azure.github.io/azure-sdk-for-java/
+[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/anomaly-detector/
+[cognitive_resource_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli
+[multivariate_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/8b2622353dd8c4a03a87c7e04a6f82bf0712bab5/sdk/anomalydetector/azure-ai-anomalydetector/src/main/java/com/azure/ai/anomalydetector/MultivariateClient.java
+[multivariate_async_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/8b2622353dd8c4a03a87c7e04a6f82bf0712bab5/sdk/anomalydetector/azure-ai-anomalydetector/src/main/java/com/azure/ai/anomalydetector/MultivariateAsyncClient.java
+[univariate_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/8b2622353dd8c4a03a87c7e04a6f82bf0712bab5/sdk/anomalydetector/azure-ai-anomalydetector/src/main/java/com/azure/ai/anomalydetector/UnivariateClient.java
+[univariate_async_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/8b2622353dd8c4a03a87c7e04a6f82bf0712bab5/sdk/anomalydetector/azure-ai-anomalydetector/src/main/java/com/azure/ai/anomalydetector/UnivariateAsyncClient.java
+[azure_cli]: https://learn.microsoft.com/cli/azure
+[azure_portal]: https://portal.azure.com
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
+[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#defaultazurecredential
+[custom_subdomain]: https://learn.microsoft.com/azure/cognitive-services/authentication#create-a-resource-with-a-custom-subdomain
+[register_aad_app]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[aad_grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[package]: https://central.sonatype.com/artifact/com.azure/azure-ai-anomalydetector
+[samples_readme]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/anomalydetector/azure-ai-anomalydetector/src/samples/README.md
+[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK
+
+
diff --git a/docs-ref-services/preview/ai-contentsafety-readme.md b/docs-ref-services/preview/ai-contentsafety-readme.md
index 110433f206278..0d3d2af7a25ce 100644
--- a/docs-ref-services/preview/ai-contentsafety-readme.md
+++ b/docs-ref-services/preview/ai-contentsafety-readme.md
@@ -1,18 +1,18 @@
---
title: Azure ContentSafety client library for Java
keywords: Azure, java, SDK, API, azure-ai-contentsafety, contentsafety
-ms.date: 09/22/2023
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: contentsafety
---
-# Azure ContentSafety client library for Java - version 1.0.0-beta.1
+# Azure ContentSafety client library for Java - version 1.1.0-alpha.20250804.2
[Azure AI Content Safety][contentsafety_overview] detects harmful user-generated and AI-generated content in applications and services. Content Safety includes several APIs that allow you to detect material that is harmful:
-* Text Analysis API: Scans text for sexual content, violence, hate, and self harm with multi-severity levels.
-* Image Analysis API: Scans images for sexual content, violence, hate, and self harm with multi-severity levels.
+* Text Analysis API: Scans text for sexual content, violence, hate, and self-harm with multi-severity levels.
+* Image Analysis API: Scans images for sexual content, violence, hate, and self-harm with multi-severity levels.
* Text Blocklist Management APIs: The default AI classifiers are sufficient for most content safety needs; however, you might need to screen for terms that are specific to your use case. You can create blocklists of terms to use with the Text API.
## Documentation
@@ -27,8 +27,8 @@ Various documentation is available to help you get started
### Prerequisites
- [Java Development Kit (JDK)][jdk] with version 8 or above
-- You need an [Azure subscription][azure_sub] to use this package.
-- An existing [Azure AI Content Safety][contentsafety_overview] instance.
+- You need an [Azure subscription][azure_subscription] to use this package.
+- An [Azure AI Content Safety][contentsafety_overview] resource, if no existing resource, you could [create a new one](https://aka.ms/acs-create).
### Adding the package to your product
@@ -37,7 +37,7 @@ Various documentation is available to help you get started
com.azureazure-ai-contentsafety
- 1.0.0-beta.1
+ 1.1.0-beta.1
```
[//]: # ({x-version-update-end})
@@ -59,53 +59,90 @@ The API key can be found in the [Azure Portal][azure_portal] or by running the f
```bash
az cognitiveservices account keys list --name "" --resource-group ""
```
-#### Create a ContentSafetyClient with KeyCredential
-```java com.azure.ai.contentsafety.createClient
+
+#### Create a ContentSafetyClient/BlocklistClient with KeyCredential
+```java com.azure.ai.contentsafety.createclientcredential
String endpoint = Configuration.getGlobalConfiguration().get("CONTENT_SAFETY_ENDPOINT");
String key = Configuration.getGlobalConfiguration().get("CONTENT_SAFETY_KEY");
-
ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder()
.credential(new KeyCredential(key))
.endpoint(endpoint).buildClient();
+BlocklistClient blocklistClient = new BlocklistClientBuilder()
+ .credential(new KeyCredential(key))
+ .endpoint(endpoint).buildClient();
+```
+#### Create a ContentSafetyClient/BlocklistClient with Microsoft Entra ID (formerly Azure Active Directory (AAD)) token credential
+- Step 1: Enable Microsoft Entra ID for your resource
+Please refer to this Cognitive Services authentication document [Authenticate with Microsoft Entra ID.][authenticate_with_microsoft_entra_id] for the steps to enable AAD for your resource.
+ The main steps are:
+ - Create resource with a custom subdomain.
+ - Create Service Principal and assign Cognitive Services User role to it.
+
+- Step 2: Set the values of the client ID, tenant ID, and client secret of the Enable Microsoft Entra ID application as environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`.
+
+After setup, you can use [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#authenticate-with-defaultazurecredential)
+can be used to authenticate the client.
+
+DefaultAzureCredential will use the values from these environment variables.
+```java com.azure.ai.contentsafety.createclienttoken
+ContentSafetyClient contentSafetyClientOauth = new ContentSafetyClientBuilder()
+ .credential(new DefaultAzureCredentialBuilder().build())
+ .endpoint(endpoint).buildClient();
+BlocklistClient blocklistClientOauth = new BlocklistClientBuilder()
+ .credential(new DefaultAzureCredentialBuilder().build())
+ .endpoint(endpoint).buildClient();
```
## Key concepts
-### Harm categories
+### Available features
+There are different types of analysis available from this service. The following table describes the currently available APIs.
+
+|Feature | Description |
+|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+|Text Analysis API| Scans text for sexual content, violence, hate, and self-harm with multi-severity levels. |
+|Image Analysis API| Scans images for sexual content, violence, hate, and self-harm with multi-severity levels. |
+| Text Blocklist Management APIs| The default AI classifiers are sufficient for most content safety needs. However, you might need to screen for terms that are specific to your use case. You can create blocklists of terms to use with the Text API. |
+### Harm categories
Content Safety recognizes four distinct categories of objectionable content.
-|Category |Description |
+|Category|Description|
|---------|---------|
-|Hate |Hate refers to any content that attacks or uses pejorative or discriminatory language in reference to a person or identity group based on certain differentiating attributes of that group. This includes but is not limited to race, ethnicity, nationality, gender identity and expression, sexual orientation, religion, immigration status, ability status, personal appearance, and body size.|
-|Sexual |Sexual describes content related to anatomical organs and genitals, romantic relationships, acts portrayed in erotic or affectionate terms, pregnancy, physical sexual acts—including those acts portrayed as an assault or a forced sexual violent act against one’s will—, prostitution, pornography, and abuse.|
-|Violence |Violence describes content related to physical actions intended to hurt, injure, damage, or kill someone or something. It also includes weapons, guns and related entities, such as manufacturers, associations, legislation, and similar.|
-|Self-harm |Self-harm describes content related to physical actions intended to purposely hurt, injure, or damage one’s body or kill oneself.|
+|Hate |Hate and fairness-related harms refer to any content that attacks or uses pejorative or discriminatory language with reference to a person or identity group based on certain differentiating attributes of these groups including but not limited to race, ethnicity, nationality, gender identity and expression, sexual orientation, religion, immigration status, ability status, personal appearance, and body size.|
+|Sexual |Sexual describes language related to anatomical organs and genitals, romantic relationships, acts portrayed in erotic or affectionate terms, pregnancy, physical sexual acts, including those portrayed as an assault or a forced sexual violent act against one's will, prostitution, pornography, and abuse.|
+|Violence |Violence describes language related to physical actions intended to hurt, injure, damage, or kill someone or something; describes weapons, guns and related entities, such as manufactures, associations, legislation, and so on.|
+|Self-harm |Self-harm describes language related to physical actions intended to purposely hurt, injure, damage one's body or kill oneself.|
Classification can be multi-labeled. For example, when a text sample goes through the text moderation model, it could be classified as both Sexual content and Violence.
### Severity levels
-
Every harm category the service applies also comes with a severity level rating. The severity level is meant to indicate the severity of the consequences of showing the flagged content.
-|Severity |Label |
-|---------|---------|
-|0 |Safe|
-|2 |Low|
-|4 |Medium|
-|6 |High|
+**Text**: The current version of the text model supports the **full 0-7 severity scale**. By default, the response will output 4 values: 0, 2, 4, and 6. Each two adjacent levels are mapped to a single level. Users could use "outputType" in request and set it as "EightSeverityLevels" to get 8 values in output: 0,1,2,3,4,5,6,7.
+You can refer [text content severity levels definitions][text_severity_levels] for details.
-### Text blocklist management
+- [0,1] -> 0
+- [2,3] -> 2
+- [4,5] -> 4
+- [6,7] -> 6
-Following operations are supported to manage your text blocklist:
+**Image**: The current version of the image model supports the **trimmed version of the full 0-7 severity scale**. The classifier only returns severities 0, 2, 4, and 6; each two adjacent levels are mapped to a single level. You can refer [image content severity levels definitions][image_severity_levels] for details.
+
+- [0,1] -> 0
+- [2,3] -> 2
+- [4,5] -> 4
+- [6,7] -> 6
-* Create or modify a blocklist
-* List all blocklists
-* Get a blocklist by blocklistName
-* Add blockItems to a blocklist
-* Remove blockItems from a blocklist
-* List all blockItems in a blocklist by blocklistName
-* Get a blockItem in a blocklist by blockItemId and blocklistName
-* Delete a blocklist and all of its blockItems
+### Text blocklist management
+Following operations are supported to manage your text blocklist:
+- Create or modify a blocklist
+- List all blocklists
+- Get a blocklist by blocklistName
+- Add blockItems to a blocklist
+- Remove blocklistItems from a blocklist
+- List all blocklistItems in a blocklist by blocklistName
+- Get a blocklistItem in a blocklist by blocklistItemId and blocklistName
+- Delete a blocklist and all of its blocklistItems
You can set the blocklists you want to use when analyze text, then you can get blocklist match result from returned response.
@@ -128,18 +165,20 @@ ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder()
AnalyzeTextResult response = contentSafetyClient.analyzeText(new AnalyzeTextOptions("This is text example"));
-System.out.println("Hate severity: " + response.getHateResult().getSeverity());
-System.out.println("SelfHarm severity: " + response.getSelfHarmResult().getSeverity());
-System.out.println("Sexual severity: " + response.getSexualResult().getSeverity());
-System.out.println("Violence severity: " + response.getViolenceResult().getSeverity());
+for (TextCategoriesAnalysis result : response.getCategoriesAnalysis()) {
+ System.out.println(result.getCategory() + " severity: " + result.getSeverity());
+}
```
#### Analyze text with blocklists
```java com.azure.ai.contentsafety.analyzetextwithblocklist
// After you edit your blocklist, it usually takes effect in 5 minutes, please wait some time before analyzing with blocklist after editing.
+ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder()
+ .credential(new KeyCredential(key))
+ .endpoint(endpoint).buildClient();
AnalyzeTextOptions request = new AnalyzeTextOptions("I h*te you and I want to k*ll you");
-request.getBlocklistNames().add(blocklistName);
-request.setBreakByBlocklists(true);
+request.setBlocklistNames(Arrays.asList(blocklistName));
+request.setHaltOnBlocklistHit(true);
AnalyzeTextResult analyzeTextResult;
try {
@@ -149,11 +188,10 @@ try {
throw ex;
}
-if (analyzeTextResult.getBlocklistsMatchResults() != null) {
+if (analyzeTextResult.getBlocklistsMatch() != null) {
System.out.println("\nBlocklist match result:");
- for (TextBlocklistMatchResult matchResult : analyzeTextResult.getBlocklistsMatchResults()) {
- System.out.println("Blockitem was hit in text: Offset: " + matchResult.getOffset() + ", Length: " + matchResult.getLength());
- System.out.println("BlocklistName: " + matchResult.getBlocklistName() + ", BlockItemId: " + matchResult.getBlockItemId() + ", BlockItemText: " + matchResult.getBlockItemText());
+ for (TextBlocklistMatch matchResult : analyzeTextResult.getBlocklistsMatch()) {
+ System.out.println("BlocklistName: " + matchResult.getBlocklistName() + ", BlockItemId: " + matchResult.getBlocklistItemId() + ", BlockItemText: " + matchResult.getBlocklistItemText());
}
}
```
@@ -167,18 +205,17 @@ ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder()
.credential(new KeyCredential(key))
.endpoint(endpoint).buildClient();
-ImageData image = new ImageData();
+ContentSafetyImageData image = new ContentSafetyImageData();
String cwd = System.getProperty("user.dir");
-String source = "/src/samples/resources/image.jpg";
-image.setContent(Files.readAllBytes(Paths.get(cwd, source)));
+String source = "/src/samples/resources/image.png";
+image.setContent(BinaryData.fromBytes(Files.readAllBytes(Paths.get(cwd, source))));
AnalyzeImageResult response =
- contentSafetyClient.analyzeImage(new AnalyzeImageOptions(image));
+ contentSafetyClient.analyzeImage(new AnalyzeImageOptions(image));
-System.out.println("Hate severity: " + response.getHateResult().getSeverity());
-System.out.println("SelfHarm severity: " + response.getSelfHarmResult().getSeverity());
-System.out.println("Sexual severity: " + response.getSexualResult().getSeverity());
-System.out.println("Violence severity: " + response.getViolenceResult().getSeverity());
+for (ImageCategoriesAnalysis result : response.getCategoriesAnalysis()) {
+ System.out.println(result.getCategory() + " severity: " + result.getSeverity());
+}
```
### Manage text blocklist
@@ -191,7 +228,7 @@ description.put("description", "Test Blocklist");
BinaryData resource = BinaryData.fromObject(description);
RequestOptions requestOptions = new RequestOptions();
Response response =
- contentSafetyClient.createOrUpdateTextBlocklistWithResponse(blocklistName, resource, requestOptions);
+ blocklistClient.createOrUpdateTextBlocklistWithResponse(blocklistName, resource, requestOptions);
if (response.getStatusCode() == 201) {
System.out.println("\nBlocklist " + blocklistName + " created.");
} else if (response.getStatusCode() == 200) {
@@ -202,57 +239,58 @@ if (response.getStatusCode() == 201) {
```java com.azure.ai.contentsafety.addblockitems
String blockItemText1 = "k*ll";
String blockItemText2 = "h*te";
-List blockItems = Arrays.asList(new TextBlockItemInfo(blockItemText1).setDescription("Kill word"),
- new TextBlockItemInfo(blockItemText2).setDescription("Hate word"));
-AddBlockItemsResult addedBlockItems = contentSafetyClient.addBlockItems(blocklistName, new AddBlockItemsOptions(blockItems));
-if (addedBlockItems != null && addedBlockItems.getValue() != null) {
+List blockItems = Arrays.asList(new TextBlocklistItem(blockItemText1).setDescription("Kill word"),
+ new TextBlocklistItem(blockItemText2).setDescription("Hate word"));
+AddOrUpdateTextBlocklistItemsResult addedBlockItems = blocklistClient.addOrUpdateBlocklistItems(blocklistName,
+ new AddOrUpdateTextBlocklistItemsOptions(blockItems));
+if (addedBlockItems != null && addedBlockItems.getBlocklistItems() != null) {
System.out.println("\nBlockItems added:");
- for (TextBlockItem addedBlockItem : addedBlockItems.getValue()) {
- System.out.println("BlockItemId: " + addedBlockItem.getBlockItemId() + ", Text: " + addedBlockItem.getText() + ", Description: " + addedBlockItem.getDescription());
+ for (TextBlocklistItem addedBlockItem : addedBlockItems.getBlocklistItems()) {
+ System.out.println("BlockItemId: " + addedBlockItem.getBlocklistItemId() + ", Text: " + addedBlockItem.getText() + ", Description: " + addedBlockItem.getDescription());
}
}
```
#### List text blocklists
```java com.azure.ai.contentsafety.listtextblocklists
-PagedIterable allTextBlocklists = contentSafetyClient.listTextBlocklists();
+PagedIterable allTextBlocklists = blocklistClient.listTextBlocklists();
System.out.println("\nList Blocklist:");
for (TextBlocklist blocklist : allTextBlocklists) {
- System.out.println("Blocklist: " + blocklist.getBlocklistName() + ", Description: " + blocklist.getDescription());
+ System.out.println("Blocklist: " + blocklist.getName() + ", Description: " + blocklist.getDescription());
}
```
#### Get text blocklist
```java com.azure.ai.contentsafety.gettextblocklist
-TextBlocklist getBlocklist = contentSafetyClient.getTextBlocklist(blocklistName);
+TextBlocklist getBlocklist = blocklistClient.getTextBlocklist(blocklistName);
if (getBlocklist != null) {
System.out.println("\nGet blocklist:");
- System.out.println("BlocklistName: " + getBlocklist.getBlocklistName() + ", Description: " + getBlocklist.getDescription());
+ System.out.println("BlocklistName: " + getBlocklist.getName() + ", Description: " + getBlocklist.getDescription());
}
```
#### List blockItems
``` java com.azure.ai.contentsafety.listtextblocklistitems
-PagedIterable allBlockitems = contentSafetyClient.listTextBlocklistItems(blocklistName);
+PagedIterable allBlockitems = blocklistClient.listTextBlocklistItems(blocklistName);
System.out.println("\nList BlockItems:");
-for (TextBlockItem blocklistItem : allBlockitems) {
- System.out.println("BlockItemId: " + blocklistItem.getBlockItemId() + ", Text: " + blocklistItem.getText() + ", Description: " + blocklistItem.getDescription());
+for (TextBlocklistItem blocklistItem : allBlockitems) {
+ System.out.println("BlockItemId: " + blocklistItem.getBlocklistItemId() + ", Text: " + blocklistItem.getText() + ", Description: " + blocklistItem.getDescription());
}
```
#### Get blockItem
```java com.azure.ai.contentsafety.gettextblocklistitem
-String getBlockItemId = addedBlockItems.getValue().get(0).getBlockItemId();
-TextBlockItem getBlockItem = contentSafetyClient.getTextBlocklistItem(blocklistName, getBlockItemId);
+String getBlockItemId = addedBlockItems.getBlocklistItems().get(0).getBlocklistItemId();
+TextBlocklistItem getBlockItem = blocklistClient.getTextBlocklistItem(blocklistName, getBlockItemId);
System.out.println("\nGet BlockItem:");
-System.out.println("BlockItemId: " + getBlockItem.getBlockItemId() + ", Text: " + getBlockItem.getText() + ", Description: " + getBlockItem.getDescription());
+System.out.println("BlockItemId: " + getBlockItem.getBlocklistItemId() + ", Text: " + getBlockItem.getText() + ", Description: " + getBlockItem.getDescription());
```
#### Remove blockItems
```java com.azure.ai.contentsafety.removeblockitems
-String removeBlockItemId = addedBlockItems.getValue().get(0).getBlockItemId();
+String removeBlockItemId = addedBlockItems.getBlocklistItems().get(0).getBlocklistItemId();
List removeBlockItemIds = new ArrayList<>();
removeBlockItemIds.add(removeBlockItemId);
-contentSafetyClient.removeBlockItems(blocklistName, new RemoveBlockItemsOptions(removeBlockItemIds));
+blocklistClient.removeBlocklistItems(blocklistName, new RemoveTextBlocklistItemsOptions(removeBlockItemIds));
```
#### Delete text blocklist
```java com.azure.ai.contentsafety.deletetextblocklist
-contentSafetyClient.deleteTextBlocklist(blocklistName);
+blocklistClient.deleteTextBlocklist(blocklistName);
```
## Troubleshooting
### General
@@ -271,11 +309,11 @@ Azure AI Content Safety client library will raise exceptions defined in [Azure C
## Next steps
### Additional documentation
-For more extensive documentation on Azure Content Safety, see the [Azure AI Content Safety][contentsafety_overview] on docs.microsoft.com.
+For more extensive documentation on Azure Content Safety, see the [Azure AI Content Safety][contentsafety_overview] on learn.microsoft.com.
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-contentsafety_1.0.0-beta.1/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -286,13 +324,15 @@ For details on contributing to this repository, see the [contributing guide](htt
[product_documentation]: https://aka.ms/acs-doc
[docs]: https://azure.github.io/azure-sdk-for-java/
-[jdk]: /java/azure/jdk/
+[jdk]: https://learn.microsoft.com/java/azure/jdk/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-contentsafety_1.0.0-beta.1/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
[contentsafety_overview]: https://aka.ms/acs-doc
[azure_portal]: https://ms.portal.azure.com/
-[azure_cli_endpoint_lookup]: /cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
-[azure_cli_key_lookup]: /cli/azure/cognitiveservices/account/keys?view=azure-cli-latest#az-cognitiveservices-account-keys-list
-
+[azure_cli_endpoint_lookup]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
+[azure_cli_key_lookup]: https://learn.microsoft.com/cli/azure/cognitiveservices/account/keys?view=azure-cli-latest#az-cognitiveservices-account-keys-list
+[authenticate_with_microsoft_entra_id]: https://learn.microsoft.com/azure/ai-services/authentication?tabs=powershell#authenticate-with-microsoft-entra-id
+[text_severity_levels]: https://learn.microsoft.com/azure/ai-services/content-safety/concepts/harm-categories?tabs=definitions#text-content
+[image_severity_levels]: https://learn.microsoft.com/azure/ai-services/content-safety/concepts/harm-categories?tabs=definitions#image-content
diff --git a/docs-ref-services/preview/ai-documentintelligence-readme.md b/docs-ref-services/preview/ai-documentintelligence-readme.md
index d6a933b6d6f4e..91f54b57862c8 100644
--- a/docs-ref-services/preview/ai-documentintelligence-readme.md
+++ b/docs-ref-services/preview/ai-documentintelligence-readme.md
@@ -1,12 +1,12 @@
---
title: Azure DocumentIntelligence client library for Java
keywords: Azure, java, SDK, API, azure-ai-documentintelligence, documentintelligence
-ms.date: 08/15/2024
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: documentintelligence
---
-# Azure DocumentIntelligence client library for Java - version 1.0.0-beta.4
+# Azure DocumentIntelligence client library for Java - version 1.1.0-alpha.20250804.2
Azure Document Intelligence ([previously known as Form Recognizer][service-rename]) is a cloud service that uses machine
@@ -18,6 +18,7 @@ It includes the following main features:
* Custom - Build custom models to extract text, field values, selection marks, and table data from documents. Custom models are built with your own data, so they're tailored to your documents.
* Read - Read information about textual elements, such as page words and lines in addition to text language information.
* Classifiers - Build custom classifiers to categorize documents into predefined classes.
+- Batch analysis - Analyze multiple documents using a single request.
[Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][sample_readme]
@@ -37,7 +38,7 @@ It includes the following main features:
com.azureazure-ai-documentintelligence
- 1.0.0-beta.4
+ 1.1.0-beta.1
```
[//]: # ({x-version-update-end})
@@ -52,15 +53,16 @@ This table shows the relationship between SDK versions and supported API version
| 1.0.0-beta.2 | 2024-02-29-preview |
| 1.0.0-beta.3 | 2024-02-29-preview |
| 1.0.0-beta.4 | 2024-07-31-preview |
+| 1.0.0 | 2024-11-30 |
> Note: Please rely on the older `azure-ai-formrecognizer` library through the older service API versions for retired
> models, such as `"prebuilt-businessCard"` and `"prebuilt-document"`. For more information, see [Changelog][changelog].
> The below table describes the relationship of each client and its supported API version(s):
-| API version | Supported clients |
-|------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
-| 2023-10-31-preview, 2024-02-29-preview, 2024-07-31-preview | DocumentIntelligenceClient and DocumentIntelligenceAsyncClient |
-| 2023-07-31 | DocumentAnalysisClient and DocumentModelAdministrationClient in `azure-ai-formrecognizer` SDK |
+| API version | Supported clients |
+|------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
+| 2023-10-31-preview, 2024-02-29-preview, 2024-07-31-preview, 2024-11-30 | DocumentIntelligenceClient and DocumentIntelligenceAsyncClient |
+| 2023-07-31 | DocumentAnalysisClient and DocumentModelAdministrationClient in `azure-ai-formrecognizer` SDK |
Please see the [Migration Guide][migration_guide] for more information about migrating from `azure-ai-formrecognizer` to `azure-ai-documentintelligence`.
@@ -82,12 +84,11 @@ DocumentIntelligenceClient documentIntelligenceClient = new DocumentIntelligence
.buildClient();
```
or
-```java readme-sample-createDocumentModelAdministrationClient
-DocumentIntelligenceAdministrationClient client =
- new DocumentIntelligenceAdministrationClientBuilder()
- .credential(new AzureKeyCredential("{key}"))
- .endpoint("{endpoint}")
- .buildClient();
+```java com.azure.ai.documentanalysis.readme.DocumentIntelligenceAdministrationClient
+DocumentIntelligenceAdministrationClient documentIntelligenceAsyncClient = new DocumentIntelligenceAdministrationClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildClient();
```
#### Create an Azure DocumentIntelligence client with Azure Active Directory credential
@@ -102,7 +103,7 @@ Authentication with AAD requires some initial setup:
com.azureazure-identity
- 1.13.2
+ 1.15.3
```
[//]: # ({x-version-update-end})
@@ -122,7 +123,23 @@ DocumentIntelligenceAsyncClient documentIntelligenceAsyncClient = new DocumentIn
.endpoint("{endpoint}")
.buildAsyncClient();
```
+You will also need to [register a new Microsoft Entra application][register_aad_app] and grant access to Document Intelligence by assigning the `"Cognitive Services Data Reader"` role to your service principal.
+It is strongly recommended to use Microsoft Entra ID as your default authentication approach. On the other hand, using an `AzureKeyCredential` can be helpful on getting-started scenarios since it can be set up fastly.
+##### Get the API Key
+
+The API key can be found in the [Azure Portal][azure_portal_get_endpoint] or by running the following Azure CLI command:
+
+```PowerShell
+az cognitiveservices account keys list --name "" --resource-group ""
+```
+
+```java com.azure.ai.documentanalysis.readme.DocumentIntelligenceAdministrationClient
+DocumentIntelligenceAdministrationClient documentIntelligenceAsyncClient = new DocumentIntelligenceAdministrationClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildClient();
+```
## Key concepts
### DocumentAnalysisClient
The [DocumentAnalysisClient][document_analysis_sync_client] and [DocumentAnalysisAsyncClient][document_analysis_async_client]
@@ -174,16 +191,9 @@ File layoutDocument = new File("local/file_path/filename.png");
Path filePath = layoutDocument.toPath();
BinaryData layoutDocumentData = BinaryData.fromFile(filePath, (int) layoutDocument.length());
-SyncPoller analyzeLayoutResultPoller =
+SyncPoller analyzeLayoutResultPoller =
documentIntelligenceClient.beginAnalyzeDocument("prebuilt-layout",
- null,
- null,
- null,
- null,
- null,
- null,
- null,
- new AnalyzeDocumentRequest().setBase64Source(Files.readAllBytes(layoutDocument.toPath())));
+ new AnalyzeDocumentOptions(layoutDocumentData));
AnalyzeResult analyzeLayoutResult = analyzeLayoutResultPoller.getFinalResult();
@@ -235,21 +245,14 @@ For example, to analyze fields from a sales receipt, into the `beginAnalyzeDocum
File sourceFile = new File("../documentintelligence/azure-ai-documentintelligence/src/samples/resources/"
+ "sample-forms/receipts/contoso-allinone.jpg");
-SyncPoller analyzeReceiptPoller =
+SyncPoller analyzeReceiptPoller =
documentIntelligenceClient.beginAnalyzeDocument("prebuilt-receipt",
- null,
- null,
- null,
- null,
- null,
- null,
- null,
- new AnalyzeDocumentRequest().setBase64Source(Files.readAllBytes(sourceFile.toPath())));
+ new AnalyzeDocumentOptions(Files.readAllBytes(sourceFile.toPath())));
AnalyzeResult receiptResults = analyzeReceiptPoller.getFinalResult();
for (int i = 0; i < receiptResults.getDocuments().size(); i++) {
- Document analyzedReceipt = receiptResults.getDocuments().get(i);
+ AnalyzedDocument analyzedReceipt = receiptResults.getDocuments().get(i);
Map receiptFields = analyzedReceipt.getFields();
System.out.printf("----------- Analyzing receipt info %d -----------%n", i);
DocumentField merchantNameField = receiptFields.get("MerchantName");
@@ -302,7 +305,7 @@ in the [service quickstart documentation][quickstart_training].
**Note**
-You can use the [Document Intelligence Studio preview][fr-studio] for creating a labeled file for your training forms.
+You can use the [Document Intelligence Studio preview][di-studio] for creating a labeled file for your training forms.
More details on setting up a container and required file structure can be found in [here][fr_build_training_set].
```java com.azure.ai.documentintelligence.readme.buildModel
@@ -310,7 +313,7 @@ More details on setting up a container and required file structure can be found
String blobContainerUrl = "{SAS_URL_of_your_container_in_blob_storage}";
// The shared access signature (SAS) Url of your Azure Blob Storage container with your forms.
SyncPoller buildOperationPoller =
- administrationClient.beginBuildDocumentModel(new BuildDocumentModelRequest("modelID", DocumentBuildMode.TEMPLATE)
+ administrationClient.beginBuildDocumentModel(new BuildDocumentModelOptions("modelID", DocumentBuildMode.TEMPLATE)
.setAzureBlobSource(new AzureBlobContentSource(blobContainerUrl)));
DocumentModelDetails documentModelDetails = buildOperationPoller.getFinalResult();
@@ -318,10 +321,10 @@ DocumentModelDetails documentModelDetails = buildOperationPoller.getFinalResult(
// Model Info
System.out.printf("Model ID: %s%n", documentModelDetails.getModelId());
System.out.printf("Model Description: %s%n", documentModelDetails.getDescription());
-System.out.printf("Model created on: %s%n%n", documentModelDetails.getCreatedDateTime());
+System.out.printf("Model created on: %s%n%n", documentModelDetails.getCreatedOn());
-System.out.println("Document Fields:");
-documentModelDetails.getDocTypes().forEach((key, documentTypeDetails) -> {
+System.out.println("AnalyzedDocument Fields:");
+documentModelDetails.getDocumentTypes().forEach((key, documentTypeDetails) -> {
documentTypeDetails.getFieldSchema().forEach((field, documentFieldSchema) -> {
System.out.printf("Field: %s", field);
System.out.printf("Field type: %s", documentFieldSchema.getType());
@@ -337,23 +340,18 @@ was built on.
```java com.azure.ai.documentintelligence.readme.analyzeCustomModel
String documentUrl = "{document-url}";
String modelId = "{custom-built-model-ID}";
-SyncPoller analyzeDocumentPoller = documentIntelligenceClient.beginAnalyzeDocument(modelId,
- "1",
- "en-US",
- StringIndexType.TEXT_ELEMENTS,
- Arrays.asList(DocumentAnalysisFeature.LANGUAGES),
- null,
- ContentFormat.TEXT,
- null,
- new AnalyzeDocumentRequest().setUrlSource(documentUrl));
+SyncPoller analyzeDocumentPoller = documentIntelligenceClient.beginAnalyzeDocument(modelId,
+ new AnalyzeDocumentOptions(documentUrl).setPages(Collections.singletonList("1")).setLocale("en-US")
+ .setStringIndexType(StringIndexType.TEXT_ELEMENTS).setDocumentAnalysisFeatures(Arrays.asList(DocumentAnalysisFeature.LANGUAGES))
+ .setOutputContentFormat(DocumentContentFormat.TEXT));
AnalyzeResult analyzeResult = analyzeDocumentPoller.getFinalResult();
for (int i = 0; i < analyzeResult.getDocuments().size(); i++) {
- final Document analyzedDocument = analyzeResult.getDocuments().get(i);
+ final AnalyzedDocument analyzedDocument = analyzeResult.getDocuments().get(i);
System.out.printf("----------- Analyzing custom document %d -----------%n", i);
System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n",
- analyzedDocument.getDocType(), analyzedDocument.getConfidence());
+ analyzedDocument.getDocumentType(), analyzedDocument.getConfidence());
}
analyzeResult.getPages().forEach(documentPage -> {
@@ -394,7 +392,7 @@ for (int i = 0; i < tables.size(); i++) {
Manage the models in your Document Intelligence account.
```java com.azure.ai.documentintelligence.readme.manageModels
-ResourceDetails resourceDetails = administrationClient.getResourceInfo();
+DocumentIntelligenceResourceDetails resourceDetails = administrationClient.getResourceDetails();
System.out.printf("The resource has %s models, and we can have at most %s models.%n",
resourceDetails.getCustomDocumentModels().getCount(), resourceDetails.getCustomDocumentModels().getLimit());
@@ -407,9 +405,9 @@ customDocumentModels.forEach(documentModelInfo -> {
DocumentModelDetails documentModel = administrationClient.getModel(documentModelInfo.getModelId());
System.out.printf("Model ID: %s%n", documentModel.getModelId());
System.out.printf("Model Description: %s%n", documentModel.getDescription());
- System.out.printf("Model created on: %s%n", documentModel.getCreatedDateTime());
- if (documentModel.getDocTypes() != null) {
- documentModel.getDocTypes().forEach((key, documentTypeDetails) -> {
+ System.out.printf("Model created on: %s%n", documentModel.getCreatedOn());
+ if (documentModel.getDocumentTypes() != null) {
+ documentModel.getDocumentTypes().forEach((key, documentTypeDetails) -> {
documentTypeDetails.getFieldSchema().forEach((field, documentFieldSchema) -> {
System.out.printf("Field: %s, ", field);
System.out.printf("Field type: %s, ", documentFieldSchema.getType());
@@ -434,7 +432,7 @@ be found here: [log levels][logLevels].
### Default HTTP Client
All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure
the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
-[HTTP clients wiki](https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients).
+[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL
@@ -447,7 +445,7 @@ reduce the dependency size, refer to the [performance tuning][performance_tuning
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
@@ -456,65 +454,66 @@ For details on contributing to this repository, see the [contributing guide](htt
5. Create new Pull Request
-[aad_authorization]: /azure/cognitive-services/authentication#authenticate-with-azure-active-directory
-[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java
-[key]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource
+[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
+[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java
+[key]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource
[api_reference_doc]: https://learn.microsoft.com/java/api/overview/azure/ai-documentintelligence-readme?view=azure-java-preview
-[form_recognizer_doc]: https://aka.ms/azsdk-java-documentintelligence-ref-doc
-[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/identity/azure-identity#credentials
-[azure_cli]: /azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows
-[azure_cli_endpoint]: /cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/identity/azure-identity#credentials
+[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
+[azure_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows
+[azure_cli_endpoint]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
[azure_portal]: https://ms.portal.azure.com
[azure_subscription]: https://azure.microsoft.com/free
[cla]: https://cla.microsoft.com
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
[coc_contact]: mailto:opencode@microsoft.com
-[create_new_resource]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource
-[form_recognizer_account]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
-[grant_access]: /azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
-[http_clients_wiki]: https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients
-[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java
-[jdk_link]: /java/azure/jdk/?view=azure-java-stable
-[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
-[logLevels]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
+[create_new_resource]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource
+[form_recognizer_account]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
+[grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[http_clients_wiki]: https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients
+[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java
+[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK
+[logLevels]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
[package]: https://central.sonatype.com/artifact/com.azure/azure-ai-documentintelligence
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
-[product_documentation]: /azure/cognitive-services/form-recognizer/overview
-[register_AAD_application]: /azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
-[fr-studio]: https://aka.ms/azsdk/formrecognizer/documentintelligencestudio
+[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/form-recognizer/overview
+[register_AAD_application]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[di-studio]: https://aka.ms/azsdk/formrecognizer/formrecognizerstudio
[fr_build_training_set]: https://aka.ms/azsdk/formrecognizer/buildcustommodel
-[sample_examples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#examples
-[samples_readme]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#readme
-[migration_guide]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/MIGRATION_GUIDE.md
-[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/CHANGELOG.md
-
-[sample_readme]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/
-[document_analysis_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAsyncClient.java
-[document_analysis_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClient.java
-[document_model_admin_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationAsyncClient.java
-[document_model_admin_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationClient.java
-[document_analysis_client_builder]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClientBuilder.java
-[manage_custom_models]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModels.java
-[manage_custom_models_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModelsAsync.java
-[build_model]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModel.java
-[build_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModelAsync.java
-[build_document_classifier]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifier.java
-[build_document_classifier_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifierAsync.java
-[analyze_identity_documents_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrl.java
-[analyze_identity_documents_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrlAsync.java
-[analyze_invoices_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeInvoicesFromUrl.java
-[analyze_receipts_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeReceiptsFromUrl.java
+[sample_examples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#examples
+[samples_readme]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#readme
+[migration_guide]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/MIGRATION_GUIDE.md
+[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/CHANGELOG.md
+
+[sample_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/
+[document_analysis_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAsyncClient.java
+[document_analysis_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClient.java
+[document_model_admin_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationAsyncClient.java
+[document_model_admin_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationClient.java
+[document_analysis_client_builder]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClientBuilder.java
+[manage_custom_models]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModels.java
+[manage_custom_models_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModelsAsync.java
+[build_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModel.java
+[build_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModelAsync.java
+[build_document_classifier]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifier.java
+[build_document_classifier_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifierAsync.java
+[analyze_identity_documents_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrl.java
+[analyze_identity_documents_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrlAsync.java
+[analyze_invoices_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeInvoicesFromUrl.java
+[analyze_receipts_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeReceiptsFromUrl.java
+[register_aad_app]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[azure_portal_get_endpoint]: https://learn.microsoft.com/azure/ai-services/document-intelligence/how-to-guides/create-document-intelligence-resource#get-endpoint-url-and-keys
[fr_models]: https://aka.ms/azsdk/formrecognizer/models
-[service_access]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
+[service_access]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
[service_analyze_invoices_fields]: https://aka.ms/azsdk/formrecognizer/invoicefieldschema
[service_analyze_identity_documents_fields]: https://aka.ms/azsdk/formrecognizer/iddocumentfieldschema
[service_analyze_receipt_fields]: https://aka.ms/azsdk/formrecognizer/receiptfieldschema
[service_analyze_w2_documents_fields]: https://aka.ms/azsdk/formrecognizer/taxusw2fieldschema
[service-rename]: https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-form-recognizer-is-now-azure-ai-document-intelligence-with/ba-p/3875765
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src
[quickstart_training]: https://learn.microsoft.com/azure/applied-ai-services/form-recognizer/quickstarts/get-started-sdks-rest-api?view=form-recog-3.0.0&pivots=programming-language-java
-[wiki_identity]: https://github.com/Azure/azure-sdk-for-java/wiki/Identity-and-Authentication
+[wiki_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity
diff --git a/docs-ref-services/preview/ai-formrecognizer-readme.md b/docs-ref-services/preview/ai-formrecognizer-readme.md
new file mode 100644
index 0000000000000..652220cac1c66
--- /dev/null
+++ b/docs-ref-services/preview/ai-formrecognizer-readme.md
@@ -0,0 +1,753 @@
+---
+title: Azure Document Intelligence client library for Java
+keywords: Azure, java, SDK, API, azure-ai-formrecognizer, formrecognizer
+ms.date: 08/05/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: formrecognizer
+---
+# Azure Document Intelligence client library for Java - version 4.2.0-alpha.20250804.1
+
+Azure Document Intelligence ([previously known as Form Recognizer][service-rename]) is a cloud service that uses machine
+learning to analyze text and structured data from your documents.
+It includes the following main features:
+
+* Layout - Extract text, table structures, and selection marks, along with their bounding region coordinates, from documents.
+* Document - Analyze entities, key-value pairs, tables, and selection marks from documents using the general prebuilt document model.
+* Prebuilt - Analyze data from certain types of common documents (such as receipts, invoices, business cards, identity documents or US W2 tax forms) using prebuilt models.
+* Custom - Build custom models to extract text, field values, selection marks, and table data from documents. Custom models are built with your own data, so they're tailored to your documents.
+* Read - Read information about textual elements, such as page words and lines in addition to text language information.
+* Classifiers - Build custom classifiers to categorize documents into predefined classes.
+
+[Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][sample_readme]
+
+## Getting started
+
+### Prerequisites
+- A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+ - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
+- [Azure Subscription][azure_subscription]
+- [Cognitive Services or Form Recognizer account][form_recognizer_account] to use this package.
+
+### Include the Package
+
+#### Include the BOM file
+
+Do include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
+To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
+
+```xml
+
+
+
+ com.azure
+ azure-sdk-bom
+ {bom_version_to_target}
+ pom
+ import
+
+
+
+```
+Then, include the direct dependency in the dependencies' section without the version tag.
+
+```xml
+
+
+ com.azure
+ azure-ai-formrecognizer
+
+
+```
+
+#### Include direct dependency
+If you want to take dependency on a particular version of the library that is not present in the BOM,
+add the direct dependency to your project as follows.
+
+[//]: # ({x-version-update-start;com.azure:azure-ai-formrecognizer;current})
+```xml
+
+ com.azure
+ azure-ai-formrecognizer
+ 4.2.0-beta.1
+
+```
+[//]: # ({x-version-update-end})
+> Note: This version of the client library defaults to the `"2023-07-31"` version of the service.
+
+This table shows the relationship between SDK versions and supported API versions of the service:
+
+| SDK version | Supported API version of service |
+|----------------|--------------------------------------------|
+| 3.0.x | 2.0 |
+| 3.1.X - 3.1.12 | 2.0, 2.1 (default) |
+| 4.0.0 | 2.0, 2.1, 2022-08-31 (default) |
+| 4.1.0 > | 2.0, 2.1, 2022-08-31, 2023-07-31 (default) |
+
+> Note: Starting with version 4.0.X, a new set of clients were introduced to leverage the newest features
+> of the Form Recognizer service. Please see the [Migration Guide][migration_guide] for detailed instructions on how to update application
+> code from client library version 3.1.X or lower to the latest version. For more information, see [Changelog][changelog].
+> The below table describes the relationship of each client and its supported API version(s):
+
+| API version | Supported clients |
+|-------------|--------------------------------------------------------------|
+| 2023-07-31 | DocumentAnalysisClient and DocumentModelAdministrationClient |
+| 2022-08-31 | DocumentAnalysisClient and DocumentModelAdministrationClient |
+| 2.1 | FormRecognizerClient and FormTrainingClient |
+| 2.0 | FormRecognizerClient and FormTrainingClient |
+
+#### Create a Form Recognizer resource
+Form Recognizer supports both [multi-service and single-service access][service_access]. Create a Cognitive Service's
+resource if you plan to access multiple cognitive services under a single endpoint/key. For Form Recognizer access only,
+create a Form Recognizer resource.
+
+You can create either resource using the
+
+**Option 1:** [Azure portal][create_new_resource]
+
+**Option 2:** [Azure CLI][azure_cli]
+
+Below is an example of how you can create a Form Recognizer resource using the CLI:
+
+```bash
+# Create a new resource group to hold the Form Recognizer resource -
+# if using an existing resource group, skip this step
+az group create --name --location
+```
+
+```bash
+# Create Form Recognizer
+az cognitiveservices account create \
+ --name \
+ --resource-group \
+ --kind FormRecognizer \
+ --sku \
+ --location \
+ --yes
+```
+### Authenticate the client
+In order to interact with the Form Recognizer service, you will need to create an instance of the Document Analysis client.
+Both the asynchronous and synchronous clients can be created by using `DocumentAnalysisClientBuilder`. Invoking `buildClient()`
+will create the synchronous client, while invoking `buildAsyncClient` will create its asynchronous counterpart.
+
+You will need an **endpoint**, and a **key** to instantiate a client object.
+
+#### Looking up the endpoint
+You can find the **endpoint** for your Form Recognizer resource in the [Azure portal][azure_portal],
+or [Azure CLI][azure_cli_endpoint].
+```bash
+# Get the endpoint for the resource
+az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "endpoint"
+```
+
+#### Create a Document Analysis client using AzureKeyCredential
+To use `AzureKeyCredential` authentication, provide the [key][key] as a string to the [AzureKeyCredential][azure_key_credential].
+This key can be found in the [Azure portal][azure_portal] in your created Form Recognizer
+resource, or by running the following Azure CLI command to get the key from the Form Recognizer resource:
+
+```bash
+az cognitiveservices account keys list --resource-group --name
+```
+Use the API key as the credential parameter to authenticate the client:
+
+```java readme-sample-createDocumentAnalysisClient
+DocumentAnalysisClient documentAnalysisClient = new DocumentAnalysisClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildClient();
+```
+
+```java readme-sample-createDocumentModelAdministrationClient
+DocumentModelAdministrationClient client =
+ new DocumentModelAdministrationClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildClient();
+```
+
+#### Create a Document Analysis client with Azure Active Directory credential
+Azure SDK for Java supports an Azure Identity package, making it easy to get credentials from Microsoft identity
+platform.
+
+Authentication with AAD requires some initial setup:
+* Add the Azure Identity package
+
+[//]: # ({x-version-update-start;com.azure:azure-identity;dependency})
+```xml
+
+ com.azure
+ azure-identity
+ 1.15.3
+
+```
+[//]: # ({x-version-update-end})
+* [Register a new Azure Active Directory application][register_AAD_application]
+* [Grant access][grant_access] to Form Recognizer by assigning the `"Cognitive Services User"` role to your service principal.
+
+After the setup, you can choose which type of [credential][azure_identity_credential_type] from azure-identity to use.
+As an example, [DefaultAzureCredential][wiki_identity] can be used to authenticate the client:
+Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
+AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.
+
+Authorization is easiest using [DefaultAzureCredential][wiki_identity]. It finds the best credential to use in its
+running environment. For more information about using Azure Active Directory authorization with Form Recognizer, see [the associated documentation][aad_authorization].
+
+```java readme-sample-createDocumentAnalysisClientWithAAD
+DocumentAnalysisClient documentAnalysisClient = new DocumentAnalysisClientBuilder()
+ .endpoint("{endpoint}")
+ .credential(new DefaultAzureCredentialBuilder().build())
+ .buildClient();
+```
+
+## Key concepts
+### DocumentAnalysisClient
+The [DocumentAnalysisClient][document_analysis_sync_client] and [DocumentAnalysisAsyncClient][document_analysis_async_client]
+provide both synchronous and asynchronous operations for analyzing input documents using custom and prebuilt models
+through the `beginAnalyzeDocument` and `beginAnalyzeDocumentFromUrl` methods.
+See a full list of supported models [here][fr_models].
+
+Sample code snippets to illustrate using a DocumentAnalysisClient [here][sample_readme].
+More information about analyzing documents, including supported features, locales, and document types can be found
+[here][fr_models].
+
+### DocumentModelAdministrationClient
+The [DocumentModelAdministrationClient][document_model_admin_sync_client] and
+[DocumentModelAdministrationAsyncClient][document_model_admin_async_client] provide both synchronous and asynchronous operations
+- Build custom document analysis models to analyze text content, fields, and values found in your custom documents. See example [Build a document model](#build-a-document-model).
+ A `DocumentModelDetails` is returned indicating the document types that the model can analyze, along with the fields and schemas it will extract.
+- Managing models created in your account by building, listing, deleting, and see the limit of custom models your account. See example [Manage models](#manage-your-models).
+- Copying a custom model from one Form Recognizer resource to another.
+- Creating a composed model from a collection of existing built models.
+- Listing document model operations associated with the Form Recognizer resource.
+
+Sample code snippets are provided to illustrate using a DocumentModelAdministrationClient [here](#examples "Examples").
+
+### Long-running operations
+Long-running operations are operations that consist of an initial request sent to the service to start an operation,
+followed by polling the service at intervals to determine whether the operation has completed or failed, and if it has
+succeeded, to get the result.
+
+Methods that build models, analyze values from documents, or copy and compose models are modeled as long-running operations.
+The client exposes a `begin` method that returns a `SyncPoller` or `PollerFlux` instance.
+Callers should wait for the operation to be completed by calling `getFinalResult()` on the returned operation from the
+`begin` method. Sample code snippets are provided to illustrate using long-running operations
+[below](#examples).
+
+## Examples
+
+The following section provides several code snippets covering some of the most common Form Recognizer tasks, including:
+
+* [Extract Layout](#extract-layout "Extract Layout")
+* [Use a General Document Model](#use-a-general-document-model)
+* [Use Prebuilt Models](#use-prebuilt-models)
+* [Build a Document Model](#build-a-document-model "Build a Document Model")
+* [Analyze Documents using a Custom Model](#analyze-documents-using-a-custom-model "Analyze Documents using a Custom Model")
+* [Manage Your Models](#manage-your-models "Manage Your Models")
+* [Classify a document](#classify-a-document "Classify a Document")
+
+### Extract Layout
+Extract text, table structures, and selection marks like radio buttons and check boxes, along with their bounding box coordinates from documents without the need to build a model.
+```java readme-sample-extractLayout
+// analyze document layout using file input stream
+File layoutDocument = new File("local/file_path/filename.png");
+Path filePath = layoutDocument.toPath();
+BinaryData layoutDocumentData = BinaryData.fromFile(filePath, (int) layoutDocument.length());
+
+SyncPoller analyzeLayoutResultPoller =
+ documentAnalysisClient.beginAnalyzeDocument("prebuilt-layout", layoutDocumentData);
+
+AnalyzeResult analyzeLayoutResult = analyzeLayoutResultPoller.getFinalResult();
+
+// pages
+analyzeLayoutResult.getPages().forEach(documentPage -> {
+ System.out.printf("Page has width: %.2f and height: %.2f, measured with unit: %s%n",
+ documentPage.getWidth(),
+ documentPage.getHeight(),
+ documentPage.getUnit());
+
+ // lines
+ documentPage.getLines().forEach(documentLine ->
+ System.out.printf("Line '%s' is within a bounding box %s.%n",
+ documentLine.getContent(),
+ documentLine.getBoundingPolygon().toString()));
+
+ // selection marks
+ documentPage.getSelectionMarks().forEach(documentSelectionMark ->
+ System.out.printf("Selection mark is '%s' and is within a bounding box %s with confidence %.2f.%n",
+ documentSelectionMark.getSelectionMarkState().toString(),
+ documentSelectionMark.getBoundingPolygon().toString(),
+ documentSelectionMark.getConfidence()));
+});
+
+// tables
+List tables = analyzeLayoutResult.getTables();
+for (int i = 0; i < tables.size(); i++) {
+ DocumentTable documentTable = tables.get(i);
+ System.out.printf("Table %d has %d rows and %d columns.%n", i, documentTable.getRowCount(),
+ documentTable.getColumnCount());
+ documentTable.getCells().forEach(documentTableCell -> {
+ System.out.printf("Cell '%s', has row index %d and column index %d.%n", documentTableCell.getContent(),
+ documentTableCell.getRowIndex(), documentTableCell.getColumnIndex());
+ });
+ System.out.println();
+}
+```
+
+### Use a General Document Model
+Analyze key-value pairs, tables, styles, and selection marks from documents using the general document model provided by
+the Form Recognizer service.
+Select the General Document Model by passing modelId="prebuilt-document" into the beginAnalyzeDocumentFromUrl method as follows:
+```java readme-sample-analyzePrebuiltDocument
+String documentUrl = "{document-url}";
+String modelId = "prebuilt-document";
+SyncPoller analyzeDocumentPoller =
+ documentAnalysisClient.beginAnalyzeDocumentFromUrl(modelId, documentUrl);
+
+AnalyzeResult analyzeResult = analyzeDocumentPoller.getFinalResult();
+
+for (int i = 0; i < analyzeResult.getDocuments().size(); i++) {
+ final AnalyzedDocument analyzedDocument = analyzeResult.getDocuments().get(i);
+ System.out.printf("----------- Analyzing document %d -----------%n", i);
+ System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n",
+ analyzedDocument.getDocType(), analyzedDocument.getConfidence());
+}
+
+analyzeResult.getPages().forEach(documentPage -> {
+ System.out.printf("Page has width: %.2f and height: %.2f, measured with unit: %s%n",
+ documentPage.getWidth(),
+ documentPage.getHeight(),
+ documentPage.getUnit());
+
+ // lines
+ documentPage.getLines().forEach(documentLine ->
+ System.out.printf("Line '%s' is within a bounding box %s.%n",
+ documentLine.getContent(),
+ documentLine.getBoundingPolygon().toString()));
+
+ // words
+ documentPage.getWords().forEach(documentWord ->
+ System.out.printf("Word '%s' has a confidence score of %.2f.%n",
+ documentWord.getContent(),
+ documentWord.getConfidence()));
+});
+
+// tables
+List tables = analyzeResult.getTables();
+for (int i = 0; i < tables.size(); i++) {
+ DocumentTable documentTable = tables.get(i);
+ System.out.printf("Table %d has %d rows and %d columns.%n", i, documentTable.getRowCount(),
+ documentTable.getColumnCount());
+ documentTable.getCells().forEach(documentTableCell -> {
+ System.out.printf("Cell '%s', has row index %d and column index %d.%n",
+ documentTableCell.getContent(),
+ documentTableCell.getRowIndex(), documentTableCell.getColumnIndex());
+ });
+ System.out.println();
+}
+
+// Key-value
+analyzeResult.getKeyValuePairs().forEach(documentKeyValuePair -> {
+ System.out.printf("Key content: %s%n", documentKeyValuePair.getKey().getContent());
+ System.out.printf("Key content bounding region: %s%n",
+ documentKeyValuePair.getKey().getBoundingRegions().toString());
+
+ System.out.printf("Value content: %s%n", documentKeyValuePair.getValue().getContent());
+ System.out.printf("Value content bounding region: %s%n", documentKeyValuePair.getValue().getBoundingRegions().toString());
+});
+```
+
+### Use Prebuilt Models
+Extract fields from select document types such as receipts, invoices, business cards, and identity documents using prebuilt models provided by the Form Recognizer service.
+Supported prebuilt models are:
+- Analyze receipts using the `prebuilt-receipt` model (fields recognized by the service can be found [here][service_analyze_receipt_fields])
+- Analyze business cards using the `prebuilt-businessCard` model (fields recognized by the service can be found [here][service_analyze_business_cards_fields]).
+- Analyze invoices using the `prebuilt-invoice` model (fields recognized by the service can be found [here][service_analyze_invoices_fields]).
+- Analyze identity documents using the `prebuilt-idDocuments` model (fields recognized by the service can be found [here][service_analyze_identity_documents_fields]).
+- Analyze US W2 tax forms using the `prebuilt-tax.us.w2` model. [Supported fields][service_analyze_w2_documents_fields].
+
+For example, to analyze fields from a sales receipt, into the `beginAnalyzeDocumentFromUrl` method:
+```java readme-sample-analyzeReceiptFromUrl
+String receiptUrl = "https://raw.githubusercontent.com/Azure/azure-sdk-for-java/main/sdk/formrecognizer"
+ + "/azure-ai-formrecognizer/src/samples/resources/sample-documents/receipts/contoso-allinone.jpg";
+
+SyncPoller analyzeReceiptPoller =
+ documentAnalysisClient.beginAnalyzeDocumentFromUrl("prebuilt-receipt", receiptUrl);
+
+AnalyzeResult receiptResults = analyzeReceiptPoller.getFinalResult();
+
+for (int i = 0; i < receiptResults.getDocuments().size(); i++) {
+ AnalyzedDocument analyzedReceipt = receiptResults.getDocuments().get(i);
+ Map receiptFields = analyzedReceipt.getFields();
+ System.out.printf("----------- Analyzing receipt info %d -----------%n", i);
+ DocumentField merchantNameField = receiptFields.get("MerchantName");
+ if (merchantNameField != null) {
+ if (DocumentFieldType.STRING == merchantNameField.getType()) {
+ String merchantName = merchantNameField.getValueAsString();
+ System.out.printf("Merchant Name: %s, confidence: %.2f%n",
+ merchantName, merchantNameField.getConfidence());
+ }
+ }
+
+ DocumentField merchantPhoneNumberField = receiptFields.get("MerchantPhoneNumber");
+ if (merchantPhoneNumberField != null) {
+ if (DocumentFieldType.PHONE_NUMBER == merchantPhoneNumberField.getType()) {
+ String merchantAddress = merchantPhoneNumberField.getValueAsPhoneNumber();
+ System.out.printf("Merchant Phone number: %s, confidence: %.2f%n",
+ merchantAddress, merchantPhoneNumberField.getConfidence());
+ }
+ }
+
+ DocumentField transactionDateField = receiptFields.get("TransactionDate");
+ if (transactionDateField != null) {
+ if (DocumentFieldType.DATE == transactionDateField.getType()) {
+ LocalDate transactionDate = transactionDateField.getValueAsDate();
+ System.out.printf("Transaction Date: %s, confidence: %.2f%n",
+ transactionDate, transactionDateField.getConfidence());
+ }
+ }
+
+ DocumentField receiptItemsField = receiptFields.get("Items");
+ if (receiptItemsField != null) {
+ System.out.printf("Receipt Items: %n");
+ if (DocumentFieldType.LIST == receiptItemsField.getType()) {
+ List receiptItems = receiptItemsField.getValueAsList();
+ receiptItems.stream()
+ .filter(receiptItem -> DocumentFieldType.MAP == receiptItem.getType())
+ .map(documentField -> documentField.getValueAsMap())
+ .forEach(documentFieldMap -> documentFieldMap.forEach((key, documentField) -> {
+ if ("Name".equals(key)) {
+ if (DocumentFieldType.STRING == documentField.getType()) {
+ String name = documentField.getValueAsString();
+ System.out.printf("Name: %s, confidence: %.2fs%n",
+ name, documentField.getConfidence());
+ }
+ }
+ if ("Quantity".equals(key)) {
+ if (DocumentFieldType.DOUBLE == documentField.getType()) {
+ Double quantity = documentField.getValueAsDouble();
+ System.out.printf("Quantity: %f, confidence: %.2f%n",
+ quantity, documentField.getConfidence());
+ }
+ }
+ }));
+ }
+ }
+}
+```
+
+For more information and samples using prebuilt models, see:
+- [Business Cards][analyze_business_cards_from_url]
+- [Identity Documents][analyze_identity_documents_from_url]
+- [Invoices][analyze_invoices_from_url]
+- [Receipts sample][analyze_receipts_from_url]
+
+### Build a document model
+Build a machine-learned model on your own document type. The resulting model will be able to analyze values from the types of documents it was built on.
+Provide a container SAS url to your Azure Storage Blob container where you're storing the training documents. See details on setting this up
+in the [service quickstart documentation][quickstart_training].
+
+**Note**
+
+You can use the [Form Recognizer Studio preview][fr-studio] for creating a labeled file for your training forms.
+More details on setting up a container and required file structure can be found in the [here][fr_build_training_set].
+
+```java readme-sample-buildModel
+// Build custom document analysis model
+String blobContainerUrl = "{SAS_URL_of_your_container_in_blob_storage}";
+// The shared access signature (SAS) Url of your Azure Blob Storage container with your forms.
+String prefix = "{blob_name_prefix}}";
+SyncPoller buildOperationPoller =
+ documentModelAdminClient.beginBuildDocumentModel(blobContainerUrl,
+ DocumentModelBuildMode.TEMPLATE,
+ prefix,
+ new BuildDocumentModelOptions().setModelId("my-build-model").setDescription("model desc"),
+ Context.NONE);
+
+DocumentModelDetails documentModelDetails = buildOperationPoller.getFinalResult();
+
+// Model Info
+System.out.printf("Model ID: %s%n", documentModelDetails.getModelId());
+System.out.printf("Model Description: %s%n", documentModelDetails.getDescription());
+System.out.printf("Model created on: %s%n%n", documentModelDetails.getCreatedOn());
+documentModelDetails.getDocumentTypes().forEach((key, documentTypeDetails) -> {
+ System.out.printf("Document type: %s%n", key);
+ documentTypeDetails.getFieldSchema().forEach((name, documentFieldSchema) -> {
+ System.out.printf("Document field: %s%n", name);
+ System.out.printf("Document field type: %s%n", documentFieldSchema.getType().toString());
+ System.out.printf("Document field confidence: %.2f%n", documentTypeDetails.getFieldConfidence().get(name));
+ });
+});
+```
+
+### Analyze Documents using a Custom Model
+Analyze the key/value pairs and table data from documents. These models are built with your own data,
+so they're tailored to your documents. You should only analyze documents of the same doc type that the custom model
+was built on.
+```java readme-sample-analyzeCustomDocument
+String documentUrl = "{document-url}";
+String modelId = "{custom-built-model-ID}";
+SyncPoller analyzeDocumentPoller =
+ documentAnalysisClient.beginAnalyzeDocumentFromUrl(modelId, documentUrl);
+
+AnalyzeResult analyzeResult = analyzeDocumentPoller.getFinalResult();
+
+for (int i = 0; i < analyzeResult.getDocuments().size(); i++) {
+ final AnalyzedDocument analyzedDocument = analyzeResult.getDocuments().get(i);
+ System.out.printf("----------- Analyzing custom document %d -----------%n", i);
+ System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n",
+ analyzedDocument.getDocType(), analyzedDocument.getConfidence());
+ analyzedDocument.getFields().forEach((key, documentField) -> {
+ System.out.printf("Document Field content: %s%n", documentField.getContent());
+ System.out.printf("Document Field confidence: %.2f%n", documentField.getConfidence());
+ System.out.printf("Document Field Type: %s%n", documentField.getType());
+ System.out.printf("Document Field found within bounding region: %s%n",
+ documentField.getBoundingRegions().toString());
+ });
+}
+
+analyzeResult.getPages().forEach(documentPage -> {
+ System.out.printf("Page has width: %.2f and height: %.2f, measured with unit: %s%n",
+ documentPage.getWidth(),
+ documentPage.getHeight(),
+ documentPage.getUnit());
+
+ // lines
+ documentPage.getLines().forEach(documentLine ->
+ System.out.printf("Line '%s' is within a bounding box %s.%n",
+ documentLine.getContent(),
+ documentLine.getBoundingPolygon().toString()));
+
+ // words
+ documentPage.getWords().forEach(documentWord ->
+ System.out.printf("Word '%s' has a confidence score of %.2f.%n",
+ documentWord.getContent(),
+ documentWord.getConfidence()));
+});
+
+// tables
+List tables = analyzeResult.getTables();
+for (int i = 0; i < tables.size(); i++) {
+ DocumentTable documentTable = tables.get(i);
+ System.out.printf("Table %d has %d rows and %d columns.%n", i, documentTable.getRowCount(),
+ documentTable.getColumnCount());
+ documentTable.getCells().forEach(documentTableCell -> {
+ System.out.printf("Cell '%s', has row index %d and column index %d.%n",
+ documentTableCell.getContent(),
+ documentTableCell.getRowIndex(), documentTableCell.getColumnIndex());
+ });
+ System.out.println();
+}
+```
+
+### Manage your models
+Manage the models in your Form Recognizer account.
+```java readme-sample-manageModels
+AtomicReference modelId = new AtomicReference<>();
+
+// First, we see how many models we have, and what our limit is
+ResourceDetails resourceDetails = documentModelAdminClient.getResourceDetails();
+System.out.printf("The resource has %s models, and we can have at most %s models",
+ resourceDetails.getCustomDocumentModelCount(), resourceDetails.getCustomDocumentModelLimit());
+
+// Next, we get a paged list of all of our models
+PagedIterable customDocumentModels = documentModelAdminClient.listDocumentModels();
+System.out.println("We have following models in the account:");
+customDocumentModels.forEach(documentModelSummary -> {
+ System.out.printf("Model ID: %s%n", documentModelSummary.getModelId());
+ modelId.set(documentModelSummary.getModelId());
+
+ // get custom document analysis model info
+ DocumentModelDetails documentModel = documentModelAdminClient.getDocumentModel(documentModelSummary.getModelId());
+ System.out.printf("Model ID: %s%n", documentModel.getModelId());
+ System.out.printf("Model Description: %s%n", documentModel.getDescription());
+ System.out.printf("Model created on: %s%n", documentModel.getCreatedOn());
+ documentModel.getDocumentTypes().forEach((key, documentTypeDetails) -> {
+ documentTypeDetails.getFieldSchema().forEach((field, documentFieldSchema) -> {
+ System.out.printf("Field: %s", field);
+ System.out.printf("Field type: %s", documentFieldSchema.getType());
+ System.out.printf("Field confidence: %.2f", documentTypeDetails.getFieldConfidence().get(field));
+ });
+ });
+});
+
+// Delete Model
+documentModelAdminClient.deleteDocumentModel(modelId.get());
+```
+
+### Classify a document
+
+The Form Recognizer service supports custom document classifiers that can classify documents into a set of predefined categories based on a training data set.
+Documents can be classified with a custom classifier using the `beginClassifyDocument` or `beginClassifyDocumentFromUrl`
+method of `DocumentAnalysisClient`.
+The following sample shows how to classify a document using a custom classifier:
+```java readme-sample-classifyDocument
+String documentUrl = "{file_source_url}";
+String classifierId = "{custom_trained_classifier_id}";
+
+documentAnalysisClient.beginClassifyDocumentFromUrl(classifierId, documentUrl, Context.NONE)
+ .getFinalResult()
+ .getDocuments()
+ .forEach(analyzedDocument -> System.out.printf("Doc Type: %s%n", analyzedDocument.getDocType()));
+```
+
+For more detailed examples, refer to [samples][sample_examples].
+
+## Troubleshooting
+### General
+Form Recognizer clients raise `HttpResponseException` [exceptions][http_response_exception]. For example, if you try
+to provide an invalid file source URL an `HttpResponseException` would be raised with an error indicating the failure cause.
+In the following code snippet, the error is handled
+gracefully by catching the exception and display the additional information about the error.
+
+```java readme-sample-handlingException
+try {
+ documentAnalysisClient.beginAnalyzeDocumentFromUrl("prebuilt-receipt", "invalidSourceUrl");
+} catch (HttpResponseException e) {
+ System.out.println(e.getMessage());
+ // Do something with the exception
+}
+```
+
+### Enable client logging
+Azure SDKs for Java offer a consistent logging story to help aid in troubleshooting application errors and expedite
+their resolution. The logs produced will capture the flow of an application before reaching the terminal state to help
+locate the root issue. View the [logging][logging] wiki for guidance about enabling logging.
+
+### Default HTTP Client
+All client libraries by default use the Netty HTTP client. Add the above dependency to automatically configure
+the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
+[HTTP clients wiki][http_clients_wiki].
+
+## Next steps
+The following section provides several code snippets illustrating common patterns used in the Form Recognizer API.
+These code samples show common scenario operations with the Azure Form Recognizer client library.
+
+* Analyze business card from a URL: [AnalyzeBusinessCardFromUrl][analyze_business_cards_from_url]
+* Analyze identity documents from a URL: [AnalyzeIdentityDocumentsFromUrl][analyze_identity_documents_from_url]
+* Analyze invoice from a URL: [AnalyzeInvoiceFromUrl][analyze_invoices_from_url]
+* Analyze receipts: [AnalyzeReceipts][analyze_receipts]
+* Analyze receipts from a URL: [AnalyzeReceiptsFromUrl][analyze_receipts_from_url]
+* Extract layout: [AnalyzeLayout][analyze_layout]
+* Analyze custom documents from a URL: [AnalyzeCustomDocumentFromUrl][analyze_custom_documents]
+* Build a model: [BuildModel][build_model]
+* Manage custom models: [ManageCustomModels][manage_custom_models]
+* Copy a model between Form Recognizer resources: [CopyModel][copy_model]
+* Create a composed model from a collection of custom-built models: [ComposeModel][compose_model]
+* Get/List document model operations associated with the Form Recognizer resource: [GetOperation][get_operation]
+* Build a document classifier : [BuildDocumentClassifier][build_document_classifier]
+
+### Async APIs
+All the examples shown so far have been using synchronous APIs, but we provide full support for async APIs as well.
+You'll need to use `DocumentAnalysisAsyncClient`
+```java readme-sample-asyncClient
+DocumentAnalysisAsyncClient documentAnalysisAsyncClient = new DocumentAnalysisClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildAsyncClient();
+```
+
+* Analyze business card from a URL: [AnalyzeBusinessCardFromUrlAsync][analyze_business_cards_from_url_async]
+* Analyze identity documents from a URL: [AnalyzeIdentityDocumentsFromUrlAsync][analyze_identity_documents_from_url_async]
+* Analyze invoice: [AnalyzeInvoiceAsync][analyze_invoices_async]
+* Analyze receipts: [AnalyzeReceiptsAsync][analyze_receipts_async]
+* Analyze receipts from a URL: [AnalyzeReceiptsFromUrlAsync][analyze_receipts_from_url_async]
+* Extract layout from a URL: [AnalyzeLayoutFromUrlAsync][analyze_layout_from_url_async]
+* Analyze custom documents: [AnalyzeCustomDocumentAsync][analyze_custom_documents_async]
+* Build a document model: [BuildModelAsync][build_model_async]
+* Manage custom models: [ManageCustomModelsAsync][manage_custom_models_async]
+* Copy a document model between Form Recognizer resources: [CopyModelAsync][copy_model_async]
+* Create a composed document model from a collection of custom-built models: [ComposeModelAsync][compose_model_async]
+* Get/List document model operations associated with the Form Recognizer resource: [GetOperationAsync][get_operation_async]
+* Build a document classifier : [BuildDocumentClassifierAsync][build_document_classifier_async]
+
+### Additional documentation
+See the [Sample README][sample_readme] for several code snippets illustrating common patterns used in the Form Recognizer Java SDK.
+For more extensive documentation on Azure Cognitive Services Form Recognizer, see the [Form Recognizer documentation][form_recognizer_doc].
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a [Contributor License Agreement (CLA)][cla] declaring that you have the right to, and actually do, grant us the rights to use your contribution.
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information, see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
+
+
+[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
+[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java
+[key]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource
+[api_reference_doc]: https://azure.github.io/azure-sdk-for-java
+[form_recognizer_doc]: https://aka.ms/azsdk-java-formrecognizer-ref-doc
+[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
+[azure_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows
+[azure_cli_endpoint]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
+[azure_portal]: https://ms.portal.azure.com
+[azure_subscription]: https://azure.microsoft.com/free
+[cla]: https://cla.microsoft.com
+[coc]: https://opensource.microsoft.com/codeofconduct/
+[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
+[coc_contact]: mailto:opencode@microsoft.com
+[create_new_resource]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource
+[form_recognizer_account]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
+[grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[http_clients_wiki]: https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients
+[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java
+[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK
+[package]: https://central.sonatype.com/artifact/com.azure/azure-ai-formrecognizer
+[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/form-recognizer/overview
+[register_AAD_application]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[fr-studio]: https://aka.ms/azsdk/formrecognizer/formrecognizerstudio
+[fr_build_training_set]: https://aka.ms/azsdk/formrecognizer/buildcustommodel
+[sample_examples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples#examples
+[sample_readme]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples#readme
+[migration_guide]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/migration-guide.md
+[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/CHANGELOG.md
+
+[sample_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/
+[document_analysis_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/DocumentAnalysisAsyncClient.java
+[document_analysis_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/DocumentAnalysisClient.java
+[document_model_admin_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/DocumentModelAdministrationAsyncClient.java
+[document_model_admin_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/DocumentModelAdministrationClient.java
+[manage_custom_models]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ManageCustomModels.java
+[manage_custom_models_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ManageCustomModelsAsync.java
+[build_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentModel.java
+[build_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentModelAsync.java
+[build_document_classifier]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentClassifier.java
+[build_document_classifier_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentClassifierAsync.java
+[compose_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ComposeDocumentModel.java
+[compose_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ComposeDocumentModelAsync.java
+[copy_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/CopyDocumentModel.java
+[copy_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/CopyDocumentModelAsync.java
+[analyze_business_cards_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeBusinessCardFromUrl.java
+[analyze_business_cards_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeBusinessCardFromUrlAsync.java
+[analyze_identity_documents_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeIdentityDocumentsFromUrl.java
+[analyze_identity_documents_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeIdentityDocumentsFromUrlAsync.java
+[analyze_invoices_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeInvoicesAsync.java
+[analyze_invoices_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeInvoicesFromUrl.java
+[analyze_layout]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeLayout.java
+[analyze_layout_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeLayoutFromUrlAsync.java
+[analyze_receipts]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceipts.java
+[analyze_receipts_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceiptsAsync.java
+[analyze_receipts_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceiptsFromUrl.java
+[analyze_receipts_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceiptsFromUrlAsync.java
+[analyze_custom_documents]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeCustomDocumentFromUrl.java
+[analyze_custom_documents_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeCustomDocumentAsync.java
+[get_operation]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/GetOperationSummary.java
+[get_operation_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/GetOperationSummaryAsync.java
+
+[fr_models]: https://aka.ms/azsdk/formrecognizer/models
+[service_access]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
+[service_analyze_business_cards_fields]: https://aka.ms/azsdk/formrecognizer/businesscardfieldschema
+[service_analyze_invoices_fields]: https://aka.ms/azsdk/formrecognizer/invoicefieldschema
+[service_analyze_identity_documents_fields]: https://aka.ms/azsdk/formrecognizer/iddocumentfieldschema
+[service_analyze_receipt_fields]: https://aka.ms/azsdk/formrecognizer/receiptfieldschema
+[service_analyze_w2_documents_fields]: https://aka.ms/azsdk/formrecognizer/taxusw2fieldschema
+[service-rename]: https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-form-recognizer-is-now-azure-ai-document-intelligence-with/ba-p/3875765
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src
+[quickstart_training]: https://learn.microsoft.com/azure/applied-ai-services/form-recognizer/quickstarts/get-started-sdks-rest-api?view=form-recog-3.0.0&pivots=programming-language-java
+[wiki_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity
+
+
+
diff --git a/docs-ref-services/preview/ai-inference-readme.md b/docs-ref-services/preview/ai-inference-readme.md
index c4029c9068286..f985220913a91 100644
--- a/docs-ref-services/preview/ai-inference-readme.md
+++ b/docs-ref-services/preview/ai-inference-readme.md
@@ -1,12 +1,12 @@
---
title: Azure AI Inference client library for Java
keywords: Azure, java, SDK, API, azure-ai-inference, ai
-ms.date: 05/15/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: ai
---
-# Azure AI Inference client library for Java - version 1.0.0-beta.5
+# Azure AI Inference client library for Java - version 1.0.0-alpha.20250805.1
Azure AI Inference client library for Java.
@@ -267,7 +267,7 @@ For more details, see [TROUBLESHOOTING][troubleshooting] guideline.
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -281,20 +281,20 @@ For details on contributing to this repository, see the [contributing guide](htt
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/identity/azure-identity
-[sample_get_chat_completions]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/BasicChatSample.java
-[sample_get_chat_completions_streaming]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/StreamingChatSample.java
-[sample_get_embedding]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/TextEmbeddingsSample.java
-[sample_chat_with_image_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/ImageUrlChatSample.java
-[sample_chat_with_image_file]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/ImageFileChatSample.java
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
+[sample_get_chat_completions]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/BasicChatSample.java
+[sample_get_chat_completions_streaming]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/StreamingChatSample.java
+[sample_get_embedding]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/TextEmbeddingsSample.java
+[sample_chat_with_image_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/ImageUrlChatSample.java
+[sample_chat_with_image_file]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/samples/java/com/azure/ai/inference/usage/ImageFileChatSample.java
[sample_function_calls]: https://aka.ms/azsdk/azure-ai-inference/java/toolCallSample
[sample_streaming_function_calls]: https://aka.ms/azsdk/azure-ai-inference/java/streamingToolCallSample
-[chat_completions_client_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/main/java/com/azure/ai/inference/ChatCompletionsAsyncClient.java
-[chat_completions_client_builder]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/main/java/com/azure/ai/inference/ChatCompletionsClientBuilder.java
-[chat_completions_client_sync]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/ai/azure-ai-inference/src/main/java/com/azure/ai/inference/ChatCompletionsClient.java
-[logLevels]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
+[chat_completions_client_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/main/java/com/azure/ai/inference/ChatCompletionsAsyncClient.java
+[chat_completions_client_builder]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/main/java/com/azure/ai/inference/ChatCompletionsClientBuilder.java
+[chat_completions_client_sync]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference/src/main/java/com/azure/ai/inference/ChatCompletionsClient.java
+[logLevels]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
-[troubleshooting]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-inference_1.0.0-beta.5/sdk/openai/azure-ai-openai/TROUBLESHOOTING.md
+[troubleshooting]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/openai/azure-ai-openai/TROUBLESHOOTING.md
[wiki_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity
diff --git a/docs-ref-services/preview/ai-metricsadvisor-readme.md b/docs-ref-services/preview/ai-metricsadvisor-readme.md
index 20ca54db76336..5c7b109055f18 100644
--- a/docs-ref-services/preview/ai-metricsadvisor-readme.md
+++ b/docs-ref-services/preview/ai-metricsadvisor-readme.md
@@ -1,15 +1,15 @@
---
title: Azure Metrics Advisor client library for Java
keywords: Azure, java, SDK, API, azure-ai-metricsadvisor, metricsadvisor
-ms.date: 06/09/2021
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: metricsadvisor
---
-# Azure Metrics Advisor client library for Java - version 1.0.0-beta.4
+# Azure Metrics Advisor client library for Java - version 1.3.0-alpha.20250805.1
Azure Metrics Advisor is a new Cognitive Service that uses time series based decision AI to identify and assist
-trouble shooting the incidents of online services, and monitor the business health by automating the slice and dice
+troubleshooting the incidents of online services, and monitor the business health by automating the slice and dice
of business dataFeedMetrics.
[Source code][source_code] | [Package (Maven)][mvn_package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][samples]
@@ -17,19 +17,53 @@ of business dataFeedMetrics.
## Getting started
### Prerequisites
-- Java Development Kit [JDK][jdk_link] with version 8 or above
+- [Java Development Kit (JDK)][jdk_link] version 8 or later
+ - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
- [Azure Subscription][azure_subscription]
- [Cognitive Services or Metrics Advisor account][metrics_advisor_account] to use this package.
-### Include the Package
-**Note:** This beta version targets Azure Metrics Advisor service API version v1.0.
+### Include the package
+
+#### Include the BOM file
+
+Please include the azure-sdk-bom to your project to take dependency on the General Availability (GA) version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
+To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
+
+```xml
+
+
+
+ com.azure
+ azure-sdk-bom
+ {bom_version_to_target}
+ pom
+ import
+
+
+
+```
+and then include the direct dependency in the dependencies section without the version tag as shown below.
+
+```xml
+
+
+ com.azure
+ azure-ai-metricsadvisor
+
+
+```
+
+#### Include direct dependency
+If you want to take dependency on a particular version of the library that is not present in the BOM,
+add the direct dependency to your project as follows.
+**Note:** This version targets Azure Metrics Advisor service API version v1.0.
[//]: # ({x-version-update-start;com.azure:azure-ai-metricsadvisor;current})
```xml
com.azureazure-ai-metricsadvisor
- 1.0.0-beta.3
+ 1.3.0-beta.1
```
[//]: # ({x-version-update-end})
@@ -41,7 +75,7 @@ In order to interact with the Metrics Advisor service, you will need to create a
Both the asynchronous and synchronous clients can be created by using `MetricsAdvisorClientBuilder`. Invoking `buildClient()`
will create the synchronous client, while invoking `buildAsyncClient` will create its asynchronous counterpart.
-##### Looking up the endpoint
+#### Looking up the endpoint
You can find the **endpoint** for your Metric Advisor resource in the [Azure Portal][azure_portal],
or [Azure CLI][azure_cli_endpoint].
```bash
@@ -58,8 +92,7 @@ You will need two keys to authenticate the client:
Once you have the two keys and endpoint, you can use the `MetricsAdvisorKeyCredential` class to authenticate the clients as follows:
#### Create a Metrics Advisor client using MetricsAdvisorKeyCredential
-
-```java
+```java readme-sample-createMetricsAdvisorClient
MetricsAdvisorKeyCredential credential = new MetricsAdvisorKeyCredential("subscription_key", "api_key");
MetricsAdvisorClient metricsAdvisorClient = new MetricsAdvisorClientBuilder()
.endpoint("{endpoint}")
@@ -68,8 +101,7 @@ MetricsAdvisorClient metricsAdvisorClient = new MetricsAdvisorClientBuilder()
```
#### Create a Metrics Administration client using MetricsAdvisorKeyCredential
-
-```java
+```java readme-sample-createMetricsAdvisorAdministrationClient
MetricsAdvisorKeyCredential credential = new MetricsAdvisorKeyCredential("subscription_key", "api_key");
MetricsAdvisorAdministrationClient metricsAdvisorAdminClient =
new MetricsAdvisorAdministrationClientBuilder()
@@ -90,7 +122,7 @@ Authentication with AAD requires some initial setup:
com.azureazure-identity
- 1.2.3
+ 1.15.3
```
[//]: # ({x-version-update-end})
@@ -106,8 +138,7 @@ Authorization is easiest using [DefaultAzureCredential][wiki_identity]. It finds
running environment. For more information about using Azure Active Directory authorization with Metrics Advisor, please
refer to [the associated documentation][aad_authorization].
#### Create a Metrics Advisor client using AAD authentication
-
-```java
+```java readme-sample-createMetricsAdvisorClientWithAAD
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
MetricsAdvisorClient metricsAdvisorClient = new MetricsAdvisorClientBuilder()
.endpoint("{endpoint}")
@@ -116,8 +147,7 @@ MetricsAdvisorClient metricsAdvisorClient = new MetricsAdvisorClientBuilder()
```
#### Create a Metrics Administration client using AAD authentication
-
-```java
+```java readme-sample-createMetricsAdvisorAdministrationClientWithAAD
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
MetricsAdvisorAdministrationClient metricsAdvisorAdminClient =
new MetricsAdvisorAdministrationClientBuilder()
@@ -178,25 +208,24 @@ A notification hook is the entry point that allows the users to subscribe to rea
* [Check ingestion status](#check-ingestion-status "Check ingestion status")
* [Configure anomaly detection configuration](#configure-anomaly-detection-configuration "Configure anomaly detection configuration")
* [Add hooks for receiving anomaly alerts](#add-hooks-for-receiving-anomaly-alerts "Add hooks for receiving anomaly alerts")
-* [Configure an anomaly alert configuration](#configure-anomaly-alert-configuration "Configure anomalyAlert configuration")
+* [Configure an anomaly alert configuration](#configure-an-anomaly-alert-configuration "Configure an anomaly alert configuration")
* [Query anomaly detection results](#query-anomaly-detection-results "Query anomaly detection results")
-#### Add a data feed from a sample or data source
+### Add a data feed from a sample or data source
This example ingests the user specified `SQLServerDataFeedSource` data feed source data to the service.
-
-```java
+```java readme-sample-createDataFeed
DataFeed dataFeed = new DataFeed()
.setName("dataFeedName")
.setSource(new MySqlDataFeedSource("conn-string", "query"))
.setGranularity(new DataFeedGranularity().setGranularityType(DataFeedGranularityType.DAILY))
.setSchema(new DataFeedSchema(
Arrays.asList(
- new DataFeedMetric().setName("cost"),
- new DataFeedMetric().setName("revenue")
+ new DataFeedMetric("cost"),
+ new DataFeedMetric("revenue")
)).setDimensions(
Arrays.asList(
- new DataFeedDimension().setName("city"),
- new DataFeedDimension().setName("category")
+ new DataFeedDimension("city"),
+ new DataFeedDimension("category")
))
)
.setIngestionSettings(new DataFeedIngestionSettings(OffsetDateTime.parse("2020-01-01T00:00:00Z")))
@@ -221,14 +250,12 @@ System.out.printf("Data feed source type: %s%n", createdSqlDataFeed.getSourceTyp
if (SQL_SERVER_DB == createdSqlDataFeed.getSourceType()) {
System.out.printf("Data feed sql server query: %s%n",
- ((SQLServerDataFeedSource) createdSqlDataFeed.getSource()).getQuery());
+ ((SqlServerDataFeedSource) createdSqlDataFeed.getSource()).getQuery());
}
```
-#### Check ingestion status
+### Check ingestion status
This example checks the ingestion status of a previously provided data feed source.
-
-
-```java
+```java readme-sample-checkIngestionStatus
String dataFeedId = "3d48er30-6e6e-4391-b78f-b00dfee1e6f5";
metricsAdvisorAdminClient.listDataFeedIngestionStatus(
@@ -243,32 +270,30 @@ metricsAdvisorAdminClient.listDataFeedIngestionStatus(
});
```
-#### Configure anomaly detection configuration
+### Configure anomaly detection configuration
This example demonstrates how a user can configure an anomaly detection configuration for their data.
-
-
-```java
+```java readme-sample-createAnomalyDetectionConfiguration
String metricId = "3d48er30-6e6e-4391-b78f-b00dfee1e6f5";
-ChangeThresholdCondition changeThresholdCondition = new ChangeThresholdCondition()
- .setAnomalyDetectorDirection(AnomalyDetectorDirection.BOTH)
- .setChangePercentage(20)
- .setShiftPoint(10)
- .setWithinRange(true)
- .setSuppressCondition(new SuppressCondition().setMinNumber(1).setMinRatio(2));
+ChangeThresholdCondition changeThresholdCondition = new ChangeThresholdCondition(
+ 20,
+ 10,
+ true,
+ AnomalyDetectorDirection.BOTH,
+ new SuppressCondition(1, 2));
-HardThresholdCondition hardThresholdCondition = new HardThresholdCondition()
- .setAnomalyDetectorDirection(AnomalyDetectorDirection.DOWN)
- .setLowerBound(5.0)
- .setSuppressCondition(new SuppressCondition().setMinNumber(1).setMinRatio(1));
+HardThresholdCondition hardThresholdCondition = new HardThresholdCondition(
+ AnomalyDetectorDirection.DOWN,
+ new SuppressCondition(1, 1))
+ .setLowerBound(5.0);
-SmartDetectionCondition smartDetectionCondition = new SmartDetectionCondition()
- .setAnomalyDetectorDirection(AnomalyDetectorDirection.UP)
- .setSensitivity(10.0)
- .setSuppressCondition(new SuppressCondition().setMinNumber(1).setMinRatio(2));
+SmartDetectionCondition smartDetectionCondition = new SmartDetectionCondition(
+ 10.0,
+ AnomalyDetectorDirection.UP,
+ new SuppressCondition(1, 2));
final AnomalyDetectionConfiguration anomalyDetectionConfiguration =
- metricsAdvisorAdminClient.createMetricAnomalyDetectionConfig(
+ metricsAdvisorAdminClient.createDetectionConfig(
metricId,
new AnomalyDetectionConfiguration("My dataPoint anomaly detection configuration")
.setDescription("anomaly detection config description")
@@ -277,17 +302,16 @@ final AnomalyDetectionConfiguration anomalyDetectionConfiguration =
.setChangeThresholdCondition(changeThresholdCondition)
.setHardThresholdCondition(hardThresholdCondition)
.setSmartDetectionCondition(smartDetectionCondition)
- .setCrossConditionOperator(DetectionConditionsOperator.OR))
+ .setConditionOperator(DetectionConditionOperator.OR))
);
```
### Add hooks for receiving anomaly alerts
This example creates an email hook that receives anomaly incident alerts.
-
-```java
+```java readme-sample-createHook
NotificationHook emailNotificationHook = new EmailNotificationHook("email Hook")
.setDescription("my email Hook")
- .addEmailToAlert("alertme@alertme.com")
+ .setEmailsToAlert(Collections.singletonList("alertme@alertme.com"))
.setExternalLink("https://adwiki.azurewebsites.net/articles/howto/alerts/create-hooks.html");
final NotificationHook notificationHook = metricsAdvisorAdminClient.createHook(emailNotificationHook);
@@ -300,37 +324,34 @@ System.out.printf("Email Hook emails to alert: %s%n",
String.join(",", createdEmailHook.getEmailsToAlert()));
```
-#### Configure an anomaly alert configuration
+### Configure an anomaly alert configuration
This example demonstrates how a user can configure an alerting configuration for detected anomalies in their data.
-
-
-```java
+```java readme-sample-createAnomalyAlertConfiguration
String detectionConfigurationId1 = "9ol48er30-6e6e-4391-b78f-b00dfee1e6f5";
String detectionConfigurationId2 = "3e58er30-6e6e-4391-b78f-b00dfee1e6f5";
String hookId1 = "5f48er30-6e6e-4391-b78f-b00dfee1e6f5";
String hookId2 = "8i48er30-6e6e-4391-b78f-b00dfee1e6f5";
final AnomalyAlertConfiguration anomalyAlertConfiguration
- = metricsAdvisorAdminClient.createAnomalyAlertConfig(
+ = metricsAdvisorAdminClient.createAlertConfig(
new AnomalyAlertConfiguration("My anomaly alert config name")
.setDescription("alert config description")
.setMetricAlertConfigurations(
Arrays.asList(
- new MetricAnomalyAlertConfiguration(detectionConfigurationId1,
+ new MetricAlertConfiguration(detectionConfigurationId1,
MetricAnomalyAlertScope.forWholeSeries()),
- new MetricAnomalyAlertConfiguration(detectionConfigurationId2,
+ new MetricAlertConfiguration(detectionConfigurationId2,
MetricAnomalyAlertScope.forWholeSeries())
.setAlertConditions(new MetricAnomalyAlertConditions()
- .setSeverityRangeCondition(new SeverityCondition()
- .setMaxAlertSeverity(AnomalySeverity.HIGH)))
+ .setSeverityRangeCondition(new SeverityCondition(AnomalySeverity.HIGH,
+ AnomalySeverity.HIGH)))
))
- .setCrossMetricsOperator(MetricAnomalyAlertConfigurationsOperator.AND)
- .setIdOfHooksToAlert(Arrays.asList(hookId1, hookId2)));
+ .setCrossMetricsOperator(MetricAlertConfigurationsOperator.AND)
+ .setHookIdsToAlert(Arrays.asList(hookId1, hookId2)));
```
-#### Query anomaly detection results
+### Query anomaly detection results
This example demonstrates how a user can query alerts triggered for an anomaly detection configuration and get anomalies for that anomalyAlert.
-
-```java
+```java readme-sample-listAnomaliesForAlert
String alertConfigurationId = "9ol48er30-6e6e-4391-b78f-b00dfee1e6f5";
final OffsetDateTime startTime = OffsetDateTime.parse("2020-01-01T00:00:00Z");
final OffsetDateTime endTime = OffsetDateTime.parse("2020-09-09T00:00:00Z");
@@ -360,8 +381,7 @@ Metrics Advisor clients raises `HttpResponseException` [exceptions][http_respons
to provide a non existing feedback Id an `HttpResponseException` would be raised with an error indicating the failure cause.
In the following code snippet, the error is handled
gracefully by catching the exception and display the additional information about the error.
-
-```java
+```java readme-sample-handlingException
try {
metricsAdvisorClient.getFeedback("non_existing_feedback_id");
} catch (HttpResponseException e) {
@@ -382,11 +402,10 @@ the client library to use the Netty HTTP client. Configuring or changing the HTT
## Next steps
For more details see the [samples README][samples_readme].
-#### Async APIs
+### Async APIs
All the examples shown so far have been using synchronous APIs, but we provide full support for async APIs as well.
You'll need to use `MetricsAdvisorAsyncClient`
-
-```java
+```java readme-sample-asyncClient
MetricsAdvisorKeyCredential credential = new MetricsAdvisorKeyCredential("subscription_key", "api_key");
MetricsAdvisorAsyncClient metricsAdvisorAsyncClient = new MetricsAdvisorClientBuilder()
.credential(credential)
@@ -407,31 +426,33 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
-[aad_authorization]: https://docs.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
-[key]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource
-[api_reference_doc]: https://docs.microsoft.com/java/api/com.azure.ai.metricsadvisor?view=azure-java-preview
-[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-metricsadvisor_1.0.0-beta.4/sdk/identity/azure-identity#credentials
-[azure_cli]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows
-[azure_cli_endpoint]: https://docs.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-metricsadvisor_1.0.0-beta.4/sdk/identity/azure-identity#credentials
+[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
+[api_reference_doc]: https://learn.microsoft.com/java/api/com.azure.ai.metricsadvisor?view=azure-java-preview
+[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
+[azure_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows
+[azure_cli_endpoint]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
[azure_portal]: https://ms.portal.azure.com
[azure_subscription]: https://azure.microsoft.com/free
[cla]: https://cla.microsoft.com
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
[coc_contact]: mailto:opencode@microsoft.com
-[create_new_resource]: https://docs.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource
-[http_clients_wiki]: https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients
-[jdk_link]: https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable
-[register_AAD_application]: https://docs.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[create_new_resource]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource
+[grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[http_clients_wiki]: https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients
+[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[key]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource
+[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK
[metrics_advisor_account]: https://ms.portal.azure.com/#create/Microsoft.CognitiveServicesMetricsAdvisor
-[metrics_advisor_doc]: https://docs.microsoft.com/azure/cognitive-services/Metrics-advisor/glossary
-[mvn_package]: https://search.maven.org/artifact/com.azure/azure-ai-metricsadvisor/1.0.0-beta.1/jar
-[product_documentation]: https://docs.microsoft.com/azure/cognitive-services/metrics-advisor/overview
-[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-metricsadvisor_1.0.0-beta.4/sdk/metricsadvisor/azure-ai-metricsadvisor/src
-[samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-metricsadvisor_1.0.0-beta.4/sdk/metricsadvisor/azure-ai-metricsadvisor/src/samples
-[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-metricsadvisor_1.0.0-beta.4/sdk/metricsadvisor/azure-ai-metricsadvisor/src/samples/README.md
-[wiki_identity]: https://github.com/Azure/azure-sdk-for-java/wiki/Identity-and-Authentication
+[metrics_advisor_doc]: https://learn.microsoft.com/azure/cognitive-services/Metrics-advisor/glossary
+[mvn_package]: https://central.sonatype.com/artifact/com.azure/azure-ai-metricsadvisor
+[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/metrics-advisor/overview
+[register_AAD_application]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/metricsadvisor/azure-ai-metricsadvisor/src
+[samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/metricsadvisor/azure-ai-metricsadvisor/src/samples
+[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/metricsadvisor/azure-ai-metricsadvisor/src/samples/README.md
+[wiki_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity
diff --git a/docs-ref-services/preview/ai-projects-readme.md b/docs-ref-services/preview/ai-projects-readme.md
index be8bf4c94da8a..9f9ae5c2ff08c 100644
--- a/docs-ref-services/preview/ai-projects-readme.md
+++ b/docs-ref-services/preview/ai-projects-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Projects client library for Java
keywords: Azure, java, SDK, API, azure-ai-projects, ai
-ms.date: 06/17/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: ai
---
-# Azure Projects client library for Java - version 1.0.0-beta.2
+# Azure Projects client library for Java - version 1.0.0-alpha.20250805.1
Azure Projects client library for Java.
@@ -71,7 +71,7 @@ Always ensure that the chosen API version is fully supported and operational for
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-projects_1.0.0-beta.2/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -84,5 +84,5 @@ For details on contributing to this repository, see the [contributing guide](htt
[docs]: https://azure.github.io/azure-sdk-for-java/
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-projects_1.0.0-beta.2/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
diff --git a/docs-ref-services/preview/ai-textanalytics-readme.md b/docs-ref-services/preview/ai-textanalytics-readme.md
new file mode 100644
index 0000000000000..808ff5cae12b3
--- /dev/null
+++ b/docs-ref-services/preview/ai-textanalytics-readme.md
@@ -0,0 +1,502 @@
+---
+title: Azure Text Analytics client library for Java
+keywords: Azure, java, SDK, API, azure-ai-textanalytics, textanalytics
+ms.date: 08/05/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: textanalytics
+---
+# Azure Text Analytics client library for Java - version 5.6.0-alpha.20250805.1
+
+The Azure Cognitive Service for Language is a cloud-based service that provides Natural Language Processing (NLP)
+features for understanding and analyzing text, and includes the following main features:
+
+- Sentiment Analysis
+- Entity Recognition (Named, Linked, and Personally Identifiable Information (PII) entities)
+- Language Detection
+- Key Phrase Extraction
+- Multiple Actions Analysis Per Document
+- Healthcare Entities Analysis
+- Abstractive Text Summarization
+- Extractive Text Summarization
+- Custom Named Entity Recognition
+- Custom Text Classification
+
+[Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][samples_readme]
+
+## Getting started
+
+### Prerequisites
+- A [Java Development Kit (JDK)][jdk_link], version 8 or later.
+ - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
+- [Azure Subscription][azure_subscription]
+- [Cognitive Services or Language service account][language_service_account] to use this package.
+
+### Include the Package
+
+#### Include the BOM file
+
+Please include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
+To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
+
+```xml
+
+
+
+ com.azure
+ azure-sdk-bom
+ {bom_version_to_target}
+ pom
+ import
+
+
+
+```
+and then include the direct dependency in the dependencies section without the version tag.
+
+```xml
+
+
+ com.azure
+ azure-ai-textanalytics
+
+
+```
+
+#### Include direct dependency
+If you want to take dependency on a particular version of the library that is not present in the BOM,
+add the direct dependency to your project as follows.
+
+[//]: # ({x-version-update-start;com.azure:azure-ai-textanalytics;current})
+```xml
+
+ com.azure
+ azure-ai-textanalytics
+ 5.6.0-beta.1
+
+```
+[//]: # ({x-version-update-end})
+**Note:** This version of the client library defaults to the `2023-04-01` version of the service.
+It is a newer version than `3_0`, `3_1` and `2022-05-01`.
+
+This table shows the relationship between SDK services and supported API versions of the service:
+
+|SDK version|Supported API version of service
+|-|-
+|5.3.x | 3.0, 3.1, 2022-05-01, 2023-04-01 (default)
+|5.2.x | 3.0, 3.1, 2022-05-01
+|5.1.x | 3.0, 3.1
+|5.0.x | 3.0
+
+#### Create a Cognitive Services or Language Service resource
+The Language service supports both [multi-service and single-service access][service_access]. Create a Cognitive Services
+resource if you plan to access multiple cognitive services under a single endpoint/key. For Language service access only,
+create a Language service resource.
+
+You can create the resource using the [Azure Portal][create_new_resource_in_azure_portal] or
+[Azure CLI][azure_cli_doc] following the steps in [this document][create_new_resource_in_azure_cli].
+
+### Authenticate the client
+In order to interact with the Language service, you will need to create an instance of the Text Analytics client,
+both the asynchronous and synchronous clients can be created by using `TextAnalyticsClientBuilder` invoking `buildClient()`
+creates a synchronous client while `buildAsyncClient()` creates its asynchronous counterpart.
+
+You will need an **endpoint** and either a **key** or **AAD TokenCredential** to instantiate a client object.
+
+#### Looking up the endpoint
+You can find the **endpoint** for your Language service resource in the [Azure Portal][azure_portal] under the
+"Keys and Endpoint", or [Azure CLI][azure_cli_endpoint].
+```bash
+# Get the endpoint for the Language service resource
+az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "endpoint"
+```
+
+#### Create a Text Analytics client with key credential
+Once you have the value for the [key][key], provide it as a string to the [AzureKeyCredential][azure_key_credential].
+This can be found in the [Azure Portal][azure_portal] under the "Keys and Endpoint" section in your created Language
+service resource or by running the following Azure CLI command:
+
+```bash
+az cognitiveservices account keys list --resource-group --name
+```
+
+Use the key as the credential parameter to authenticate the client:
+```java readme-sample-createTextAnalyticsClientWithKeyCredential
+TextAnalyticsClient textAnalyticsClient = new TextAnalyticsClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildClient();
+```
+
+The Azure Text Analytics client library provides a way to **rotate the existing key**.
+```java readme-sample-rotatingAzureKeyCredential
+AzureKeyCredential credential = new AzureKeyCredential("{key}");
+TextAnalyticsClient textAnalyticsClient = new TextAnalyticsClientBuilder()
+ .credential(credential)
+ .endpoint("{endpoint}")
+ .buildClient();
+
+credential.update("{new_key}");
+```
+
+#### Create a Text Analytics client with Azure Active Directory credential
+Azure SDK for Java supports an Azure Identity package, making it easy to get credentials from Microsoft identity
+platform.
+
+Authentication with AAD requires some initial setup:
+* Add the Azure Identity package
+
+[//]: # ({x-version-update-start;com.azure:azure-identity;dependency})
+```xml
+
+ com.azure
+ azure-identity
+ 1.15.3
+
+```
+[//]: # ({x-version-update-end})
+* [Register a new Azure Active Directory application][register_AAD_application]
+* [Grant access][grant_access] to Language service by assigning the `"Cognitive Services User"` role to your service principal.
+
+After setup, you can choose which type of [credential][azure_identity_credential_type] from azure.identity to use.
+As an example, [DefaultAzureCredential][wiki_identity] can be used to authenticate the client:
+Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
+AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.
+
+Authorization is easiest using [DefaultAzureCredential][wiki_identity]. It finds the best credential to use in its
+running environment. For more information about using Azure Active Directory authorization with Language service, please
+refer to [the associated documentation][aad_authorization].
+
+```java readme-sample-createTextAnalyticsAsyncClientWithAAD
+TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
+TextAnalyticsAsyncClient textAnalyticsAsyncClient = new TextAnalyticsClientBuilder()
+ .endpoint("{endpoint}")
+ .credential(defaultCredential)
+ .buildAsyncClient();
+```
+
+## Key concepts
+### Text Analytics client
+The Text Analytics client library provides a [TextAnalyticsClient][text_analytics_sync_client] and
+[TextAnalyticsAsyncClient][text_analytics_async_client] to do analysis on batches of documents. It provides both synchronous and
+asynchronous operations to access a specific use of Language service, such as language detection or key phrase extraction.
+
+### Input
+A **text input**, also called a **document**, is a single unit of document to be analyzed by the predictive models
+in the Language service. Operations on a Text Analytics client may take a single document or a collection
+of documents to be analyzed as a batch.
+See [service limitations][service_input_limitation] for the document, including document length limits, maximum batch size,
+and supported text encoding.
+
+### Operation on multiple documents
+For each supported operation, the Text Analytics client provides method overloads to take a single document, a batch
+of documents as strings, or a batch of either `TextDocumentInput` or `DetectLanguageInput` objects. The overload
+taking the `TextDocumentInput` or `DetectLanguageInput` batch allows callers to give each document a unique ID,
+indicate that the documents in the batch are written in different languages, or provide a country hint about the
+language of the document.
+
+### Return value
+An operation result, such as `AnalyzeSentimentResult`, is the result of a Language service operation, containing a
+prediction or predictions about a single document and a list of warnings inside of it. An operation's result type also
+may optionally include information about the input document and how it was processed. An operation result contains a
+`isError` property that allows to identify if an operation executed was successful or unsuccessful for the given
+document. When the operation results an error, you can simply call `getError()` to get `TextAnalyticsError` which
+contains the reason why it is unsuccessful. If you are interested in how many characters are in your document,
+or the number of operation transactions that have gone through, simply call `getStatistics()` to get the
+`TextDocumentStatistics` which contains both information.
+
+### Return value collection
+An operation result collection, such as `AnalyzeSentimentResultCollection`, which is the collection of
+the result of analyzing sentiment operation. It also includes the model version of the operation and statistics of
+the batch documents.
+
+**Note**: It is recommended to use the batch methods when working on production environments as they allow you to send one
+request with multiple documents. This is more performant than sending a request per each document.
+
+## Examples
+The following sections provide several code snippets covering some of the most common Language service tasks, including:
+
+* [Analyze Sentiment](#analyze-sentiment "Analyze sentiment")
+* [Detect Language](#detect-language "Detect language")
+* [Extract Key Phrases](#extract-key-phrases "Extract key phrases")
+* [Recognize Named Entities](#recognize-named-entities "Recognize named entities")
+* [Recognize Personally Identifiable Information Entities](#recognize-personally-identifiable-information-entities "Recognize Personally Identifiable Information entities")
+* [Recognize Linked Entities](#recognize-linked-entities "Recognize linked entities")
+* [Analyze Healthcare Entities](#analyze-healthcare-entities "Analyze healthcare entities")
+* [Analyze Multiple Actions](#analyze-multiple-actions "Analyze multiple actions")
+* [Custom Entities Recognition](#custom-entities-recognition "Custom entities recognition")
+* [Custom Text Classification](#custom-text-classification "Custom text classification")
+* [Abstractive Text Summarization][abstractive_summary_action_sample]
+* [Extractive Text Summarization][extractive_summary_action_sample]
+
+### Text Analytics Client
+Language service supports both synchronous and asynchronous client creation by using
+`TextAnalyticsClientBuilder`,
+
+``` java readme-sample-createTextAnalyticsClientWithKeyCredential
+TextAnalyticsClient textAnalyticsClient = new TextAnalyticsClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildClient();
+```
+
+or
+
+``` java readme-sample-createTextAnalyticsAsyncClientWithKeyCredential
+TextAnalyticsAsyncClient textAnalyticsAsyncClient = new TextAnalyticsClientBuilder()
+ .credential(new AzureKeyCredential("{key}"))
+ .endpoint("{endpoint}")
+ .buildAsyncClient();
+```
+
+### Analyze sentiment
+Run a predictive model to identify the positive, negative, neutral or mixed sentiment contained in the
+provided document or batch of documents.
+``` java readme-sample-analyzeSentiment
+String document = "The hotel was dark and unclean. I like microsoft.";
+DocumentSentiment documentSentiment = textAnalyticsClient.analyzeSentiment(document);
+System.out.printf("Analyzed document sentiment: %s.%n", documentSentiment.getSentiment());
+documentSentiment.getSentences().forEach(sentenceSentiment ->
+ System.out.printf("Analyzed sentence sentiment: %s.%n", sentenceSentiment.getSentiment()));
+```
+
+For samples on using the production recommended option `AnalyzeSentimentBatch` see [here][analyze_sentiment_sample].
+
+To get more granular information about the opinions related to aspects of a product/service, also knows as Aspect-based
+Sentiment Analysis in Natural Language Processing (NLP), see sample on sentiment analysis with opinion mining see
+[here][analyze_sentiment_with_opinion_mining_sample].
+
+Please refer to the service documentation for a conceptual discussion of [sentiment analysis][sentiment_analysis].
+
+### Detect language
+Run a predictive model to determine the language that the provided document or batch of documents are written in.
+
+```java readme-sample-detectLanguages
+String document = "Bonjour tout le monde";
+DetectedLanguage detectedLanguage = textAnalyticsClient.detectLanguage(document);
+System.out.printf("Detected language name: %s, ISO 6391 name: %s, confidence score: %f.%n",
+ detectedLanguage.getName(), detectedLanguage.getIso6391Name(), detectedLanguage.getConfidenceScore());
+```
+For samples on using the production recommended option `DetectLanguageBatch` see [here][detect_language_sample].
+Please refer to the service documentation for a conceptual discussion of [language detection][language_detection].
+
+### Extract key phrases
+Run a model to identify a collection of significant phrases found in the provided document or batch of documents.
+
+```java readme-sample-extractKeyPhrases
+String document = "My cat might need to see a veterinarian.";
+System.out.println("Extracted phrases:");
+textAnalyticsClient.extractKeyPhrases(document).forEach(keyPhrase -> System.out.printf("%s.%n", keyPhrase));
+```
+For samples on using the production recommended option `ExtractKeyPhrasesBatch` see [here][extract_key_phrases_sample].
+Please refer to the service documentation for a conceptual discussion of [key phrase extraction][key_phrase_extraction].
+
+### Recognize named entities
+Run a predictive model to identify a collection of named entities in the provided document or batch of documents and
+categorize those entities into categories such as person, location, or organization. For more information on available
+categories, see [Named Entity Categories][named_entities_categories].
+
+```java readme-sample-recognizeEntity
+String document = "Satya Nadella is the CEO of Microsoft";
+textAnalyticsClient.recognizeEntities(document).forEach(entity ->
+ System.out.printf("Recognized entity: %s, category: %s, subcategory: %s, confidence score: %f.%n",
+ entity.getText(), entity.getCategory(), entity.getSubcategory(), entity.getConfidenceScore()));
+```
+For samples on using the production recommended option `RecognizeEntitiesBatch` see [here][recognize_entities_sample].
+Please refer to the service documentation for a conceptual discussion of [named entity recognition][named_entity_recognition].
+
+### Recognize Personally Identifiable Information entities
+Run a predictive model to identify a collection of Personally Identifiable Information(PII) entities in the provided
+document. It recognizes and categorizes PII entities in its input text, such as
+Social Security Numbers, bank account information, credit card numbers, and more. This endpoint is only supported for
+API versions v3.1-preview.1 and above.
+
+```java readme-sample-recognizePiiEntity
+String document = "My SSN is 859-98-0987";
+PiiEntityCollection piiEntityCollection = textAnalyticsClient.recognizePiiEntities(document);
+System.out.printf("Redacted Text: %s%n", piiEntityCollection.getRedactedText());
+piiEntityCollection.forEach(entity -> System.out.printf(
+ "Recognized Personally Identifiable Information entity: %s, entity category: %s, entity subcategory: %s,"
+ + " confidence score: %f.%n",
+ entity.getText(), entity.getCategory(), entity.getSubcategory(), entity.getConfidenceScore()));
+```
+
+For samples on using the production recommended option `RecognizePiiEntitiesBatch` see [here][recognize_pii_entities_sample].
+Please refer to the service documentation for [supported PII entity types][pii_entity_recognition].
+
+### Recognize linked entities
+Run a predictive model to identify a collection of entities found in the provided document or batch of documents,
+and include information linking the entities to their corresponding entries in a well-known knowledge base.
+
+```java readme-sample-recognizeLinkedEntity
+String document = "Old Faithful is a geyser at Yellowstone Park.";
+textAnalyticsClient.recognizeLinkedEntities(document).forEach(linkedEntity -> {
+ System.out.println("Linked Entities:");
+ System.out.printf("Name: %s, entity ID in data source: %s, URL: %s, data source: %s.%n",
+ linkedEntity.getName(), linkedEntity.getDataSourceEntityId(), linkedEntity.getUrl(), linkedEntity.getDataSource());
+ linkedEntity.getMatches().forEach(match ->
+ System.out.printf("Text: %s, confidence score: %f.%n", match.getText(), match.getConfidenceScore()));
+});
+```
+For samples on using the production recommended option `RecognizeLinkedEntitiesBatch` see [here][recognize_linked_entities_sample].
+Please refer to the service documentation for a conceptual discussion of [entity linking][entity_linking].
+
+### Analyze healthcare entities
+Text Analytics for health is a containerized service that extracts and labels relevant medical information from
+unstructured texts such as doctor's notes, discharge summaries, clinical documents, and electronic health records.
+
+- [Healthcare entities recognition][recognize_healthcare_entities_sample]
+
+For more information see [How to: Use Text Analytics for health][healthcare].
+
+### Custom entities recognition
+Custom NER is one of the custom features offered by Azure Cognitive Service for Language. It is a cloud-based API
+service that applies machine-learning intelligence to enable you to build custom models for custom named entity
+recognition tasks.
+
+- [Custom entities recognition][recognize_custom_entities_sample]
+
+For more information see [How to use: Custom Entities Recognition][custom_entities_recognition_overview].
+
+### Custom text classification
+Custom text classification is one of the custom features offered by Azure Cognitive Service for Language. It is a
+cloud-based API service that applies machine-learning intelligence to enable you to build custom models for text
+classification tasks.
+
+- [Single label classification][single_label_classification_sample]
+
+- [Multi label classification][multi_label_classification_sample]
+
+For more information see [How to use: Custom Text Classification][custom_text_classification_overview].
+
+### Analyze multiple actions
+The `Analyze` functionality allows choosing which of the supported Language service features to execute in the same
+set of documents. Currently, the supported features are:
+
+- Named Entities Recognition
+- PII Entities Recognition
+- Linked Entity Recognition
+- Key Phrase Extraction
+- Sentiment Analysis
+- Healthcare Analysis
+- Custom Entity Recognition (API version 2022-05-01 and newer)
+- Custom Single-Label Classification (API version 2022-05-01 and newer)
+- Custom Multi-Label Classification (API version 2022-05-01 and newer)
+- Abstractive Text Summarization (API version 2023-04-01 and newer)
+- Extractive Text Summarization (API version 2023-04-01 and newer)
+
+
+Sample: [Multiple action analysis][multiple_actions_analysis_sample]
+
+For more examples, such as asynchronous samples, refer to [here][samples_readme].
+
+## Troubleshooting
+### General
+Text Analytics clients raise exceptions. For example, if you try to detect the languages of a batch of text with same
+document IDs, `400` error is return that indicating bad request. In the following code snippet, the error is handled
+gracefully by catching the exception and display the additional information about the error.
+
+```java readme-sample-handlingException
+List documents = Arrays.asList(
+ new DetectLanguageInput("1", "This is written in English.", "us"),
+ new DetectLanguageInput("1", "Este es un documento escrito en Español.", "es")
+);
+
+try {
+ textAnalyticsClient.detectLanguageBatchWithResponse(documents, null, Context.NONE);
+} catch (HttpResponseException e) {
+ System.out.println(e.getMessage());
+}
+```
+
+### Enable client logging
+You can set the `AZURE_LOG_LEVEL` environment variable to view logging statements made in the client library. For
+example, setting `AZURE_LOG_LEVEL=2` would show all informational, warning, and error log messages. The log levels can
+be found here: [log levels][LogLevels].
+
+### Default HTTP Client
+All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure
+the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
+[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
+
+### Default SSL library
+All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL
+operations. The Boring SSL library is an uber jar containing native libraries for Linux / macOS / Windows, and provides
+better performance compared to the default SSL implementation within the JDK. For more information, including how to
+reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
+
+## Next steps
+- Samples are explained in detail [here][samples_readme].
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a [Contributor License Agreement (CLA)][cla] declaring that you have the right to, and actually do, grant us the rights to use your contribution.
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
+
+
+[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
+[aad_credential]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
+[api_reference_doc]: https://aka.ms/azsdk-java-textanalytics-ref-docs
+[authentication]: https://learn.microsoft.com/azure/cognitive-services/authentication
+[azure_cli_doc]: https://learn.microsoft.com/cli/azure/
+[azure_cli_endpoint]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
+[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
+[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java
+[azure_portal]: https://ms.portal.azure.com
+[azure_subscription]: https://azure.microsoft.com/free
+[cla]: https://cla.microsoft.com
+[coc]: https://opensource.microsoft.com/codeofconduct/
+[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
+[coc_contact]: mailto:opencode@microsoft.com
+[create_new_resource_in_azure_portal]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource
+[create_new_resource_in_azure_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows
+[custom_entities_recognition_overview]: https://learn.microsoft.com/azure/cognitive-services/language-service/custom-named-entity-recognition/overview
+[custom_subdomain]: https://learn.microsoft.com/azure/cognitive-services/authentication#create-a-resource-with-a-custom-subdomain
+[custom_text_classification_overview]: https://learn.microsoft.com/azure/cognitive-services/language-service/custom-text-classification/overview
+[grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[healthcare]: https://learn.microsoft.com/azure/cognitive-services/language-service/text-analytics-for-health/overview?tabs=ner
+[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable
+[key]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource
+[key_phrase_extraction]: https://learn.microsoft.com/azure/cognitive-services/language-service/key-phrase-extraction/overview
+[language_detection]: https://learn.microsoft.com/azure/cognitive-services/language-service/language-detection/overview
+[language_regional_support]: https://learn.microsoft.com/azure/cognitive-services/language-service/language-detection/language-support
+[named_entity_recognition]: https://learn.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/overview
+[named_entities_categories]: https://learn.microsoft.com/azure/cognitive-services/language-service/named-entity-recognition/concepts/named-entity-categories
+[entity_linking]: https://learn.microsoft.com/azure/cognitive-services/language-service/entity-linking/overview
+[pii_entity_recognition]: https://learn.microsoft.com/azure/cognitive-services/language-service/personally-identifiable-information/overview
+[package]: https://central.sonatype.com/artifact/com.azure/azure-ai-textanalytics
+[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
+[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/language-service/overview
+[register_AAD_application]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal
+[service_access]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
+[service_input_limitation]: https://learn.microsoft.com/azure/cognitive-services/language-service/overview#data-limits
+[sentiment_analysis]: https://learn.microsoft.com/azure/cognitive-services/language-service/sentiment-opinion-mining/overview
+[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/textanalytics/azure-ai-textanalytics/src
+[language_service_account]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows
+[text_analytics_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/main/java/com/azure/ai/textanalytics/TextAnalyticsAsyncClient.java
+[text_analytics_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/main/java/com/azure/ai/textanalytics/TextAnalyticsClient.java
+[wiki_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity
+[LogLevels]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java
+
+[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/README.md
+[abstractive_summary_action_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/AbstractiveSummarization.java
+[analyze_sentiment_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/AnalyzeSentimentBatchDocuments.java
+[analyze_sentiment_with_opinion_mining_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/AnalyzeSentimentWithOpinionMining.java
+[detect_language_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/DetectLanguageBatchDocuments.java
+[extract_key_phrases_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/ExtractKeyPhrasesBatchDocuments.java
+[extractive_summary_action_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/ExtractiveSummarization.java
+[multi_label_classification_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/MultiLabelClassifyDocument.java
+[multiple_actions_analysis_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/AnalyzeActions.java
+[recognize_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeEntitiesBatchDocuments.java
+[recognize_pii_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizePiiEntitiesBatchDocuments.java
+[recognize_linked_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/batch/RecognizeLinkedEntitiesBatchDocuments.java
+[recognize_healthcare_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/AnalyzeHealthcareEntities.java
+[recognize_custom_entities_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/RecognizeCustomEntities.java
+[single_label_classification_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics/src/samples/java/com/azure/ai/textanalytics/lro/SingleLabelClassifyDocument.java
+
+
+
diff --git a/docs-ref-services/preview/ai-translation-document-readme.md b/docs-ref-services/preview/ai-translation-document-readme.md
index ddcf69aa25318..f8224efd328d3 100644
--- a/docs-ref-services/preview/ai-translation-document-readme.md
+++ b/docs-ref-services/preview/ai-translation-document-readme.md
@@ -1,12 +1,12 @@
---
title: Azure DocumentTranslation client library for Java
keywords: Azure, java, SDK, API, azure-ai-translation-document, translation
-ms.date: 06/19/2024
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: translation
---
-# Azure DocumentTranslation client library for Java - version 1.0.0-beta.2
+# Azure DocumentTranslation client library for Java - version 1.1.0-alpha.20250805.1
Document Translation is a cloud-based machine translation feature of the Azure AI Translator service. You can translate multiple and complex documents across all supported languages and dialects while preserving original document structure and data format. The Document translation API supports two translation processes:
@@ -37,7 +37,7 @@ Various documentation is available to help you get started
com.azureazure-ai-translation-document
- 1.0.0-beta.2
+ 1.1.0-beta.1
```
[//]: # ({x-version-update-end})
@@ -46,48 +46,68 @@ Various documentation is available to help you get started
Interaction with the service using the client library begins with creating an instance of the [DocumentTranslationClient][document_translator_client_class] class. You will need an **API key** or ``TokenCredential`` and **Endpoint** to instantiate a document translation client object. Similarly for [SingleDocumentTranslationclient][single_document_translator_client_class]
-#### Get an API key
+Managed identities for Azure resources are service principals that create a Microsoft Entra identity and specific permissions for Azure managed resources. Managed identities are a safer way to grant access to storage data and replace the requirement for you to include shared access signature tokens (SAS) with your source and target URLs.
+Here is more information on [Managed identities for Document Translation] [managed_identities_for_document_translation].
-You can get the `endpoint`, `API key` and `Region` from the Cognitive Services resource or Document Translator service resource information in the [Azure Portal][azure_portal].
+#### Create DocumentTranslationClient and SingleDocumentTranslationClient using Azure Active Directory credential
+Azure SDK for Java supports an Azure Identity package, making it easy to get credentials from Microsoft identity
+platform.
-Alternatively, use the [Azure CLI][azure_cli] snippet below to get the API key from the Translator service resource.
+Authentication with AAD requires some initial setup:
+* Add the Azure Identity package
-```PowerShell
-az cognitiveservices account keys list --resource-group --name
+[//]: # ({x-version-update-start;com.azure:azure-identity;dependency})
+```xml
+
+ com.azure
+ azure-identity
+ 1.15.3
+
```
+[//]: # ({x-version-update-end})
-#### Create a `DocumentTranslationClient` using endpoint and API key credential
-
-Once you have the value for the API key, create an `AzureKeyCredential`. This will allow you to
-update the API key without creating a new client.
+After setup, you can choose which type of [credential][azure_identity_credential_type] from azure-identity to use.
+As an example, [DefaultAzureCredential][wiki_identity] can be used to authenticate the client:
+Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
+`AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`.
-With the value of the `endpoint` and `AzureKeyCredential` , you can create the [DocumentTranslationClient][document_translator_client_class]:
+Authorization is easiest using [DefaultAzureCredential][wiki_identity]. It finds the best credential to use in its
+running environment. For more information about using Azure Active Directory authorization with DocumentTranslation service, please
+refer to [the associated documentation][aad_authorization].
-```java createDocumentTranslationClient
+```java createDocumentTranslationClientWithAAD
String endpoint = System.getenv("DOCUMENT_TRANSLATION_ENDPOINT");
-String apiKey = System.getenv("DOCUMENT_TRANSLATION_API_KEY");
-
-AzureKeyCredential credential = new AzureKeyCredential(apiKey);
+TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
DocumentTranslationClient client = new DocumentTranslationClientBuilder()
- .endpoint(endpoint)
- .credential(credential)
- .buildClient();
+ .endpoint(endpoint)
+ .credential(defaultCredential)
+ .buildClient();
```
-You can similarly create the [SingleDocumentTranslationClient][single_document_translator_client_class]:
-```java createSingleDocumentTranslationClient
+```java createSingleDocumentTranslationClientWithAAD
String endpoint = System.getenv("DOCUMENT_TRANSLATION_ENDPOINT");
-String apiKey = System.getenv("DOCUMENT_TRANSLATION_API_KEY");
-AzureKeyCredential credential = new AzureKeyCredential(apiKey);
+TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
SingleDocumentTranslationClient client = new SingleDocumentTranslationClientBuilder()
- .endpoint(endpoint)
- .credential(credential)
- .buildClient();
+ .endpoint(endpoint)
+ .credential(defaultCredential)
+ .buildClient();
+```
+#### Create a `DocumentTranslationClient` or `SingleDocumentTranslationClient` using endpoint and API key credential
+
+You can get the `endpoint`, `API key` and `Region` from the Cognitive Services resource or Document Translator service resource information in the [Azure Portal][azure_portal].
+
+Alternatively, use the [Azure CLI][azure_cli] snippet below to get the API key from the Translator service resource.
+
+```PowerShell
+az cognitiveservices account keys list --resource-group --name
```
+Please refer to these samples for creating [DocumentTranslationClientWithAPIKey][sample_document_translation_client_with_apiKey] and [SingleDocumentTranslationClientWithAPIKey][sample_single_document_translation_client_with_apiKey].
+
+
## Key concepts
### `DocumentTranslationClient` and `DocumentTranslationAsyncClient`
@@ -111,8 +131,7 @@ The following section provides several code snippets using the `client` [created
Gets a list of document and glossary formats supported by the Document Translation feature. The list includes common file extensions and content-type if using the upload API.
```java getSupportedFormats
-SupportedFileFormats documentResponse = documentTranslationClient.getSupportedFormats(FileFormatType.DOCUMENT);
-List documentFileFormats = documentResponse.getValue();
+List documentFileFormats = documentTranslationClient.getSupportedFormats(FileFormatType.DOCUMENT);
for (FileFormat fileFormat : documentFileFormats) {
System.out.println("FileFormat:" + fileFormat.getFormat());
System.out.println("FileExtensions:" + fileFormat.getFileExtensions());
@@ -120,8 +139,7 @@ for (FileFormat fileFormat : documentFileFormats) {
System.out.println("Type:" + fileFormat.getType());
}
-SupportedFileFormats glossaryResponse = documentTranslationClient.getSupportedFormats(FileFormatType.GLOSSARY);
-List glossaryFileFormats = glossaryResponse.getValue();
+List glossaryFileFormats = documentTranslationClient.getSupportedFormats(FileFormatType.GLOSSARY);
for (FileFormat fileFormat : glossaryFileFormats) {
System.out.println("FileFormat:" + fileFormat.getFormat());
System.out.println("FileExtensions:" + fileFormat.getFileExtensions());
@@ -136,26 +154,39 @@ Please refer to the service documentation for a conceptual discussion of [docume
Executes an asynchronous batch translation request. The method requires an Azure Blob storage account with storage containers for your source and translated documents.
```java startDocumentTranslation
-SyncPoller response
- = documentTranslationClient
- .beginStartTranslation(
- new StartTranslationDetails(Arrays.asList(new BatchRequest(
- new SourceInput("https://myblob.blob.core.windows.net/sourceContainer")
- .setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"))
- .setLanguage("en")
- .setStorageSource(StorageSource.AZURE_BLOB),
- Arrays
- .asList(
- new TargetInput("https://myblob.blob.core.windows.net/destinationContainer1", "fr")
- .setCategory("general")
- .setGlossaries(Arrays.asList(new Glossary(
- "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf", "XLIFF")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageSource(StorageSource.AZURE_BLOB),
- new TargetInput("https://myblob.blob.core.windows.net/destinationContainer2", "es")
- .setCategory("general")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageType(StorageInputType.FOLDER))));
+String sourceUrl = "https://myblob.blob.core.windows.net/sourceContainer";
+TranslationSource translationSource = new TranslationSource(sourceUrl);
+translationSource.setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"));
+translationSource.setLanguage("en");
+translationSource.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl1 = "https://myblob.blob.core.windows.net/destinationContainer1";
+TranslationTarget translationTarget1 = new TranslationTarget(targetUrl1, "fr");
+translationTarget1.setCategory("general");
+
+TranslationGlossary translationGlossary = new TranslationGlossary(
+ "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
+ "XLIFF");
+List translationGlossaries = new ArrayList<>();
+translationGlossaries.add(translationGlossary);
+translationTarget1.setGlossaries(translationGlossaries);
+translationTarget1.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl2 = "https://myblob.blob.core.windows.net/destinationContainer2";
+TranslationTarget translationTarget2 = new TranslationTarget(targetUrl2, "fr");
+translationTarget2.setCategory("general");
+translationTarget2.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+List translationTargets = new ArrayList<>();
+translationTargets.add(translationTarget1);
+translationTargets.add(translationTarget2);
+
+DocumentTranslationInput batchRequest = new DocumentTranslationInput(translationSource, translationTargets);
+batchRequest.setStorageType(StorageInputType.FOLDER);
+
+SyncPoller response = documentTranslationClient
+ .beginTranslation(TestHelper.getStartTranslationDetails(batchRequest));
+TranslationStatusResult translationStatus = response.waitForCompletion().getValue();
```
Please refer to the service documentation for a conceptual discussion of [batchTranslation][batchTranslation_doc].
@@ -165,9 +196,9 @@ Synchronously translate a single document.
```java SingleDocumentTranslation
DocumentFileDetails document = createDocumentContent();
DocumentTranslateContent documentTranslateContent = new DocumentTranslateContent(document);
-String targetLanguage = "hi";
+String targetLanguage = "hi";
-BinaryData response = singleDocumentTranslationClient.documentTranslate(targetLanguage, documentTranslateContent);
+BinaryData response = singleDocumentTranslationClient.translate(targetLanguage, documentTranslateContent);
String translatedResponse = response.toString();
System.out.println("Translated Response: " + translatedResponse);
```
@@ -177,35 +208,43 @@ Please refer to the service documentation for a conceptual discussion of [single
Cancels a translation job that is currently processing or queued (pending) as indicated in the request by the id query parameter.
```java CancelDocumentTranslation
-DocumentTranslationClient documentTranslationClient = new DocumentTranslationClientBuilder()
- .endpoint("{endpoint}")
- .credential(new AzureKeyCredential("{key}"))
- .buildClient();
-
-SyncPoller response
- = documentTranslationClient
- .beginStartTranslation(
- new StartTranslationDetails(Arrays.asList(new BatchRequest(
- new SourceInput("https://myblob.blob.core.windows.net/sourceContainer")
- .setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"))
- .setLanguage("en")
- .setStorageSource(StorageSource.AZURE_BLOB),
- Arrays
- .asList(
- new TargetInput("https://myblob.blob.core.windows.net/destinationContainer1", "fr")
- .setCategory("general")
- .setGlossaries(Arrays.asList(new Glossary(
- "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf", "XLIFF")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageSource(StorageSource.AZURE_BLOB),
- new TargetInput("https://myblob.blob.core.windows.net/destinationContainer2", "es")
- .setCategory("general")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageType(StorageInputType.FOLDER))));
+String sourceUrl = "https://myblob.blob.core.windows.net/sourceContainer";
+TranslationSource translationSource = new TranslationSource(sourceUrl);
+translationSource.setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"));
+translationSource.setLanguage("en");
+translationSource.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl1 = "https://myblob.blob.core.windows.net/destinationContainer1";
+TranslationTarget translationTarget1 = new TranslationTarget(targetUrl1, "fr");
+translationTarget1.setCategory("general");
+
+TranslationGlossary translationGlossary = new TranslationGlossary(
+ "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
+ "XLIFF");
+List translationGlossaries = new ArrayList<>();
+translationGlossaries.add(translationGlossary);
+translationTarget1.setGlossaries(translationGlossaries);
+translationTarget1.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl2 = "https://myblob.blob.core.windows.net/destinationContainer2";
+TranslationTarget translationTarget2 = new TranslationTarget(targetUrl2, "fr");
+translationTarget2.setCategory("general");
+translationTarget2.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+List translationTargets = new ArrayList<>();
+translationTargets.add(translationTarget1);
+translationTargets.add(translationTarget2);
+
+DocumentTranslationInput batchRequest = new DocumentTranslationInput(translationSource, translationTargets);
+batchRequest.setStorageType(StorageInputType.FOLDER);
+
+SyncPoller response = documentTranslationClient
+ .beginTranslation(TestHelper.getStartTranslationDetails(batchRequest));
String translationId = response.poll().getValue().getId();
-documentTranslationClient.cancelTranslation(translationId);
-TranslationStatus translationStatus = documentTranslationClient.getTranslationStatus(translationId);
+documentTranslationClient.cancelTranslation(translationId);
+TranslationStatusResult translationStatus = documentTranslationClient
+ .getTranslationStatus(translationId);
System.out.println("Translation ID is: " + translationStatus.getId());
System.out.println("Translation status is: " + translationStatus.getStatus().toString());
@@ -216,33 +255,42 @@ Please refer to the service documentation for a conceptual discussion of [cancel
Gets a list and the status of all translation jobs submitted by the user (associated with the resource).
```java GetTranslationsStatus
-SyncPoller response = documentTranslationClient
- .beginStartTranslation(
- new StartTranslationDetails(Arrays.asList(new BatchRequest(
- new SourceInput("https://myblob.blob.core.windows.net/sourceContainer")
- .setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"))
- .setLanguage("en")
- .setStorageSource(StorageSource.AZURE_BLOB),
- Arrays
- .asList(
- new TargetInput(
- "https://myblob.blob.core.windows.net/destinationContainer1",
- "fr")
- .setCategory("general")
- .setGlossaries(Arrays.asList(new Glossary(
- "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
- "XLIFF")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageSource(StorageSource.AZURE_BLOB),
- new TargetInput(
- "https://myblob.blob.core.windows.net/destinationContainer2",
- "es")
- .setCategory("general")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageType(StorageInputType.FOLDER))));
-
-PagedIterable translationStatuses = documentTranslationClient.getTranslationsStatus();
-for (TranslationStatus translationStatus : translationStatuses) {
+String sourceUrl = "https://myblob.blob.core.windows.net/sourceContainer";
+TranslationSource translationSource = new TranslationSource(sourceUrl);
+translationSource.setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"));
+translationSource.setLanguage("en");
+translationSource.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl1 = "https://myblob.blob.core.windows.net/destinationContainer1";
+TranslationTarget translationTarget1 = new TranslationTarget(targetUrl1, "fr");
+translationTarget1.setCategory("general");
+
+TranslationGlossary translationGlossary = new TranslationGlossary(
+ "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
+ "XLIFF");
+List translationGlossaries = new ArrayList<>();
+translationGlossaries.add(translationGlossary);
+translationTarget1.setGlossaries(translationGlossaries);
+translationTarget1.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl2 = "https://myblob.blob.core.windows.net/destinationContainer2";
+TranslationTarget translationTarget2 = new TranslationTarget(targetUrl2, "fr");
+translationTarget2.setCategory("general");
+translationTarget2.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+List translationTargets = new ArrayList<>();
+translationTargets.add(translationTarget1);
+translationTargets.add(translationTarget2);
+
+DocumentTranslationInput batchRequest = new DocumentTranslationInput(translationSource, translationTargets);
+batchRequest.setStorageType(StorageInputType.FOLDER);
+
+SyncPoller response = documentTranslationClient
+ .beginTranslation(TestHelper.getStartTranslationDetails(batchRequest));
+
+PagedIterable < TranslationStatusResult> translationStatuses = documentTranslationClient
+ .listTranslationStatuses();
+for (TranslationStatusResult translationStatus: translationStatuses) {
System.out.println("Translation ID is: " + translationStatus.getId());
System.out.println("Translation status is: " + translationStatus.getStatus().toString());
}
@@ -253,29 +301,42 @@ Please refer to the service documentation for a conceptual discussion of [getTra
Request a summary of the status for a specific translation job. The response includes the overall job status and the status for documents that are being translated as part of that job.
```java GetTranslationStatus
-SyncPoller response
- = documentTranslationClient
- .beginStartTranslation(
- new StartTranslationDetails(Arrays.asList(new BatchRequest(
- new SourceInput("https://myblob.blob.core.windows.net/sourceContainer")
- .setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"))
- .setLanguage("en")
- .setStorageSource(StorageSource.AZURE_BLOB),
- Arrays
- .asList(
- new TargetInput("https://myblob.blob.core.windows.net/destinationContainer1", "fr")
- .setCategory("general")
- .setGlossaries(Arrays.asList(new Glossary(
- "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf", "XLIFF")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageSource(StorageSource.AZURE_BLOB),
- new TargetInput("https://myblob.blob.core.windows.net/destinationContainer2", "es")
- .setCategory("general")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageType(StorageInputType.FOLDER))));
-
-String translationId = response.poll().getValue().getId();
-TranslationStatus translationStatus = documentTranslationClient.getTranslationStatus(translationId);
+String sourceUrl = "https://myblob.blob.core.windows.net/sourceContainer";
+TranslationSource translationSource = new TranslationSource(sourceUrl);
+translationSource.setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"));
+translationSource.setLanguage("en");
+translationSource.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl1 = "https://myblob.blob.core.windows.net/destinationContainer1";
+TranslationTarget translationTarget1 = new TranslationTarget(targetUrl1, "fr");
+translationTarget1.setCategory("general");
+
+TranslationGlossary translationGlossary = new TranslationGlossary(
+ "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
+ "XLIFF");
+List translationGlossaries = new ArrayList<>();
+translationGlossaries.add(translationGlossary);
+translationTarget1.setGlossaries(translationGlossaries);
+translationTarget1.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl2 = "https://myblob.blob.core.windows.net/destinationContainer2";
+TranslationTarget translationTarget2 = new TranslationTarget(targetUrl2, "fr");
+translationTarget2.setCategory("general");
+translationTarget2.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+List translationTargets = new ArrayList<>();
+translationTargets.add(translationTarget1);
+translationTargets.add(translationTarget2);
+
+DocumentTranslationInput batchRequest = new DocumentTranslationInput(translationSource, translationTargets);
+batchRequest.setStorageType(StorageInputType.FOLDER);
+
+SyncPoller response = documentTranslationClient
+ .beginTranslation(TestHelper.getStartTranslationDetails(batchRequest));
+
+String translationId = response.poll().getValue().getId();
+TranslationStatusResult translationStatus = documentTranslationClient
+ .getTranslationStatus(translationId);
System.out.println("Translation ID is: " + translationStatus.getId());
System.out.println("Translation status is: " + translationStatus.getStatus().toString());
@@ -287,39 +348,50 @@ Please refer to the service documentation for a conceptual discussion of [getTra
Gets the status for all documents in a translation job.
```java GetDocumentsStatus
-SyncPoller response = documentTranslationClient
- .beginStartTranslation(
- new StartTranslationDetails(Arrays.asList(new BatchRequest(
- new SourceInput("https://myblob.blob.core.windows.net/sourceContainer")
- .setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"))
- .setLanguage("en")
- .setStorageSource(StorageSource.AZURE_BLOB),
- Arrays
- .asList(
- new TargetInput(
- "https://myblob.blob.core.windows.net/destinationContainer1",
- "fr")
- .setCategory("general")
- .setGlossaries(Arrays.asList(new Glossary(
- "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
- "XLIFF")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageSource(StorageSource.AZURE_BLOB),
- new TargetInput(
- "https://myblob.blob.core.windows.net/destinationContainer2",
- "es")
- .setCategory("general")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageType(StorageInputType.FOLDER))));
+String sourceUrl = "https://myblob.blob.core.windows.net/sourceContainer";
+TranslationSource translationSource = new TranslationSource(sourceUrl);
+translationSource.setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"));
+translationSource.setLanguage("en");
+translationSource.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl1 = "https://myblob.blob.core.windows.net/destinationContainer1";
+TranslationTarget translationTarget1 = new TranslationTarget(targetUrl1, "fr");
+translationTarget1.setCategory("general");
+
+TranslationGlossary translationGlossary = new TranslationGlossary(
+ "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
+ "XLIFF");
+List translationGlossaries = new ArrayList<>();
+translationGlossaries.add(translationGlossary);
+translationTarget1.setGlossaries(translationGlossaries);
+translationTarget1.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl2 = "https://myblob.blob.core.windows.net/destinationContainer2";
+TranslationTarget translationTarget2 = new TranslationTarget(targetUrl2, "fr");
+translationTarget2.setCategory("general");
+translationTarget2.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+List translationTargets = new ArrayList<>();
+translationTargets.add(translationTarget1);
+translationTargets.add(translationTarget2);
+
+DocumentTranslationInput batchRequest = new DocumentTranslationInput(translationSource, translationTargets);
+batchRequest.setStorageType(StorageInputType.FOLDER);
+
+SyncPoller response = documentTranslationClient
+ .beginTranslation(TestHelper.getStartTranslationDetails(batchRequest));
String translationId = response.poll().getValue().getId();
// Add Status filter
-List succeededStatusList = Arrays.asList(Status.SUCCEEDED.toString());
+List succeededStatusList = Arrays.asList(TranslationStatus.SUCCEEDED.toString());
+
+ListDocumentStatusesOptions listDocumentStatusesOptions
+ = new ListDocumentStatusesOptions(translationId).setStatuses(succeededStatusList);
try {
- PagedIterable documentStatusResponse = documentTranslationClient
- .getDocumentsStatus(translationId, null, null, null, succeededStatusList, null, null, null);
- for (DocumentStatus documentStatus : documentStatusResponse) {
+ PagedIterable < DocumentStatusResult> documentStatusResponse = documentTranslationClient
+ .listDocumentStatuses(listDocumentStatusesOptions);
+ for (DocumentStatusResult documentStatus: documentStatusResponse) {
String id = documentStatus.getId();
System.out.println("Document Translation ID is: " + id);
String status = documentStatus.getStatus().toString();
@@ -336,45 +408,57 @@ Please refer to the service documentation for a conceptual discussion of [getDoc
Request the status for a specific document in a job.
```java GetDocumentStatus
-SyncPoller response = documentTranslationClient
- .beginStartTranslation(
- new StartTranslationDetails(Arrays.asList(new BatchRequest(
- new SourceInput("https://myblob.blob.core.windows.net/sourceContainer")
- .setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"))
- .setLanguage("en")
- .setStorageSource(StorageSource.AZURE_BLOB),
- Arrays
- .asList(
- new TargetInput(
- "https://myblob.blob.core.windows.net/destinationContainer1",
- "fr")
- .setCategory("general")
- .setGlossaries(Arrays.asList(new Glossary(
- "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
- "XLIFF")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageSource(StorageSource.AZURE_BLOB),
- new TargetInput(
- "https://myblob.blob.core.windows.net/destinationContainer2",
- "es")
- .setCategory("general")
- .setStorageSource(StorageSource.AZURE_BLOB)))
- .setStorageType(StorageInputType.FOLDER))));
+String sourceUrl = "https://myblob.blob.core.windows.net/sourceContainer";
+TranslationSource translationSource = new TranslationSource(sourceUrl);
+translationSource.setFilter(new DocumentFilter().setPrefix("pre").setSuffix(".txt"));
+translationSource.setLanguage("en");
+translationSource.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl1 = "https://myblob.blob.core.windows.net/destinationContainer1";
+TranslationTarget translationTarget1 = new TranslationTarget(targetUrl1, "fr");
+translationTarget1.setCategory("general");
+
+TranslationGlossary translationGlossary = new TranslationGlossary(
+ "https://myblob.blob.core.windows.net/myglossary/en_fr_glossary.xlf",
+ "XLIFF");
+List translationGlossaries = new ArrayList<>();
+translationGlossaries.add(translationGlossary);
+translationTarget1.setGlossaries(translationGlossaries);
+translationTarget1.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+String targetUrl2 = "https://myblob.blob.core.windows.net/destinationContainer2";
+TranslationTarget translationTarget2 = new TranslationTarget(targetUrl2, "fr");
+translationTarget2.setCategory("general");
+translationTarget2.setStorageSource(TranslationStorageSource.AZURE_BLOB);
+
+List translationTargets = new ArrayList<>();
+translationTargets.add(translationTarget1);
+translationTargets.add(translationTarget2);
+
+DocumentTranslationInput batchRequest = new DocumentTranslationInput(translationSource, translationTargets);
+batchRequest.setStorageType(StorageInputType.FOLDER);
+
+SyncPoller response = documentTranslationClient
+ .beginTranslation(TestHelper.getStartTranslationDetails(batchRequest));
String translationId = response.poll().getValue().getId();
// Add Status filter
-List succeededStatusList = Arrays.asList(Status.SUCCEEDED.toString());
+List succeededStatusList = Arrays.asList(TranslationStatus.SUCCEEDED.toString());
+ListDocumentStatusesOptions listDocumentStatusesOptions
+ = new ListDocumentStatusesOptions(translationId).setStatuses(succeededStatusList);
try {
- PagedIterable documentStatusResponse = documentTranslationClient
- .getDocumentsStatus(translationId, null, null, null, succeededStatusList, null, null, null);
- for (DocumentStatus documentsStatus : documentStatusResponse) {
+ PagedIterable documentStatusResponse = documentTranslationClient
+ .listDocumentStatuses(listDocumentStatusesOptions);
+ for (DocumentStatusResult documentsStatus: documentStatusResponse) {
String id = documentsStatus.getId();
System.out.println("Document Translation ID is: " + id);
- DocumentStatus documentStatus = documentTranslationClient.getDocumentStatus(translationId, id);
+ DocumentStatusResult documentStatus = documentTranslationClient
+ .getDocumentStatus(translationId, id);
System.out.println("Document ID is: " + documentStatus.getId());
System.out.println("Document Status is: " + documentStatus.getStatus().toString());
- System.out.println("Characters Charged is: " + documentStatus.getCharacterCharged().toString());
+ System.out.println("Characters Charged is: "
+ + documentStatus.getCharacterCharged().toString());
System.out.println("Document path is: " + documentStatus.getPath());
System.out.println("Document source path is: " + documentStatus.getSourcePath());
}
@@ -405,7 +489,7 @@ Samples are provided for each main functional area.
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-document_1.0.0-beta.2/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -418,7 +502,9 @@ For details on contributing to this repository, see the [contributing guide](htt
[docs]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/rest-api-guide
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-document_1.0.0-beta.2/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
+[sample_document_translation_client_with_apiKey]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/ReadmeSamples.java
+[sample_single_document_translation_client_with_apiKey]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/ReadmeSamples.java
[documentFormats_doc]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-supported-document-formats
[glossaryFormats]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-supported-glossary-formats
[batchTranslation_doc]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/start-batch-translation
@@ -428,15 +514,18 @@ For details on contributing to this repository, see the [contributing guide](htt
[getTranslationStatus_doc]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-translation-status
[getDocumentsStatus_doc]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-documents-status
[getDocumentStatus_doc]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/reference/get-document-status
-[document_translator_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/main/java/com/azure/ai/translation/document/DocumentTranslationClient.java
-[single_document_translator_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/main/java/com/azure/ai/translation/document/SingleDocumentTranslationClient.java
-[sample_batchDocumentTranslation]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/StartDocumentTranslation.java
-[sample_singleDocumentTranslation]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/StartSingleDocumentTranslation.java
-[sample_cancelTranslation]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/CancelDocumentTranslation.java
-[sample_getTranslationsStatus]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetTranslationsStatus.java
-[sample_getTranslationStatus]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetTranslationStatus.java
-[sample_getDocumentsStatus]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetDocumentsStatus.java
-[sample_getDocumentStatus]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetDocumentStatus.java
-[sample_getSupportedFormats]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-translation-document_1.0.0-beta.2/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetSupportedFormats.java
-
+[document_translator_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-document/src/main/java/com/azure/ai/translation/document/DocumentTranslationClient.java
+[single_document_translator_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-document/src/main/java/com/azure/ai/translation/document/SingleDocumentTranslationClient.java
+[sample_batchDocumentTranslation]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/StartDocumentTranslation.java
+[sample_singleDocumentTranslation]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/StartSingleDocumentTranslation.java
+[sample_cancelTranslation]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/CancelDocumentTranslation.java
+[sample_getTranslationsStatus]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetTranslationsStatus.java
+[sample_getTranslationStatus]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetTranslationStatus.java
+[sample_getDocumentsStatus]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetDocumentsStatus.java
+[sample_getDocumentStatus]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetDocumentStatus.java
+[sample_getSupportedFormats]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/translation/azure-ai-translation-document/src/samples/java/com/azure/ai/translation/document/GetSupportedFormats.java
+[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials
+[wiki_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity
+[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory
+[managed_identities_for_document_translation]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/how-to-guides/create-use-managed-identities
diff --git a/docs-ref-services/preview/ai-translation-text-readme.md b/docs-ref-services/preview/ai-translation-text-readme.md
index 8c11329617f8c..51c30fd22652d 100644
--- a/docs-ref-services/preview/ai-translation-text-readme.md
+++ b/docs-ref-services/preview/ai-translation-text-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Text Translation client library for Java
keywords: Azure, java, SDK, API, azure-ai-translation-text, translation
-ms.date: 04/19/2023
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: translation
---
-# Azure Text Translation client library for Java - version 1.0.0-beta.1
+# Azure Text Translation client library for Java - version 1.2.0-alpha.20250805.1
Text translation is a cloud-based REST API feature of the Translator service that uses neural machine translation technology to enable quick and accurate source-to-target text translation in real time across all supported languages.
@@ -45,7 +45,7 @@ Various documentation is available to help you get started
com.azureazure-ai-translation-text
- 1.0.0-beta.1
+ 1.2.0-beta.1
```
[//]: # ({x-version-update-end})
@@ -71,15 +71,16 @@ update the API key without creating a new client.
With the value of the endpoint, `AzureKeyCredential` and a `Region`, you can create the [TextTranslationClient][translator_client_class]:
-```Java
+```java createTextTranslationRestClient
String apiKey = System.getenv("TEXT_TRANSLATOR_API_KEY");
String region = System.getenv("TEXT_TRANSLATOR_API_REGION");
AzureKeyCredential credential = new AzureKeyCredential(apiKey);
TextTranslationClient client = new TextTranslationClientBuilder()
-.credential(credential)
-.region(region)
-.buildClient();
+ .credential(credential)
+ .region(region)
+ .endpoint("https://api.cognitive.microsofttranslator.com")
+ .buildClient();
```
## Key concepts
@@ -103,8 +104,8 @@ The following section provides several code snippets using the `client` [created
Gets the set of languages currently supported by other operations of the Translator.
-```Java
-GetLanguagesResult languages = client.getLanguages();
+```java getTextTranslationLanguages
+GetSupportedLanguagesResult languages = client.getSupportedLanguages();
System.out.println("Number of supported languages for translate operation: " + languages.getTranslation().size() + ".");
System.out.println("Number of supported languages for transliterate operation: " + languages.getTransliteration().size() + ".");
@@ -132,19 +133,15 @@ Please refer to the service documentation for a conceptual discussion of [langua
Renders single source-language text to multiple target-language texts with a single request.
-```Java
-String from = "en";
-List targetLanguages = new ArrayList<>();
-targetLanguages.add("cs");
-List content = new ArrayList<>();
-content.add(new InputTextItem("This is a test."));
+```java getTextTranslationMultiple
+TranslateOptions translateOptions = new TranslateOptions()
+ .setSourceLanguage("en")
+ .addTargetLanguage("es");
-List translations = client.translate(targetLanguages, content, null, from, TextType.PLAIN, null, ProfanityAction.NO_ACTION, ProfanityMarker.ASTERISK, false, false, null, null, null, false);
+TranslatedTextItem translation = client.translate("This is a test.", translateOptions);
-for (TranslatedTextItem translation : translations) {
- for (Translation textTranslation : translation.getTranslations()) {
- System.out.println("Text was translated to: '" + textTranslation.getTo() + "' and the result is: '" + textTranslation.getText() + "'.");
- }
+for (TranslationText textTranslation : translation.getTranslations()) {
+ System.out.println("Text was translated to: '" + textTranslation.getTargetLanguage() + "' and the result is: '" + textTranslation.getText() + "'.");
}
```
@@ -154,18 +151,15 @@ Please refer to the service documentation for a conceptual discussion of [transl
Converts characters or letters of a source language to the corresponding characters or letters of a target language.
-```Java
+```java getTextTranslationTransliterate
String language = "zh-Hans";
String fromScript = "Hans";
String toScript = "Latn";
-List content = new ArrayList<>();
-content.add(new InputTextItem("这是个测试。"));
+String content = "这是个测试。";
-List transliterations = client.transliterate(language, fromScript, toScript, content);
+TransliteratedText transliteration = client.transliterate(language, fromScript, toScript, content);
-for (TransliteratedText transliteration : transliterations) {
- System.out.println("Input text was transliterated to '" + transliteration.getScript() + "' script. Transliterated text: '" + transliteration.getText() + "'.");
-}
+System.out.println("Input text was transliterated to '" + transliteration.getScript() + "' script. Transliterated text: '" + transliteration.getText() + "'.");
```
Please refer to the service documentation for a conceptual discussion of [transliterate][transliterate_doc].
@@ -174,17 +168,14 @@ Please refer to the service documentation for a conceptual discussion of [transl
Identifies the positioning of sentence boundaries in a piece of text.
-```Java
+```java getTextTranslationSentenceBoundaries
String sourceLanguage = "zh-Hans";
String sourceScript = "Latn";
-List content = new ArrayList<>();
-content.add(new InputTextItem("zhè shì gè cè shì。"));
+String content = "zhè shì gè cè shì。";
-List breakSentences = client.findSentenceBoundaries(content, null, sourceLanguage, sourceScript);
+BreakSentenceItem breakSentence = client.findSentenceBoundaries(content, sourceLanguage, sourceScript);
-for (BreakSentenceItem breakSentence : breakSentences) {
- System.out.println("The detected sentence boundaries: " + breakSentence.getSentLen());
-}
+System.out.println("The detected sentence boundaries: " + breakSentence.getSentencesLengths());
```
Please refer to the service documentation for a conceptual discussion of [break sentence][breaksentence_doc].
@@ -193,18 +184,15 @@ Please refer to the service documentation for a conceptual discussion of [break
Returns equivalent words for the source term in the target language.
-```Java
+```java getTextTranslationDictionaryLookup
String sourceLanguage = "en";
String targetLanguage = "es";
-List content = new ArrayList<>();
-content.add(new InputTextItem("fly"));
+String content = "fly";
-List dictionaryEntries = client.lookupDictionaryEntries(sourceLanguage, targetLanguage, content);
+DictionaryLookupItem dictionaryEntry = client.lookupDictionaryEntries(sourceLanguage, targetLanguage, content);
-for (DictionaryLookupItem dictionaryEntry : dictionaryEntries) {
- System.out.println("For the given input " + dictionaryEntry.getTranslations().size() + " entries were found in the dictionary.");
- System.out.println("First entry: '" + dictionaryEntry.getTranslations().get(0).getDisplayTarget() + "', confidence: " + dictionaryEntry.getTranslations().get(0).getConfidence());
-}
+System.out.println("For the given input " + dictionaryEntry.getTranslations().size() + " entries were found in the dictionary.");
+System.out.println("First entry: '" + dictionaryEntry.getTranslations().get(0).getDisplayTarget() + "', confidence: " + dictionaryEntry.getTranslations().get(0).getConfidence());
```
Please refer to the service documentation for a conceptual discussion of [dictionary lookup][dictionarylookup_doc].
@@ -213,7 +201,7 @@ Please refer to the service documentation for a conceptual discussion of [dictio
Returns grammatical structure and context examples for the source term and target term pair.
-```Java
+```java getTextTranslationDictionaryExamples
String sourceLanguage = "en";
String targetLanguage = "es";
List content = new ArrayList<>();
@@ -262,7 +250,7 @@ Samples are provided for each main functional area, and for each area, samples a
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -273,11 +261,11 @@ For details on contributing to this repository, see the [contributing guide](htt
[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/translator/reference/v3-0-reference
[docs]: https://azure.github.io/azure-sdk-for-java/
-[jdk]: /java/azure/jdk/
+[jdk]: https://learn.microsoft.com/java/azure/jdk/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
-[azure_cli]: /cli/azure
+[azure_cli]: https://learn.microsoft.com/cli/azure
[azure_portal]: https://portal.azure.com
[translator_auth]: https://learn.microsoft.com/azure/cognitive-services/translator/reference/v3-0-reference#authentication
@@ -290,25 +278,25 @@ For details on contributing to this repository, see the [contributing guide](htt
[dictionarylookup_doc]: https://learn.microsoft.com/azure/cognitive-services/translator/reference/v3-0-dictionary-lookup
[dictionaryexamples_doc]: https://learn.microsoft.com/azure/cognitive-services/translator/reference/v3-0-dictionary-examples
-[sample_breaksentence]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/BreakSentence.java
-[sample_dictionaryexamples]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/DictionaryExamples.java
-[sample_dictionarylookup]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/DictionaryLookup.java
-[sample_getlanguages]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/GetLanguages.java
-[sample_getlanguagesaccept]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/GetLanguagesAcceptLanguage.java
-[sample_getlanguagesscope]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/GetLanguagesScope.java
-[sample_translate]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/Translate.java
-[sample_translatealignments]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateAlignments.java
-[sample_translatecustom]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateCustom.java
-[sample_translatedetection]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateDetection.java
-[sample_translatedictionary]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateDictionary.java
-[sample_translatesources]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateMultipleSources.java
-[sample_translatetargets]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateMultipleTargets.java
-[sample_translatenotranslate]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateNoTranslate.java
-[sample_translateprofanity]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateProfanity.java
-[sample_translatesentencelength]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateSentenceLength.java
-[sample_translatetexttypes]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateTextType.java
-[sample_translatetransliteration]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateWithTransliteration.java
-[sample_transliterate]: https://github.com/azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/Transliterate.java
-
-[translator_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-translation-text_1.0.0-beta.1/sdk/translation/azure-ai-translation-text/src/main/java/com/azure/ai/translation/text/TextTranslationClient.java
+[sample_breaksentence]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/BreakSentence.java
+[sample_dictionaryexamples]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/DictionaryExamples.java
+[sample_dictionarylookup]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/DictionaryLookup.java
+[sample_getlanguages]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/GetLanguages.java
+[sample_getlanguagesaccept]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/GetLanguagesAcceptLanguage.java
+[sample_getlanguagesscope]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/GetLanguagesScope.java
+[sample_translate]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/Translate.java
+[sample_translatealignments]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateAlignments.java
+[sample_translatecustom]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateCustom.java
+[sample_translatedetection]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateDetection.java
+[sample_translatedictionary]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateDictionary.java
+[sample_translatesources]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateMultipleSources.java
+[sample_translatetargets]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateMultipleTargets.java
+[sample_translatenotranslate]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateNoTranslate.java
+[sample_translateprofanity]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateProfanity.java
+[sample_translatesentencelength]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateSentenceLength.java
+[sample_translatetexttypes]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateTextType.java
+[sample_translatetransliteration]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/TranslateWithTransliteration.java
+[sample_transliterate]: https://github.com/azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/samples/java/com/azure/ai/translation/text/Transliterate.java
+
+[translator_client_class]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text/src/main/java/com/azure/ai/translation/text/TextTranslationClient.java
diff --git a/docs-ref-services/preview/ai-vision-imageanalysis-readme.md b/docs-ref-services/preview/ai-vision-imageanalysis-readme.md
index d8bb86d0b4ad3..cc03eec2e9a84 100644
--- a/docs-ref-services/preview/ai-vision-imageanalysis-readme.md
+++ b/docs-ref-services/preview/ai-vision-imageanalysis-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Image Analysis client library for Java
keywords: Azure, java, SDK, API, azure-ai-vision-imageanalysis, vision
-ms.date: 09/05/2024
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: vision
---
-# Azure Image Analysis client library for Java - version 1.0.0-beta.3
+# Azure Image Analysis client library for Java - version 1.1.0-alpha.20250805.1
The Image Analysis service provides AI algorithms for processing images and returning information about their content. In a single service call, you can extract one or more visual features from the image simultaneously, including getting a caption for the image, extracting text shown in the image (OCR) and detecting objects. For more information on the service and the supported visual features, see [Image Analysis overview][image_analysis_overview], and the [Concepts][image_analysis_concepts] page.
@@ -49,7 +49,7 @@ Also note that the client library does not directly read the `VISION_ENDPOINT` a
com.azureazure-ai-vision-imageanalysis
- 1.0.0-beta.3
+ 1.1.0-beta.1
```
[//]: # ({x-version-update-end})
@@ -96,14 +96,15 @@ ImageAnalysisAsyncClient client = new ImageAnalysisClientBuilder()
#### Using Entra ID
-Add an additional dependency on `azure-identity` in your `pom.xml`:
+To use the [DefaultAzureCredential](https://learn.microsoft.com/java/api/com.azure.identity.defaultazurecredential)
+provider, or other credential providers, add an additional dependency on `azure-identity` in your `pom.xml`:
[//]: # ({x-version-update-start;com.azure:azure-identity;dependency})
```xml
com.azureazure-identity
- 1.13.2
+ 1.15.3
```
[//]: # ({x-version-update-end})
@@ -350,7 +351,7 @@ Message: Status code 400, "{"error":{"code":"InvalidRequest","message":"Image fo
Reviewing the HTTP request sent or response received over the wire to the Image Analysis service can be useful in troubleshooting. This can be done in two ways:
1. The Image Analysis client library supports a built-in console logging framework for temporary debugging purposes. It also supports more advanced logging using the [SLF4J](https://www.slf4j.org/) interface. For detailed information see [Use logging in the Azure SDK for Java](https://learn.microsoft.com/azure/developer/java/sdk/troubleshooting-overview#use-logging-in-the-azure-sdk-for-java).
-1. By getting access to the [Response](https://learn.microsoft.com/java/api/com.azure.core.http.rest.response) object, and from it the [HttpRequest](https://learn.microsoft.com/java/api/com.azure.core.http.httprequest) object, and printing information provided by these objects. See [SampleCaptionImageFileWithResponse.java](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-vision-imageanalysis_1.0.0-beta.3/sdk/vision/azure-ai-vision-imageanalysis/src/samples/java/com/azure/ai/vision/imageanalysis/SampleCaptionImageFileWithResponse.java) and [SampleOcrImageUrlWithResponseAsync.java](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-vision-imageanalysis_1.0.0-beta.3/sdk/vision/azure-ai-vision-imageanalysis/src/samples/java/com/azure/ai/vision/imageanalysis/SampleOcrImageUrlWithResponseAsync.java).
+1. By getting access to the [Response](https://learn.microsoft.com/java/api/com.azure.core.http.rest.response) object, and from it the [HttpRequest](https://learn.microsoft.com/java/api/com.azure.core.http.httprequest) object, and printing information provided by these objects. See [SampleCaptionImageFileWithResponse.java](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/vision/azure-ai-vision-imageanalysis/src/samples/java/com/azure/ai/vision/imageanalysis/SampleCaptionImageFileWithResponse.java) and [SampleOcrImageUrlWithResponseAsync.java](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/vision/azure-ai-vision-imageanalysis/src/samples/java/com/azure/ai/vision/imageanalysis/SampleOcrImageUrlWithResponseAsync.java).
We recommend you enable console logging (option #1). The sections below discusses enabling console logging using the built-in framework.
@@ -433,6 +434,6 @@ additional questions or comments.
[image_analysis_concepts]: https://learn.microsoft.com/azure/ai-services/computer-vision/concept-tag-images-40
[vision_studio]: https://aka.ms/vision-studio/image-analysis
[samples]: https://aka.ms/azsdk/image-analysis/samples/java
-[sdk_source_code]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-vision-imageanalysis_1.0.0-beta.3/sdk/vision/azure-ai-vision-imageanalysis/src/main/java/com/azure/ai/vision/imageanalysis
+[sdk_source_code]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/vision/azure-ai-vision-imageanalysis/src/main/java/com/azure/ai/vision/imageanalysis
[supported_regions]: https://learn.microsoft.com/azure/ai-services/computer-vision/concept-describe-images-40
diff --git a/docs-ref-services/preview/alerts-management.md b/docs-ref-services/preview/alerts-management.md
index 3db699dec92e8..29841ab599131 100644
--- a/docs-ref-services/preview/alerts-management.md
+++ b/docs-ref-services/preview/alerts-management.md
@@ -1,7 +1,7 @@
---
title: Azure Alerts Management SDK for Java
description: Reference for Azure Alerts Management SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: alertsmanagement
diff --git a/docs-ref-services/preview/analytics-defender-easm-readme.md b/docs-ref-services/preview/analytics-defender-easm-readme.md
index af00e938abc0c..b33cf0efec604 100644
--- a/docs-ref-services/preview/analytics-defender-easm-readme.md
+++ b/docs-ref-services/preview/analytics-defender-easm-readme.md
@@ -1,12 +1,12 @@
---
title: Azure EASM client library for Java
keywords: Azure, java, SDK, API, azure-analytics-defender-easm, easm
-ms.date: 11/07/2023
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: easm
---
-# Azure EASM client library for Java - version 1.0.0-beta.1
+# Azure EASM client library for Java - version 1.0.0-alpha.20250805.1
*Microsoft Defender External Attack Surface Management (Defender EASM)* continuously discovers and maps your digital attack surface to provide an external view of your online infrastructure. This visibility enables security and IT teams to identify unknowns, prioritize risk, eliminate threats, and extend vulnerability and exposure control beyond the firewall. Defender EASM leverages Microsoft’s crawling technology to discover assets that are related to your known online infrastructure, and actively scans these assets to discover new connections over time. Attack Surface Insights are generated by leveraging vulnerability and infrastructure data to showcase the key areas of concern for your organization.
@@ -34,7 +34,7 @@ Various documentation is available to help you get started
com.azureazure-analytics-defender-easm
- 1.0.0-beta.1
+ 1.0.0-beta.2
```
[//]: # ({x-version-update-end})
@@ -66,16 +66,10 @@ Custom discoveries are organized into Discovery Groups. They are independent see
## Examples
```java readme-sample-createDefenderEasmClient
-String subscriptionId = Configuration.getGlobalConfiguration().get("SUBSCRIPTION_ID");
-String workspaceName = Configuration.getGlobalConfiguration().get("WORKSPACENAME");
-String resourceGroupName = Configuration.getGlobalConfiguration().get("RESOURCEGROUPNAME");
String endpoint = Configuration.getGlobalConfiguration().get("ENDPOINT");
EasmClient easmClient = new EasmClientBuilder()
.endpoint(endpoint)
- .subscriptionId(subscriptionId)
- .workspaceName(workspaceName)
- .resourceGroupName(resourceGroupName)
.credential(new DefaultAzureCredentialBuilder().build())
.buildClient();
```
@@ -96,10 +90,10 @@ locate the root issue. View the [logging][logging] wiki for guidance about enabl
These code samples show common scenario operations with the Azure Anomaly Detector library. More samples can be found under the [samples][samples] directory.
For more extensive documentation on Microsoft Defender External Attack Surface Management, see the [Defender EASM][product_documentation]: https://azure.microsoft.com/services/
-on docs.microsoft.com.
+on learn.microsoft.com.
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-defender-easm_1.0.0-beta.1/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -110,15 +104,15 @@ For details on contributing to this repository, see the [contributing guide](htt
[product_documentation]: https://learn.microsoft.com/azure/external-attack-surface-management/
[docs]: https://azure.github.io/azure-sdk-for-java/
-[jdk]: /java/azure/jdk/
+[jdk]: https://learn.microsoft.com/java/azure/jdk/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-defender-easm_1.0.0-beta.1/sdk/identity/azure-identity
-[discovery_runs_sample]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-defender-easm_1.0.0-beta.1/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/DiscoveryRunsSample.java
-[disco_template_sample]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-defender-easm_1.0.0-beta.1/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/DiscoTemplateSample.java
-[saved_filter_sample]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-defender-easm_1.0.0-beta.1/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/SavedFilterSample.java
-[external_ids_sample]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-defender-easm_1.0.0-beta.1/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/ManagingExternalIdsSample.java
-[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK
-[samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-analytics-defender-easm_1.0.0-beta.1/samples
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
+[discovery_runs_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/DiscoveryRunsSample.java
+[disco_template_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/DiscoTemplateSample.java
+[saved_filter_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/SavedFilterSample.java
+[external_ids_sample]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/easm/azure-analytics-defender-easm/src/samples/java/com/azure/analytics/defender/easm/ManagingExternalIdsSample.java
+[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK
+[samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/samples
[assets_documentation]: https://learn.microsoft.com/azure/external-attack-surface-management/understanding-inventory-assets
[discovery_documentation]: https://learn.microsoft.com/azure/external-attack-surface-management/what-is-discovery
[discovery_groups_documentation]: https://learn.microsoft.com/azure/external-attack-surface-management/using-and-managing-discovery#discovery-groups
diff --git a/docs-ref-services/preview/analytics-onlineexperimentation-readme.md b/docs-ref-services/preview/analytics-onlineexperimentation-readme.md
index 8608d5f8b0010..aca7d133fce9b 100644
--- a/docs-ref-services/preview/analytics-onlineexperimentation-readme.md
+++ b/docs-ref-services/preview/analytics-onlineexperimentation-readme.md
@@ -1,12 +1,12 @@
---
title: Azure OnlineExperimentation client library for Java
keywords: Azure, java, SDK, API, azure-analytics-onlineexperimentation, onlineexperimentation/azure-analytics-onlineexperimentation
-ms.date: 06/11/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: onlineexperimentation/azure-analytics-onlineexperimentation
---
-# Azure OnlineExperimentation client library for Java - version 1.0.0-beta.1
+# Azure OnlineExperimentation client library for Java - version 1.0.0-alpha.20250805.1
Azure OnlineExperimentation client library for Java.
@@ -159,7 +159,7 @@ See the [samples][azure_exp_samples] page for common ways to setup metrics for e
## Contributing
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-onlineexperimentation_1.0.0-beta.1/CONTRIBUTING.md).
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
1. Fork it
1. Create your feature branch (`git checkout -b my-new-feature`)
@@ -172,10 +172,10 @@ For details on contributing to this repository, see the [contributing guide](htt
[docs]: https://azure.github.io/azure-sdk-for-java/
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/
[azure_subscription]: https://azure.microsoft.com/free/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-onlineexperimentation_1.0.0-beta.1/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity
[app_config]: https://learn.microsoft.com/azure/azure-app-configuration/overview
[azure_monitor]: https://learn.microsoft.com/azure/azure-monitor/overview
-[azure_exp_samples]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-onlineexperimentation_1.0.0-beta.1/sdk/onlineexperimentation/azure-resourcemanager-onlineexperimentation/SAMPLE.md
+[azure_exp_samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/onlineexperimentation/azure-resourcemanager-onlineexperimentation/SAMPLE.md
[az_exp_workspace]: https://learn.microsoft.com/azure/templates/microsoft.onlineexperimentation/workspaces
[http_clients_wiki]: https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients
[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK
diff --git a/docs-ref-services/preview/analytics-synapse-accesscontrol-readme.md b/docs-ref-services/preview/analytics-synapse-accesscontrol-readme.md
index 2e0f584bb7078..94bb5884fda14 100644
--- a/docs-ref-services/preview/analytics-synapse-accesscontrol-readme.md
+++ b/docs-ref-services/preview/analytics-synapse-accesscontrol-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Synapse Access Control client library for Java
-keywords: Azure, java, SDK, API, azure-analytics-synapse-accesscontrol, synapseanalytics
-ms.date: 08/11/2021
+keywords: Azure, java, SDK, API, azure-analytics-synapse-accesscontrol, synapse-analytics
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: synapseanalytics
+ms.service: synapse-analytics
---
-# Azure Synapse Access Control client library for Java - version 1.0.0-beta.4
+# Azure Synapse Access Control client library for Java - version 1.0.0-alpha.20250805.1
Azure Synapse is a limitless analytics service that brings together enterprise data warehousing and Big Data analytics. It gives you the freedom to query data on your terms, using either serverless on-demand or provisioned resources—at scale. Azure Synapse brings these two worlds together with a unified experience to ingest, prepare, manage, and serve data for immediate BI and machine learning needs.
@@ -23,13 +23,13 @@ Maven dependency for the Azure Synapse Access Control client library. Add it to
com.azureazure-analytics-synapse-accesscontrol
- 1.0.0-beta.4
+ 1.0.0-beta.5
```
[//]: # ({x-version-update-end})
### Prerequisites
-- Java Development Kit (JDK) with version 8 or above
+- [Java Development Kit (JDK)][jdk] with version 8 or above
- An [Azure subscription][azure_sub].
- An existing Azure Synapse workspace. If you need to create an Azure Synapse workspace, you can use the Azure Portal or [Azure CLI][azure_cli].
```Bash
@@ -82,7 +82,7 @@ Here is an [Azure Cloud Shell](https://shell.azure.com/bash) snippet below to
## Troubleshooting
### Default HTTP client
-All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients).
+All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL operations. The Boring SSL library is an Uber JAR containing native libraries for Linux / macOS / Windows, and provides better performance compared to the default SSL implementation within the JDK. For more information, including how to reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
@@ -102,17 +102,20 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the Code of Conduct FAQ or contact with any additional questions or comments.
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-accesscontrol_1.0.0-beta.4/sdk/synapse/azure-analytics-synapse-accesscontrol/src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-accesscontrol/src
[api_documentation]: https://azure.github.io/azure-sdk-for-java
-[azsynapse_docs]: https://docs.microsoft.com/azure/synapse-analytics/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-analytics-synapse-accesscontrol_1.0.0-beta.4/sdk/identity/azure-identity
+[azsynapse_docs]: https://learn.microsoft.com/azure/synapse-analytics/
+[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/?view=azure-java-stable
+[azure_sub]: https://azure.microsoft.com/free/
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/
-[azure_synapse]: https://docs.microsoft.com/en-us/azure/synapse-analytics/quickstart-create-workspace
-[azure_cli]: https://docs.microsoft.com/cli/azure
-[rest_api]: https://docs.microsoft.com/rest/api/synapse/
-[azsynapse_rest]: https://docs.microsoft.com/rest/api/synapse/
-[azure_create_application_in_portal]: https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
-[azure_synapse_cli_full]: https://docs.microsoft.com/cli/azure/synapse?view=azure-cli-latest
+[azure_synapse]: https://learn.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
+[azure_cli]: https://learn.microsoft.com/cli/azure
+[rest_api]: https://learn.microsoft.com/rest/api/synapse/
+[azsynapse_rest]: https://learn.microsoft.com/rest/api/synapse/
+[azure_create_application_in_portal]: https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
+[azure_synapse_cli_full]: https://learn.microsoft.com/cli/azure/synapse?view=azure-cli-latest
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
+
diff --git a/docs-ref-services/preview/analytics-synapse-artifacts-readme.md b/docs-ref-services/preview/analytics-synapse-artifacts-readme.md
index f0fc481ffb634..f19a9b261c9d0 100644
--- a/docs-ref-services/preview/analytics-synapse-artifacts-readme.md
+++ b/docs-ref-services/preview/analytics-synapse-artifacts-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Synapse Artifacts client library for Java
keywords: Azure, java, SDK, API, azure-analytics-synapse-artifacts, synapse-analytics
-ms.date: 03/10/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: synapse-analytics
---
-# Azure Synapse Artifacts client library for Java - version 1.0.0-beta.16
+# Azure Synapse Artifacts client library for Java - version 1.0.0-alpha.20250805.1
Azure Synapse is a limitless analytics service that brings together enterprise data warehousing and Big Data analytics. It gives you the freedom to query data on your terms, using either serverless on-demand or provisioned resources—at scale. Azure Synapse brings these two worlds together with a unified experience to ingest, prepare, manage, and serve data for immediate BI and machine learning needs.
@@ -23,7 +23,7 @@ Maven dependency for the Azure Synapse Artifacts client library. Add it to your
com.azureazure-analytics-synapse-artifacts
- 1.0.0-beta.16
+ 1.0.0-beta.17
```
[//]: # ({x-version-update-end})
@@ -222,10 +222,10 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the Code of Conduct FAQ or contact with any additional questions or comments.
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-artifacts_1.0.0-beta.16/sdk/synapse/azure-analytics-synapse-artifacts/src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-artifacts/src
[api_documentation]: https://azure.github.io/azure-sdk-for-java
[azsynapse_docs]: https://learn.microsoft.com/azure/synapse-analytics/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-analytics-synapse-artifacts_1.0.0-beta.16/sdk/identity/azure-identity
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/
[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/?view=azure-java-stable
@@ -236,7 +236,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
[azsynapse_rest]: https://learn.microsoft.com/rest/api/synapse/
[azure_create_application_in_portal]: https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
[azure_synapse_cli_full]: https://learn.microsoft.com/cli/azure/synapse?view=azure-cli-latest
-[artifacts_samples]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-artifacts_1.0.0-beta.16/sdk/synapse/azure-analytics-synapse-artifacts/src/samples/java/com/azure/analytics/synapse/artifacts
+[artifacts_samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-artifacts/src/samples/java/com/azure/analytics/synapse/artifacts
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
diff --git a/docs-ref-services/preview/analytics-synapse-managedprivateendpoints-readme.md b/docs-ref-services/preview/analytics-synapse-managedprivateendpoints-readme.md
index 79eb6a0765f5d..48604fd1907ba 100644
--- a/docs-ref-services/preview/analytics-synapse-managedprivateendpoints-readme.md
+++ b/docs-ref-services/preview/analytics-synapse-managedprivateendpoints-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Synapse Managed Private Endpoints client library for Java
-keywords: Azure, java, SDK, API, azure-analytics-synapse-managedprivateendpoints, synapseanalytics
-ms.date: 09/08/2021
+keywords: Azure, java, SDK, API, azure-analytics-synapse-managedprivateendpoints, synapse-analytics
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: synapseanalytics
+ms.service: synapse-analytics
---
-# Azure Synapse Managed Private Endpoints client library for Java - version 1.0.0-beta.5
+# Azure Synapse Managed Private Endpoints client library for Java - version 1.0.0-alpha.20250805.1
Azure Synapse is a limitless analytics service that brings together enterprise data warehousing and Big Data analytics. It gives you the freedom to query data on your terms, using either serverless on-demand or provisioned resources—at scale. Azure Synapse brings these two worlds together with a unified experience to ingest, prepare, manage, and serve data for immediate BI and machine learning needs.
@@ -23,13 +23,13 @@ Maven dependency for the Azure Synapse managed private endpoints client library.
com.azureazure-analytics-synapse-managedprivateendpoints
- 1.0.0-beta.5
+ 1.0.0-beta.6
```
[//]: # ({x-version-update-end})
### Prerequisites
-- Java Development Kit (JDK) with version 8 or above
+- [Java Development Kit (JDK)][jdk] with version 8 or above
- An [Azure subscription][azure_sub].
- An existing Azure Synapse workspace. If you need to create an Azure Synapse workspace, you can use the Azure Portal or [Azure CLI][azure_cli].
```Bash
@@ -82,7 +82,7 @@ Here is an [Azure Cloud Shell](https://shell.azure.com/bash) snippet below to
## Troubleshooting
### Default HTTP client
-All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients).
+All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL operations. The Boring SSL library is an Uber JAR containing native libraries for Linux / macOS / Windows, and provides better performance compared to the default SSL implementation within the JDK. For more information, including how to reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
@@ -102,17 +102,20 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the Code of Conduct FAQ or contact with any additional questions or comments.
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-managedprivateendpoints_1.0.0-beta.5/sdk/synapse/azure-analytics-synapse-accesscontrol/src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-accesscontrol/src
[api_documentation]: https://azure.github.io/azure-sdk-for-java
-[azsynapse_docs]: https://docs.microsoft.com/azure/synapse-analytics/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-analytics-synapse-managedprivateendpoints_1.0.0-beta.5/sdk/identity/azure-identity
+[azsynapse_docs]: https://learn.microsoft.com/azure/synapse-analytics/
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/
-[azure_synapse]: https://docs.microsoft.com/en-us/azure/synapse-analytics/quickstart-create-workspace
-[azure_cli]: https://docs.microsoft.com/cli/azure
-[rest_api]: https://docs.microsoft.com/rest/api/synapse/
-[azsynapse_rest]: https://docs.microsoft.com/rest/api/synapse/
-[azure_create_application_in_portal]: https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
-[azure_synapse_cli_full]: https://docs.microsoft.com/cli/azure/synapse?view=azure-cli-latest
+[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/?view=azure-java-stable
+[azure_sub]: https://azure.microsoft.com/free/
+[azure_synapse]: https://learn.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
+[azure_cli]: https://learn.microsoft.com/cli/azure
+[rest_api]: https://learn.microsoft.com/rest/api/synapse/
+[azsynapse_rest]: https://learn.microsoft.com/rest/api/synapse/
+[azure_create_application_in_portal]: https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
+[azure_synapse_cli_full]: https://learn.microsoft.com/cli/azure/synapse?view=azure-cli-latest
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
+
diff --git a/docs-ref-services/preview/analytics-synapse-monitoring-readme.md b/docs-ref-services/preview/analytics-synapse-monitoring-readme.md
index 3f1f7beee0568..60a1c30701119 100644
--- a/docs-ref-services/preview/analytics-synapse-monitoring-readme.md
+++ b/docs-ref-services/preview/analytics-synapse-monitoring-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Synapse Monitoring client library for Java
-keywords: Azure, java, SDK, API, azure-analytics-synapse-monitoring, synapseanalytics
-ms.date: 04/07/2021
+keywords: Azure, java, SDK, API, azure-analytics-synapse-monitoring, synapse-analytics
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: synapseanalytics
+ms.service: synapse-analytics
---
-# Azure Synapse Monitoring client library for Java - version 1.0.0-beta.3
+# Azure Synapse Monitoring client library for Java - version 1.0.0-alpha.20250805.1
Azure Synapse is a limitless analytics service that brings together enterprise data warehousing and Big Data analytics. It gives you the freedom to query data on your terms, using either serverless on-demand or provisioned resources—at scale. Azure Synapse brings these two worlds together with a unified experience to ingest, prepare, manage, and serve data for immediate BI and machine learning needs.
@@ -23,13 +23,13 @@ Maven dependency for the Azure Synapse monitoring client library. Add it to your
com.azureazure-analytics-synapse-monitoring
- 1.0.0-beta.3
+ 1.0.0-beta.5
```
[//]: # ({x-version-update-end})
### Prerequisites
-- Java Development Kit (JDK) with version 8 or above
+- [Java Development Kit (JDK)][jdk] with version 8 or above
- An [Azure subscription][azure_sub].
- An existing Azure Synapse workspace. If you need to create an Azure Synapse workspace, you can use the Azure Portal or [Azure CLI][azure_cli].
```Bash
@@ -82,7 +82,7 @@ Here is an [Azure Cloud Shell](https://shell.azure.com/bash) snippet below to
## Troubleshooting
### Default HTTP client
-All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients).
+All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL operations. The Boring SSL library is an Uber JAR containing native libraries for Linux / macOS / Windows, and provides better performance compared to the default SSL implementation within the JDK. For more information, including how to reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
@@ -102,17 +102,20 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the Code of Conduct FAQ or contact with any additional questions or comments.
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-monitoring_1.0.0-beta.3/sdk/synapse/azure-analytics-synapse-accesscontrol/src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-accesscontrol/src
[api_documentation]: https://azure.github.io/azure-sdk-for-java
-[azsynapse_docs]: https://docs.microsoft.com/azure/synapse-analytics/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-analytics-synapse-monitoring_1.0.0-beta.3/sdk/identity/azure-identity
+[azsynapse_docs]: https://learn.microsoft.com/azure/synapse-analytics/
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/
-[azure_synapse]: https://docs.microsoft.com/en-us/azure/synapse-analytics/quickstart-create-workspace
-[azure_cli]: https://docs.microsoft.com/cli/azure
-[rest_api]: https://docs.microsoft.com/rest/api/synapse/
-[azsynapse_rest]: https://docs.microsoft.com/rest/api/synapse/
-[azure_create_application_in_portal]: https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
-[azure_synapse_cli_full]: https://docs.microsoft.com/cli/azure/synapse?view=azure-cli-latest
+[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/?view=azure-java-stable
+[azure_sub]: https://azure.microsoft.com/free/
+[azure_synapse]: https://learn.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
+[azure_cli]: https://learn.microsoft.com/cli/azure
+[rest_api]: https://learn.microsoft.com/rest/api/synapse/
+[azsynapse_rest]: https://learn.microsoft.com/rest/api/synapse/
+[azure_create_application_in_portal]: https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
+[azure_synapse_cli_full]: https://learn.microsoft.com/cli/azure/synapse?view=azure-cli-latest
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
+
diff --git a/docs-ref-services/preview/analytics-synapse-spark-readme.md b/docs-ref-services/preview/analytics-synapse-spark-readme.md
index be4a5096a7897..2373c0b504108 100644
--- a/docs-ref-services/preview/analytics-synapse-spark-readme.md
+++ b/docs-ref-services/preview/analytics-synapse-spark-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Synapse Spark client library for Java
-keywords: Azure, java, SDK, API, azure-analytics-synapse-spark, synapseanalytics
-ms.date: 10/15/2021
+keywords: Azure, java, SDK, API, azure-analytics-synapse-spark, synapse-analytics
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: synapseanalytics
+ms.service: synapse-analytics
---
-# Azure Synapse Spark client library for Java - version 1.0.0-beta.5
+# Azure Synapse Spark client library for Java - version 1.0.0-alpha.20250805.1
Azure Synapse is a limitless analytics service that brings together enterprise data warehousing and Big Data analytics. It gives you the freedom to query data on your terms, using either serverless on-demand or provisioned resources—at scale. Azure Synapse brings these two worlds together with a unified experience to ingest, prepare, manage, and serve data for immediate BI and machine learning needs.
@@ -23,7 +23,7 @@ Maven dependency for the Azure Synapse Spark client library. Add it to your proj
com.azureazure-analytics-synapse-spark
- 1.0.0-beta.4
+ 1.0.0-beta.6
```
[//]: # ({x-version-update-end})
@@ -103,7 +103,7 @@ The following sections provide several code snippets covering some of the most c
### Spark batch job examples
* [Create a Spark batch job](#create-a-spark-batch-job)
* [List role Spark batch jobs](#list-spark-batch-jobs)
-* [Cancel a Spark batch job](#delete-a-spark-batch-job)
+* [Cancel a Spark batch job](#cancel-a-spark-batch-job)
### Create a Spark batch job
@@ -148,10 +148,9 @@ batchClient.cancelSparkBatchJob(jobId);
### Async API
The following sections provide several code snippets covering some of the most common asynchronous Azure Synapse Spark service tasks, including:
-* [Create a Spark job asynchronously](#create-a-spark-batch-job-asynchronously)
-* [Retrieve a Spark job asynchronously](#retrieve-a-spark-batch-job-asynchronously)
+* [Create a Spark job asynchronously](#create-a-spark-job-asynchronously)
* [List Spark jobs asynchronously](#list-spark-batch-jobs-asynchronously)
-* [Delete a Spark job asynchronously](#delete-a-spark-batch-job-asynchronously)
+* [Cancel a Spark batch job asynchronously](#cancel-a-spark-batch-job-asynchronously)
> Note : You should add `System.in.read()` or `Thread.sleep()` after the function calls in the main class/thread to allow async functions/operations to execute and finish before the main application/thread exits.
@@ -203,7 +202,7 @@ batchClient.cancelSparkBatchJob(jobId);
## Troubleshooting
### Default HTTP client
-All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients).
+All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the [HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL operations. The Boring SSL library is an Uber JAR containing native libraries for Linux / macOS / Windows, and provides better performance compared to the default SSL implementation within the JDK. For more information, including how to reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
@@ -223,21 +222,23 @@ When you submit a pull request, a CLA-bot will automatically determine whether y
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the Code of Conduct FAQ or contact with any additional questions or comments.
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-spark_1.0.0-beta.5/sdk/synapse/azure-analytics-synapse-spark/src
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-spark/src
[api_documentation]: https://azure.github.io/azure-sdk-for-java
-[azsynapse_docs]: https://docs.microsoft.com/azure/synapse-analytics/
-[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-analytics-synapse-spark_1.0.0-beta.5/sdk/identity/azure-identity
+[azsynapse_docs]: https://learn.microsoft.com/azure/synapse-analytics/
+[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/
-[azure_synapse]: https://docs.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
-[azure_cli]: https://docs.microsoft.com/azure/synapse-analytics/quickstart-create-workspace-cli
-[rest_api]: https://docs.microsoft.com/rest/api/synapse/
-[azsynapse_rest]: https://docs.microsoft.com/rest/api/synapse/
-[azure_create_application_in_portal]: https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
-[azure_synapse_cli_full]: https://docs.microsoft.com/cli/azure/synapse?view=azure-cli-latest
-[spark_samples]: https://github.com/Azure/azure-sdk-for-java/blob/azure-analytics-synapse-spark_1.0.0-beta.5/sdk/synapse/azure-analytics-synapse-spark/src/samples/java/com/azure/analytics/synapse/spark
+[azure_synapse]: https://learn.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
+[azure_cli]: https://learn.microsoft.com/cli/azure
+[jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/?view=azure-java-stable
+[azure_sub]: https://azure.microsoft.com/free/
+[rest_api]: https://learn.microsoft.com/rest/api/synapse/
+[azsynapse_rest]: https://learn.microsoft.com/rest/api/synapse/
+[azure_create_application_in_portal]: https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
+[azure_synapse_cli_full]: https://learn.microsoft.com/cli/azure/synapse?view=azure-cli-latest
+[spark_samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/synapse/azure-analytics-synapse-spark/src/samples/java/com/azure/analytics/synapse/spark
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning
-[jdk]: https://docs.microsoft.com/java/azure/jdk/
+[jdk]: https://learn.microsoft.com/java/azure/jdk/
[azure_sub]: https://azure.microsoft.com/free/
-[azure_portal]: https://docs.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
+[azure_portal]: https://learn.microsoft.com/azure/synapse-analytics/quickstart-create-workspace
diff --git a/docs-ref-services/preview/api-center.md b/docs-ref-services/preview/api-center.md
index 80f1a13cd5511..d51319caadcc3 100644
--- a/docs-ref-services/preview/api-center.md
+++ b/docs-ref-services/preview/api-center.md
@@ -1,7 +1,7 @@
---
title: Azure API Center SDK for Java
description: Reference for Azure API Center SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: apicenter
diff --git a/docs-ref-services/preview/api-management.md b/docs-ref-services/preview/api-management.md
index 01d9f43b072ec..965bbc19e76c0 100644
--- a/docs-ref-services/preview/api-management.md
+++ b/docs-ref-services/preview/api-management.md
@@ -1,7 +1,7 @@
---
title: Azure API Management SDK for Java
description: Reference for Azure API Management SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: apimanagement
diff --git a/docs-ref-services/preview/app-compliance-automation.md b/docs-ref-services/preview/app-compliance-automation.md
index 1f50ffda64b6d..6748179e2d37f 100644
--- a/docs-ref-services/preview/app-compliance-automation.md
+++ b/docs-ref-services/preview/app-compliance-automation.md
@@ -1,7 +1,7 @@
---
title: Azure App Compliance Automation SDK for Java
description: Reference for Azure App Compliance Automation SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: appcomplianceautomation
diff --git a/docs-ref-services/preview/app-configuration.md b/docs-ref-services/preview/app-configuration.md
index be0efb7496308..90e6613cc7aff 100644
--- a/docs-ref-services/preview/app-configuration.md
+++ b/docs-ref-services/preview/app-configuration.md
@@ -1,7 +1,7 @@
---
title: Azure App Configuration SDK for Java
description: Reference for Azure App Configuration SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: appconfiguration
diff --git a/docs-ref-services/preview/application-insights.md b/docs-ref-services/preview/application-insights.md
index b81b7a51ffea1..29a4c186cbc48 100644
--- a/docs-ref-services/preview/application-insights.md
+++ b/docs-ref-services/preview/application-insights.md
@@ -1,7 +1,7 @@
---
title: Azure Application Insights SDK for Java
description: Reference for Azure Application Insights SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/preview/arc-data.md b/docs-ref-services/preview/arc-data.md
index f55bb26fd2022..b2bfe81c30053 100644
--- a/docs-ref-services/preview/arc-data.md
+++ b/docs-ref-services/preview/arc-data.md
@@ -1,7 +1,7 @@
---
title: Azure Arc Data SDK for Java
description: Reference for Azure Arc Data SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/preview/arize-ai.md b/docs-ref-services/preview/arize-ai.md
index 3a6e57869b175..44721ae7d1434 100644
--- a/docs-ref-services/preview/arize-ai.md
+++ b/docs-ref-services/preview/arize-ai.md
@@ -1,7 +1,7 @@
---
title: Azure Arize AI SDK for Java
description: Reference for Azure Arize AI SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: arizeai
diff --git a/docs-ref-services/preview/astro.md b/docs-ref-services/preview/astro.md
index e2f4540d3e505..c6ecfdab5bb64 100644
--- a/docs-ref-services/preview/astro.md
+++ b/docs-ref-services/preview/astro.md
@@ -1,7 +1,7 @@
---
title: Azure Astro SDK for Java
description: Reference for Azure Astro SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: astro
diff --git a/docs-ref-services/preview/attestation-index.md b/docs-ref-services/preview/attestation-index.md
index bd70092ecc1d3..8bcfac306953a 100644
--- a/docs-ref-services/preview/attestation-index.md
+++ b/docs-ref-services/preview/attestation-index.md
@@ -1,3 +1,4 @@
| Reference | Package | Source |
|---|---|---|
+|[Attestation](security-attestation-readme.md)|[azure-security-attestation](https://repo1.maven.org/maven2/com/azure/azure-security-attestation)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/attestation/azure-security-attestation)|
|[Resource Management - Attestation](resourcemanager-attestation-readme.md)|[azure-resourcemanager-attestation](https://repo1.maven.org/maven2/com/azure/resourcemanager/azure-resourcemanager-attestation)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/attestation/azure-resourcemanager-attestation)|
diff --git a/docs-ref-services/preview/attestation.md b/docs-ref-services/preview/attestation.md
index 5f391fb612d85..55e0b66ae9cf8 100644
--- a/docs-ref-services/preview/attestation.md
+++ b/docs-ref-services/preview/attestation.md
@@ -1,7 +1,7 @@
---
title: Azure Attestation SDK for Java
description: Reference for Azure Attestation SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/preview/automanage.md b/docs-ref-services/preview/automanage.md
index 1067a80734747..a327519e18086 100644
--- a/docs-ref-services/preview/automanage.md
+++ b/docs-ref-services/preview/automanage.md
@@ -1,7 +1,7 @@
---
title: Azure Automanage SDK for Java
description: Reference for Azure Automanage SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: automanage
diff --git a/docs-ref-services/preview/automation.md b/docs-ref-services/preview/automation.md
index 20b1b88336809..09bdd01888f57 100644
--- a/docs-ref-services/preview/automation.md
+++ b/docs-ref-services/preview/automation.md
@@ -1,7 +1,7 @@
---
title: Azure Automation SDK for Java
description: Reference for Azure Automation SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/preview/azure-analytics.md b/docs-ref-services/preview/azure-analytics.md
index 803311bf625aa..50405982f7724 100644
--- a/docs-ref-services/preview/azure-analytics.md
+++ b/docs-ref-services/preview/azure-analytics.md
@@ -1,7 +1,7 @@
---
title: Azure Azure Analytics SDK for Java
description: Reference for Azure Azure Analytics SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azureanalytics
diff --git a/docs-ref-services/preview/azure-stack-hci.md b/docs-ref-services/preview/azure-stack-hci.md
index 95ef25200991c..50068401bb844 100644
--- a/docs-ref-services/preview/azure-stack-hci.md
+++ b/docs-ref-services/preview/azure-stack-hci.md
@@ -1,7 +1,7 @@
---
title: Azure Azure Stack HCI SDK for Java
description: Reference for Azure Azure Stack HCI SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/preview/azure-stack.md b/docs-ref-services/preview/azure-stack.md
index 1559448d86eb0..a5681f37dfb2e 100644
--- a/docs-ref-services/preview/azure-stack.md
+++ b/docs-ref-services/preview/azure-stack.md
@@ -1,7 +1,7 @@
---
title: Azure Azure Stack SDK for Java
description: Reference for Azure Azure Stack SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-resource-manager
diff --git a/docs-ref-services/preview/azure-vmware-solution.md b/docs-ref-services/preview/azure-vmware-solution.md
index 18b77dea5aba2..017435ed11bb4 100644
--- a/docs-ref-services/preview/azure-vmware-solution.md
+++ b/docs-ref-services/preview/azure-vmware-solution.md
@@ -1,7 +1,7 @@
---
title: Azure Azure VMware Solution SDK for Java
description: Reference for Azure Azure VMware Solution SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: azurevmwaresolution
diff --git a/docs-ref-services/preview/baremetal-infrastructure.md b/docs-ref-services/preview/baremetal-infrastructure.md
index e86e1e35a7ac0..f61839cfef4b1 100644
--- a/docs-ref-services/preview/baremetal-infrastructure.md
+++ b/docs-ref-services/preview/baremetal-infrastructure.md
@@ -1,7 +1,7 @@
---
title: Azure BareMetal Infrastructure SDK for Java
description: Reference for Azure BareMetal Infrastructure SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: baremetalinfrastructure
diff --git a/docs-ref-services/preview/batch-index.md b/docs-ref-services/preview/batch-index.md
index a34d42e74fed0..a71a2f10bcf97 100644
--- a/docs-ref-services/preview/batch-index.md
+++ b/docs-ref-services/preview/batch-index.md
@@ -1,4 +1,5 @@
| Reference | Package | Source |
|---|---|---|
+|[Batch](batch-readme.md)|[azure-batch](https://repo1.maven.org/maven2/com/microsoft/azure/azure-batch)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/batch/microsoft-azure-batch)|
|[Compute Batch](compute-batch-readme.md)|[azure-compute-batch](https://repo1.maven.org/maven2/com/azure/azure-compute-batch)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/batch/azure-compute-batch)|
|[Resource Management - Batch](resourcemanager-batch-readme.md)|[azure-resourcemanager-batch](https://repo1.maven.org/maven2/com/azure/resourcemanager/azure-resourcemanager-batch)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/batch/azure-resourcemanager-batch)|
diff --git a/docs-ref-services/preview/batch-readme.md b/docs-ref-services/preview/batch-readme.md
new file mode 100644
index 0000000000000..24b12d78e9913
--- /dev/null
+++ b/docs-ref-services/preview/batch-readme.md
@@ -0,0 +1,154 @@
+---
+title:
+keywords: Azure, java, SDK, API, azure-batch, batch
+ms.date: 08/05/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: batch
+---
+## Azure Batch Libraries for Java
+
+This README is based on the latest released version Azure Batch SDK (7.0.0). If you are looking for other releases, see the [More Information](#more-information) section below.
+
+The Azure Batch Libraries for Java is a higher-level, object-oriented API for interacting with the Azure Batch service.
+
+
+> **7.0.0** is a release that supports all features of Azure Batch service with API version "2019-08-01.10.0". We will be adding support for more new features and tweaking the API associated with Azure Batch service newer release.
+
+**Azure Batch Authentication**
+
+You need to create a Batch account through the [Azure portal](https://portal.azure.com) or Azure cli.
+
+* Use the account name, key, and URL to create a `BatchSharedKeyCredentials` instance for authentication with the Azure Batch service.
+The `BatchClient` class is the simplest entry point for creating and interacting with Azure Batch objects.
+
+```java
+BatchSharedKeyCredentials cred = new BatchSharedKeyCredentials(batchUri, batchAccount, batchKey);
+BatchClient client = BatchClient.open(cred);
+```
+
+* The other way is using AAD (Azure Active Directory) authentication to create the client. See this [document](https://learn.microsoft.com/azure/batch/batch-aad-auth) for detail.
+
+```java
+BatchApplicationTokenCredentials cred = new BatchApplicationTokenCredentials(batchEndpoint, clientId, applicationSecret, applicationDomain, null, null);
+BatchClient client = BatchClient.open(cred);
+```
+
+**Create a pool using an Azure Marketplace image**
+
+You can create a pool of Azure virtual machines which can be used to execute tasks.
+
+```java
+System.out.println("Created a pool using an Azure Marketplace image.");
+
+VirtualMachineConfiguration configuration = new VirtualMachineConfiguration();
+configuration.withNodeAgentSKUId(skuId).withImageReference(imageRef);
+client.poolOperations().createPool(poolId, poolVMSize, configuration, poolVMCount);
+
+System.out.println("Created a Pool: " + poolId);
+```
+
+**Create a Job**
+
+You can create a job by using the recently created pool.
+
+```java
+PoolInformation poolInfo = new PoolInformation();
+poolInfo.withPoolId(poolId);
+client.jobOperations().createJob(jobId, poolInfo);
+```
+
+# Sample Code
+
+You can find sample code that illustrates Batch usage scenarios in https://github.com/azure/azure-batch-samples
+
+
+# Download
+
+[//]: # ({x-version-update-start;com.microsoft.azure:azure-batch;current})
+```xml
+
+ com.microsoft.azure
+ azure-batch
+ 11.2.0
+
+```
+[//]: # ({x-version-update-end})
+
+# Pre-requisites
+
+- [A Java Developer Kit (JDK)](https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable), v 1.7 or later
+- [Maven](https://central.sonatype.com/artifact/com.microsoft.azure/azure-batch)
+- Azure Service Principal - see [how to create authentication info](https://learn.microsoft.com/azure/batch/batch-aad-auth#use-a-service-principal).
+
+
+## Help
+
+If you encounter any bugs with these libraries, please file issues via [Issues](https://github.com/Azure/azure-sdk-for-java) or checkout [StackOverflow for Azure Java SDK](https://stackoverflow.com/questions/tagged/azure-java-sdk).
+
+# Contribute Code
+
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+# Build Code
+To build the code open a console, navigate to the git repository, and run
+```
+maven build
+```
+
+# Test Code
+
+All tests are run from the `sdk/batch` directory. They can be run either on the command line or from a Java IDE, such as Eclipse.
+
+## Step 1: Run tests in Record mode
+
+1. Deploy test resources in Azure and set the following environment variables:
+
+ * APPLICATION_SECRET
+ * AZURE_BATCH_ACCESS_KEY
+ * AZURE_BATCH_ACCOUNT
+ * AZURE_BATCH_ENDPOINT
+ * AZURE_BATCH_REGION
+ * AZURE_VNET
+ * AZURE_VNET_ADDRESS_SPACE
+ * AZURE_VNET_RESOURCE_GROUP
+ * AZURE_VNET_SUBNET
+ * AZURE_VNET_SUBNET_ADDRESS_SPACE
+ * CLIENT_ID
+ * STORAGE_ACCOUNT_KEY
+ * STORAGE_ACCOUNT_NAME
+ * SUBSCRIPTION_ID
+
+1. Set `AZURE_TEST_MODE` to `Record`
+1. Run the tests in `src/test/java`
+ 1. From the command-line, run `mvn test` (can also supply `-DAZURE_TEST_MODE=Record` instead of setting environment variable)
+1. Test recordings will be created in `microsoft-azure-batch/target/test-classes/session-records`
+1. Copy these recordings to `microsoft-azure-batch/src/test/resources/test-recordings`
+
+## Step 2: Run tests in Playback mode
+
+1. Set `AZURE_TEST_MODE` to `Playback`
+1. Run the Jetty test server
+ 1. CLI: `mvn jetty:start`
+ 1. Eclipse: Install Jetty plugin for Eclipse from marketplace and create two run configurations (one for 11080 and one for 11081)
+1. Run the tests
+ 1. CLI: `mvn test -DAZURE_TEST_MODE=Playback`
+
+# More Information
+
+* [Javadoc](https://learn.microsoft.com/java/api/overview/azure/batch?view=azure-java-stable)
+* [https://azure.com/java](https://azure.com/java)
+* If you don't have a Microsoft Azure subscription you can get a FREE trial account [here](https://go.microsoft.com/fwlink/?LinkId=330212)
+
+---
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+
+
diff --git a/docs-ref-services/preview/batch.md b/docs-ref-services/preview/batch.md
index 9ef20bd132f62..e2890edbb44cf 100644
--- a/docs-ref-services/preview/batch.md
+++ b/docs-ref-services/preview/batch.md
@@ -1,12 +1,12 @@
---
title: Azure Batch SDK for Java
description: Reference for Azure Batch SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: batch
-manager: douge
keywords: Azure, Java, SDK, API, Batch, processing, scheduling, long-running
+manager: douge
---
# Azure Batch libraries for Java
diff --git a/docs-ref-services/preview/billing-benefits.md b/docs-ref-services/preview/billing-benefits.md
index f8b21d7ee29fb..36ba9f896855c 100644
--- a/docs-ref-services/preview/billing-benefits.md
+++ b/docs-ref-services/preview/billing-benefits.md
@@ -1,7 +1,7 @@
---
title: Azure Billing Benefits SDK for Java
description: Reference for Azure Billing Benefits SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: billingbenefits
diff --git a/docs-ref-services/preview/billing.md b/docs-ref-services/preview/billing.md
index 02ca4d91867d4..8e8ddae4b18b5 100644
--- a/docs-ref-services/preview/billing.md
+++ b/docs-ref-services/preview/billing.md
@@ -1,7 +1,7 @@
---
title: Azure Billing SDK for Java
description: Reference for Azure Billing SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: billing
diff --git a/docs-ref-services/preview/bot-service.md b/docs-ref-services/preview/bot-service.md
index 4d2d57a15bd17..52534c44067e8 100644
--- a/docs-ref-services/preview/bot-service.md
+++ b/docs-ref-services/preview/bot-service.md
@@ -1,7 +1,7 @@
---
title: Azure Bot Service SDK for Java
description: Reference for Azure Bot Service SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: botservice
diff --git a/docs-ref-services/preview/carbonoptimization.md b/docs-ref-services/preview/carbonoptimization.md
index 0559f02150086..8be5345026ac3 100644
--- a/docs-ref-services/preview/carbonoptimization.md
+++ b/docs-ref-services/preview/carbonoptimization.md
@@ -1,7 +1,7 @@
---
title: Azure Carbonoptimization SDK for Java
description: Reference for Azure Carbonoptimization SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: carbonoptimization
diff --git a/docs-ref-services/preview/change-analysis-index.md b/docs-ref-services/preview/change-analysis-index.md
new file mode 100644
index 0000000000000..d65e76abcdb64
--- /dev/null
+++ b/docs-ref-services/preview/change-analysis-index.md
@@ -0,0 +1,3 @@
+| Reference | Package | Source |
+|---|---|---|
+|[Resource Management - Change Analysis](resourcemanager-changeanalysis-readme.md)|[azure-resourcemanager-changeanalysis](https://repo1.maven.org/maven2/com/azure/resourcemanager/azure-resourcemanager-changeanalysis)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/changeanalysis/azure-resourcemanager-changeanalysis)|
diff --git a/docs-ref-services/preview/change-analysis.md b/docs-ref-services/preview/change-analysis.md
new file mode 100644
index 0000000000000..73008cf9a0307
--- /dev/null
+++ b/docs-ref-services/preview/change-analysis.md
@@ -0,0 +1,11 @@
+---
+title: Azure Change Analysis SDK for Java
+description: Reference for Azure Change Analysis SDK for Java
+ms.date: 08/06/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: changeanalysis
+---
+# Azure Change Analysis SDK for Java - preview
+## Packages - preview
+[!INCLUDE [packages](change-analysis-index.md)]
\ No newline at end of file
diff --git a/docs-ref-services/preview/cognitive-services-index.md b/docs-ref-services/preview/cognitive-services-index.md
index a78f4744b142c..f339af95ae9d1 100644
--- a/docs-ref-services/preview/cognitive-services-index.md
+++ b/docs-ref-services/preview/cognitive-services-index.md
@@ -1,12 +1,15 @@
| Reference | Package | Source |
|---|---|---|
|[AI Agents Persistent](ai-agents-persistent-readme.md)|[azure-ai-agents-persistent](https://repo1.maven.org/maven2/com/azure/azure-ai-agents-persistent)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-agents-persistent)|
+|[Anomaly Detector](ai-anomalydetector-readme.md)|[azure-ai-anomalydetector](https://repo1.maven.org/maven2/com/azure/azure-ai-anomalydetector)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/anomalydetector/azure-ai-anomalydetector)|
|[Content Safety](ai-contentsafety-readme.md)|[azure-ai-contentsafety](https://repo1.maven.org/maven2/com/azure/azure-ai-contentsafety)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/contentsafety/azure-ai-contentsafety)|
|[Document Intelligence](ai-documentintelligence-readme.md)|[azure-ai-documentintelligence](https://repo1.maven.org/maven2/com/azure/azure-ai-documentintelligence)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence)|
+|[Form Recognizer](ai-formrecognizer-readme.md)|[azure-ai-formrecognizer](https://repo1.maven.org/maven2/com/azure/azure-ai-formrecognizer)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer)|
|[Azure AI Inference](ai-inference-readme.md)|[azure-ai-inference](https://repo1.maven.org/maven2/com/azure/azure-ai-inference)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-inference)|
|[OpenAI](ai-openai-readme.md)|[azure-ai-openai](https://repo1.maven.org/maven2/com/azure/azure-ai-openai)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/openai/azure-ai-openai)|
|[OpenAI Assistants](ai-openai-assistants-readme.md)|[azure-ai-openai-assistants](https://repo1.maven.org/maven2/com/azure/azure-ai-openai-assistants)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/openai/azure-ai-openai-assistants)|
|[AI Projects](ai-projects-readme.md)|[azure-ai-projects](https://repo1.maven.org/maven2/com/azure/azure-ai-projects)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/ai/azure-ai-projects)|
+|[Text Analytics](ai-textanalytics-readme.md)|[azure-ai-textanalytics](https://repo1.maven.org/maven2/com/azure/azure-ai-textanalytics)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/textanalytics/azure-ai-textanalytics)|
|[Document Translation](ai-translation-document-readme.md)|[azure-ai-translation-document](https://repo1.maven.org/maven2/com/azure/azure-ai-translation-document)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-document)|
|[Text Translation](ai-translation-text-readme.md)|[azure-ai-translation-text](https://repo1.maven.org/maven2/com/azure/azure-ai-translation-text)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/translation/azure-ai-translation-text)|
|[Face](ai-vision-face-readme.md)|[azure-ai-vision-face](https://repo1.maven.org/maven2/com/azure/azure-ai-vision-face)|[GitHub](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/face/azure-ai-vision-face)|
diff --git a/docs-ref-services/preview/cognitive-services.md b/docs-ref-services/preview/cognitive-services.md
index 18496ce4def6a..49a19fd972823 100644
--- a/docs-ref-services/preview/cognitive-services.md
+++ b/docs-ref-services/preview/cognitive-services.md
@@ -1,7 +1,7 @@
---
title: Azure Cognitive Services SDK for Java
description: Reference for Azure Cognitive Services SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: cognitiveservices
diff --git a/docs-ref-services/preview/commerce.md b/docs-ref-services/preview/commerce.md
index ccf66ffdc17a6..3e608d537535c 100644
--- a/docs-ref-services/preview/commerce.md
+++ b/docs-ref-services/preview/commerce.md
@@ -1,7 +1,7 @@
---
title: Azure Commerce SDK for Java
description: Reference for Azure Commerce SDK for Java
-ms.date: 08/04/2025
+ms.date: 08/06/2025
ms.topic: reference
ms.devlang: java
ms.service: commerce
diff --git a/docs-ref-services/preview/communication-callautomation-readme.md b/docs-ref-services/preview/communication-callautomation-readme.md
index 13f350f6e2361..7ac7f0b5f6d9f 100644
--- a/docs-ref-services/preview/communication-callautomation-readme.md
+++ b/docs-ref-services/preview/communication-callautomation-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Communication Call Automation Service client library for Java
keywords: Azure, java, SDK, API, azure-communication-callautomation, communication/azure-communication-callautomation
-ms.date: 01/31/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: communication/azure-communication-callautomation
---
-# Azure Communication Call Automation Service client library for Java - version 1.4.0-beta.2
+# Azure Communication Call Automation Service client library for Java - version 1.5.0-alpha.20250804.2
This package contains a Java SDK for Azure Communication Call Automation Service.
@@ -31,7 +31,7 @@ This package contains a Java SDK for Azure Communication Call Automation Service
com.azureazure-communication-callautomation
- 1.1.0
+ 1.5.0
```
@@ -50,64 +50,9 @@ This is the restart of Call Automation Service. It is renamed to Call Automation
`CallAutomationEventParser` provides the functionality to handle events from the ACS resource.
-## Examples
-
-### Handle Mid-Connection events with CallAutomation's EventProcessor
-
-To easily handle mid-connection events, Call Automation's SDK provides easier way to handle these events.
-Take a look at `CallAutomationEventProcessor`. This will ensure correlation between call and events more easily.
-
-```Java
-@RestController
-public class ActionController {
- // Controller implementation...
-
- @RequestMapping(value = "/api/events", method = POST)
- public ResponseEntity> handleCallEvents(@RequestBody String requestBody) {
- try {
- CallAutomationAsyncClient client = getCallAutomationAsyncClient();
- client.getEventProcessor().processEvents(requestBody);
-
- return new ResponseEntity<>(HttpStatus.OK);
- } catch (Exception e) {
- return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
- }
- }
-}
-```
-
-`processEvents` is required for EventProcessor to work.
-After event is being consumed by EventProcessor, you can start using its feature.
-
-See below for example: where you are making a call with `CreateCall`, and wait for `CallConnected` event of the call.
-
-```Java
-public class commandClass {
- // Class implementation...
-
- public void createCallCommand() {
- CallAutomationAsyncClient client = getCallAutomationAsyncClient(); // Should be the same instance as the one used in the example above.
- String callbackUrl = "";
- CallInvite callInvite = new CallInvite(new CommunicationUserIdentifier(""));
- CreateCallResult result = client.createCall(callInvite, callbackUrl).block();
-
- try {
- // This will wait until CallConnected event is arrived or Timesout!
- CreateCallEventResult eventResult = result.waitForEventProcessorAsync(Duration.ofSeconds(30)).block();
- CallConnected returnedEvent = eventResult.successResult();
- } catch (Exception e) {
- // Timeout exception happend!
- // Call likely was never answered.
- }
- }
-}
-```
-
-If timeout was not set when calling "waitForEventProcessorAsync", the default timeout is 4 minutes.
-
## Troubleshooting
-If you recieve a CommunicationErrorException with the messagae: "Action is invalid when call is not in Established state." This usually means the call has ended. This can occur if the participants all leave
+If you receive a CommunicationErrorException with the message: "Action is invalid when call is not in Established state." This usually means the call has ended. This can occur if the participants all leave
the call, or participants did not accept the call before the call timed out.
If you fail to start a call because of an HMAC validation error, be sure your access key is correct, and
@@ -141,7 +86,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m
[product_docs]: https://learn.microsoft.com/azure/communication-services/
[package]: https://dev.azure.com/azure-sdk/public/_artifacts/feed/azure-sdk-for-java-communication-interaction
[api_documentation]: https://aka.ms/java-docs
-[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-communication-callautomation_1.4.0-beta.2/sdk/communication/azure-communication-callautomation/src
+[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-callautomation/src
[overview]: https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/call-automation
[incomingcall]: https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/incoming-call-notification
[build1]: https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/callflows-for-customer-interactions?pivots=programming-language-java
diff --git a/docs-ref-services/preview/communication-callingserver-readme.md b/docs-ref-services/preview/communication-callingserver-readme.md
new file mode 100644
index 0000000000000..fa092a6c8cd65
--- /dev/null
+++ b/docs-ref-services/preview/communication-callingserver-readme.md
@@ -0,0 +1,89 @@
+---
+title: Azure Communication CallingServer Service client library for Java
+keywords: Azure, java, SDK, API, azure-communication-callingserver, communication/azure-communication-callingserver
+ms.date: 08/05/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: communication/azure-communication-callingserver
+---
+# Azure Communication CallingServer Service client library for Java - version 1.0.0-alpha.20250805.1
+
+
+This package contains a Java SDK for Azure Communication CallingServer Service. Server Test
+
+[Source code][source] | [Package (Maven)][package] | [API reference documentation][api_documentation]
+| [Product documentation][product_docs]
+
+## Getting started
+
+### Prerequisites
+
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- [Java Development Kit (JDK)](https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable) version 8 or above.
+- [Apache Maven](https://maven.apache.org/download.cgi).
+- A deployed Communication Services resource. You can use the [Azure Portal](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp) or the [Azure PowerShell](https://learn.microsoft.com/powershell/module/az.communication/new-azcommunicationservice) to set it up.
+
+### Include the package
+
+[//]: # ({x-version-update-start;com.azure:azure-communication-callingserver;current})
+```xml
+
+ com.azure
+ azure-communication-callingserver
+ 1.0.0-beta.5
+
+```
+[//]: # ({x-version-update-end})
+
+## Key concepts
+This is the restart of CallingServer Service. It is renamed to Call Automation service and being more intuitive to use.
+
+`CallAutomationClient` provides the functionality to make call, answer/reject incoming call and redirect a call.
+
+`CallConnection` provides the functionality to perform actions in an established call connection such as adding participants and terminate the call.
+
+`CallMedia` introduces media related functionalities into the call.
+
+`CallRecording` provides the functionality of recording the call.
+
+`EventHandler` provides the functionality to handle events from the ACS resource.
+
+## Examples
+
+To be determined.
+
+## Troubleshooting
+
+If you receive a CommunicationErrorException with the message: "Action is invalid when call is not in Established state." This usually means the call has ended. This can occur if the participants all leave
+the call, or participants did not accept the call before the call timed out.
+
+If you fail to start a call because of an HMAC validation error, be sure your access key is correct, and
+that you are passing in a valid conversation id.
+
+## Contributing
+
+This project welcomes contributions and suggestions. Most contributions require you to agree to a [Contributor License Agreement (CLA)][cla] declaring that you have the right to, and actually do, grant us the rights to use your contribution.
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments.
+
+## Next steps
+
+- [Read more about CallingServer Call Automation in Azure Communication Services][call_automation_apis_overview]
+- [Read more about CallingServer Call Recording in Azure Communication Services][call_recording_overview]
+- For a basic guide on how to record and download calls with Event Grid please refer to the [Record and download calls with Event Grid][record_and_download_calls_with_event_grid].
+
+
+[cla]: https://cla.microsoft.com
+[coc]: https://opensource.microsoft.com/codeofconduct/
+[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
+[coc_contact]: mailto:opencode@microsoft.com
+[product_docs]: https://learn.microsoft.com/azure/communication-services/
+[package]: https://dev.azure.com/azure-sdk/public/_artifacts/feed/azure-sdk-for-java-communication-interaction
+[api_documentation]: https://aka.ms/java-docs
+[call_automation_apis_overview]:https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/call-automation-apis
+[call_recording_overview]:https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/call-recording
+[record_and_download_calls_with_event_grid]:https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/download-recording-file-sample
+[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-callingserver/src
+
diff --git a/docs-ref-services/preview/communication-chat-readme.md b/docs-ref-services/preview/communication-chat-readme.md
index 14b5c18c3aad0..a0531b1c7f78f 100644
--- a/docs-ref-services/preview/communication-chat-readme.md
+++ b/docs-ref-services/preview/communication-chat-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Communication Chat client library for Java
-keywords: Azure, java, SDK, API, azure-communication-chat, communication
-ms.date: 08/12/2021
+keywords: Azure, java, SDK, API, azure-communication-chat, communication/azure-communication-chat
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: communication
+ms.service: communication/azure-communication-chat
---
-# Azure Communication Chat client library for Java - version 1.1.0-beta.2
+# Azure Communication Chat client library for Java - version 1.7.0-alpha.20250805.1
Azure Communication Chat contains the APIs used in chat applications for Azure Communication Services.
@@ -19,17 +19,49 @@ Azure Communication Chat contains the APIs used in chat applications for Azure C
### Prerequisites
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
-- [Java Development Kit (JDK)](https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable) version 8 or above.
+- [Java Development Kit (JDK)](https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable) version 8 or above.
- [Apache Maven](https://maven.apache.org/download.cgi).
-- A deployed Communication Services resource. You can use the [Azure Portal](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp) or the [Azure PowerShell](https://docs.microsoft.com/powershell/module/az.communication/new-azcommunicationservice) to set it up.
+- A deployed Communication Services resource. You can use the [Azure Portal](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp) or the [Azure PowerShell](https://learn.microsoft.com/powershell/module/az.communication/new-azcommunicationservice) to set it up.
### Include the package
+#### Include the BOM file
+
+Please include the azure-sdk-bom to your project to take dependency on the General Availability (GA) version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
+To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
+
+```xml
+
+
+
+ com.azure
+ azure-sdk-bom
+ {bom_version_to_target}
+ pom
+ import
+
+
+
+```
+and then include the direct dependency in the dependencies section without the version tag.
+
+```xml
+
+
+ com.azure
+ azure-communication-chat
+
+
+```
+
+#### Include direct dependency
+If you want to take dependency on a particular version of the library that is not present in the BOM,
+add the direct dependency to your project as follows.
[//]: # ({x-version-update-start;com.azure:azure-communication-chat;current})
```xml
com.azureazure-communication-chat
- 1.1.0-beta.2
+ 1.6.0
```
@@ -64,7 +96,7 @@ endpoint = "https://*Azure-Communication-Resource-Name*.communications.azure.com
User access tokens enable you to build client applications that directly authenticate to Azure Communication Services.
You generate these tokens on your server, pass them back to a client device, and then use them to initialize the Communication Services SDKs.
-Learn how to generate user access tokens from [User Access Tokens](https://docs.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java#issue-user-access-tokens)
+Learn how to generate user access tokens from [User Access Tokens](https://learn.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java#issue-user-access-tokens)
## Examples
@@ -79,8 +111,7 @@ The following sections provide several code snippets covering some of the most c
### Create the Chat Client
-
-```Java
+```java readme-sample-createChatClient
String endpoint = "https://.communcationservices.azure.com";
// Your user access token retrieved from your trusted service
@@ -110,8 +141,7 @@ Use the `createChatThread` method to create a chat thread.
It contains a `getChatThread()` method which returns the `ChatThread` object that can be used to get the thread client from which you can get the `ChatThreadClient` for performing operations on the created thread: add participants, send message, etc.
The `ChatThread` object also contains the `getId()` method which retrieves the unique ID of the thread.
-
-```Java
+```java readme-sample-createChatThread
List participants = new ArrayList();
ChatParticipant firstParticipant = new ChatParticipant()
@@ -136,8 +166,7 @@ String chatThreadId = result.getChatThread().getId();
The `getChatThreadProperties` method retrieves a thread's properties from the service.
-
-```Java
+```java readme-sample-getChatThread
ChatThreadClient chatThreadClient = chatClient.getChatThreadClient("Id");
ChatThreadProperties chatThreadProperties = chatThreadClient.getProperties();
```
@@ -147,8 +176,7 @@ ChatThreadProperties chatThreadProperties = chatThreadClient.getProperties();
Use `deleteChatThread` method to delete a chat thread
`chatThreadId` is the unique ID of the chat thread.
-
-```Java
+```java readme-sample-deleteChatThread
String chatThreadId = "Id";
chatClient.deleteChatThread(chatThreadId);
```
@@ -158,8 +186,7 @@ chatClient.deleteChatThread(chatThreadId);
The `getChatThreadClient` method returns a thread client for a thread that already exists. It can be used for performing operations on the created thread: add participants, send message, etc.
`chatThreadId` is the unique ID of the existing chat thread.
-
-```Java
+```java readme-sample-getChatThreadClient
String chatThreadId = "Id";
ChatThreadClient chatThreadClient = chatClient.getChatThreadClient(chatThreadId);
```
@@ -169,8 +196,7 @@ ChatThreadClient chatThreadClient = chatClient.getChatThreadClient(chatThreadId)
Use `updateTopic` method to update a thread's topic
`topic` is used to hold the new topic of the thread.
-
-```Java
+```java readme-sample-updateTopic
chatThreadClient.updateTopic("New Topic");
```
@@ -187,8 +213,7 @@ Use the `sendMessage` method to send a chat message to the chat thread that the
A `SendChatMessageResult` response returned from sending a chat message, it contains an id, which is the unique ID of the message.
-
-```Java
+```java readme-sample-sendChatMessage
SendChatMessageOptions sendChatMessageOptions = new SendChatMessageOptions()
.setContent("Message content")
.setSenderDisplayName("Sender Display Name");
@@ -201,8 +226,7 @@ SendChatMessageResult sendResult = chatThreadClient.sendMessage(sendChatMessageO
The `getMessage` method retrieves a chat message from the service.
`chatMessageId` is the unique ID of the chat message.
-
-```Java
+```java readme-sample-getChatMessage
String chatMessageId = "Id";
ChatMessage chatMessage = chatThreadClient.getMessage(chatMessageId);
```
@@ -211,15 +235,13 @@ ChatMessage chatMessage = chatThreadClient.getMessage(chatMessageId);
You can retrieve chat messages using the `listMessages` method on the chat thread client at specified intervals (polling).
-
-```Java
+```java readme-sample-getChatMessages
PagedIterable chatMessagesResponse = chatThreadClient.listMessages();
chatMessagesResponse.iterableByPage().forEach(resp -> {
System.out.printf("Response headers are %s. Url %s and status code %d %n", resp.getHeaders(),
resp.getRequest().getUrl(), resp.getStatusCode());
- resp.getItems().forEach(message -> {
- System.out.printf("Message id is %s.", message.getId());
- });
+ resp.getElements().forEach(message ->
+ System.out.printf("Message id is %s.", message.getId()));
});
```
@@ -243,7 +265,7 @@ listMessages returns different types of messages which can be identified by `cha
- `participantRemoved`: System message that indicates a participant has been removed from the chat thread.
-For more details, see [Message Types](https://docs.microsoft.com/azure/communication-services/concepts/chat/concepts#message-types).
+For more details, see [Message Types](https://learn.microsoft.com/azure/communication-services/concepts/chat/concepts#message-types).
#### Update a chat message
@@ -253,8 +275,7 @@ Use `updateMessage` to update a chat message identified by chatThreadId and mess
- Use `content` to provide a new chat message content;
-
-```Java
+```java readme-sample-updateChatMessage
String chatMessageId = "Id";
UpdateChatMessageOptions updateChatMessageOptions = new UpdateChatMessageOptions()
.setContent("Updated message content");
@@ -267,8 +288,7 @@ chatThreadClient.updateMessage(chatMessageId, updateChatMessageOptions);
Use `updateMessage` to update a chat message identified by chatMessageId.
`chatMessageId` is the unique ID of the chat message.
-
-```Java
+```java readme-sample-deleteChatMessage
String chatMessageId = "Id";
chatThreadClient.deleteMessage(chatMessageId);
```
@@ -279,15 +299,13 @@ chatThreadClient.deleteMessage(chatMessageId);
Use `listParticipants` to retrieve a paged collection containing the participants of the chat thread.
-
-```Java
+```java readme-sample-listChatParticipants
PagedIterable chatParticipantsResponse = chatThreadClient.listParticipants();
chatParticipantsResponse.iterableByPage().forEach(resp -> {
System.out.printf("Response headers are %s. Url %s and status code %d %n", resp.getHeaders(),
resp.getRequest().getUrl(), resp.getStatusCode());
- resp.getItems().forEach(chatParticipant -> {
- System.out.printf("Participant id is %s.", ((CommunicationUserIdentifier) chatParticipant.getCommunicationIdentifier()).getId());
- });
+ resp.getElements().forEach(chatParticipant ->
+ System.out.printf("Participant id is %s.", ((CommunicationUserIdentifier) chatParticipant.getCommunicationIdentifier()).getId()));
});
```
@@ -296,12 +314,11 @@ chatParticipantsResponse.iterableByPage().forEach(resp -> {
Use `addParticipants` method to add participants to the chat thread.
`participants` list of participants to be added to the thread;
-- `communicationIdentifier`, required, is the CommunicationIdentifier you've created by using the CommunicationIdentityClient. More info at: [Create A User](https://docs.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java#create-a-user).
+- `communicationIdentifier`, required, is the CommunicationIdentifier you've created by using the CommunicationIdentityClient. More info at: [Create A User](https://learn.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java#create-a-user).
- `display_name`, optional, is the display name for the thread member.
- `share_history_time`, optional, is the time from which the chat history is shared with the member. To share history since the inception of the chat thread, set this property to any date equal to, or less than the thread creation time. To share no history previous to when the member was added, set it to the current date. To share partial history, set it to the required date.
-
-```Java
+```java readme-sample-addChatParticipants
List participants = new ArrayList();
ChatParticipant firstParticipant = new ChatParticipant()
@@ -323,8 +340,7 @@ chatThreadClient.addParticipants(participants);
Use `removeParticipant` method to remove a participant from the chat thread.
`identifier` is the CommunicationIdentifier you've created.
-
-```Java
+```java readme-sample-removeChatParticipant
chatThreadClient.removeParticipant(user);
```
@@ -335,8 +351,7 @@ chatThreadClient.removeParticipant(user);
Use `sendReadReceipt` method to post a read receipt event to a chat thread, on behalf of a user.
`chatMessageId` is the unique ID of the chat message that was read.
-
-```Java
+```java readme-sample-sendReadReceipt
String chatMessageId = "Id";
chatThreadClient.sendReadReceipt(chatMessageId);
```
@@ -345,15 +360,13 @@ chatThreadClient.sendReadReceipt(chatMessageId);
`getReadReceipts` method retrieves read receipts for a chat thread.
-
-```Java
+```java readme-sample-listReadReceipts
PagedIterable readReceiptsResponse = chatThreadClient.listReadReceipts();
readReceiptsResponse.iterableByPage().forEach(resp -> {
System.out.printf("Response headers are %s. Url %s and status code %d %n", resp.getHeaders(),
resp.getRequest().getUrl(), resp.getStatusCode());
- resp.getItems().forEach(readReceipt -> {
- System.out.printf("Read message id is %s.", readReceipt.getChatMessageId());
- });
+ resp.getElements().forEach(readReceipt ->
+ System.out.printf("Read message id is %s.", readReceipt.getChatMessageId()));
});
```
@@ -366,15 +379,12 @@ Use `sendTypingNotification` method to post a typing notification event to a cha
- Use `senderDisplayName` to set the display name of the notification sender;
-
-```Java
+```java readme-sample-sendTypingNotification
TypingNotificationOptions options = new TypingNotificationOptions();
options.setSenderDisplayName("Sender Display Name");
-chatThreadClient.sendTypingNotification(options);
+chatThreadClient.sendTypingNotificationWithResponse(options, Context.NONE);
```
-
-
## Troubleshooting
In progress.
@@ -388,8 +398,8 @@ Check out other client libraries for Azure communication service
[coc]: https://opensource.microsoft.com/codeofconduct/
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
[coc_contact]: mailto:opencode@microsoft.com
-[product_docs]: https://docs.microsoft.com/azure/communication-services/
-[package]: https://search.maven.org/artifact/com.azure/azure-communication-chat
+[product_docs]: https://learn.microsoft.com/azure/communication-services/
+[package]: https://central.sonatype.com/artifact/com.azure/azure-communication-chat
[api_documentation]: https://aka.ms/java-docs
-[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-communication-chat_1.1.0-beta.2/sdk/communication/azure-communication-chat/src
+[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-chat/src
diff --git a/docs-ref-services/preview/communication-identity-readme.md b/docs-ref-services/preview/communication-identity-readme.md
new file mode 100644
index 0000000000000..7e075e6ab57ca
--- /dev/null
+++ b/docs-ref-services/preview/communication-identity-readme.md
@@ -0,0 +1,252 @@
+---
+title: Azure Communication Identity client library for Java
+keywords: Azure, java, SDK, API, azure-communication-identity, communication/azure-communication-identity
+ms.date: 08/05/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: communication/azure-communication-identity
+---
+# Azure Communication Identity client library for Java - version 1.7.0-alpha.20250805.1
+
+
+The identity package is used for managing users and tokens for Azure Communication Services.
+
+[Source code][source] | [Package (Maven)][package] | [API reference documentation][api_documentation]
+| [Product documentation][product_docs]
+
+
+## Getting started
+
+### Prerequisites
+
+- An Azure subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+- [Java Development Kit (JDK)](https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable) version 8 or above.
+- [Apache Maven](https://maven.apache.org/download.cgi).
+- A Communication Services resource. You can use the [Azure Portal](https://learn.microsoft.com/azure/communication-services/quickstarts/create-communication-resource?tabs=windows&pivots=platform-azp) or the [Azure PowerShell](https://learn.microsoft.com/powershell/module/az.communication/new-azcommunicationservice) to set it up.
+
+### Include the package
+#### Include the BOM file
+
+Please include the azure-sdk-bom to your project to take dependency on the General Availability (GA) version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
+To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
+
+```xml
+
+
+
+ com.azure
+ azure-sdk-bom
+ {bom_version_to_target}
+ pom
+ import
+
+
+
+```
+and then include the direct dependency in the dependencies section without the version tag.
+
+```xml
+
+
+ com.azure
+ azure-communication-identity
+
+
+```
+
+#### Include direct dependency
+If you want to take dependency on a particular version of the library that is not present in the BOM,
+add the direct dependency to your project as follows.
+
+
+[//]: # ({x-version-update-start;com.azure:azure-communication-identity;current})
+```xml
+
+ com.azure
+ azure-communication-identity
+ 1.7.0-beta.1
+
+```
+
+## Authenticate the client
+
+There are two forms of authentication to use the Identity SDK:
+
+### Azure Active Directory Token Authentication
+A `DefaultAzureCredential` object must be passed to the `CommunicationIdentityClientBuilder` via the credential() function. Endpoint and httpClient must also be set via the endpoint() and httpClient() functions respectively.
+
+`AZURE_CLIENT_SECRET`, `AZURE_CLIENT_ID` and `AZURE_TENANT_ID` environment variables
+are needed to create a DefaultAzureCredential object.
+
+```java readme-sample-createCommunicationIdentityClientWithAAD
+// You can find your endpoint and access key from your resource in the Azure Portal
+String endpoint = "https://.communication.azure.com";
+
+CommunicationIdentityClient communicationIdentityClient = new CommunicationIdentityClientBuilder()
+ .endpoint(endpoint)
+ .credential(new DefaultAzureCredentialBuilder().build())
+ .buildClient();
+```
+
+### AzureKeyCredential Authentication
+Identity uses HMAC authentication with the resource access key.
+The access key can be used to create an AzureKeyCredential and provided to the `CommunicationIdentityClientBuilder` via the credential() function. Endpoint and httpClient must also be set via the endpoint() and httpClient() functions respectively.
+
+```java readme-sample-createCommunicationIdentityClient
+// You can find your endpoint and access key from your resource in the Azure Portal
+String endpoint = "https://.communication.azure.com";
+AzureKeyCredential keyCredential = new AzureKeyCredential("");
+
+CommunicationIdentityClient communicationIdentityClient = new CommunicationIdentityClientBuilder()
+ .endpoint(endpoint)
+ .credential(keyCredential)
+ .buildClient();
+```
+
+### Connection String Authentication
+Alternatively, you can provide the entire connection string using the connectionString() function instead of providing the endpoint and access key.
+
+```java readme-sample-createCommunicationIdentityClientWithConnectionString
+// You can find your connection string from your resource in the Azure Portal
+String connectionString = "";
+
+CommunicationIdentityClient communicationIdentityClient = new CommunicationIdentityClientBuilder()
+ .connectionString(connectionString)
+ .buildClient();
+```
+
+## Key concepts
+
+`CommunicationIdentityClient` and `CommunicationIdentityAsyncClient` provide the functionalities to manage users and user tokens.
+
+## Examples
+
+### Creating a new user
+Use the `createUser` function to create a new user. `user.getId()` gets the
+unique ID of the user that was created.
+
+```java readme-sample-createNewUser
+CommunicationUserIdentifier user = communicationIdentityClient.createUser();
+System.out.println("User id: " + user.getId());
+```
+
+### Getting a token for an existing user
+Use the `getToken` function to get a token for an existing user. The function
+also takes in a list of `CommunicationTokenScope`. Scope options include:
+- `CHAT` (Use this for full access to Chat APIs)
+- `VOIP` (Use this for full access to Calling APIs)
+- `CHAT_JOIN` (Access to Chat APIs but without the authorization to create, delete or update chat threads)
+- `CHAT_JOIN_LIMITED` (A more limited version of CHAT_JOIN that doesn't allow to add or remove participants)
+- `VOIP_JOIN` (Access to Calling APIs but without the authorization to start new calls)
+
+```java readme-sample-issueUserToken
+ // Define a list of communication token scopes
+List scopes = Arrays.asList(CommunicationTokenScope.CHAT);
+
+AccessToken userToken = communicationIdentityClient.getToken(user, scopes);
+System.out.println("User token value: " + userToken.getToken());
+System.out.println("Expires at: " + userToken.getExpiresAt());
+```
+
+It's also possible to create a Communication Identity access token by customizing the expiration time. The token can be configured to expire in as little as one hour or as long as 24 hours. The default expiration time is 24 hours.
+```java readme-sample-issueTokenWithCustomExpiration
+// Define a list of Communication Identity access token scopes
+List scopes = Arrays.asList(CommunicationTokenScope.CHAT);
+// Set custom validity period of the Communication Identity access token within [1,24]
+// hours range. If not provided, the default value of 24 hours will be used.
+Duration tokenExpiresIn = Duration.ofHours(1);
+AccessToken userToken = communicationIdentityClient.getToken(user, scopes, tokenExpiresIn);
+System.out.println("User token value: " + userToken.getToken());
+System.out.println("Expires at: " + userToken.getExpiresAt());
+```
+
+### Create a new user and token in a single request
+For convenience, use `createUserAndToken` to create a new user and issue a token with one function call. This translates into a single web request as opposed to creating a user first and then issuing a token.
+
+```java readme-sample-createNewUserAndToken
+// Define a list of communication token scopes
+List scopes = Arrays.asList(CommunicationTokenScope.CHAT);
+
+CommunicationUserIdentifierAndToken result = communicationIdentityClient.createUserAndToken(scopes);
+System.out.println("User id: " + result.getUser().getId());
+System.out.println("User token value: " + result.getUserToken().getToken());
+```
+
+Here it's also possible to specify the expiration time for the Communication Identity access token. The token can be configured to expire in as little as one hour or as long as 24 hours. The default expiration time is 24 hours.
+
+```java readme-sample-createNewUserAndTokenWithCustomExpiration
+// Define a list of communication token scopes
+List scopes = Arrays.asList(CommunicationTokenScope.CHAT);
+// Set custom validity period of the Communication Identity access token within [1,24]
+// hours range. If not provided, the default value of 24 hours will be used.
+Duration tokenExpiresIn = Duration.ofHours(1);
+CommunicationUserIdentifierAndToken result = communicationIdentityClient.createUserAndToken(scopes, tokenExpiresIn);
+System.out.println("User id: " + result.getUser().getId());
+System.out.println("User token value: " + result.getUserToken().getToken());
+```
+
+### Revoking all tokens for an existing user
+Use the `revokeTokens` function to revoke all the issued tokens of a user.
+
+```java readme-sample-revokeUserToken
+// revoke tokens issued for the specified user
+communicationIdentityClient.revokeTokens(user);
+```
+
+### Deleting a user
+Use the `deleteUser` function to delete a user.
+
+```java readme-sample-deleteUser
+// delete a previously created user
+communicationIdentityClient.deleteUser(user);
+```
+
+### Exchanging Azure AD access token of a Teams User for a Communication Identity access token
+Use the `getTokenForTeamsUser` function to exchange an Azure AD access token of a Teams User for a new Communication Identity access token.
+
+```java readme-sample-getTokenForTeamsUser
+String clientId = "";
+String userObjectId = "