Merge pull request #268328 from HeidiSteen/heidist-fix

[SCOPED] [azure search] update debug session to use VS Code REST client + more postman link replacements

Author: denrea

articles/search/cognitive-search-tutorial-blob.md

@@ -127,7 +127,7 @@ All HTTP requests to a search service require an API key. A valid key establishe
 
 ## 2 - Set up Postman
 
-1. Start Postman, import the collection, and set up the environment variables. If you're unfamiliar with this tool, see [Explore Azure AI Search REST APIs](search-get-started-rest.md).
+1. Start Postman, import the collection, and set up the environment variables. If you're unfamiliar with this tool, see [Quickstart: Text search using REST](search-get-started-rest.md).
 
 1. You'll need to provide a search service name, an admin API key, an index name, a connection string to your Azure Storage account, and the container name.
 

articles/search/cognitive-search-tutorial-debug-sessions.md

@@ -19,15 +19,15 @@ Learn about the REST API samples that demonstrate the functionality and workflow
 
 REST is the definitive programming interface for Azure AI Search, and all operations that can be invoked programmatically are available first in REST, and then in SDKs. For this reason, most examples in the documentation use the REST APIs to demonstrate or explain important concepts.
 
-REST samples are usually developed and tested on the [Postman app](https://www.postman.com/downloads/), but you can use any client that supports HTTP calls. [Here's a quickstart](search-get-started-rest.md) that explains how to formulate the HTTP request from end-to-end in Postman.
+You can use any client that supports HTTP calls. [Here's a quickstart](search-get-started-rest.md) that explains how to formulate the HTTP request using Visual Studio Code with a REST client.
 
 ## Doc samples
 
 Code samples from the Azure AI Search team demonstrate features and workflows. Many of these samples are referenced in tutorials, quickstarts, and how-to articles. You can find these samples in [**Azure-Samples/azure-search-postman-samples**](https://github.com/Azure-Samples/azure-search-postman-samples) on GitHub.
 
 | Samples | Description |
 |---------|---------|
-| [Quickstart](https://github.com/Azure-Samples/azure-search-postman-samples/tree/main/Quickstart) | Source code for [Quickstart: Create a search index using REST APIs](search-get-started-rest.md). This sample  covers the basic workflow for creating, loading, and querying a search index using sample data. |
+| [Quickstart](https://github.com/Azure-Samples/azure-search-postman-samples/tree/main/Quickstart) | Source code for [Quickstart: Text search using REST](search-get-started-rest.md). This sample  covers the basic workflow for creating, loading, and querying a search index using sample data. |
 | [Quickstart-vectors](https://github.com/Azure-Samples/azure-search-postman-samples/tree/main/Quickstart-vectors) | Source code for [Quickstart: Vector search using REST APIs](search-get-started-vector.md). This sample  covers the basic workflow for indexing and querying vector data. |
 | [Tutorial](https://github.com/Azure-Samples/azure-search-postman-samples/tree/main/Tutorial) | Source code for [Tutorial: Use REST and AI to generate searchable content from Azure blobs](cognitive-search-tutorial-blob.md). This sample  shows you how to create a skillset that iterates over Azure blobs to extract information and infer structure.|
 | [Debug-sessions](https://github.com/Azure-Samples/azure-search-postman-samples/tree/main/Debug-sessions) | Source code for [Tutorial: Diagnose, repair, and commit changes to your skillset](cognitive-search-tutorial-debug-sessions.md). This sample  shows you how to use a skillset debug session in the Azure portal. REST is used to create the objects used during debug.|

articles/search/samples-rest.md

@@ -95,7 +95,7 @@ The following screenshot highlights where **Add index** and **Import data** appe
 
 ### [**REST**](#tab/index-rest)
 
-[**Create Index (REST API)**](/rest/api/searchservice/create-index) is used to create an index. The Postman app can function as a search index client to connect to your search service and send requests. See [Create a search index using REST and Postman](search-get-started-rest.md) to get started.
+[**Create Index (REST API)**](/rest/api/searchservice/create-index) is used to create an index. You need a REST client to connect to your search service and send requests. See [Quickstart: Text search using REST](search-get-started-rest.md) to get started.
 
 The REST API provides defaults for field attribution. For example, all `Edm.String` fields are searchable by default. Attributes are shown in full below for illustrative purposes, but you can omit attribution in cases where the default values apply.
 

articles/search/search-how-to-create-search-index.md

@@ -45,7 +45,7 @@ If indexers are already defined, you can [reset and run an indexer](search-howto
 
 [Documents - Index (REST)](/rest/api/searchservice/documents) is the means by which you can import data into a search index. The @search.action parameter determines whether documents are added in full, or partially in terms of new or replacement values for specific fields.
 
-[**REST Quickstart: Create, load, and query an index**](search-get-started-rest.md) explains the steps. The following example is a modified version of the example. It's been trimmed for brevity and the first HotelId value has been altered to avoid overwriting an existing document.
+[**Quickstart: Text search using REST**](search-get-started-rest.md) explains the steps. The following example is a modified version of the example. It's been trimmed for brevity and the first HotelId value has been altered to avoid overwriting an existing document.
 
 1. Formulate a POST call specifying the index name, the "docs/index" endpoint, and a request body that includes the @search.action parameter.
 

articles/search/search-how-to-load-search-index.md

@@ -188,7 +188,7 @@ POST /indexers?api-version=[api-version]
 }
 ```
 
-There are numerous tutorials and examples that demonstrate REST clients for creating objects. [Create a search index using REST](search-get-started-rest.md) can get you started.
+There are numerous tutorials and examples that demonstrate REST clients for creating objects. [Quickstart: Text search using REST](search-get-started-rest.md) can get you started.
 
 ### [**.NET SDK**](#tab/indexer-csharp)
 

articles/search/search-howto-create-indexers.md

@@ -67,4 +67,4 @@ GET /indexes/hotels-sample-index/docs?moreLikeThis=20&searchFields=Description&$
 You can use any REST client for this exercise.
 
 > [!div class="nextstepaction"]
-> [Quickstart: Azure AI Search using REST](search-get-started-rest.md)
+> [Quickstart: Text search using REST](search-get-started-rest.md)

articles/search/search-more-like-this.md

@@ -100,9 +100,7 @@ In the portal, when you open an index, you can work with Search Explorer alongsi
 
 ### [**REST API**](#tab/rest-text-query)
 
-[Postman app](https://www.postman.com/downloads/) is useful for working with the REST APIs, such as [Search Documents (REST)](/rest/api/searchservice/documents/search-post). 
-
-[Quickstart: Create a search index using REST and Postman](search-get-started-rest.md) has step-by-step instructions for setting up requests.
+Use a REST client to set up a request. [Quickstart: Text search using REST](search-get-started-rest.md) has instructions if you need help with getting started.
 
 The following example calls the REST API for full text search:
 

articles/search/search-query-create.md

@@ -33,7 +33,7 @@ In this article, learn how to invoke a semantic ranking over a result set, promo
 Choose a search client that supports semantic ranking. Here are some options:
 
 + [Azure portal](https://portal.azure.com), using the index designer to add a semantic configuration.
-+ [Postman app](https://www.postman.com/downloads/) using [REST APIs](/rest/api/searchservice/)
++ [Visual Studio Code](https://code.visualstudio.com/download) with a [REST client](https://marketplace.visualstudio.com/items?itemName=humao.rest-client)
 + [Azure SDK for .NET](https://www.nuget.org/packages/Azure.Search.Documents)
 + [Azure SDK for Python](https://pypi.org/project/azure-search-documents)
 + [Azure SDK for Java](https://central.sonatype.com/artifact/com.azure/azure-search-documents)

articles/search/semantic-how-to-query-request.md

@@ -56,7 +56,7 @@ For each request, you need to:
 
   :::image type="content" source="media/search-get-started-rest/postman-url.png" alt-text="Postman request URL and header" border="false":::
 
-If you're unfamiliar with Postman, see [Explore Azure AI Search REST APIs](search-get-started-rest.md).
+If you're unfamiliar with Postman, see [Quickstart: Text search using REST](search-get-started-rest.md).
 
 ## 3 - Create an initial index