Merge pull request #2046 from soophiac/sophiac/update-aiservicesbykey

Update documentation with AIServicesByKey

Author: prmerger-automator[bot]

articles/search/cognitive-search-attach-cognitive-services.md

@@ -110,7 +110,9 @@ POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-ver
 
 Azure AI Search can also charge for transaction using the Azure AI multi-service resource key. This approach is the default and is generally available. You can use the Azure portal, REST API, or an Azure SDK to add the key to a skillset.
 
-You only need to add the key, not the subdomain or endpoint. If you leave the `cognitiveServices` property unspecified, your search service attempts to use the free enrichments available to your indexer on a daily basis. Execution of billable skills stops at 20 transactions per indexer invocation and a "Time Out" message appears in indexer execution history.
+There are two supported key types: `#Microsoft.Azure.Search.CognitiveServicesByKey` which calls the regional endpoint and `"#Microsoft.Azure.Search.AIServicesByKey` which calls the subdomain. We recommend using `AIServicesByKey` for its shared private link support and ability to function with no regional requirements relative to the search service.
+
+If you leave the `cognitiveServices` property unspecified, your search service attempts to use the free enrichments available to your indexer on a daily basis. Execution of billable skills stops at 20 transactions per indexer invocation and a "Time Out" message appears in indexer execution history.
 
 ### [**Azure portal**](#tab/portal)
 
@@ -128,12 +130,15 @@ You only need to add the key, not the subdomain or endpoint. If you leave the `c
 
   :::image type="content" source="media/cognitive-search-attach-cognitive-services/attach-existing2.png" alt-text="Screenshot of the key page." border="true":::
 
+> [!NOTE]
+> Azure portal currently automatically attaches key of type `#Microsoft.Azure.Search.CognitiveServicesByKey`.
+
 ### [**REST**](#tab/cogkey-rest)
 
 1. Use the [Create or Update Skillset](/rest/api/searchservice/skillsets/create-or-update) API, specifying `cognitiveServices` section in the body of the request:
 
 ```http
-PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-01
+PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-11-01-Preview
 api-key: [admin key]
 Content-Type: application/json
 {
@@ -157,8 +162,9 @@ Content-Type: application/json
       }
     ],
     "cognitiveServices": {
-        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
+        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
         "description": "mycogsvcs",
+        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",
         "key": "<your key goes here>"
     }
 }