Merge pull request #7335 from HeidiSteen/heidist-0901

Bulk API version update

Author: prmerger-automator[bot]

articles/search/includes/quickstarts/full-text-powershell.md

@@ -92,7 +92,7 @@ To connect to your search service:
 1. Create a `$url` object that targets the indexes collection on your search service. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
 
     ```powershell
-    $url = "<YOUR-SEARCH-SERVICE>/indexes?api-version=2024-07-01&`$select=name"
+    $url = "<YOUR-SEARCH-SERVICE>/indexes?api-version=@search.rerankerBoostedScore&`$select=name"
     ```
 
 1. Run `Invoke-RestMethod` to send a GET request to your search service. Include `ConvertTo-Json` to view responses from the service.
@@ -152,7 +152,7 @@ To create an index:
 2. Update the `$url` object to target the new index. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
 
     ```powershell
-    $url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart?api-version=2024-07-01"
+    $url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart?api-version=@search.rerankerBoostedScore"
     ```
 
 3. Run `Invoke-RestMethod` to create the index on your search service.
@@ -275,7 +275,7 @@ To upload documents to your index:
 2. Update the `$url` object to target the indexing endpoint. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
 
     ```powershell
-    $url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs/index?api-version=2024-07-01"
+    $url = "<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs/index?api-version=@search.rerankerBoostedScore"
     ```
 
 3. Run `Invoke-RestMethod` to send the upload request to your search service.
@@ -301,7 +301,7 @@ To run a full-text query against your index:
 1. Update the `$url` object to specify search parameters. Replace `<YOUR-SEARCH-SERVICE>` with the value you obtained in [Get endpoint](#get-endpoint).
 
     ```powershell
-    $url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=attached restaurant&searchFields=Description,Tags&$select=HotelId,HotelName,Tags,Description&$count=true'
+    $url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=attached restaurant&searchFields=Description,Tags&$select=HotelId,HotelName,Tags,Description&$count=true'
     ```
 
 2. Run `Invoke-RestMethod` to send the query request to your search service.
@@ -344,20 +344,20 @@ Run the following commands to explore the query syntax. You can perform string s
 # Query example 1
 # Search the index for the terms 'restaurant' and 'wifi'
 # Return only the HotelName, Description, and Tags fields
-$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=restaurant wifi&$count=true&$select=HotelName,Description,Tags'
+$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=restaurant wifi&$count=true&$select=HotelName,Description,Tags'
 
 # Query example 2 
 # Use a filter to find hotels rated 4 or higher
 # Return only the HotelName and Rating fields
-$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=*&$filter=Rating gt 4&$select=HotelName,Rating'
+$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=*&$filter=Rating gt 4&$select=HotelName,Rating'
 
 # Query example 3
 # Take the top two results
 # Return only the HotelName and Category fields
-$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=boutique&$top=2&$select=HotelName,Category'
+$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=boutique&$top=2&$select=HotelName,Category'
 
 # Query example 4
 # Sort by a specific field (Address/City) in ascending order
 # Return only the HotelName, Address/City, Tags, and Rating fields
-$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=2024-07-01&search=pool&$orderby=Address/City asc&$select=HotelName, Address/City, Tags, Rating'
+$url = '<YOUR-SEARCH-SERVICE>/indexes/hotels-quickstart/docs?api-version=@search.rerankerBoostedScore&search=pool&$orderby=Address/City asc&$select=HotelName, Address/City, Tags, Rating'
 ```

articles/search/includes/quickstarts/full-text-rest.md

@@ -89,7 +89,7 @@ To set up your request file:
     @token = PUT-YOUR-PERSONAL-IDENTITY-TOKEN-HERE
 
     ### List existing indexes by name
