Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into tamram-251126

Author: tamram

articles/advisor/advisor-release-notes.md

@@ -2,13 +2,29 @@
 title: What's new in Azure Advisor
 description: A description of what's new and changed in Azure Advisor
 ms.topic: reference
-ms.date: 11/02/2023
+ms.date: 05/03/2024
 ---
 
 # What's new in Azure Advisor?
 
 Learn what's new in the service. These items might be release notes, videos, blog posts, and other types of information. Bookmark this page to stay up to date with the service.
 
+## April 2024
+
+### Azure Advisor will no longer display aggregated potential yearly savings beginning 30 September 2024
+
+In the Azure portal, Azure Advisor currently shows potential aggregated cost savings under the label "Potential yearly savings based on retail pricing" on pages where cost recommendations are displayed (as shown in the image). This aggregated savings estimate will be removed from the Azure portal on 30 September 2024. However, you can still evaluate potential yearly savings tailored to your specific needs by following the steps in [Calculate cost savings](/azure/advisor/advisor-how-to-calculate-total-cost-savings). All individual recommendations and their associated potential savings will remain available.
+
+#### Recommended action
+
+If you want to continue calculating aggregated potential yearly savings, follow [these steps](/azure/advisor/advisor-how-to-calculate-total-cost-savings). Note that individual recommendations might show savings that overlap with the savings shown in other recommendations, although you might not be able to benefit from them concurrently. For example, you can benefit from savings plans or from reservations for virtual machines, but not typically from both on the same virtual machines.
+
+### Public Preview: Resiliency Review on Azure Advisor
+
+Recommendations from WAF Reliability reviews in Advisor help you focus on the most important recommendations to ensure your workloads remain resilient. As part of the review, personalized and prioritized recommendations from Microsoft Cloud Solution Architects will be presented to you and your team. You can triage recommendations (accept or reject), manage their lifecycle on Advisor, and work with your Microsoft account team to track resolution. You can reach out to your account team to request Well Architected Reliability Assessment to successfully optimize workload resiliency and reliability by implementing curated recommendations and track its lifecycle on Advisor.
+
+To learn more, visit [Azure Advisor Resiliency Reviews](/azure/advisor/advisor-resiliency-reviews).
+
 ## March 2024
 
 ### Well-Architected Framework (WAF) assessments & recommendations
@@ -97,7 +113,7 @@ If you're interested in workload based recommendations, reach out to your accoun
 
 ### Cost Optimization workbook template
 
-The Azure Cost Optimization workbook serves as a centralized hub for some of the most used tools that can help you drive utilization and efficiency goals. It offers a range of recommendations, including Azure Advisor cost recommendations, identification of idle resources, and management of improperly deallocated Virtual Machines. Additionally, it provides insights into leveraging Azure Hybrid benefit options for Windows, Linux, and SQL databases
+The Azure Cost Optimization workbook serves as a centralized hub for some of the most used tools that can help you drive utilization and efficiency goals. It offers a range of recommendations, including Azure Advisor cost recommendations, identification of idle resources, and management of improperly deallocated Virtual Machines. Additionally, it provides insights into leveraging Azure Hybrid benefit options for Windows, Linux, and SQL databases.
 
 To learn more, visit [Understand and optimize your Azure costs using the Cost Optimization workbook](/azure/advisor/advisor-cost-optimization-workbook).
 
