Merge pull request #209687 from Juliako/patch-18

Stacyrch140 · web-flow · commit 29871547be51 · 2022-08-31T00:12:56.000-04:00
Update video-indexer-get-started.md
diff --git a/articles/azure-video-indexer/accounts-overview.md b/articles/azure-video-indexer/accounts-overview.md
@@ -10,21 +10,28 @@ ms.author: juliako
 
 This article gives an overview of Azure Video Indexer accounts types and provides links to other articles for more details.
 
-## Overview
+## A trial account
 
-The first time you visit the [www.videoindexer.ai/](https://www.videoindexer.ai/) website, a trial account is automatically created. A trial Azure Video Indexer account has limitation on number of indexing minutes, support, and SLA.
+The first time you visit the [Azure Video Indexer](https://www.videoindexer.ai/) website, a trial account is automatically created. The trial Azure Video Indexer account has limitation on number of indexing minutes, support, and SLA.
 
-With a trial, account Azure Video Indexer provides up to 600 minutes of free indexing to users and up to 2400 minutes of free indexing to users that subscribe to the Azure Video Indexer API on the [developer portal](https://aka.ms/avam-dev-portal).
+With a trial, account Azure Video Indexer provides:
 
-The trial account is not available on the Azure Government cloud. For other Azure Government limitations, see [Limitations of Azure Video Indexer on Azure Government](connect-to-azure.md#limitations-of-azure-video-indexer-on-azure-government).
+* up to 600 minutes of free indexing to the [Azure Video Indexer](https://www.videoindexer.ai/) website users and 
+* up to 2400 minutes of free indexing to users that subscribe to the Azure Video Indexer API on the [developer portal](https://aka.ms/avam-dev-portal).
+
+When using the trial account, you don't have to set up an Azure subscription.
+
+The trial account option is not available on the Azure Government cloud. For other Azure Government limitations, see [Limitations of Azure Video Indexer on Azure Government](connect-to-azure.md#limitations-of-azure-video-indexer-on-azure-government).
+
+## A paid (unlimited) account
 
 You can later create a paid account where you're not limited by the quota. Two types of paid accounts are available to you: Azure Resource Manager (ARM) (currently in preview) and classic (generally available). The main difference between the two is account management platform. While classic accounts are built on the API Management, ARM-based accounts management is built on Azure, which enables apply access control to all services with role-based access control (Azure RBAC) natively.
 
-Make sure to review [Pricing](https://azure.microsoft.com/pricing/details/video-indexer/).
+With the paid option, you pay for indexed minutes, for more information, see [Azure Video Indexer pricing](https://azure.microsoft.com/pricing/details/video-indexer/).
 
-## Connecting to Azure subscription
+When creating a new paid account, you need to connect the Azure Video Indexer account to your Azure subscription and an Azure Media Services account. 
 
-With a trial account, you don't have to set up an Azure subscription. When creating a paid account, you need to connect Azure Video Indexer [to your Azure subscription and an Azure Media Services account](connect-to-azure.md). 
+**The recommended paid account type is the ARM-based account**.
 
 ## To get access to your account
 
@@ -35,17 +42,17 @@ With a trial account, you don't have to set up an Azure subscription. When creat
 
 ## Create accounts
 
-* ARM accounts:  **The recommended paid account type is the ARM-based account**.  
+* Creating ARM accounts. Make sure you are signed in with the correct domain to the [Azure Video Indexer website](https://www.videoindexer.ai/). For details, see [Switch tenants](switch-tenants-portal.md).  
 
-    * You can create an Azure Video Indexer **ARM-based** account through one of the following:
+    * You can create an Azure Video Indexer ARM-based account through one of the following:
     
-      1. [Azure Video Indexer portal](https://aka.ms/vi-portal-link)
-      2. [Azure portal](https://portal.azure.com/#home)
+      1. The [Azure Video Indexer website](https://aka.ms/vi-portal-link)
+      2. The [Azure portal](https://portal.azure.com/#home)
       
     For the detailed description, [Get started with Azure Video Indexer in Azure portal](create-account-portal.md).
 * Upgrade a trial account to an ARM-based account and [import your content for free](import-content-from-trial.md).  
-* Classic accounts: [Create classic accounts using API](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Create-Paid-Account).
-* Connect a classic account to ARM: [Connect an existing classic paid Azure Video Indexer account to an ARM-based account](connect-classic-account-to-arm.md).
+* [Create classic accounts using API](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Create-Paid-Account).
+* [Connect an existing classic paid Azure Video Indexer account to an ARM-based account](connect-classic-account-to-arm.md).
 
 ## Limited access features
 
@@ -62,4 +69,4 @@ For more information, see [Azure Video Indexer limited access features](limited-
 
 ## Next steps
 
-[Pricing](https://azure.microsoft.com/pricing/details/video-indexer/)
+Make sure to review [Pricing](https://azure.microsoft.com/pricing/details/video-indexer/).
diff --git a/articles/azure-video-indexer/logic-apps-connector-tutorial.md b/articles/azure-video-indexer/logic-apps-connector-tutorial.md
@@ -59,7 +59,7 @@ Also, add a new "Shared Access Protocol" parameter. Choose HttpsOnly for the val
 
 ![SAS uri by path](./media/logic-apps-connector-tutorial/sas-uri-by-path.jpg)
 
-Fill out [your account location](regions.md) and [account ID](./video-indexer-use-apis.md#account-id) to get the Azure Video Indexer account token.
+Fill out [your account location](regions.md) and [account ID](./video-indexer-use-apis.md#operational-api-calls) to get the Azure Video Indexer account token.
 
 ![Get account access token](./media/logic-apps-connector-tutorial/account-access-token.png)
 
@@ -83,9 +83,9 @@ Create the second flow separate from the first one.
 
 To set up this flow, you will need to provide your Azure Video Indexer API Key and Azure Storage credentials again. You will need to update the same parameters as you did for the first flow. 
 
-For your trigger, you will see a HTTP POST URL field. The URL won’t be generated until after you save your flow; however, you will need the URL eventually. We will come back to this. 
+For your trigger, you will see an HTTP POST URL field. The URL won’t be generated until after you save your flow; however, you will need the URL eventually. We will come back to this. 
 
-Fill out [your account location](regions.md) and [account ID](./video-indexer-use-apis.md#account-id) to get the Azure Video Indexer account token.  
+Fill out [your account location](regions.md) and [account ID](./video-indexer-use-apis.md#operational-api-calls) to get the Azure Video Indexer account token.  
 
 Go to the “Get Video Index” action and fill out the required parameters. For Video ID, put in the following expression: triggerOutputs()['queries']['id'] 
 
diff --git a/articles/azure-video-indexer/video-indexer-get-started.md b/articles/azure-video-indexer/video-indexer-get-started.md
@@ -11,11 +11,9 @@ ms.custom: mode-other
 
 [!INCLUDE [Gate notice](./includes/face-limited-access.md)]
 
-This quickstart shows you how to sign in to the Azure Video Indexer [website](https://www.videoindexer.ai/) and how to upload your first video. When visiting the Azure Video Indexer website for the first time, the free trial account is automatically created for you. With the free trial account, you get a certain number of free indexing minutes. When creating an unlimited/paid account, you aren't limited by the quota. 
+This quickstart shows you how to sign in to the Azure Video Indexer [website](https://www.videoindexer.ai/) and how to upload your first video. When visiting the Azure Video Indexer website for the first time, a trial account is automatically created for you. With the trial account, you get a certain number of free indexing minutes. You can later add a paid (ARM-based or classic) account. With the paid option, you pay for indexed minutes.
 
-With free trial, Azure Video Indexer provides up to 600 minutes of free indexing to website users and up to 2400 minutes of free indexing to API users. With paid option, you create an Azure Video Indexer account that is [connected to your Azure subscription and an Azure Media Services account](connect-to-azure.md). You pay for minutes indexed, for more information, see [Media Services pricing](https://azure.microsoft.com/pricing/details/media-services/).
-
-For details about available accounts, see [Azure Video Indexer account types](accounts-overview.md).
+For details about available accounts (trial and paid options), see [Azure Video Indexer account types](accounts-overview.md).
 
 ## Sign up for Azure Video Indexer
 
@@ -28,6 +26,10 @@ Once you start using Azure Video Indexer, all your stored data and uploaded cont
 
 ## Upload a video using the Azure Video Indexer website
 
+### Supported browsers
+
+For more information, see [supported browsers](video-indexer-overview.md#supported-browsers).
+
 ### Supported file formats for Azure Video Indexer
 
 See the [input container/file formats](/azure/media-services/latest/encode-media-encoder-standard-formats-reference) article for a list of file formats that you can use with Azure Video Indexer.
@@ -49,7 +51,8 @@ See the [input container/file formats](/azure/media-services/latest/encode-media
     > [!div class="mx-imgBorder"]
     > :::image type="content" source="./media/video-indexer-get-started/progress.png" alt-text="Progress of the upload"::: 
 
-    The produced JSON output contains  `Insights` and `SummarizedInsights` elements. We highly recommend using `Insights` and not using `SummarizedInsights` (which is present for backward compatibility). 
+    The produced JSON output contains `Insights` and `SummarizedInsights` elements. We highly recommend using `Insights` and not using `SummarizedInsights` (which is present for backward compatibility). 
+    
 1. Once Azure Video Indexer is done analyzing, you'll get an email with a link to your video and a short description of what was found in your video. For example: people, spoken and written words, topics, and named entities.
 1. You can later find your video in the library list and perform different operations. For example: search, reindex, edit.
 
@@ -62,10 +65,6 @@ For more details, see [Upload and index videos](upload-index-videos.md).
 
 To start using the APIs, see [use APIs](video-indexer-use-apis.md)
 
-## Supported browsers
-
-For more information, see [supported browsers](video-indexer-overview.md#supported-browsers).
-
 ## Next steps
 
 For detailed introduction please visit our [introduction lab](https://github.com/Azure-Samples/media-services-video-indexer/blob/master/IntroToVideoIndexer.md).
diff --git a/articles/azure-video-indexer/video-indexer-use-apis.md b/articles/azure-video-indexer/video-indexer-use-apis.md
@@ -10,7 +10,9 @@ ms.custom: devx-track-csharp
 
 Azure Video Indexer consolidates various audio and video artificial intelligence (AI) technologies offered by Microsoft into one integrated service, making development simpler. The APIs are designed to enable developers to focus on consuming Media AI technologies without worrying about scale, global reach, availability, and reliability of cloud platforms. You can use the API to upload your files, get detailed video insights, get URLs of embeddable insight and player widgets, and more.
 
-When creating an Azure Video Indexer account, you can choose a trial account (where you get a certain number of free indexing minutes) or a paid option (where you're not limited by the quota). With a trial, account, Azure Video Indexer provides up to 600 minutes of free indexing to website users and up to 2400 minutes of free indexing to API users. With a paid option, you create an Azure Video Indexer account that's [connected to your Azure subscription and an Azure Media Services account](connect-to-azure.md). You pay for minutes indexed, for more information, see [Media Services pricing](https://azure.microsoft.com/pricing/details/media-services/).
+When visiting the [Azure Video Indexer](https://www.videoindexer.ai/) website for the first time, a trial account is automatically created for you. With the trial account, you get a certain number of free indexing minutes. You can later add a paid (ARM-based or classic) account. With the paid option, you pay for indexed minutes.
+
+For details about available accounts (trial and paid options), see [Azure Video Indexer account types](accounts-overview.md).
 
 This article shows how the developers can take advantage of the [Azure Video Indexer API](https://api-portal.videoindexer.ai/).
 
@@ -31,7 +33,7 @@ This article shows how the developers can take advantage of the [Azure Video Ind
 
    Select the [Products](https://api-portal.videoindexer.ai/products) tab. Then, select Authorization and subscribe.
 	
-   ![Products tab in Video Indexer Developer Portal](./media/video-indexer-use-apis/authorization.png)
+   ![Products tab in the Video Indexer developer portal](./media/video-indexer-use-apis/authorization.png)
 
    > [!NOTE]
    > New users are automatically subscribed to Authorization.
@@ -66,7 +68,20 @@ Access tokens expire after 1 hour. Make sure your access token is valid before u
 
 You're ready to start integrating with the API. Find [the detailed description of each Azure Video Indexer REST API](https://api-portal.videoindexer.ai/).
 
-## Account ID
+## Recommendations
+
+This section lists some recommendations when using Azure Video Indexer API.
+
+- If you're planning to upload a video, it's recommended to place the file in some public network location (for example, an Azure Blob Storage account). Get the link to the video and provide the URL as the upload file param.
+
+	The URL provided to Azure Video Indexer must point to a media (audio or video) file. An easy verification for the URL (or SAS URL) is to paste it into a browser, if the file starts playing/downloading, it's likely a good URL. If the browser is rendering some visualization, it's likely not a link to a file but to an HTML page.
+- When you call the API that gets video insights for the specified video, you get a detailed JSON output as the response content. [See details about the returned JSON in this topic](video-indexer-output-json-v2.md).
+- The JSON output produced by the API contains `Insights` and `SummarizedInsights` elements. We highly recommend using `Insights` and not using `SummarizedInsights` (which is present for backward compatibility).
+- We do not recommend that you use data directly from the artifacts folder for production purposes. Artifacts are intermediate outputs of the indexing process. They are essentially raw outputs of the various AI engines that analyze the videos; the artifacts schema may change over time. 
+
+    It is recommended that you use the [Get Video Index](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Get-Video-Index) API, as described in [Get insights and artifacts produced by the API](video-indexer-output-json-v2.md#get-insights-produced-by-the-api) and **not** [Get-Video-Artifact-Download-Url](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Get-Video-Artifact-Download-Url).
+
+## Operational API calls
 
 The Account ID parameter is required in all operational API calls. Account ID is a GUID that can be obtained in one of the following ways:
 
@@ -93,16 +108,6 @@ The Account ID parameter is required in all operational API calls. Account ID is
     https://www.videoindexer.ai/accounts/00000000-f324-4385-b142-f77dacb0a368/videos/d45bf160b5/
     ```
 
-## Recommendations
-
-This section lists some recommendations when using Azure Video Indexer API.
-
-- If you're planning to upload a video, it's recommended to place the file in some public network location (for example, an Azure Blob Storage account). Get the link to the video and provide the URL as the upload file param.
-
-	The URL provided to Azure Video Indexer must point to a media (audio or video) file. An easy verification for the URL (or SAS URL) is to paste it into a browser, if the file starts playing/downloading, it's likely a good URL. If the browser is rendering some visualization, it's likely not a link to a file but to an HTML page.
-
-- When you call the API that gets video insights for the specified video, you get a detailed JSON output as the response content. [See details about the returned JSON in this topic](video-indexer-output-json-v2.md).
-
 ## Code sample
 
 The following C# code snippet demonstrates the usage of all the Azure Video Indexer APIs together.
@@ -207,13 +212,6 @@ Debug.WriteLine(playerWidgetLink);
 
 After you are done with this tutorial, delete resources that you are not planning to use.
 
-## Considerations
-
-* The JSON output produced by the API contains `Insights` and `SummarizedInsights` elements. We highly recommend using `Insights` and not using `SummarizedInsights` (which is present for backward compatibility).
-* We do not recommend that you use data directly from the artifacts folder for production purposes. Artifacts are intermediate outputs of the indexing process. They are essentially raw outputs of the various AI engines that analyze the videos; the artifacts schema may change over time. 
-
-    It is recommended that you use the [Get Video Index](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Get-Video-Index) API, as described in [Get insights and artifacts produced by the API](video-indexer-output-json-v2.md#get-insights-produced-by-the-api) and **not** [Get-Video-Artifact-Download-Url](https://api-portal.videoindexer.ai/api-details#api=Operations&operation=Get-Video-Artifact-Download-Url).
-
 ## See also
 
 - [Azure Video Indexer overview](video-indexer-overview.md)