-    GET {{baseUrl}}/indexes?api-version=2024-07-01  HTTP/1.1
+    GET {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Authorization: Bearer {{token}}
     ```
 
@@ -111,7 +111,7 @@ To create an index:
 
     ```http
     ### Create a new index
-    POST {{baseUrl}}/indexes?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
     
@@ -169,7 +169,7 @@ To upload documents to your index:
 
     ```http
     ### Upload documents
-    POST {{baseUrl}}/indexes/hotels-quickstart/docs/index?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-quickstart/docs/index?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
     
@@ -275,7 +275,7 @@ To run a full-text query against your index:
 
     ```http
     ### Run a query
-    POST {{baseUrl}}/indexes/hotels-quickstart/docs/search?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-quickstart/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
       Content-Type: application/json
       Authorization: Bearer {{token}}
     

articles/search/includes/quickstarts/search-get-started-rbac-rest.md

@@ -75,7 +75,7 @@ To connect using REST:
    @token = PUT-YOUR-PERSONAL-IDENTITY-TOKEN-HERE
 
    ### List existing indexes
-   GET {{baseUrl}}/indexes?api-version=2024-07-01  HTTP/1.1
+   GET {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore  HTTP/1.1
       Content-Type: application/json
       Authorization: Bearer {{token}}
    ```

articles/search/includes/quickstarts/search-get-started-vector-rest.md

@@ -109,7 +109,7 @@ The index schema in this example is organized around hotel content. Sample data
 
     ```http
     ### Create a new index
-    POST  {{baseUrl}}/indexes?api-version=2024-07-01  HTTP/1.1
+    POST  {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore  HTTP/1.1
     Content-Type: application/json
     Authorization: Bearer {{token}}
 
@@ -402,7 +402,7 @@ In Azure AI Search, the index contains all searchable data and queries run on th
 
     ```http
     ### Upload documents
-    POST {{baseUrl}}/indexes/hotels-quickstart-vectors/docs/index?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-quickstart-vectors/docs/index?api-version=@search.rerankerBoostedScore  HTTP/1.1
     Content-Type: application/json
     Authorization: Bearer {{token}}
 
@@ -673,7 +673,7 @@ The vector query string is semantically similar to the search string, but it inc
 
     ```http
     ### Run a single vector query
-    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
         
@@ -784,7 +784,7 @@ You can add filters, but the filters are applied to the nonvector content in you
 
     ```http
     ### Run a vector query with a filter
-    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
     
@@ -847,7 +847,7 @@ You can add filters, but the filters are applied to the nonvector content in you
 
     ```http
     ### Run a vector query with a geo filter
-    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
     
@@ -917,7 +917,7 @@ Hybrid search consists of keyword queries and vector queries in a single search
 
     ```http
     ### Run a hybrid query
-    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
         
@@ -1033,7 +1033,7 @@ Here's the last query in the collection. This hybrid query adds L2 semantic rank
 
     ```http
     ### Run a hybrid query with semantic reranking
-    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01  HTTP/1.1
+    POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
         Content-Type: application/json
         Authorization: Bearer {{token}}
 
@@ -1127,7 +1127,7 @@ If you want to keep the search service, but delete the index and documents, you
 
 ```http
 ### Delete an index
-DELETE  {{baseUrl}}/indexes/hotels-vector-quickstart?api-version=2024-07-01 HTTP/1.1
+DELETE  {{baseUrl}}/indexes/hotels-vector-quickstart?api-version=@search.rerankerBoostedScore HTTP/1.1
     Content-Type: application/json
     Authorization: Bearer {{token}}
 ```

articles/search/includes/tutorials/skillset-rest.md

@@ -97,7 +97,7 @@ Call [Create Data Source](/rest/api/searchservice/data-sources/create) to set th
 
 ```http
 ### Create a data source
-POST {{baseUrl}}/datasources?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/datasources?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
 
@@ -124,7 +124,7 @@ Call [Create Skillset](/rest/api/searchservice/skillsets/create) to specify whic
 
 ```http
 ### Create a skillset
-POST {{baseUrl}}/skillsets?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/skillsets?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
 
@@ -313,7 +313,7 @@ The largest component of an index is the fields collection, where data type and
 
 ```http
 ### Create an index
-POST {{baseUrl}}/indexes?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/indexes?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
 
@@ -406,7 +406,7 @@ Expect this step to take several minutes to complete. Even though the data set i
 
 ```http
 ### Create and run an indexer
-POST {{baseUrl}}/indexers?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/indexers?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
 
@@ -497,7 +497,7 @@ To find out whether the indexer is still running, call [Get Indexer Status](/res
 
 ```http
 ### Get Indexer Status (wait several minutes for the indexer to complete)
-GET {{baseUrl}}/indexers/cog-search-demo-idxr/status?api-version=2024-07-01  HTTP/1.1
+GET {{baseUrl}}/indexers/cog-search-demo-idxr/status?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
 ```
@@ -514,7 +514,7 @@ Now that you've created an index that contains AI-generated content, call [Searc
 
 ```http
 ### Query the index\
-POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
   
@@ -529,7 +529,7 @@ Filters can help you narrow results to items of interest:
 
 ```http
 ### Filter by organization
-POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/indexes/cog-search-demo-idx/docs/search?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
   

articles/search/search-howto-managed-identities-storage.md

@@ -74,7 +74,7 @@ For connections made using a system-assigned managed identity, the only change t
 Provide a connection string that contains a `ResourceId`, with no account key or password. The `ResourceId` must include the subscription ID of the storage account, the resource group of the storage account, and the storage account name.
 
 ```http
-POST https://[service name].search.windows.net/datasources?api-version=2024-07-01
+POST https://[service name].search.windows.net/datasources?api-version=@search.rerankerBoostedScore
 
 {
     "name" : "blob-datasource",

articles/search/search-howto-powerapps.md

@@ -74,7 +74,7 @@ A connector in Power Apps is a data source connection. In this step, create a cu
    * For the URL, enter a sample query for your search index (`search=*` returns all documents, `$select=` lets you choose fields). The API version is required. Fully specified, a URL might look like the following example. Notice that the `https://` prefix is omitted.
 
      ```http
-     mydemo.search.windows.net/indexes/hotels-sample-index/docs?search=*&$select=HotelName,Description,Address/City&api-version=2024-07-01
+     mydemo.search.windows.net/indexes/hotels-sample-index/docs?search=*&$select=HotelName,Description,Address/City&api-version=@search.rerankerBoostedScore
      ```
 
    * For Headers, type `Content-Type application/json`.
@@ -95,7 +95,7 @@ A connector in Power Apps is a data source connection. In this step, create a cu
 
     :::image type="content" source="./media/search-howto-powerapps/1-10-4-parameter-metadata-select.png" alt-text="Select parameter metadata" border="true":::
 
-1. For *api-version*: Set `2024-07-01` as the **default value**, set **required** to *True*, and set **visibility** as *internal*.  
+1. For *api-version*: Set `@search.rerankerBoostedScore` as the **default value**, set **required** to *True*, and set **visibility** as *internal*.  
 
     :::image type="content" source="./media/search-howto-powerapps/1-10-2-parameter-metadata-version.png" alt-text="Version parameter metadata" border="true":::
 
@@ -107,7 +107,7 @@ A connector in Power Apps is a data source connection. In this step, create a cu
     parameters:
       - {name: search, in: query, required: false, type: string, default: '*'}
       - {name: $select, in: query, required: false, type: string, default: 'HotelName,Description,Address/City'}
-      - {name: api-version, in: query, required: true, type: string, default: '2024-07-01',
+      - {name: api-version, in: query, required: true, type: string, default: '@search.rerankerBoostedScore',
         x-ms-visibility: internal}
       - {name: Content-Type, in: header, required: false, type: string}
     ```

articles/search/search-howto-reindex.md

@@ -161,12 +161,12 @@ Here's a [REST API example](search-get-started-text.md) demonstrating these tips
 
 ```rest
 ### Get Stay-Kay City Hotel by ID
-GET  {{baseUrl}}/indexes/hotels-vector-quickstart/docs('1')?api-version=2024-07-01  HTTP/1.1
+GET  {{baseUrl}}/indexes/hotels-vector-quickstart/docs('1')?api-version=@search.rerankerBoostedScore  HTTP/1.1
     Content-Type: application/json
     api-key: {{apiKey}}
 
 ### Change the description, city, and tags for Stay-Kay City Hotel
-POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search.index?api-version=2024-07-01  HTTP/1.1
+POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search.index?api-version=@search.rerankerBoostedScore  HTTP/1.1
   Content-Type: application/json
   api-key: {{apiKey}}
 
@@ -185,7 +185,7 @@ POST {{baseUrl}}/indexes/hotels-vector-quickstart/docs/search.index?api-version=
     }
        
 ### Retrieve the same document, confirm the overwrites and retention of all other values
-GET  {{baseUrl}}/indexes/hotels-vector-quickstart/docs('1')?api-version=2024-07-01  HTTP/1.1
+GET  {{baseUrl}}/indexes/hotels-vector-quickstart/docs('1')?api-version=@search.rerankerBoostedScore  HTTP/1.1
     Content-Type: application/json
     api-key: {{apiKey}}
 ```
@@ -329,17 +329,17 @@ Deleting a document doesn't immediately free up space in the index. Every few mi
 1. [Look up the document](/rest/api/searchservice/documents/get) to verify the value of the document ID and to review its content before deleting it. Specify the key or document ID in the request. The following examples illustrate a simple string for the [Hotels sample index](search-get-started-portal.md) and a base-64 encoded string for the metadata_storage_path key of the [cog-search-demo index](tutorial-skillset.md).
 
     ```http
-    GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2024-07-01
+    GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=@search.rerankerBoostedScore
     ```
 
     ```http
-    GET https://[service name].search.windows.net/indexes/cog-search-demo/docs/aHR0cHM6Ly9oZWlkaWJsb2JzdG9yYWdlMi5ibG9iLmNvcmUud2luZG93cy5uZXQvY29nLXNlYXJjaC1kZW1vL2d1dGhyaWUuanBn0?api-version=2024-07-01
+    GET https://[service name].search.windows.net/indexes/cog-search-demo/docs/aHR0cHM6Ly9oZWlkaWJsb2JzdG9yYWdlMi5ibG9iLmNvcmUud2luZG93cy5uZXQvY29nLXNlYXJjaC1kZW1vL2d1dGhyaWUuanBn0?api-version=@search.rerankerBoostedScore
     ```
 
 1. [Delete the document](/rest/api/searchservice/documents) using a delete `@search.action` to remove it from the search index.
 
     ```http
-    POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2024-07-01
+    POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=@search.rerankerBoostedScore
     Content-Type: application/json   
     api-key: [admin key] 
     {  

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

@@ -71,7 +71,7 @@ Switch to the **Indexer Definition (JSON)** tab at the top of the index to view
 1. Set the schedule property in the body of the request:
 
     ```http
-    PUT /indexers/<indexer-name>?api-version=2024-07-01
+    PUT /indexers/<indexer-name>?api-version=@search.rerankerBoostedScore
     {
         "dataSourceName" : "myazuresqldatasource",
         "targetIndexName" : "my-target-index-name",

articles/search/search-index-azure-sql-managed-instance-with-managed-identity.md

@@ -101,7 +101,7 @@ When you're connecting with a system-assigned managed identity, the only change
 Here's an example of how to create a data source to index data from a storage account using the [Create Data Source](/rest/api/searchservice/data-sources/create) REST API and a managed identity connection string. The managed identity connection string format is the same for the REST API, .NET SDK, and the Azure portal.  
 
 ```http
-POST https://[service name].search.windows.net/datasources?api-version=2024-07-01
+POST https://[service name].search.windows.net/datasources?api-version=@search.rerankerBoostedScore
 Content-Type: application/json
 api-key: [admin key]
 
@@ -124,7 +124,7 @@ The index specifies the fields in a document, attributes, and other constructs t
 Here's a [Create Index](/rest/api/searchservice/indexes/create) REST API call with a searchable `booktitle` field:
 
 ```http
-POST https://[service name].search.windows.net/indexes?api-version=2024-07-01
+POST https://[service name].search.windows.net/indexes?api-version=@search.rerankerBoostedScore
 Content-Type: application/json
 api-key: [admin key]
 
@@ -144,7 +144,7 @@ An indexer connects a data source with a target search index, and provides a sch
 Here's a [Create Indexer](/rest/api/searchservice/indexers/create) REST API call with an Azure SQL indexer definition. The indexer runs when you submit the request.
 
 ```http
-POST https://[service name].search.windows.net/indexers?api-version=2024-07-01
+POST https://[service name].search.windows.net/indexers?api-version=@search.rerankerBoostedScore
 Content-Type: application/json
 api-key: [admin key]