@@ -150,7 +166,7 @@ To learn more, visit [Prepare migration of your workloads impacted by service re
 
 Azure Advisor now provides the option to postpone or dismiss a recommendation for multiple resources at once. Once you open a recommendations details page with a list of recommendations and associated resources, select the relevant resources and choose **Postpone** or **Dismiss** in the command bar at the top of the page.
 
-To learn more, visit [Dismissing and postponing recommendations](/azure/advisor/view-recommendations#dismissing-and-postponing-recommendations)
+To learn more, visit [Dismissing and postponing recommendations](/azure/advisor/view-recommendations#dismissing-and-postponing-recommendations).
 
 ### VM/VMSS right-sizing recommendations with custom lookback period
 
@@ -187,7 +203,7 @@ To learn more, visit [Azure Advisor for MySQL](/azure/mysql/single-server/concep
 
 ### Unlimited number of subscriptions
 
-It is easier now to get an overview of optimization opportunities available to your organization – no need to spend time and effort to apply filters and process subscription in batches.
+It's easier now to get an overview of optimization opportunities available to your organization – no need to spend time and effort to apply filters and process subscription in batches.
 
 To learn more, visit [Get started with Azure Advisor](advisor-get-started.md).
 

articles/ai-services/translator/containers/install-run.md

@@ -7,22 +7,19 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: how-to
-ms.date: 04/08/2024
+ms.date: 04/19/2024
 ms.author: lajanuar
 recommendations: false
 keywords: on-premises, Docker, container, identify
 ---
 
 <!-- markdownlint-disable MD001 -->
 <!-- markdownlint-disable MD033 -->
+<!-- markdownlint-disable MD024 -->
+<!-- markdownlint-disable MD051 -->
 
 # Install and run Azure AI Translator container
 
-> [!IMPORTANT]
->
-> * To use the Translator container, you must submit an online request and have it approved. For more information, *see* [Request container access](overview.md#request-container-access).
-> * Azure AI Translator container supports limited features compared to the cloud offerings.
-
 Containers enable you to host the Azure AI Translator API on your own infrastructure. The container image includes all libraries, tools, and dependencies needed to run an application consistently in any private, public, or personal computing environment. If your security or data governance requirements can't be fulfilled by calling Azure AI Translator API remotely, containers are a good option.
 
 In this article, learn how to install and run the Translator container online with Docker API. The Azure AI Translator container supports the following operations:
@@ -35,7 +32,7 @@ In this article, learn how to install and run the Translator container online wi
 
 ## Prerequisites
 
-To get started, you need the following resources, access approval, and tools:
+To get started, you need the following resources, gated access approval, and tools:
 
 ##### Azure resources
 
@@ -46,6 +43,9 @@ To get started, you need the following resources, access approval, and tools:
 * An [**Azure AI Translator resource**](https://portal.azure.com/#create/Microsoft.CognitiveServicesTextTranslation) (**not** a multi-service Azure AI services resource) created under the approved subscription ID. You need the API key and endpoint URI associated with your resource. Both values are required to start the container and can be found on the resource overview page in the Azure portal.
 
   * For Translator **connected** containers, select the `S1` pricing tier.
+
+    :::image type="content" source="media/connected-pricing-tier.png" alt-text="Screenshot of pricing tier selection for Translator connected container.":::
+
   * For Translator **disconnected** containers, select **`Commitment tier disconnected containers`** as your pricing tier. You only see the option to purchase a commitment tier if your disconnected container access request is approved.
 
       :::image type="content" source="media/disconnected-pricing-tier.png" alt-text="A screenshot showing resource creation on the Azure portal.":::
@@ -96,12 +96,12 @@ The following table describes the minimum and recommended specifications and the
    > [!TIP]
    > You can use the [docker images](https://docs.docker.com/engine/reference/commandline/images/) command to list your downloaded container images. For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:
    >
-   >  ```docker
+   > ```docker
    >  docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"
    >
    >  IMAGE ID         REPOSITORY                TAG
    >  <image-id>       <repository-path/name>    <tag-name>
-   >  ```
+   > ```
 
 ## Required input
 
@@ -151,7 +151,7 @@ To use the latest version of the container, use the latest tag. You can view
 
 Select a tab to choose your Azure AI Translator container environment:
 
-## [**Connected containers**](#tab/connected)
+### [**Connected containers**](#tab/connected)
 
 Azure AI Translator containers enable you to run the Azure AI Translator service `on-premise` in your own environment. Connected containers run locally and send usage information to the cloud for billing.
 
@@ -586,23 +586,27 @@ https://<service>/records/usage-logs/{MONTH}/{YEAR}
 
 The usage-logs endpoints return a JSON response similar to the following example:
 
+### [**Connected containers**](#tab/connected)
+
 ***Connected container***
 
-The `quantity` is the amount you're charged for connected container usage.
+Usage charges are calculated based upon the `quantity` value.
 
    ```json
    {
-   "apiType": "string",
+     "apiType": "string",
    "serviceName": "string",
    "meters": [
-   {
+     {
        "name": "string",
        "quantity": 256345435
        }
      ]
    }
    ```
 
+### [**Disconnected (offline) containers**](#tab/disconnected)
+
 ***Disconnected container***
 
    ```json
@@ -631,6 +635,8 @@ The aggregated value of `billedUnit` for the following meters is counted  toward
 
 * `CognitiveServices.TextTranslation.Container.TranslatedCharacters`
 
+---
+
 ### Summary
 
 In this article, you learned concepts and workflows for downloading, installing, and running an Azure AI Translator container:

articles/ai-services/translator/containers/media/connected-pricing-tier.png

@@ -6,28 +6,23 @@ author: laujan
 manager: nitinme
 ms.service: azure-ai-translator
 ms.topic: overview
-ms.date: 04/08/2024
+ms.date: 05/02/2024
 ms.author: lajanuar
 ---
 
 # What is Azure AI Translator container?
 
-> [!IMPORTANT]
->
-> * To use the Translator container, you must submit an online request and have it approved. For more information, *see* [Request container access](#request-container-access).
-> * Azure AI Translator container supports limited features compared to the cloud offerings.  For more information, *see* [**Container translate methods**](translator-container-supported-parameters.md).
-
 Azure AI Translator container enables you to build translator application architecture that is optimized for both robust cloud capabilities and edge locality. A container is a running instance of an executable software image. The Translator container image includes all libraries, tools, and dependencies needed to run an application consistently in any private, public, or personal computing environment. Containers are isolated, lightweight, portable, and are great for implementing specific security or data governance requirements. Translator container is available in [connected](#connected-containers) and [disconnected (offline)](#disconnected-containers) modalities.
 
 ## Connected containers
 
-* **Translator connected container** is deployed on premises and processes content in your environment. It requires internet connectivity to transmit usage metadata for billing; however, your customer content isn't transmitted outside of your premises.
+**Translator connected container** is deployed on premises and processes content in your environment. It requires internet connectivity to transmit usage metadata for billing; however, your content isn't transmitted outside of your premises. The `EULA`, `Billing`, and `APIKey` options must be specified to run a container.
 
-You're billed for connected containers monthly, based on the usage and consumption. The container needs to be configured to send metering data to Azure, and transactions are billed accordingly. Queries to the container are billed at the pricing tier of the Azure resource used for the API Key. You're billed for each container instance used to process your documents and images.
+You're billed for connected containers monthly, based on the usage and consumption. Queries to the container are billed at the pricing tier for the Azure resource used for the `APIKey` parameter. For more information, *see* [Billing configuration](configuration.md#billing-configuration-setting).
 
-  ***Sample billing metadata transmitted by Translator connected container***
+  ***Sample billing metadata for Translator connected container***
 
-  The `quantity` is the amount you're charged for connected container usage.
+  Usage charges are calculated based upon the `quantity` value.
 
    ```json
    {
@@ -41,13 +36,13 @@ You're billed for connected containers monthly, based on the usage and consumpti
 
 ## Disconnected containers
 
-* **Translator disconnected container** is deployed on premises and processes content in your environment. It doesn't require internet connectivity at runtime. Customer must license the container for projected usage over a year and is charged affront.
+**Translator disconnected container** is deployed on premises and processes content in your environment. It doesn't require internet connectivity at runtime. Customer must license the container for projected usage over a year and is charged affront.
 
 Disconnected containers are offered through commitment tier pricing offered at a discounted rate compared to pay-as-you-go pricing. With commitment tier pricing, you can commit to using Translator Service features for a fixed fee, at a predictable total cost, based on the needs of your workload. Commitment plans for disconnected containers have a calendar year commitment period.
 
 When you purchase a plan, you're charged the full price immediately. During the commitment period, you can't change your commitment plan; however you can purchase more units at a pro-rated price for the remaining days in the year. You have until midnight (UTC) on the last day of your commitment, to end a commitment plan.
 
-  ***Sample billing metadata transmitted by Translator disconnected container***
+  ***Sample billing metadata for Translator disconnected container***
 
    ```json
       {
@@ -75,10 +70,9 @@ The aggregated value of `billedUnit` for the following meters is counted  toward
 
 * `CognitiveServices.TextTranslation.Container.TranslatedCharacters`
 
-
 ## Request container access
 
-Translator containers are a gated offering. To use the Translator container, you must submit an online request and for approval.
+**Translator containers are a gated offering. To use the Translator container, you must submit an online request for approval.**
 
 * To request access to a connected container, complete and submit the [**connected container access request form**](https://aka.ms/csgate-translator).
 

articles/ai-services/translator/containers/overview.md

@@ -1,5 +1,5 @@
 ---
-title: "Container: Translate document method"
+title: "Container: Translate document"
 titleSuffix: Azure AI services
 description: Understand the parameters, headers, and body request/response messages for the Azure AI Translator container translate document operation.
 #services: cognitive-services
@@ -26,7 +26,7 @@ ms.author: lajanuar
 `POST` request:
 
 ```bash
-    POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version=2023-11-01-preview" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
+    POST "http://localhost:{port}/translator/document:translate?sourceLanguage={sourceLanguage}&targetLanguage={targetLanguage}&api-version={api-version}" -F "document=@{path-to-your-document-with-file-extension};type={ContentType}/{file-extension}" -o "{path-to-output-file-with-file-extension}"
 ```
 
 Example:
@@ -71,7 +71,7 @@ For this project, you need a source document to translate. You can download our
 Here's an example cURL HTTP request using localhost:5000:
 
 ```bash
-curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=v1.0" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"
+curl -v "http://localhost:5000/translator/document:translate?sourceLanguage=en&targetLanguage=es&api-version=2023-11-01-preview" -F "document=@document-translation-sample-docx" -o "C:\translation\translated-file.md"
 ```
 
 ***Upon successful completion***:

articles/ai-services/translator/containers/translate-document-parameters.md

@@ -1,5 +1,5 @@
 ---
-title: "Container: Translate text method"
+title: "Container: Translate text"
 titleSuffix: Azure AI services
 description: Understand the parameters, headers, and body messages for the Azure AI Translator container translate document operation.
 author: laujan

articles/ai-services/translator/containers/translate-text-parameters.md

@@ -1,5 +1,5 @@
 ---
-title: "Container: Transliterate document method"
+title: "Container: Transliterate text"
 titleSuffix: Azure AI services
 description: Understand the parameters, headers, and body messages for the Azure AI Translator container transliterate text operation.
 #services: cognitive-services

articles/ai-services/translator/containers/transliterate-text-parameters.md

@@ -144,7 +144,7 @@ For detailed information regarding Azure AI Translator Service request limits, *
 Document Translation data residency depends on the Azure region where your Translator resource was created:
 
 ✔️ Feature: **Document Translation**</br>
-✔️ Service endpoint:  **Custom:** &#8198;&#8198;&#8198; **`<name-of-your-resource.cognitiveservices.azure.com/translator/text/batch/v1.1`**
+✔️ Service endpoint:  **Custom: `<name-of-your-resource.cognitiveservices.azure.com/translator/text/batch/v1.1`**
 
 |Resource created region| Request processing data center |
 |----------------------------------|-----------------------|

articles/ai-services/translator/document-translation/overview.md

@@ -168,6 +168,8 @@ Limitations for log search alert rule queries:
     1. Enter values for the **Alert rule name** and the **Alert rule description**.
        > [!NOTE]
        > Notice that rule that uses **Identity** cannot have the character ";" in the **Alert rule name**
+       > Customers cannot set a specific time to run the alert at same time everyday, but they can set frequency to run the alert rule.
+       
     1. Select the **Region**.
     1. <a name="managed-id"></a>In the **Identity** section, select which identity is used by the log search alert rule to send the log query. This identity is used for authentication when the alert rule executes the log query.