Merge pull request #276325 from PatrickFarley/apim-migration

JamesJBarnett · web-flow · commit 103510f69334 · 2024-05-24T12:10:03.000-07:00
Apim migration
diff --git a/articles/ai-services/computer-vision/concept-brand-detection.md b/articles/ai-services/computer-vision/concept-brand-detection.md
@@ -69,6 +69,6 @@ In some cases, the brand detector picks up both the logo image and the stylized
 
 ## Use the API
 
-The brand detection feature is part of the [Analyze Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API. You can call this API through a native SDK or through REST calls. Include `Brands` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"brands"` section.
+The brand detection feature is part of the [Analyze Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API. You can call this API through a native SDK or through REST calls. Include `Brands` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"brands"` section.
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-categorizing-images.md b/articles/ai-services/computer-vision/concept-categorizing-images.md
@@ -56,7 +56,7 @@ The following table illustrates a typical image set and the category returned by
 
 ## Use the API
 
-The categorization feature is part of the [Analyze Image 3.2](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API. You can call this API through a native SDK or through REST calls. Include `Categories` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"categories"` section.
+The categorization feature is part of the [Analyze Image 3.2](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API. You can call this API through a native SDK or through REST calls. Include `Categories` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"categories"` section.
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
 
diff --git a/articles/ai-services/computer-vision/concept-describing-images.md b/articles/ai-services/computer-vision/concept-describing-images.md
@@ -56,7 +56,7 @@ The following JSON response illustrates what the Analyze API returns when descri
 
 ## Use the API
 
-The image description feature is part of the [Analyze Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API. You can call this API through a native SDK or through REST calls. Include `Description` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"description"` section.
+The image description feature is part of the [Analyze Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API. You can call this API through a native SDK or through REST calls. Include `Description` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"description"` section.
 
 * [Quickstart: Image Analysis REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
 
diff --git a/articles/ai-services/computer-vision/concept-detecting-adult-content.md b/articles/ai-services/computer-vision/concept-detecting-adult-content.md
@@ -34,6 +34,6 @@ The "adult" classification contains several different categories:
 
 ## Use the API
 
-You can detect adult content with the [Analyze Image 3.2](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API. When you add the value of `Adult` to the **visualFeatures** query parameter, the API returns three boolean properties&mdash;`isAdultContent`, `isRacyContent`, and `isGoryContent`&mdash;in its JSON response. The method also returns corresponding properties&mdash;`adultScore`, `racyScore`, and `goreScore`&mdash;which represent confidence scores between zero and one for each respective category.
+You can detect adult content with the [Analyze Image 3.2](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API. When you add the value of `Adult` to the **visualFeatures** query parameter, the API returns three boolean properties&mdash;`isAdultContent`, `isRacyContent`, and `isGoryContent`&mdash;in its JSON response. The method also returns corresponding properties&mdash;`adultScore`, `racyScore`, and `goreScore`&mdash;which represent confidence scores between zero and one for each respective category.
 
 - [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-detecting-color-schemes.md b/articles/ai-services/computer-vision/concept-detecting-color-schemes.md
@@ -77,6 +77,6 @@ The following table shows Azure AI Vision's black and white evaluation in the sa
 
 ## Use the API
 
-The color scheme detection feature is part of the [Analyze Image 3.2](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API. You can call this API through a native SDK or through REST calls. Include `Color` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"color"` section.
+The color scheme detection feature is part of the [Analyze Image 3.2](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API. You can call this API through a native SDK or through REST calls. Include `Color` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"color"` section.
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-detecting-domain-content.md b/articles/ai-services/computer-vision/concept-detecting-domain-content.md
@@ -20,7 +20,7 @@ There are two ways to use the domain-specific models: by themselves (scoped anal
 
 ### Scoped analysis
 
-You can analyze an image using only the chosen domain-specific model by calling the [Models/\<model\>/Analyze](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API.
+You can analyze an image using only the chosen domain-specific model by calling the [Models/\<model\>/Analyze](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API.
 
 The following is a sample JSON response returned by the `models/celebrities/analyze` API for the given image:
 
@@ -51,7 +51,7 @@ The following is a sample JSON response returned by the `models/celebrities/anal
 
 ### Enhanced categorization analysis
 
-You can also use domain-specific models to supplement general image analysis. You do this as part of [high-level categorization](concept-categorizing-images.md) by specifying domain-specific models in the *details* parameter of the [Analyze Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API call.
+You can also use domain-specific models to supplement general image analysis. You do this as part of [high-level categorization](concept-categorizing-images.md) by specifying domain-specific models in the *details* parameter of the [Analyze Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API call.
 
 In this case, the 86-category taxonomy classifier is called first. If any of the detected categories have a matching domain-specific model, the image is passed through that model as well and the results are added.
 
@@ -99,7 +99,7 @@ Currently, Azure AI Vision supports the following domain-specific models:
 | celebrities | Celebrity recognition, supported for images classified in the `people_` category |
 | landmarks | Landmark recognition, supported for images classified in the `outdoor_` or `building_` categories |
 
-Calling the [Models](/rest/api/computervision/list-models/list-models?view=rest-computervision-v3.1&tabs=HTTP) API returns this information along with the categories to which each model can apply:
+Calling the [Models](/rest/api/computervision/list-models/list-models?view=rest-computervision-v3.2&tabs=HTTP) API returns this information along with the categories to which each model can apply:
 
 ```json
 {
@@ -133,6 +133,6 @@ Calling the [Models](/rest/api/computervision/list-models/list-models?view=rest-
 
 ## Use the API
 
-This feature is available through the [Analyze Image 3.2 API](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.1&tabs=HTTP). You can call this API through a native SDK or through REST calls. Include `Celebrities` or `Landmarks` in the **details** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"details"` section.
+This feature is available through the [Analyze Image 3.2 API](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.2&tabs=HTTP). You can call this API through a native SDK or through REST calls. Include `Celebrities` or `Landmarks` in the **details** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"details"` section.
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-detecting-faces.md b/articles/ai-services/computer-vision/concept-detecting-faces.md
@@ -110,6 +110,6 @@ The next example demonstrates the JSON response returned for an image containing
 
 ## Use the API
 
-The face detection feature is part of the [Analyze Image 3.2](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.1&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. Include `Faces` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"faces"` section.
+The face detection feature is part of the [Analyze Image 3.2](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.2&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. Include `Faces` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"faces"` section.
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-detecting-image-types.md b/articles/ai-services/computer-vision/concept-detecting-image-types.md
@@ -14,7 +14,7 @@ ms.author: pafarley
 
 # Image type detection
 
-With the [Analyze Image 3.2 API](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.1&tabs=HTTP), Azure AI Vision can analyze the content type of images and indicate whether an image is clip art or a line drawing.
+With the [Analyze Image 3.2 API](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.2&tabs=HTTP), Azure AI Vision can analyze the content type of images and indicate whether an image is clip art or a line drawing.
 
 ## Clip art detection
 
@@ -109,6 +109,6 @@ The following JSON responses illustrates what Azure AI Vision returns when indic
 
 ## Use the API
 
-The image type detection feature is part of the [Analyze Image 3.2 API](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.1&tabs=HTTP). You can call this API through a native SDK or through REST calls. Include `ImageType` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"imageType"` section.
+The image type detection feature is part of the [Analyze Image 3.2 API](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.2&tabs=HTTP). You can call this API through a native SDK or through REST calls. Include `ImageType` in the **visualFeatures** query parameter. Then, when you get the full JSON response, simply parse the string for the contents of the `"imageType"` section.
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-generating-thumbnails.md b/articles/ai-services/computer-vision/concept-generating-thumbnails.md
@@ -46,7 +46,7 @@ The following table illustrates thumbnails defined by smart-cropping for the exa
 ## Use the API
 
 
-The generate thumbnail feature is available through the [Get Thumbnail](/rest/api/computervision/generate-thumbnail/generate-thumbnail?view=rest-computervision-v3.1&tabs=HTTP) and [Get Area of Interest](/rest/api/computervision/get-area-of-interest/get-area-of-interest?view=rest-computervision-v3.1&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. 
+The generate thumbnail feature is available through the [Get Thumbnail](/rest/api/computervision/generate-thumbnail/generate-thumbnail?view=rest-computervision-v3.2&tabs=HTTP) and [Get Area of Interest](/rest/api/computervision/get-area-of-interest/get-area-of-interest?view=rest-computervision-v3.2&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. 
 
 
 * [Generate a thumbnail (how-to)](./how-to/generate-thumbnail.md)
diff --git a/articles/ai-services/computer-vision/concept-object-detection.md b/articles/ai-services/computer-vision/concept-object-detection.md
@@ -99,7 +99,7 @@ It's important to note the limitations of object detection so you can avoid or m
 
 ## Use the API
 
-The object detection feature is part of the [Analyze Image](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.1&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. Include `Objects` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"objects"` section.
+The object detection feature is part of the [Analyze Image](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.2&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. Include `Objects` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"objects"` section.
 
 
 * [Quickstart: Vision REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/concept-tagging-images.md b/articles/ai-services/computer-vision/concept-tagging-images.md
@@ -137,7 +137,7 @@ The following JSON response illustrates what Azure AI Vision returns when taggin
 
 ## Use the API
 
-The tagging feature is part of the [Analyze Image](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.1&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. Include `Tags` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"tags"` section.
+The tagging feature is part of the [Analyze Image](/rest/api/computervision/analyze-image/analyze-image?view=rest-computervision-v3.2&tabs=HTTP) API. You can call this API through a native SDK or through REST calls. Include `Tags` in the **visualFeatures** query parameter. Then, when you get the full JSON response, parse the string for the contents of the `"tags"` section.
 
 
 * [Quickstart: Image Analysis REST API or client libraries](./quickstarts-sdk/image-analysis-client-library.md?pivots=programming-language-csharp)
diff --git a/articles/ai-services/computer-vision/how-to/call-analyze-image.md b/articles/ai-services/computer-vision/how-to/call-analyze-image.md
@@ -183,7 +183,7 @@ This section shows you how to parse the results of the API call. It includes the
 > [!NOTE]
 > **Scoped API calls**
 >
-> Some of the features in Image Analysis can be called directly as well as through the Analyze API call. For example, you can do a scoped analysis of only image tags by making a request to `<endpoint>/vision/v3.2/tag` (or to the corresponding method in the SDK). See the [reference documentation](/rest/api/computervision/operation-groups?view=rest-computervision-v3.1) for other features that can be called separately.
+> Some of the features in Image Analysis can be called directly as well as through the Analyze API call. For example, you can do a scoped analysis of only image tags by making a request to `<endpoint>/vision/v3.2/tag` (or to the corresponding method in the SDK). See the [reference documentation](/rest/api/computervision/operation-groups?view=rest-computervision-v3.2) for other features that can be called separately.
 
 #### [REST](#tab/rest)
 
diff --git a/articles/ai-services/computer-vision/how-to/identity-access-token.md b/articles/ai-services/computer-vision/how-to/identity-access-token.md
@@ -19,7 +19,7 @@ Independent software vendors (ISVs) can manage the Face API usage of their clien
 
 This guide shows you how to generate the access tokens, if you're an approved ISV, and how to use the tokens if you're a client. 
 
-The limited access token feature is a part of the existing [Azure AI services token service](https://westus.dev.cognitive.microsoft.com/docs/services/57346a70b4769d2694911369/operations/issueScopedToken).  We have added a new operation for the purpose of bypassing the Limited Access gate for approved scenarios. Only ISVs that pass the gating requirements will be given access to this feature.
+The limited access token feature is a part of the existing Azure AI Services token service. We have added a new operation for the purpose of bypassing the Limited Access gate for approved scenarios. Only ISVs that pass the gating requirements will be given access to this feature.
 
 ## Example use case
 
@@ -172,5 +172,4 @@ static void Main(string[] args)
 ```
 ---
 
-## Next steps
-* [LimitedAccessToken API reference](https://westus.dev.cognitive.microsoft.com/docs/services/57346a70b4769d2694911369/operations/issueLimitedAccessToken)
+
diff --git a/articles/ai-services/computer-vision/index.yml b/articles/ai-services/computer-vision/index.yml
@@ -49,7 +49,7 @@ conceptualContent:
           url: /training/modules/read-text-images-documents-with-computer-vision-service/
         - itemType: reference
           text: OCR API reference
-          url: /rest/api/computervision/read?view=rest-computervision-v3.2-preview
+          url: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2
 
     - title: Image Analysis
       links:
@@ -166,7 +166,7 @@ additionalContent:
       - title: REST APIs
         links:
         - text: Optical character recognition (OCR)
-          url: /rest/api/computervision/read?view=rest-computervision-v3.2-preview
+          url: /rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2
         - text: Image Analysis
           url: https://aka.ms/vision-4-0-ref
         - text: Face
diff --git a/articles/ai-services/computer-vision/language-support.md b/articles/ai-services/computer-vision/language-support.md
@@ -127,7 +127,7 @@ The following table lists the OCR supported languages for print text by the most
 
 ## Analyze image
 
-Some features of the [Analyze - Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.1) API can return results in other languages, specified with the `language` query parameter. Other actions return results in English regardless of what language is specified, and others throw an exception for unsupported languages. Actions are specified with the `visualFeatures` and `details` query parameters; see the [Overview](overview-image-analysis.md) for a list of all the actions you can do with the Analyze API, or follow the [How-to guide](/azure/ai-services/computer-vision/how-to/call-analyze-image-40) to try them out.
+Some features of the [Analyze - Image](/rest/api/computervision/analyze-image?view=rest-computervision-v3.2) API can return results in other languages, specified with the `language` query parameter. Other actions return results in English regardless of what language is specified, and others throw an exception for unsupported languages. Actions are specified with the `visualFeatures` and `details` query parameters; see the [Overview](overview-image-analysis.md) for a list of all the actions you can do with the Analyze API, or follow the [How-to guide](/azure/ai-services/computer-vision/how-to/call-analyze-image-40) to try them out.
 
 | Language | Language code | Categories | Tags | Description | Adult, Brands, Color, Faces, ImageType, Objects | Celebrities, Landmarks | Captions, Dense captions|
 |:---|:---:|:----:|:---:|:---:|:---:|:---:|:--:|
diff --git a/articles/ai-services/computer-vision/overview-ocr.md b/articles/ai-services/computer-vision/overview-ocr.md
@@ -26,7 +26,7 @@ Intelligent Document Processing (IDP) uses OCR as its foundational technology to
 Microsoft's **Read** OCR engine is composed of multiple advanced machine-learning based models supporting [global languages](./language-support.md). It can extract printed and handwritten text including mixed languages and writing styles. **Read** is available as cloud service and on-premises container for deployment flexibility. With the latest preview, it's also available as a synchronous API for single, non-document, image-only scenarios with performance enhancements that make it easier to implement OCR-assisted user experiences.
 
 > [!WARNING]
-> The Azure AI Vision legacy [OCR API in v3.2](/rest/api/computervision/read?view=rest-computervision-v3.2-preview) and [RecognizeText API in v2.1](/rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.1) operations are not recommended for use.
+> The Azure AI Vision legacy [OCR API in v3.2](/rest/api/computervision/recognize-printed-text?view=rest-computervision-v3.2) and [RecognizeText API in v2.1](/rest/api/computervision/recognize-printed-text/recognize-printed-text?view=rest-computervision-v2.1) operations are not recommended for use.
 
 [!INCLUDE [read-editions](includes/read-editions.md)]
 
diff --git a/articles/ai-services/computer-vision/sdk/overview-sdk.md b/articles/ai-services/computer-vision/sdk/overview-sdk.md
diff --git a/articles/ai-services/computer-vision/toc.yml b/articles/ai-services/computer-vision/toc.yml
diff --git a/articles/ai-services/computer-vision/whats-new.md b/articles/ai-services/computer-vision/whats-new.md
