Merge pull request #284102 from MicrosoftDocs/main

8/8/2024 PM Publish

Author: Taojunshen

.openpublishing.redirection.azure-monitor.json

@@ -14,7 +14,7 @@ ms.author: pafarley
 
 After you've created and trained a Custom Vision project, you may want to copy your project to another resource. If your app or business depends on a Custom Vision project, we recommend you copy your model to another Custom Vision account in another region. Then if a regional outage occurs, you can access your project in the region where it was copied.
 
-The **[ExportProject](/rest/api/customvision/training/projects/export?view=rest-customvision-training-v3.3&tabs=HTTP)** and **[ImportProject](/rest/api/customvision/training/projects/import?view=rest-customvision-training-v3.3&tabs=HTTP)** APIs enable this scenario by allowing you to copy projects from one Custom Vision account into others. This guide shows you how to use these REST APIs with cURL. You can also use an HTTP request service, like the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) for Visual Studio Code, to issue the requests.
+The **[ExportProject](/rest/api/customvision/projects/export)** and **[ImportProject](/rest/api/customvision/projects/import)** APIs enable this scenario by allowing you to copy projects from one Custom Vision account into others. This guide shows you how to use these REST APIs with cURL. You can also use an HTTP request service, like the [REST Client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client) for Visual Studio Code, to issue the requests.
 
 > [!TIP]
 > For an example of this scenario using the Python client library, see the [Move Custom Vision Project](https://github.com/Azure-Samples/custom-vision-move-project/tree/master/) repository on GitHub.
@@ -39,7 +39,7 @@ The process for copying a project consists of the following steps:
 
 ## Get the project ID
 
-First call **[GetProjects](/rest/api/customvision/training/projects/get?view=rest-customvision-training-v3.3&tabs=HTTP)** to see a list of your existing Custom Vision projects and their IDs. Use the training key and endpoint of your source account.
+First call **[GetProjects](/rest/api/customvision/projects/get)** to see a list of your existing Custom Vision projects and their IDs. Use the training key and endpoint of your source account.
 
 ```curl
 curl -v -X GET "{endpoint}/customvision/v3.3/Training/projects"
@@ -77,7 +77,7 @@ You'll get a `200\OK` response with a list of projects and their metadata in the
 
 ## Export the project
 
-Call **[ExportProject](/rest/api/customvision/training/projects/export?view=rest-customvision-training-v3.3&tabs=HTTP)** using the project ID and your source training key and endpoint.
+Call **[ExportProject](/rest/api/customvision/projects/export)** using the project ID and your source training key and endpoint.
 
 ```curl
 curl -v -X GET "{endpoint}/customvision/v3.3/Training/projects/{projectId}/export"
@@ -102,7 +102,7 @@ You'll get a `200/OK` response with metadata about the exported project and a re
 
 ## Import the project
 
-Call **[ImportProject](/rest/api/customvision/training/projects/import?view=rest-customvision-training-v3.3&tabs=HTTP)** using your target training key and endpoint, along with the reference token. You can also give your project a name in its new account.
+Call **[ImportProject](/rest/api/customvision/projects/import)** using your target training key and endpoint, along with the reference token. You can also give your project a name in its new account.
 
 ```curl
 curl -v -G -X POST "{endpoint}/customvision/v3.3/Training/projects/import"

articles/ai-services/custom-vision-service/copy-move-projects.md

@@ -15,19 +15,19 @@ ms.custom: cogserv-non-critical-vision
 
 # View or delete user data in Custom Vision
 
-Custom Vision collects user data to operate the service, but customers have full control to viewing and delete their data using the Custom Vision [Training APIs](https://go.microsoft.com/fwlink/?linkid=865446).
+Custom Vision collects user data to operate the service, but customers have full control to viewing and delete their data using the Custom Vision [Training APIs](/rest/api/customvision/train-project).
 
 [!INCLUDE [GDPR-related guidance](~/reusable-content/ce-skilling/azure/includes/gdpr-intro-sentence.md)]
 
 To learn how to view or delete different kinds of user data in Custom Vision, see the following table:
 
 | Data | View operation | Delete operation |
 | ---- | ---------------- | ---------------- |
-| Account info (Keys) | [GetAccountInfo](https://go.microsoft.com/fwlink/?linkid=865446) | Delete using Azure portal (for Azure Subscriptions). Or use **Delete Your Account** button in [CustomVision.ai](https://customvision.ai) settings page (for Microsoft Account Subscriptions) | 
-| Iteration details | [GetIteration](https://go.microsoft.com/fwlink/?linkid=865446) | [DeleteIteration](https://go.microsoft.com/fwlink/?linkid=865446) |
-| Iteration performance details | [GetIterationPerformance](https://go.microsoft.com/fwlink/?linkid=865446) | [DeleteIteration](https://go.microsoft.com/fwlink/?linkid=865446) | 
-| List of iterations | [GetIterations](https://go.microsoft.com/fwlink/?linkid=865446) | [DeleteIteration](https://go.microsoft.com/fwlink/?linkid=865446) |
-| Projects and project details | [GetProject](https://go.microsoft.com/fwlink/?linkid=865446) and [GetProjects](https://go.microsoft.com/fwlink/?linkid=865446) | [DeleteProject](https://go.microsoft.com/fwlink/?linkid=865446) | 
-| Image tags | [GetTag](https://go.microsoft.com/fwlink/?linkid=865446) and [GetTags](https://go.microsoft.com/fwlink/?linkid=865446) | [DeleteTag](https://go.microsoft.com/fwlink/?linkid=865446) | 
-| Images | [GetTaggedImages](https://go.microsoft.com/fwlink/?linkid=865446) (provides uri for image download) and [GetUntaggedImages](https://go.microsoft.com/fwlink/?linkid=865446) (provides uri for image download) | [DeleteImages](https://go.microsoft.com/fwlink/?linkid=865446) | 
-| Exported iterations | [GetExports](https://go.microsoft.com/fwlink/?linkid=865446) | Deleted upon account deletion |
+| Account info (Keys) | [GetAccountInfo](/rest/api/aiservices/accountmanagement/accounts/get) | Delete using Azure portal (for Azure Subscriptions). Or use **Delete Your Account** button in [CustomVision.ai](https://customvision.ai) settings page (for Microsoft Account Subscriptions) | 
+| Iteration details | [GetIteration](/rest/api/customvision/get-iteration) | [DeleteIteration](/rest/api/customvision/delete-iteration) |
+| Iteration performance details | [GetIterationPerformance](/rest/api/customvision/get-iteration-performance) | [DeleteIteration](/rest/api/customvision/delete-iteration) | 
+| List of iterations | [GetIterations](/rest/api/customvision/get-iterations) | [DeleteIteration](/rest/api/customvision/delete-iteration) |
+| Projects and project details | [GetProject](/rest/api/customvision/get-project) and [GetProjects](/rest/api/customvision/get-projects) | [DeleteProject](/rest/api/customvision/delete-project) | 
+| Image tags | [GetTag](/rest/api/customvision/get-tag) and [GetTags](/rest/api/customvision/get-tags) | [DeleteTag](/rest/api/customvision/delete-tag) | 
+| Images | [GetTaggedImages](/rest/api/customvision/get-tagged-images) (provides uri for image download) and [GetUntaggedImages](/rest/api/customvision/get-untagged-images) (provides uri for image download) | [DeleteImages](/rest/api/customvision/delete-images) | 
+| Exported iterations | [GetExports](/rest/api/customvision/get-exports) | Deleted upon account deletion |

articles/ai-services/custom-vision-service/export-delete-data.md

@@ -78,7 +78,7 @@ sections:
       - question: | 
           Can training images be exported with the tags that were added in the Custom Vision portal?
         answer: |
-          Yes, you can use the [GetImages API](/rest/api/customvision/training/images/list?view=rest-customvision-training-v3.3&tabs=HTTP) to export with tags.
+          Yes, you can use the [GetImages API](/rest/api/customvision/get-images) to export with tags.
 
       - question: |
           How can I write logs on this service?

articles/ai-services/custom-vision-service/faq.yml

@@ -42,7 +42,7 @@ Copy the command to a text editor and make the following changes:
 * Replace `{endpoint}` with the endpoint that corresponds to your key.
    [!INCLUDE [subdomains-note](../../../includes/cognitive-services-custom-subdomains-note.md)]
 * Replace `{name}` with the name of your project.
-* Optionally set other URL parameters to configure what type of model your project will use. See the [CreatProject API](/rest/api/customvision/training/projects/create?view=rest-customvision-training-v3.3&tabs=HTTP) for options.
+* Optionally set other URL parameters to configure what type of model your project will use. See the [CreatProject API](/rest/api/customvision/create-project) for options.
 
 You'll receive a JSON response like the following. Save the `"id"` value of your project to a temporary location.
 
@@ -99,7 +99,7 @@ You'll get a JSON response like the following. Save the `"id"` value of each tag
 
 Next, download the sample images for this project. Save the contents of the [sample Images folder](https://github.com/Azure-Samples/cognitive-services-sample-data-files/tree/master/CustomVision/ImageClassification/Images) to your local device.
 
-Use the following command to upload the images and apply tags; once for the "Hemlock" images, and separately for the "Japanese Cherry" images. See the [Create Images From Data](/rest/api/customvision/training/images/create-from-data?view=rest-customvision-training-v3.3&tabs=HTTP) API for more options.
+Use the following command to upload the images and apply tags; once for the "Hemlock" images, and separately for the "Japanese Cherry" images. See the [Create Images From Data](/rest/api/customvision/create-images-from-data) API for more options.
 
 :::code language="shell" source="~/cognitive-services-quickstart-code/curl/custom-vision/image-classifier.sh" ID="uploadimages":::
 
@@ -118,7 +118,7 @@ This method trains the model on the tagged images you've uploaded and returns an
 * Replace `{projectId}` with your own project ID.
 * Replace `{tagArray}` with the ID of a tag.
 * Then, populate the body of the request with the binary data of the images you want to tag.
-* Optionally use other URL parameters. See the [Train Project](/rest/api/customvision/training/projects/train?view=rest-customvision-training-v3.3&tabs=HTTP) API for options.
+* Optionally use other URL parameters. See the [Train Project](/rest/api/customvision/train-project) API for options.
 
 > [!TIP]
 > Train with selected tags
@@ -168,7 +168,7 @@ This method makes the current iteration of the model available for querying. You
 * Replace `{iterationId}` with the ID returned in the previous step.
 * Replace `{publishedName}` with the name you'd like to assign to your prediction model.
 * Replace `{predictionId}` with your own prediction resource ID. You can find the prediction resource ID on the resource's **Properties** tab in the Azure portal, listed as **Resource ID**.
-* Optionally use other URL parameters. See the [Publish Iteration](/rest/api/customvision/training/iterations/publish?view=rest-customvision-training-v3.3&tabs=HTTP) API.
+* Optionally use other URL parameters. See the [Publish Iteration](/rest/api/customvision/publish-iteration) API.
 
 ## Test the prediction endpoint
 
@@ -180,7 +180,7 @@ Finally, use this command to test your trained model by uploading a new image fo
 * Replace `{projectId}` with your own project ID.
 * Replace `{publishedName}` with the name you used in the previous step.
 * Add the binary data of your local image to the request body.
-* Optionally use other URL parameters. See the [Classify Image](/rest/api/customvision/training/train-project/train-project) API.
+* Optionally use other URL parameters. See the [Classify Image](/rest/api/customvision/train-project/train-project) API.
 
 The returned JSON response will list each of the tags that the model applied to your image, along with probability scores for each tag. 
 

articles/ai-services/custom-vision-service/includes/quickstarts/rest-tutorial.md

@@ -28,8 +28,8 @@ There are two tiers of keys for the Custom Vision service. You can sign up for a
 |How long prediction images stored|30 days|30 days|
 |[Prediction](/rest/api/customvision/predictions) operations with storage (Transactions Per Second)|2|10|
 |[Prediction](/rest/api/customvision/predictions) operations without storage (Transactions Per Second)|2|20|
-|[TrainProject](https://go.microsoft.com/fwlink/?linkid=865446) (API calls Per Second)|2|10|
-|[Other API calls](https://go.microsoft.com/fwlink/?linkid=865446) (Transactions Per Second)|10|10|
+|[TrainProject](/rest/api/customvision/train-project/train-project) (API calls Per Second)|2|10|
+|[Other API calls](/rest/api/custom-vision) (Transactions Per Second)|10|10|
 |Accepted image types|jpg, png, bmp, gif|jpg, png, bmp, gif|
 |Min image height/width in pixels|256 (see note)|256 (see note)|
 |Max image height/width in pixels|10,240|10,240|

articles/ai-services/custom-vision-service/limits-and-quotas.md

@@ -15,7 +15,7 @@ ms.author: pafarley
 
 This guide shows you how to select a domain for your project in the Custom Vision Service.
 
-From the **settings** tab of your project on the Custom Vision web portal, you can select a model domain for your project. You'll want to choose the domain that's closest to your use case scenario. If you're accessing Custom Vision through a client library or REST API, you'll need to specify a domain ID when creating the project. You can get a list of domain IDs with [Get Domains](/rest/api/customvision/training/domains/list?view=rest-customvision-training-v3.3&tabs=HTTP). Or, use the table below.
+From the **settings** tab of your project on the Custom Vision web portal, you can select a model domain for your project. You'll want to choose the domain that's closest to your use case scenario. If you're accessing Custom Vision through a client library or REST API, you'll need to specify a domain ID when creating the project. You can get a list of domain IDs with [Get Domains](/rest/api/customvision/get-domains). Or, use the table below.
 
 ## Image Classification domains
 

articles/ai-services/custom-vision-service/select-domain.md

@@ -61,7 +61,7 @@ Now that you have the integration URLs, you can create a new Custom Vision proje
 
 #### [Create a new project](#tab/create)
 
-When you call the [CreateProject](/rest/api/customvision/training/projects/create?view=rest-customvision-training-v3.3&tabs=HTTP) API, add the optional parameters _exportModelContainerUri_ and _notificationQueueUri_. Assign the URL values you got in the previous section. 
+When you call the [CreateProject](/rest/api/customvision/create-project) API, add the optional parameters _exportModelContainerUri_ and _notificationQueueUri_. Assign the URL values you got in the previous section. 
 
 ```curl
 curl -v -X POST "{endpoint}/customvision/v3.3/Training/projects?exportModelContainerUri={inputUri}&notificationQueueUri={inputUri}&name={inputName}"
@@ -99,7 +99,7 @@ If you receive a `200/OK` response, that means the URLs have been set up success
 
 #### [Update an existing project](#tab/update)
 
-To update an existing project with Azure storage feature integration, call the [UpdateProject](/rest/api/customvision/training/projects/update?view=rest-customvision-training-v3.3&tabs=HTTP) API, using the ID of the project you want to update. 
+To update an existing project with Azure storage feature integration, call the [UpdateProject](/rest/api/customvision/update-project) API, using the ID of the project you want to update. 
 
 ```curl
 curl -v -X PATCH "{endpoint}/customvision/v3.3/Training/projects/{projectId}"
@@ -157,7 +157,7 @@ In your notification queue, you should see a test notification in the following
 
 ## Get event notifications
 
-When you're ready, call the [TrainProject](/rest/api/customvision/training/projects/train?view=rest-customvision-training-v3.3&tabs=HTTP) API on your project to do an ordinary training operation.
+When you're ready, call the [TrainProject](/rest/api/customvision/train-project) API on your project to do an ordinary training operation.
 
 In your Storage notification queue, you'll receive a notification once training finishes:
 
@@ -178,7 +178,7 @@ The `"trainingStatus"` field may be either `"TrainingCompleted"` or `"TrainingFa
 
 ## Get model export backups
 
-When you're ready, call the [ExportIteration](/rest/api/customvision/training/iterations/export?view=rest-customvision-training-v3.3&tabs=HTTP) API to export a trained model into a specified platform.
+When you're ready, call the [ExportIteration](/rest/api/customvision/export-iteration) API to export a trained model into a specified platform.
 
 In your designated storage container, a backup copy of the exported model will appear. The blob name will have the format:
 
@@ -207,5 +207,5 @@ The `"exportStatus"` field may be either `"ExportCompleted"` or `"ExportFailed"`
 ## Next steps
 
 In this guide, you learned how to copy and back up a project between Custom Vision resources. Next, explore the API reference docs to see what else you can do with Custom Vision.
-* [REST API reference documentation (training)](/rest/api/customvision/training/operation-groups?view=rest-customvision-training-v3.3)
+* [REST API reference documentation (training)](/rest/api/customvision/train-project)
 * [REST API reference documentation (prediction)](/rest/api/customvision/predictions)

articles/ai-services/custom-vision-service/storage-integration.md

@@ -5,8 +5,6 @@ description: Extract print and handwritten text from scanned and digital documen
 author: laujan
 manager: nitinme
 ms.service: azure-ai-document-intelligence
-ms.custom:
-  - ignite-2023
 ms.topic: conceptual
 ms.date: 08/07/2024
 ms.author: lajanuar
@@ -122,7 +120,7 @@ The searchable PDF capability enables you to convert an analog PDF, such as scan
   > [!IMPORTANT]
   >
   > * Currently, the searchable PDF capability is only supported by Read OCR model `prebuilt-read`. When using this feature, please specify the `modelId` as `prebuilt-read`, as other model types will return error for this preview version.
-  > * Searchable PDF is included with the 2024-07-31-preview `prebuilt-read` model with no usage cost for general PDF consumption.
+  > * Searchable PDF is included with the 2024-07-31-preview `prebuilt-read` model with no additional cost for generating a searchable PDF output.
 
 ### Use searchable PDF
 
@@ -135,7 +133,7 @@ POST /documentModels/prebuilt-read:analyze?output=pdf
 202
 ```
 
-Once the `Analyze` operation is complete, make a `GET` request to retrieve the `Analyze` operation results.
+Poll for completion of the `Analyze` operation. Once the operation is complete, issue a `GET` request to retrieve the PDF format of the `Analyze` operation results.
 
 Upon successful completion, the PDF can be retrieved and downloaded as `application/pdf`. This operation allows direct downloading of the embedded text form of PDF instead of Base64-encoded JSON.