From acab4cc20f87c92421e8178d5f446b702e534a78 Mon Sep 17 00:00:00 2001 From: hamshavathimunibyraiah <125092972+hamshavathimunibyraiah@users.noreply.github.com> Date: Thu, 15 Aug 2024 09:08:17 -0700 Subject: [PATCH] Updating to the latest TypeSpec and preparing for Document Translation SDK GA release. (#45478) * Updating to the latest TypeSpec and preparing for GA release. * Adding the next release section * Fixing build issue * Updating Readme --- .../Azure.AI.Translation.Document/CHANGELOG.md | 8 ++++++-- sdk/translation/Azure.AI.Translation.Document/README.md | 8 ++++++++ .../src/Azure.AI.Translation.Document.csproj | 2 +- .../Azure.AI.Translation.Document/tsp-location.yaml | 4 +--- 4 files changed, 16 insertions(+), 6 deletions(-) diff --git a/sdk/translation/Azure.AI.Translation.Document/CHANGELOG.md b/sdk/translation/Azure.AI.Translation.Document/CHANGELOG.md index 4cb8f1d4f3366..cfecdd4e791b7 100644 --- a/sdk/translation/Azure.AI.Translation.Document/CHANGELOG.md +++ b/sdk/translation/Azure.AI.Translation.Document/CHANGELOG.md @@ -1,6 +1,5 @@ # Release History - -## 2.0.0-beta.3 (Unreleased) +## 2.1.0-beta.1 (Unreleased) ### Features Added @@ -10,6 +9,11 @@ ### Other Changes +## 2.0.0 (2024-08-16) + +### Other Changes +This is a GA release. No new features added. + ## 2.0.0-beta.2 (2024-07-05) ### Features Added diff --git a/sdk/translation/Azure.AI.Translation.Document/README.md b/sdk/translation/Azure.AI.Translation.Document/README.md index 991b689ed9e76..a877fe1ed65cf 100644 --- a/sdk/translation/Azure.AI.Translation.Document/README.md +++ b/sdk/translation/Azure.AI.Translation.Document/README.md @@ -54,6 +54,9 @@ az cognitiveservices account create \ ``` For more information about creating the resource or how to get the location information see [here][cognitive_resource_cli]. +#### Setup Azure Blob Storage Account +For more information about creating an Azure Blob Storage account see [here][azure_blob_storage_account]. For creating containers for your source and target files see [here][container]. Make sure to authorize your Translation resource storage access, more info [here][storage_container_authorization]. + ### Authenticate the client In order to interact with the Document Translation service, you'll need to create an instance of the [DocumentTranslationClient][documenttranslation_client_class] class. You will need an **endpoint**, and either an **API key** or `TokenCredential` to instantiate a client object. For more information regarding authenticating with cognitive services, see [Authenticate requests to Azure Cognitive Services][cognitive_auth]. @@ -153,6 +156,8 @@ var inputs = new List Note that documents written to a target container must have unique names. So you can't translate a source container into a target container twice or have sources with the same documents translated into the same target container. +If "Allow Storage Account Key Access" is disabled on the storage account , Managed Identity is enabled on the Translator resource and it is assigned the role "Storage Blob Data Contributor" on the storage account, then you can use the container URLs directly and no SAS URIs will be needed. + ### Long-Running Operations Document Translation is implemented as a [**long-running operation**][dotnet_lro]. Long-running operations 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 successfully or failed. @@ -502,6 +507,9 @@ This project has adopted the [Microsoft Open Source Code of Conduct][code_of_con [glossary]: https://docs.microsoft.com/azure/cognitive-services/translator/document-translation/overview#supported-glossary-formats [sas_token]: https://docs.microsoft.com/azure/cognitive-services/translator/document-translation/create-sas-tokens?tabs=Containers#create-your-sas-tokens-with-azure-storage-explorer [sas_token_permissions]: https://aka.ms/azsdk/documenttranslation/sas-permissions +[azure_blob_storage_account]: https://ms.portal.azure.com/#create/Microsoft.StorageAccount +[container]: https://learn.microsoft.com/azure/storage/blobs/storage-quickstart-blobs-portal#create-a-container +[storage_container_authorization]: https://learn.microsoft.com/azure/ai-services/translator/document-translation/quickstarts/client-library-sdks?tabs=dotnet&pivots=programming-language-csharp#storage-container-authorization [documenttranslation_client_class]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/translation/Azure.AI.Translation.Document/src/DocumentTranslationClient.cs [azure_identity]: https://github.com/Azure/azure-sdk-for-net/blob/master/sdk/identity/Azure.Identity/README.md diff --git a/sdk/translation/Azure.AI.Translation.Document/src/Azure.AI.Translation.Document.csproj b/sdk/translation/Azure.AI.Translation.Document/src/Azure.AI.Translation.Document.csproj index 58cdf2ac964a5..8e426afdb4d03 100644 --- a/sdk/translation/Azure.AI.Translation.Document/src/Azure.AI.Translation.Document.csproj +++ b/sdk/translation/Azure.AI.Translation.Document/src/Azure.AI.Translation.Document.csproj @@ -3,7 +3,7 @@ Translator is a cloud-based machine translation service and is part of the Azure Cognitive Services family of cognitive APIs used to build intelligent apps. Translator is easy to integrate in your applications, websites, tools, and solutions. It allows you to add multi-language user experiences in 90 languages and dialects. And it can be used on any hardware platform with any operating system for text translation. Microsoft Azure.AI.Translation.Document client library - 2.0.0-beta.3 + 2.1.0-beta.1 Microsoft Azure Document Translation diff --git a/sdk/translation/Azure.AI.Translation.Document/tsp-location.yaml b/sdk/translation/Azure.AI.Translation.Document/tsp-location.yaml index 51be8ea521945..837c4b587a843 100644 --- a/sdk/translation/Azure.AI.Translation.Document/tsp-location.yaml +++ b/sdk/translation/Azure.AI.Translation.Document/tsp-location.yaml @@ -1,5 +1,3 @@ directory: specification/translation/Azure.AI.DocumentTranslation -commit: bd246a654089bc08bbb99f1dbf2c35755a51e40b +commit: 27a9398801386caaba2df7e1a4d1a8abd19e3789 repo: Azure/azure-rest-api-specs - -