diff --git a/docs-ref-mapping/reference-unified.yml b/docs-ref-mapping/reference-unified.yml
index 80132b1da751..4f4e48b900ce 100644
--- a/docs-ref-mapping/reference-unified.yml
+++ b/docs-ref-mapping/reference-unified.yml
@@ -180,6 +180,10 @@
- com.azure.resourcemanager.arizeaiobservabilityeval.fluent
- com.azure.resourcemanager.arizeaiobservabilityeval.fluent.models
- com.azure.resourcemanager.arizeaiobservabilityeval.models
+ - com.azure.resourcemanager.arizeaiobservabilityeval
+ - com.azure.resourcemanager.arizeaiobservabilityeval.fluent
+ - com.azure.resourcemanager.arizeaiobservabilityeval.fluent.models
+ - com.azure.resourcemanager.arizeaiobservabilityeval.models
- name: Astro
href: ~/docs-ref-services/{moniker}/astro.md
landingPageType: Service
@@ -1546,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
@@ -1560,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
@@ -2302,6 +2303,10 @@
- com.azure.resourcemanager.lambdatesthyperexecute.fluent
- com.azure.resourcemanager.lambdatesthyperexecute.fluent.models
- com.azure.resourcemanager.lambdatesthyperexecute.models
+ - com.azure.resourcemanager.lambdatesthyperexecute
+ - com.azure.resourcemanager.lambdatesthyperexecute.fluent
+ - com.azure.resourcemanager.lambdatesthyperexecute.fluent.models
+ - com.azure.resourcemanager.lambdatesthyperexecute.models
- name: Large Instance
href: ~/docs-ref-services/{moniker}/large-instance.md
landingPageType: Service
@@ -2680,6 +2685,10 @@
- com.azure.resourcemanager.mongodbatlas.fluent
- com.azure.resourcemanager.mongodbatlas.fluent.models
- com.azure.resourcemanager.mongodbatlas.models
+ - com.azure.resourcemanager.mongodbatlas
+ - com.azure.resourcemanager.mongodbatlas.fluent
+ - com.azure.resourcemanager.mongodbatlas.fluent.models
+ - com.azure.resourcemanager.mongodbatlas.models
- name: Monitor
href: ~/docs-ref-services/{moniker}/monitor.md
landingPageType: Service
@@ -2702,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:
@@ -3119,6 +3138,10 @@
- com.azure.resourcemanager.purestorageblock.fluent
- com.azure.resourcemanager.purestorageblock.fluent.models
- com.azure.resourcemanager.purestorageblock.models
+ - com.azure.resourcemanager.purestorageblock
+ - com.azure.resourcemanager.purestorageblock.fluent
+ - com.azure.resourcemanager.purestorageblock.fluent.models
+ - com.azure.resourcemanager.purestorageblock.models
- name: Purview
href: ~/docs-ref-services/{moniker}/purview.md
landingPageType: Service
diff --git a/docs-ref-services/latest/advisor.md b/docs-ref-services/latest/advisor.md
index 1957a18367d6..ae87306d6987 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/01/2025
+ms.date: 08/05/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 bdf98fd2a684..e6157559c007 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/01/2025
+ms.date: 08/05/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 2d09c3db80de..528c090f96a2 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/01/2025
+ms.date: 08/05/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 540054daa117..b5f5898fbead 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/01/2025
+ms.date: 08/05/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 f251f117a21f..2a40373eedd8 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/01/2025
+ms.date: 08/05/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 73c091243701..2e398e982136 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/01/2025
+ms.date: 08/05/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 6a63c2978ab8..b39ac5bea05b 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/01/2025
+ms.date: 08/05/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 39729b8c83eb..cc984fab74ea 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/01/2025
+ms.date: 08/05/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 473831ea1795..1d515177e6f4 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/01/2025
+ms.date: 08/05/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 9a09b36a93a2..cd1893e468f3 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/01/2025
+ms.date: 08/05/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 e705499929eb..3321271b6b1f 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/01/2025
+ms.date: 08/05/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 d080dc64834f..86ab1e8de40b 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/01/2025
+ms.date: 08/05/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 d6e90c5db8cc..7751264df524 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/01/2025
+ms.date: 08/05/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 2bb5ada7701c..0aa5862f8dc6 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/01/2025
+ms.date: 08/05/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 5d58754e5e48..f7daa08dd9cd 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/01/2025
+ms.date: 08/05/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 b8cc15077459..7fcec4d3b38d 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/01/2025
+ms.date: 08/05/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 5a5a5e563e97..f37b1d2ca09a 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/01/2025
+ms.date: 08/05/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 4a617ab1c0fc..6a242ed4d474 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/01/2025
+ms.date: 08/05/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 f62c03fa78ea..df654e82b702 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/01/2025
+ms.date: 08/05/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 4da5975535e9..d5563d3bdf0c 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/01/2025
+ms.date: 08/05/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 de8f6ffab62c..4962d2928ee8 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/01/2025
+ms.date: 08/05/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 ad8dfe74da49..af1cc633b21a 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/01/2025
+ms.date: 08/05/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 8cf38a3e60c1..34499e95c326 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/01/2025
+ms.date: 08/05/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 6477dd051bd7..e1f80a4d2bc2 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/01/2025
+ms.date: 08/05/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 53cf2d705bac..b33932082207 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/01/2025
+ms.date: 08/05/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 c3aec23fa8de..bc40f0811edd 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/01/2025
+ms.date: 08/05/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 cf10083b7837..b7835ea8f8d8 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/01/2025
+ms.date: 08/05/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 f442c10bd03d..b1ca5894efe7 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/01/2025
+ms.date: 08/05/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 f29bd327d23a..c463a0c17898 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/01/2025
+ms.date: 08/05/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 b70208649218..f2ceed9fef3a 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/01/2025
+ms.date: 08/05/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 a14b38e2cb01..c290d6e98ced 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/01/2025
+ms.date: 08/05/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 1a601b792eb4..4ec14484acd2 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/01/2025
+ms.date: 08/05/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 a7e132a1c0f1..6ab363fe0b63 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/01/2025
+ms.date: 08/05/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 5a12d91ea8f7..b8dede0e7913 100644
--- a/docs-ref-services/latest/container-registry.md
+++ b/docs-ref-services/latest/container-registry.md
@@ -1,10 +1,10 @@
---
title: Azure Container Registry SDK for Java
description: Reference for Azure Container Registry SDK for Java
-ms.date: 08/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: container-registry
+ms.service: containerregistry
---
# Azure Container Registry SDK for Java - latest
## Packages - latest
diff --git a/docs-ref-services/latest/container-service-fleet.md b/docs-ref-services/latest/container-service-fleet.md
index a2c5db39af9b..db620f561d17 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/01/2025
+ms.date: 08/05/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 47f4019863d2..8786289913b7 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/01/2025
+ms.date: 08/05/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 a72d42358031..c0a03daa1560 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/01/2025
+ms.date: 08/05/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 8cf26f9a205e..a7d6805ef6fa 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/01/2025
+ms.date: 08/05/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 6386e1d94368..d5e876c7dad9 100644
--- a/docs-ref-services/latest/cosmos-db.md
+++ b/docs-ref-services/latest/cosmos-db.md
@@ -1,10 +1,10 @@
---
title: Azure Cosmos DB SDK for Java
description: Reference for Azure Cosmos DB SDK for Java
-ms.date: 08/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: cosmos-db
+ms.service: cosmosdb
---
# Azure Cosmos DB libraries for Java
diff --git a/docs-ref-services/latest/cost-management.md b/docs-ref-services/latest/cost-management.md
index 6e3e4bb16579..651710fcde3f 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/01/2025
+ms.date: 08/05/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 3e15d3d543f7..1f57c57bdac3 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/01/2025
+ms.date: 08/05/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 bd0ef2751c6c..d6163805fe2a 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/01/2025
+ms.date: 08/05/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 e419878dc792..7a73fb3d6c0f 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/01/2025
+ms.date: 08/05/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 f2a80d0a77e3..331af3ec1bb0 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/01/2025
+ms.date: 08/05/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 7c62833cdad4..093b2d987478 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/01/2025
+ms.date: 08/05/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 59efdb2ae6e4..420c817d8c91 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/01/2025
+ms.date: 08/05/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 43c87a87b5ef..1ae5dfd32868 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/01/2025
+ms.date: 08/05/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 ffcd7d5d08fc..07725c6a10ac 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/01/2025
+ms.date: 08/05/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 26d0879873dc..86ea0e10d9a2 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/01/2025
+ms.date: 08/05/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 6fbdbf87d230..58e952c5c033 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/01/2025
+ms.date: 08/05/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 b37c9d851a90..7e053d7aceda 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/01/2025
+ms.date: 08/05/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 9052038f0e43..60b6ec5fefc1 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/01/2025
+ms.date: 08/05/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 14c5ce95f843..fce6f7f8056a 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/01/2025
+ms.date: 08/05/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 931f00128b28..46f0eab48c7f 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/01/2025
+ms.date: 08/05/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 da167dea2b8e..8068a7f959f6 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/01/2025
+ms.date: 08/05/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 347827fe9746..e55d2e9c8f1b 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/01/2025
+ms.date: 08/05/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 d4753ab75798..0d2055ca909c 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/01/2025
+ms.date: 08/05/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 953a57921258..9dcbbe3c5c91 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/01/2025
+ms.date: 08/05/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 4d9349f94dc5..d01f032e4b0e 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/01/2025
+ms.date: 08/05/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 c434b11f318a..8880498a8cad 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/01/2025
+ms.date: 08/05/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 3c1296f6e176..71a9f1663b8e 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/01/2025
+ms.date: 08/05/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 b95a60a63f38..cd104e80320d 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/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-event-grid
diff --git a/docs-ref-services/latest/event-hubs.md b/docs-ref-services/latest/event-hubs.md
index e4bc8b471f47..faaa2ebb121f 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/01/2025
+ms.date: 08/05/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 4506227fb12e..70b666f9fd2a 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/01/2025
+ms.date: 08/05/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 3386c8df6edf..348f3221f46d 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/01/2025
+ms.date: 08/05/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 bd18988d988b..56ae7d4bac6d 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/01/2025
+ms.date: 08/05/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 ca2b669bec86..813b580bdc08 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/01/2025
+ms.date: 08/05/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 e378bd1f6be1..2adce067925a 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/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: azure-functions
diff --git a/docs-ref-services/latest/grafana.md b/docs-ref-services/latest/grafana.md
index add48c9c2155..26361c5d1aa7 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/01/2025
+ms.date: 08/05/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 3c1347183d97..74aebe893007 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/01/2025
+ms.date: 08/05/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 3817898bb5b0..ba6546a3dd41 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/01/2025
+ms.date: 08/05/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 16d109b0b942..cdbae21317e9 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/01/2025
+ms.date: 08/05/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 e4d8073afa83..243d31c99d09 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/01/2025
+ms.date: 08/05/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 fa683b72bc5e..98ccf029f191 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/01/2025
+ms.date: 08/05/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 c797b6602aeb..f8c65e65bc5e 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/01/2025
+ms.date: 08/05/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 7dfd1cc2915a..dd1115b49c32 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/01/2025
+ms.date: 08/05/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 5097a511ade9..488caaf5ced3 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/01/2025
+ms.date: 08/05/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 6b28690f08df..28b352a258aa 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/01/2025
+ms.date: 08/05/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 ed0e97210a66..bdd5a3ac157b 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/01/2025
+ms.date: 08/05/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 ad9be963abce..0305162b73de 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/01/2025
+ms.date: 08/05/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 76637e6f9719..3e36a961f99b 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/01/2025
+ms.date: 08/05/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 8eafa81516a1..be5e9fdaa3a8 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/01/2025
+ms.date: 08/05/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 ad621bbdf47c..b3afc73afd71 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/01/2025
+ms.date: 08/05/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 2e1ac177054b..189f13695659 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/01/2025
+ms.date: 08/05/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 72e5d90745fa..9f459688341e 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/01/2025
+ms.date: 08/05/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 d1e00aaf3c43..8f6bd17fa081 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/01/2025
+ms.date: 08/05/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 3143a8a60f8b..54a5ae0d73e5 100644
--- a/docs-ref-services/latest/lab-services.md
+++ b/docs-ref-services/latest/lab-services.md
@@ -1,7 +1,7 @@
---
title: Azure Lab Services SDK for Java
description: Reference for Azure Lab Services SDK for Java
-ms.date: 08/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: lab-services
diff --git a/docs-ref-services/latest/lambdatesthyperexecute.md b/docs-ref-services/latest/lambdatesthyperexecute.md
index bcfa2ab8e1c2..9f803104932e 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/01/2025
+ms.date: 08/05/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 ba37ed75a0e0..b3253f5364ed 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/01/2025
+ms.date: 08/05/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 378458839c7b..9f3a37a69ea1 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/01/2025
+ms.date: 08/05/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 e33abeb6f15f..b457d13c5270 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/01/2025
+ms.date: 08/05/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 abc0c3544d61..e04e687be1ef 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/01/2025
+ms.date: 08/05/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 36c157590bbd..bf3c68143bd5 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/01/2025
+ms.date: 08/05/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 0062cf1eea37..80aba921905a 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/01/2025
+ms.date: 08/05/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 c86f9a025d2e..ac0dc20bf401 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/01/2025
+ms.date: 08/05/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 a8c51d819232..92e38c68fad8 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/01/2025
+ms.date: 08/05/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 740307b3fe8b..607ba4e2b075 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/01/2025
+ms.date: 08/05/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 c82185d5228b..97e2b0450877 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/01/2025
+ms.date: 08/05/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 9359e3e8a4ae..3e6824e030c1 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/01/2025
+ms.date: 08/05/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 29d306f2504e..dad9ef3e4967 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/01/2025
+ms.date: 08/05/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 3849ae4164a1..8255e2749cff 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/01/2025
+ms.date: 08/05/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 6580f18eb1d4..73a21b3f8579 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/01/2025
+ms.date: 08/05/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 6f5afae2fdf2..821c30c177a7 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/01/2025
+ms.date: 08/05/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 25b3ab4a4787..2d9cbdb35447 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/01/2025
+ms.date: 08/05/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 c704d960f146..84c05d85a419 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/01/2025
+ms.date: 08/05/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 6bbe4ba52a17..9b6e1529680c 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 5f19ac6aff6f..4f6228270a6c 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/01/2025
+ms.date: 08/05/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 4b9382a0a804..92deb7023752 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/01/2025
+ms.date: 08/05/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 fae45989ed18..f00ff76d7d3c 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/01/2025
+ms.date: 08/05/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 5b3d926f5669..c5836b06b1ab 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/01/2025
+ms.date: 08/05/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 f1eef7936058..ba0514658331 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/01/2025
+ms.date: 08/05/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 48c40ba4e4dd..ae7083d00bc9 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/01/2025
+ms.date: 08/05/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 84f953da4414..4fd275fd3598 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/01/2025
+ms.date: 08/05/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 4244645ec353..ec3dc1dd9990 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/01/2025
+ms.date: 08/05/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 3a43138d2ceb..e85dbd292fca 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/01/2025
+ms.date: 08/05/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 741a00f73f37..d6d04b09cc58 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/01/2025
+ms.date: 08/05/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 fdd27bc90fff..28f21a80cf74 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/01/2025
+ms.date: 08/05/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 ee5357fae53f..7f376883ac48 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/01/2025
+ms.date: 08/05/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 a9a1b4057717..bc962b717c95 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/01/2025
+ms.date: 08/05/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 97922b195368..4b8e9e8445d0 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/01/2025
+ms.date: 08/05/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 e1a445f88543..5832d40f0bae 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/01/2025
+ms.date: 08/05/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 1dcf84274fcc..17a35552a25a 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/01/2025
+ms.date: 08/05/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 cad9dddc96f1..d6ffec8cd526 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/01/2025
+ms.date: 08/05/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 40926fc3fc30..57b4f38b6328 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/01/2025
+ms.date: 08/05/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 ed68e4bdc5e9..5db82d24d81e 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/01/2025
+ms.date: 08/05/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 946bee4ce3b7..bbf3ba2512e0 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/01/2025
+ms.date: 08/05/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 0d468ec57135..6bf57b504510 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/01/2025
+ms.date: 08/05/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 50d0d3ed5053..25a9efc49e41 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/01/2025
+ms.date: 08/05/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 845e06b8889e..e7410d8776b5 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/01/2025
+ms.date: 08/05/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 2c7f576c0c94..b89b2b205804 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/01/2025
+ms.date: 08/05/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 b97943008680..83949298a52d 100644
--- a/docs-ref-services/latest/redis.md
+++ b/docs-ref-services/latest/redis.md
@@ -1,7 +1,7 @@
---
title: Azure Redis SDK for Java
description: Reference for Azure Redis SDK for Java
-ms.date: 08/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: redis-cache
diff --git a/docs-ref-services/latest/reservations.md b/docs-ref-services/latest/reservations.md
index bd63a672f0bd..af6624496ac7 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/01/2025
+ms.date: 08/05/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 ee6f7fd085fd..db9133d74e4d 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/01/2025
+ms.date: 08/05/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 7de4e8bcfa3e..71c5a463ae44 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/01/2025
+ms.date: 08/05/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 baec47a9c4b0..fd02ca5c5350 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/01/2025
+ms.date: 08/05/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 a839f010a9fa..975ebca77821 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/01/2025
+ms.date: 08/05/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 649605788eb8..9f29794767bb 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/01/2025
+ms.date: 08/05/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 358ff88bda4a..0574639f9675 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/01/2025
+ms.date: 08/05/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 9e910b61452e..83ccd6d9ee2d 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/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: schemaregistry
+ms.service: schema-registry
---
# 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 63718ed69da0..a83c57bea4f6 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/01/2025
+ms.date: 08/05/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 7c960fe931b2..28988ff725bf 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/01/2025
+ms.date: 08/05/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 a3ca9d75bc49..bc570211bd10 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/01/2025
+ms.date: 08/05/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 020657d1de1f..7be3c471b7aa 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/01/2025
+ms.date: 08/05/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 1cceea4e6c54..b486f2bfa5c1 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/01/2025
+ms.date: 08/05/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 4a79fb28e676..a6ac4a028b68 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/01/2025
+ms.date: 08/05/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 706a15a0b58a..0886cd98e87e 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/01/2025
+ms.date: 08/05/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 b12eb33385a2..fe296e7040ce 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/01/2025
+ms.date: 08/05/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 f876e74dc930..2ad80c97ebe9 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/01/2025
+ms.date: 08/05/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 7ee04ad09433..dd40437eceba 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/01/2025
+ms.date: 08/05/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 2eb4cce72456..208c0d6a217d 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/01/2025
+ms.date: 08/05/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 ff089917e147..82a4a642d581 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/01/2025
+ms.date: 08/05/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 186e642d6620..77cada4d6802 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/01/2025
+ms.date: 08/05/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 832316eb1fbc..417432bc246e 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/01/2025
+ms.date: 08/05/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 ee7082c71f01..750e4ca4e6ad 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/01/2025
+ms.date: 08/05/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 cb65b44e825b..342885217199 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/01/2025
+ms.date: 08/05/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 639648802729..718a4d549fc6 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/01/2025
+ms.date: 08/05/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 88b223e05505..048c316ee59b 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/01/2025
+ms.date: 08/05/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 86dedbaaedef..be8572ad8800 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/01/2025
+ms.date: 08/05/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 500280044325..c70b51893f79 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/01/2025
+ms.date: 08/05/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 6404b83b5345..7fa02e775dd1 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/01/2025
+ms.date: 08/05/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 ee70237d4cc6..5c44e17dd237 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/01/2025
+ms.date: 08/05/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 bd04b3ba0995..7f8080f3b75e 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/01/2025
+ms.date: 08/05/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 4ff037db344b..62501c7a898d 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/01/2025
+ms.date: 08/05/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 3bbbbceac809..ae76f138770a 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/01/2025
+ms.date: 08/05/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 e819538a3209..7a248e8a7051 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/01/2025
+ms.date: 08/05/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 e632003dff7a..d24162ac1ad0 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/01/2025
+ms.date: 08/05/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 f85a781f5cdd..99ffb492fa33 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/01/2025
+ms.date: 08/05/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 afb4b1d06568..8d71cf1d3c19 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/01/2025
+ms.date: 08/05/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 ca0d9caea761..8ae76ed6aabe 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/01/2025
+ms.date: 08/05/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 f3e38a2535d0..27c8dab0f3e3 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/01/2025
+ms.date: 08/05/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 b6f4335460fa..38e8429aca97 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 5610198024bc..a13d439003f9 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/01/2025
+ms.date: 08/05/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 ca88962736a7..28a344702144 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/01/2025
+ms.date: 08/05/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 b35301105be8..f99665f2d76a 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/01/2025
+ms.date: 08/05/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 59cd812f72b7..44d2a0215bad 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/01/2025
+ms.date: 08/05/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 7aff13b1c073..cfc273a66db9 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/01/2025
+ms.date: 08/05/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 61f990ef47f0..af5e711cb349 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/01/2025
+ms.date: 08/05/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 fb75d6f4181c..ea428323114b 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/01/2025
+ms.date: 08/05/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 fd2facff579e..4b9601f60db2 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/01/2025
+ms.date: 08/05/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 71fe94acee0b..a639a1d87d75 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/01/2025
+ms.date: 08/05/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 b16eea8bce8a..6b886aa76960 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/01/2025
+ms.date: 08/05/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 81333b56d9e4..6e0bcc55989b 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/01/2025
+ms.date: 08/05/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 8f2f4da7118b..14fa79a995c6 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/01/2025
+ms.date: 08/05/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 38f68571da08..1d5f2bf959d1 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/01/2025
+ms.date: 08/05/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 57830ce9bc28..c9275829d953 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/01/2025
+ms.date: 08/05/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 e802512e00ba..5d958f5db7cb 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/01/2025
+ms.date: 08/05/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 67e9cbbacbea..04a426ef4656 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/01/2025
+ms.date: 08/05/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 d32d4851ed9c..d4b87a3b51f5 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/01/2025
+ms.date: 08/05/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 eff0ec1c31dd..1226b25601ba 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/01/2025
+ms.date: 08/05/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 9a66fbf1dc8e..316d7cbbdbb2 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/01/2025
+ms.date: 08/05/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 8a9e87770a8b..443ae9b075e3 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/01/2025
+ms.date: 08/05/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 20428af72f8f..cb9e5a33d932 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/01/2025
+ms.date: 08/05/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 ce8603db10d6..fad92111d95b 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/01/2025
+ms.date: 08/05/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 0ad995263b03..c68a1ba2b7e0 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/01/2025
+ms.date: 08/05/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 5b4dd9870ca6..ac740a0aba5e 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/01/2025
+ms.date: 08/05/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 8c394c612ecf..c15adb51a356 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/01/2025
+ms.date: 08/05/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 b55ff6b28bd7..349738f971ef 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/01/2025
+ms.date: 08/05/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 1231e04c8c6a..2ecd1ebfd5cb 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/01/2025
+ms.date: 08/05/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 291931f6651f..2d7df7bf638e 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/01/2025
+ms.date: 08/05/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 778eef73db51..dcdbdd8190d3 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/01/2025
+ms.date: 08/05/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 278bd1edfeb3..6022a3d48a76 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/01/2025
+ms.date: 08/05/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 a67badce6a91..8ec38e519cd2 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/01/2025
+ms.date: 08/05/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 3551f9af5007..cad132b42f3a 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/01/2025
+ms.date: 08/05/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 344112e0bcaa..67db5bd3e163 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/01/2025
+ms.date: 08/05/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 1cd66222ba6e..06198eea9149 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/01/2025
+ms.date: 08/05/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 f670477107f7..85c20a9f87eb 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/01/2025
+ms.date: 08/05/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 73b8a8102b37..98b06f0cb01f 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/01/2025
+ms.date: 08/05/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 fd2a6100afa7..59eee8f7508e 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/01/2025
+ms.date: 08/05/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 ff8742a19d1b..0eadbc514208 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/01/2025
+ms.date: 08/05/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 318706fe0607..d2b07079b6a3 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/01/2025
+ms.date: 08/05/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 d90df0852719..88a9f8a56fca 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/01/2025
+ms.date: 08/05/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 954e631c5555..95ea83787936 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/01/2025
+ms.date: 08/05/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 ba6471f1121c..859e8a6935b0 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/01/2025
+ms.date: 08/05/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 11274586d301..c58c793a5801 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/01/2025
+ms.date: 08/05/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 8f9dab392fea..7d7b3fc9ba49 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/01/2025
+ms.date: 08/05/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 16cbf8c4db86..cfb2f100aed4 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/01/2025
+ms.date: 08/05/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 7b75e9a125e4..e9092313a3de 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/01/2025
+ms.date: 08/05/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 8998d5264914..38f0bf54da36 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/04/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.20250804.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 000000000000..b0e5ee6a1287
--- /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/04/2025
+ms.topic: reference
+ms.devlang: java
+ms.service: anomalydetector
+---
+# Azure Anomaly Detector client library for Java - version 3.0.0-alpha.20250804.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-inference-readme.md b/docs-ref-services/preview/ai-inference-readme.md
index c4029c906828..bfb641ad57ab 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/04/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.20250804.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 20ca54db7633..5206fe5c9ae0 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/04/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.20250804.2
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 be8bf4c94da8..add7d6ba2701 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/04/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.20250804.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-translation-document-readme.md b/docs-ref-services/preview/ai-translation-document-readme.md
index ddcf69aa2531..d0e00730a864 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/04/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.20250804.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 8c11329617f8..0705f06a3104 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/04/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.20250804.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 d8bb86d0b4ad..a48f24090352 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/04/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.20250804.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 7126a47bc25c..0b3efe50db99 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/01/2025
+ms.date: 08/05/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 af00e938abc0..99229b3a0dd7 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/04/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.20250804.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 8608d5f8b001..71465e31178d 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/04/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.20250804.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 2e0f584bb707..51963822f457 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/04/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.20250804.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 f0fc481ffb63..bc73b3d310b1 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/04/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.20250804.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 79eb6a0765f5..eb885268b410 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/04/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.20250804.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 3f1f7beee056..e3fc9a659b8c 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/04/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.20250804.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 be4a5096a789..16f2bad06168 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/04/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.20250804.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 26a5b6bf2d6d..bbc7ecda4af3 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/01/2025
+ms.date: 08/05/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 52078200f43e..32484b691dce 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/01/2025
+ms.date: 08/05/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 c9aea629c817..895271c2a09e 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/01/2025
+ms.date: 08/05/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 312730f639bf..4c0b5e95bc3f 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/01/2025
+ms.date: 08/05/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 ff166b3f4c0f..f3bd4102fc61 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/01/2025
+ms.date: 08/05/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 f44aa8511068..316791ee956d 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/01/2025
+ms.date: 08/05/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 7dbf5a44f72c..48e1d6de679a 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/01/2025
+ms.date: 08/05/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 b6290c553cb9..f132dff75110 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/01/2025
+ms.date: 08/05/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 bd70092ecc1d..8bcfac306953 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 a895669e02b4..3b820506be2a 100644
--- a/docs-ref-services/preview/attestation.md
+++ b/docs-ref-services/preview/attestation.md
@@ -1,10 +1,10 @@
---
title: Azure Attestation SDK for Java
description: Reference for Azure Attestation SDK for Java
-ms.date: 08/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
-ms.service: azure-resource-manager
+ms.service: attestation
---
# Azure Attestation SDK for Java - preview
## Packages - preview
diff --git a/docs-ref-services/preview/automanage.md b/docs-ref-services/preview/automanage.md
index 82b57ac80ad0..34b899df625e 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/01/2025
+ms.date: 08/05/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 56f010901b29..ab9e1692e573 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/01/2025
+ms.date: 08/05/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 120d5c3ffbbd..b6c416493213 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/01/2025
+ms.date: 08/05/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 7bf32b3bfd21..82267caa4ee7 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/01/2025
+ms.date: 08/05/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 3cc5e4fd41b3..63b8623fc9b7 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/01/2025
+ms.date: 08/05/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 02afe8103797..bf8d5361a226 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/01/2025
+ms.date: 08/05/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 ba4accb5b328..a939caafbd06 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/01/2025
+ms.date: 08/05/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 a34d42e74fed..a71a2f10bcf9 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 000000000000..6e07030900fc
--- /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/04/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 cf691baf7616..3ff3aeda7ceb 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/01/2025
+ms.date: 08/05/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 6b1e75e5c51e..f94733b9a173 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/01/2025
+ms.date: 08/05/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 c8adedc752aa..575bf3da3819 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/01/2025
+ms.date: 08/05/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 08cf031541d1..aa380c57a9ad 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/01/2025
+ms.date: 08/05/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 b86a54f30186..0734486cb6ed 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/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: carbonoptimization
diff --git a/docs-ref-services/preview/cognitive-services-index.md b/docs-ref-services/preview/cognitive-services-index.md
index a78f4744b142..510d166c7eaf 100644
--- a/docs-ref-services/preview/cognitive-services-index.md
+++ b/docs-ref-services/preview/cognitive-services-index.md
@@ -1,6 +1,7 @@
| 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)|
|[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)|
diff --git a/docs-ref-services/preview/cognitive-services.md b/docs-ref-services/preview/cognitive-services.md
index e84737f26278..dc618d396c06 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/01/2025
+ms.date: 08/05/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 cdc3c75ee570..0818717884ba 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/01/2025
+ms.date: 08/05/2025
ms.topic: reference
ms.devlang: java
ms.service: commerce
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 000000000000..85f05e8b2e22
--- /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/04/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.20250804.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 14b5c18c3aad..e5d525b6d646 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/04/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.20250804.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-common-readme.md b/docs-ref-services/preview/communication-common-readme.md
index 2e6b5c034788..57a590ccb2f5 100644
--- a/docs-ref-services/preview/communication-common-readme.md
+++ b/docs-ref-services/preview/communication-common-readme.md
@@ -1,12 +1,12 @@
---
title: Azure Communication Service Common client library for Java
-keywords: Azure, java, SDK, API, azure-communication-common, communication
-ms.date: 03/27/2023
+keywords: Azure, java, SDK, API, azure-communication-common, communication/azure-communication-common
+ms.date: 08/04/2025
ms.topic: reference
ms.devlang: java
-ms.service: communication
+ms.service: communication/azure-communication-common
---
-# Azure Communication Service Common client library for Java - version 2.0.0-beta.1
+# Azure Communication Service Common client library for Java - version 1.5.0-alpha.20250804.1
Azure Communication Common contains data structures commonly used for communicating with Azure Communication Services.
@@ -17,14 +17,14 @@ It is intended to provide cross-cutting concerns, e.g. authentication.
### 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)](/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.
#### 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/azure-communication-common_2.0.0-beta.1/sdk/boms/azure-sdk-bom/README.md).
+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
@@ -60,7 +60,7 @@ add the direct dependency to your project as follows.
com.azureazure-communication-common
- 2.0.0-beta.1
+ 1.4.0
```
[//]: # ({x-version-update-end})
@@ -81,6 +81,7 @@ Depending on your scenario, you may want to initialize the `CommunicationTokenCr
- a static token (suitable for short-lived clients used to e.g. send one-off Chat messages) or
- a callback function that ensures a continuous authentication state (ideal e.g. for long Calling sessions).
+- a token credential capable of obtaining an Entra user token. You can provide any implementation of [Azure.Core.TokenCredential](https://learn.microsoft.com/es-es/java/api/com.azure.core.credential.tokencredential?view=azure-java-stable). It is suitable for scenarios where Entra user access tokens are needed to authenticate with Communication Services.
The tokens supplied to the `CommunicationTokenCredential` either through the constructor or via the token refresher callback can be obtained using the Azure Communication Identity library.
@@ -112,6 +113,52 @@ CommunicationTokenRefreshOptions tokenRefreshOptions = new CommunicationTokenRef
CommunicationTokenCredential tokenCredential = new CommunicationTokenCredential(tokenRefreshOptions);
```
+### Create a credential with a token credential capable of obtaining an Entra user token
+
+For scenarios where an Entra user can be used with Communication Services, you need to initialize any implementation of [Azure.Core.TokenCredential](https://learn.microsoft.com/es-es/java/api/com.azure.core.credential.tokencredential?view=azure-java-stable) and provide it to the `EntraCommunicationTokenCredentialOptions`.
+Along with this, you must provide the URI of the Azure Communication Services resource and the scopes required for the Entra user token. These scopes determine the permissions granted to the token.
+
+This approach needs to be used for authorizing an Entra user with a Teams license to use Teams Phone Extensibility features through your Azure Communication Services resource.
+This requires providing the `https://auth.msft.communication.azure.com/TeamsExtension.ManageCalls` scope.
+
+```java
+InteractiveBrowserCredential tokenCredential = new InteractiveBrowserCredentialBuilder()
+ .clientId("")
+ .tenantId("")
+ .redirectUrl("")
+ .build();
+String resourceEndpoint = "https://.communication.azure.com";
+List scopes = new ArrayList() {
+ {
+ add("https://auth.msft.communication.azure.com/TeamsExtension.ManageCalls");
+ }
+};
+
+EntraCommunicationTokenCredentialOptions entraTokenCredentialOptions = new EntraCommunicationTokenCredentialOptions(tokenCredential, resourceEndpoint).setScopes(scopes);
+CommunicationTokenCredential credential = new CommunicationTokenCredential(entraTokenCredentialOptions);
+```
+
+Other scenarios for Entra users to utilize Azure Communication Services are currently in the **preview stage only and should not be used in production**.
+The scopes for these scenarios follow the format `https://communication.azure.com/clients/`.
+If specific scopes are not provided, the default scopes will be set to `https://communication.azure.com/clients/.default`.
+
+```java
+InteractiveBrowserCredential tokenCredential = new InteractiveBrowserCredentialBuilder()
+ .clientId("")
+ .tenantId("")
+ .redirectUrl("")
+ .build();
+String resourceEndpoint = "https://.communication.azure.com";
+List scopes = new ArrayList() {
+ {
+ add("https://communication.azure.com/clients/VoIP");
+ }
+};
+
+EntraCommunicationTokenCredentialOptions entraTokenCredentialOptions = new EntraCommunicationTokenCredentialOptions(tokenCredential, resourceEndpoint).setScopes(scopes);
+CommunicationTokenCredential credential = new CommunicationTokenCredential(entraTokenCredentialOptions);
+```
+
## Troubleshooting
In progress.
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 000000000000..f0c4011c7f9d
--- /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/04/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.20250804.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 = "