Merge pull request #279466 from HeidiSteen/heidist-june24

REST API links - create skillset

Author: prmerger-automator[bot]

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

@@ -15,7 +15,7 @@ ms.date: 01/11/2024
 
 When configuring an optional [AI enrichment pipeline](cognitive-search-concept-intro.md) in Azure AI Search, you can enrich a limited number of documents free of charge. For larger and more frequent workloads, you should attach a billable [**Azure AI multi-service resource**](../ai-services/multi-service-resource.md?pivots=azportal). 
 
-A multi-service resource references a set of Azure AI services as the offering, rather than individual services, with access granted through a single API key. This key is specified in a [**skillset**](/rest/api/searchservice/create-skillset) and allows Microsoft to charge you for using these services:
+A multi-service resource references a set of Azure AI services as the offering, rather than individual services, with access granted through a single API key. This key is specified in a [**skillset**](/rest/api/searchservice/skillsets/create) and allows Microsoft to charge you for using these services:
 
 + [Azure AI Vision](../ai-services/computer-vision/overview.md) for image analysis and optical character recognition (OCR)
 + [Azure AI Language](../ai-services/language-service/overview.md) for language detection, entity recognition, sentiment analysis, and key phrase extraction
@@ -49,7 +49,7 @@ If you leave the property unspecified, your search service attempts to use the f
 
 1. Create an [Azure AI multi-service resource](../ai-services/multi-service-resource.md?pivots=azportal) in the [same region](#same-region-requirement) as your search service.
 
-1. Create or update a skillset, specifying `cognitiveServices` section in the body of the [skillset request](/rest/api/searchservice/create-skillset):
+1. Create or update a skillset, specifying `cognitiveServices` section in the body of the [skillset request](/rest/api/searchservice/skillsets/create):
 
 ```http
 PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2023-11-01
@@ -242,5 +242,5 @@ Putting it all together, you'd pay about $57.00 to ingest 1,000 PDF documents of
 
 + [Azure AI Search pricing page](https://azure.microsoft.com/pricing/details/search/)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Create Skillset (REST)](/rest/api/searchservice/create-skillset)
++ [Create Skillset (REST)](/rest/api/searchservice/skillsets/create)
 + [How to map enriched fields](cognitive-search-output-field-mapping.md)

articles/search/cognitive-search-concept-annotations-syntax.md

@@ -154,5 +154,5 @@ If you're having trouble with specifying skill inputs, these tips might help you
 + [Skill context and input annotation language](cognitive-search-skill-annotation-language.md)
 + [How to integrate a custom skill into an enrichment pipeline](cognitive-search-custom-skill-interface.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Create Skillset (REST)](/rest/api/searchservice/create-skillset)
++ [Create Skillset (REST)](/rest/api/searchservice/skillsets/create)
 + [How to map enriched fields to an index](cognitive-search-output-field-mapping.md)

articles/search/cognitive-search-concept-image-scenarios.md

@@ -147,7 +147,7 @@ When `imageAction` is set to a value other than "none", the new *normalized_imag
 
 This section supplements the [skill reference](cognitive-search-predefined-skills.md) articles by providing context for working with skill inputs, outputs, and patterns, as they relate to image processing.
 
-1. [Create or update a skillset](/rest/api/searchservice/create-skillset) to add skills.
+1. [Create or update a skillset](/rest/api/searchservice/skillsets/create) to add skills.
 
 1. Add templates for OCR and Image Analysis from the portal, or copy the definitions from the [skill reference](cognitive-search-predefined-skills.md) documentation. Insert them into the skills array of your skillset definition.
 

articles/search/cognitive-search-create-custom-skill-example.md

@@ -474,5 +474,5 @@ Congratulations! You've created your first custom skill. Now you can follow the
 + [Power Skills: a repository of custom skills](https://github.com/Azure-Samples/azure-search-power-skills)
 + [Add a custom skill to an AI enrichment pipeline](cognitive-search-custom-skill-interface.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Create Skillset (REST)](/rest/api/searchservice/create-skillset)
++ [Create Skillset (REST)](/rest/api/searchservice/skillsets/create)
 + [How to map enriched fields](cognitive-search-output-field-mapping.md)

articles/search/cognitive-search-custom-skill-interface.md

@@ -172,5 +172,5 @@ This article covered the interface requirements necessary for integrating a cust
 + [Power Skills: a repository of custom skills](https://github.com/Azure-Samples/azure-search-power-skills)
 + [Example: Creating a custom skill for AI enrichment](cognitive-search-create-custom-skill-example.md)
 + [How to define a skillset](cognitive-search-defining-skillset.md)
-+ [Create Skillset (REST)](/rest/api/searchservice/create-skillset)
++ [Create Skillset (REST)](/rest/api/searchservice/skillsets/create)
 + [How to map enriched fields](cognitive-search-output-field-mapping.md)

articles/search/cognitive-search-defining-skillset.md

@@ -17,7 +17,7 @@ ms.date: 01/10/2024
 
 A skillset defines operations that generate textual content and structure from documents that contain images or unstructured text. Examples are OCR for images, entity recognition for undifferentiated text, and text translation. A skillset executes after text and images are extracted from an external data source, and after [field mappings](search-indexer-field-mappings.md) are processed.
 
-This article explains how to create a skillset using [REST APIs](/rest/api/searchservice/create-skillset), but the same concepts and steps apply to other programming languages. 
+This article explains how to create a skillset using [REST APIs](/rest/api/searchservice/skillsets/create), but the same concepts and steps apply to other programming languages. 
 
 Rules for skillset definition include:
 
@@ -33,7 +33,7 @@ Indexers drive skillset execution. You need an [indexer](search-howto-create-ind
 
 ## Add a skillset definition
 
-Start with the basic structure. In the [Create Skillset REST API](/rest/api/searchservice/create-skillset), the body of the request is authored in JSON and has the following sections:
+Start with the basic structure. In the [Create Skillset REST API](/rest/api/searchservice/skillsets/create), the body of the request is authored in JSON and has the following sections:
 
 ```json
 {

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

@@ -124,7 +124,7 @@ POST {{baseUrl}}/datasources?api-version=2023-11-01  HTTP/1.1
 
 ### Step 2: Create a skillset
 
-Call [Create Skillset](/rest/api/searchservice/create-skillset) to specify which enrichment steps are applied to your content. Skills execute in parallel unless there's a dependency.
+Call [Create Skillset](/rest/api/searchservice/skillsets/create) to specify which enrichment steps are applied to your content. Skills execute in parallel unless there's a dependency.
 
 ```http
 ### Create a skillset

articles/search/knowledge-store-projection-overview.md

@@ -35,7 +35,7 @@ A knowledge store is a logical construction that's physically expressed as a loo
 
 ## Projection definition
 
-Projections are specified under the "knowledgeStore" property of a [skillset](/rest/api/searchservice/create-skillset). Projection definitions are used during indexer invocation to create and load objects in Azure Storage with enriched content. If you're unfamiliar with these concepts, start with [AI enrichment](cognitive-search-concept-intro.md) for an introduction.
+Projections are specified under the "knowledgeStore" property of a [skillset](/rest/api/searchservice/skillsets/create). Projection definitions are used during indexer invocation to create and load objects in Azure Storage with enriched content. If you're unfamiliar with these concepts, start with [AI enrichment](cognitive-search-concept-intro.md) for an introduction.
 
 The following example illustrates the placement of projections under knowledgeStore, and the basic construction. The name, type, and content source make up a projection definition.
 

articles/search/search-import-data-portal.md

@@ -38,7 +38,7 @@ The wizard will output the objects in the following table. After the objects are
 | [Indexer](/rest/api/searchservice/create-indexer)  | A configuration object specifying a data source, target index, an optional skillset, optional schedule, and optional configuration settings for error handing and base-64 encoding. |
 | [Data Source](/rest/api/searchservice/create-data-source)  | Persists connection information to a [supported data source](search-indexer-overview.md#supported-data-sources) on Azure. A data source object is used exclusively with indexers. | 
 | [Index](/rest/api/searchservice/create-index) | Physical data structure used for full text search and other queries. | 
-| [Skillset](/rest/api/searchservice/create-skillset) | Optional. A complete set of instructions for manipulating, transforming, and shaping content, including analyzing and extracting information from image files. Unless the volume of work fall under the limit of 20 transactions per indexer per day, the skillset must include a reference to an Azure AI multi-service resource that provides enrichment. | 
+| [Skillset](/rest/api/searchservice/skillsets/create) | Optional. A complete set of instructions for manipulating, transforming, and shaping content, including analyzing and extracting information from image files. Unless the volume of work fall under the limit of 20 transactions per indexer per day, the skillset must include a reference to an Azure AI multi-service resource that provides enrichment. | 
 | [Knowledge store](knowledge-store-concept-intro.md) | Optional. Stores output from an [AI enrichment pipeline](cognitive-search-concept-intro.md) in tables and blobs in Azure Storage for independent analysis or downstream processing. |
 
 ## Benefits and limitations