From 65a48e937bc25b242fba9a82574ec1f3db70c99d Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 00:24:38 +0000 Subject: [PATCH 01/52] Update docs metadata --- .../resourcemanager-commerce-readme.md | 20 +++++++++---------- .../azure-resourcemanager-commerce.json | 19 +++++++++++++++--- 2 files changed, 26 insertions(+), 13 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-commerce-readme.md b/docs-ref-services/preview/resourcemanager-commerce-readme.md index 7154f126e5d14..566d77924272e 100644 --- a/docs-ref-services/preview/resourcemanager-commerce-readme.md +++ b/docs-ref-services/preview/resourcemanager-commerce-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager Usage client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-commerce, commerce -ms.date: 01/12/2023 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: commerce --- -# Azure Resource Manager Usage client library for Java - version 1.0.0-beta.2 +# Azure Resource Manager Usage client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager Usage client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-commerce - 1.0.0-beta.2 + 1.0.0-beta.3 ``` [//]: # ({x-version-update-end}) @@ -83,7 +83,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-commerce_1.0.0-beta.2/sdk/commerce/azure-resourcemanager-commerce/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/commerce/azure-resourcemanager-commerce/SAMPLE.md) ## Troubleshooting @@ -103,13 +103,13 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS [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-resourcemanager-commerce_1.0.0-beta.2/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-commerce_1.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-commerce_1.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-commerce_1.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-commerce_1.0.0-beta.2/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-commerce.json b/metadata/preview/azure-resourcemanager-commerce.json index f7dc06c3b459a..d6483b8e5b956 100644 --- a/metadata/preview/azure-resourcemanager-commerce.json +++ b/metadata/preview/azure-resourcemanager-commerce.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-commerce", - "Version": "1.0.0-beta.2", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/commerce/azure-resourcemanager-commerce", "ServiceDirectory": "commerce", "ReadMePath": "sdk/commerce/azure-resourcemanager-commerce/README.md", @@ -10,7 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-commerce", - "ReleaseStatus": "2023-01-12", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", + "safeName": "azureresourcemanagercommerce", + "name": "azure-resourcemanager-commerce", + "triggeringPaths": [ + "/sdk/commerce/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.commerce", "com.azure.resourcemanager.commerce.fluent", From 55cffb630c17f9c58b6937b0ae0ab7907a25b996 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 00:30:18 +0000 Subject: [PATCH 02/52] Update docs metadata --- ...ourcemanager-mysqlflexibleserver-readme.md | 22 +++++++++---------- ...e-resourcemanager-mysqlflexibleserver.json | 20 +++++++++++------ 2 files changed, 24 insertions(+), 18 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-mysqlflexibleserver-readme.md b/docs-ref-services/preview/resourcemanager-mysqlflexibleserver-readme.md index f88d0500d05c4..5ca4dec86f7b6 100644 --- a/docs-ref-services/preview/resourcemanager-mysqlflexibleserver-readme.md +++ b/docs-ref-services/preview/resourcemanager-mysqlflexibleserver-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager MySql client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-mysqlflexibleserver, mysqlflexibleserver -ms.date: 12/04/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: mysqlflexibleserver --- -# Azure Resource Manager MySql client library for Java - version 1.0.0-beta.6 +# Azure Resource Manager MySql client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager MySql client library for Java. -This package contains Microsoft Azure SDK for MySql Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2023-12-30. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for MySql Management SDK. The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules, VNET rules, log files and configurations with new business model. Package tag package-flexibleserver-2021-05-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-mysqlflexibleserver - 1.0.0-beta.6 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -88,7 +88,7 @@ server = mysqlManager.servers() .withAdministratorLoginPassword(adminPwd) .create(); ``` -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/SAMPLE.md) ## Troubleshooting @@ -110,12 +110,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-mysqlflexibleserver_1.0.0-beta.6/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-mysqlflexibleserver.json b/metadata/preview/azure-resourcemanager-mysqlflexibleserver.json index a9e162092d5c8..2a368b92f69c6 100644 --- a/metadata/preview/azure-resourcemanager-mysqlflexibleserver.json +++ b/metadata/preview/azure-resourcemanager-mysqlflexibleserver.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-mysqlflexibleserver", - "Version": "1.0.0-beta.6", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver", "ServiceDirectory": "mysqlflexibleserver", "ReadMePath": "sdk/mysqlflexibleserver/azure-resourcemanager-mysqlflexibleserver/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-mysqlflexibleserver", - "ReleaseStatus": "2024-12-04", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "name": "azure-resourcemanager-mysqlflexibleserver", + "safeName": "azureresourcemanagermysqlflexibleserver", "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagermysqlflexibleserver" + "triggeringPaths": [ + "/sdk/mysqlflexibleserver/ci.yml" + ], + "name": "azure-resourcemanager-mysqlflexibleserver" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.resourcemanager.mysqlflexibleserver", "com.azure.resourcemanager.mysqlflexibleserver.fluent", "com.azure.resourcemanager.mysqlflexibleserver.fluent.models", "com.azure.resourcemanager.mysqlflexibleserver.models" - ] + ], + "CIMatrixConfigs": [] } From 3020224a70e54ca8f1157dd20a48e33db488c2a5 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 00:32:19 +0000 Subject: [PATCH 03/52] Update docs metadata --- .../resourcemanager-edgeorder-readme.md | 20 +++++++++---------- .../azure-resourcemanager-edgeorder.json | 17 +++++++++++++--- 2 files changed, 24 insertions(+), 13 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-edgeorder-readme.md b/docs-ref-services/preview/resourcemanager-edgeorder-readme.md index e8f4870ba1e7e..c331d3542ec4b 100644 --- a/docs-ref-services/preview/resourcemanager-edgeorder-readme.md +++ b/docs-ref-services/preview/resourcemanager-edgeorder-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager EdgeOrder client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-edgeorder, edgeorder -ms.date: 10/06/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: edgeorder --- -# Azure Resource Manager EdgeOrder client library for Java - version 1.0.0-beta.2 +# Azure Resource Manager EdgeOrder client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager EdgeOrder client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-edgeorder - 1.0.0-beta.2 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-edgeorder_1.0.0-beta.2/sdk/edgeorder/azure-resourcemanager-edgeorder/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/edgeorder/azure-resourcemanager-edgeorder/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-edgeorder_1.0.0-beta.2/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-edgeorder_1.0.0-beta.2/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-edgeorder_1.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-edgeorder_1.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-edgeorder_1.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-edgeorder_1.0.0-beta.2/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-edgeorder.json b/metadata/preview/azure-resourcemanager-edgeorder.json index 4bad704d023b4..d51710ac03c68 100644 --- a/metadata/preview/azure-resourcemanager-edgeorder.json +++ b/metadata/preview/azure-resourcemanager-edgeorder.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-edgeorder", - "Version": "1.0.0-beta.2", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/edgeorder/azure-resourcemanager-edgeorder", "ServiceDirectory": "edgeorder", "ReadMePath": "sdk/edgeorder/azure-resourcemanager-edgeorder/README.md", @@ -10,9 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-edgeorder", - "ReleaseStatus": "2024-10-06", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", + "triggeringPaths": [ + "/sdk/edgeorder/ci.yml" + ], + "name": "azure-resourcemanager-edgeorder", + "safeName": "azureresourcemanageredgeorder" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.edgeorder", "com.azure.resourcemanager.edgeorder.fluent", From a96edc1b2e55afbd4c4f75268c3197a4fb672511 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 00:47:07 +0000 Subject: [PATCH 04/52] Update docs metadata --- .../resourcemanager-resourcemover-readme.md | 123 ++++++++++++++++++ .../azure-resourcemanager-resourcemover.json | 33 +++++ 2 files changed, 156 insertions(+) create mode 100644 docs-ref-services/preview/resourcemanager-resourcemover-readme.md create mode 100644 metadata/preview/azure-resourcemanager-resourcemover.json diff --git a/docs-ref-services/preview/resourcemanager-resourcemover-readme.md b/docs-ref-services/preview/resourcemanager-resourcemover-readme.md new file mode 100644 index 0000000000000..0c3413fe982e1 --- /dev/null +++ b/docs-ref-services/preview/resourcemanager-resourcemover-readme.md @@ -0,0 +1,123 @@ +--- +title: Azure Resource Manager ResourceMover client library for Java +keywords: Azure, java, SDK, API, azure-resourcemanager-resourcemover, resourcemover +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: resourcemover +--- +# Azure Resource Manager ResourceMover client library for Java - version 1.3.0-alpha.20251024.1 + + +Azure Resource Manager ResourceMover client library for Java. + +This package contains Microsoft Azure SDK for ResourceMover Management SDK. A first party Azure service orchestrating the move of Azure resources from one Azure region to another or between zones within a region. Package tag package-2023-08-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). + +## We'd love to hear your feedback + +We're always working on improving our products and the way we communicate with our users. So we'd love to learn what's working and how we can do better. + +If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together. + +Thank you in advance for your collaboration. We really appreciate your time! + +## Documentation + +Various documentation is available to help you get started + +- [API reference documentation][docs] + +## Getting started + +### Prerequisites + +- [Java Development Kit (JDK)][jdk] with version 8 or above +- [Azure Subscription][azure_subscription] + +### Adding the package to your product + +[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-resourcemover;current}) +```xml + + com.azure.resourcemanager + azure-resourcemanager-resourcemover + 1.3.0-beta.1 + +``` +[//]: # ({x-version-update-end}) + +### Include the recommended packages + +Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client. + +[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation. + +### Authentication + +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. + +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. + +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: + +```java +AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); +TokenCredential credential = new DefaultAzureCredentialBuilder() + .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) + .build(); +ResourceMoverManager manager = ResourceMoverManager + .authenticate(credential, profile); +``` + +The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. + +See [Authentication][authenticate] for more options. + +## Key concepts + +See [API design][design] for general introduction on design and key concepts on Azure Management Libraries. + +## Examples + +```java +moveCollection = resourceMoverManager.moveCollections() + .define(collectionName) + .withRegion(REGION) + .withExistingResourceGroup(resourceGroupName) + .withProperties(new MoveCollectionProperties().withSourceRegion(Region.US_WEST2.name()) + .withTargetRegion(Region.US_WEST.name())) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemover/azure-resourcemanager-resourcemover/SAMPLE.md) + + +## Troubleshooting + +## Next steps + +## Contributing + +For details on contributing to this repository, see the [contributing guide][cg]. + +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 . + +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 repositories 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 with any additional questions or comments. + + +[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS +[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/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + + diff --git a/metadata/preview/azure-resourcemanager-resourcemover.json b/metadata/preview/azure-resourcemanager-resourcemover.json new file mode 100644 index 0000000000000..7f9d1372f5020 --- /dev/null +++ b/metadata/preview/azure-resourcemanager-resourcemover.json @@ -0,0 +1,33 @@ +{ + "Name": "azure-resourcemanager-resourcemover", + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", + "DirectoryPath": "sdk/resourcemover/azure-resourcemanager-resourcemover", + "ServiceDirectory": "resourcemover", + "ReadMePath": "sdk/resourcemover/azure-resourcemanager-resourcemover/README.md", + "ChangeLogPath": "sdk/resourcemover/azure-resourcemanager-resourcemover/CHANGELOG.md", + "Group": "com.azure.resourcemanager", + "SdkType": "mgmt", + "IsNewSdk": true, + "ArtifactName": "azure-resourcemanager-resourcemover", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "name": "azure-resourcemanager-resourcemover", + "triggeringPaths": [ + "/sdk/resourcemover/ci.yml" + ], + "safeName": "azureresourcemanagerresourcemover", + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.resourcemanager.resourcemover", + "com.azure.resourcemanager.resourcemover.fluent", + "com.azure.resourcemanager.resourcemover.fluent.models", + "com.azure.resourcemanager.resourcemover.models" + ] +} From b32733d420bb037fd8dd313ca1ffca6f6c3d3752 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 00:55:15 +0000 Subject: [PATCH 05/52] Update docs metadata --- .../preview/resourcemanager-billing-readme.md | 35 +++++++++---------- .../azure-resourcemanager-billing.json | 19 ++++++++-- 2 files changed, 33 insertions(+), 21 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-billing-readme.md b/docs-ref-services/preview/resourcemanager-billing-readme.md index b1e8eb2a0a456..b31025e688ce1 100644 --- a/docs-ref-services/preview/resourcemanager-billing-readme.md +++ b/docs-ref-services/preview/resourcemanager-billing-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager Billing client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-billing, billing -ms.date: 01/12/2023 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: billing --- -# Azure Resource Manager Billing client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager Billing client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager Billing client library for Java. -This package contains Microsoft Azure SDK for Billing Management SDK. Billing client provides access to billing resources for Azure subscriptions. Package tag package-2020-05. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for Billing Management SDK. Billing Client. Package tag package-2024-04. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-billing - 1.0.0-beta.3 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -54,15 +54,11 @@ Azure Management Libraries require a `TokenCredential` implementation for authen ### Authentication -By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables. +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. -- `AZURE_CLIENT_ID` for Azure client ID. -- `AZURE_TENANT_ID` for Azure tenant ID. -- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate. +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. -In addition, Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. - -With above configuration, `azure` client can be authenticated using the following code: +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); @@ -83,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-billing_1.0.0-beta.3/sdk/billing/azure-resourcemanager-billing/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/billing/azure-resourcemanager-billing/SAMPLE.md) ## Troubleshooting @@ -103,13 +99,16 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS [docs]: https://azure.github.io/azure-sdk-for-java/ -[jdk]: /java/azure/jdk/ +[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-resourcemanager-billing_1.0.0-beta.3/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-billing_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-billing_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-billing_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-billing_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + diff --git a/metadata/preview/azure-resourcemanager-billing.json b/metadata/preview/azure-resourcemanager-billing.json index 9f89a32442b00..e0247ab8acaa3 100644 --- a/metadata/preview/azure-resourcemanager-billing.json +++ b/metadata/preview/azure-resourcemanager-billing.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-billing", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/billing/azure-resourcemanager-billing", "ServiceDirectory": "billing", "ReadMePath": "sdk/billing/azure-resourcemanager-billing/README.md", @@ -10,7 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-billing", - "ReleaseStatus": "2023-01-12", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "triggeringPaths": [ + "/sdk/billing/ci.yml" + ], + "name": "azure-resourcemanager-billing", + "safeName": "azureresourcemanagerbilling", + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.billing", "com.azure.resourcemanager.billing.fluent", From c1121a2fa83512d6116927a18252394d2fe8e4c7 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:02:33 +0000 Subject: [PATCH 06/52] Update docs metadata --- ...emanager-baremetalinfrastructure-readme.md | 22 +++++++++---------- ...sourcemanager-baremetalinfrastructure.json | 20 +++++++++++------ 2 files changed, 24 insertions(+), 18 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-baremetalinfrastructure-readme.md b/docs-ref-services/preview/resourcemanager-baremetalinfrastructure-readme.md index 6908afe475850..70e6a92655892 100644 --- a/docs-ref-services/preview/resourcemanager-baremetalinfrastructure-readme.md +++ b/docs-ref-services/preview/resourcemanager-baremetalinfrastructure-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager BareMetalInfrastructure client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-baremetalinfrastructure, baremetalinfrastructure -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: baremetalinfrastructure --- -# Azure Resource Manager BareMetalInfrastructure client library for Java - version 1.0.0-beta.4 +# Azure Resource Manager BareMetalInfrastructure client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager BareMetalInfrastructure client library for Java. -This package contains Microsoft Azure SDK for BareMetalInfrastructure Management SDK. The Bare Metal Infrastructure Management client. Package tag package-preview-2023-08. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for BareMetalInfrastructure Management SDK. The BareMetalInfrastructure Management client. Package tag package-2021-08-09. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-baremetalinfrastructure - 1.0.0-beta.4 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/sdk/baremetalinfrastructure/azure-resourcemanager-baremetalinfrastructure/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/baremetalinfrastructure/azure-resourcemanager-baremetalinfrastructure/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-baremetalinfrastructure_1.0.0-beta.4/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-baremetalinfrastructure.json b/metadata/preview/azure-resourcemanager-baremetalinfrastructure.json index 6f78052f857ff..2855b70ca6db8 100644 --- a/metadata/preview/azure-resourcemanager-baremetalinfrastructure.json +++ b/metadata/preview/azure-resourcemanager-baremetalinfrastructure.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-baremetalinfrastructure", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/baremetalinfrastructure/azure-resourcemanager-baremetalinfrastructure", "ServiceDirectory": "baremetalinfrastructure", "ReadMePath": "sdk/baremetalinfrastructure/azure-resourcemanager-baremetalinfrastructure/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-baremetalinfrastructure", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "name": "azure-resourcemanager-baremetalinfrastructure", "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerbaremetalinfrastructure" + "safeName": "azureresourcemanagerbaremetalinfrastructure", + "triggeringPaths": [ + "/sdk/baremetalinfrastructure/ci.yml" + ], + "name": "azure-resourcemanager-baremetalinfrastructure" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.resourcemanager.baremetalinfrastructure", "com.azure.resourcemanager.baremetalinfrastructure.fluent", "com.azure.resourcemanager.baremetalinfrastructure.fluent.models", "com.azure.resourcemanager.baremetalinfrastructure.models" - ] + ], + "CIMatrixConfigs": [] } From 1a46d98081230490d44306e6252a51ac7f3e157a Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:03:07 +0000 Subject: [PATCH 07/52] Update docs metadata --- .../preview/monitor-ingestion-readme.md | 268 ++++++++ ...itor-opentelemetry-autoconfigure-readme.md | 30 +- .../preview/monitor-query-logs-readme.md | 455 +++++++++++++ .../preview/monitor-query-metrics-readme.md | 295 ++++++++ .../preview/monitor-query-readme.md | 641 ++++++++++++++++++ metadata/preview/azure-monitor-ingestion.json | 36 + ...e-monitor-opentelemetry-autoconfigure.json | 15 +- .../preview/azure-monitor-query-logs.json | 36 + .../preview/azure-monitor-query-metrics.json | 36 + metadata/preview/azure-monitor-query.json | 24 +- 10 files changed, 1814 insertions(+), 22 deletions(-) create mode 100644 docs-ref-services/preview/monitor-ingestion-readme.md create mode 100644 docs-ref-services/preview/monitor-query-logs-readme.md create mode 100644 docs-ref-services/preview/monitor-query-metrics-readme.md create mode 100644 docs-ref-services/preview/monitor-query-readme.md create mode 100644 metadata/preview/azure-monitor-ingestion.json create mode 100644 metadata/preview/azure-monitor-query-logs.json create mode 100644 metadata/preview/azure-monitor-query-metrics.json diff --git a/docs-ref-services/preview/monitor-ingestion-readme.md b/docs-ref-services/preview/monitor-ingestion-readme.md new file mode 100644 index 0000000000000..2c8fc96e7609c --- /dev/null +++ b/docs-ref-services/preview/monitor-ingestion-readme.md @@ -0,0 +1,268 @@ +--- +title: Azure Monitor Ingestion client library for Java +keywords: Azure, java, SDK, API, azure-monitor-ingestion, monitor +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: monitor +--- +# Azure Monitor Ingestion client library for Java - version 1.3.0-alpha.20251024.1 + + +The Azure Monitor Ingestion client library is used to send custom logs to [Azure Monitor][azure_monitor_overview] using +the [Logs Ingestion API][ingestion_overview]. + +This library allows you to send data from virtually any source to supported built-in tables or to custom tables +that you create in Log Analytics workspace. You can even extend the schema of built-in tables with custom columns. + +## Getting started + +### Prerequisites +- A [Java Development Kit (JDK)][jdk_link], version 8 or later. + - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis). +- [Azure Subscription][azure_subscription] +- A [Data Collection Endpoint][data_collection_endpoint] +- A [Data Collection Rule][data_collection_rule] +- A [Log Analytics workspace][log_analytics_workspace] + +### Include the package + +#### Include the BOM file + +Please include the `azure-sdk-bom` to your project to take a dependency on the latest stable 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-monitor-ingestion + + +``` + +#### 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-monitor-ingestion;current}) +```xml + + com.azure + azure-monitor-ingestion + 1.2.11 + +``` +[//]: # ({x-version-update-end}) + +### Create the client + +An authenticated client is required to upload logs to Azure Monitor. The library includes both synchronous and asynchronous forms of the clients. To authenticate, +the following examples use `DefaultAzureCredentialBuilder` from the [azure-identity](https://central.sonatype.com/artifact/com.azure/azure-identity/1.8.1) package. + +#### Authenticating using Azure Active Directory +You can authenticate with Azure Active Directory using the [Azure Identity library][azure_identity]. + +After setup, you can choose which type of [credential][azure_identity_credential_type] from `azure-identity` to use. +We recommend using [DefaultAzureCredential][identity_dac], configured through the `AZURE_TOKEN_CREDENTIALS` environment variable. +Set this variable as described in the [Learn documentation][customize_defaultAzureCredential], which provides the most up-to-date guidance and examples. + +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.18.1 + +``` +[//]: # ({x-version-update-end}) + +#### Synchronous Logs Ingestion client + +```java readme-sample-createLogsIngestionClient +DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build(); + +LogsIngestionClient client = new LogsIngestionClientBuilder() + .endpoint("") + .credential(tokenCredential) + .buildClient(); +``` + +#### Asynchronous Logs Ingestion client + +```java readme-sample-createLogsIngestionAsyncClient +DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build(); + +LogsIngestionAsyncClient asyncClient = new LogsIngestionClientBuilder() + .endpoint("") + .credential(tokenCredential) + .buildAsyncClient(); +``` +## Key concepts + +### Data Collection Endpoint + +Data Collection Endpoints (DCEs) allow you to uniquely configure ingestion settings for Azure Monitor. [This +article][data_collection_endpoint] provides an overview of data collection endpoints including their contents and +structure and how you can create and work with them. + +### Data Collection Rule + +Data collection rules (DCR) define data collected by Azure Monitor and specify how and where that data should be sent or +stored. The REST API call must specify a DCR to use. A single DCE can support multiple DCRs, so you can specify a +different DCR for different sources and target tables. + +The DCR must understand the structure of the input data and the structure of the target table. If the two don't match, +it can use a transformation to convert the source data to match the target table. You may also use the transform to +filter source data and perform any other calculations or conversions. + +For more details, see [Data collection rules in Azure Monitor][data_collection_rule]. For information on how to retrieve +a DCR ID, see [this tutorial][data_collection_rule_tutorial]. + +### Log Analytics Workspace Tables + +Custom logs can send data to any custom table that you create and to certain built-in tables in your Log Analytics +workspace. The target table must exist before you can send data to it. The following built-in tables are currently supported: + +- [CommonSecurityLog](https://learn.microsoft.com/azure/azure-monitor/reference/tables/commonsecuritylog) +- [SecurityEvents](https://learn.microsoft.com/azure/azure-monitor/reference/tables/securityevent) +- [Syslog](https://learn.microsoft.com/azure/azure-monitor/reference/tables/syslog) +- [WindowsEvents](https://learn.microsoft.com/azure/azure-monitor/reference/tables/windowsevent) + +### Logs retrieval +The logs that were uploaded using this library can be queried using the +[Azure Monitor Query](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-query#readme) +client library. + +## Examples + +- [Upload custom logs](#upload-custom-logs) +- [Upload custom logs with max concurrency](#upload-custom-logs-with-max-concurrency) +- [Upload custom logs with error handling](#upload-custom-logs-with-error-handling) + +### Upload custom logs + +```java readme-sample-uploadLogs +DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build(); + +LogsIngestionClient client = new LogsIngestionClientBuilder() + .endpoint("") + .credential(tokenCredential) + .buildClient(); + +List logs = getLogs(); +client.upload("", "", logs); +System.out.println("Logs uploaded successfully"); +``` + +### Upload custom logs with max concurrency + +If the in input logs collection is too large, the client will split the input into multiple smaller requests. These +requests are sent serially, by default, but by configuring the max concurrency in `LogsUploadOptions`, these requests +can be concurrently sent to the service as shown in the example below. + +```java readme-sample-uploadLogsWithMaxConcurrency +DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build(); + +LogsIngestionClient client = new LogsIngestionClientBuilder() + .endpoint("") + .credential(tokenCredential) + .buildClient(); + +List logs = getLogs(); +LogsUploadOptions logsUploadOptions = new LogsUploadOptions() + .setMaxConcurrency(3); +client.upload("", "", logs, logsUploadOptions, + Context.NONE); +System.out.println("Logs uploaded successfully"); +``` + +### Upload custom logs with error handling + +When uploading large collection of logs, the client splits the input into multiple smaller service requests. The upload +method provides an option to handle individual service errors through an error handler as shown in the example below. +This error handler include the exception details and the list of all logs that failed to upload. If an error handler is +not provided, the upload method will throw an aggregate exception that includes all the service errors. + +```java readme-sample-uploadLogs-error-handler +DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build(); + +LogsIngestionClient client = new LogsIngestionClientBuilder() + .endpoint("") + .credential(tokenCredential) + .buildClient(); + +List logs = getLogs(); + +LogsUploadOptions logsUploadOptions = new LogsUploadOptions() + .setLogsUploadErrorConsumer(uploadLogsError -> { + System.out.println("Error message " + uploadLogsError.getResponseException().getMessage()); + System.out.println("Total logs failed to upload = " + uploadLogsError.getFailedLogs().size()); + + // throw the exception here to abort uploading remaining logs + // throw uploadLogsError.getResponseException(); + }); +client.upload("", "", logs, logsUploadOptions, + Context.NONE); +``` +## Troubleshooting + +For details on diagnosing various failure scenarios, see our [troubleshooting guide](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-ingestion/TROUBLESHOOTING.md). + +## Next steps +More samples can be found [here][samples]. + +## 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 [https://cla.microsoft.com](https://cla.microsoft.com). + +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](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. + + +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity +[azure_monitor_overview]: https://learn.microsoft.com/azure/azure-monitor/overview +[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 +[data_collection_endpoint]: https://learn.microsoft.com//azure/azure-monitor/essentials/data-collection-endpoint-overview +[data_collection_rule]: https://learn.microsoft.com/azure/azure-monitor/essentials/data-collection-rule-overview +[data_collection_rule_tutorial]: https://learn.microsoft.com/azure/azure-monitor/logs/tutorial-logs-ingestion-portal#collect-information-from-the-dcr +[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#defaultazurecredential +[ingestion_overview]: https://learn.microsoft.com/azure/azure-monitor/logs/logs-ingestion-api-overview +[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable +[log_analytics_workspace]: https://learn.microsoft.com//azure/azure-monitor/logs/log-analytics-workspace-overview +[logging]: https://learn.microsoft.com//azure/developer/java/sdk/logging-overview +[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-ingestion/src/samples/java/com/azure/monitor/ingestion +[customize_defaultAzureCredential]: https://aka.ms/azsdk/java/identity/credential-chains#how-to-customize-defaultazurecredential +[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[identity_dac]: https://aka.ms/azsdk/java/identity/credential-chains#defaultazurecredential-overview + diff --git a/docs-ref-services/preview/monitor-opentelemetry-autoconfigure-readme.md b/docs-ref-services/preview/monitor-opentelemetry-autoconfigure-readme.md index 597fb1bca2720..ec8254ef67b1f 100644 --- a/docs-ref-services/preview/monitor-opentelemetry-autoconfigure-readme.md +++ b/docs-ref-services/preview/monitor-opentelemetry-autoconfigure-readme.md @@ -1,17 +1,15 @@ --- title: Azure Monitor OpenTelemetry SDK Autoconfigure Distro for Application Insights in Java applications client library for Java keywords: Azure, java, SDK, API, azure-monitor-opentelemetry-autoconfigure, monitor -ms.date: 02/24/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: monitor --- -# Azure Monitor OpenTelemetry SDK Autoconfigure Distro for Application Insights in Java applications client library for Java - version 1.0.0-beta.3 +# Azure Monitor OpenTelemetry SDK Autoconfigure Distro for Application Insights in Java applications client library for Java - version 1.5.0-alpha.20251024.1 -This client library provides support for exporting OpenTelemetry data to Azure Monitor. This package assumes your -application is already instrumented with the [OpenTelemetry SDK][opentelemetry_sdk] following the [OpenTelemetry -Specification][opentelemetry_specification]. +This client library customizes the [OpenTelemetry SDK autoconfiguration][opentelemetry_autoconfiguration] for Azure Monitor. [Source code][source_code] | [Package (Maven)][package_mvn] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][sample_readme] @@ -150,7 +148,7 @@ For more information on the OpenTelemetry project, please review the [OpenTeleme ### Enabling Logging -You can leverage [Azure SDK logging](logging]. +You can leverage [Azure SDK logging][logging]. Examples: * [Log4j][log4j] @@ -158,6 +156,11 @@ Examples: Learn more about [OpenTelemetry SDK logging][logging_otel_sdk]. +### Disable live metrics + +You can disable the [live metrics][live_metrics] by setting the `APPLICATIONINSIGHTS_LIVE_METRICS_ENABLED` environment variable to false, the `applicationinsights.live.metrics.enabled` Java system property to false, +or programmatically with a properties supplier: `sdkBuilder.addPropertiesSupplier(() -> Collections.singletonMap("applicationinsights.live.metrics.enabled", "false"))`. + ## Next steps Learn more about [OpenTelemetry][opentelemetry_io] @@ -176,28 +179,29 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [jdk]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable -[samples]: https://github.com/Azure/azure-sdk-for-java/blob/azure-monitor-opentelemetry-autoconfigure_1.0.0-beta.3/sdk/monitor -[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/azure-monitor-opentelemetry-autoconfigure_1.0.0-beta.3/sdk/monitor/azure-monitor-opentelemetry-autoconfigure/src +[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor +[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-opentelemetry-autoconfigure/src [azure_subscription]: https://azure.microsoft.com/free/ [api_reference_doc]: https://learn.microsoft.com/azure/azure-monitor/overview [package_mvn]: https://central.sonatype.com/artifact/com.azure/azure-monitor-opentelemetry-autoconfigure [product_documentation]: https://learn.microsoft.com/azure/azure-monitor/overview [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/azure-monitor-opentelemetry-autoconfigure_1.0.0-beta.3/sdk/identity/azure-identity -[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-java/blob/azure-monitor-opentelemetry-autoconfigure_1.0.0-beta.3/sdk/identity/azure-identity/README.md#defaultazurecredential +[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 [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK [log4j]: https://github.com/Azure-Samples/ApplicationInsights-Java-Samples/blob/9a7344eeb44525dfc83df3a1bd59460b8a7d93c6/opentelemetry-api/exporter/TrackTrace/Log4j2/src/main/resources/log4j2.xml#L16 [logback]: https://github.com/Azure-Samples/ApplicationInsights-Java-Samples/blob/9a7344eeb44525dfc83df3a1bd59460b8a7d93c6/opentelemetry-api/exporter/TrackTrace/Logback/src/main/resources/logback.xml#L22 [logging_otel_sdk]: https://opentelemetry.io/docs/languages/java/sdk/#internal-logging -[opentelemetry_specification]: https://github.com/open-telemetry/opentelemetry-specification +[live_metrics]: https://learn.microsoft.com/azure/azure-monitor/app/live-stream +[opentelemetry_autoconfiguration]: https://opentelemetry.io/docs/languages/java/configuration/#zero-code-sdk-autoconfigure [application_insights_resource]: https://learn.microsoft.com/azure/azure-monitor/app/create-new-resource [application_insights_intro]: https://learn.microsoft.com/azure/azure-monitor/app/app-insights-overview [azure_portal]: https://ms.portal.azure.com/#blade/HubsExtension/BrowseResource/resourceType/microsoft.insights%2Fcomponents [opentelemetry_io]: https://opentelemetry.io/ [span_data]: https://opentelemetry.lightstep.com/spans -[sample_readme]: https://github.com/Azure/azure-sdk-for-java/tree/azure-monitor-opentelemetry-autoconfigure_1.0.0-beta.3/sdk/monitor/azure-monitor-opentelemetry-autoconfigure/src/samples +[sample_readme]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-opentelemetry-autoconfigure/src/samples [opentelemetry_spec]: https://opentelemetry.io/ [instrumentation_library]: https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md#instrumentation-libraries [tracer_provider]: https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/trace/sdk.md#tracer-provider @@ -206,7 +210,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [trace_concept]: https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/overview.md#trace [advanced_examples_1]: https://github.com/Azure-Samples/ApplicationInsights-Java-Samples/tree/main/opentelemetry-api/exporter/ [advanced_examples_2]: https://github.com/open-telemetry/opentelemetry-java-examples/tree/main/sdk-usage/src/main/java/io/opentelemetry/sdk/example -[event_hubs_example]: https://github.com/Azure/azure-sdk-for-java/blob/azure-monitor-opentelemetry-autoconfigure_1.0.0-beta.3/sdk/monitor/azure-monitor-opentelemetry-autoconfigure/src/samples/java/com/azure/monitor/opentelemetry/autoconfigure/EventHubsAzureMonitorExporterSample.java +[event_hubs_example]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-opentelemetry-autoconfigure/src/samples/java/com/azure/monitor/opentelemetry/autoconfigure/EventHubsAzureMonitorExporterSample.java [cla]: https://cla.microsoft.com [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/docs-ref-services/preview/monitor-query-logs-readme.md b/docs-ref-services/preview/monitor-query-logs-readme.md new file mode 100644 index 0000000000000..76eb295e57c25 --- /dev/null +++ b/docs-ref-services/preview/monitor-query-logs-readme.md @@ -0,0 +1,455 @@ +--- +title: Azure Monitor Logs Query client library for Java +keywords: Azure, java, SDK, API, azure-monitor-query-logs, monitor +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: monitor +--- +# Azure Monitor Logs Query client library for Java - version 1.1.0-alpha.20251024.1 + + +The Azure Monitor Logs Query client library is used to execute read-only queries against [Azure Monitor][azure_monitor_overview]'s logs data platform: + +- [Logs](https://learn.microsoft.com/azure/azure-monitor/logs/data-platform-logs) - Collects and organizes log and performance data from monitored resources. Data from different sources such as platform logs from Azure services, log and performance data from virtual machines agents, and usage and performance data from apps can be consolidated into a single [Azure Log Analytics workspace](https://learn.microsoft.com/azure/azure-monitor/logs/data-platform-logs#log-analytics-and-workspaces). The various data types can be analyzed together using the [Kusto Query Language][kusto_query_language]. + +**Resources:** + +- [Source code][source] +- [Package (Maven)][package] +- [API reference documentation][msdocs_apiref] +- [Service documentation][azure_monitor_overview] +- [Samples][samples] +- [Change log][changelog] + +## Getting started + +### Prerequisites + +- A [Java Development Kit (JDK)][jdk_link], version 8 or later + - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis). +- An [Azure subscription][azure_subscription] +- A [TokenCredential](https://learn.microsoft.com/java/api/com.azure.core.credential.tokencredential?view=azure-java-stable) implementation, such as an [Azure Identity library credential type](https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes). +- To query Logs, you need an [Azure Log Analytics workspace][azure_monitor_create_using_portal] or an Azure resource of any kind (Storage Account, Key Vault, Cosmos DB, etc.). + +### Include the package + +#### Include the BOM file + +Include the `azure-sdk-bom` to your project to take a dependency on the stable version of the library. In the following snippet, replace the `{bom_version_to_target}` placeholder with the version number. To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md). + +```xml + + + + com.azure + azure-sdk-bom + {bom_version_to_target} + pom + import + + + +``` + +Then include the direct dependency in the `dependencies` section without the version tag: + +```xml + + + com.azure + azure-monitor-query-logs + + +``` + +#### Include direct dependency + +If you want to take dependency on a particular version of the library that isn't present in the BOM, add the direct dependency to your project as follows. + +[//]: # ({x-version-update-start;com.azure:azure-monitor-query-logs;current}) + +```xml + + com.azure + azure-monitor-query-logs + 1.0.0 + +``` + +[//]: # ({x-version-update-end}) + +### Create the client + +An authenticated client is required to query Logs. The library includes both synchronous and asynchronous forms of the clients. To authenticate, the following examples use `DefaultAzureCredentialBuilder` from the [azure-identity](https://central.sonatype.com/artifact/com.azure/azure-identity/1.8.1) package. + +### Authenticate using Microsoft Entra ID + +You can authenticate with Microsoft Entra ID using the [Azure Identity library][azure_identity]. Regional endpoints don't support Microsoft Entra authentication. Create a [custom subdomain][custom_subdomain] for your resource to use this type of authentication. + +To use the [DefaultAzureCredential][DefaultAzureCredential] provider shown below, or other credential providers provided with the Azure Identity library, include the `azure-identity` package: + +[//]: # ({x-version-update-start;com.azure:azure-identity;dependency}) +```xml + + com.azure + azure-identity + 1.18.1 + +``` +[//]: # ({x-version-update-end}) + +Set the values of the client ID, tenant ID, and client secret of the Microsoft Entra application as environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`. + +#### Synchronous clients + +```java readme-sample-createLogsQueryClient +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); +``` + +#### Asynchronous clients + +```java readme-sample-createLogsQueryAsyncClient +LogsQueryAsyncClient logsQueryAsyncClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildAsyncClient(); +``` + +#### Configure client for Azure sovereign cloud + +By default, `LogsQueryClient` is configured to connect to the Azure Public Cloud. To use a sovereign cloud instead, set the correct endpoint in the client builders. + +- Creating a `LogsQueryClient` for Azure China Cloud: + + ```java readme-sample-createLogsQueryClientWithSovereignCloud + LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("https://api.loganalytics.azure.cn/v1") + .buildClient(); + ``` + +### Execute the query + +For examples of Logs queries, see the [Examples](#examples) section. + +## Key concepts + +### Logs query rate limits and throttling + +The Log Analytics service applies throttling when the request rate is too high. Limits, such as the maximum number of rows returned, are also applied on the Kusto queries. For more information, see [Query API](https://learn.microsoft.com/azure/azure-monitor/service-limits#la-query-api). + +## Examples + +- [Logs query](#logs-query) + - [Map logs query results to a model](#map-logs-query-results-to-a-model) + - [Handle logs query response](#handle-logs-query-response) + - [Query logs by resource ID](#query-logs-by-resource-id) +- [Batch logs query](#batch-logs-query) +- [Advanced logs query scenarios](#advanced-logs-query-scenarios) + - [Set logs query timeout](#set-logs-query-timeout) + - [Query multiple workspaces](#query-multiple-workspaces) + - [Include statistics](#include-statistics) + - [Include visualization](#include-visualization) + - [Overcome Log Analytics query size limitations](#overcome-log-analytics-query-size-limitations) + +### Logs query + +```java readme-sample-logsquery +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +LogsQueryResult queryResults = logsQueryClient.queryWorkspace("{workspace-id}", "{kusto-query}", + new LogsQueryTimeInterval(Duration.ofDays(2))); + +for (LogsTableRow row : queryResults.getTable().getRows()) { + System.out.println(row.getColumnValue("OperationName") + " " + row.getColumnValue("ResourceGroup")); +} +``` + +#### Map logs query results to a model + +```java readme-sample-custommodel +public class CustomLogModel { + private String resourceGroup; + private String operationName; + + public String getResourceGroup() { + return resourceGroup; + } + + public String getOperationName() { + return operationName; + } +} +``` + +```java readme-sample-logsquerycustommodel +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +List customLogModels = logsQueryClient.queryWorkspace("{workspace-id}", "{kusto-query}", + new LogsQueryTimeInterval(Duration.ofDays(2)), CustomLogModel.class); + +for (CustomLogModel customLogModel : customLogModels) { + System.out.println(customLogModel.getOperationName() + " " + customLogModel.getResourceGroup()); +} +``` + +#### Handle logs query response + +The `query` API returns the `LogsQueryResult`, while the `queryBatch` API returns the `LogsBatchQueryResult`. Here's a hierarchy of the response: + +``` +LogsQueryResult / LogsBatchQueryResult +|---id (this exists in `LogsBatchQueryResult` object only) +|---status (this exists in `LogsBatchQueryResult` object only) +|---statistics +|---visualization +|---error +|---tables (list of `LogsTable` objects) + |---name + |---rows (list of `LogsTableRow` objects) + |--- rowIndex + |--- rowCells (list of `LogsTableCell` objects) + |---columns (list of `LogsTableColumn` objects) + |---name + |---type +``` + +#### Query logs by resource ID + +The `LogsQueryClient` supports querying logs using a workspace ID (`queryWorkspace` methods) or a resource ID (`queryResource` methods). +See the following example of querying logs using a resource ID. Similar changes can be applied to all other samples. + +```java readme-sample-logsquerybyresourceid +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +LogsQueryResult queryResults = logsQueryClient.queryResource("{resource-id}", "{kusto-query}", + new LogsQueryTimeInterval(Duration.ofDays(2))); + +for (LogsTableRow row : queryResults.getTable().getRows()) { + System.out.println(row.getColumnValue("OperationName") + " " + row.getColumnValue("ResourceGroup")); +} +``` + +### Batch logs query + +```java readme-sample-batchlogsquery +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +LogsBatchQuery logsBatchQuery = new LogsBatchQuery(); +String query1 = logsBatchQuery.addWorkspaceQuery("{workspace-id}", "{query-1}", new LogsQueryTimeInterval(Duration.ofDays(2))); +String query2 = logsBatchQuery.addWorkspaceQuery("{workspace-id}", "{query-2}", new LogsQueryTimeInterval(Duration.ofDays(30))); +String query3 = logsBatchQuery.addWorkspaceQuery("{workspace-id}", "{query-3}", new LogsQueryTimeInterval(Duration.ofDays(10))); + +LogsBatchQueryResultCollection batchResults = logsQueryClient + .queryBatchWithResponse(logsBatchQuery, Context.NONE).getValue(); + +LogsBatchQueryResult query1Result = batchResults.getResult(query1); +for (LogsTableRow row : query1Result.getTable().getRows()) { + System.out.println(row.getColumnValue("OperationName") + " " + row.getColumnValue("ResourceGroup")); +} + +List customLogModels = batchResults.getResult(query2, CustomLogModel.class); +for (CustomLogModel customLogModel : customLogModels) { + System.out.println(customLogModel.getOperationName() + " " + customLogModel.getResourceGroup()); +} + +LogsBatchQueryResult query3Result = batchResults.getResult(query3); +if (query3Result.getQueryResultStatus() == LogsQueryResultStatus.FAILURE) { + System.out.println(query3Result.getError().getMessage()); +} +``` + +### Advanced logs query scenarios + +#### Set logs query timeout + +```java readme-sample-logsquerytimeout +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +// set request options: server timeout +LogsQueryOptions options = new LogsQueryOptions() + .setServerTimeout(Duration.ofMinutes(10)); + +Response response = logsQueryClient.queryWorkspaceWithResponse("{workspace-id}", + "{kusto-query}", new LogsQueryTimeInterval(Duration.ofDays(2)), options, Context.NONE); +``` + +#### Query multiple workspaces + +To run the same query against multiple Log Analytics workspaces, use the `LogsQueryOptions.setAdditionalWorkspaces` method. + +When multiple workspaces are included in the query, the logs in the result table aren't grouped according to the +workspace from which it was retrieved. To identify the workspace of a row in the result table, you can inspect the +"TenantId" column in the result table. If this column isn't in the table, then you may have to update your query string +to include this column. + +```java readme-sample-logsquerymultipleworkspaces +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +Response response = logsQueryClient.queryWorkspaceWithResponse("{workspace-id}", "{kusto-query}", + new LogsQueryTimeInterval(Duration.ofDays(2)), new LogsQueryOptions() + .setAdditionalWorkspaces(Arrays.asList("{additional-workspace-identifiers}")), + Context.NONE); +LogsQueryResult result = response.getValue(); +``` + +#### Include statistics + +To get logs query execution statistics, such as CPU and memory consumption: + +1. Use `LogsQueryOptions` to request for statistics in the response by setting `setIncludeStatistics()` to `true`. +2. Invoke the `getStatistics` method on the `LogsQueryResult` object. + +The following example prints the query execution time: +```java readme-sample-includestatistics +LogsQueryClient client = new LogsQueryClientBuilder() + .credential(credential) + .buildClient(); + +LogsQueryOptions options = new LogsQueryOptions() + .setIncludeStatistics(true); +Response response = client.queryWorkspaceWithResponse("{workspace-id}", + "AzureActivity | top 10 by TimeGenerated", LogsQueryTimeInterval.LAST_1_HOUR, options, Context.NONE); +LogsQueryResult result = response.getValue(); +BinaryData statistics = result.getStatistics(); + +ObjectMapper objectMapper = new ObjectMapper(); +JsonNode statisticsJson = objectMapper.readTree(statistics.toBytes()); +JsonNode queryStatistics = statisticsJson.get("query"); +System.out.println("Query execution time = " + queryStatistics.get("executionTime").asDouble()); +``` + +Because the structure of the statistics payload varies by query, a `BinaryData` return type is used. It contains the +raw JSON response. The statistics are found within the `query` property of the JSON. For example: + +```json +{ + "query": { + "executionTime": 0.0156478, + "resourceUsage": {...}, + "inputDatasetStatistics": {...}, + "datasetStatistics": [{...}] + } +} +``` + +#### Include visualization + +To get visualization data for logs queries using the [render operator](https://learn.microsoft.com/azure/data-explorer/kusto/query/renderoperator?pivots=azuremonitor): + +1. Use `LogsQueryOptions` to request for visualization data in the response by setting `setIncludeVisualization()` to `true`. +2. Invoke the `getVisualization` method on the `LogsQueryResult` object. + +For example: +```java readme-sample-includevisualization +LogsQueryClient client = new LogsQueryClientBuilder() + .credential(credential) + .buildClient(); + +String visualizationQuery = "StormEvents" + + "| summarize event_count = count() by State" + + "| where event_count > 10" + + "| project State, event_count" + + "| render columnchart"; +LogsQueryOptions options = new LogsQueryOptions() + .setIncludeVisualization(true); +Response response = client.queryWorkspaceWithResponse("{workspace-id}", visualizationQuery, + LogsQueryTimeInterval.LAST_7_DAYS, options, Context.NONE); +LogsQueryResult result = response.getValue(); +BinaryData visualization = result.getVisualization(); + +ObjectMapper objectMapper = new ObjectMapper(); +JsonNode visualizationJson = objectMapper.readTree(visualization.toBytes()); +System.out.println("Visualization graph type = " + visualizationJson.get("visualization").asText()); +``` + +Because the structure of the visualization payload varies by query, a `BinaryData` return type is used. It contains the +raw JSON response. For example: + +```json +{ + "visualization": "columnchart", + "title": null, + "accumulate": false, + "isQuerySorted": false, + "kind": null, + "legend": null, + "series": null, + "yMin": "", + "yMax": "", + "xAxis": null, + "xColumn": null, + "xTitle": null, + "yAxis": null, + "yColumns": null, + "ySplit": null, + "yTitle": null, + "anomalyColumns": null +} +``` + +#### Overcome Log Analytics query size limitations + +If your query exceeds the [service limits][service_limits], see the large log query documentation to learn how to overcome them. + +## Troubleshooting + +See our [troubleshooting guide](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query/TROUBLESHOOTING.md) +for details on how to diagnose various failure scenarios. + +## Next steps + +To learn more about Azure Monitor, see the [Azure Monitor service documentation][azure_monitor_overview]. + +## 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. + + + +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md +[azure_monitor_create_using_portal]: https://learn.microsoft.com/azure/azure-monitor/logs/quick-create-workspace +[azure_monitor_overview]: https://learn.microsoft.com/azure/azure-monitor/overview +[azure_subscription]: https://azure.microsoft.com/free/java +[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query/CHANGELOG.md +[custom_subdomain]: https://learn.microsoft.com/azure/cognitive-services/authentication?tabs=powershell#create-a-resource-with-a-custom-subdomain +[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#defaultazurecredential +[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable +[kusto_query_language]: https://learn.microsoft.com/azure/data-explorer/kusto/query/ +[log_levels]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java +[msdocs_apiref]: https://learn.microsoft.com/java/api/com.azure.monitor.query?view=azure-java-stable +[package]: https://central.sonatype.com/artifact/com.azure/azure-monitor-query-logs +[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-logs/src/samples/README.md +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-query-logs/src +[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning +[service_limits]: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language + +[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 + + + diff --git a/docs-ref-services/preview/monitor-query-metrics-readme.md b/docs-ref-services/preview/monitor-query-metrics-readme.md new file mode 100644 index 0000000000000..efde6dc9db20d --- /dev/null +++ b/docs-ref-services/preview/monitor-query-metrics-readme.md @@ -0,0 +1,295 @@ +--- +title: Azure Monitor Metrics Query client library for Java +keywords: Azure, java, SDK, API, azure-monitor-query-metrics, monitor +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: monitor +--- +# Azure Monitor Metrics Query client library for Java - version 1.1.0-alpha.20251024.1 + + +The Azure Monitor Metrics Query client library is used to execute read-only queries against [Azure Monitor][azure_monitor_overview]'s metrics data platform: + +- [Metrics](https://learn.microsoft.com/azure/azure-monitor/essentials/data-platform-metrics) - Collects numeric data from monitored resources into a time series database. Metrics are numerical values that are collected at regular intervals and describe some aspect of a system at a particular time. Metrics are lightweight and capable of supporting near real-time scenarios, making them useful for alerting and fast detection of issues. + +**Resources:** + +- [Source code][source] +- [Package (Maven)][package] +- [API reference documentation][msdocs_apiref] +- [Service documentation][azure_monitor_overview] +- [Samples][samples] +- [Change log][changelog] + +## Getting started + +### Prerequisites + +- A [Java Development Kit (JDK)][jdk_link], version 8 or later + - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis). +- An [Azure subscription][azure_subscription] +- A [TokenCredential](https://learn.microsoft.com/java/api/com.azure.core.credential.tokencredential?view=azure-java-stable) implementation, such as an [Azure Identity library credential type](https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes). +- To query Metrics, you need an Azure resource of any kind (Storage Account, Key Vault, Cosmos DB, etc.). + +### Include the package + +#### Include the BOM file + +Include the `azure-sdk-bom` to your project to take a dependency on the stable version of the library. In the following snippet, replace the `{bom_version_to_target}` placeholder with the version number. To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md). + +```xml + + + + com.azure + azure-sdk-bom + {bom_version_to_target} + pom + import + + + +``` + +Then include the direct dependency in the `dependencies` section without the version tag: + +```xml + + + com.azure + azure-monitor-query-metrics + + +``` + +#### Include direct dependency + +If you want to take dependency on a particular version of the library that isn't present in the BOM, add the direct dependency to your project as follows. + +[//]: # ({x-version-update-start;com.azure:azure-monitor-query-metrics;current}) + +```xml + + com.azure + azure-monitor-query-metrics + 1.0.0 + +``` + +[//]: # ({x-version-update-end}) + +### Authenticate using Microsoft Entra ID + +You can authenticate with Microsoft Entra ID using the [Azure Identity library][azure_identity]. Regional endpoints don't support Microsoft Entra authentication. Create a [custom subdomain][custom_subdomain] for your resource to use this type of authentication. + +To use the [DefaultAzureCredential][DefaultAzureCredential] provider shown below, or other credential providers provided with the Azure Identity library, include the `azure-identity` package: + +[//]: # ({x-version-update-start;com.azure:azure-identity;dependency}) +```xml + + com.azure + azure-identity + 1.18.1 + +``` +[//]: # ({x-version-update-end}) + +Set the values of the client ID, tenant ID, and client secret of the Microsoft Entra application as environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`. + +#### Synchronous clients + +```java readme-sample-createMetricsClient +MetricsClient metricsClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); +``` + +#### Asynchronous clients + +```java readme-sample-createMetricsAsyncClient +MetricsAsyncClient metricsAsyncClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildAsyncClient(); +``` + +#### Configure client for Azure sovereign cloud + +By default, `MetricsClient` is configured to connect to the Azure Public Cloud. To use a sovereign cloud instead, set the correct endpoint in the client builders. + +- Creating a `MetricsClient` for Azure China Cloud: + + ```java readme-sample-createSovereignMetricsClient + MetricsClient metricsClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("{china_cloud_endpoint}") + .audience(MetricsAudience.AZURE_CHINA) + .buildClient(); + ``` + +### Execute the query + +For examples of Metrics queries, see the [Examples](#examples) section. + +## Key concepts + +### Metrics data structure + +Each set of metric values is a time series with the following characteristics: + +- The time the value was collected +- The resource associated with the value +- A namespace that acts like a category for the metric +- A metric name +- The value itself +- Some metrics have multiple dimensions as described in multi-dimensional metrics. Custom metrics can have up to 10 dimensions. + +## Examples + +### Metrics query + +A resource ID, as denoted by the `{resource-uri}` placeholder in the following sample, is required to query metrics. To find the resource ID: + +1. Navigate to your resource's page in the Azure portal. +2. From the **Overview** blade, select the **JSON View** link. +3. In the resulting JSON, copy the value of the `id` property. + +### Metrics query resources + +```java readme-sample-metricsqueryresource +MetricsClient metricsClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +MetricsQueryResourcesResult metricsQueryResult = metricsClient.queryResources( + Arrays.asList("{resourceId}", "{resourceId2}"), + Arrays.asList("{metric1}", "{metric2}"), + "{metricNamespace}"); + +for (MetricsQueryResult queryResult : metricsQueryResult.getMetricsQueryResults()) { + System.out.println("Resource ID: " + queryResult.getResourceId()); + System.out.println("Metrics: " + queryResult.getMetrics().size() + "\n"); + // print out the metrics for each query result + for (MetricResult metric : queryResult.getMetrics()) { + System.out.println("Metric Name: " + metric.getMetricName()); + System.out.println("Unit: " + metric.getUnit()); + System.out.println("Time Series Count: " + metric.getTimeSeries().size()); + + metric.getTimeSeries().forEach(timeSeries -> { + timeSeries.getValues().forEach(value -> { + System.out.println("Timestamp: " + value.getTimeStamp() + + ", Total: " + value.getTotal() + + ", Average: " + value.getAverage() + + ", Count: " + value.getCount()); + }); + }); + } +} +``` + +#### Handle metrics query response + +The metrics query API returns a `MetricsQueryResult` object. The `MetricsQueryResult` object contains properties such as a list of `MetricResult`-typed objects, `granularity`, `namespace`, and `timeInterval`. The `MetricResult` objects list can be accessed using the `metrics` param. Each `MetricResult` object in this list contains a list of `TimeSeriesElement` objects. Each `TimeSeriesElement` contains `data` and `metadata_values` properties. In visual form, the object hierarchy of the response resembles the following structure: + +``` +MetricsQueryResult +|---granularity +|---timeInterval +|---cost +|---namespace +|---resourceRegion +|---metrics (list of `MetricResult` objects) + |---id + |---type + |---name + |---unit + |---timeSeries (list of `TimeSeriesElement` objects) + |---metadata (dimensions) + |---metricValues (list of data points represented by `MetricValue` objects) + |--- timeStamp + |--- count + |--- average + |--- total + |--- maximum + |--- minimum +``` + +#### Get average and count metrics + +```java readme-sample-metricsqueryaggregation +MetricsClient metricsClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +Response metricsResponse = metricsClient.queryResourcesWithResponse( + Arrays.asList("{resourceId}", "{resourceId2}"), + Arrays.asList("{metric1}", "{metric2}"), + "{metricNamespace}", + new MetricsQueryResourcesOptions() + .setGranularity(Duration.ofHours(1)) + .setAggregations(Arrays.asList(AggregationType.AVERAGE, AggregationType.COUNT)), + Context.NONE); + +MetricsQueryResourcesResult metricsQueryResult = metricsResponse.getValue(); + +for (MetricsQueryResult queryResult : metricsQueryResult.getMetricsQueryResults()) { + System.out.println("Resource ID: " + queryResult.getResourceId()); + System.out.println("Metrics: " + queryResult.getMetrics().size() + "\n"); + // print out the metrics for each query result + for (MetricResult metric : queryResult.getMetrics()) { + System.out.println("Metric Name: " + metric.getMetricName()); + System.out.println("Unit: " + metric.getUnit()); + System.out.println("Time Series Count: " + metric.getTimeSeries().size()); + + metric.getTimeSeries().forEach(timeSeries -> { + timeSeries.getValues().forEach(value -> { + System.out.println("Timestamp: " + value.getTimeStamp() + + ", Average: " + value.getAverage() + + ", Count: " + value.getCount()); + }); + }); + } +} +``` + +## Troubleshooting + +See our [troubleshooting guide](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-metrics/TROUBLESHOOTING.md) +for details on how to diagnose various failure scenarios. + +## Next steps + +To learn more about Azure Monitor, see the [Azure Monitor service documentation][azure_monitor_overview]. + +## 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. + + + +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md +[azure_monitor_overview]: https://learn.microsoft.com/azure/azure-monitor/overview +[azure_subscription]: https://azure.microsoft.com/free/java +[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-metrics/CHANGELOG.md +[custom_subdomain]: https://learn.microsoft.com/azure/cognitive-services/authentication?tabs=powershell#create-a-resource-with-a-custom-subdomain +[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#defaultazurecredential +[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable +[msdocs_apiref]: https://learn.microsoft.com/java/api/com.azure.monitor.query?view=azure-java-stable +[package]: https://central.sonatype.com/artifact/com.azure/azure-monitor-query-metrics +[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-metrics/src/samples/java/README.md +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-query-metrics/src + +[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 + + diff --git a/docs-ref-services/preview/monitor-query-readme.md b/docs-ref-services/preview/monitor-query-readme.md new file mode 100644 index 0000000000000..dd3db174c4ebb --- /dev/null +++ b/docs-ref-services/preview/monitor-query-readme.md @@ -0,0 +1,641 @@ +--- +title: Azure Monitor Query client library for Java +keywords: Azure, java, SDK, API, azure-monitor-query, monitor +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: monitor +--- +# Azure Monitor Query client library for Java - version 1.6.0-alpha.20251024.1 + + +> This package is deprecated in favor of the new libraries [azure-monitor-query-metrics](https://central.sonatype.com/artifact/com.azure/azure-monitor-query-metrics) +and [azure-monitor-query-logs](https://central.sonatype.com/artifact/com.azure/azure-monitor-query-logs), available as of August 2025. +While this package will continue to receive critical bug fixes, we strongly encourage you to upgrade. For transition support, read the migration +guides for [migrating to azure-monitor-query-logs](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-logs/migration-guide.md) +and [migrating to azure-monitor-query-metrics](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query-metrics/migration-guide.md). + +The Azure Monitor Query client library is used to execute read-only queries against [Azure Monitor][azure_monitor_overview]'s two data platforms: + +- [Logs](https://learn.microsoft.com/azure/azure-monitor/logs/data-platform-logs) - Collects and organizes log and performance data from monitored resources. Data from different sources such as platform logs from Azure services, log and performance data from virtual machines agents, and usage and performance data from apps can be consolidated into a single [Azure Log Analytics workspace](https://learn.microsoft.com/azure/azure-monitor/logs/data-platform-logs#log-analytics-and-workspaces). The various data types can be analyzed together using the [Kusto Query Language][kusto_query_language]. +- [Metrics](https://learn.microsoft.com/azure/azure-monitor/essentials/data-platform-metrics) - Collects numeric data from monitored resources into a time series database. Metrics are numerical values that are collected at regular intervals and describe some aspect of a system at a particular time. Metrics are lightweight and capable of supporting near real-time scenarios, making them useful for alerting and fast detection of issues. + +**Resources:** + +- [Source code][source] +- [Package (Maven)][package] +- [API reference documentation][msdocs_apiref] +- [Service documentation][azure_monitor_overview] +- [Samples][samples] +- [Change log][changelog] + +## Getting started + +### Prerequisites + +- A [Java Development Kit (JDK)][jdk_link], version 8 or later + - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis). +- An [Azure subscription][azure_subscription] +- A [TokenCredential](https://learn.microsoft.com/java/api/com.azure.core.credential.tokencredential?view=azure-java-stable) implementation, such as an [Azure Identity library credential type](https://learn.microsoft.com/java/api/overview/azure/identity-readme?view=azure-java-stable#credential-classes). +- To query Logs, you need an [Azure Log Analytics workspace][azure_monitor_create_using_portal] or an Azure resource of any kind (Storage Account, Key Vault, Cosmos DB, etc.). +- To query Metrics, you need an Azure resource of any kind (Storage Account, Key Vault, Cosmos DB, etc.). + +### Include the package + +#### Include the BOM file + +Include the `azure-sdk-bom` to your project to take a dependency on the stable version of the library. In the following snippet, replace the `{bom_version_to_target}` placeholder with the version number. To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md). + +```xml + + + + com.azure + azure-sdk-bom + {bom_version_to_target} + pom + import + + + +``` + +Then include the direct dependency in the `dependencies` section without the version tag: + +```xml + + + com.azure + azure-monitor-query + + +``` + +#### Include direct dependency + +If you want to take dependency on a particular version of the library that isn't present in the BOM, add the direct dependency to your project as follows. + +[//]: # ({x-version-update-start;com.azure:azure-monitor-query;current}) + +```xml + + com.azure + azure-monitor-query + 1.5.9 + +``` + +[//]: # ({x-version-update-end}) + +### Create the client + +An authenticated client is required to query Logs or Metrics. The library includes both synchronous and asynchronous forms of the clients. To authenticate, the following examples use `DefaultAzureCredentialBuilder` from the [azure-identity](https://central.sonatype.com/artifact/com.azure/azure-identity/1.8.1) package. + +### Authenticate using Microsoft Entra ID + +You can authenticate with Microsoft Entra ID using the [Azure Identity library][azure_identity]. Regional endpoints don't support Microsoft Entra authentication. Create a [custom subdomain][custom_subdomain] for your resource to use this type of authentication. + +To use the [DefaultAzureCredential][DefaultAzureCredential] provider shown below, or other credential providers provided with the Azure Identity library, include the `azure-identity` package: + +[//]: # ({x-version-update-start;com.azure:azure-identity;dependency}) +```xml + + com.azure + azure-identity + 1.18.1 + +``` +[//]: # ({x-version-update-end}) + +Set the values of the client ID, tenant ID, and client secret of the Microsoft Entra application as environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`. + +#### Synchronous clients + +```java readme-sample-createLogsQueryClient +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); +``` + +```java readme-sample-createMetricsQueryClient +MetricsQueryClient metricsQueryClient = new MetricsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); +``` + +```java readme-sample-createMetricsClient +MetricsClient metricsClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("{endpoint}") + .buildClient(); +``` + +#### Asynchronous clients + +```java readme-sample-createLogsQueryAsyncClient +LogsQueryAsyncClient logsQueryAsyncClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildAsyncClient(); +``` + +```java readme-sample-createMetricsQueryAsyncClient +MetricsQueryAsyncClient metricsQueryAsyncClient = new MetricsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildAsyncClient(); +``` + +```java readme-sample-createMetricsAsyncClient +MetricsAsyncClient metricsAsyncClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("{endpoint}") + .buildAsyncClient(); +``` + +#### Configure client for Azure sovereign cloud + +By default, `LogsQueryClient`, `MetricsQueryClient` and `MetricsClient` are configured to connect to the Azure Public Cloud. To use a sovereign cloud instead, set the correct endpoint in the client builders. +Additionally, for creating a `MetricsClient` instance, the audience should also be set in `MetricsClientBuilder` as shown in the sample below. + +- Creating a `LogsQueryClient` for Azure China Cloud: + + ```java readme-sample-createLogsQueryClientWithSovereignCloud + LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("https://api.loganalytics.azure.cn/v1") + .buildClient(); + ``` + +- Creating a `MetricsQueryClient` for Azure China Cloud: + + ```java readme-sample-createMetricsQueryClientWithSovereignCloud + MetricsQueryClient metricsQueryClient = new MetricsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("https://management.chinacloudapi.cn") + .buildClient(); + ``` + +- Creating a `MetricsClient` for Azure China Cloud: + + ```java readme-sample-createMetricsClientWithSovereignCloud + MetricsClient metricsClient = new MetricsClientBuilder() + .endpoint("") + .credential(new DefaultAzureCredentialBuilder().build()) + .audience(MetricsAudience.AZURE_CHINA) + .buildClient(); + ``` + +### Execute the query + +For examples of Logs and Metrics queries, see the [Examples](#examples) section. + +## Key concepts + +### Logs query rate limits and throttling + +The Log Analytics service applies throttling when the request rate is too high. Limits, such as the maximum number of rows returned, are also applied on the Kusto queries. For more information, see [Query API](https://learn.microsoft.com/azure/azure-monitor/service-limits#la-query-api). + +### Metrics data structure + +Each set of metric values is a time series with the following characteristics: + +- The time the value was collected +- The resource associated with the value +- A namespace that acts like a category for the metric +- A metric name +- The value itself +- Some metrics have multiple dimensions as described in multi-dimensional metrics. Custom metrics can have up to 10 dimensions. + +## Examples + +- [Logs query](#logs-query) + - [Map logs query results to a model](#map-logs-query-results-to-a-model) + - [Handle logs query response](#handle-logs-query-response) + - [Query logs by resource ID](#query-logs-by-resource-id) +- [Batch logs query](#batch-logs-query) +- [Advanced logs query scenarios](#advanced-logs-query-scenarios) + - [Set logs query timeout](#set-logs-query-timeout) + - [Query multiple workspaces](#query-multiple-workspaces) + - [Include statistics](#include-statistics) + - [Include visualization](#include-visualization) + - [Overcome Log Analytics query size limitations](#overcome-log-analytics-query-size-limitations) +- [Metrics query](#metrics-query) + - [Handle metrics query response](#handle-metrics-query-response) + - [Get average and count metrics](#get-average-and-count-metrics) +- [Metrics query resources](#metrics-query-resources) + - [Handle metrics query resources response](#handle-metrics-query-resources-response) + +### Logs query + +```java readme-sample-logsquery +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +LogsQueryResult queryResults = logsQueryClient.queryWorkspace("{workspace-id}", "{kusto-query}", + new QueryTimeInterval(Duration.ofDays(2))); + +for (LogsTableRow row : queryResults.getTable().getRows()) { + System.out.println(row.getColumnValue("OperationName") + " " + row.getColumnValue("ResourceGroup")); +} +``` + +#### Map logs query results to a model + +```java readme-sample-custommodel +public class CustomLogModel { + private String resourceGroup; + private String operationName; + + public String getResourceGroup() { + return resourceGroup; + } + + public String getOperationName() { + return operationName; + } +} +``` + +```java readme-sample-logsquerycustommodel +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +List customLogModels = logsQueryClient.queryWorkspace("{workspace-id}", "{kusto-query}", + new QueryTimeInterval(Duration.ofDays(2)), CustomLogModel.class); + +for (CustomLogModel customLogModel : customLogModels) { + System.out.println(customLogModel.getOperationName() + " " + customLogModel.getResourceGroup()); +} +``` + +#### Handle logs query response + +The `query` API returns the `LogsQueryResult`, while the `queryBatch` API returns the `LogsBatchQueryResult`. Here's a hierarchy of the response: + +``` +LogsQueryResult / LogsBatchQueryResult +|---id (this exists in `LogsBatchQueryResult` object only) +|---status (this exists in `LogsBatchQueryResult` object only) +|---statistics +|---visualization +|---error +|---tables (list of `LogsTable` objects) + |---name + |---rows (list of `LogsTableRow` objects) + |--- rowIndex + |--- rowCells (list of `LogsTableCell` objects) + |---columns (list of `LogsTableColumn` objects) + |---name + |---type +``` + +#### Query logs by resource ID + +The `LogsQueryClient` supports querying logs using a workspace ID (`queryWorkspace` methods) or a resource ID (`queryResource` methods). +See the following example of querying logs using a resource ID. Similar changes can be applied to all other samples. + +```java readme-sample-logsquerybyresourceid +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +LogsQueryResult queryResults = logsQueryClient.queryResource("{resource-id}", "{kusto-query}", + new QueryTimeInterval(Duration.ofDays(2))); + +for (LogsTableRow row : queryResults.getTable().getRows()) { + System.out.println(row.getColumnValue("OperationName") + " " + row.getColumnValue("ResourceGroup")); +} +``` + +### Batch logs query + +```java readme-sample-batchlogsquery +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +LogsBatchQuery logsBatchQuery = new LogsBatchQuery(); +String query1 = logsBatchQuery.addWorkspaceQuery("{workspace-id}", "{query-1}", new QueryTimeInterval(Duration.ofDays(2))); +String query2 = logsBatchQuery.addWorkspaceQuery("{workspace-id}", "{query-2}", new QueryTimeInterval(Duration.ofDays(30))); +String query3 = logsBatchQuery.addWorkspaceQuery("{workspace-id}", "{query-3}", new QueryTimeInterval(Duration.ofDays(10))); + +LogsBatchQueryResultCollection batchResults = logsQueryClient + .queryBatchWithResponse(logsBatchQuery, Context.NONE).getValue(); + +LogsBatchQueryResult query1Result = batchResults.getResult(query1); +for (LogsTableRow row : query1Result.getTable().getRows()) { + System.out.println(row.getColumnValue("OperationName") + " " + row.getColumnValue("ResourceGroup")); +} + +List customLogModels = batchResults.getResult(query2, CustomLogModel.class); +for (CustomLogModel customLogModel : customLogModels) { + System.out.println(customLogModel.getOperationName() + " " + customLogModel.getResourceGroup()); +} + +LogsBatchQueryResult query3Result = batchResults.getResult(query3); +if (query3Result.getQueryResultStatus() == LogsQueryResultStatus.FAILURE) { + System.out.println(query3Result.getError().getMessage()); +} +``` + +### Advanced logs query scenarios + +#### Set logs query timeout + +```java readme-sample-logsquerytimeout +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +// set request options: server timeout +LogsQueryOptions options = new LogsQueryOptions() + .setServerTimeout(Duration.ofMinutes(10)); + +Response response = logsQueryClient.queryWorkspaceWithResponse("{workspace-id}", + "{kusto-query}", new QueryTimeInterval(Duration.ofDays(2)), options, Context.NONE); +``` + +#### Query multiple workspaces + +To run the same query against multiple Log Analytics workspaces, use the `LogsQueryOptions.setAdditionalWorkspaces` method. + +When multiple workspaces are included in the query, the logs in the result table aren't grouped according to the +workspace from which it was retrieved. To identify the workspace of a row in the result table, you can inspect the +"TenantId" column in the result table. If this column isn't in the table, then you may have to update your query string +to include this column. + +```java readme-sample-logsquerymultipleworkspaces +LogsQueryClient logsQueryClient = new LogsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +Response response = logsQueryClient.queryWorkspaceWithResponse("{workspace-id}", "{kusto-query}", + new QueryTimeInterval(Duration.ofDays(2)), new LogsQueryOptions() + .setAdditionalWorkspaces(Arrays.asList("{additional-workspace-identifiers}")), + Context.NONE); +LogsQueryResult result = response.getValue(); +``` + +#### Include statistics + +To get logs query execution statistics, such as CPU and memory consumption: + +1. Use `LogsQueryOptions` to request for statistics in the response by setting `setIncludeStatistics()` to `true`. +2. Invoke the `getStatistics` method on the `LogsQueryResult` object. + +The following example prints the query execution time: +```java readme-sample-includestatistics +LogsQueryClient client = new LogsQueryClientBuilder() + .credential(credential) + .buildClient(); + +LogsQueryOptions options = new LogsQueryOptions() + .setIncludeStatistics(true); +Response response = client.queryWorkspaceWithResponse("{workspace-id}", + "AzureActivity | top 10 by TimeGenerated", QueryTimeInterval.LAST_1_HOUR, options, Context.NONE); +LogsQueryResult result = response.getValue(); +BinaryData statistics = result.getStatistics(); + +ObjectMapper objectMapper = new ObjectMapper(); +JsonNode statisticsJson = objectMapper.readTree(statistics.toBytes()); +JsonNode queryStatistics = statisticsJson.get("query"); +System.out.println("Query execution time = " + queryStatistics.get("executionTime").asDouble()); +``` + +Because the structure of the statistics payload varies by query, a `BinaryData` return type is used. It contains the +raw JSON response. The statistics are found within the `query` property of the JSON. For example: + +```json +{ + "query": { + "executionTime": 0.0156478, + "resourceUsage": {...}, + "inputDatasetStatistics": {...}, + "datasetStatistics": [{...}] + } +} +``` + +#### Include visualization + +To get visualization data for logs queries using the [render operator](https://learn.microsoft.com/azure/data-explorer/kusto/query/renderoperator?pivots=azuremonitor): + +1. Use `LogsQueryOptions` to request for visualization data in the response by setting `setIncludeVisualization()` to `true`. +2. Invoke the `getVisualization` method on the `LogsQueryResult` object. + +For example: +```java readme-sample-includevisualization +LogsQueryClient client = new LogsQueryClientBuilder() + .credential(credential) + .buildClient(); + +String visualizationQuery = "StormEvents" + + "| summarize event_count = count() by State" + + "| where event_count > 10" + + "| project State, event_count" + + "| render columnchart"; +LogsQueryOptions options = new LogsQueryOptions() + .setIncludeVisualization(true); +Response response = client.queryWorkspaceWithResponse("{workspace-id}", visualizationQuery, + QueryTimeInterval.LAST_7_DAYS, options, Context.NONE); +LogsQueryResult result = response.getValue(); +BinaryData visualization = result.getVisualization(); + +ObjectMapper objectMapper = new ObjectMapper(); +JsonNode visualizationJson = objectMapper.readTree(visualization.toBytes()); +System.out.println("Visualization graph type = " + visualizationJson.get("visualization").asText()); +``` + +Because the structure of the visualization payload varies by query, a `BinaryData` return type is used. It contains the +raw JSON response. For example: + +```json +{ + "visualization": "columnchart", + "title": null, + "accumulate": false, + "isQuerySorted": false, + "kind": null, + "legend": null, + "series": null, + "yMin": "", + "yMax": "", + "xAxis": null, + "xColumn": null, + "xTitle": null, + "yAxis": null, + "yColumns": null, + "ySplit": null, + "yTitle": null, + "anomalyColumns": null +} +``` + +#### Overcome Log Analytics query size limitations + +If your query exceeds the [service limits][service_limits], see the large log query documentation to learn how to overcome them. + +### Metrics query + +A resource ID, as denoted by the `{resource-uri}` placeholder in the following sample, is required to query metrics. To find the resource ID: + +1. Navigate to your resource's page in the Azure portal. +2. From the **Overview** blade, select the **JSON View** link. +3. In the resulting JSON, copy the value of the `id` property. + +```java readme-sample-metricsquery +MetricsQueryClient metricsQueryClient = new MetricsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +MetricsQueryResult metricsQueryResult = metricsQueryClient.queryResource("{resource-uri}", + Arrays.asList("SuccessfulCalls", "TotalCalls")); + +for (MetricResult metric : metricsQueryResult.getMetrics()) { + System.out.println("Metric name " + metric.getMetricName()); + for (TimeSeriesElement timeSeriesElement : metric.getTimeSeries()) { + System.out.println("Dimensions " + timeSeriesElement.getMetadata()); + for (MetricValue metricValue : timeSeriesElement.getValues()) { + System.out.println(metricValue.getTimeStamp() + " " + metricValue.getTotal()); + } + } +} +``` + +#### Handle metrics query response + +The metrics query API returns a `MetricsQueryResult` object. The `MetricsQueryResult` object contains properties such as a list of `MetricResult`-typed objects, `granularity`, `namespace`, and `timeInterval`. The `MetricResult` objects list can be accessed using the `metrics` param. Each `MetricResult` object in this list contains a list of `TimeSeriesElement` objects. Each `TimeSeriesElement` contains `data` and `metadata_values` properties. In visual form, the object hierarchy of the response resembles the following structure: + +``` +MetricsQueryResult +|---granularity +|---timeInterval +|---cost +|---namespace +|---resourceRegion +|---metrics (list of `MetricResult` objects) + |---id + |---type + |---name + |---unit + |---timeSeries (list of `TimeSeriesElement` objects) + |---metadata (dimensions) + |---metricValues (list of data points represented by `MetricValue` objects) + |--- timeStamp + |--- count + |--- average + |--- total + |--- maximum + |--- minimum +``` + +#### Get average and count metrics + +```java readme-sample-metricsqueryaggregation +MetricsQueryClient metricsQueryClient = new MetricsQueryClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +Response metricsResponse = metricsQueryClient + .queryResourceWithResponse("{resource-id}", Arrays.asList("SuccessfulCalls", "TotalCalls"), + new MetricsQueryOptions() + .setGranularity(Duration.ofHours(1)) + .setAggregations(Arrays.asList(AggregationType.AVERAGE, AggregationType.COUNT)), + Context.NONE); + +MetricsQueryResult metricsQueryResult = metricsResponse.getValue(); + +for (MetricResult metric : metricsQueryResult.getMetrics()) { + System.out.println("Metric name " + metric.getMetricName()); + for (TimeSeriesElement timeSeriesElement : metric.getTimeSeries()) { + System.out.println("Dimensions " + timeSeriesElement.getMetadata()); + for (MetricValue metricValue : timeSeriesElement.getValues()) { + System.out.println(metricValue.getTimeStamp() + " " + metricValue.getTotal()); + } + } +} +``` + +### Metrics query resources + +#### Handle metrics query resources response + +```java readme-sample-metricsquerymultipleresources +MetricsClient metricsClient = new MetricsClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint("{endpoint}") + .buildClient(); + +MetricsQueryResourcesResult metricsQueryResourcesResult = metricsClient.queryResources( + Arrays.asList("{resourceId1}", "{resourceId2}"), + Arrays.asList("{metric1}", "{metric2}"), + "{metricNamespace}"); + +for (MetricsQueryResult metricsQueryResult : metricsQueryResourcesResult.getMetricsQueryResults()) { + // Each MetricsQueryResult corresponds to one of the resourceIds in the batch request. + List metrics = metricsQueryResult.getMetrics(); + metrics.forEach(metric -> { + System.out.println(metric.getMetricName()); + System.out.println(metric.getId()); + System.out.println(metric.getResourceType()); + System.out.println(metric.getUnit()); + System.out.println(metric.getTimeSeries().size()); + System.out.println(metric.getTimeSeries().get(0).getValues().size()); + metric.getTimeSeries() + .stream() + .flatMap(ts -> ts.getValues().stream()) + .forEach(mv -> System.out.println(mv.getTimeStamp().toString() + + "; Count = " + mv.getCount() + + "; Average = " + mv.getAverage())); + }); +} +``` + +## Troubleshooting + +See our [troubleshooting guide](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query/TROUBLESHOOTING.md) +for details on how to diagnose various failure scenarios. + +## Next steps + +To learn more about Azure Monitor, see the [Azure Monitor service documentation][azure_monitor_overview]. + +## 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. + + + +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md +[azure_monitor_create_using_portal]: https://learn.microsoft.com/azure/azure-monitor/logs/quick-create-workspace +[azure_monitor_overview]: https://learn.microsoft.com/azure/azure-monitor/overview +[azure_subscription]: https://azure.microsoft.com/free/java +[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query/CHANGELOG.md +[custom_subdomain]: https://learn.microsoft.com/azure/cognitive-services/authentication?tabs=powershell#create-a-resource-with-a-custom-subdomain +[DefaultAzureCredential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#defaultazurecredential +[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable +[kusto_query_language]: https://learn.microsoft.com/azure/data-explorer/kusto/query/ +[log_levels]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java +[msdocs_apiref]: https://learn.microsoft.com/java/api/com.azure.monitor.query?view=azure-java-stable +[package]: https://central.sonatype.com/artifact/com.azure/azure-monitor-query +[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/monitor/azure-monitor-query/src/samples/java/README.md +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-query/src +[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning +[service_limits]: https://learn.microsoft.com/azure/azure-monitor/service-limits#log-queries-and-language + +[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 + + + diff --git a/metadata/preview/azure-monitor-ingestion.json b/metadata/preview/azure-monitor-ingestion.json new file mode 100644 index 0000000000000..e50c86962d24c --- /dev/null +++ b/metadata/preview/azure-monitor-ingestion.json @@ -0,0 +1,36 @@ +{ + "Name": "azure-monitor-ingestion", + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", + "DirectoryPath": "sdk/monitor/azure-monitor-ingestion", + "ServiceDirectory": "monitor", + "ReadMePath": "sdk/monitor/azure-monitor-ingestion/README.md", + "ChangeLogPath": "sdk/monitor/azure-monitor-ingestion/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-monitor-ingestion", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": [ + "com.azure:azure-monitor-query-perf", + "com.azure:azure-monitor-ingestion-perf", + "com.azure:perf-test-core" + ], + "ArtifactDetails": { + "groupId": "com.azure", + "name": "azure-monitor-ingestion", + "releaseInBatch": "${{ parameters.release_azuremonitoringestion }}", + "triggeringPaths": [ + "/sdk/monitor/ci.yml" + ], + "safeName": "azuremonitoringestion" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.monitor.ingestion", + "com.azure.monitor.ingestion.models" + ] +} diff --git a/metadata/preview/azure-monitor-opentelemetry-autoconfigure.json b/metadata/preview/azure-monitor-opentelemetry-autoconfigure.json index 3f23df69d18d8..8e6fe95b424bb 100644 --- a/metadata/preview/azure-monitor-opentelemetry-autoconfigure.json +++ b/metadata/preview/azure-monitor-opentelemetry-autoconfigure.json @@ -1,7 +1,7 @@ { "Name": "azure-monitor-opentelemetry-autoconfigure", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.5.0-alpha.20251024.1", + "DevVersion": "1.5.0-alpha.20251024.1", "DirectoryPath": "sdk/monitor/azure-monitor-opentelemetry-autoconfigure", "ServiceDirectory": "monitor", "ReadMePath": "sdk/monitor/azure-monitor-opentelemetry-autoconfigure/README.md", @@ -10,7 +10,7 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-monitor-opentelemetry-autoconfigure", - "ReleaseStatus": "2025-02-24", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": [ "com.azure:azure-monitor-query-perf", @@ -18,10 +18,13 @@ "com.azure:perf-test-core" ], "ArtifactDetails": { - "safeName": "azuremonitoropentelemetryautoconfigure", - "releaseInBatch": "${{ parameters.release_azuremonitoropentelemetryautoconfigure }}", + "groupId": "com.azure", "name": "azure-monitor-opentelemetry-autoconfigure", - "groupId": "com.azure" + "releaseInBatch": "${{ parameters.release_azuremonitoropentelemetryautoconfigure }}", + "triggeringPaths": [ + "/sdk/monitor/ci.yml" + ], + "safeName": "azuremonitoropentelemetryautoconfigure" }, "CIParameters": { "CIMatrixConfigs": [] diff --git a/metadata/preview/azure-monitor-query-logs.json b/metadata/preview/azure-monitor-query-logs.json new file mode 100644 index 0000000000000..e094ae1078c06 --- /dev/null +++ b/metadata/preview/azure-monitor-query-logs.json @@ -0,0 +1,36 @@ +{ + "Name": "azure-monitor-query-logs", + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", + "DirectoryPath": "sdk/monitor/azure-monitor-query-logs", + "ServiceDirectory": "monitor", + "ReadMePath": "sdk/monitor/azure-monitor-query-logs/README.md", + "ChangeLogPath": "sdk/monitor/azure-monitor-query-logs/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-monitor-query-logs", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": [ + "com.azure:azure-monitor-query-perf", + "com.azure:azure-monitor-ingestion-perf", + "com.azure:perf-test-core" + ], + "ArtifactDetails": { + "groupId": "com.azure", + "name": "azure-monitor-query-logs", + "releaseInBatch": "${{ parameters.release_azuremonitorquerylogs }}", + "triggeringPaths": [ + "/sdk/monitor/ci.yml" + ], + "safeName": "azuremonitorquerylogs" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.monitor.query.logs", + "com.azure.monitor.query.logs.models" + ] +} diff --git a/metadata/preview/azure-monitor-query-metrics.json b/metadata/preview/azure-monitor-query-metrics.json new file mode 100644 index 0000000000000..37a4c33d380b9 --- /dev/null +++ b/metadata/preview/azure-monitor-query-metrics.json @@ -0,0 +1,36 @@ +{ + "Name": "azure-monitor-query-metrics", + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", + "DirectoryPath": "sdk/monitor/azure-monitor-query-metrics", + "ServiceDirectory": "monitor", + "ReadMePath": "sdk/monitor/azure-monitor-query-metrics/README.md", + "ChangeLogPath": "sdk/monitor/azure-monitor-query-metrics/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-monitor-query-metrics", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": [ + "com.azure:azure-monitor-query-perf", + "com.azure:azure-monitor-ingestion-perf", + "com.azure:perf-test-core" + ], + "ArtifactDetails": { + "groupId": "com.azure", + "name": "azure-monitor-query-metrics", + "releaseInBatch": "${{ parameters.release_azuremonitorquerymetrics }}", + "triggeringPaths": [ + "/sdk/monitor/ci.yml" + ], + "safeName": "azuremonitorquerymetrics" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.monitor.query.metrics", + "com.azure.monitor.query.metrics.models" + ] +} diff --git a/metadata/preview/azure-monitor-query.json b/metadata/preview/azure-monitor-query.json index 3f6791749269b..70ea81019f924 100644 --- a/metadata/preview/azure-monitor-query.json +++ b/metadata/preview/azure-monitor-query.json @@ -1,7 +1,7 @@ { "Name": "azure-monitor-query", - "Version": "1.3.0-beta.3", - "DevVersion": null, + "Version": "1.6.0-alpha.20251024.1", + "DevVersion": "1.6.0-alpha.20251024.1", "DirectoryPath": "sdk/monitor/azure-monitor-query", "ServiceDirectory": "monitor", "ReadMePath": "sdk/monitor/azure-monitor-query/README.md", @@ -10,7 +10,25 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-monitor-query", - "ReleaseStatus": "2023-11-22", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": [ + "com.azure:azure-monitor-query-perf", + "com.azure:azure-monitor-ingestion-perf", + "com.azure:perf-test-core" + ], + "ArtifactDetails": { + "groupId": "com.azure", + "name": "azure-monitor-query", + "releaseInBatch": "${{ parameters.release_azuremonitorquery }}", + "triggeringPaths": [ + "/sdk/monitor/ci.yml" + ], + "safeName": "azuremonitorquery" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.monitor.query", "com.azure.monitor.query.models" From 3b11a8de74b019a8ccff8ae70ecad3ff310ccd91 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:05:42 +0000 Subject: [PATCH 08/52] Update docs metadata --- .../preview/developer-devcenter-readme.md | 131 ++++++++++++------ .../preview/azure-developer-devcenter.json | 23 ++- 2 files changed, 106 insertions(+), 48 deletions(-) diff --git a/docs-ref-services/preview/developer-devcenter-readme.md b/docs-ref-services/preview/developer-devcenter-readme.md index 0a64de4af24cc..b8cbacc9f81fe 100644 --- a/docs-ref-services/preview/developer-devcenter-readme.md +++ b/docs-ref-services/preview/developer-devcenter-readme.md @@ -1,12 +1,12 @@ --- title: Azure DevCenter client library for Java keywords: Azure, java, SDK, API, azure-developer-devcenter, devcenter -ms.date: 11/09/2023 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: devcenter --- -# Azure DevCenter client library for Java - version 1.0.0-beta.3 +# Azure DevCenter client library for Java - version 1.1.0-alpha.20251024.1 This package contains Microsoft Azure DevCenter client library. @@ -34,7 +34,7 @@ Various documentation is available to help you get started com.azure azure-developer-devcenter - 1.0.0-beta.3 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -57,74 +57,117 @@ DevCenterClient devCenterClient = .credential(new DefaultAzureCredentialBuilder().build()) .buildClient(); -DevBoxesClient devBoxClient = - new DevBoxesClientBuilder() - .endpoint(endpoint) - .credential(new DefaultAzureCredentialBuilder().build()) - .buildClient(); +DevBoxesClient devBoxClient = devCenterClient.getDevBoxesClient(); // Find available Projects and Pools -PagedIterable projectListResponse = devCenterClient.listProjects(null); -for (BinaryData p: projectListResponse) { - System.out.println(p); +PagedIterable projectListResponse = devCenterClient.listProjects(); +for (DevCenterProject project: projectListResponse) { + System.out.println(project.getName()); } -PagedIterable poolListResponse = devBoxClient.listPools("myProject", null); -for (BinaryData p: poolListResponse) { - System.out.println(p); +// Use the first project in the list +DevCenterProject project = projectListResponse.iterator().next(); +String projectName = project.getName(); + +PagedIterable poolListResponse = devBoxClient.listPools(projectName); +for (DevBoxPool pool: poolListResponse) { + System.out.println(pool.getName()); } +// Use the first pool in the list +DevBoxPool pool = poolListResponse.iterator().next(); +String poolName = pool.getName(); + +System.out.println("Starting to create dev box in project " + projectName + " and pool " + poolName); + // Provision a Dev Box -BinaryData devBoxBody = BinaryData.fromString("{\"poolName\":\"MyPool\"}"); -SyncPoller devBoxCreateResponse = - devBoxClient.beginCreateDevBox("myProject", "me", "MyDevBox", devBoxBody, null); +SyncPoller devBoxCreateResponse = + devBoxClient.beginCreateDevBox(projectName, "me", new DevBox("MyDevBox", poolName)); devBoxCreateResponse.waitForCompletion(); +DevBox devBox = devBoxCreateResponse.getFinalResult(); +String devBoxName = devBox.getName(); +System.out.println("DevBox " + devBoxName + "finished provisioning with status " + devBox.getProvisioningState()); -Response remoteConnectionResponse = - devBoxClient.getRemoteConnectionWithResponse("myProject", "me", "MyDevBox", null); -System.out.println(remoteConnectionResponse.getValue()); +RemoteConnection remoteConnection = + devBoxClient.getRemoteConnection(projectName, "me", devBoxName); +System.out.println("Dev Box web url is " + remoteConnection.getWebUrl()); +System.out.println("Start deleting dev box"); // Tear down the Dev Box when we're finished: -SyncPoller devBoxDeleteResponse = - devBoxClient.beginDeleteDevBox("myProject", "me", "MyDevBox", null); +SyncPoller devBoxDeleteResponse = + devBoxClient.beginDeleteDevBox(projectName, "me", devBoxName); devBoxDeleteResponse.waitForCompletion(); +System.out.println("Done deleting dev box"); ``` ### Environments Scenarios ```java com.azure.developer.devcenter.readme.environments -DeploymentEnvironmentsClient environmentsClient = - new DeploymentEnvironmentsClientBuilder() - .endpoint(endpoint) - .credential(new DefaultAzureCredentialBuilder().build()) - .buildClient(); +String endpoint = Configuration.getGlobalConfiguration().get("DEVCENTER_ENDPOINT"); + +// Build our clients +DevCenterClient devCenterClient = + new DevCenterClientBuilder() + .endpoint(endpoint) + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); + +DeploymentEnvironmentsClient environmentsClient = devCenterClient.getDeploymentEnvironmentsClient(); + +// Find available Projects +PagedIterable projectListResponse = devCenterClient.listProjects(); +for (DevCenterProject project: projectListResponse) { + System.out.println(project.getName()); +} + +// Use the first project in the list +DevCenterProject project = projectListResponse.iterator().next(); +String projectName = project.getName(); // Fetch available environment definitions and environment types -PagedIterable listCatalogsResponse = environmentsClient.listCatalogs("myProject", null); -for (BinaryData p: listCatalogsResponse) { - System.out.println(p); +PagedIterable catalogs = environmentsClient.listCatalogs(projectName); +for (DevCenterCatalog catalog: catalogs) { + System.out.println(catalog.getName()); } -PagedIterable environmentDefinitionsListResponse = environmentsClient.listEnvironmentDefinitionsByCatalog("myProject", "myCatalog", null); -for (BinaryData p: environmentDefinitionsListResponse) { - System.out.println(p); +// Use the first catalog in the list +String catalogName = catalogs.iterator().next().getName(); + +PagedIterable environmentDefinitions = environmentsClient.listEnvironmentDefinitionsByCatalog(projectName, catalogName); +for (EnvironmentDefinition environmentDefinition: environmentDefinitions) { + System.out.println(environmentDefinition.getName()); } -PagedIterable environmentTypesListResponse = environmentsClient.listEnvironmentTypes("myProject", null); -for (BinaryData p: environmentTypesListResponse) { - System.out.println(p); +// Use the first environment definition in the list +String envDefinitionName = environmentDefinitions.iterator().next().getName(); + +PagedIterable environmentTypes = environmentsClient.listEnvironmentTypes(projectName); +for (DevCenterEnvironmentType envType: environmentTypes) { + System.out.println(envType.getName()); } +// Use the first environment type in the list +String envTypeName = environmentTypes.iterator().next().getName(); + +System.out.println("Starting to create environment in project " + projectName + ", with catalog " + catalogName + + ", environment definition " + envDefinitionName + ", environment type " + envTypeName); + // Create an environment -BinaryData environmentBody = BinaryData.fromString("{\"environmentDefinitionName\":\"myEnvironmentDefinition\", \"environmentType\":\"myEnvironmentType\", \"catalogName\":\"myCatalog\"}"); -SyncPoller environmentCreateResponse = - environmentsClient.beginCreateOrUpdateEnvironment("myProject", "me", "TestEnvironment", environmentBody, null); +SyncPoller environmentCreateResponse + = environmentsClient.beginCreateOrUpdateEnvironment(projectName, "me", + new DevCenterEnvironment("myEnvironmentName", envTypeName, catalogName, envDefinitionName)); environmentCreateResponse.waitForCompletion(); +DevCenterEnvironment environment = environmentCreateResponse.getFinalResult(); + +String environmentName = environment.getName(); +System.out.println("Environment " + environmentName + "finished provisioning with status " + environment.getProvisioningState()); +System.out.println("Start deleting environment " + environmentName); // Delete the environment when we're finished: -SyncPoller environmentDeleteResponse = - environmentsClient.beginDeleteEnvironment("myProject", "me", "TestEnvironment", null); +SyncPoller environmentDeleteResponse = + environmentsClient.beginDeleteEnvironment(projectName, "me", environmentName); environmentDeleteResponse.waitForCompletion(); +System.out.println("Done deleting environment" + environmentName); ``` ## Troubleshooting @@ -133,7 +176,7 @@ environmentDeleteResponse.waitForCompletion(); ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-developer-devcenter_1.0.0-beta.3/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`) @@ -145,7 +188,7 @@ For details on contributing to this repository, see the [contributing guide](htt [environments_documentation]: https://learn.microsoft.com/azure/deployment-environments/ [devbox_documentation]: https://learn.microsoft.com/azure/dev-box/ [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-developer-devcenter_1.0.0-beta.3/sdk/identity/azure-identity +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity diff --git a/metadata/preview/azure-developer-devcenter.json b/metadata/preview/azure-developer-devcenter.json index b46f1e60ff2bd..45df4ffdcdb52 100644 --- a/metadata/preview/azure-developer-devcenter.json +++ b/metadata/preview/azure-developer-devcenter.json @@ -1,7 +1,7 @@ { "Name": "azure-developer-devcenter", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/devcenter/azure-developer-devcenter", "ServiceDirectory": "devcenter", "ReadMePath": "sdk/devcenter/azure-developer-devcenter/README.md", @@ -10,8 +10,23 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-developer-devcenter", - "ReleaseStatus": "2023-11-09", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "safeName": "azuredeveloperdevcenter", + "releaseInBatch": "${{ parameters.release_azuredeveloperdevcenter }}", + "triggeringPaths": [ + "/sdk/devcenter/ci.yml" + ], + "groupId": "com.azure", + "name": "azure-developer-devcenter" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ - "com.azure.developer.devcenter" + "com.azure.developer.devcenter", + "com.azure.developer.devcenter.models" ] } From 37387d5b287f2f1b6514f451c46195d01c80e154 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:10:24 +0000 Subject: [PATCH 09/52] Update docs metadata --- .../preview/resourcemanager-oep-readme.md | 20 +++++++++---------- .../preview/azure-resourcemanager-oep.json | 17 +++++++++++++--- 2 files changed, 24 insertions(+), 13 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-oep-readme.md b/docs-ref-services/preview/resourcemanager-oep-readme.md index 63aaaec73f28c..28527bbc75202 100644 --- a/docs-ref-services/preview/resourcemanager-oep-readme.md +++ b/docs-ref-services/preview/resourcemanager-oep-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager oep client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-oep, oep -ms.date: 10/09/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: oep --- -# Azure Resource Manager oep client library for Java - version 1.0.0-beta.2 +# Azure Resource Manager oep client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager oep client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-oep - 1.0.0-beta.2 + 1.0.0-beta.3 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-oep_1.0.0-beta.2/sdk/oep/azure-resourcemanager-oep/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/oep/azure-resourcemanager-oep/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-oep_1.0.0-beta.2/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-oep_1.0.0-beta.2/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-oep_1.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-oep_1.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-oep_1.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-oep_1.0.0-beta.2/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-oep.json b/metadata/preview/azure-resourcemanager-oep.json index 833ef02106277..85e84604e8622 100644 --- a/metadata/preview/azure-resourcemanager-oep.json +++ b/metadata/preview/azure-resourcemanager-oep.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-oep", - "Version": "1.0.0-beta.2", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/oep/azure-resourcemanager-oep", "ServiceDirectory": "oep", "ReadMePath": "sdk/oep/azure-resourcemanager-oep/README.md", @@ -10,9 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-oep", - "ReleaseStatus": "2024-10-09", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, + "ArtifactDetails": { + "name": "azure-resourcemanager-oep", + "safeName": "azureresourcemanageroep", + "triggeringPaths": [ + "/sdk/oep/ci.yml" + ], + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.oep", "com.azure.resourcemanager.oep.fluent", From 6f11274175550ebdd1d3aa38c10386157478e042 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:13:29 +0000 Subject: [PATCH 10/52] Update docs metadata --- ...esourcemanager-sqlvirtualmachine-readme.md | 20 +++++++++---------- ...ure-resourcemanager-sqlvirtualmachine.json | 20 ++++++++++++------- 2 files changed, 23 insertions(+), 17 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-sqlvirtualmachine-readme.md b/docs-ref-services/preview/resourcemanager-sqlvirtualmachine-readme.md index 313d35bae5d62..5c55a7891f0fd 100644 --- a/docs-ref-services/preview/resourcemanager-sqlvirtualmachine-readme.md +++ b/docs-ref-services/preview/resourcemanager-sqlvirtualmachine-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager SqlVirtualMachine client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-sqlvirtualmachine, sqlvirtualmachine -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: sqlvirtualmachine --- -# Azure Resource Manager SqlVirtualMachine client library for Java - version 1.0.0-beta.5 +# Azure Resource Manager SqlVirtualMachine client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager SqlVirtualMachine client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-sqlvirtualmachine - 1.0.0-beta.5 + 1.0.0-beta.6 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/sdk/sqlvirtualmachine/azure-resourcemanager-sqlvirtualmachine/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/sqlvirtualmachine/azure-resourcemanager-sqlvirtualmachine/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-sqlvirtualmachine_1.0.0-beta.5/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-sqlvirtualmachine.json b/metadata/preview/azure-resourcemanager-sqlvirtualmachine.json index 89c6cd318af29..f3d3fc7dece14 100644 --- a/metadata/preview/azure-resourcemanager-sqlvirtualmachine.json +++ b/metadata/preview/azure-resourcemanager-sqlvirtualmachine.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-sqlvirtualmachine", - "Version": "1.0.0-beta.5", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/sqlvirtualmachine/azure-resourcemanager-sqlvirtualmachine", "ServiceDirectory": "sqlvirtualmachine", "ReadMePath": "sdk/sqlvirtualmachine/azure-resourcemanager-sqlvirtualmachine/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-sqlvirtualmachine", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "name": "azure-resourcemanager-sqlvirtualmachine", + "triggeringPaths": [ + "/sdk/sqlvirtualmachine/ci.yml" + ], + "safeName": "azureresourcemanagersqlvirtualmachine", "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagersqlvirtualmachine" + "name": "azure-resourcemanager-sqlvirtualmachine" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.resourcemanager.sqlvirtualmachine", "com.azure.resourcemanager.sqlvirtualmachine.fluent", "com.azure.resourcemanager.sqlvirtualmachine.fluent.models", "com.azure.resourcemanager.sqlvirtualmachine.models" - ] + ], + "CIMatrixConfigs": [] } From ed876c079832930f093ddb6e03d6ac4d35ed4bd7 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:24:55 +0000 Subject: [PATCH 11/52] Update docs metadata --- .../preview/health-deidentification-readme.md | 12 ++++++------ metadata/preview/azure-health-deidentification.json | 10 +++++----- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs-ref-services/preview/health-deidentification-readme.md b/docs-ref-services/preview/health-deidentification-readme.md index b4f57d2b05d9a..b0a71e9758830 100644 --- a/docs-ref-services/preview/health-deidentification-readme.md +++ b/docs-ref-services/preview/health-deidentification-readme.md @@ -1,12 +1,12 @@ --- title: Azure Health Data Services de-identification service client library for Java keywords: Azure, java, SDK, API, azure-health-deidentification, healthdataaiservices -ms.date: 10/03/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: healthdataaiservices --- -# Azure Health Data Services de-identification service client library for Java - version 1.1.0-beta.1 +# Azure Health Data Services de-identification service client library for Java - version 1.1.0-alpha.20251024.1 This package contains a client library for the de-identification service in Azure Health Data Services which @@ -207,11 +207,11 @@ try { ``` ## Next steps -See the [samples] for several code snippets illustrating common patterns used in the de-identification service +See the [samples] for several code snippets illustrating common patterns used in the de-identification service Java SDK. For more extensive documentation, see the [de-identification service documentation][product_documentation]. ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-health-deidentification_1.1.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). [product_documentation]: https://learn.microsoft.com/azure/healthcare-apis/deidentification/ @@ -219,12 +219,12 @@ For details on contributing to this repository, see the [contributing guide](htt [jdk]: https://learn.microsoft.com/azure/developer/java/fundamentals/ [azure_subscription]: https://azure.microsoft.com/free/ [deid_quickstart]: https://learn.microsoft.com/azure/healthcare-apis/deidentification/quickstart -[string_index]: https://github.com/Azure/azure-sdk-for-java/blob/azure-health-deidentification_1.1.0-beta.1/sdk/healthdataaiservices/azure-health-deidentification/src/main/java/com/azure/health/deidentification/models/StringIndex.java +[string_index]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/healthdataaiservices/azure-health-deidentification/src/main/java/com/azure/health/deidentification/models/StringIndex.java [character_encoding]: https://learn.microsoft.com/dotnet/standard/base-types/character-encoding-introduction [deid_rbac]: https://learn.microsoft.com/azure/healthcare-apis/deidentification/manage-access-rbac [deid_configure_storage]: https://learn.microsoft.com/azure/healthcare-apis/deidentification/configure-storage [azure_identity]: https://learn.microsoft.com/azure/developer/java/sdk/identity [azure_cli]: https://learn.microsoft.com/cli/azure/healthcareapis/deidservice?view=azure-cli-latest [azure_portal]: https://ms.portal.azure.com -[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/azure-health-deidentification_1.1.0-beta.1/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java +[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java diff --git a/metadata/preview/azure-health-deidentification.json b/metadata/preview/azure-health-deidentification.json index 91f682f9bbcd8..f3aa9b08b2a95 100644 --- a/metadata/preview/azure-health-deidentification.json +++ b/metadata/preview/azure-health-deidentification.json @@ -1,7 +1,7 @@ { "Name": "azure-health-deidentification", - "Version": "1.1.0-beta.1", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/healthdataaiservices/azure-health-deidentification", "ServiceDirectory": "healthdataaiservices", "ReadMePath": "sdk/healthdataaiservices/azure-health-deidentification/README.md", @@ -10,16 +10,16 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-health-deidentification", - "ReleaseStatus": "2025-10-03", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "safeName": "azureaihealthdataaiservices", "triggeringPaths": [ "/sdk/healthdataaiservices/ci.yml" ], - "name": "azure-health-deidentification", "releaseInBatch": "${{ parameters.release_azureaihealthdataaiservices }}", + "name": "azure-health-deidentification", + "safeName": "azureaihealthdataaiservices", "groupId": "com.azure" }, "CIParameters": { From ddd931c87d67f39eb942ae91eb06242154d33a1d Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:25:27 +0000 Subject: [PATCH 12/52] Update docs metadata --- .../preview/resourcemanager-quota-readme.md | 32 +++++++++---------- .../preview/azure-resourcemanager-quota.json | 18 +++++++---- 2 files changed, 27 insertions(+), 23 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-quota-readme.md b/docs-ref-services/preview/resourcemanager-quota-readme.md index 0f36ab8ec88d6..4d953f0f0757a 100644 --- a/docs-ref-services/preview/resourcemanager-quota-readme.md +++ b/docs-ref-services/preview/resourcemanager-quota-readme.md @@ -1,17 +1,17 @@ --- -title: Azure Resource Manager quota client library for Java +title: Azure Resource Manager Quota client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-quota, quota -ms.date: 01/22/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: quota --- -# Azure Resource Manager quota client library for Java - version 1.1.0-beta.3 +# Azure Resource Manager Quota client library for Java - version 2.1.0-alpha.20251024.1 -Azure Resource Manager quota client library for Java. +Azure Resource Manager Quota client library for Java. -This package contains Microsoft Azure SDK for quota Management SDK. Microsoft Azure Quota Resource Provider. This Swagger is for Azure Group Quota using GroupQuota Entity. Package tag package-2024-12-18-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for Quota Management SDK. Microsoft Azure Quota Resource Provider. Package api-version 2025-09-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-quota - 1.1.0-beta.3 + 2.0.0 ``` [//]: # ({x-version-update-end}) @@ -61,7 +61,7 @@ Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java -AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); +AzureProfile profile = new AzureProfile(AzureCloud.AZURE_PUBLIC_CLOUD); TokenCredential credential = new DefaultAzureCredentialBuilder() .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) .build(); @@ -69,7 +69,7 @@ QuotaManager manager = QuotaManager .authenticate(credential, profile); ``` -The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. +The sample code assumes global Azure. Please change the `AzureCloud.AZURE_PUBLIC_CLOUD` variable if otherwise. See [Authentication][authenticate] for more options. @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-quota_1.1.0-beta.3/sdk/quota/azure-resourcemanager-quota/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/quota/azure-resourcemanager-quota/SAMPLE.md) ## Troubleshooting @@ -101,14 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-quota_1.1.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-quota_1.1.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-quota_1.1.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-quota_1.1.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-quota_1.1.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-quota_1.1.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ - - diff --git a/metadata/preview/azure-resourcemanager-quota.json b/metadata/preview/azure-resourcemanager-quota.json index c7b92571faa0e..96c13004e3bda 100644 --- a/metadata/preview/azure-resourcemanager-quota.json +++ b/metadata/preview/azure-resourcemanager-quota.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-quota", - "Version": "1.1.0-beta.3", - "DevVersion": null, + "Version": "2.1.0-alpha.20251024.1", + "DevVersion": "2.1.0-alpha.20251024.1", "DirectoryPath": "sdk/quota/azure-resourcemanager-quota", "ServiceDirectory": "quota", "ReadMePath": "sdk/quota/azure-resourcemanager-quota/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-quota", - "ReleaseStatus": "2025-01-22", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "safeName": "azureresourcemanagerquota", "name": "azure-resourcemanager-quota", - "groupId": "com.azure.resourcemanager" + "groupId": "com.azure.resourcemanager", + "triggeringPaths": [ + "/sdk/quota/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.resourcemanager.quota", "com.azure.resourcemanager.quota.fluent", "com.azure.resourcemanager.quota.fluent.models", "com.azure.resourcemanager.quota.models" - ] + ], + "CIMatrixConfigs": [] } From 5df304521108fb176881645ec6821a1361838b28 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:41:09 +0000 Subject: [PATCH 13/52] Update docs metadata --- .../preview/ai-contentsafety-readme.md | 196 +++++++++++------- metadata/preview/azure-ai-contentsafety.json | 20 +- 2 files changed, 135 insertions(+), 81 deletions(-) diff --git a/docs-ref-services/preview/ai-contentsafety-readme.md b/docs-ref-services/preview/ai-contentsafety-readme.md index 110433f206278..b528014b06a65 100644 --- a/docs-ref-services/preview/ai-contentsafety-readme.md +++ b/docs-ref-services/preview/ai-contentsafety-readme.md @@ -1,18 +1,18 @@ --- title: Azure ContentSafety client library for Java keywords: Azure, java, SDK, API, azure-ai-contentsafety, contentsafety -ms.date: 09/22/2023 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: contentsafety --- -# Azure ContentSafety client library for Java - version 1.0.0-beta.1 +# Azure ContentSafety client library for Java - version 1.1.0-alpha.20251024.1 [Azure AI Content Safety][contentsafety_overview] detects harmful user-generated and AI-generated content in applications and services. Content Safety includes several APIs that allow you to detect material that is harmful: -* Text Analysis API: Scans text for sexual content, violence, hate, and self harm with multi-severity levels. -* Image Analysis API: Scans images for sexual content, violence, hate, and self harm with multi-severity levels. +* Text Analysis API: Scans text for sexual content, violence, hate, and self-harm with multi-severity levels. +* Image Analysis API: Scans images for sexual content, violence, hate, and self-harm with multi-severity levels. * Text Blocklist Management APIs: The default AI classifiers are sufficient for most content safety needs; however, you might need to screen for terms that are specific to your use case. You can create blocklists of terms to use with the Text API. ## Documentation @@ -27,8 +27,8 @@ Various documentation is available to help you get started ### Prerequisites - [Java Development Kit (JDK)][jdk] with version 8 or above -- You need an [Azure subscription][azure_sub] to use this package. -- An existing [Azure AI Content Safety][contentsafety_overview] instance. +- You need an [Azure subscription][azure_subscription] to use this package. +- An [Azure AI Content Safety][contentsafety_overview] resource, if no existing resource, you could [create a new one](https://aka.ms/acs-create). ### Adding the package to your product @@ -37,7 +37,7 @@ Various documentation is available to help you get started com.azure azure-ai-contentsafety - 1.0.0-beta.1 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -59,53 +59,90 @@ The API key can be found in the [Azure Portal][azure_portal] or by running the f ```bash az cognitiveservices account keys list --name "" --resource-group "" ``` -#### Create a ContentSafetyClient with KeyCredential -```java com.azure.ai.contentsafety.createClient + +#### Create a ContentSafetyClient/BlocklistClient with KeyCredential +```java com.azure.ai.contentsafety.createclientcredential String endpoint = Configuration.getGlobalConfiguration().get("CONTENT_SAFETY_ENDPOINT"); String key = Configuration.getGlobalConfiguration().get("CONTENT_SAFETY_KEY"); - ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder() .credential(new KeyCredential(key)) .endpoint(endpoint).buildClient(); +BlocklistClient blocklistClient = new BlocklistClientBuilder() + .credential(new KeyCredential(key)) + .endpoint(endpoint).buildClient(); +``` +#### Create a ContentSafetyClient/BlocklistClient with Microsoft Entra ID (formerly Azure Active Directory (AAD)) token credential +- Step 1: Enable Microsoft Entra ID for your resource +Please refer to this Cognitive Services authentication document [Authenticate with Microsoft Entra ID.][authenticate_with_microsoft_entra_id] for the steps to enable AAD for your resource. + The main steps are: + - Create resource with a custom subdomain. + - Create Service Principal and assign Cognitive Services User role to it. + +- Step 2: Set the values of the client ID, tenant ID, and client secret of the Enable Microsoft Entra ID application as environment variables: `AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`. + +After setup, you can use [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#authenticate-with-defaultazurecredential) +can be used to authenticate the client. + +DefaultAzureCredential will use the values from these environment variables. +```java com.azure.ai.contentsafety.createclienttoken +ContentSafetyClient contentSafetyClientOauth = new ContentSafetyClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint(endpoint).buildClient(); +BlocklistClient blocklistClientOauth = new BlocklistClientBuilder() + .credential(new DefaultAzureCredentialBuilder().build()) + .endpoint(endpoint).buildClient(); ``` ## Key concepts -### Harm categories +### Available features +There are different types of analysis available from this service. The following table describes the currently available APIs. + +|Feature | Description | +|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +|Text Analysis API| Scans text for sexual content, violence, hate, and self-harm with multi-severity levels. | +|Image Analysis API| Scans images for sexual content, violence, hate, and self-harm with multi-severity levels. | +| Text Blocklist Management APIs| The default AI classifiers are sufficient for most content safety needs. However, you might need to screen for terms that are specific to your use case. You can create blocklists of terms to use with the Text API. | +### Harm categories Content Safety recognizes four distinct categories of objectionable content. -|Category |Description | +|Category|Description| |---------|---------| -|Hate |Hate refers to any content that attacks or uses pejorative or discriminatory language in reference to a person or identity group based on certain differentiating attributes of that group. This includes but is not limited to race, ethnicity, nationality, gender identity and expression, sexual orientation, religion, immigration status, ability status, personal appearance, and body size.| -|Sexual |Sexual describes content related to anatomical organs and genitals, romantic relationships, acts portrayed in erotic or affectionate terms, pregnancy, physical sexual acts—including those acts portrayed as an assault or a forced sexual violent act against one’s will—, prostitution, pornography, and abuse.| -|Violence |Violence describes content related to physical actions intended to hurt, injure, damage, or kill someone or something. It also includes weapons, guns and related entities, such as manufacturers, associations, legislation, and similar.| -|Self-harm |Self-harm describes content related to physical actions intended to purposely hurt, injure, or damage one’s body or kill oneself.| +|Hate |Hate and fairness-related harms refer to any content that attacks or uses pejorative or discriminatory language with reference to a person or identity group based on certain differentiating attributes of these groups including but not limited to race, ethnicity, nationality, gender identity and expression, sexual orientation, religion, immigration status, ability status, personal appearance, and body size.| +|Sexual |Sexual describes language related to anatomical organs and genitals, romantic relationships, acts portrayed in erotic or affectionate terms, pregnancy, physical sexual acts, including those portrayed as an assault or a forced sexual violent act against one's will, prostitution, pornography, and abuse.| +|Violence |Violence describes language related to physical actions intended to hurt, injure, damage, or kill someone or something; describes weapons, guns and related entities, such as manufactures, associations, legislation, and so on.| +|Self-harm |Self-harm describes language related to physical actions intended to purposely hurt, injure, damage one's body or kill oneself.| Classification can be multi-labeled. For example, when a text sample goes through the text moderation model, it could be classified as both Sexual content and Violence. ### Severity levels - Every harm category the service applies also comes with a severity level rating. The severity level is meant to indicate the severity of the consequences of showing the flagged content. -|Severity |Label | -|---------|---------| -|0 |Safe| -|2 |Low| -|4 |Medium| -|6 |High| +**Text**: The current version of the text model supports the **full 0-7 severity scale**. By default, the response will output 4 values: 0, 2, 4, and 6. Each two adjacent levels are mapped to a single level. Users could use "outputType" in request and set it as "EightSeverityLevels" to get 8 values in output: 0,1,2,3,4,5,6,7. +You can refer [text content severity levels definitions][text_severity_levels] for details. -### Text blocklist management +- [0,1] -> 0 +- [2,3] -> 2 +- [4,5] -> 4 +- [6,7] -> 6 -Following operations are supported to manage your text blocklist: +**Image**: The current version of the image model supports the **trimmed version of the full 0-7 severity scale**. The classifier only returns severities 0, 2, 4, and 6; each two adjacent levels are mapped to a single level. You can refer [image content severity levels definitions][image_severity_levels] for details. + +- [0,1] -> 0 +- [2,3] -> 2 +- [4,5] -> 4 +- [6,7] -> 6 -* Create or modify a blocklist -* List all blocklists -* Get a blocklist by blocklistName -* Add blockItems to a blocklist -* Remove blockItems from a blocklist -* List all blockItems in a blocklist by blocklistName -* Get a blockItem in a blocklist by blockItemId and blocklistName -* Delete a blocklist and all of its blockItems +### Text blocklist management +Following operations are supported to manage your text blocklist: +- Create or modify a blocklist +- List all blocklists +- Get a blocklist by blocklistName +- Add blockItems to a blocklist +- Remove blocklistItems from a blocklist +- List all blocklistItems in a blocklist by blocklistName +- Get a blocklistItem in a blocklist by blocklistItemId and blocklistName +- Delete a blocklist and all of its blocklistItems You can set the blocklists you want to use when analyze text, then you can get blocklist match result from returned response. @@ -128,18 +165,20 @@ ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder() AnalyzeTextResult response = contentSafetyClient.analyzeText(new AnalyzeTextOptions("This is text example")); -System.out.println("Hate severity: " + response.getHateResult().getSeverity()); -System.out.println("SelfHarm severity: " + response.getSelfHarmResult().getSeverity()); -System.out.println("Sexual severity: " + response.getSexualResult().getSeverity()); -System.out.println("Violence severity: " + response.getViolenceResult().getSeverity()); +for (TextCategoriesAnalysis result : response.getCategoriesAnalysis()) { + System.out.println(result.getCategory() + " severity: " + result.getSeverity()); +} ``` #### Analyze text with blocklists ```java com.azure.ai.contentsafety.analyzetextwithblocklist // After you edit your blocklist, it usually takes effect in 5 minutes, please wait some time before analyzing with blocklist after editing. +ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder() + .credential(new KeyCredential(key)) + .endpoint(endpoint).buildClient(); AnalyzeTextOptions request = new AnalyzeTextOptions("I h*te you and I want to k*ll you"); -request.getBlocklistNames().add(blocklistName); -request.setBreakByBlocklists(true); +request.setBlocklistNames(Arrays.asList(blocklistName)); +request.setHaltOnBlocklistHit(true); AnalyzeTextResult analyzeTextResult; try { @@ -149,11 +188,10 @@ try { throw ex; } -if (analyzeTextResult.getBlocklistsMatchResults() != null) { +if (analyzeTextResult.getBlocklistsMatch() != null) { System.out.println("\nBlocklist match result:"); - for (TextBlocklistMatchResult matchResult : analyzeTextResult.getBlocklistsMatchResults()) { - System.out.println("Blockitem was hit in text: Offset: " + matchResult.getOffset() + ", Length: " + matchResult.getLength()); - System.out.println("BlocklistName: " + matchResult.getBlocklistName() + ", BlockItemId: " + matchResult.getBlockItemId() + ", BlockItemText: " + matchResult.getBlockItemText()); + for (TextBlocklistMatch matchResult : analyzeTextResult.getBlocklistsMatch()) { + System.out.println("BlocklistName: " + matchResult.getBlocklistName() + ", BlockItemId: " + matchResult.getBlocklistItemId() + ", BlockItemText: " + matchResult.getBlocklistItemText()); } } ``` @@ -167,18 +205,17 @@ ContentSafetyClient contentSafetyClient = new ContentSafetyClientBuilder() .credential(new KeyCredential(key)) .endpoint(endpoint).buildClient(); -ImageData image = new ImageData(); +ContentSafetyImageData image = new ContentSafetyImageData(); String cwd = System.getProperty("user.dir"); -String source = "/src/samples/resources/image.jpg"; -image.setContent(Files.readAllBytes(Paths.get(cwd, source))); +String source = "/src/samples/resources/image.png"; +image.setContent(BinaryData.fromBytes(Files.readAllBytes(Paths.get(cwd, source)))); AnalyzeImageResult response = - contentSafetyClient.analyzeImage(new AnalyzeImageOptions(image)); + contentSafetyClient.analyzeImage(new AnalyzeImageOptions(image)); -System.out.println("Hate severity: " + response.getHateResult().getSeverity()); -System.out.println("SelfHarm severity: " + response.getSelfHarmResult().getSeverity()); -System.out.println("Sexual severity: " + response.getSexualResult().getSeverity()); -System.out.println("Violence severity: " + response.getViolenceResult().getSeverity()); +for (ImageCategoriesAnalysis result : response.getCategoriesAnalysis()) { + System.out.println(result.getCategory() + " severity: " + result.getSeverity()); +} ``` ### Manage text blocklist @@ -191,7 +228,7 @@ description.put("description", "Test Blocklist"); BinaryData resource = BinaryData.fromObject(description); RequestOptions requestOptions = new RequestOptions(); Response response = - contentSafetyClient.createOrUpdateTextBlocklistWithResponse(blocklistName, resource, requestOptions); + blocklistClient.createOrUpdateTextBlocklistWithResponse(blocklistName, resource, requestOptions); if (response.getStatusCode() == 201) { System.out.println("\nBlocklist " + blocklistName + " created."); } else if (response.getStatusCode() == 200) { @@ -202,57 +239,58 @@ if (response.getStatusCode() == 201) { ```java com.azure.ai.contentsafety.addblockitems String blockItemText1 = "k*ll"; String blockItemText2 = "h*te"; -List blockItems = Arrays.asList(new TextBlockItemInfo(blockItemText1).setDescription("Kill word"), - new TextBlockItemInfo(blockItemText2).setDescription("Hate word")); -AddBlockItemsResult addedBlockItems = contentSafetyClient.addBlockItems(blocklistName, new AddBlockItemsOptions(blockItems)); -if (addedBlockItems != null && addedBlockItems.getValue() != null) { +List blockItems = Arrays.asList(new TextBlocklistItem(blockItemText1).setDescription("Kill word"), + new TextBlocklistItem(blockItemText2).setDescription("Hate word")); +AddOrUpdateTextBlocklistItemsResult addedBlockItems = blocklistClient.addOrUpdateBlocklistItems(blocklistName, + new AddOrUpdateTextBlocklistItemsOptions(blockItems)); +if (addedBlockItems != null && addedBlockItems.getBlocklistItems() != null) { System.out.println("\nBlockItems added:"); - for (TextBlockItem addedBlockItem : addedBlockItems.getValue()) { - System.out.println("BlockItemId: " + addedBlockItem.getBlockItemId() + ", Text: " + addedBlockItem.getText() + ", Description: " + addedBlockItem.getDescription()); + for (TextBlocklistItem addedBlockItem : addedBlockItems.getBlocklistItems()) { + System.out.println("BlockItemId: " + addedBlockItem.getBlocklistItemId() + ", Text: " + addedBlockItem.getText() + ", Description: " + addedBlockItem.getDescription()); } } ``` #### List text blocklists ```java com.azure.ai.contentsafety.listtextblocklists -PagedIterable allTextBlocklists = contentSafetyClient.listTextBlocklists(); +PagedIterable allTextBlocklists = blocklistClient.listTextBlocklists(); System.out.println("\nList Blocklist:"); for (TextBlocklist blocklist : allTextBlocklists) { - System.out.println("Blocklist: " + blocklist.getBlocklistName() + ", Description: " + blocklist.getDescription()); + System.out.println("Blocklist: " + blocklist.getName() + ", Description: " + blocklist.getDescription()); } ``` #### Get text blocklist ```java com.azure.ai.contentsafety.gettextblocklist -TextBlocklist getBlocklist = contentSafetyClient.getTextBlocklist(blocklistName); +TextBlocklist getBlocklist = blocklistClient.getTextBlocklist(blocklistName); if (getBlocklist != null) { System.out.println("\nGet blocklist:"); - System.out.println("BlocklistName: " + getBlocklist.getBlocklistName() + ", Description: " + getBlocklist.getDescription()); + System.out.println("BlocklistName: " + getBlocklist.getName() + ", Description: " + getBlocklist.getDescription()); } ``` #### List blockItems ``` java com.azure.ai.contentsafety.listtextblocklistitems -PagedIterable allBlockitems = contentSafetyClient.listTextBlocklistItems(blocklistName); +PagedIterable allBlockitems = blocklistClient.listTextBlocklistItems(blocklistName); System.out.println("\nList BlockItems:"); -for (TextBlockItem blocklistItem : allBlockitems) { - System.out.println("BlockItemId: " + blocklistItem.getBlockItemId() + ", Text: " + blocklistItem.getText() + ", Description: " + blocklistItem.getDescription()); +for (TextBlocklistItem blocklistItem : allBlockitems) { + System.out.println("BlockItemId: " + blocklistItem.getBlocklistItemId() + ", Text: " + blocklistItem.getText() + ", Description: " + blocklistItem.getDescription()); } ``` #### Get blockItem ```java com.azure.ai.contentsafety.gettextblocklistitem -String getBlockItemId = addedBlockItems.getValue().get(0).getBlockItemId(); -TextBlockItem getBlockItem = contentSafetyClient.getTextBlocklistItem(blocklistName, getBlockItemId); +String getBlockItemId = addedBlockItems.getBlocklistItems().get(0).getBlocklistItemId(); +TextBlocklistItem getBlockItem = blocklistClient.getTextBlocklistItem(blocklistName, getBlockItemId); System.out.println("\nGet BlockItem:"); -System.out.println("BlockItemId: " + getBlockItem.getBlockItemId() + ", Text: " + getBlockItem.getText() + ", Description: " + getBlockItem.getDescription()); +System.out.println("BlockItemId: " + getBlockItem.getBlocklistItemId() + ", Text: " + getBlockItem.getText() + ", Description: " + getBlockItem.getDescription()); ``` #### Remove blockItems ```java com.azure.ai.contentsafety.removeblockitems -String removeBlockItemId = addedBlockItems.getValue().get(0).getBlockItemId(); +String removeBlockItemId = addedBlockItems.getBlocklistItems().get(0).getBlocklistItemId(); List removeBlockItemIds = new ArrayList<>(); removeBlockItemIds.add(removeBlockItemId); -contentSafetyClient.removeBlockItems(blocklistName, new RemoveBlockItemsOptions(removeBlockItemIds)); +blocklistClient.removeBlocklistItems(blocklistName, new RemoveTextBlocklistItemsOptions(removeBlockItemIds)); ``` #### Delete text blocklist ```java com.azure.ai.contentsafety.deletetextblocklist -contentSafetyClient.deleteTextBlocklist(blocklistName); +blocklistClient.deleteTextBlocklist(blocklistName); ``` ## Troubleshooting ### General @@ -271,11 +309,11 @@ Azure AI Content Safety client library will raise exceptions defined in [Azure C ## Next steps ### Additional documentation -For more extensive documentation on Azure Content Safety, see the [Azure AI Content Safety][contentsafety_overview] on docs.microsoft.com. +For more extensive documentation on Azure Content Safety, see the [Azure AI Content Safety][contentsafety_overview] on learn.microsoft.com. ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-contentsafety_1.0.0-beta.1/CONTRIBUTING.md). +For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md). 1. Fork it 1. Create your feature branch (`git checkout -b my-new-feature`) @@ -286,13 +324,15 @@ For details on contributing to this repository, see the [contributing guide](htt [product_documentation]: https://aka.ms/acs-doc [docs]: https://azure.github.io/azure-sdk-for-java/ -[jdk]: /java/azure/jdk/ +[jdk]: https://learn.microsoft.com/java/azure/jdk/ [azure_subscription]: https://azure.microsoft.com/free/ -[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-contentsafety_1.0.0-beta.1/sdk/identity/azure-identity +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity [contentsafety_overview]: https://aka.ms/acs-doc [azure_portal]: https://ms.portal.azure.com/ -[azure_cli_endpoint_lookup]: /cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show -[azure_cli_key_lookup]: /cli/azure/cognitiveservices/account/keys?view=azure-cli-latest#az-cognitiveservices-account-keys-list - +[azure_cli_endpoint_lookup]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show +[azure_cli_key_lookup]: https://learn.microsoft.com/cli/azure/cognitiveservices/account/keys?view=azure-cli-latest#az-cognitiveservices-account-keys-list +[authenticate_with_microsoft_entra_id]: https://learn.microsoft.com/azure/ai-services/authentication?tabs=powershell#authenticate-with-microsoft-entra-id +[text_severity_levels]: https://learn.microsoft.com/azure/ai-services/content-safety/concepts/harm-categories?tabs=definitions#text-content +[image_severity_levels]: https://learn.microsoft.com/azure/ai-services/content-safety/concepts/harm-categories?tabs=definitions#image-content diff --git a/metadata/preview/azure-ai-contentsafety.json b/metadata/preview/azure-ai-contentsafety.json index 27d2e3492c111..8bd808166de16 100644 --- a/metadata/preview/azure-ai-contentsafety.json +++ b/metadata/preview/azure-ai-contentsafety.json @@ -1,7 +1,7 @@ { "Name": "azure-ai-contentsafety", - "Version": "1.0.0-beta.1", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/contentsafety/azure-ai-contentsafety", "ServiceDirectory": "contentsafety", "ReadMePath": "sdk/contentsafety/azure-ai-contentsafety/README.md", @@ -10,7 +10,21 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-ai-contentsafety", - "ReleaseStatus": "2023-09-28", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure", + "name": "azure-ai-contentsafety", + "releaseInBatch": "${{ parameters.release_azureaicontentsafety }}", + "safeName": "azureaicontentsafety", + "triggeringPaths": [ + "/sdk/contentsafety/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.ai.contentsafety", "com.azure.ai.contentsafety.models" From d5ca7974dbb1c87b78f2176ccb63acef7619e760 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:43:14 +0000 Subject: [PATCH 14/52] Update docs metadata --- .../preview/resourcemanager-signalr-readme.md | 22 +++++++++---------- .../azure-resourcemanager-signalr.json | 18 ++++++++++----- 2 files changed, 23 insertions(+), 17 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-signalr-readme.md b/docs-ref-services/preview/resourcemanager-signalr-readme.md index 7aad728ee838b..43a94e357e114 100644 --- a/docs-ref-services/preview/resourcemanager-signalr-readme.md +++ b/docs-ref-services/preview/resourcemanager-signalr-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager SignalR client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-signalr, signalr -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: signalr --- -# Azure Resource Manager SignalR client library for Java - version 1.0.0-beta.9 +# Azure Resource Manager SignalR client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager SignalR client library for Java. -This package contains Microsoft Azure SDK for SignalR Management SDK. REST API for Azure SignalR Service. Package tag package-2023-08-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for SignalR Management SDK. REST API for Azure SignalR Service. Package tag package-2023-02-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-signalr - 1.0.0-beta.9 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-signalr_1.0.0-beta.9/sdk/signalr/azure-resourcemanager-signalr/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/signalr/azure-resourcemanager-signalr/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-signalr_1.0.0-beta.9/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-signalr_1.0.0-beta.9/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-signalr_1.0.0-beta.9/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-signalr_1.0.0-beta.9/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-signalr_1.0.0-beta.9/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-signalr_1.0.0-beta.9/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-signalr.json b/metadata/preview/azure-resourcemanager-signalr.json index 8459bd6bf7828..28f9f755ef018 100644 --- a/metadata/preview/azure-resourcemanager-signalr.json +++ b/metadata/preview/azure-resourcemanager-signalr.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-signalr", - "Version": "1.0.0-beta.9", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/signalr/azure-resourcemanager-signalr", "ServiceDirectory": "signalr", "ReadMePath": "sdk/signalr/azure-resourcemanager-signalr/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-signalr", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "name": "azure-resourcemanager-signalr", "groupId": "com.azure.resourcemanager", + "name": "azure-resourcemanager-signalr", + "triggeringPaths": [ + "/sdk/signalr/ci.yml" + ], "safeName": "azureresourcemanagersignalr" }, - "CIMatrixConfigs": [], + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.signalr", "com.azure.resourcemanager.signalr.fluent", "com.azure.resourcemanager.signalr.fluent.models", "com.azure.resourcemanager.signalr.models" - ] + ], + "CIMatrixConfigs": [] } From e95d832dd5eddbc61b1da4ffdbd5951ffb75f822 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:44:54 +0000 Subject: [PATCH 15/52] Update docs metadata --- .../preview/resourcemanager-relay-readme.md | 20 +++++++++---------- .../preview/azure-resourcemanager-relay.json | 17 +++++++++++++--- 2 files changed, 24 insertions(+), 13 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-relay-readme.md b/docs-ref-services/preview/resourcemanager-relay-readme.md index 06d2c8e19695f..6515561d18a85 100644 --- a/docs-ref-services/preview/resourcemanager-relay-readme.md +++ b/docs-ref-services/preview/resourcemanager-relay-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager Relay client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-relay, azure-relay -ms.date: 10/11/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: azure-relay --- -# Azure Resource Manager Relay client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager Relay client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager Relay client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-relay - 1.0.0-beta.3 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-relay_1.0.0-beta.3/sdk/relay/azure-resourcemanager-relay/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/relay/azure-resourcemanager-relay/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-relay_1.0.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-relay_1.0.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-relay_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-relay_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-relay_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-relay_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-relay.json b/metadata/preview/azure-resourcemanager-relay.json index ab68753ea5aa5..baa48a7815610 100644 --- a/metadata/preview/azure-resourcemanager-relay.json +++ b/metadata/preview/azure-resourcemanager-relay.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-relay", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/relay/azure-resourcemanager-relay", "ServiceDirectory": "relay", "ReadMePath": "sdk/relay/azure-resourcemanager-relay/README.md", @@ -10,9 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-relay", - "ReleaseStatus": "2024-10-10", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, + "ArtifactDetails": { + "safeName": "azureresourcemanagerrelay", + "name": "azure-resourcemanager-relay", + "triggeringPaths": [ + "/sdk/relay/ci.yml" + ], + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.relay", "com.azure.resourcemanager.relay.fluent", From c0a3c844b2f05c80a268b4e7c02acebb4e418e18 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:54:27 +0000 Subject: [PATCH 16/52] Update docs metadata --- .../preview/search-documents-readme.md | 26 +++++++++---------- metadata/preview/azure-search-documents.json | 14 +++++----- 2 files changed, 20 insertions(+), 20 deletions(-) diff --git a/docs-ref-services/preview/search-documents-readme.md b/docs-ref-services/preview/search-documents-readme.md index 48e540e23b4cb..a945f26bf5660 100644 --- a/docs-ref-services/preview/search-documents-readme.md +++ b/docs-ref-services/preview/search-documents-readme.md @@ -1,12 +1,12 @@ --- title: Azure AI Search client library for Java keywords: Azure, java, SDK, API, azure-search-documents, cognitive-search -ms.date: 09/05/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: cognitive-search --- -# Azure AI Search client library for Java - version 11.8.0-beta.8 +# Azure AI Search client library for Java - version 11.9.0-alpha.20251024.1 This is the Java client library for [Azure AI Search](https://learn.microsoft.com/azure/search/) (formerly known as "Azure Cognitive Search"). Azure AI Search service is an AI-powered information retrieval platform that helps developers build rich search experiences and generative AI apps that combine large language models with enterprise data. @@ -47,7 +47,7 @@ Use the Azure AI Search client library to: #### 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-search-documents_11.8.0-beta.8/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 @@ -84,7 +84,7 @@ add the direct dependency to your project as follows. com.azure azure-search-documents - 11.8.0-beta.8 + 11.8.0 ``` [//]: # ({x-version-update-end}) @@ -209,13 +209,13 @@ SearchAsyncClient searchAsyncClient = new SearchClientBuilder() #### Create a client using Microsoft Entra ID authentication You can also create a `SearchClient`, `SearchIndexClient`, or `SearchIndexerClient` using Microsoft Entra ID authentication. Your user or service principal must be assigned the "Search Index Data Reader" role. -Using the [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/identity/azure-identity/README.md#defaultazurecredential) +Using the [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#defaultazurecredential) you can authenticate a service using Managed Identity or a service principal, authenticate as a developer working on an application, and more all without changing code. Please refer the [documentation](https://learn.microsoft.com/azure/search/search-security-rbac?tabs=config-svc-portal%2Croles-portal%2Ctest-portal%2Ccustom-role-portal%2Cdisable-keys-portal) for instructions on how to connect to Azure AI Search using Azure role-based access control (Azure RBAC). -Before you can use the `DefaultAzureCredential`, or any credential type from [Azure.Identity](https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/identity/azure-identity/README.md), -you'll first need to [install the Azure.Identity package](https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/identity/azure-identity/README.md#include-the-package). +Before you can use the `DefaultAzureCredential`, or any credential type from [Azure.Identity](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md), +you'll first need to [install the Azure.Identity package](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity/README.md#include-the-package). To use `DefaultAzureCredential` with a client ID and secret, you'll need to set the `AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, and `AZURE_CLIENT_SECRET` environment variables; alternatively, you can pass those values @@ -521,7 +521,7 @@ SearchClient searchClient = new SearchClientBuilder() ## Troubleshooting -See our [troubleshooting guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/search/azure-search-documents/TROUBLESHOOTING.md) +See our [troubleshooting guide](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/search/azure-search-documents/TROUBLESHOOTING.md) for details on how to diagnose various failure scenarios. ### General @@ -587,20 +587,20 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [azure_subscription]: https://azure.microsoft.com/free/java [maven]: https://maven.apache.org/ [package]: https://central.sonatype.com/artifact/com.azure/azure-search-documents -[samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-search-documents_11.8.0-beta.8/sdk/search/azure-search-documents/src/samples/ -[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/search/azure-search-documents/src/samples/README.md -[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/azure-search-documents_11.8.0-beta.8/sdk/search/azure-search-documents/src +[samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/search/azure-search-documents/src/samples/ +[samples_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/search/azure-search-documents/src/samples/README.md +[source_code]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/search/azure-search-documents/src [logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK [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 -[add_headers_from_context_policy]: https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/core/azure-core/src/main/java/com/azure/core/http/policy/AddHeadersFromContextPolicy.java +[add_headers_from_context_policy]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/http/policy/AddHeadersFromContextPolicy.java [rest_api]: https://learn.microsoft.com/rest/api/searchservice/http-status-codes [create_search_service_docs]: https://learn.microsoft.com/azure/search/search-create-service-portal [create_search_service_ps]: https://learn.microsoft.com/azure/search/search-manage-powershell#create-or-delete-a-service [create_search_service_cli]: https://learn.microsoft.com/cli/azure/search/service?view=azure-cli-latest#az-search-service-create -[HttpResponseException]: https://github.com/Azure/azure-sdk-for-java/blob/azure-search-documents_11.8.0-beta.8/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java +[HttpResponseException]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java [status_codes]: https://learn.microsoft.com/rest/api/searchservice/http-status-codes [search-get-started-portal]: https://learn.microsoft.com/azure/search/search-get-started-portal diff --git a/metadata/preview/azure-search-documents.json b/metadata/preview/azure-search-documents.json index b10144312225f..a6e30b81c22fb 100644 --- a/metadata/preview/azure-search-documents.json +++ b/metadata/preview/azure-search-documents.json @@ -1,7 +1,7 @@ { "Name": "azure-search-documents", - "Version": "11.8.0-beta.8", - "DevVersion": null, + "Version": "11.9.0-alpha.20251024.1", + "DevVersion": "11.9.0-alpha.20251024.1", "DirectoryPath": "sdk/search/azure-search-documents", "ServiceDirectory": "search", "ReadMePath": "sdk/search/azure-search-documents/README.md", @@ -10,20 +10,20 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-search-documents", - "ReleaseStatus": "2025-09-05", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": [ "com.azure:azure-search-perf", "com.azure:perf-test-core" ], "ArtifactDetails": { + "releaseInBatch": "${{ parameters.release_azuresearchdocuments }}", + "groupId": "com.azure", + "name": "azure-search-documents", "triggeringPaths": [ "/sdk/search/ci.yml" ], - "safeName": "azuresearch", - "groupId": "com.azure", - "releaseInBatch": "${{ parameters.release_azuresearchdocuments }}", - "name": "azure-search-documents" + "safeName": "azuresearch" }, "CIParameters": { "CIMatrixConfigs": [] From d9d873af5320e81450980e4f1f7aa515984a0425 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:57:02 +0000 Subject: [PATCH 17/52] Update docs metadata --- .../resourcemanager-resourcegraph-readme.md | 127 ++++++++++++++++++ .../azure-resourcemanager-resourcegraph.json | 33 +++++ 2 files changed, 160 insertions(+) create mode 100644 docs-ref-services/preview/resourcemanager-resourcegraph-readme.md create mode 100644 metadata/preview/azure-resourcemanager-resourcegraph.json diff --git a/docs-ref-services/preview/resourcemanager-resourcegraph-readme.md b/docs-ref-services/preview/resourcemanager-resourcegraph-readme.md new file mode 100644 index 0000000000000..0bbd9b280f9dc --- /dev/null +++ b/docs-ref-services/preview/resourcemanager-resourcegraph-readme.md @@ -0,0 +1,127 @@ +--- +title: Azure Resource Manager ResourceGraph client library for Java +keywords: Azure, java, SDK, API, azure-resourcemanager-resourcegraph, resourcegraph +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: resourcegraph +--- +# Azure Resource Manager ResourceGraph client library for Java - version 1.2.0-alpha.20251024.1 + + +Azure Resource Manager ResourceGraph client library for Java. + +This package contains Microsoft Azure SDK for ResourceGraph Management SDK. Azure Resource Graph API Reference. Package tag package-2021-03. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). + +## We'd love to hear your feedback + +We're always working on improving our products and the way we communicate with our users. So we'd love to learn what's working and how we can do better. + +If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together. + +Thank you in advance for your collaboration. We really appreciate your time! + +## Documentation + +Various documentation is available to help you get started + +- [API reference documentation][docs] + +## Getting started + +### Prerequisites + +- [Java Development Kit (JDK)][jdk] with version 8 or above +- [Azure Subscription][azure_subscription] + +### Adding the package to your product + +[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-resourcegraph;current}) +```xml + + com.azure.resourcemanager + azure-resourcemanager-resourcegraph + 1.2.0-beta.1 + +``` +[//]: # ({x-version-update-end}) + +### Include the recommended packages + +Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client. + +[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation. + +### Authentication + +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. + +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. + +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: + +```java +AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); +TokenCredential credential = new DefaultAzureCredentialBuilder() + .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) + .build(); +ResourceGraphManager manager = ResourceGraphManager + .authenticate(credential, profile); +``` + +The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. + +See [Authentication][authenticate] for more options. + +## Key concepts + +See [API design][design] for general introduction on design and key concepts on Azure Management Libraries. + +## Examples + +```java +QueryRequest queryRequest = new QueryRequest().withSubscriptions(Collections.singletonList(subscriptionId)) + .withQuery("Resources | project name, type | limit 5 | order by name asc"); +// table format +queryRequest.withOptions(new QueryRequestOptions().withResultFormat(ResultFormat.TABLE)); +QueryResponse response = manager.resourceProviders().resources(queryRequest); + + +// object array format +queryRequest.withOptions(new QueryRequestOptions().withResultFormat(ResultFormat.OBJECT_ARRAY)); +response = manager.resourceProviders().resources(queryRequest); + +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcegraph/azure-resourcemanager-resourcegraph/SAMPLE.md) + + +## Troubleshooting + +## Next steps + +## Contributing + +For details on contributing to this repository, see the [contributing guide][cg]. + +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 . + +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 repositories 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 with any additional questions or comments. + + +[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS +[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/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + + diff --git a/metadata/preview/azure-resourcemanager-resourcegraph.json b/metadata/preview/azure-resourcemanager-resourcegraph.json new file mode 100644 index 0000000000000..a01c907e269c1 --- /dev/null +++ b/metadata/preview/azure-resourcemanager-resourcegraph.json @@ -0,0 +1,33 @@ +{ + "Name": "azure-resourcemanager-resourcegraph", + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", + "DirectoryPath": "sdk/resourcegraph/azure-resourcemanager-resourcegraph", + "ServiceDirectory": "resourcegraph", + "ReadMePath": "sdk/resourcegraph/azure-resourcemanager-resourcegraph/README.md", + "ChangeLogPath": "sdk/resourcegraph/azure-resourcemanager-resourcegraph/CHANGELOG.md", + "Group": "com.azure.resourcemanager", + "SdkType": "mgmt", + "IsNewSdk": true, + "ArtifactName": "azure-resourcemanager-resourcegraph", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "name": "azure-resourcemanager-resourcegraph", + "triggeringPaths": [ + "/sdk/resourcegraph/ci.yml" + ], + "groupId": "com.azure.resourcemanager", + "safeName": "azureresourcemanagerresourcegraph" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.resourcemanager.resourcegraph", + "com.azure.resourcemanager.resourcegraph.fluent", + "com.azure.resourcemanager.resourcegraph.fluent.models", + "com.azure.resourcemanager.resourcegraph.models" + ] +} From cdd0b5cb81a31fc7c068d3a3dbce179da8665218 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 01:57:19 +0000 Subject: [PATCH 18/52] Update docs metadata --- .../resourcemanager-hybridkubernetes-readme.md | 18 +++++++++--------- ...azure-resourcemanager-hybridkubernetes.json | 14 +++++++------- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-hybridkubernetes-readme.md b/docs-ref-services/preview/resourcemanager-hybridkubernetes-readme.md index fcb2f919cac61..bc4de1b0e0d91 100644 --- a/docs-ref-services/preview/resourcemanager-hybridkubernetes-readme.md +++ b/docs-ref-services/preview/resourcemanager-hybridkubernetes-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager HybridKubernetes client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-hybridkubernetes, hybridkubernetes -ms.date: 03/25/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: hybridkubernetes --- -# Azure Resource Manager HybridKubernetes client library for Java - version 1.1.0-beta.1 +# Azure Resource Manager HybridKubernetes client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager HybridKubernetes client library for Java. @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridkubernetes_1.1.0-beta.1/sdk/hybridkubernetes/azure-resourcemanager-hybridkubernetes/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/hybridkubernetes/azure-resourcemanager-hybridkubernetes/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-hybridkubernetes_1.1.0-beta.1/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-hybridkubernetes_1.1.0-beta.1/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridkubernetes_1.1.0-beta.1/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridkubernetes_1.1.0-beta.1/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridkubernetes_1.1.0-beta.1/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridkubernetes_1.1.0-beta.1/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-hybridkubernetes.json b/metadata/preview/azure-resourcemanager-hybridkubernetes.json index a2d4bbb335857..d0ef3cbdd1ef7 100644 --- a/metadata/preview/azure-resourcemanager-hybridkubernetes.json +++ b/metadata/preview/azure-resourcemanager-hybridkubernetes.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-hybridkubernetes", - "Version": "1.1.0-beta.1", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/hybridkubernetes/azure-resourcemanager-hybridkubernetes", "ServiceDirectory": "hybridkubernetes", "ReadMePath": "sdk/hybridkubernetes/azure-resourcemanager-hybridkubernetes/README.md", @@ -10,16 +10,16 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-hybridkubernetes", - "ReleaseStatus": "2025-03-25", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "name": "azure-resourcemanager-hybridkubernetes", - "safeName": "azureresourcemanagerhybridkubernetes", - "groupId": "com.azure.resourcemanager", "triggeringPaths": [ "/sdk/hybridkubernetes/ci.yml" - ] + ], + "groupId": "com.azure.resourcemanager", + "safeName": "azureresourcemanagerhybridkubernetes", + "name": "azure-resourcemanager-hybridkubernetes" }, "CIParameters": { "CIMatrixConfigs": [] From 1e6e7a7d47495a1e57eb6868b12edc020f2734cf Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 02:28:25 +0000 Subject: [PATCH 19/52] Update docs metadata --- .../mixedreality-authentication-readme.md | 59 +++++++++++++++---- .../azure-mixedreality-authentication.json | 31 ++++++++++ 2 files changed, 77 insertions(+), 13 deletions(-) create mode 100644 metadata/preview/azure-mixedreality-authentication.json diff --git a/docs-ref-services/preview/mixedreality-authentication-readme.md b/docs-ref-services/preview/mixedreality-authentication-readme.md index 105e649ac77a3..5137d5f2f0c1a 100644 --- a/docs-ref-services/preview/mixedreality-authentication-readme.md +++ b/docs-ref-services/preview/mixedreality-authentication-readme.md @@ -1,12 +1,12 @@ --- title: Azure Mixed Reality client library for Java -keywords: Azure, java, SDK, API, azure-mixedreality-authentication, -ms.date: 02/23/2021 +keywords: Azure, java, SDK, API, azure-mixedreality-authentication, mixedreality +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java -ms.service: +ms.service: mixedreality --- -# Azure Mixed Reality client library for Java - version 1.0.0-beta.1 +# Azure Mixed Reality client library for Java - version 1.3.0-alpha.20251024.1 Mixed Reality services, like Azure Spatial Anchors, Azure Remote Rendering, and others, use the Mixed Reality security @@ -16,7 +16,7 @@ token from the STS that can be used to access Mixed Reality services. [Source code][source] | [Package (Maven)][package] | [API reference documentation][api_documentation] | [Product documentation][product_docs] -![Mixed Reality service authentication diagram](https://docs.microsoft.com/azure/spatial-anchors/concepts/media/spatial-anchors-authentication-overview.png) +![Mixed Reality service authentication diagram](https://learn.microsoft.com/azure/spatial-anchors/concepts/media/spatial-anchors-authentication-overview.png) ## Getting started @@ -24,20 +24,53 @@ token from the STS that can be used to access Mixed Reality services. - You must have an [Azure subscription](https://azure.microsoft.com/free/). - You must have an account with an [Azure Mixed Reality service](https://azure.microsoft.com/topic/mixed-reality/): - - [Azure Remote Rendering](https://docs.microsoft.com/azure/remote-rendering/) - - [Azure Spatial Anchors](https://docs.microsoft.com/azure/spatial-anchors/) -- [Java Development Kit (JDK)](https://docs.microsoft.com/java/azure/jdk/?view=azure-java-stable) version 8 or above. + - [Azure Remote Rendering](https://learn.microsoft.com/azure/remote-rendering/) + - [Azure Spatial Anchors](https://learn.microsoft.com/azure/spatial-anchors/) +- [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). -- Familiarity with the authentication and credential concepts from [Azure.Identity](https://github.com/Azure/azure-sdk-for-java/tree/azure-mixedreality-authentication_1.0.0-beta.1/sdk/identity/azure-identity). +- Familiarity with the authentication and credential concepts from [Azure.Identity](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity). ### 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-mixedreality-authentication + + +``` + +#### 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-mixedreality-authentication;current}) ```xml com.azure azure-mixedreality-authentication - 1.0.0-beta.1 + 1.3.0-beta.1 ``` @@ -56,7 +89,7 @@ Mixed Reality services support a few different forms of authentication: method for production applications because it allows you to avoid embedding the credentials for access to a Mixed Reality service in your client application. -See [here](https://docs.microsoft.com/azure/spatial-anchors/concepts/authentication) for detailed instructions and information. +See [here](https://learn.microsoft.com/azure/spatial-anchors/concepts/authentication) for detailed instructions and information. ## Key concepts @@ -159,9 +192,9 @@ For more information see the [Code of Conduct FAQ](https://opensource.microsoft. [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ [coc_contact]: mailto:opencode@microsoft.com [product_docs]: https://azure.microsoft.com/topic/mixed-reality/ -[package]: https://search.maven.org/artifact/com.azure/azure-mixedreality-authentication +[package]: https://central.sonatype.com/artifact/com.azure/azure-mixedreality-authentication [api_documentation]: https://aka.ms/java-docs -[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-mixedreality-authentication_1.0.0-beta.1/sdk/mixedreality/azure-mixedreality-authentication +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/mixedreality/azure-mixedreality-authentication diff --git a/metadata/preview/azure-mixedreality-authentication.json b/metadata/preview/azure-mixedreality-authentication.json new file mode 100644 index 0000000000000..bd370c83723e0 --- /dev/null +++ b/metadata/preview/azure-mixedreality-authentication.json @@ -0,0 +1,31 @@ +{ + "Name": "azure-mixedreality-authentication", + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", + "DirectoryPath": "sdk/mixedreality/azure-mixedreality-authentication", + "ServiceDirectory": "mixedreality", + "ReadMePath": "sdk/mixedreality/azure-mixedreality-authentication/README.md", + "ChangeLogPath": "sdk/mixedreality/azure-mixedreality-authentication/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-mixedreality-authentication", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "releaseInBatch": "${{ parameters.release_azuremixedrealityauthentication }}", + "triggeringPaths": [ + "/sdk/mixedreality/ci.yml" + ], + "safeName": "azuremixedrealityauthentication", + "name": "azure-mixedreality-authentication", + "groupId": "com.azure" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.mixedreality.authentication" + ] +} From 8d9867acc65a5f2229e154d6b8e0f91ebddc6f09 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 02:29:30 +0000 Subject: [PATCH 20/52] Update docs metadata --- .../preview/ai-documentintelligence-readme.md | 207 +++++++++--------- .../azure-ai-documentintelligence.json | 23 +- 2 files changed, 119 insertions(+), 111 deletions(-) diff --git a/docs-ref-services/preview/ai-documentintelligence-readme.md b/docs-ref-services/preview/ai-documentintelligence-readme.md index d6a933b6d6f4e..65942e60e75de 100644 --- a/docs-ref-services/preview/ai-documentintelligence-readme.md +++ b/docs-ref-services/preview/ai-documentintelligence-readme.md @@ -1,12 +1,12 @@ --- title: Azure DocumentIntelligence client library for Java keywords: Azure, java, SDK, API, azure-ai-documentintelligence, documentintelligence -ms.date: 08/15/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: documentintelligence --- -# Azure DocumentIntelligence client library for Java - version 1.0.0-beta.4 +# Azure DocumentIntelligence client library for Java - version 1.1.0-alpha.20251024.1 Azure Document Intelligence ([previously known as Form Recognizer][service-rename]) is a cloud service that uses machine @@ -18,6 +18,7 @@ It includes the following main features: * Custom - Build custom models to extract text, field values, selection marks, and table data from documents. Custom models are built with your own data, so they're tailored to your documents. * Read - Read information about textual elements, such as page words and lines in addition to text language information. * Classifiers - Build custom classifiers to categorize documents into predefined classes. +- Batch analysis - Analyze multiple documents using a single request. [Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][sample_readme] @@ -37,7 +38,7 @@ It includes the following main features: com.azure azure-ai-documentintelligence - 1.0.0-beta.4 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -52,15 +53,16 @@ This table shows the relationship between SDK versions and supported API version | 1.0.0-beta.2 | 2024-02-29-preview | | 1.0.0-beta.3 | 2024-02-29-preview | | 1.0.0-beta.4 | 2024-07-31-preview | +| 1.0.0 | 2024-11-30 | > Note: Please rely on the older `azure-ai-formrecognizer` library through the older service API versions for retired > models, such as `"prebuilt-businessCard"` and `"prebuilt-document"`. For more information, see [Changelog][changelog]. > The below table describes the relationship of each client and its supported API version(s): -| API version | Supported clients | -|------------------------------------------------------------|-----------------------------------------------------------------------------------------------| -| 2023-10-31-preview, 2024-02-29-preview, 2024-07-31-preview | DocumentIntelligenceClient and DocumentIntelligenceAsyncClient | -| 2023-07-31 | DocumentAnalysisClient and DocumentModelAdministrationClient in `azure-ai-formrecognizer` SDK | +| API version | Supported clients | +|------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------| +| 2023-10-31-preview, 2024-02-29-preview, 2024-07-31-preview, 2024-11-30 | DocumentIntelligenceClient and DocumentIntelligenceAsyncClient | +| 2023-07-31 | DocumentAnalysisClient and DocumentModelAdministrationClient in `azure-ai-formrecognizer` SDK | Please see the [Migration Guide][migration_guide] for more information about migrating from `azure-ai-formrecognizer` to `azure-ai-documentintelligence`. @@ -82,12 +84,11 @@ DocumentIntelligenceClient documentIntelligenceClient = new DocumentIntelligence .buildClient(); ``` or -```java readme-sample-createDocumentModelAdministrationClient -DocumentIntelligenceAdministrationClient client = - new DocumentIntelligenceAdministrationClientBuilder() - .credential(new AzureKeyCredential("{key}")) - .endpoint("{endpoint}") - .buildClient(); +```java com.azure.ai.documentanalysis.readme.DocumentIntelligenceAdministrationClient +DocumentIntelligenceAdministrationClient documentIntelligenceAsyncClient = new DocumentIntelligenceAdministrationClientBuilder() + .credential(new AzureKeyCredential("{key}")) + .endpoint("{endpoint}") + .buildClient(); ``` #### Create an Azure DocumentIntelligence client with Azure Active Directory credential @@ -102,19 +103,14 @@ Authentication with AAD requires some initial setup: com.azure azure-identity - 1.13.2 + 1.18.1 ``` [//]: # ({x-version-update-end}) -After setup, you can choose which type of [credential][azure_identity_credential_type] from azure-identity to use. -As an example, [DefaultAzureCredential][wiki_identity] can be used to authenticate the client: -Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables: -`AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, `AZURE_CLIENT_SECRET`. - -Authorization is easiest using [DefaultAzureCredential][wiki_identity]. It finds the best credential to use in its -running environment. For more information about using Azure Active Directory authorization with DocumentIntelligence service, please -refer to [the associated documentation][aad_authorization]. +After setup, you can choose which type of [credential][azure_identity_credential_type] from `azure-identity` to use. +We recommend using [DefaultAzureCredential][identity_dac], configured through the `AZURE_TOKEN_CREDENTIALS` environment variable. +Set this variable as described in the [Learn documentation][customize_defaultAzureCredential], which provides the most up-to-date guidance and examples. ```java com.azure.ai.documentanalysis.readme.DocumentAnalysisAsyncClient.withAAD DocumentIntelligenceAsyncClient documentIntelligenceAsyncClient = new DocumentIntelligenceClientBuilder() @@ -122,7 +118,23 @@ DocumentIntelligenceAsyncClient documentIntelligenceAsyncClient = new DocumentIn .endpoint("{endpoint}") .buildAsyncClient(); ``` +You will also need to [register a new Microsoft Entra application][register_aad_app] and grant access to Document Intelligence by assigning the `"Cognitive Services Data Reader"` role to your service principal. +It is strongly recommended to use Microsoft Entra ID as your default authentication approach. On the other hand, using an `AzureKeyCredential` can be helpful on getting-started scenarios since it can be set up fastly. + +##### Get the API Key + +The API key can be found in the [Azure Portal][azure_portal_get_endpoint] or by running the following Azure CLI command: + +```PowerShell +az cognitiveservices account keys list --name "" --resource-group "" +``` +```java com.azure.ai.documentanalysis.readme.DocumentIntelligenceAdministrationClient +DocumentIntelligenceAdministrationClient documentIntelligenceAsyncClient = new DocumentIntelligenceAdministrationClientBuilder() + .credential(new AzureKeyCredential("{key}")) + .endpoint("{endpoint}") + .buildClient(); +``` ## Key concepts ### DocumentAnalysisClient The [DocumentAnalysisClient][document_analysis_sync_client] and [DocumentAnalysisAsyncClient][document_analysis_async_client] @@ -174,16 +186,9 @@ File layoutDocument = new File("local/file_path/filename.png"); Path filePath = layoutDocument.toPath(); BinaryData layoutDocumentData = BinaryData.fromFile(filePath, (int) layoutDocument.length()); -SyncPoller analyzeLayoutResultPoller = +SyncPoller analyzeLayoutResultPoller = documentIntelligenceClient.beginAnalyzeDocument("prebuilt-layout", - null, - null, - null, - null, - null, - null, - null, - new AnalyzeDocumentRequest().setBase64Source(Files.readAllBytes(layoutDocument.toPath()))); + new AnalyzeDocumentOptions(layoutDocumentData)); AnalyzeResult analyzeLayoutResult = analyzeLayoutResultPoller.getFinalResult(); @@ -235,21 +240,14 @@ For example, to analyze fields from a sales receipt, into the `beginAnalyzeDocum File sourceFile = new File("../documentintelligence/azure-ai-documentintelligence/src/samples/resources/" + "sample-forms/receipts/contoso-allinone.jpg"); -SyncPoller analyzeReceiptPoller = +SyncPoller analyzeReceiptPoller = documentIntelligenceClient.beginAnalyzeDocument("prebuilt-receipt", - null, - null, - null, - null, - null, - null, - null, - new AnalyzeDocumentRequest().setBase64Source(Files.readAllBytes(sourceFile.toPath()))); + new AnalyzeDocumentOptions(Files.readAllBytes(sourceFile.toPath()))); AnalyzeResult receiptResults = analyzeReceiptPoller.getFinalResult(); for (int i = 0; i < receiptResults.getDocuments().size(); i++) { - Document analyzedReceipt = receiptResults.getDocuments().get(i); + AnalyzedDocument analyzedReceipt = receiptResults.getDocuments().get(i); Map receiptFields = analyzedReceipt.getFields(); System.out.printf("----------- Analyzing receipt info %d -----------%n", i); DocumentField merchantNameField = receiptFields.get("MerchantName"); @@ -302,7 +300,7 @@ in the [service quickstart documentation][quickstart_training]. **Note** -You can use the [Document Intelligence Studio preview][fr-studio] for creating a labeled file for your training forms. +You can use the [Document Intelligence Studio preview][di-studio] for creating a labeled file for your training forms. More details on setting up a container and required file structure can be found in [here][fr_build_training_set]. ```java com.azure.ai.documentintelligence.readme.buildModel @@ -310,7 +308,7 @@ More details on setting up a container and required file structure can be found String blobContainerUrl = "{SAS_URL_of_your_container_in_blob_storage}"; // The shared access signature (SAS) Url of your Azure Blob Storage container with your forms. SyncPoller buildOperationPoller = - administrationClient.beginBuildDocumentModel(new BuildDocumentModelRequest("modelID", DocumentBuildMode.TEMPLATE) + administrationClient.beginBuildDocumentModel(new BuildDocumentModelOptions("modelID", DocumentBuildMode.TEMPLATE) .setAzureBlobSource(new AzureBlobContentSource(blobContainerUrl))); DocumentModelDetails documentModelDetails = buildOperationPoller.getFinalResult(); @@ -318,10 +316,10 @@ DocumentModelDetails documentModelDetails = buildOperationPoller.getFinalResult( // Model Info System.out.printf("Model ID: %s%n", documentModelDetails.getModelId()); System.out.printf("Model Description: %s%n", documentModelDetails.getDescription()); -System.out.printf("Model created on: %s%n%n", documentModelDetails.getCreatedDateTime()); +System.out.printf("Model created on: %s%n%n", documentModelDetails.getCreatedOn()); -System.out.println("Document Fields:"); -documentModelDetails.getDocTypes().forEach((key, documentTypeDetails) -> { +System.out.println("AnalyzedDocument Fields:"); +documentModelDetails.getDocumentTypes().forEach((key, documentTypeDetails) -> { documentTypeDetails.getFieldSchema().forEach((field, documentFieldSchema) -> { System.out.printf("Field: %s", field); System.out.printf("Field type: %s", documentFieldSchema.getType()); @@ -337,23 +335,18 @@ was built on. ```java com.azure.ai.documentintelligence.readme.analyzeCustomModel String documentUrl = "{document-url}"; String modelId = "{custom-built-model-ID}"; -SyncPoller analyzeDocumentPoller = documentIntelligenceClient.beginAnalyzeDocument(modelId, - "1", - "en-US", - StringIndexType.TEXT_ELEMENTS, - Arrays.asList(DocumentAnalysisFeature.LANGUAGES), - null, - ContentFormat.TEXT, - null, - new AnalyzeDocumentRequest().setUrlSource(documentUrl)); +SyncPoller analyzeDocumentPoller = documentIntelligenceClient.beginAnalyzeDocument(modelId, + new AnalyzeDocumentOptions(documentUrl).setPages(Collections.singletonList("1")).setLocale("en-US") + .setStringIndexType(StringIndexType.TEXT_ELEMENTS).setDocumentAnalysisFeatures(Arrays.asList(DocumentAnalysisFeature.LANGUAGES)) + .setOutputContentFormat(DocumentContentFormat.TEXT)); AnalyzeResult analyzeResult = analyzeDocumentPoller.getFinalResult(); for (int i = 0; i < analyzeResult.getDocuments().size(); i++) { - final Document analyzedDocument = analyzeResult.getDocuments().get(i); + final AnalyzedDocument analyzedDocument = analyzeResult.getDocuments().get(i); System.out.printf("----------- Analyzing custom document %d -----------%n", i); System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n", - analyzedDocument.getDocType(), analyzedDocument.getConfidence()); + analyzedDocument.getDocumentType(), analyzedDocument.getConfidence()); } analyzeResult.getPages().forEach(documentPage -> { @@ -394,7 +387,7 @@ for (int i = 0; i < tables.size(); i++) { Manage the models in your Document Intelligence account. ```java com.azure.ai.documentintelligence.readme.manageModels -ResourceDetails resourceDetails = administrationClient.getResourceInfo(); +DocumentIntelligenceResourceDetails resourceDetails = administrationClient.getResourceDetails(); System.out.printf("The resource has %s models, and we can have at most %s models.%n", resourceDetails.getCustomDocumentModels().getCount(), resourceDetails.getCustomDocumentModels().getLimit()); @@ -407,9 +400,9 @@ customDocumentModels.forEach(documentModelInfo -> { DocumentModelDetails documentModel = administrationClient.getModel(documentModelInfo.getModelId()); System.out.printf("Model ID: %s%n", documentModel.getModelId()); System.out.printf("Model Description: %s%n", documentModel.getDescription()); - System.out.printf("Model created on: %s%n", documentModel.getCreatedDateTime()); - if (documentModel.getDocTypes() != null) { - documentModel.getDocTypes().forEach((key, documentTypeDetails) -> { + System.out.printf("Model created on: %s%n", documentModel.getCreatedOn()); + if (documentModel.getDocumentTypes() != null) { + documentModel.getDocumentTypes().forEach((key, documentTypeDetails) -> { documentTypeDetails.getFieldSchema().forEach((field, documentFieldSchema) -> { System.out.printf("Field: %s, ", field); System.out.printf("Field type: %s, ", documentFieldSchema.getType()); @@ -434,7 +427,7 @@ be found here: [log levels][logLevels]. ### Default HTTP Client All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the -[HTTP clients wiki](https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients). +[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients). ### Default SSL library All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL @@ -447,7 +440,7 @@ reduce the dependency size, refer to the [performance tuning][performance_tuning ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/CONTRIBUTING.md). +For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md). 1. Fork it 2. Create your feature branch (`git checkout -b my-new-feature`) @@ -456,65 +449,67 @@ For details on contributing to this repository, see the [contributing guide](htt 5. Create new Pull Request -[aad_authorization]: /azure/cognitive-services/authentication#authenticate-with-azure-active-directory -[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java -[key]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource +[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory +[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java +[key]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource [api_reference_doc]: https://learn.microsoft.com/java/api/overview/azure/ai-documentintelligence-readme?view=azure-java-preview -[form_recognizer_doc]: https://aka.ms/azsdk-java-documentintelligence-ref-doc -[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_cli]: /azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows -[azure_cli_endpoint]: /cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show -[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/identity/azure-identity#credentials +[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows +[azure_cli_endpoint]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials [azure_portal]: https://ms.portal.azure.com [azure_subscription]: https://azure.microsoft.com/free [cla]: https://cla.microsoft.com [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ [coc_contact]: mailto:opencode@microsoft.com -[create_new_resource]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource -[form_recognizer_account]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows -[grant_access]: /azure/cognitive-services/authentication#assign-a-role-to-a-service-principal -[http_clients_wiki]: https://github.com/Azure/azure-sdk-for-java/wiki/HTTP-clients -[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java -[jdk_link]: /java/azure/jdk/?view=azure-java-stable -[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-with-Azure-SDK -[logLevels]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java +[create_new_resource]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource +[form_recognizer_account]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows +[grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal +[http_clients_wiki]: https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients +[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java +[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable +[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK +[logLevels]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/util/logging/ClientLogger.java [package]: https://central.sonatype.com/artifact/com.azure/azure-ai-documentintelligence [performance_tuning]: https://github.com/Azure/azure-sdk-for-java/wiki/Performance-Tuning -[product_documentation]: /azure/cognitive-services/form-recognizer/overview -[register_AAD_application]: /azure/cognitive-services/authentication#assign-a-role-to-a-service-principal -[fr-studio]: https://aka.ms/azsdk/formrecognizer/documentintelligencestudio +[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/form-recognizer/overview +[register_AAD_application]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal +[di-studio]: https://aka.ms/azsdk/formrecognizer/formrecognizerstudio [fr_build_training_set]: https://aka.ms/azsdk/formrecognizer/buildcustommodel -[sample_examples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#examples -[samples_readme]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#readme -[migration_guide]: https://github.com/Azure/azure-sdk-for-java/tree/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/MIGRATION_GUIDE.md -[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/CHANGELOG.md - -[sample_readme]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/ -[document_analysis_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAsyncClient.java -[document_analysis_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClient.java -[document_model_admin_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationAsyncClient.java -[document_model_admin_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationClient.java -[document_analysis_client_builder]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClientBuilder.java -[manage_custom_models]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModels.java -[manage_custom_models_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModelsAsync.java -[build_model]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModel.java -[build_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModelAsync.java -[build_document_classifier]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifier.java -[build_document_classifier_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifierAsync.java -[analyze_identity_documents_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrl.java -[analyze_identity_documents_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrlAsync.java -[analyze_invoices_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeInvoicesFromUrl.java -[analyze_receipts_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeReceiptsFromUrl.java +[sample_examples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#examples +[samples_readme]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples#readme +[migration_guide]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/documentintelligence/azure-ai-documentintelligence/MIGRATION_GUIDE.md +[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/CHANGELOG.md + +[sample_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/ +[document_analysis_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAsyncClient.java +[document_analysis_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClient.java +[document_model_admin_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationAsyncClient.java +[document_model_admin_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceAdministrationClient.java +[document_analysis_client_builder]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/main/java/com/azure/ai/documentintelligence/DocumentIntelligenceClientBuilder.java +[manage_custom_models]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModels.java +[manage_custom_models_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/ManageCustomModelsAsync.java +[build_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModel.java +[build_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentModelAsync.java +[build_document_classifier]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifier.java +[build_document_classifier_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/administration/BuildDocumentClassifierAsync.java +[analyze_identity_documents_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrl.java +[analyze_identity_documents_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeIdentityDocumentsFromUrlAsync.java +[analyze_invoices_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeInvoicesFromUrl.java +[analyze_receipts_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src/samples/java/com/azure/ai/documentintelligence/AnalyzeReceiptsFromUrl.java +[register_aad_app]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal +[azure_portal_get_endpoint]: https://learn.microsoft.com/azure/ai-services/document-intelligence/how-to-guides/create-document-intelligence-resource#get-endpoint-url-and-keys [fr_models]: https://aka.ms/azsdk/formrecognizer/models -[service_access]: /azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows +[service_access]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows [service_analyze_invoices_fields]: https://aka.ms/azsdk/formrecognizer/invoicefieldschema [service_analyze_identity_documents_fields]: https://aka.ms/azsdk/formrecognizer/iddocumentfieldschema [service_analyze_receipt_fields]: https://aka.ms/azsdk/formrecognizer/receiptfieldschema [service_analyze_w2_documents_fields]: https://aka.ms/azsdk/formrecognizer/taxusw2fieldschema [service-rename]: https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-form-recognizer-is-now-azure-ai-document-intelligence-with/ba-p/3875765 -[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/azure-ai-documentintelligence_1.0.0-beta.4/sdk/documentintelligence/azure-ai-documentintelligence/src +[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/documentintelligence/azure-ai-documentintelligence/src [quickstart_training]: https://learn.microsoft.com/azure/applied-ai-services/form-recognizer/quickstarts/get-started-sdks-rest-api?view=form-recog-3.0.0&pivots=programming-language-java -[wiki_identity]: https://github.com/Azure/azure-sdk-for-java/wiki/Identity-and-Authentication +[customize_defaultAzureCredential]: https://aka.ms/azsdk/java/identity/credential-chains#how-to-customize-defaultazurecredential +[identity_dac]: https://aka.ms/azsdk/java/identity/credential-chains#defaultazurecredential-overview diff --git a/metadata/preview/azure-ai-documentintelligence.json b/metadata/preview/azure-ai-documentintelligence.json index f417737be4324..b6360c45987ca 100644 --- a/metadata/preview/azure-ai-documentintelligence.json +++ b/metadata/preview/azure-ai-documentintelligence.json @@ -1,7 +1,7 @@ { "Name": "azure-ai-documentintelligence", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/documentintelligence/azure-ai-documentintelligence", "ServiceDirectory": "documentintelligence", "ReadMePath": "sdk/documentintelligence/azure-ai-documentintelligence/README.md", @@ -10,10 +10,23 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-ai-documentintelligence", - "ReleaseStatus": "2024-08-14", - "DependentPackages": null, + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure", + "name": "azure-ai-documentintelligence", + "triggeringPaths": [ + "/sdk/documentintelligence/ci.yml" + ], + "safeName": "azureaidocumentintelligence" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.ai.documentintelligence", "com.azure.ai.documentintelligence.models" - ] + ], + "DependentPackages": null } From 1f48f0be19d8ac0d6e48ccb3800cce282ff40722 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 02:30:21 +0000 Subject: [PATCH 21/52] Update docs metadata --- ...cemanager-recoveryservicesbackup-readme.md | 186 ++++++++++++++++++ ...esourcemanager-recoveryservicesbackup.json | 33 ++++ 2 files changed, 219 insertions(+) create mode 100644 docs-ref-services/preview/resourcemanager-recoveryservicesbackup-readme.md create mode 100644 metadata/preview/azure-resourcemanager-recoveryservicesbackup.json diff --git a/docs-ref-services/preview/resourcemanager-recoveryservicesbackup-readme.md b/docs-ref-services/preview/resourcemanager-recoveryservicesbackup-readme.md new file mode 100644 index 0000000000000..6d6fac430d8df --- /dev/null +++ b/docs-ref-services/preview/resourcemanager-recoveryservicesbackup-readme.md @@ -0,0 +1,186 @@ +--- +title: Azure Resource Manager RecoveryServicesBackup client library for Java +keywords: Azure, java, SDK, API, azure-resourcemanager-recoveryservicesbackup, recoveryservicesbackup +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: recoveryservicesbackup +--- +# Azure Resource Manager RecoveryServicesBackup client library for Java - version 1.7.0-alpha.20251024.1 + + +Azure Resource Manager RecoveryServicesBackup client library for Java. + +This package contains Microsoft Azure SDK for RecoveryServicesBackup Management SDK. Open API 2.0 Specs for Azure RecoveryServices Backup service. Package tag package-2025-02-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). + +## We'd love to hear your feedback + +We're always working on improving our products and the way we communicate with our users. So we'd love to learn what's working and how we can do better. + +If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together. + +Thank you in advance for your collaboration. We really appreciate your time! + +## Documentation + +Various documentation is available to help you get started + +- [API reference documentation][docs] + +## Getting started + +### Prerequisites + +- [Java Development Kit (JDK)][jdk] with version 8 or above +- [Azure Subscription][azure_subscription] + +### Adding the package to your product + +[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-recoveryservicesbackup;current}) +```xml + + com.azure.resourcemanager + azure-resourcemanager-recoveryservicesbackup + 1.6.0 + +``` +[//]: # ({x-version-update-end}) + +### Include the recommended packages + +Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client. + +[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation. + +### Authentication + +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. + +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. + +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: + +```java +AzureProfile profile = new AzureProfile(AzureCloud.AZURE_PUBLIC_CLOUD); +TokenCredential credential = new DefaultAzureCredentialBuilder() + .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) + .build(); +RecoveryServicesBackupManager manager = RecoveryServicesBackupManager + .authenticate(credential, profile); +``` + +The sample code assumes global Azure. Please change the `AzureCloud.AZURE_PUBLIC_CLOUD` variable if otherwise. + +See [Authentication][authenticate] for more options. + +## Key concepts + +See [API design][design] for general introduction on design and key concepts on Azure Management Libraries. + +## Examples + +```java +OffsetDateTime scheduleDateTime = OffsetDateTime.parse(OffsetDateTime.now(Clock.systemUTC()) + .withNano(0) + .withMinute(0) + .withSecond(0) + .plusDays(1) + .format(DateTimeFormatter.ISO_INSTANT)); + +List lstSubProtectionPolicy + = Arrays + .asList( + new SubProtectionPolicy().withPolicyType(PolicyType.FULL) + .withSchedulePolicy( + new SimpleSchedulePolicy().withScheduleRunFrequency(ScheduleRunType.WEEKLY) + .withScheduleRunDays(Arrays.asList(DayOfWeek.SUNDAY, DayOfWeek.TUESDAY)) + .withScheduleRunTimes(Arrays.asList(scheduleDateTime))) + .withRetentionPolicy( + new LongTermRetentionPolicy() + .withWeeklySchedule(new WeeklyRetentionSchedule() + .withDaysOfTheWeek(Arrays.asList(DayOfWeek.SUNDAY, DayOfWeek.TUESDAY)) + .withRetentionTimes(Arrays.asList(scheduleDateTime)) + .withRetentionDuration(new RetentionDuration().withCount(2) + .withDurationType(RetentionDurationType.WEEKS))) + .withMonthlySchedule(new MonthlyRetentionSchedule() + .withRetentionScheduleFormatType(RetentionScheduleFormat.WEEKLY) + .withRetentionScheduleWeekly(new WeeklyRetentionFormat() + .withDaysOfTheWeek(Arrays.asList(DayOfWeek.SUNDAY)) + .withWeeksOfTheMonth(Arrays.asList(WeekOfMonth.SECOND))) + .withRetentionTimes(Arrays.asList(scheduleDateTime)) + .withRetentionDuration(new RetentionDuration() + .withCount(1) + .withDurationType(RetentionDurationType.MONTHS))) + .withYearlySchedule(new YearlyRetentionSchedule() + .withRetentionScheduleFormatType(RetentionScheduleFormat.WEEKLY) + .withMonthsOfYear( + Arrays.asList(MonthOfYear.JANUARY, MonthOfYear.JUNE, MonthOfYear.DECEMBER)) + .withRetentionScheduleWeekly(new WeeklyRetentionFormat() + .withDaysOfTheWeek(Arrays.asList(DayOfWeek.SUNDAY)) + .withWeeksOfTheMonth(Arrays.asList(WeekOfMonth.LAST))) + .withRetentionTimes(Arrays.asList(scheduleDateTime)) + .withRetentionDuration(new RetentionDuration().withCount(1) + .withDurationType(RetentionDurationType.YEARS)))), + new SubProtectionPolicy().withPolicyType(PolicyType.DIFFERENTIAL) + .withSchedulePolicy( + new SimpleSchedulePolicy().withScheduleRunFrequency(ScheduleRunType.WEEKLY) + .withScheduleRunDays(Arrays.asList(DayOfWeek.FRIDAY)) + .withScheduleRunTimes(Arrays.asList(scheduleDateTime))) + .withRetentionPolicy(new SimpleRetentionPolicy().withRetentionDuration( + new RetentionDuration().withCount(8).withDurationType(RetentionDurationType.DAYS))), + new SubProtectionPolicy().withPolicyType(PolicyType.LOG) + .withSchedulePolicy(new LogSchedulePolicy().withScheduleFrequencyInMins(60)) + .withRetentionPolicy(new SimpleRetentionPolicy().withRetentionDuration( + new RetentionDuration().withCount(7).withDurationType(RetentionDurationType.DAYS)))); + +vault = recoveryServicesManager.vaults() + .define(vaultName) + .withRegion(REGION) + .withExistingResourceGroup(resourceGroupName) + .withSku(new Sku().withName(SkuName.RS0).withTier("Standard")) + .withProperties(new VaultProperties().withPublicNetworkAccess(PublicNetworkAccess.ENABLED) + .withRestoreSettings(new RestoreSettings() + .withCrossSubscriptionRestoreSettings(new CrossSubscriptionRestoreSettings() + .withCrossSubscriptionRestoreState(CrossSubscriptionRestoreState.ENABLED)))) + .create(); + +protectionPolicyResource = recoveryServicesBackupManager.protectionPolicies() + .define(policyName) + .withRegion(REGION) + .withExistingVault(vaultName, resourceGroupName) + .withProperties(new AzureVmWorkloadProtectionPolicy().withWorkLoadType(WorkloadType.SQLDATA_BASE) + .withSettings(new Settings().withTimeZone("Pacific Standard Time").withIssqlcompression(false)) + .withSubProtectionPolicy(lstSubProtectionPolicy)) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/recoveryservicesbackup/azure-resourcemanager-recoveryservicesbackup/SAMPLE.md) + + +## Troubleshooting + +## Next steps + +## Contributing + +For details on contributing to this repository, see the [contributing guide][cg]. + +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 . + +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 repositories 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 with any additional questions or comments. + + +[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS +[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/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + diff --git a/metadata/preview/azure-resourcemanager-recoveryservicesbackup.json b/metadata/preview/azure-resourcemanager-recoveryservicesbackup.json new file mode 100644 index 0000000000000..524d373bfbfcc --- /dev/null +++ b/metadata/preview/azure-resourcemanager-recoveryservicesbackup.json @@ -0,0 +1,33 @@ +{ + "Name": "azure-resourcemanager-recoveryservicesbackup", + "Version": "1.7.0-alpha.20251024.1", + "DevVersion": "1.7.0-alpha.20251024.1", + "DirectoryPath": "sdk/recoveryservicesbackup/azure-resourcemanager-recoveryservicesbackup", + "ServiceDirectory": "recoveryservicesbackup", + "ReadMePath": "sdk/recoveryservicesbackup/azure-resourcemanager-recoveryservicesbackup/README.md", + "ChangeLogPath": "sdk/recoveryservicesbackup/azure-resourcemanager-recoveryservicesbackup/CHANGELOG.md", + "Group": "com.azure.resourcemanager", + "SdkType": "mgmt", + "IsNewSdk": true, + "ArtifactName": "azure-resourcemanager-recoveryservicesbackup", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "safeName": "azureresourcemanagerrecoveryservicesbackup", + "triggeringPaths": [ + "/sdk/recoveryservicesbackup/ci.yml" + ], + "groupId": "com.azure.resourcemanager", + "name": "azure-resourcemanager-recoveryservicesbackup" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.resourcemanager.recoveryservicesbackup", + "com.azure.resourcemanager.recoveryservicesbackup.fluent", + "com.azure.resourcemanager.recoveryservicesbackup.fluent.models", + "com.azure.resourcemanager.recoveryservicesbackup.models" + ] +} From 6c61d4f49d1f6b9795e6d16cfb420f90a5dfc137 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 02:31:54 +0000 Subject: [PATCH 22/52] Update docs metadata --- ...resourcemanager-customerinsights-readme.md | 20 +++++++++---------- ...zure-resourcemanager-customerinsights.json | 16 ++++++++++----- 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-customerinsights-readme.md b/docs-ref-services/preview/resourcemanager-customerinsights-readme.md index 608e5fd34d8d9..eb001c0226a1a 100644 --- a/docs-ref-services/preview/resourcemanager-customerinsights-readme.md +++ b/docs-ref-services/preview/resourcemanager-customerinsights-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager CustomerInsights client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-customerinsights, customerinsights -ms.date: 10/17/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: customerinsights --- -# Azure Resource Manager CustomerInsights client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager CustomerInsights client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager CustomerInsights client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-customerinsights - 1.0.0-beta.3 + 1.0.0-beta.4 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-customerinsights_1.0.0-beta.3/sdk/customerinsights/azure-resourcemanager-customerinsights/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/customerinsights/azure-resourcemanager-customerinsights/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-customerinsights_1.0.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-customerinsights_1.0.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-customerinsights_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-customerinsights_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-customerinsights_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-customerinsights_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-customerinsights.json b/metadata/preview/azure-resourcemanager-customerinsights.json index a5c516c04ee9c..114a5c0fbf573 100644 --- a/metadata/preview/azure-resourcemanager-customerinsights.json +++ b/metadata/preview/azure-resourcemanager-customerinsights.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-customerinsights", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/customerinsights/azure-resourcemanager-customerinsights", "ServiceDirectory": "customerinsights", "ReadMePath": "sdk/customerinsights/azure-resourcemanager-customerinsights/README.md", @@ -10,13 +10,19 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-customerinsights", - "ReleaseStatus": "2024-10-17", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { + "safeName": "azureresourcemanagercustomerinsights", + "triggeringPaths": [ + "/sdk/customerinsights/ci.yml" + ], "name": "azure-resourcemanager-customerinsights", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagercustomerinsights" + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, "Namespaces": [ "com.azure.resourcemanager.customerinsights", From fe64ae70a008dc7202e9f74bec0b7211708c2d97 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 02:44:07 +0000 Subject: [PATCH 23/52] Update docs metadata --- ...resourcemanager-recoveryservices-readme.md | 127 ++++++++++++++++++ ...zure-resourcemanager-recoveryservices.json | 33 +++++ 2 files changed, 160 insertions(+) create mode 100644 docs-ref-services/preview/resourcemanager-recoveryservices-readme.md create mode 100644 metadata/preview/azure-resourcemanager-recoveryservices.json diff --git a/docs-ref-services/preview/resourcemanager-recoveryservices-readme.md b/docs-ref-services/preview/resourcemanager-recoveryservices-readme.md new file mode 100644 index 0000000000000..bec7675ab791c --- /dev/null +++ b/docs-ref-services/preview/resourcemanager-recoveryservices-readme.md @@ -0,0 +1,127 @@ +--- +title: Azure Resource Manager RecoveryServices client library for Java +keywords: Azure, java, SDK, API, azure-resourcemanager-recoveryservices, recoveryservices +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: recoveryservices +--- +# Azure Resource Manager RecoveryServices client library for Java - version 1.6.0-alpha.20251024.1 + + +Azure Resource Manager RecoveryServices client library for Java. + +This package contains Microsoft Azure SDK for RecoveryServices Management SDK. Package api-version 2025-08-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). + +## We'd love to hear your feedback + +We're always working on improving our products and the way we communicate with our users. So we'd love to learn what's working and how we can do better. + +If you haven't already, please take a few minutes to [complete this short survey][survey] we have put together. + +Thank you in advance for your collaboration. We really appreciate your time! + +## Documentation + +Various documentation is available to help you get started + +- [API reference documentation][docs] + +## Getting started + +### Prerequisites + +- [Java Development Kit (JDK)][jdk] with version 8 or above +- [Azure Subscription][azure_subscription] + +### Adding the package to your product + +[//]: # ({x-version-update-start;com.azure.resourcemanager:azure-resourcemanager-recoveryservices;current}) +```xml + + com.azure.resourcemanager + azure-resourcemanager-recoveryservices + 1.6.0 + +``` +[//]: # ({x-version-update-end}) + +### Include the recommended packages + +Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client. + +[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation. + +### Authentication + +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. + +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. + +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: + +```java +AzureProfile profile = new AzureProfile(AzureCloud.AZURE_PUBLIC_CLOUD); +TokenCredential credential = new DefaultAzureCredentialBuilder() + .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) + .build(); +RecoveryServicesManager manager = RecoveryServicesManager + .authenticate(credential, profile); +``` + +The sample code assumes global Azure. Please change the `AzureCloud.AZURE_PUBLIC_CLOUD` variable if otherwise. + +See [Authentication][authenticate] for more options. + +## Key concepts + +See [API design][design] for general introduction on design and key concepts on Azure Management Libraries. + +## Examples + +```java +vault = recoveryServicesManager.vaults() + .define(vaultName) + .withRegion(REGION) + .withExistingResourceGroup(resourceGroupName) + .withSku(new Sku().withName(SkuName.RS0).withTier("Standard")) + .withProperties(new VaultProperties() + .withSecuritySettings(new SecuritySettings() + .withImmutabilitySettings(new ImmutabilitySettings().withState(ImmutabilityState.UNLOCKED))) + .withPublicNetworkAccess(PublicNetworkAccess.ENABLED) + .withRestoreSettings(new RestoreSettings() + .withCrossSubscriptionRestoreSettings(new CrossSubscriptionRestoreSettings() + .withCrossSubscriptionRestoreState(CrossSubscriptionRestoreState.ENABLED)))) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/recoveryservices/azure-resourcemanager-recoveryservices/SAMPLE.md) + + +## Troubleshooting + +## Next steps + +## Contributing + +For details on contributing to this repository, see the [contributing guide][cg]. + +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 . + +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 repositories 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 with any additional questions or comments. + + +[survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS +[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/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + diff --git a/metadata/preview/azure-resourcemanager-recoveryservices.json b/metadata/preview/azure-resourcemanager-recoveryservices.json new file mode 100644 index 0000000000000..6b89736dc5140 --- /dev/null +++ b/metadata/preview/azure-resourcemanager-recoveryservices.json @@ -0,0 +1,33 @@ +{ + "Name": "azure-resourcemanager-recoveryservices", + "Version": "1.6.0-alpha.20251024.1", + "DevVersion": "1.6.0-alpha.20251024.1", + "DirectoryPath": "sdk/recoveryservices/azure-resourcemanager-recoveryservices", + "ServiceDirectory": "recoveryservices", + "ReadMePath": "sdk/recoveryservices/azure-resourcemanager-recoveryservices/README.md", + "ChangeLogPath": "sdk/recoveryservices/azure-resourcemanager-recoveryservices/CHANGELOG.md", + "Group": "com.azure.resourcemanager", + "SdkType": "mgmt", + "IsNewSdk": true, + "ArtifactName": "azure-resourcemanager-recoveryservices", + "ReleaseStatus": "2025-09-29", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", + "name": "azure-resourcemanager-recoveryservices", + "safeName": "azureresourcemanagerrecoveryservices", + "triggeringPaths": [ + "/sdk/recoveryservices/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.resourcemanager.recoveryservices", + "com.azure.resourcemanager.recoveryservices.fluent", + "com.azure.resourcemanager.recoveryservices.fluent.models", + "com.azure.resourcemanager.recoveryservices.models" + ] +} From 95f24607e7288822de9e23aab5638f0bb89a678a Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 02:50:17 +0000 Subject: [PATCH 24/52] Update docs metadata --- .../preview/digitaltwins-core-readme.md | 163 ++++++++++++++++++ metadata/preview/azure-digitaltwins-core.json | 32 ++++ 2 files changed, 195 insertions(+) create mode 100644 docs-ref-services/preview/digitaltwins-core-readme.md create mode 100644 metadata/preview/azure-digitaltwins-core.json diff --git a/docs-ref-services/preview/digitaltwins-core-readme.md b/docs-ref-services/preview/digitaltwins-core-readme.md new file mode 100644 index 0000000000000..3999e54643895 --- /dev/null +++ b/docs-ref-services/preview/digitaltwins-core-readme.md @@ -0,0 +1,163 @@ +--- +title: Azure IoT Digital Twins client library for Java +keywords: Azure, java, SDK, API, azure-digitaltwins-core, digital-twins +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: digital-twins +--- +# Azure IoT Digital Twins client library for Java - version 1.6.0-alpha.20251024.1 + + +This library provides access to the Azure Digital Twins service for managing twins, models, relationships, etc. + + [Source code][source] | [Package](https://central.sonatype.com/artifact/com.azure/azure-digitaltwins-core) + +## Getting started + +The complete Microsoft Azure SDK can be downloaded from the [Microsoft Azure downloads][microsoft_sdk_download] page, and it ships with support for building deployment packages, integrating with tooling, rich command line tooling, and more. + +For the best development experience, developers should use the official Microsoft Maven packages for libraries. Maven packages are regularly updated with new functionality and hotfixes. + +### Include the Package +#### Include the BOM file + +Please include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number. +To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md). + +```xml + + + + com.azure + azure-sdk-bom + {bom_version_to_target} + pom + import + + + +``` +and then include the direct dependency in the dependencies section without the version tag. + +```xml + + + com.azure + azure-digitaltwins-core + + +``` + +#### 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-digitaltwins-core;current}) + +```xml + + com.azure + azure-digitaltwins-core + 1.5.0 + +``` + +[//]: # ({x-version-update-end}) + +### Prerequisites + +- A Microsoft Azure Subscription + - To call Microsoft Azure services, create an [Azure subscription][azure_sub]. +- An Azure Digital Twins instance + - In order to use the Azure Digital Twins SDK, first create a Digital Twins instance using one of options: + - Using [Azure portal][azure_portal] + - Using [Azure Management APIs][azure_rest_api] + - Using [Azure CLI][azure_cli] + - You will need to install azure cli and the [Azure IoT extension][iot_cli_extension] for Azure CLI. + - Refer to [IoT CLI documentation][iot_cli_doc] for more information on how to create and interact with your Digital Twins instance. + +### Authenticate the Client + +In order to interact with the Azure Digital Twins service, you will need to create an instance of a [TokenCredential class][token_credential] and pass it to the constructor of your [DigitalTwinsClientBuilder](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/digitaltwins/azure-digitaltwins-core/src/main/java/com/azure/digitaltwins/core/DigitalTwinsClientBuilder.java). + +## Key concepts + +Azure Digital Twins is an Azure IoT service that creates comprehensive models of the physical environment. +It can create spatial intelligence graphs to model the relationships and interactions between people, spaces, and devices. + +You can learn more about Azure Digital Twins by visiting [Azure Digital Twins Documentation][digital_twins_documentation] + +## Examples + +You can familiarize yourself with different APIs using [samples for Digital Twins](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/digitaltwins/azure-digitaltwins-core/src/samples). + +## Source code folder structure + +### /src/main/java/com/azure/digitaltwins/core + +- The Digital Twins client builder [`DigitalTwinsClientBuilder`](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/digitaltwins/azure-digitaltwins-core/src/main/java/com/azure/digitaltwins/core/DigitalTwinsClientBuilder.java) +- The Digital Twins public sync and async clients [`DigitalTwinsClient`](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/digitaltwins/azure-digitaltwins-core/src/main/java/com/azure/digitaltwins/core/DigitalTwinsClient.java), [`DigitalTwinsAsyncClient`](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/digitaltwins/azure-digitaltwins-core/src/main/java/com/azure/digitaltwins/core/DigitalTwinsAsyncClient.java) +- [`models` package](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/digitaltwins/azure-digitaltwins-core/src/main/java/com/azure/digitaltwins/core/models) + +Portions of the client library are generated through Autorest, and the swagger file used is defined in the Autorest config file. + +### /src/samples + +This directory contains sample code that demonstrates basic usage of this client library. For additional information, +see the [sample readme](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/digitaltwins/azure-digitaltwins-core/src/samples/README.md) + +## Troubleshooting + +All service operations will throw ErrorResponseException on failure reported by the service, with helpful error codes and other information. + +For example, use the `getModel` operation to check if the model exists before creating it. + +```java +try { + syncClient.getModel("someRandomModelId"); +} +catch (ErrorResponseException ex) { + if (ex.getResponse().getStatusCode() == HttpURLConnection.HTTP_NOT_FOUND) { + return id; + } else { + // This request should not retried if it encounters a 401 error, for instance + throw new IllegalStateException("Encountered unexpected error while searching for unique id", ex); + } +} +``` + +## Next steps + +See implementation examples with our [code samples](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/digitaltwins/azure-digitaltwins-core/src/samples). + +## 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 . + +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 or contact opencode@microsoft.com with any additional questions or comments. + + +[microsoft_sdk_download]: https://azure.microsoft.com/downloads/?sdk=java +[azure_cli]: https://learn.microsoft.com/cli/azure +[azure_sub]: https://azure.microsoft.com/free/ +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/digitaltwins/azure-digitaltwins-core +[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ +[nuget]: https://www.nuget.org/ +[azure_portal]: https://portal.azure.com/ +[azure_rest_api]: https://learn.microsoft.com/rest/api/azure/ +[azure_core_library]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/core/azure-core +[token_credential]: https://learn.microsoft.com/java/api/com.azure.core.credential.tokencredential?view=azure-java-stable +[digital_twins_documentation]: https://learn.microsoft.com/azure/digital-twins/ +[azure_cli]: https://learn.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest +[iot_cli_extension]: https://github.com/Azure/azure-iot-cli-extension/releases +[iot_cli_doc]: https://learn.microsoft.com/cli/azure/ext/azure-iot/dt?view=azure-cli-latest + diff --git a/metadata/preview/azure-digitaltwins-core.json b/metadata/preview/azure-digitaltwins-core.json new file mode 100644 index 0000000000000..66e5d118a6c7c --- /dev/null +++ b/metadata/preview/azure-digitaltwins-core.json @@ -0,0 +1,32 @@ +{ + "Name": "azure-digitaltwins-core", + "Version": "1.6.0-alpha.20251024.1", + "DevVersion": "1.6.0-alpha.20251024.1", + "DirectoryPath": "sdk/digitaltwins/azure-digitaltwins-core", + "ServiceDirectory": "digitaltwins", + "ReadMePath": "sdk/digitaltwins/azure-digitaltwins-core/README.md", + "ChangeLogPath": "sdk/digitaltwins/azure-digitaltwins-core/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-digitaltwins-core", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "releaseInBatch": "${{ parameters.release_azuredigitaltwinscore }}", + "groupId": "com.azure", + "name": "azure-digitaltwins-core", + "safeName": "azuredigitaltwinscore", + "triggeringPaths": [ + "/sdk/digitaltwins/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.digitaltwins.core", + "com.azure.digitaltwins.core.models" + ] +} From acce0bcecb6ecdd8b8e60f6aefac725126da0549 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 03:12:15 +0000 Subject: [PATCH 25/52] Update docs metadata --- .../resourcemanager-costmanagement-readme.md | 20 +++++++++---------- .../azure-resourcemanager-costmanagement.json | 20 ++++++++++++------- 2 files changed, 23 insertions(+), 17 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-costmanagement-readme.md b/docs-ref-services/preview/resourcemanager-costmanagement-readme.md index ffb27e3d36112..1781c9059a46b 100644 --- a/docs-ref-services/preview/resourcemanager-costmanagement-readme.md +++ b/docs-ref-services/preview/resourcemanager-costmanagement-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager CostManagement client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-costmanagement, costmanagement -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: costmanagement --- -# Azure Resource Manager CostManagement client library for Java - version 1.0.0-beta.7 +# Azure Resource Manager CostManagement client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager CostManagement client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-costmanagement - 1.0.0-beta.7 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-costmanagement_1.0.0-beta.7/sdk/costmanagement/azure-resourcemanager-costmanagement/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/costmanagement/azure-resourcemanager-costmanagement/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-costmanagement_1.0.0-beta.7/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-costmanagement_1.0.0-beta.7/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-costmanagement_1.0.0-beta.7/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-costmanagement_1.0.0-beta.7/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-costmanagement_1.0.0-beta.7/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-costmanagement_1.0.0-beta.7/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-costmanagement.json b/metadata/preview/azure-resourcemanager-costmanagement.json index 4bb7bc52cc344..3ca1a346694a9 100644 --- a/metadata/preview/azure-resourcemanager-costmanagement.json +++ b/metadata/preview/azure-resourcemanager-costmanagement.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-costmanagement", - "Version": "1.0.0-beta.7", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/costmanagement/azure-resourcemanager-costmanagement", "ServiceDirectory": "costmanagement", "ReadMePath": "sdk/costmanagement/azure-resourcemanager-costmanagement/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-costmanagement", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { + "safeName": "azureresourcemanagercostmanagement", + "triggeringPaths": [ + "/sdk/costmanagement/ci.yml" + ], "name": "azure-resourcemanager-costmanagement", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagercostmanagement" + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.resourcemanager.costmanagement", "com.azure.resourcemanager.costmanagement.fluent", "com.azure.resourcemanager.costmanagement.fluent.models", "com.azure.resourcemanager.costmanagement.models" - ] + ], + "CIMatrixConfigs": [] } From 99bc16d7ca56a180a89a3ad7ad5b7945b796158f Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 03:21:32 +0000 Subject: [PATCH 26/52] Update docs metadata --- ...ourcemanager-managedapplications-readme.md | 20 +++++++++---------- ...e-resourcemanager-managedapplications.json | 16 ++++++++++----- 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-managedapplications-readme.md b/docs-ref-services/preview/resourcemanager-managedapplications-readme.md index 10343115bd678..90e1a4b7d98d7 100644 --- a/docs-ref-services/preview/resourcemanager-managedapplications-readme.md +++ b/docs-ref-services/preview/resourcemanager-managedapplications-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager Application client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-managedapplications, managedapplications -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: managedapplications --- -# Azure Resource Manager Application client library for Java - version 1.0.0-beta.4 +# Azure Resource Manager Application client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager Application client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-managedapplications - 1.0.0-beta.4 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-managedapplications_1.0.0-beta.4/sdk/managedapplications/azure-resourcemanager-managedapplications/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/managedapplications/azure-resourcemanager-managedapplications/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-managedapplications_1.0.0-beta.4/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-managedapplications_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-managedapplications_1.0.0-beta.4/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-managedapplications_1.0.0-beta.4/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-managedapplications_1.0.0-beta.4/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-managedapplications_1.0.0-beta.4/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-managedapplications.json b/metadata/preview/azure-resourcemanager-managedapplications.json index 9bbd828ef2bd3..bc06eaa036b96 100644 --- a/metadata/preview/azure-resourcemanager-managedapplications.json +++ b/metadata/preview/azure-resourcemanager-managedapplications.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-managedapplications", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/managedapplications/azure-resourcemanager-managedapplications", "ServiceDirectory": "managedapplications", "ReadMePath": "sdk/managedapplications/azure-resourcemanager-managedapplications/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-managedapplications", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { + "triggeringPaths": [ + "/sdk/managedapplications/ci.yml" + ], "name": "azure-resourcemanager-managedapplications", "groupId": "com.azure.resourcemanager", "safeName": "azureresourcemanagermanagedapplications" }, - "CIMatrixConfigs": [], + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.managedapplications", "com.azure.resourcemanager.managedapplications.fluent", "com.azure.resourcemanager.managedapplications.fluent.models", "com.azure.resourcemanager.managedapplications.models" - ] + ], + "CIMatrixConfigs": [] } From 01e8ba4764f356f39c273fa1edc27d01064c0462 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 03:24:31 +0000 Subject: [PATCH 27/52] Update docs metadata --- .../preview/resourcemanager-databox-readme.md | 28 +++++++++---------- .../azure-resourcemanager-databox.json | 20 ++++++++----- 2 files changed, 26 insertions(+), 22 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-databox-readme.md b/docs-ref-services/preview/resourcemanager-databox-readme.md index fd91f4c438900..b9cb03d023f69 100644 --- a/docs-ref-services/preview/resourcemanager-databox-readme.md +++ b/docs-ref-services/preview/resourcemanager-databox-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager DataBox client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-databox, databox -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: databox --- -# Azure Resource Manager DataBox client library for Java - version 1.0.0-beta.4 +# Azure Resource Manager DataBox client library for Java - version 1.2.0-alpha.20251024.1 Azure Resource Manager DataBox client library for Java. -This package contains Microsoft Azure SDK for DataBox Management SDK. Package tag package-2022-12. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for DataBox Management SDK. Package tag package-2025-02. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-databox - 1.0.0-beta.4 + 1.1.0 ``` [//]: # ({x-version-update-end}) @@ -61,7 +61,7 @@ Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java -AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); +AzureProfile profile = new AzureProfile(AzureCloud.AZURE_PUBLIC_CLOUD); TokenCredential credential = new DefaultAzureCredentialBuilder() .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) .build(); @@ -69,7 +69,7 @@ DataBoxManager manager = DataBoxManager .authenticate(credential, profile); ``` -The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. +The sample code assumes global Azure. Please change the `AzureCloud.AZURE_PUBLIC_CLOUD` variable if otherwise. See [Authentication][authenticate] for more options. @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-databox_1.0.0-beta.4/sdk/databox/azure-resourcemanager-databox/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/databox/azure-resourcemanager-databox/SAMPLE.md) ## Troubleshooting @@ -101,14 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-databox_1.0.0-beta.4/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-databox_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-databox_1.0.0-beta.4/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-databox_1.0.0-beta.4/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-databox_1.0.0-beta.4/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-databox_1.0.0-beta.4/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ - - diff --git a/metadata/preview/azure-resourcemanager-databox.json b/metadata/preview/azure-resourcemanager-databox.json index a2a668ab75db9..d020895f73ecf 100644 --- a/metadata/preview/azure-resourcemanager-databox.json +++ b/metadata/preview/azure-resourcemanager-databox.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-databox", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", "DirectoryPath": "sdk/databox/azure-resourcemanager-databox", "ServiceDirectory": "databox", "ReadMePath": "sdk/databox/azure-resourcemanager-databox/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-databox", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "name": "azure-resourcemanager-databox", + "safeName": "azureresourcemanagerdatabox", "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerdatabox" + "triggeringPaths": [ + "/sdk/databox/ci.yml" + ], + "name": "azure-resourcemanager-databox" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.resourcemanager.databox", "com.azure.resourcemanager.databox.fluent", "com.azure.resourcemanager.databox.fluent.models", "com.azure.resourcemanager.databox.models" - ] + ], + "CIMatrixConfigs": [] } From 21d92ea1d3311b188507d02c9f1156d81ceec0a9 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 03:28:04 +0000 Subject: [PATCH 28/52] Update docs metadata --- .../preview/resourcemanager-kusto-readme.md | 45 +++++++++++-------- .../preview/azure-resourcemanager-kusto.json | 19 ++++++-- 2 files changed, 43 insertions(+), 21 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-kusto-readme.md b/docs-ref-services/preview/resourcemanager-kusto-readme.md index 09c2f34ebde89..7af20c5ea7b63 100644 --- a/docs-ref-services/preview/resourcemanager-kusto-readme.md +++ b/docs-ref-services/preview/resourcemanager-kusto-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager Kusto client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-kusto, kusto -ms.date: 02/21/2023 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: kusto --- -# Azure Resource Manager Kusto client library for Java - version 1.0.0-beta.6 +# Azure Resource Manager Kusto client library for Java - version 1.3.0-alpha.20251024.1 Azure Resource Manager Kusto client library for Java. -This package contains Microsoft Azure SDK for Kusto Management SDK. The Azure Kusto management API provides a RESTful set of web services that interact with Azure Kusto services to manage your clusters and databases. The API enables you to create, update, and delete clusters and databases. Package tag package-2022-12. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for Kusto Management SDK. The Azure Kusto management API provides a RESTful set of web services that interact with Azure Kusto services to manage your clusters and databases. The API enables you to create, update, and delete clusters and databases. Package tag package-2024-04. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-kusto - 1.0.0-beta.6 + 1.3.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -54,15 +54,11 @@ Azure Management Libraries require a `TokenCredential` implementation for authen ### Authentication -By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables. +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. -- `AZURE_CLIENT_ID` for Azure client ID. -- `AZURE_TENANT_ID` for Azure tenant ID. -- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate. +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. -In addition, Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. - -With above configuration, `azure` client can be authenticated using the following code: +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); @@ -83,7 +79,17 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-kusto_1.0.0-beta.6/sdk/kusto/azure-resourcemanager-kusto/SAMPLE.md) +```java +cluster = kustoManager.clusters() + .define(clusterName) + .withRegion(REGION) + .withExistingResourceGroup(resourceGroupName) + .withSku(new AzureSku().withName(AzureSkuName.DEV_NO_SLA_STANDARD_E2A_V4) + .withCapacity(1) + .withTier(AzureSkuTier.BASIC)) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/kusto/azure-resourcemanager-kusto/SAMPLE.md) ## Troubleshooting @@ -103,13 +109,16 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS [docs]: https://azure.github.io/azure-sdk-for-java/ -[jdk]: /java/azure/jdk/ +[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-resourcemanager-kusto_1.0.0-beta.6/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-kusto_1.0.0-beta.6/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-kusto_1.0.0-beta.6/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-kusto_1.0.0-beta.6/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-kusto_1.0.0-beta.6/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + diff --git a/metadata/preview/azure-resourcemanager-kusto.json b/metadata/preview/azure-resourcemanager-kusto.json index 818c72cdb28da..0a3a19fbffaf6 100644 --- a/metadata/preview/azure-resourcemanager-kusto.json +++ b/metadata/preview/azure-resourcemanager-kusto.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-kusto", - "Version": "1.0.0-beta.6", - "DevVersion": null, + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", "DirectoryPath": "sdk/kusto/azure-resourcemanager-kusto", "ServiceDirectory": "kusto", "ReadMePath": "sdk/kusto/azure-resourcemanager-kusto/README.md", @@ -10,7 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-kusto", - "ReleaseStatus": "2023-02-21", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", + "safeName": "azureresourcemanagerkusto", + "name": "azure-resourcemanager-kusto", + "triggeringPaths": [ + "/sdk/kusto/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.kusto", "com.azure.resourcemanager.kusto.fluent", From 5f28ff028f4c6aa6bba0975f443ff90b09942072 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 03:29:04 +0000 Subject: [PATCH 29/52] Update docs metadata --- .../resourcemanager-education-readme.md | 20 +++++++++---------- .../azure-resourcemanager-education.json | 16 ++++++++++----- 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-education-readme.md b/docs-ref-services/preview/resourcemanager-education-readme.md index 4fb6cc92c0a24..baec8b092e42d 100644 --- a/docs-ref-services/preview/resourcemanager-education-readme.md +++ b/docs-ref-services/preview/resourcemanager-education-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager Education client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-education, education -ms.date: 10/14/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: education --- -# Azure Resource Manager Education client library for Java - version 1.0.0-beta.4 +# Azure Resource Manager Education client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager Education client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-education - 1.0.0-beta.4 + 1.0.0-beta.5 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-education_1.0.0-beta.4/sdk/education/azure-resourcemanager-education/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/education/azure-resourcemanager-education/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-education_1.0.0-beta.4/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-education_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-education_1.0.0-beta.4/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-education_1.0.0-beta.4/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-education_1.0.0-beta.4/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-education_1.0.0-beta.4/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-education.json b/metadata/preview/azure-resourcemanager-education.json index 5a5367eb0e243..5fc32ebfd2a54 100644 --- a/metadata/preview/azure-resourcemanager-education.json +++ b/metadata/preview/azure-resourcemanager-education.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-education", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/education/azure-resourcemanager-education", "ServiceDirectory": "education", "ReadMePath": "sdk/education/azure-resourcemanager-education/README.md", @@ -10,13 +10,19 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-education", - "ReleaseStatus": "2024-10-14", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "name": "azure-resourcemanager-education", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagereducation" + "triggeringPaths": [ + "/sdk/education/ci.yml" + ], + "safeName": "azureresourcemanagereducation", + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, "Namespaces": [ "com.azure.resourcemanager.education", From 2280f8e07fb4f7d3200b7687a9f8f60671d887a8 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 03:29:37 +0000 Subject: [PATCH 30/52] Update docs metadata --- .../preview/iot-modelsrepository-readme.md | 16 ++++---- .../preview/azure-iot-modelsrepository.json | 38 ++++++++++++++----- 2 files changed, 36 insertions(+), 18 deletions(-) diff --git a/docs-ref-services/preview/iot-modelsrepository-readme.md b/docs-ref-services/preview/iot-modelsrepository-readme.md index f1710ea8d5826..27651addde7bf 100644 --- a/docs-ref-services/preview/iot-modelsrepository-readme.md +++ b/docs-ref-services/preview/iot-modelsrepository-readme.md @@ -1,12 +1,12 @@ --- title: Azure IoT Models Repository client library for Java -keywords: Azure, java, SDK, API, azure-iot-modelsrepository, -ms.date: 03/30/2021 +keywords: Azure, java, SDK, API, azure-iot-modelsrepository, modelsrepository +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java -ms.service: +ms.service: modelsrepository --- -# Azure IoT Models Repository client library for Java - version 1.0.0-beta.1 +# Azure IoT Models Repository client library for Java - version 1.0.0-alpha.20251024.1 This library provides functionality for interacting with the [Azure IoT Models Repository][modelsrepository_iot_endpoint]. It also aims to provide a consistent experience working with digital twin model repositories following Azure IoT conventions. @@ -27,7 +27,7 @@ For the best development experience, developers should use the official Microsof com.azure azure-iot-modelsrepository - 1.0.0-beta.1 + 1.0.0-beta.2 ``` @@ -65,7 +65,7 @@ See implementation examples with our [code samples][modelsrepository_samples]. 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 . +For details, visit . 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. @@ -78,9 +78,9 @@ For more information see the Code of Conduct FAQ or contact opencode@microsoft.c [microsoft_sdk_download]: https://azure.microsoft.com/downloads/?sdk=net [code_of_conduct]: https://opensource.microsoft.com/codeofconduct/ [modelsrepository_iot_endpoint]: https://devicemodels.azure.com/ -[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-iot-modelsrepository_1.0.0-beta.1/sdk/modelsrepository/azure-iot-modelsrepository/src +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/modelsrepository/azure-iot-modelsrepository/src [modelsrepository_conventions]: https://github.com/Azure/iot-plugandplay-models-tools/wiki [json_ld_reference]: https://json-ld.org [dtdlv2_reference]: https://github.com/Azure/opendigitaltwins-dtdl/blob/master/DTDL/v2/dtdlv2.md -[modelsrepository_samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-iot-modelsrepository_1.0.0-beta.1/sdk/modelsrepository/azure-iot-modelsrepository/src/samples +[modelsrepository_samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/modelsrepository/azure-iot-modelsrepository/src/samples diff --git a/metadata/preview/azure-iot-modelsrepository.json b/metadata/preview/azure-iot-modelsrepository.json index 49bf3143c365c..ca123603ebcfa 100644 --- a/metadata/preview/azure-iot-modelsrepository.json +++ b/metadata/preview/azure-iot-modelsrepository.json @@ -1,16 +1,34 @@ { - "ServiceDirectory": "NA", - "DocsCiConfigProperties": { - "excludePath": [], - "inputPath": [] - }, "Name": "azure-iot-modelsrepository", - "SdkType": "NA", - "Version": "1.0.0-beta.1", - "IsNewSdk": false, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", + "DirectoryPath": "sdk/modelsrepository/azure-iot-modelsrepository", + "ServiceDirectory": "modelsrepository", + "ReadMePath": "sdk/modelsrepository/azure-iot-modelsrepository/README.md", + "ChangeLogPath": "sdk/modelsrepository/azure-iot-modelsrepository/CHANGELOG.md", "Group": "com.azure", - "DirectoryPath": "", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-iot-modelsrepository", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "name": "azure-iot-modelsrepository", + "groupId": "com.azure", + "safeName": "azureiotmodelsrepository", + "triggeringPaths": [ + "/sdk/modelsrepository/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.iot.modelsrepository" - ] + ], + "DocsCiConfigProperties": { + "excludePath": [], + "inputPath": [] + } } From ad61c16d7e686873e83b4d6444f465498b87b940 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 04:01:28 +0000 Subject: [PATCH 31/52] Update docs metadata --- .../resourcemanager-datamigration-readme.md | 29 ++++++++++++------- .../azure-resourcemanager-datamigration.json | 12 ++++---- 2 files changed, 24 insertions(+), 17 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-datamigration-readme.md b/docs-ref-services/preview/resourcemanager-datamigration-readme.md index c66d18b10f30c..bc75840ca4b16 100644 --- a/docs-ref-services/preview/resourcemanager-datamigration-readme.md +++ b/docs-ref-services/preview/resourcemanager-datamigration-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager DataMigration client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-datamigration, datamigration -ms.date: 07/28/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: datamigration --- -# Azure Resource Manager DataMigration client library for Java - version 1.1.0-beta.1 +# Azure Resource Manager DataMigration client library for Java - version 1.3.0-alpha.20251024.1 Azure Resource Manager DataMigration client library for Java. -This package contains Microsoft Azure SDK for DataMigration Management SDK. Data Migration Client. Package tag package-preview-2025-03. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for DataMigration Management SDK. Data Migration Client. Package tag package-2025-06. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-datamigration - 1.1.0-beta.1 + 1.2.0 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,14 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-datamigration_1.1.0-beta.1/sdk/datamigration/azure-resourcemanager-datamigration/SAMPLE.md) +```java +service = dataMigrationManager.migrationServices() + .define(serviceName) + .withRegion(REGION) + .withExistingResourceGroup(resourceGroupName) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/datamigration/azure-resourcemanager-datamigration/SAMPLE.md) ## Troubleshooting @@ -101,12 +108,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-datamigration_1.1.0-beta.1/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-datamigration_1.1.0-beta.1/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-datamigration_1.1.0-beta.1/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-datamigration_1.1.0-beta.1/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-datamigration_1.1.0-beta.1/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-datamigration_1.1.0-beta.1/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-datamigration.json b/metadata/preview/azure-resourcemanager-datamigration.json index 61201b000d430..e01339e27705f 100644 --- a/metadata/preview/azure-resourcemanager-datamigration.json +++ b/metadata/preview/azure-resourcemanager-datamigration.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-datamigration", - "Version": "1.1.0-beta.1", - "DevVersion": null, + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", "DirectoryPath": "sdk/datamigration/azure-resourcemanager-datamigration", "ServiceDirectory": "datamigration", "ReadMePath": "sdk/datamigration/azure-resourcemanager-datamigration/README.md", @@ -10,16 +10,16 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-datamigration", - "ReleaseStatus": "2025-07-28", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", "triggeringPaths": [ "/sdk/datamigration/ci.yml" ], - "groupId": "com.azure.resourcemanager", - "name": "azure-resourcemanager-datamigration", - "safeName": "azureresourcemanagerdatamigration" + "safeName": "azureresourcemanagerdatamigration", + "name": "azure-resourcemanager-datamigration" }, "CIParameters": { "CIMatrixConfigs": [] From 84078bfd1e86137368185f6db6aa87403be85d14 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 04:09:55 +0000 Subject: [PATCH 32/52] Update docs metadata --- .../preview/resourcemanager-orbital-readme.md | 20 +++++++++---------- .../azure-resourcemanager-orbital.json | 16 ++++++++++----- 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-orbital-readme.md b/docs-ref-services/preview/resourcemanager-orbital-readme.md index c91e81c723f2c..a81a0afd289e7 100644 --- a/docs-ref-services/preview/resourcemanager-orbital-readme.md +++ b/docs-ref-services/preview/resourcemanager-orbital-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager orbital client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-orbital, orbital -ms.date: 10/31/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: orbital --- -# Azure Resource Manager orbital client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager orbital client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager orbital client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-orbital - 1.0.0-beta.3 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-orbital_1.0.0-beta.3/sdk/orbital/azure-resourcemanager-orbital/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/orbital/azure-resourcemanager-orbital/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-orbital_1.0.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-orbital_1.0.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-orbital_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-orbital_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-orbital_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-orbital_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-orbital.json b/metadata/preview/azure-resourcemanager-orbital.json index 79602eff50626..cae5926b121dc 100644 --- a/metadata/preview/azure-resourcemanager-orbital.json +++ b/metadata/preview/azure-resourcemanager-orbital.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-orbital", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/orbital/azure-resourcemanager-orbital", "ServiceDirectory": "orbital", "ReadMePath": "sdk/orbital/azure-resourcemanager-orbital/README.md", @@ -10,19 +10,25 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-orbital", - "ReleaseStatus": "2024-10-31", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "name": "azure-resourcemanager-orbital", "groupId": "com.azure.resourcemanager", + "triggeringPaths": [ + "/sdk/orbital/ci.yml" + ], "safeName": "azureresourcemanagerorbital" }, - "CIMatrixConfigs": [], + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.orbital", "com.azure.resourcemanager.orbital.fluent", "com.azure.resourcemanager.orbital.fluent.models", "com.azure.resourcemanager.orbital.models" - ] + ], + "CIMatrixConfigs": [] } From 14c5d7a00bebcf72861a510e3a7b91409d4623fb Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 04:10:23 +0000 Subject: [PATCH 33/52] Update docs metadata --- .../preview/communication-callautomation-readme.md | 6 +++--- .../preview/azure-communication-callautomation.json | 10 +++++----- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs-ref-services/preview/communication-callautomation-readme.md b/docs-ref-services/preview/communication-callautomation-readme.md index 243ae1c4d8cc0..69b9dd56d1bfa 100644 --- a/docs-ref-services/preview/communication-callautomation-readme.md +++ b/docs-ref-services/preview/communication-callautomation-readme.md @@ -1,12 +1,12 @@ --- title: Azure Communication Call Automation Service client library for Java keywords: Azure, java, SDK, API, azure-communication-callautomation, communication/azure-communication-callautomation -ms.date: 08/26/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: communication/azure-communication-callautomation --- -# Azure Communication Call Automation Service client library for Java - version 1.6.0-beta.1 +# Azure Communication Call Automation Service client library for Java - version 1.6.0-alpha.20251024.1 This package contains a Java SDK for Azure Communication Call Automation Service. @@ -86,7 +86,7 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [product_docs]: https://learn.microsoft.com/azure/communication-services/ [package]: https://dev.azure.com/azure-sdk/public/_artifacts/feed/azure-sdk-for-java-communication-interaction [api_documentation]: https://aka.ms/java-docs -[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-communication-callautomation_1.6.0-beta.1/sdk/communication/azure-communication-callautomation/src +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/communication/azure-communication-callautomation/src [overview]: https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/call-automation [incomingcall]: https://learn.microsoft.com/azure/communication-services/concepts/voice-video-calling/incoming-call-notification [build1]: https://learn.microsoft.com/azure/communication-services/quickstarts/voice-video-calling/callflows-for-customer-interactions?pivots=programming-language-java diff --git a/metadata/preview/azure-communication-callautomation.json b/metadata/preview/azure-communication-callautomation.json index 6c72ca7108cb4..71e19e099243d 100644 --- a/metadata/preview/azure-communication-callautomation.json +++ b/metadata/preview/azure-communication-callautomation.json @@ -1,7 +1,7 @@ { "Name": "azure-communication-callautomation", - "Version": "1.6.0-beta.1", - "DevVersion": null, + "Version": "1.6.0-alpha.20251024.1", + "DevVersion": "1.6.0-alpha.20251024.1", "DirectoryPath": "sdk/communication/azure-communication-callautomation", "ServiceDirectory": "communication/azure-communication-callautomation", "ReadMePath": "sdk/communication/azure-communication-callautomation/README.md", @@ -10,16 +10,16 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-communication-callautomation", - "ReleaseStatus": "2025-08-25", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "groupId": "com.azure", "name": "azure-communication-callautomation", "safeName": "azurecommunicationcallautomation", "triggeringPaths": [ "/sdk/communication/azure-communication-callautomation/ci.yml" - ] + ], + "groupId": "com.azure" }, "CIParameters": { "CIMatrixConfigs": [] From 0cce6924e35c961d41c493dfb924b11bd5091b8a Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 04:40:46 +0000 Subject: [PATCH 34/52] Update docs metadata --- .../resourcemanager-redisenterprise-readme.md | 22 +++++++++---------- ...azure-resourcemanager-redisenterprise.json | 10 ++++----- 2 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-redisenterprise-readme.md b/docs-ref-services/preview/resourcemanager-redisenterprise-readme.md index 1283082fe85c9..f9686acf191bf 100644 --- a/docs-ref-services/preview/resourcemanager-redisenterprise-readme.md +++ b/docs-ref-services/preview/resourcemanager-redisenterprise-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager RedisEnterprise client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-redisenterprise, redisenterprise -ms.date: 05/06/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: redisenterprise --- -# Azure Resource Manager RedisEnterprise client library for Java - version 2.1.0-beta.3 +# Azure Resource Manager RedisEnterprise client library for Java - version 2.2.0-alpha.20251024.1 Azure Resource Manager RedisEnterprise client library for Java. -This package contains Microsoft Azure SDK for RedisEnterprise Management SDK. REST API for managing Redis Enterprise resources in Azure. Package tag package-preview-2025-05-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for RedisEnterprise Management SDK. REST API for managing Redis Enterprise resources in Azure. Package tag package-2025-07-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-redisenterprise - 2.1.0-beta.3 + 2.1.0 ``` [//]: # ({x-version-update-end}) @@ -89,7 +89,7 @@ cluster = redisEnterpriseManager.redisEnterprises() .withMinimumTlsVersion(TlsVersion.ONE_TWO) .create(); ``` -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-redisenterprise_2.1.0-beta.3/sdk/redisenterprise/azure-resourcemanager-redisenterprise/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/redisenterprise/azure-resourcemanager-redisenterprise/SAMPLE.md) ## Troubleshooting @@ -111,12 +111,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-redisenterprise_2.1.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-redisenterprise_2.1.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-redisenterprise_2.1.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-redisenterprise_2.1.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-redisenterprise_2.1.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-redisenterprise_2.1.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-redisenterprise.json b/metadata/preview/azure-resourcemanager-redisenterprise.json index f51de68451b36..5b31cb456ae4e 100644 --- a/metadata/preview/azure-resourcemanager-redisenterprise.json +++ b/metadata/preview/azure-resourcemanager-redisenterprise.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-redisenterprise", - "Version": "2.1.0-beta.3", - "DevVersion": null, + "Version": "2.2.0-alpha.20251024.1", + "DevVersion": "2.2.0-alpha.20251024.1", "DirectoryPath": "sdk/redisenterprise/azure-resourcemanager-redisenterprise", "ServiceDirectory": "redisenterprise", "ReadMePath": "sdk/redisenterprise/azure-resourcemanager-redisenterprise/README.md", @@ -10,15 +10,15 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-redisenterprise", - "ReleaseStatus": "2025-05-06", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerredisenterprise", "triggeringPaths": [ "/sdk/redisenterprise/ci.yml" ], + "safeName": "azureresourcemanagerredisenterprise", + "groupId": "com.azure.resourcemanager", "name": "azure-resourcemanager-redisenterprise" }, "CIParameters": { From 78d33367625c8ffd5955cda6261a31acaf1db178 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 04:55:52 +0000 Subject: [PATCH 35/52] Update docs metadata --- .../resourcemanager-changeanalysis-readme.md | 57 +++++++++++-------- .../azure-resourcemanager-changeanalysis.json | 33 +++++++++++ 2 files changed, 66 insertions(+), 24 deletions(-) create mode 100644 metadata/preview/azure-resourcemanager-changeanalysis.json diff --git a/docs-ref-services/preview/resourcemanager-changeanalysis-readme.md b/docs-ref-services/preview/resourcemanager-changeanalysis-readme.md index 37732d67c2c97..9f78067673f25 100644 --- a/docs-ref-services/preview/resourcemanager-changeanalysis-readme.md +++ b/docs-ref-services/preview/resourcemanager-changeanalysis-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager AzureChangeAnalysis client library for Java -keywords: Azure, java, SDK, API, azure-resourcemanager-changeanalysis, -ms.date: 03/26/2021 +keywords: Azure, java, SDK, API, azure-resourcemanager-changeanalysis, changeanalysis +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java -ms.service: +ms.service: changeanalysis --- -# Azure Resource Manager AzureChangeAnalysis client library for Java - version 1.0.0-beta.1 +# Azure Resource Manager AzureChangeAnalysis client library for Java - version 1.2.0-alpha.20251024.1 Azure Resource Manager AzureChangeAnalysis client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-changeanalysis - 1.0.0-beta.1 + 1.2.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -50,19 +50,15 @@ Various documentation is available to help you get started Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client. -[Azure Identity][azure_identity] package and [Azure Core Netty HTTP][azure_core_http_netty] package provide the default implementation. +[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation. ### Authentication -By default, Azure Active Directory token authentication depends on correct configure of following environment variables. +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. -- `AZURE_CLIENT_ID` for Azure client ID. -- `AZURE_TENANT_ID` for Azure tenant ID. -- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate. +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. -In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`. - -With above configuration, `azure` client can be authenticated by following code: +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); @@ -83,27 +79,40 @@ See [API design][design] for general introduction on design and key concepts on ## Examples +```java +OffsetDateTime nowDateTime = OffsetDateTime.now(); + azureChangeAnalysisManager.changes().list(nowDateTime.minusWeeks(2), nowDateTime).stream().count() > 0); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/changeanalysis/azure-resourcemanager-changeanalysis/SAMPLE.md) + + ## Troubleshooting ## Next steps ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-changeanalysis_1.0.0-beta.1/CONTRIBUTING.md). +For details on contributing to this repository, see the [contributing guide][cg]. -1. Fork it -1. Create your feature branch (`git checkout -b my-new-feature`) -1. Commit your changes (`git commit -am 'Add some feature'`) -1. Push to the branch (`git push origin my-new-feature`) -1. Create new Pull Request +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 . + +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 repositories 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 with any additional questions or comments. [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS [docs]: https://azure.github.io/azure-sdk-for-java/ -[jdk]: https://docs.microsoft.com/java/azure/jdk/ +[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-resourcemanager-changeanalysis_1.0.0-beta.1/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-changeanalysis_1.0.0-beta.1/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-changeanalysis_1.0.0-beta.1/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-changeanalysis_1.0.0-beta.1/sdk/resourcemanager/docs/DESIGN.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + diff --git a/metadata/preview/azure-resourcemanager-changeanalysis.json b/metadata/preview/azure-resourcemanager-changeanalysis.json new file mode 100644 index 0000000000000..d2473d947b812 --- /dev/null +++ b/metadata/preview/azure-resourcemanager-changeanalysis.json @@ -0,0 +1,33 @@ +{ + "Name": "azure-resourcemanager-changeanalysis", + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", + "DirectoryPath": "sdk/changeanalysis/azure-resourcemanager-changeanalysis", + "ServiceDirectory": "changeanalysis", + "ReadMePath": "sdk/changeanalysis/azure-resourcemanager-changeanalysis/README.md", + "ChangeLogPath": "sdk/changeanalysis/azure-resourcemanager-changeanalysis/CHANGELOG.md", + "Group": "com.azure.resourcemanager", + "SdkType": "mgmt", + "IsNewSdk": true, + "ArtifactName": "azure-resourcemanager-changeanalysis", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", + "triggeringPaths": [ + "/sdk/changeanalysis/ci.yml" + ], + "name": "azure-resourcemanager-changeanalysis", + "safeName": "azureresourcemanagerchangeanalysis" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.resourcemanager.changeanalysis", + "com.azure.resourcemanager.changeanalysis.fluent", + "com.azure.resourcemanager.changeanalysis.fluent.models", + "com.azure.resourcemanager.changeanalysis.models" + ] +} From d4223f10e6bfb1c96809b24f795378d94d02c5a2 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:14:39 +0000 Subject: [PATCH 36/52] Update docs metadata --- .../resourcemanager-devtestlabs-readme.md | 44 +++++++++++-------- .../azure-resourcemanager-devtestlabs.json | 19 ++++++-- 2 files changed, 41 insertions(+), 22 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-devtestlabs-readme.md b/docs-ref-services/preview/resourcemanager-devtestlabs-readme.md index 66b355a34022a..6a6ed42d1f19a 100644 --- a/docs-ref-services/preview/resourcemanager-devtestlabs-readme.md +++ b/docs-ref-services/preview/resourcemanager-devtestlabs-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager DevTestLabs client library for Java -keywords: Azure, java, SDK, API, azure-resourcemanager-devtestlabs, devtestlabs -ms.date: 01/17/2023 +keywords: Azure, java, SDK, API, azure-resourcemanager-devtestlabs, devtest-lab +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java -ms.service: devtestlabs +ms.service: devtest-lab --- -# Azure Resource Manager DevTestLabs client library for Java - version 1.0.0-beta.2 +# Azure Resource Manager DevTestLabs client library for Java - version 1.2.0-alpha.20251024.1 Azure Resource Manager DevTestLabs client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-devtestlabs - 1.0.0-beta.2 + 1.2.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -54,15 +54,11 @@ Azure Management Libraries require a `TokenCredential` implementation for authen ### Authentication -By default, Azure Active Directory token authentication depends on correct configuration of the following environment variables. +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. -- `AZURE_CLIENT_ID` for Azure client ID. -- `AZURE_TENANT_ID` for Azure tenant ID. -- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate. +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. -In addition, Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. - -With above configuration, `azure` client can be authenticated using the following code: +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); @@ -83,7 +79,14 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-devtestlabs_1.0.0-beta.2/sdk/devtestlabs/azure-resourcemanager-devtestlabs/SAMPLE.md) +```java +lab = devTestLabsManager.labs() + .define(labName) + .withRegion(REGION) + .withExistingResourceGroup(resourceGroupName) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/devtestlabs/azure-resourcemanager-devtestlabs/SAMPLE.md) ## Troubleshooting @@ -103,13 +106,16 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS [docs]: https://azure.github.io/azure-sdk-for-java/ -[jdk]: /java/azure/jdk/ +[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-resourcemanager-devtestlabs_1.0.0-beta.2/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-devtestlabs_1.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-devtestlabs_1.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-devtestlabs_1.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-devtestlabs_1.0.0-beta.2/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + diff --git a/metadata/preview/azure-resourcemanager-devtestlabs.json b/metadata/preview/azure-resourcemanager-devtestlabs.json index eb7e9b475bc5d..66aae06913331 100644 --- a/metadata/preview/azure-resourcemanager-devtestlabs.json +++ b/metadata/preview/azure-resourcemanager-devtestlabs.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-devtestlabs", - "Version": "1.0.0-beta.2", - "DevVersion": null, + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", "DirectoryPath": "sdk/devtestlabs/azure-resourcemanager-devtestlabs", "ServiceDirectory": "devtestlabs", "ReadMePath": "sdk/devtestlabs/azure-resourcemanager-devtestlabs/README.md", @@ -10,7 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-devtestlabs", - "ReleaseStatus": "2023-01-17", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "name": "azure-resourcemanager-devtestlabs", + "safeName": "azureresourcemanagerdevtestlabs", + "groupId": "com.azure.resourcemanager", + "triggeringPaths": [ + "/sdk/devtestlabs/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.devtestlabs", "com.azure.resourcemanager.devtestlabs.fluent", From 7461fdd817186c1a11f21de42b64973c331b6aaf Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:18:12 +0000 Subject: [PATCH 37/52] Update docs metadata --- .../resourcemanager-dashboard-readme.md | 22 +++++++++---------- .../azure-resourcemanager-dashboard.json | 8 +++---- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-dashboard-readme.md b/docs-ref-services/preview/resourcemanager-dashboard-readme.md index b56d7ee49620f..d242a1a890b5b 100644 --- a/docs-ref-services/preview/resourcemanager-dashboard-readme.md +++ b/docs-ref-services/preview/resourcemanager-dashboard-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager Dashboard client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-dashboard, dashboard -ms.date: 08/07/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: dashboard --- -# Azure Resource Manager Dashboard client library for Java - version 1.2.0-beta.2 +# Azure Resource Manager Dashboard client library for Java - version 1.3.0-alpha.20251024.1 Azure Resource Manager Dashboard client library for Java. -This package contains Microsoft Azure SDK for Dashboard Management SDK. The Microsoft.Dashboard Rest API spec. Package api-version 2024-11-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for Dashboard Management SDK. The Microsoft.Dashboard Rest API spec. Package api-version 2025-08-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-dashboard - 1.2.0-beta.2 + 1.2.0 ``` [//]: # ({x-version-update-end}) @@ -87,7 +87,7 @@ grafana = dashboardManager.grafanas() .withIdentity(new ManagedServiceIdentity().withType(ManagedServiceIdentityType.SYSTEM_ASSIGNED)) .create(); ``` -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dashboard_1.2.0-beta.2/sdk/dashboard/azure-resourcemanager-dashboard/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/dashboard/azure-resourcemanager-dashboard/SAMPLE.md) ## Troubleshooting @@ -109,12 +109,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-dashboard_1.2.0-beta.2/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-dashboard_1.2.0-beta.2/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dashboard_1.2.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dashboard_1.2.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dashboard_1.2.0-beta.2/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dashboard_1.2.0-beta.2/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-dashboard.json b/metadata/preview/azure-resourcemanager-dashboard.json index 19423749cc5f3..577fe1ec4dc9b 100644 --- a/metadata/preview/azure-resourcemanager-dashboard.json +++ b/metadata/preview/azure-resourcemanager-dashboard.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-dashboard", - "Version": "1.2.0-beta.2", - "DevVersion": null, + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", "DirectoryPath": "sdk/dashboard/azure-resourcemanager-dashboard", "ServiceDirectory": "dashboard", "ReadMePath": "sdk/dashboard/azure-resourcemanager-dashboard/README.md", @@ -10,15 +10,15 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-dashboard", - "ReleaseStatus": "2025-07-21", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "safeName": "azureresourcemanagerdashboard", "triggeringPaths": [ "/sdk/dashboard/ci.yml" ], "groupId": "com.azure.resourcemanager", + "safeName": "azureresourcemanagerdashboard", "name": "azure-resourcemanager-dashboard" }, "CIParameters": { From a375361eb1e89939b0aad6ad85134b91ff46c23a Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:28:57 +0000 Subject: [PATCH 38/52] Update docs metadata --- .../preview/maps-route-readme.md | 39 ++++++++++--------- metadata/preview/azure-maps-route.json | 20 ++++++---- 2 files changed, 34 insertions(+), 25 deletions(-) diff --git a/docs-ref-services/preview/maps-route-readme.md b/docs-ref-services/preview/maps-route-readme.md index 7376e1c50aafc..f2750ce261eae 100644 --- a/docs-ref-services/preview/maps-route-readme.md +++ b/docs-ref-services/preview/maps-route-readme.md @@ -1,17 +1,17 @@ --- title: Azure Maps SDK Route client library for Java keywords: Azure, java, SDK, API, azure-maps-route, maps/azure-maps-route -ms.date: 12/27/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: maps/azure-maps-route --- -# Azure Maps SDK Route client library for Java - version 1.0.0-beta.3 +# Azure Maps SDK Route client library for Java - version 1.0.0-alpha.20251024.1 Azure Maps SDK Route client library for Java. -This package contains Microsoft Azure SDK for Route Management SDK which contains Azure Maps Route REST APIs. For documentation on how to use this package, please see [Azure Management Libraries for Java](/rest/api/maps/route). +This package contains Microsoft Azure SDK for Route Management SDK which contains Azure Maps Route REST APIs. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://learn.microsoft.com/rest/api/maps/route). [Source code][source] | [API reference documentation][docs] | [REST API documentation][rest_docs] | [Product documentation][product_docs] | [Samples][samples] @@ -35,7 +35,7 @@ Various documentation is available to help you get started com.azure azure-maps-route - 1.0.0-beta.3 + 1.0.0-beta.4 ``` [//]: # ({x-version-update-end}) @@ -50,7 +50,10 @@ Azure Maps Libraries require a `TokenCredential` implementation for authenticati There are 3 ways to authenticate the client: Shared key authentication, Microsoft Entra ID authentication, and shared access signature (SAS) authentication. -By default, Microsoft Entra ID token authentication depends on correct configure of following environment variables. +We recommend using Microsoft Entra ID with [`DefaultAzureCredential`][azure_identity]. This allows you to configure authentication through the `AZURE_TOKEN_CREDENTIALS` environment variable. +Set this variable as described in the [Learn documentation][customize_defaultAzureCredential], which provides the most up-to-date guidance and examples. + +By default, Microsoft Entra ID token authentication depends on correct configuration of the following environment variables. - `AZURE_CLIENT_ID` for Azure client ID. - `AZURE_TENANT_ID` for Azure tenant ID. @@ -77,7 +80,7 @@ MapsRouteAsyncClient client = builder.buildAsyncClient(); The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. -For SAS-based authentication, please refer to [AccountsListSasSamples.java][https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-route_1.0.0-beta.3/sdk/maps/azure-resourcemanager-maps/src/samples/java/com/azure/resourcemanager/maps/generated/AccountsListSasSamples.java]. +For SAS-based authentication, please refer to [AccountsListSasSamples.java][https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-resourcemanager-maps/src/samples/java/com/azure/resourcemanager/maps/generated/AccountsListSasSamples.java]. See [Authentication][authenticate] for more options. @@ -207,11 +210,11 @@ For example, if you search with an invalid coordinate, a error is returned, indi ## Next steps Several Azure Maps Route Java SDK samples are available to you in the SDK's GitHub repository. -[Azure Maps Route Samples](https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-route_1.0.0-beta.3/sdk/maps/azure-maps-route/src/samples) +[Azure Maps Route Samples](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-route/src/samples) ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-route_1.0.0-beta.3/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`) @@ -220,17 +223,17 @@ For details on contributing to this repository, see the [contributing guide](htt 1. Create new Pull Request -[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-route_1.0.0-beta.3/sdk/maps/azure-maps-route/src -[samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-route_1.0.0-beta.3/sdk/maps/azure-maps-route/src/samples -[rest_docs]: /rest/api/maps -[product_docs]: /azure/azure-maps/ +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-route/src +[samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-route/src/samples +[rest_docs]: https://learn.microsoft.com/rest/api/maps +[product_docs]: https://learn.microsoft.com/azure/azure-maps/ [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-maps-route_1.0.0-beta.3/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-route_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-route_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-route_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md - +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[customize_defaultAzureCredential]: https://aka.ms/azsdk/java/identity/credential-chains#how-to-customize-defaultazurecredential diff --git a/metadata/preview/azure-maps-route.json b/metadata/preview/azure-maps-route.json index 5102a55b71c32..6fb934e6456e2 100644 --- a/metadata/preview/azure-maps-route.json +++ b/metadata/preview/azure-maps-route.json @@ -1,7 +1,7 @@ { "Name": "azure-maps-route", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/maps/azure-maps-route", "ServiceDirectory": "maps/azure-maps-route", "ReadMePath": "sdk/maps/azure-maps-route/README.md", @@ -10,17 +10,23 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-maps-route", - "ReleaseStatus": "2024-12-27", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "safeName": "azuremapsroute", + "groupId": "com.azure", "name": "azure-maps-route", - "groupId": "com.azure" + "triggeringPaths": [ + "/sdk/maps/azure-maps-route/ci.yml" + ], + "safeName": "azuremapsroute" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.maps.route", "com.azure.maps.route.models" - ] + ], + "CIMatrixConfigs": [] } From 3e4ee4176a46ca8c94211ea8865c6ad4b32f52e9 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:29:35 +0000 Subject: [PATCH 39/52] Update docs metadata --- .../preview/communication-email-readme.md | 45 +++++-------------- .../preview/azure-communication-email.json | 6 +-- 2 files changed, 15 insertions(+), 36 deletions(-) diff --git a/docs-ref-services/preview/communication-email-readme.md b/docs-ref-services/preview/communication-email-readme.md index d737537467c84..896bdf3b99585 100644 --- a/docs-ref-services/preview/communication-email-readme.md +++ b/docs-ref-services/preview/communication-email-readme.md @@ -1,12 +1,12 @@ --- title: Azure Communication Email client library for Java keywords: Azure, java, SDK, API, azure-communication-email, communication/azure-communication-email -ms.date: 07/17/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: communication/azure-communication-email --- -# Azure Communication Email client library for Java - version 1.2.0-beta.1 +# Azure Communication Email client library for Java - version 1.2.0-alpha.20251024.1 This package contains the Java SDK for Azure Communication Services for Email. @@ -28,7 +28,7 @@ To create these resources, you can use the [Azure Portal][communication_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-email_1.2.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 @@ -44,7 +44,7 @@ To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/A ``` -and then include the direct dependency in the dependencies section without the version tag. +And then include the direct dependency in the dependencies section without the version tag. ```xml @@ -58,27 +58,27 @@ and then include the direct dependency in the dependencies section without the v #### 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-email;current}) +add the direct dependency to your project as follows. "VERSION" below should be the version number you want. Example: 1.0.22 ```xml com.azure azure-communication-email - 1.2.0-beta.1 + VERSION ``` -[//]: # ({x-version-update-end}) - ## Key concepts -> More details coming soon. +The email SDK provides two clients, a synchronous client and an asynchronous client: + +`EmailClient` and `EmailAsyncClient` provide an operation to send an email message (plain text or html). Inline images are supported for HTML formatted email message, making emails appealing for marketing campaigns. + +`EmailClient` and `EmailAsyncClient` also provide an operation to fetch the status of an email message sent. ## Examples -`EmailClient` provides the functionality to send email messages . +`EmailClient` provides the functionality to send email messages. ### Client Creation and Authentication @@ -177,27 +177,6 @@ PollResponse response = poller.waitForCompletion(); System.out.println("Operation Id: " + response.getValue().getId()); ``` -### Create a Poller from an Existing Operation ID - -If you have an operation ID from a previous send email request, you can create a poller to check the status of that operation at a later time. - -```java readme-sample-beginSendFromExistingOperationId -EmailMessage message = new EmailMessage() - .setSenderAddress("") - .setToRecipients("") - .setSubject("test subject") - .setBodyPlainText("test message"); - -SyncPoller poller = emailClient.beginSend(message); -PollResponse response = poller.waitForCompletion(); -String operationId = response.getValue().getId(); - -SyncPoller poller2 = emailClient.beginSend(operationId); -PollResponse response2 = poller2.waitForCompletion(); - -System.out.println("Status: " + response2.getValue().getStatus()); -``` - ### Send Email with Attachments Azure Communication Services support sending email with attachments. diff --git a/metadata/preview/azure-communication-email.json b/metadata/preview/azure-communication-email.json index 68e258ecf7375..b6e9e2ddd634f 100644 --- a/metadata/preview/azure-communication-email.json +++ b/metadata/preview/azure-communication-email.json @@ -1,7 +1,7 @@ { "Name": "azure-communication-email", - "Version": "1.2.0-beta.1", - "DevVersion": null, + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", "DirectoryPath": "sdk/communication/azure-communication-email", "ServiceDirectory": "communication/azure-communication-email", "ReadMePath": "sdk/communication/azure-communication-email/README.md", @@ -10,7 +10,7 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-communication-email", - "ReleaseStatus": "2025-07-16", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { From 5a7636975a7da81975db7bd714261034e2600371 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:29:54 +0000 Subject: [PATCH 40/52] Update docs metadata --- .../resourcemanager-hanaonazure-readme.md | 20 +++++++++---------- .../azure-resourcemanager-hanaonazure.json | 16 ++++++++++----- 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-hanaonazure-readme.md b/docs-ref-services/preview/resourcemanager-hanaonazure-readme.md index 2029e8e874ecf..4b2d1ef6722f2 100644 --- a/docs-ref-services/preview/resourcemanager-hanaonazure-readme.md +++ b/docs-ref-services/preview/resourcemanager-hanaonazure-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager Hana client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-hanaonazure, hanaonazure -ms.date: 10/17/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: hanaonazure --- -# Azure Resource Manager Hana client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager Hana client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager Hana client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-hanaonazure - 1.0.0-beta.3 + 1.0.0-beta.4 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hanaonazure_1.0.0-beta.3/sdk/hanaonazure/azure-resourcemanager-hanaonazure/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/hanaonazure/azure-resourcemanager-hanaonazure/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-hanaonazure_1.0.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-hanaonazure_1.0.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hanaonazure_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hanaonazure_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hanaonazure_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hanaonazure_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-hanaonazure.json b/metadata/preview/azure-resourcemanager-hanaonazure.json index 34bfe138bae01..420b0e1475122 100644 --- a/metadata/preview/azure-resourcemanager-hanaonazure.json +++ b/metadata/preview/azure-resourcemanager-hanaonazure.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-hanaonazure", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/hanaonazure/azure-resourcemanager-hanaonazure", "ServiceDirectory": "hanaonazure", "ReadMePath": "sdk/hanaonazure/azure-resourcemanager-hanaonazure/README.md", @@ -10,13 +10,19 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-hanaonazure", - "ReleaseStatus": "2024-10-17", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { + "triggeringPaths": [ + "/sdk/hanaonazure/ci.yml" + ], + "safeName": "azureresourcemanagerhanaonazure", "name": "azure-resourcemanager-hanaonazure", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerhanaonazure" + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, "Namespaces": [ "com.azure.resourcemanager.hanaonazure", From 246ec1373ac47d0d3df039707e7523d9440be1d6 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:30:32 +0000 Subject: [PATCH 41/52] Update docs metadata --- .../resourcemanager-dnsresolver-readme.md | 32 +++++++++---------- .../azure-resourcemanager-dnsresolver.json | 16 +++++++--- 2 files changed, 26 insertions(+), 22 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-dnsresolver-readme.md b/docs-ref-services/preview/resourcemanager-dnsresolver-readme.md index 68154698a7b1f..d98ad26ef223a 100644 --- a/docs-ref-services/preview/resourcemanager-dnsresolver-readme.md +++ b/docs-ref-services/preview/resourcemanager-dnsresolver-readme.md @@ -1,17 +1,17 @@ --- -title: Azure Resource Manager DnsResolver client library for Java +title: Azure Resource Manager Dns Resolver client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-dnsresolver, dnsresolver -ms.date: 10/23/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: dnsresolver --- -# Azure Resource Manager DnsResolver client library for Java - version 1.0.0-beta.4 +# Azure Resource Manager Dns Resolver client library for Java - version 1.2.0-alpha.20251024.1 -Azure Resource Manager DnsResolver client library for Java. +Azure Resource Manager Dns Resolver client library for Java. -This package contains Microsoft Azure SDK for DnsResolver Management SDK. DNS Resolver Client. Package tag package-preview-2023-07. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for Dns Resolver Management SDK. The DNS Resolver Management Client. Package api-version 2025-10-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-dnsresolver - 1.0.0-beta.4 + 1.2.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -61,7 +61,7 @@ Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java -AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); +AzureProfile profile = new AzureProfile(AzureCloud.AZURE_PUBLIC_CLOUD); TokenCredential credential = new DefaultAzureCredentialBuilder() .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint()) .build(); @@ -69,7 +69,7 @@ DnsResolverManager manager = DnsResolverManager .authenticate(credential, profile); ``` -The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. +The sample code assumes global Azure. Please change the `AzureCloud.AZURE_PUBLIC_CLOUD` variable if otherwise. See [Authentication][authenticate] for more options. @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dnsresolver_1.0.0-beta.4/sdk/dnsresolver/azure-resourcemanager-dnsresolver/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/dnsresolver/azure-resourcemanager-dnsresolver/SAMPLE.md) ## Troubleshooting @@ -101,14 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-dnsresolver_1.0.0-beta.4/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-dnsresolver_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dnsresolver_1.0.0-beta.4/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dnsresolver_1.0.0-beta.4/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dnsresolver_1.0.0-beta.4/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-dnsresolver_1.0.0-beta.4/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ - - diff --git a/metadata/preview/azure-resourcemanager-dnsresolver.json b/metadata/preview/azure-resourcemanager-dnsresolver.json index 8c9bce710d35e..79ef0d6d308d3 100644 --- a/metadata/preview/azure-resourcemanager-dnsresolver.json +++ b/metadata/preview/azure-resourcemanager-dnsresolver.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-dnsresolver", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", "DirectoryPath": "sdk/dnsresolver/azure-resourcemanager-dnsresolver", "ServiceDirectory": "dnsresolver", "ReadMePath": "sdk/dnsresolver/azure-resourcemanager-dnsresolver/README.md", @@ -10,13 +10,19 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-dnsresolver", - "ReleaseStatus": "2024-10-23", + "ReleaseStatus": "2025-10-07", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "name": "azure-resourcemanager-dnsresolver", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerdnsresolver" + "triggeringPaths": [ + "/sdk/dnsresolver/ci.yml" + ], + "safeName": "azureresourcemanagerdnsresolver", + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, "Namespaces": [ "com.azure.resourcemanager.dnsresolver", From 995a8efa4a0efed655349c069c5a8562a5cd4e73 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:42:16 +0000 Subject: [PATCH 42/52] Update docs metadata --- ...resourcemanager-extendedlocation-readme.md | 22 +++++++++---------- ...zure-resourcemanager-extendedlocation.json | 17 +++++++++++--- 2 files changed, 25 insertions(+), 14 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-extendedlocation-readme.md b/docs-ref-services/preview/resourcemanager-extendedlocation-readme.md index 2cd2042c418cf..ee1d694f6822e 100644 --- a/docs-ref-services/preview/resourcemanager-extendedlocation-readme.md +++ b/docs-ref-services/preview/resourcemanager-extendedlocation-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager CustomLocations client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-extendedlocation, extendedlocation -ms.date: 10/10/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: extendedlocation --- -# Azure Resource Manager CustomLocations client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager CustomLocations client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager CustomLocations client library for Java. -This package contains Microsoft Azure SDK for CustomLocations Management SDK. The customLocations Rest API spec. Package tag package-2021-08-31-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for CustomLocations Management SDK. The customLocations Rest API spec. Package tag package-2021-08-15. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-extendedlocation - 1.0.0-beta.3 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-extendedlocation_1.0.0-beta.3/sdk/extendedlocation/azure-resourcemanager-extendedlocation/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/extendedlocation/azure-resourcemanager-extendedlocation/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-extendedlocation_1.0.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-extendedlocation_1.0.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-extendedlocation_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-extendedlocation_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-extendedlocation_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-extendedlocation_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-extendedlocation.json b/metadata/preview/azure-resourcemanager-extendedlocation.json index 4df546684a2d0..9699198684d94 100644 --- a/metadata/preview/azure-resourcemanager-extendedlocation.json +++ b/metadata/preview/azure-resourcemanager-extendedlocation.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-extendedlocation", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/extendedlocation/azure-resourcemanager-extendedlocation", "ServiceDirectory": "extendedlocation", "ReadMePath": "sdk/extendedlocation/azure-resourcemanager-extendedlocation/README.md", @@ -10,9 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-extendedlocation", - "ReleaseStatus": "2024-10-10", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, + "ArtifactDetails": { + "name": "azure-resourcemanager-extendedlocation", + "groupId": "com.azure.resourcemanager", + "safeName": "azureresourcemanagerextendedlocation", + "triggeringPaths": [ + "/sdk/extendedlocation/ci.yml" + ] + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.extendedlocation", "com.azure.resourcemanager.extendedlocation.fluent", From 7ead9d1933d837ee5dc3c70bb7bc2e6f2f25931d Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:45:16 +0000 Subject: [PATCH 43/52] Update docs metadata --- .../preview/maps-search-readme.md | 37 ++++++++++--------- metadata/preview/azure-maps-search.json | 20 ++++++---- 2 files changed, 33 insertions(+), 24 deletions(-) diff --git a/docs-ref-services/preview/maps-search-readme.md b/docs-ref-services/preview/maps-search-readme.md index 16c8638eb4732..1bcc9460cd7ef 100644 --- a/docs-ref-services/preview/maps-search-readme.md +++ b/docs-ref-services/preview/maps-search-readme.md @@ -1,17 +1,17 @@ --- title: Azure Maps SDK Search client library for Java keywords: Azure, java, SDK, API, azure-maps-search, maps/azure-maps-search -ms.date: 12/27/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: maps/azure-maps-search --- -# Azure Maps SDK Search client library for Java - version 2.0.0-beta.2 +# Azure Maps SDK Search client library for Java - version 2.0.0-alpha.20251024.1 Azure Maps SDK Search client library for Java. -This package contains the Azure Maps SDK Search client library which contains Azure Maps Search APIs. For documentation on how to use this package, please see [Azure Maps Search SDK for Java](/rest/api/maps/search). +This package contains the Azure Maps SDK Search client library which contains Azure Maps Search APIs. For documentation on how to use this package, please see [Azure Maps Search SDK for Java](https://learn.microsoft.com/rest/api/maps/search). [Source code][source] | [API reference documentation][docs] | [REST API documentation][rest_docs] | [Product documentation][product_docs] | [Samples][samples] @@ -35,7 +35,7 @@ Various documentation is available to help you get started com.azure azure-maps-search - 2.0.0-beta.2 + 2.0.0-beta.3 ``` [//]: # ({x-version-update-end}) @@ -50,6 +50,9 @@ Azure Maps Libraries require a `TokenCredential` implementation for authenticati There are 3 ways to authenticate the client: Shared key authentication, Microsoft Entra ID authentication, and shared access signature (SAS) authentication. +We recommend using Microsoft Entra ID with [`DefaultAzureCredential`][azure_identity]. This allows you to configure authentication through the `AZURE_TOKEN_CREDENTIALS` environment variable. +Set this variable as described in the [Learn documentation][customize_defaultAzureCredential], which provides the most up-to-date guidance and examples. + By default, Microsoft Entra ID token authentication depends on correct configuration of the following environment variables. - `AZURE_CLIENT_ID` for Azure client ID. @@ -77,7 +80,7 @@ MapsSearchClient client = builder.buildClient(); The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. -For SAS-based authentication, please refer to [AccountsListSasSamples.java][https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-search_2.0.0-beta.2/sdk/maps/azure-resourcemanager-maps/src/samples/java/com/azure/resourcemanager/maps/generated/AccountsListSasSamples.java]. +For SAS-based authentication, please refer to [AccountsListSasSamples.java][https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-resourcemanager-maps/src/samples/java/com/azure/resourcemanager/maps/generated/AccountsListSasSamples.java]. See [Authentication][authenticate] for more options. @@ -176,11 +179,11 @@ For example, if you search with an invalid coordinate, a error is returned, indi ## Next steps Several Azure Maps Search Java SDK samples are available to you in the SDK's GitHub repository. -[Azure Maps Search Samples](https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-search_2.0.0-beta.2/sdk/maps/azure-maps-search/src/samples) +[Azure Maps Search Samples](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-search/src/samples) ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-search_2.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`) @@ -189,17 +192,17 @@ For details on contributing to this repository, see the [contributing guide](htt 1. Create new Pull Request -[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-search_2.0.0-beta.2/sdk/maps/azure-maps-search/src -[samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-search_2.0.0-beta.2/sdk/maps/azure-maps-search/src/samples -[rest_docs]: /rest/api/maps -[product_docs]: /azure/azure-maps/ +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-search/src +[samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-search/src/samples +[rest_docs]: https://learn.microsoft.com/rest/api/maps +[product_docs]: https://learn.microsoft.com/azure/azure-maps/ [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-maps-search_2.0.0-beta.2/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-search_2.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-search_2.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-search_2.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md - +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[customize_defaultAzureCredential]: https://aka.ms/azsdk/java/identity/credential-chains#how-to-customize-defaultazurecredential diff --git a/metadata/preview/azure-maps-search.json b/metadata/preview/azure-maps-search.json index 12249f4ff9206..fbf135f1aafb0 100644 --- a/metadata/preview/azure-maps-search.json +++ b/metadata/preview/azure-maps-search.json @@ -1,7 +1,7 @@ { "Name": "azure-maps-search", - "Version": "2.0.0-beta.2", - "DevVersion": null, + "Version": "2.0.0-alpha.20251024.1", + "DevVersion": "2.0.0-alpha.20251024.1", "DirectoryPath": "sdk/maps/azure-maps-search", "ServiceDirectory": "maps/azure-maps-search", "ReadMePath": "sdk/maps/azure-maps-search/README.md", @@ -10,17 +10,23 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-maps-search", - "ReleaseStatus": "2024-12-27", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "groupId": "com.azure", + "safeName": "azuremapssearch", + "triggeringPaths": [ + "/sdk/maps/azure-maps-search/ci.yml" + ], "name": "azure-maps-search", - "safeName": "azuremapssearch" + "groupId": "com.azure" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.maps.search", "com.azure.maps.search.models" - ] + ], + "CIMatrixConfigs": [] } From 34abf3511c133c33696143d0c195de17c840616c Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 05:57:30 +0000 Subject: [PATCH 44/52] Update docs metadata --- .../preview/maps-render-readme.md | 39 ++++++++++--------- metadata/preview/azure-maps-render.json | 20 ++++++---- 2 files changed, 34 insertions(+), 25 deletions(-) diff --git a/docs-ref-services/preview/maps-render-readme.md b/docs-ref-services/preview/maps-render-readme.md index f91b0e476e014..eca3a5f40e4e1 100644 --- a/docs-ref-services/preview/maps-render-readme.md +++ b/docs-ref-services/preview/maps-render-readme.md @@ -1,17 +1,17 @@ --- title: Azure Maps SDK Render client library for Java keywords: Azure, java, SDK, API, azure-maps-render, maps/azure-maps-render -ms.date: 12/27/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: maps/azure-maps-render --- -# Azure Maps SDK Render client library for Java - version 2.0.0-beta.2 +# Azure Maps SDK Render client library for Java - version 2.0.0-alpha.20251024.1 Azure Maps SDK Render client library for Java. -This package contains Microsoft Azure SDK for Render Management SDK which contains Azure Maps Render REST APIs. Azure Maps Render retrieves copyrigt information or map/state tiles. For documentation on how to use this package, please see [Azure Maps Render](/rest/api/maps/render-v2). +This package contains Microsoft Azure SDK for Render Management SDK which contains Azure Maps Render REST APIs. Azure Maps Render retrieves copyrigt information or map/state tiles. For documentation on how to use this package, please see [Azure Maps Render](https://learn.microsoft.com/rest/api/maps/render). [Source code][source] | [API reference documentation][docs] | [REST API documentation][rest_docs] | [Product documentation][product_docs] | [Samples][samples] @@ -35,7 +35,7 @@ Various documentation is available to help you get started com.azure azure-maps-render - 2.0.0-beta.2 + 2.0.0-beta.3 ``` [//]: # ({x-version-update-end}) @@ -50,7 +50,10 @@ Azure Maps Libraries require a `TokenCredential` implementation for authenticati There are 3 ways to authenticate the client: Shared key authentication, Microsoft Entra ID authentication, and shared access signature (SAS) authentication. -By default, Microsoft Entra ID token authentication depends on correct configure of following environment variables. +We recommend using Microsoft Entra ID with [`DefaultAzureCredential`][azure_identity]. This allows you to configure authentication through the `AZURE_TOKEN_CREDENTIALS` environment variable. +Set this variable as described in the [Learn documentation][customize_defaultAzureCredential], which provides the most up-to-date guidance and examples. + +By default, Microsoft Entra ID token authentication depends on correct configuration of the following environment variables. - `AZURE_CLIENT_ID` for Azure client ID. - `AZURE_TENANT_ID` for Azure tenant ID. @@ -77,7 +80,7 @@ MapsRenderClient client = builder.buildClient(); The sample code assumes global Azure. Please change `AzureEnvironment.AZURE` variable if otherwise. -For SAS-based authentication, please refer to [AccountsListSasSamples.java][https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-render_2.0.0-beta.2/sdk/maps/azure-resourcemanager-maps/src/samples/java/com/azure/resourcemanager/maps/generated/AccountsListSasSamples.java]. +For SAS-based authentication, please refer to [AccountsListSasSamples.java][https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-resourcemanager-maps/src/samples/java/com/azure/resourcemanager/maps/generated/AccountsListSasSamples.java]. See [Authentication][authenticate] for more options. @@ -151,11 +154,11 @@ For example, if you search with an invalid coordinate, a error is returned, indi ## Next steps Several Azure Maps Render Java SDK samples are available to you in the SDK's GitHub repository. -[Azure Maps Render Samples](https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-render_2.0.0-beta.2/sdk/maps/azure-maps-render/src/samples) +[Azure Maps Render Samples](https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-render/src/samples) ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-render_2.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`) @@ -164,17 +167,17 @@ For details on contributing to this repository, see the [contributing guide](htt 1. Create new Pull Request -[source]: https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-render_2.0.0-beta.2/sdk/maps/azure-maps-render/src -[samples]: https://github.com/Azure/azure-sdk-for-java/tree/azure-maps-render_2.0.0-beta.2/sdk/maps/azure-maps-render/src/samples -[rest_docs]: /rest/api/maps -[product_docs]: /azure/azure-maps/ +[source]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-render/src +[samples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/maps/azure-maps-render/src/samples +[rest_docs]: https://learn.microsoft.com/rest/api/maps +[product_docs]: https://learn.microsoft.com/azure/azure-maps/ [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-maps-render_2.0.0-beta.2/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-render_2.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-render_2.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-maps-render_2.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md - +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[customize_defaultAzureCredential]: https://aka.ms/azsdk/java/identity/credential-chains#how-to-customize-defaultazurecredential diff --git a/metadata/preview/azure-maps-render.json b/metadata/preview/azure-maps-render.json index 811a02c569e8a..f288e23b83051 100644 --- a/metadata/preview/azure-maps-render.json +++ b/metadata/preview/azure-maps-render.json @@ -1,7 +1,7 @@ { "Name": "azure-maps-render", - "Version": "2.0.0-beta.2", - "DevVersion": null, + "Version": "2.0.0-alpha.20251024.1", + "DevVersion": "2.0.0-alpha.20251024.1", "DirectoryPath": "sdk/maps/azure-maps-render", "ServiceDirectory": "maps/azure-maps-render", "ReadMePath": "sdk/maps/azure-maps-render/README.md", @@ -10,17 +10,23 @@ "SdkType": "client", "IsNewSdk": true, "ArtifactName": "azure-maps-render", - "ReleaseStatus": "2024-12-27", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "groupId": "com.azure", - "safeName": "azuremapsrender", - "name": "azure-maps-render" + "name": "azure-maps-render", + "triggeringPaths": [ + "/sdk/maps/azure-maps-render/ci.yml" + ], + "safeName": "azuremapsrender" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, - "CIMatrixConfigs": [], "Namespaces": [ "com.azure.maps.render", "com.azure.maps.render.models" - ] + ], + "CIMatrixConfigs": [] } From 6fa97e595488dd1aa09c54e8e616c914848dafe9 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:03:08 +0000 Subject: [PATCH 45/52] Update docs metadata --- ...resourcemanager-delegatednetwork-readme.md | 20 +++++++++---------- ...zure-resourcemanager-delegatednetwork.json | 16 ++++++++++----- 2 files changed, 21 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-delegatednetwork-readme.md b/docs-ref-services/preview/resourcemanager-delegatednetwork-readme.md index 9f12c48766e24..89da222ea522e 100644 --- a/docs-ref-services/preview/resourcemanager-delegatednetwork-readme.md +++ b/docs-ref-services/preview/resourcemanager-delegatednetwork-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager DelegatedNetwork client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-delegatednetwork, delegatednetwork -ms.date: 10/17/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: delegatednetwork --- -# Azure Resource Manager DelegatedNetwork client library for Java - version 1.0.0-beta.3 +# Azure Resource Manager DelegatedNetwork client library for Java - version 1.0.0-alpha.20251024.1 Azure Resource Manager DelegatedNetwork client library for Java. @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-delegatednetwork - 1.0.0-beta.3 + 1.0.0-beta.4 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-delegatednetwork_1.0.0-beta.3/sdk/delegatednetwork/azure-resourcemanager-delegatednetwork/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/delegatednetwork/azure-resourcemanager-delegatednetwork/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-delegatednetwork_1.0.0-beta.3/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-delegatednetwork_1.0.0-beta.3/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-delegatednetwork_1.0.0-beta.3/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-delegatednetwork_1.0.0-beta.3/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-delegatednetwork_1.0.0-beta.3/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-delegatednetwork_1.0.0-beta.3/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-delegatednetwork.json b/metadata/preview/azure-resourcemanager-delegatednetwork.json index 5115168a75dde..37b1ccbdb6bcc 100644 --- a/metadata/preview/azure-resourcemanager-delegatednetwork.json +++ b/metadata/preview/azure-resourcemanager-delegatednetwork.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-delegatednetwork", - "Version": "1.0.0-beta.3", - "DevVersion": null, + "Version": "1.0.0-alpha.20251024.1", + "DevVersion": "1.0.0-alpha.20251024.1", "DirectoryPath": "sdk/delegatednetwork/azure-resourcemanager-delegatednetwork", "ServiceDirectory": "delegatednetwork", "ReadMePath": "sdk/delegatednetwork/azure-resourcemanager-delegatednetwork/README.md", @@ -10,13 +10,19 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-delegatednetwork", - "ReleaseStatus": "2024-10-17", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "name": "azure-resourcemanager-delegatednetwork", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerdelegatednetwork" + "safeName": "azureresourcemanagerdelegatednetwork", + "triggeringPaths": [ + "/sdk/delegatednetwork/ci.yml" + ], + "groupId": "com.azure.resourcemanager" + }, + "CIParameters": { + "CIMatrixConfigs": [] }, "Namespaces": [ "com.azure.resourcemanager.delegatednetwork", From a082599e009820147405fa132551071b57bad173 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:04:29 +0000 Subject: [PATCH 46/52] Update docs metadata --- .../resourcemanager-healthcareapis-readme.md | 58 +++++++++++-------- .../azure-resourcemanager-healthcareapis.json | 19 +++++- 2 files changed, 50 insertions(+), 27 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-healthcareapis-readme.md b/docs-ref-services/preview/resourcemanager-healthcareapis-readme.md index 16dcb0a551613..642e55bc8f8b6 100644 --- a/docs-ref-services/preview/resourcemanager-healthcareapis-readme.md +++ b/docs-ref-services/preview/resourcemanager-healthcareapis-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager HealthcareApis client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-healthcareapis, healthcareapis -ms.date: 04/11/2022 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: healthcareapis --- -# Azure Resource Manager HealthcareApis client library for Java - version 1.0.0-beta.2 +# Azure Resource Manager HealthcareApis client library for Java - version 1.3.0-alpha.20251024.1 Azure Resource Manager HealthcareApis client library for Java. -This package contains Microsoft Azure SDK for HealthcareApis Management SDK. Azure Healthcare APIs Client. Package tag package-2021-11. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for HealthcareApis Management SDK. Azure Healthcare APIs Client. Package tag package-2024-03-31. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-healthcareapis - 1.0.0-beta.2 + 1.3.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -50,19 +50,15 @@ Various documentation is available to help you get started Azure Management Libraries require a `TokenCredential` implementation for authentication and an `HttpClient` implementation for HTTP client. -[Azure Identity][azure_identity] package and [Azure Core Netty HTTP][azure_core_http_netty] package provide the default implementation. +[Azure Identity][azure_identity] and [Azure Core Netty HTTP][azure_core_http_netty] packages provide the default implementation. ### Authentication -By default, Azure Active Directory token authentication depends on correct configure of following environment variables. +Microsoft Entra ID token authentication relies on the [credential class][azure_identity_credentials] from [Azure Identity][azure_identity] package. -- `AZURE_CLIENT_ID` for Azure client ID. -- `AZURE_TENANT_ID` for Azure tenant ID. -- `AZURE_CLIENT_SECRET` or `AZURE_CLIENT_CERTIFICATE_PATH` for client secret or client certificate. +Azure subscription ID can be configured via `AZURE_SUBSCRIPTION_ID` environment variable. -In addition, Azure subscription ID can be configured via environment variable `AZURE_SUBSCRIPTION_ID`. - -With above configuration, `azure` client can be authenticated by following code: +Assuming the use of the `DefaultAzureCredential` credential class, the client can be authenticated using the following code: ```java AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE); @@ -83,7 +79,15 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-healthcareapis_1.0.0-beta.2/sdk/healthcareapis/azure-resourcemanager-healthcareapis/SAMPLE.md) +```java +workspace = healthcareApisManager.workspaces() + .define(workspaceName) + .withExistingResourceGroup(resourceGroupName) + .withRegion(REGION) + .withProperties(new WorkspaceProperties().withPublicNetworkAccess(PublicNetworkAccess.DISABLED)) + .create(); +``` +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/healthcareapis/azure-resourcemanager-healthcareapis/SAMPLE.md) ## Troubleshooting @@ -92,21 +96,27 @@ See [API design][design] for general introduction on design and key concepts on ## Contributing -For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-healthcareapis_1.0.0-beta.2/CONTRIBUTING.md). +For details on contributing to this repository, see the [contributing guide][cg]. + +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 . -1. Fork it -1. Create your feature branch (`git checkout -b my-new-feature`) -1. Commit your changes (`git commit -am 'Add some feature'`) -1. Push to the branch (`git push origin my-new-feature`) -1. Create new Pull Request +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 repositories 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 with any additional questions or comments. [survey]: https://microsoft.qualtrics.com/jfe/form/SV_ehN0lIk2FKEBkwd?Q_CHL=DOCS [docs]: https://azure.github.io/azure-sdk-for-java/ -[jdk]: https://docs.microsoft.com/java/azure/jdk/ +[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-resourcemanager-healthcareapis_1.0.0-beta.2/sdk/identity/azure-identity -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-healthcareapis_1.0.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-healthcareapis_1.0.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-healthcareapis_1.0.0-beta.2/sdk/resourcemanager/docs/DESIGN.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ + + diff --git a/metadata/preview/azure-resourcemanager-healthcareapis.json b/metadata/preview/azure-resourcemanager-healthcareapis.json index 595649a532153..9bcd367f8c9ec 100644 --- a/metadata/preview/azure-resourcemanager-healthcareapis.json +++ b/metadata/preview/azure-resourcemanager-healthcareapis.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-healthcareapis", - "Version": "1.0.0-beta.2", - "DevVersion": null, + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", "DirectoryPath": "sdk/healthcareapis/azure-resourcemanager-healthcareapis", "ServiceDirectory": "healthcareapis", "ReadMePath": "sdk/healthcareapis/azure-resourcemanager-healthcareapis/README.md", @@ -10,7 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-healthcareapis", - "ReleaseStatus": "2022-04-11", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "safeName": "azureresourcemanagerhealthcareapis", + "triggeringPaths": [ + "/sdk/healthcareapis/ci.yml" + ], + "groupId": "com.azure.resourcemanager", + "name": "azure-resourcemanager-healthcareapis" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.healthcareapis", "com.azure.resourcemanager.healthcareapis.fluent", From 5cdda69732017c8f51f387860325df94636ab139 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:10:26 +0000 Subject: [PATCH 47/52] Update docs metadata --- .../preview/identity-extensions-readme.md | 57 +++++++++++++++++++ .../preview/azure-identity-extensions.json | 32 +++++++++++ 2 files changed, 89 insertions(+) create mode 100644 docs-ref-services/preview/identity-extensions-readme.md create mode 100644 metadata/preview/azure-identity-extensions.json diff --git a/docs-ref-services/preview/identity-extensions-readme.md b/docs-ref-services/preview/identity-extensions-readme.md new file mode 100644 index 0000000000000..2e0e4cc7c81d7 --- /dev/null +++ b/docs-ref-services/preview/identity-extensions-readme.md @@ -0,0 +1,57 @@ +--- +title: Azure identity authentication extensions plugin library for Java +keywords: Azure, java, SDK, API, azure-identity-extensions, entra-id +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: entra-id +--- +# Azure identity authentication extensions plugin library for Java - version 1.3.0-alpha.20251024.1 + + +This package contains authentication extensions to get a token from Microsoft Entra ID for Azure services, like Azure Database for MySQL. + +## Getting started + +### Prerequisites + +- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/). +- [Java Development Kit (JDK)][jdk] with version 8 or above. + - 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). +- [Apache Maven](https://maven.apache.org/download.cgi). + +## Key concepts + +Azure Identity Extensions contains a common template framework for users to get a token from Microsoft Entra ID and +use the token as a password. For example, to connect Azure hosted MySQL, get a token from Microsoft Entra ID and use the +token as a password to connect with MySQL. + +## Architecture + +### Authenticating with JDBC + +This picture shows how the JDBC authentication plugins provided by Azure Identity Extensions authenticate with managed identity. +![Architecture](https://raw.githubusercontent.com/Azure/azure-sdk-for-java/main/sdk/identity/azure-identity-extensions/img/passwordless-connections-from-java-apps-to-data-services.jpg) + +## Examples +For documentation on how to use this package, please refer to [Quickstart:Use Java and JDBC with Azure Database for MySQL](https://aka.ms/passwordless/quickstart/mysql) and [Quickstart:Use Java and JDBC with Azure Database for PostgreSQL](https://aka.ms/passwordless/quickstart/postgresql). + + +## Troubleshooting +If you encounter any bugs, please file issues via [Issues](https://github.com/Azure/azure-sdk-for-java/issues). + +## Next steps +Other useful docs are: +* [With Azure Database for MySQL][azure-identity-extensions-jdbc-mysql]: Azure identity extensions for Azure Database for MySQL. +* [With Azure Database for PostgreSQL][azure-identity-extensions-jdbc-postgresql]: Azure identity extensions for Azure Database for PostgreSQL. + + +## Contributing + +For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md). + + +[jdk]: https://learn.microsoft.com/java/azure/jdk/ +[azure-identity-extensions-jdbc-mysql]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity-extensions/Azure-Database-for-MySQL-README.md +[azure-identity-extensions-jdbc-postgresql]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity-extensions/Azure-Database-for-PostgreSQL-README.md + diff --git a/metadata/preview/azure-identity-extensions.json b/metadata/preview/azure-identity-extensions.json new file mode 100644 index 0000000000000..b2ef9f1e89161 --- /dev/null +++ b/metadata/preview/azure-identity-extensions.json @@ -0,0 +1,32 @@ +{ + "Name": "azure-identity-extensions", + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", + "DirectoryPath": "sdk/identity/azure-identity-extensions", + "ServiceDirectory": "identity/azure-identity-extensions", + "ReadMePath": "sdk/identity/azure-identity-extensions/README.md", + "ChangeLogPath": "sdk/identity/azure-identity-extensions/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-identity-extensions", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": null, + "ArtifactDetails": { + "safeName": "azureidentityextensions", + "triggeringPaths": [ + "/sdk/identity/azure-identity-extensions/ci.yml" + ], + "name": "azure-identity-extensions", + "groupId": "com.azure", + "releaseInBatch": "${{ parameters.release_azureidentityextensions }}" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.identity.extensions.jdbc.mysql", + "com.azure.identity.extensions.jdbc.postgresql" + ] +} From 927b353f9862959bd9c59d815770021ce0f78118 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:18:54 +0000 Subject: [PATCH 48/52] Update docs metadata --- .../preview/ai-formrecognizer-readme.md | 748 ++++++++++++++++++ metadata/preview/azure-ai-formrecognizer.json | 40 + 2 files changed, 788 insertions(+) create mode 100644 docs-ref-services/preview/ai-formrecognizer-readme.md create mode 100644 metadata/preview/azure-ai-formrecognizer.json diff --git a/docs-ref-services/preview/ai-formrecognizer-readme.md b/docs-ref-services/preview/ai-formrecognizer-readme.md new file mode 100644 index 0000000000000..f4698bccd93ae --- /dev/null +++ b/docs-ref-services/preview/ai-formrecognizer-readme.md @@ -0,0 +1,748 @@ +--- +title: Azure Document Intelligence client library for Java +keywords: Azure, java, SDK, API, azure-ai-formrecognizer, formrecognizer +ms.date: 10/25/2025 +ms.topic: reference +ms.devlang: java +ms.service: formrecognizer +--- +# Azure Document Intelligence client library for Java - version 4.2.0-alpha.20251024.1 + +Azure Document Intelligence ([previously known as Form Recognizer][service-rename]) is a cloud service that uses machine +learning to analyze text and structured data from your documents. +It includes the following main features: + +* Layout - Extract text, table structures, and selection marks, along with their bounding region coordinates, from documents. +* Document - Analyze entities, key-value pairs, tables, and selection marks from documents using the general prebuilt document model. +* Prebuilt - Analyze data from certain types of common documents (such as receipts, invoices, business cards, identity documents or US W2 tax forms) using prebuilt models. +* Custom - Build custom models to extract text, field values, selection marks, and table data from documents. Custom models are built with your own data, so they're tailored to your documents. +* Read - Read information about textual elements, such as page words and lines in addition to text language information. +* Classifiers - Build custom classifiers to categorize documents into predefined classes. + +[Source code][source_code] | [Package (Maven)][package] | [API reference documentation][api_reference_doc] | [Product Documentation][product_documentation] | [Samples][sample_readme] + +## Getting started + +### Prerequisites +- A [Java Development Kit (JDK)][jdk_link], version 8 or later. + - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis). +- [Azure Subscription][azure_subscription] +- [Cognitive Services or Form Recognizer account][form_recognizer_account] to use this package. + +### Include the Package + +#### Include the BOM file + +Do include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number. +To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md). + +```xml + + + + com.azure + azure-sdk-bom + {bom_version_to_target} + pom + import + + + +``` +Then, include the direct dependency in the dependencies' section without the version tag. + +```xml + + + com.azure + azure-ai-formrecognizer + + +``` + +#### Include direct dependency +If you want to take dependency on a particular version of the library that is not present in the BOM, +add the direct dependency to your project as follows. + +[//]: # ({x-version-update-start;com.azure:azure-ai-formrecognizer;current}) +```xml + + com.azure + azure-ai-formrecognizer + 4.2.0-beta.1 + +``` +[//]: # ({x-version-update-end}) +> Note: This version of the client library defaults to the `"2023-07-31"` version of the service. + +This table shows the relationship between SDK versions and supported API versions of the service: + +| SDK version | Supported API version of service | +|----------------|--------------------------------------------| +| 3.0.x | 2.0 | +| 3.1.X - 3.1.12 | 2.0, 2.1 (default) | +| 4.0.0 | 2.0, 2.1, 2022-08-31 (default) | +| 4.1.0 > | 2.0, 2.1, 2022-08-31, 2023-07-31 (default) | + +> Note: Starting with version 4.0.X, a new set of clients were introduced to leverage the newest features +> of the Form Recognizer service. Please see the [Migration Guide][migration_guide] for detailed instructions on how to update application +> code from client library version 3.1.X or lower to the latest version. For more information, see [Changelog][changelog]. +> The below table describes the relationship of each client and its supported API version(s): + +| API version | Supported clients | +|-------------|--------------------------------------------------------------| +| 2023-07-31 | DocumentAnalysisClient and DocumentModelAdministrationClient | +| 2022-08-31 | DocumentAnalysisClient and DocumentModelAdministrationClient | +| 2.1 | FormRecognizerClient and FormTrainingClient | +| 2.0 | FormRecognizerClient and FormTrainingClient | + +#### Create a Form Recognizer resource +Form Recognizer supports both [multi-service and single-service access][service_access]. Create a Cognitive Service's +resource if you plan to access multiple cognitive services under a single endpoint/key. For Form Recognizer access only, +create a Form Recognizer resource. + +You can create either resource using the + +**Option 1:** [Azure portal][create_new_resource] + +**Option 2:** [Azure CLI][azure_cli] + +Below is an example of how you can create a Form Recognizer resource using the CLI: + +```bash +# Create a new resource group to hold the Form Recognizer resource - +# if using an existing resource group, skip this step +az group create --name --location +``` + +```bash +# Create Form Recognizer +az cognitiveservices account create \ + --name \ + --resource-group \ + --kind FormRecognizer \ + --sku \ + --location \ + --yes +``` +### Authenticate the client +In order to interact with the Form Recognizer service, you will need to create an instance of the Document Analysis client. +Both the asynchronous and synchronous clients can be created by using `DocumentAnalysisClientBuilder`. Invoking `buildClient()` +will create the synchronous client, while invoking `buildAsyncClient` will create its asynchronous counterpart. + +You will need an **endpoint**, and a **key** to instantiate a client object. + +#### Looking up the endpoint +You can find the **endpoint** for your Form Recognizer resource in the [Azure portal][azure_portal], +or [Azure CLI][azure_cli_endpoint]. +```bash +# Get the endpoint for the resource +az cognitiveservices account show --name "resource-name" --resource-group "resource-group-name" --query "endpoint" +``` + +#### Create a Document Analysis client using AzureKeyCredential +To use `AzureKeyCredential` authentication, provide the [key][key] as a string to the [AzureKeyCredential][azure_key_credential]. +This key can be found in the [Azure portal][azure_portal] in your created Form Recognizer +resource, or by running the following Azure CLI command to get the key from the Form Recognizer resource: + +```bash +az cognitiveservices account keys list --resource-group --name +``` +Use the API key as the credential parameter to authenticate the client: + +```java readme-sample-createDocumentAnalysisClient +DocumentAnalysisClient documentAnalysisClient = new DocumentAnalysisClientBuilder() + .credential(new AzureKeyCredential("{key}")) + .endpoint("{endpoint}") + .buildClient(); +``` + +```java readme-sample-createDocumentModelAdministrationClient +DocumentModelAdministrationClient client = + new DocumentModelAdministrationClientBuilder() + .credential(new AzureKeyCredential("{key}")) + .endpoint("{endpoint}") + .buildClient(); +``` + +#### Create a Document Analysis client with Azure Active Directory credential +Azure SDK for Java supports an Azure Identity package, making it easy to get credentials from Microsoft identity +platform. + +Authentication with AAD requires some initial setup: +* Add the Azure Identity package + +[//]: # ({x-version-update-start;com.azure:azure-identity;dependency}) +```xml + + com.azure + azure-identity + 1.18.1 + +``` +[//]: # ({x-version-update-end}) +* [Register a new Azure Active Directory application][register_AAD_application] +* [Grant access][grant_access] to Form Recognizer by assigning the `"Cognitive Services User"` role to your service principal. + +After setup, you can choose which type of [credential][azure_identity_credential_type] from `azure-identity` to use. +We recommend using [DefaultAzureCredential][identity_dac], configured through the `AZURE_TOKEN_CREDENTIALS` environment variable. +Set this variable as described in the [Learn documentation][customize_defaultAzureCredential], which provides the most up-to-date guidance and examples. + +```java readme-sample-createDocumentAnalysisClientWithAAD +DocumentAnalysisClient documentAnalysisClient = new DocumentAnalysisClientBuilder() + .endpoint("{endpoint}") + .credential(new DefaultAzureCredentialBuilder().build()) + .buildClient(); +``` + +## Key concepts +### DocumentAnalysisClient +The [DocumentAnalysisClient][document_analysis_sync_client] and [DocumentAnalysisAsyncClient][document_analysis_async_client] +provide both synchronous and asynchronous operations for analyzing input documents using custom and prebuilt models +through the `beginAnalyzeDocument` and `beginAnalyzeDocumentFromUrl` methods. +See a full list of supported models [here][fr_models]. + +Sample code snippets to illustrate using a DocumentAnalysisClient [here][sample_readme]. +More information about analyzing documents, including supported features, locales, and document types can be found +[here][fr_models]. + +### DocumentModelAdministrationClient +The [DocumentModelAdministrationClient][document_model_admin_sync_client] and +[DocumentModelAdministrationAsyncClient][document_model_admin_async_client] provide both synchronous and asynchronous operations +- Build custom document analysis models to analyze text content, fields, and values found in your custom documents. See example [Build a document model](#build-a-document-model). + A `DocumentModelDetails` is returned indicating the document types that the model can analyze, along with the fields and schemas it will extract. +- Managing models created in your account by building, listing, deleting, and see the limit of custom models your account. See example [Manage models](#manage-your-models). +- Copying a custom model from one Form Recognizer resource to another. +- Creating a composed model from a collection of existing built models. +- Listing document model operations associated with the Form Recognizer resource. + +Sample code snippets are provided to illustrate using a DocumentModelAdministrationClient [here](#examples "Examples"). + +### Long-running operations +Long-running operations are operations that consist of an initial request sent to the service to start an operation, +followed by polling the service at intervals to determine whether the operation has completed or failed, and if it has +succeeded, to get the result. + +Methods that build models, analyze values from documents, or copy and compose models are modeled as long-running operations. +The client exposes a `begin` method that returns a `SyncPoller` or `PollerFlux` instance. +Callers should wait for the operation to be completed by calling `getFinalResult()` on the returned operation from the +`begin` method. Sample code snippets are provided to illustrate using long-running operations +[below](#examples). + +## Examples + +The following section provides several code snippets covering some of the most common Form Recognizer tasks, including: + +* [Extract Layout](#extract-layout "Extract Layout") +* [Use a General Document Model](#use-a-general-document-model) +* [Use Prebuilt Models](#use-prebuilt-models) +* [Build a Document Model](#build-a-document-model "Build a Document Model") +* [Analyze Documents using a Custom Model](#analyze-documents-using-a-custom-model "Analyze Documents using a Custom Model") +* [Manage Your Models](#manage-your-models "Manage Your Models") +* [Classify a document](#classify-a-document "Classify a Document") + +### Extract Layout +Extract text, table structures, and selection marks like radio buttons and check boxes, along with their bounding box coordinates from documents without the need to build a model. +```java readme-sample-extractLayout +// analyze document layout using file input stream +File layoutDocument = new File("local/file_path/filename.png"); +Path filePath = layoutDocument.toPath(); +BinaryData layoutDocumentData = BinaryData.fromFile(filePath, (int) layoutDocument.length()); + +SyncPoller analyzeLayoutResultPoller = + documentAnalysisClient.beginAnalyzeDocument("prebuilt-layout", layoutDocumentData); + +AnalyzeResult analyzeLayoutResult = analyzeLayoutResultPoller.getFinalResult(); + +// pages +analyzeLayoutResult.getPages().forEach(documentPage -> { + System.out.printf("Page has width: %.2f and height: %.2f, measured with unit: %s%n", + documentPage.getWidth(), + documentPage.getHeight(), + documentPage.getUnit()); + + // lines + documentPage.getLines().forEach(documentLine -> + System.out.printf("Line '%s' is within a bounding box %s.%n", + documentLine.getContent(), + documentLine.getBoundingPolygon().toString())); + + // selection marks + documentPage.getSelectionMarks().forEach(documentSelectionMark -> + System.out.printf("Selection mark is '%s' and is within a bounding box %s with confidence %.2f.%n", + documentSelectionMark.getSelectionMarkState().toString(), + documentSelectionMark.getBoundingPolygon().toString(), + documentSelectionMark.getConfidence())); +}); + +// tables +List tables = analyzeLayoutResult.getTables(); +for (int i = 0; i < tables.size(); i++) { + DocumentTable documentTable = tables.get(i); + System.out.printf("Table %d has %d rows and %d columns.%n", i, documentTable.getRowCount(), + documentTable.getColumnCount()); + documentTable.getCells().forEach(documentTableCell -> { + System.out.printf("Cell '%s', has row index %d and column index %d.%n", documentTableCell.getContent(), + documentTableCell.getRowIndex(), documentTableCell.getColumnIndex()); + }); + System.out.println(); +} +``` + +### Use a General Document Model +Analyze key-value pairs, tables, styles, and selection marks from documents using the general document model provided by +the Form Recognizer service. +Select the General Document Model by passing modelId="prebuilt-document" into the beginAnalyzeDocumentFromUrl method as follows: +```java readme-sample-analyzePrebuiltDocument +String documentUrl = "{document-url}"; +String modelId = "prebuilt-document"; +SyncPoller analyzeDocumentPoller = + documentAnalysisClient.beginAnalyzeDocumentFromUrl(modelId, documentUrl); + +AnalyzeResult analyzeResult = analyzeDocumentPoller.getFinalResult(); + +for (int i = 0; i < analyzeResult.getDocuments().size(); i++) { + final AnalyzedDocument analyzedDocument = analyzeResult.getDocuments().get(i); + System.out.printf("----------- Analyzing document %d -----------%n", i); + System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n", + analyzedDocument.getDocType(), analyzedDocument.getConfidence()); +} + +analyzeResult.getPages().forEach(documentPage -> { + System.out.printf("Page has width: %.2f and height: %.2f, measured with unit: %s%n", + documentPage.getWidth(), + documentPage.getHeight(), + documentPage.getUnit()); + + // lines + documentPage.getLines().forEach(documentLine -> + System.out.printf("Line '%s' is within a bounding box %s.%n", + documentLine.getContent(), + documentLine.getBoundingPolygon().toString())); + + // words + documentPage.getWords().forEach(documentWord -> + System.out.printf("Word '%s' has a confidence score of %.2f.%n", + documentWord.getContent(), + documentWord.getConfidence())); +}); + +// tables +List tables = analyzeResult.getTables(); +for (int i = 0; i < tables.size(); i++) { + DocumentTable documentTable = tables.get(i); + System.out.printf("Table %d has %d rows and %d columns.%n", i, documentTable.getRowCount(), + documentTable.getColumnCount()); + documentTable.getCells().forEach(documentTableCell -> { + System.out.printf("Cell '%s', has row index %d and column index %d.%n", + documentTableCell.getContent(), + documentTableCell.getRowIndex(), documentTableCell.getColumnIndex()); + }); + System.out.println(); +} + +// Key-value +analyzeResult.getKeyValuePairs().forEach(documentKeyValuePair -> { + System.out.printf("Key content: %s%n", documentKeyValuePair.getKey().getContent()); + System.out.printf("Key content bounding region: %s%n", + documentKeyValuePair.getKey().getBoundingRegions().toString()); + + System.out.printf("Value content: %s%n", documentKeyValuePair.getValue().getContent()); + System.out.printf("Value content bounding region: %s%n", documentKeyValuePair.getValue().getBoundingRegions().toString()); +}); +``` + +### Use Prebuilt Models +Extract fields from select document types such as receipts, invoices, business cards, and identity documents using prebuilt models provided by the Form Recognizer service. +Supported prebuilt models are: +- Analyze receipts using the `prebuilt-receipt` model (fields recognized by the service can be found [here][service_analyze_receipt_fields]) +- Analyze business cards using the `prebuilt-businessCard` model (fields recognized by the service can be found [here][service_analyze_business_cards_fields]). +- Analyze invoices using the `prebuilt-invoice` model (fields recognized by the service can be found [here][service_analyze_invoices_fields]). +- Analyze identity documents using the `prebuilt-idDocuments` model (fields recognized by the service can be found [here][service_analyze_identity_documents_fields]). +- Analyze US W2 tax forms using the `prebuilt-tax.us.w2` model. [Supported fields][service_analyze_w2_documents_fields]. + +For example, to analyze fields from a sales receipt, into the `beginAnalyzeDocumentFromUrl` method: +```java readme-sample-analyzeReceiptFromUrl +String receiptUrl = "https://raw.githubusercontent.com/Azure/azure-sdk-for-java/main/sdk/formrecognizer" + + "/azure-ai-formrecognizer/src/samples/resources/sample-documents/receipts/contoso-allinone.jpg"; + +SyncPoller analyzeReceiptPoller = + documentAnalysisClient.beginAnalyzeDocumentFromUrl("prebuilt-receipt", receiptUrl); + +AnalyzeResult receiptResults = analyzeReceiptPoller.getFinalResult(); + +for (int i = 0; i < receiptResults.getDocuments().size(); i++) { + AnalyzedDocument analyzedReceipt = receiptResults.getDocuments().get(i); + Map receiptFields = analyzedReceipt.getFields(); + System.out.printf("----------- Analyzing receipt info %d -----------%n", i); + DocumentField merchantNameField = receiptFields.get("MerchantName"); + if (merchantNameField != null) { + if (DocumentFieldType.STRING == merchantNameField.getType()) { + String merchantName = merchantNameField.getValueAsString(); + System.out.printf("Merchant Name: %s, confidence: %.2f%n", + merchantName, merchantNameField.getConfidence()); + } + } + + DocumentField merchantPhoneNumberField = receiptFields.get("MerchantPhoneNumber"); + if (merchantPhoneNumberField != null) { + if (DocumentFieldType.PHONE_NUMBER == merchantPhoneNumberField.getType()) { + String merchantAddress = merchantPhoneNumberField.getValueAsPhoneNumber(); + System.out.printf("Merchant Phone number: %s, confidence: %.2f%n", + merchantAddress, merchantPhoneNumberField.getConfidence()); + } + } + + DocumentField transactionDateField = receiptFields.get("TransactionDate"); + if (transactionDateField != null) { + if (DocumentFieldType.DATE == transactionDateField.getType()) { + LocalDate transactionDate = transactionDateField.getValueAsDate(); + System.out.printf("Transaction Date: %s, confidence: %.2f%n", + transactionDate, transactionDateField.getConfidence()); + } + } + + DocumentField receiptItemsField = receiptFields.get("Items"); + if (receiptItemsField != null) { + System.out.printf("Receipt Items: %n"); + if (DocumentFieldType.LIST == receiptItemsField.getType()) { + List receiptItems = receiptItemsField.getValueAsList(); + receiptItems.stream() + .filter(receiptItem -> DocumentFieldType.MAP == receiptItem.getType()) + .map(documentField -> documentField.getValueAsMap()) + .forEach(documentFieldMap -> documentFieldMap.forEach((key, documentField) -> { + if ("Name".equals(key)) { + if (DocumentFieldType.STRING == documentField.getType()) { + String name = documentField.getValueAsString(); + System.out.printf("Name: %s, confidence: %.2fs%n", + name, documentField.getConfidence()); + } + } + if ("Quantity".equals(key)) { + if (DocumentFieldType.DOUBLE == documentField.getType()) { + Double quantity = documentField.getValueAsDouble(); + System.out.printf("Quantity: %f, confidence: %.2f%n", + quantity, documentField.getConfidence()); + } + } + })); + } + } +} +``` + +For more information and samples using prebuilt models, see: +- [Business Cards][analyze_business_cards_from_url] +- [Identity Documents][analyze_identity_documents_from_url] +- [Invoices][analyze_invoices_from_url] +- [Receipts sample][analyze_receipts_from_url] + +### Build a document model +Build a machine-learned model on your own document type. The resulting model will be able to analyze values from the types of documents it was built on. +Provide a container SAS url to your Azure Storage Blob container where you're storing the training documents. See details on setting this up +in the [service quickstart documentation][quickstart_training]. + +**Note** + +You can use the [Form Recognizer Studio preview][fr-studio] for creating a labeled file for your training forms. +More details on setting up a container and required file structure can be found in the [here][fr_build_training_set]. + +```java readme-sample-buildModel +// Build custom document analysis model +String blobContainerUrl = "{SAS_URL_of_your_container_in_blob_storage}"; +// The shared access signature (SAS) Url of your Azure Blob Storage container with your forms. +String prefix = "{blob_name_prefix}}"; +SyncPoller buildOperationPoller = + documentModelAdminClient.beginBuildDocumentModel(blobContainerUrl, + DocumentModelBuildMode.TEMPLATE, + prefix, + new BuildDocumentModelOptions().setModelId("my-build-model").setDescription("model desc"), + Context.NONE); + +DocumentModelDetails documentModelDetails = buildOperationPoller.getFinalResult(); + +// Model Info +System.out.printf("Model ID: %s%n", documentModelDetails.getModelId()); +System.out.printf("Model Description: %s%n", documentModelDetails.getDescription()); +System.out.printf("Model created on: %s%n%n", documentModelDetails.getCreatedOn()); +documentModelDetails.getDocumentTypes().forEach((key, documentTypeDetails) -> { + System.out.printf("Document type: %s%n", key); + documentTypeDetails.getFieldSchema().forEach((name, documentFieldSchema) -> { + System.out.printf("Document field: %s%n", name); + System.out.printf("Document field type: %s%n", documentFieldSchema.getType().toString()); + System.out.printf("Document field confidence: %.2f%n", documentTypeDetails.getFieldConfidence().get(name)); + }); +}); +``` + +### Analyze Documents using a Custom Model +Analyze the key/value pairs and table data from documents. These models are built with your own data, +so they're tailored to your documents. You should only analyze documents of the same doc type that the custom model +was built on. +```java readme-sample-analyzeCustomDocument +String documentUrl = "{document-url}"; +String modelId = "{custom-built-model-ID}"; +SyncPoller analyzeDocumentPoller = + documentAnalysisClient.beginAnalyzeDocumentFromUrl(modelId, documentUrl); + +AnalyzeResult analyzeResult = analyzeDocumentPoller.getFinalResult(); + +for (int i = 0; i < analyzeResult.getDocuments().size(); i++) { + final AnalyzedDocument analyzedDocument = analyzeResult.getDocuments().get(i); + System.out.printf("----------- Analyzing custom document %d -----------%n", i); + System.out.printf("Analyzed document has doc type %s with confidence : %.2f%n", + analyzedDocument.getDocType(), analyzedDocument.getConfidence()); + analyzedDocument.getFields().forEach((key, documentField) -> { + System.out.printf("Document Field content: %s%n", documentField.getContent()); + System.out.printf("Document Field confidence: %.2f%n", documentField.getConfidence()); + System.out.printf("Document Field Type: %s%n", documentField.getType()); + System.out.printf("Document Field found within bounding region: %s%n", + documentField.getBoundingRegions().toString()); + }); +} + +analyzeResult.getPages().forEach(documentPage -> { + System.out.printf("Page has width: %.2f and height: %.2f, measured with unit: %s%n", + documentPage.getWidth(), + documentPage.getHeight(), + documentPage.getUnit()); + + // lines + documentPage.getLines().forEach(documentLine -> + System.out.printf("Line '%s' is within a bounding box %s.%n", + documentLine.getContent(), + documentLine.getBoundingPolygon().toString())); + + // words + documentPage.getWords().forEach(documentWord -> + System.out.printf("Word '%s' has a confidence score of %.2f.%n", + documentWord.getContent(), + documentWord.getConfidence())); +}); + +// tables +List tables = analyzeResult.getTables(); +for (int i = 0; i < tables.size(); i++) { + DocumentTable documentTable = tables.get(i); + System.out.printf("Table %d has %d rows and %d columns.%n", i, documentTable.getRowCount(), + documentTable.getColumnCount()); + documentTable.getCells().forEach(documentTableCell -> { + System.out.printf("Cell '%s', has row index %d and column index %d.%n", + documentTableCell.getContent(), + documentTableCell.getRowIndex(), documentTableCell.getColumnIndex()); + }); + System.out.println(); +} +``` + +### Manage your models +Manage the models in your Form Recognizer account. +```java readme-sample-manageModels +AtomicReference modelId = new AtomicReference<>(); + +// First, we see how many models we have, and what our limit is +ResourceDetails resourceDetails = documentModelAdminClient.getResourceDetails(); +System.out.printf("The resource has %s models, and we can have at most %s models", + resourceDetails.getCustomDocumentModelCount(), resourceDetails.getCustomDocumentModelLimit()); + +// Next, we get a paged list of all of our models +PagedIterable customDocumentModels = documentModelAdminClient.listDocumentModels(); +System.out.println("We have following models in the account:"); +customDocumentModels.forEach(documentModelSummary -> { + System.out.printf("Model ID: %s%n", documentModelSummary.getModelId()); + modelId.set(documentModelSummary.getModelId()); + + // get custom document analysis model info + DocumentModelDetails documentModel = documentModelAdminClient.getDocumentModel(documentModelSummary.getModelId()); + System.out.printf("Model ID: %s%n", documentModel.getModelId()); + System.out.printf("Model Description: %s%n", documentModel.getDescription()); + System.out.printf("Model created on: %s%n", documentModel.getCreatedOn()); + documentModel.getDocumentTypes().forEach((key, documentTypeDetails) -> { + documentTypeDetails.getFieldSchema().forEach((field, documentFieldSchema) -> { + System.out.printf("Field: %s", field); + System.out.printf("Field type: %s", documentFieldSchema.getType()); + System.out.printf("Field confidence: %.2f", documentTypeDetails.getFieldConfidence().get(field)); + }); + }); +}); + +// Delete Model +documentModelAdminClient.deleteDocumentModel(modelId.get()); +``` + +### Classify a document + +The Form Recognizer service supports custom document classifiers that can classify documents into a set of predefined categories based on a training data set. +Documents can be classified with a custom classifier using the `beginClassifyDocument` or `beginClassifyDocumentFromUrl` +method of `DocumentAnalysisClient`. +The following sample shows how to classify a document using a custom classifier: +```java readme-sample-classifyDocument +String documentUrl = "{file_source_url}"; +String classifierId = "{custom_trained_classifier_id}"; + +documentAnalysisClient.beginClassifyDocumentFromUrl(classifierId, documentUrl, Context.NONE) + .getFinalResult() + .getDocuments() + .forEach(analyzedDocument -> System.out.printf("Doc Type: %s%n", analyzedDocument.getDocType())); +``` + +For more detailed examples, refer to [samples][sample_examples]. + +## Troubleshooting +### General +Form Recognizer clients raise `HttpResponseException` [exceptions][http_response_exception]. For example, if you try +to provide an invalid file source URL an `HttpResponseException` would be raised with an error indicating the failure cause. +In the following code snippet, the error is handled +gracefully by catching the exception and display the additional information about the error. + +```java readme-sample-handlingException +try { + documentAnalysisClient.beginAnalyzeDocumentFromUrl("prebuilt-receipt", "invalidSourceUrl"); +} catch (HttpResponseException e) { + System.out.println(e.getMessage()); + // Do something with the exception +} +``` + +### Enable client logging +Azure SDKs for Java offer a consistent logging story to help aid in troubleshooting application errors and expedite +their resolution. The logs produced will capture the flow of an application before reaching the terminal state to help +locate the root issue. View the [logging][logging] wiki for guidance about enabling logging. + +### Default HTTP Client +All client libraries by default use the Netty HTTP client. Add the above dependency to automatically configure +the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the +[HTTP clients wiki][http_clients_wiki]. + +## Next steps +The following section provides several code snippets illustrating common patterns used in the Form Recognizer API. +These code samples show common scenario operations with the Azure Form Recognizer client library. + +* Analyze business card from a URL: [AnalyzeBusinessCardFromUrl][analyze_business_cards_from_url] +* Analyze identity documents from a URL: [AnalyzeIdentityDocumentsFromUrl][analyze_identity_documents_from_url] +* Analyze invoice from a URL: [AnalyzeInvoiceFromUrl][analyze_invoices_from_url] +* Analyze receipts: [AnalyzeReceipts][analyze_receipts] +* Analyze receipts from a URL: [AnalyzeReceiptsFromUrl][analyze_receipts_from_url] +* Extract layout: [AnalyzeLayout][analyze_layout] +* Analyze custom documents from a URL: [AnalyzeCustomDocumentFromUrl][analyze_custom_documents] +* Build a model: [BuildModel][build_model] +* Manage custom models: [ManageCustomModels][manage_custom_models] +* Copy a model between Form Recognizer resources: [CopyModel][copy_model] +* Create a composed model from a collection of custom-built models: [ComposeModel][compose_model] +* Get/List document model operations associated with the Form Recognizer resource: [GetOperation][get_operation] +* Build a document classifier : [BuildDocumentClassifier][build_document_classifier] + +### Async APIs +All the examples shown so far have been using synchronous APIs, but we provide full support for async APIs as well. +You'll need to use `DocumentAnalysisAsyncClient` +```java readme-sample-asyncClient +DocumentAnalysisAsyncClient documentAnalysisAsyncClient = new DocumentAnalysisClientBuilder() + .credential(new AzureKeyCredential("{key}")) + .endpoint("{endpoint}") + .buildAsyncClient(); +``` + +* Analyze business card from a URL: [AnalyzeBusinessCardFromUrlAsync][analyze_business_cards_from_url_async] +* Analyze identity documents from a URL: [AnalyzeIdentityDocumentsFromUrlAsync][analyze_identity_documents_from_url_async] +* Analyze invoice: [AnalyzeInvoiceAsync][analyze_invoices_async] +* Analyze receipts: [AnalyzeReceiptsAsync][analyze_receipts_async] +* Analyze receipts from a URL: [AnalyzeReceiptsFromUrlAsync][analyze_receipts_from_url_async] +* Extract layout from a URL: [AnalyzeLayoutFromUrlAsync][analyze_layout_from_url_async] +* Analyze custom documents: [AnalyzeCustomDocumentAsync][analyze_custom_documents_async] +* Build a document model: [BuildModelAsync][build_model_async] +* Manage custom models: [ManageCustomModelsAsync][manage_custom_models_async] +* Copy a document model between Form Recognizer resources: [CopyModelAsync][copy_model_async] +* Create a composed document model from a collection of custom-built models: [ComposeModelAsync][compose_model_async] +* Get/List document model operations associated with the Form Recognizer resource: [GetOperationAsync][get_operation_async] +* Build a document classifier : [BuildDocumentClassifierAsync][build_document_classifier_async] + +### Additional documentation +See the [Sample README][sample_readme] for several code snippets illustrating common patterns used in the Form Recognizer Java SDK. +For more extensive documentation on Azure Cognitive Services Form Recognizer, see the [Form Recognizer documentation][form_recognizer_doc]. + +## Contributing + +This project welcomes contributions and suggestions. Most contributions require you to agree to a [Contributor License Agreement (CLA)][cla] declaring that you have the right to, and actually do, grant us the rights to use your contribution. + +When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. + +This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For more information, see the [Code of Conduct FAQ][coc_faq] or contact [opencode@microsoft.com][coc_contact] with any additional questions or comments. + + +[aad_authorization]: https://learn.microsoft.com/azure/cognitive-services/authentication#authenticate-with-azure-active-directory +[azure_key_credential]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/credential/AzureKeyCredential.java +[key]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#get-the-keys-for-your-resource +[api_reference_doc]: https://azure.github.io/azure-sdk-for-java +[form_recognizer_doc]: https://aka.ms/azsdk-java-formrecognizer-ref-doc +[azure_identity_credential_type]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_cli]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account-cli?tabs=windows +[azure_cli_endpoint]: https://learn.microsoft.com/cli/azure/cognitiveservices/account?view=azure-cli-latest#az-cognitiveservices-account-show +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_portal]: https://ms.portal.azure.com +[azure_subscription]: https://azure.microsoft.com/free +[cla]: https://cla.microsoft.com +[coc]: https://opensource.microsoft.com/codeofconduct/ +[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ +[coc_contact]: mailto:opencode@microsoft.com +[create_new_resource]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows#create-a-new-azure-cognitive-services-resource +[form_recognizer_account]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows +[grant_access]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal +[http_clients_wiki]: https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients +[http_response_exception]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core/src/main/java/com/azure/core/exception/HttpResponseException.java +[jdk_link]: https://learn.microsoft.com/java/azure/jdk/?view=azure-java-stable +[logging]: https://github.com/Azure/azure-sdk-for-java/wiki/Logging-in-Azure-SDK +[package]: https://central.sonatype.com/artifact/com.azure/azure-ai-formrecognizer +[product_documentation]: https://learn.microsoft.com/azure/cognitive-services/form-recognizer/overview +[register_AAD_application]: https://learn.microsoft.com/azure/cognitive-services/authentication#assign-a-role-to-a-service-principal +[fr-studio]: https://aka.ms/azsdk/formrecognizer/formrecognizerstudio +[fr_build_training_set]: https://aka.ms/azsdk/formrecognizer/buildcustommodel +[sample_examples]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples#examples +[sample_readme]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples#readme +[migration_guide]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/formrecognizer/azure-ai-formrecognizer/migration-guide.md +[changelog]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/CHANGELOG.md + +[sample_readme]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/ +[document_analysis_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/DocumentAnalysisAsyncClient.java +[document_analysis_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/DocumentAnalysisClient.java +[document_model_admin_async_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/DocumentModelAdministrationAsyncClient.java +[document_model_admin_sync_client]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/main/java/com/azure/ai/formrecognizer/documentanalysis/administration/DocumentModelAdministrationClient.java +[manage_custom_models]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ManageCustomModels.java +[manage_custom_models_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ManageCustomModelsAsync.java +[build_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentModel.java +[build_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentModelAsync.java +[build_document_classifier]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentClassifier.java +[build_document_classifier_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/BuildDocumentClassifierAsync.java +[compose_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ComposeDocumentModel.java +[compose_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/ComposeDocumentModelAsync.java +[copy_model]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/CopyDocumentModel.java +[copy_model_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/CopyDocumentModelAsync.java +[analyze_business_cards_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeBusinessCardFromUrl.java +[analyze_business_cards_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeBusinessCardFromUrlAsync.java +[analyze_identity_documents_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeIdentityDocumentsFromUrl.java +[analyze_identity_documents_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeIdentityDocumentsFromUrlAsync.java +[analyze_invoices_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeInvoicesAsync.java +[analyze_invoices_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeInvoicesFromUrl.java +[analyze_layout]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeLayout.java +[analyze_layout_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeLayoutFromUrlAsync.java +[analyze_receipts]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceipts.java +[analyze_receipts_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceiptsAsync.java +[analyze_receipts_from_url]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceiptsFromUrl.java +[analyze_receipts_from_url_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeReceiptsFromUrlAsync.java +[analyze_custom_documents]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeCustomDocumentFromUrl.java +[analyze_custom_documents_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/AnalyzeCustomDocumentAsync.java +[get_operation]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/GetOperationSummary.java +[get_operation_async]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src/samples/java/com/azure/ai/formrecognizer/administration/GetOperationSummaryAsync.java + +[fr_models]: https://aka.ms/azsdk/formrecognizer/models +[service_access]: https://learn.microsoft.com/azure/cognitive-services/cognitive-services-apis-create-account?tabs=multiservice%2Cwindows +[service_analyze_business_cards_fields]: https://aka.ms/azsdk/formrecognizer/businesscardfieldschema +[service_analyze_invoices_fields]: https://aka.ms/azsdk/formrecognizer/invoicefieldschema +[service_analyze_identity_documents_fields]: https://aka.ms/azsdk/formrecognizer/iddocumentfieldschema +[service_analyze_receipt_fields]: https://aka.ms/azsdk/formrecognizer/receiptfieldschema +[service_analyze_w2_documents_fields]: https://aka.ms/azsdk/formrecognizer/taxusw2fieldschema +[service-rename]: https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-form-recognizer-is-now-azure-ai-document-intelligence-with/ba-p/3875765 +[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/formrecognizer/azure-ai-formrecognizer/src +[quickstart_training]: https://learn.microsoft.com/azure/applied-ai-services/form-recognizer/quickstarts/get-started-sdks-rest-api?view=form-recog-3.0.0&pivots=programming-language-java +[customize_defaultAzureCredential]: https://aka.ms/azsdk/java/identity/credential-chains#how-to-customize-defaultazurecredential +[identity_dac]: https://aka.ms/azsdk/java/identity/credential-chains#defaultazurecredential-overview + diff --git a/metadata/preview/azure-ai-formrecognizer.json b/metadata/preview/azure-ai-formrecognizer.json new file mode 100644 index 0000000000000..ba7a34cb5ceb4 --- /dev/null +++ b/metadata/preview/azure-ai-formrecognizer.json @@ -0,0 +1,40 @@ +{ + "Name": "azure-ai-formrecognizer", + "Version": "4.2.0-alpha.20251024.1", + "DevVersion": "4.2.0-alpha.20251024.1", + "DirectoryPath": "sdk/formrecognizer/azure-ai-formrecognizer", + "ServiceDirectory": "formrecognizer", + "ReadMePath": "sdk/formrecognizer/azure-ai-formrecognizer/README.md", + "ChangeLogPath": "sdk/formrecognizer/azure-ai-formrecognizer/CHANGELOG.md", + "Group": "com.azure", + "SdkType": "client", + "IsNewSdk": true, + "ArtifactName": "azure-ai-formrecognizer", + "ReleaseStatus": "Unreleased", + "IncludedForValidation": false, + "AdditionalValidationPackages": [ + "com.azure:azure-ai-formrecognizer-perf", + "com.azure:perf-test-core" + ], + "ArtifactDetails": { + "name": "azure-ai-formrecognizer", + "triggeringPaths": [ + "/sdk/formrecognizer/ci.yml" + ], + "groupId": "com.azure", + "safeName": "azureaiformrecognizer" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, + "Namespaces": [ + "com.azure.ai.formrecognizer", + "com.azure.ai.formrecognizer.documentanalysis", + "com.azure.ai.formrecognizer.documentanalysis.administration", + "com.azure.ai.formrecognizer.documentanalysis.administration.models", + "com.azure.ai.formrecognizer.documentanalysis.models", + "com.azure.ai.formrecognizer.models", + "com.azure.ai.formrecognizer.training", + "com.azure.ai.formrecognizer.training.models" + ] +} From 4b64b273400f9114ee659924862531765e5f2050 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:19:13 +0000 Subject: [PATCH 49/52] Update docs metadata --- .../resourcemanager-eventgrid-readme.md | 18 +++++++++--------- .../azure-resourcemanager-eventgrid.json | 12 ++++++------ 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-eventgrid-readme.md b/docs-ref-services/preview/resourcemanager-eventgrid-readme.md index e8e61f9031e4c..080975b701f0c 100644 --- a/docs-ref-services/preview/resourcemanager-eventgrid-readme.md +++ b/docs-ref-services/preview/resourcemanager-eventgrid-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager EventGrid client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-eventgrid, azure-event-grid -ms.date: 07/25/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: azure-event-grid --- -# Azure Resource Manager EventGrid client library for Java - version 1.3.0-beta.1 +# Azure Resource Manager EventGrid client library for Java - version 1.3.0-alpha.20251024.1 Azure Resource Manager EventGrid client library for Java. @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-eventgrid_1.3.0-beta.1/sdk/eventgrid/azure-resourcemanager-eventgrid/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/eventgrid/azure-resourcemanager-eventgrid/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-eventgrid_1.3.0-beta.1/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-eventgrid_1.3.0-beta.1/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-eventgrid_1.3.0-beta.1/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-eventgrid_1.3.0-beta.1/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-eventgrid_1.3.0-beta.1/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-eventgrid_1.3.0-beta.1/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-eventgrid.json b/metadata/preview/azure-resourcemanager-eventgrid.json index 477f1f9601397..beb87553e830b 100644 --- a/metadata/preview/azure-resourcemanager-eventgrid.json +++ b/metadata/preview/azure-resourcemanager-eventgrid.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-eventgrid", - "Version": "1.3.0-beta.1", - "DevVersion": null, + "Version": "1.3.0-alpha.20251024.1", + "DevVersion": "1.3.0-alpha.20251024.1", "DirectoryPath": "sdk/eventgrid/azure-resourcemanager-eventgrid", "ServiceDirectory": "eventgrid/azure-resourcemanager-eventgrid", "ReadMePath": "sdk/eventgrid/azure-resourcemanager-eventgrid/README.md", @@ -10,17 +10,17 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-eventgrid", - "ReleaseStatus": "2025-07-25", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { - "releaseInBatch": "${{ parameters.release_azureresourcemanagereventgrid }}", - "safeName": "azureresourcemanagereventgrid", "name": "azure-resourcemanager-eventgrid", "groupId": "com.azure.resourcemanager", "triggeringPaths": [ "/sdk/eventgrid/azure-resourcemanager-eventgrid/ci.yml" - ] + ], + "releaseInBatch": "${{ parameters.release_azureresourcemanagereventgrid }}", + "safeName": "azureresourcemanagereventgrid" }, "CIParameters": { "CIMatrixConfigs": [] From ecf99b545e9ab285476561007898d837dc930b39 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:39:24 +0000 Subject: [PATCH 50/52] Update docs metadata --- .../resourcemanager-hybridcompute-readme.md | 18 +++++++++--------- .../azure-resourcemanager-hybridcompute.json | 12 ++++++------ 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-hybridcompute-readme.md b/docs-ref-services/preview/resourcemanager-hybridcompute-readme.md index 2108c81d22bbe..7c462dadfd417 100644 --- a/docs-ref-services/preview/resourcemanager-hybridcompute-readme.md +++ b/docs-ref-services/preview/resourcemanager-hybridcompute-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager HybridCompute client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-hybridcompute, hybridcompute -ms.date: 06/16/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: hybridcompute --- -# Azure Resource Manager HybridCompute client library for Java - version 1.1.0-beta.2 +# Azure Resource Manager HybridCompute client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager HybridCompute client library for Java. @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridcompute_1.1.0-beta.2/sdk/hybridcompute/azure-resourcemanager-hybridcompute/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/hybridcompute/azure-resourcemanager-hybridcompute/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-hybridcompute_1.1.0-beta.2/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-hybridcompute_1.1.0-beta.2/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridcompute_1.1.0-beta.2/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridcompute_1.1.0-beta.2/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridcompute_1.1.0-beta.2/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-hybridcompute_1.1.0-beta.2/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-hybridcompute.json b/metadata/preview/azure-resourcemanager-hybridcompute.json index f103e4aab9187..62bd4b61323f9 100644 --- a/metadata/preview/azure-resourcemanager-hybridcompute.json +++ b/metadata/preview/azure-resourcemanager-hybridcompute.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-hybridcompute", - "Version": "1.1.0-beta.2", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/hybridcompute/azure-resourcemanager-hybridcompute", "ServiceDirectory": "hybridcompute", "ReadMePath": "sdk/hybridcompute/azure-resourcemanager-hybridcompute/README.md", @@ -10,16 +10,16 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-hybridcompute", - "ReleaseStatus": "2025-06-16", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { + "name": "azure-resourcemanager-hybridcompute", "triggeringPaths": [ "/sdk/hybridcompute/ci.yml" ], - "name": "azure-resourcemanager-hybridcompute", - "groupId": "com.azure.resourcemanager", - "safeName": "azureresourcemanagerhybridcompute" + "safeName": "azureresourcemanagerhybridcompute", + "groupId": "com.azure.resourcemanager" }, "CIParameters": { "CIMatrixConfigs": [] From dd811c3768357121c59fa14b46632b603f9faba3 Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 06:50:27 +0000 Subject: [PATCH 51/52] Update docs metadata --- ...emanager-postgresqlflexibleserver-readme.md | 18 +++++++++--------- ...sourcemanager-postgresqlflexibleserver.json | 10 +++++----- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-postgresqlflexibleserver-readme.md b/docs-ref-services/preview/resourcemanager-postgresqlflexibleserver-readme.md index efd5f7b5f4fe1..9b49b8c0390e7 100644 --- a/docs-ref-services/preview/resourcemanager-postgresqlflexibleserver-readme.md +++ b/docs-ref-services/preview/resourcemanager-postgresqlflexibleserver-readme.md @@ -1,12 +1,12 @@ --- title: Azure Resource Manager PostgreSql client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-postgresqlflexibleserver, postgresqlflexibleserver -ms.date: 05/16/2025 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: postgresqlflexibleserver --- -# Azure Resource Manager PostgreSql client library for Java - version 1.2.0-beta.1 +# Azure Resource Manager PostgreSql client library for Java - version 1.2.0-alpha.20251024.1 Azure Resource Manager PostgreSql client library for Java. @@ -100,7 +100,7 @@ server = postgreSqlManager.servers() .withReplicationRole(ReplicationRole.PRIMARY) .create(); ``` -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/sdk/postgresqlflexibleserver/azure-resourcemanager-postgresqlflexibleserver/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/postgresqlflexibleserver/azure-resourcemanager-postgresqlflexibleserver/SAMPLE.md) ## Troubleshooting @@ -122,12 +122,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-postgresqlflexibleserver_1.2.0-beta.1/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-postgresqlflexibleserver.json b/metadata/preview/azure-resourcemanager-postgresqlflexibleserver.json index d08f01988c95f..d2d532d374778 100644 --- a/metadata/preview/azure-resourcemanager-postgresqlflexibleserver.json +++ b/metadata/preview/azure-resourcemanager-postgresqlflexibleserver.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-postgresqlflexibleserver", - "Version": "1.2.0-beta.1", - "DevVersion": null, + "Version": "1.2.0-alpha.20251024.1", + "DevVersion": "1.2.0-alpha.20251024.1", "DirectoryPath": "sdk/postgresqlflexibleserver/azure-resourcemanager-postgresqlflexibleserver", "ServiceDirectory": "postgresqlflexibleserver", "ReadMePath": "sdk/postgresqlflexibleserver/azure-resourcemanager-postgresqlflexibleserver/README.md", @@ -10,16 +10,16 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-postgresqlflexibleserver", - "ReleaseStatus": "2025-05-16", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, "ArtifactDetails": { "name": "azure-resourcemanager-postgresqlflexibleserver", - "safeName": "azureresourcemanagerpostgresqlflexibleserver", "groupId": "com.azure.resourcemanager", "triggeringPaths": [ "/sdk/postgresqlflexibleserver/ci.yml" - ] + ], + "safeName": "azureresourcemanagerpostgresqlflexibleserver" }, "CIParameters": { "CIMatrixConfigs": [] From f68b05913ab0c8d83ac87e0da310a89a3651499e Mon Sep 17 00:00:00 2001 From: azure-sdk Date: Sat, 25 Oct 2025 07:02:24 +0000 Subject: [PATCH 52/52] Update docs metadata --- .../resourcemanager-servicelinker-readme.md | 22 +++++++++---------- .../azure-resourcemanager-servicelinker.json | 17 +++++++++++--- 2 files changed, 25 insertions(+), 14 deletions(-) diff --git a/docs-ref-services/preview/resourcemanager-servicelinker-readme.md b/docs-ref-services/preview/resourcemanager-servicelinker-readme.md index c3fbbc03e2e36..0009db75208de 100644 --- a/docs-ref-services/preview/resourcemanager-servicelinker-readme.md +++ b/docs-ref-services/preview/resourcemanager-servicelinker-readme.md @@ -1,17 +1,17 @@ --- title: Azure Resource Manager ServiceLinker client library for Java keywords: Azure, java, SDK, API, azure-resourcemanager-servicelinker, servicelinker -ms.date: 10/09/2024 +ms.date: 10/25/2025 ms.topic: reference ms.devlang: java ms.service: servicelinker --- -# Azure Resource Manager ServiceLinker client library for Java - version 1.0.0-beta.4 +# Azure Resource Manager ServiceLinker client library for Java - version 1.1.0-alpha.20251024.1 Azure Resource Manager ServiceLinker client library for Java. -This package contains Microsoft Azure SDK for ServiceLinker Management SDK. Microsoft.ServiceLinker provider. Package tag package-2024-07-01-preview. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). +This package contains Microsoft Azure SDK for ServiceLinker Management SDK. Microsoft.ServiceLinker provider. Package tag package-2022-05-01. For documentation on how to use this package, please see [Azure Management Libraries for Java](https://aka.ms/azsdk/java/mgmt). ## We'd love to hear your feedback @@ -41,7 +41,7 @@ Various documentation is available to help you get started com.azure.resourcemanager azure-resourcemanager-servicelinker - 1.0.0-beta.4 + 1.1.0-beta.1 ``` [//]: # ({x-version-update-end}) @@ -79,7 +79,7 @@ See [API design][design] for general introduction on design and key concepts on ## Examples -[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-servicelinker_1.0.0-beta.4/sdk/servicelinker/azure-resourcemanager-servicelinker/SAMPLE.md) +[Code snippets and samples](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/servicelinker/azure-resourcemanager-servicelinker/SAMPLE.md) ## Troubleshooting @@ -101,12 +101,12 @@ This project has adopted the [Microsoft Open Source Code of Conduct][coc]. For m [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-resourcemanager-servicelinker_1.0.0-beta.4/sdk/identity/azure-identity -[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/azure-resourcemanager-servicelinker_1.0.0-beta.4/sdk/identity/azure-identity#credentials -[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-servicelinker_1.0.0-beta.4/sdk/core/azure-core-http-netty -[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-servicelinker_1.0.0-beta.4/sdk/resourcemanager/docs/AUTH.md -[design]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-servicelinker_1.0.0-beta.4/sdk/resourcemanager/docs/DESIGN.md -[cg]: https://github.com/Azure/azure-sdk-for-java/blob/azure-resourcemanager-servicelinker_1.0.0-beta.4/CONTRIBUTING.md +[azure_identity]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/identity/azure-identity +[azure_identity_credentials]: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/identity/azure-identity#credentials +[azure_core_http_netty]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/core/azure-core-http-netty +[authenticate]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md +[design]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/DESIGN.md +[cg]: https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md [coc]: https://opensource.microsoft.com/codeofconduct/ [coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/ diff --git a/metadata/preview/azure-resourcemanager-servicelinker.json b/metadata/preview/azure-resourcemanager-servicelinker.json index 28774f3cadfa2..740a35e2e0c2f 100644 --- a/metadata/preview/azure-resourcemanager-servicelinker.json +++ b/metadata/preview/azure-resourcemanager-servicelinker.json @@ -1,7 +1,7 @@ { "Name": "azure-resourcemanager-servicelinker", - "Version": "1.0.0-beta.4", - "DevVersion": null, + "Version": "1.1.0-alpha.20251024.1", + "DevVersion": "1.1.0-alpha.20251024.1", "DirectoryPath": "sdk/servicelinker/azure-resourcemanager-servicelinker", "ServiceDirectory": "servicelinker", "ReadMePath": "sdk/servicelinker/azure-resourcemanager-servicelinker/README.md", @@ -10,9 +10,20 @@ "SdkType": "mgmt", "IsNewSdk": true, "ArtifactName": "azure-resourcemanager-servicelinker", - "ReleaseStatus": "2024-10-09", + "ReleaseStatus": "Unreleased", "IncludedForValidation": false, "AdditionalValidationPackages": null, + "ArtifactDetails": { + "groupId": "com.azure.resourcemanager", + "triggeringPaths": [ + "/sdk/servicelinker/ci.yml" + ], + "name": "azure-resourcemanager-servicelinker", + "safeName": "azureresourcemanagerservicelinker" + }, + "CIParameters": { + "CIMatrixConfigs": [] + }, "Namespaces": [ "com.azure.resourcemanager.servicelinker", "com.azure.resourcemanager.servicelinker.fluent",