Updated management content

haileytap · haileytap · commit 65348bf87a68 · 2025-07-03T14:25:01.000-04:00
diff --git a/articles/search/includes/how-tos/manage-index-portal.md b/articles/search/includes/how-tos/manage-index-portal.md
@@ -7,13 +7,13 @@ ms.topic: include
 ms.date: 07/03/2025
 ---
 
-After you [create an index](search-how-to-create-search-index.md), you can use the [Azure portal](https://portal.azure.com) to access its statistics and definition or remove it from your search service.
+After you [create an index](../../search-how-to-create-search-index.md), you can use the [Azure portal](https://portal.azure.com) to access its statistics and definition or remove it from your search service.
 
-This article describes how to manage an index without affecting its content. For guidance on modifying an index definition, see [Update or rebuild an index in Azure AI Search](search-howto-reindex.md).
+This article describes how to manage an index without affecting its content. For guidance on modifying an index definition, see [Update or rebuild an index in Azure AI Search](../../search-howto-reindex.md).
 
 ## Limitations
 
-The pricing tier of your search service determines the maximum number and size of your indexes, fields, and documents. For more information, see [Service limits in Azure AI Search](search-limits-quotas-capacity.md).
+The pricing tier of your search service determines the maximum number and size of your indexes, fields, and documents. For more information, see [Service limits in Azure AI Search](../../search-limits-quotas-capacity.md).
 
 Otherwise, the following limitations apply to index management:
 
@@ -37,10 +37,10 @@ To view all your indexes:
 
 On the index page, the portal provides the following statistics:
 
-+ **Documents**: Number of documents in the index.
-+ **Total storage**: Storage space used by the index.
-+ **Vector index quota usage**: Vector storage space used by the index.
-+ **Max storage**: Maximum storage space for each index in your search service, which depends on your pricing tier. This value doesn't represent the total storage currently available to the index.
++ The number of documents in the index.
++ The storage space used by the index.
++ The vector storage space used by the index.
++ The maximum storage space for each index on your search service, which [depends on your pricing tier](../../search-limits-quotas-capacity.md). This value doesn't represent the total storage currently available to the index.
 
 :::image type="content" source="../../media/search-how-to-manage-index/index-statistics.png" alt-text="Screenshot of the index statistics in the portal." border="true" lightbox="../../media/search-how-to-manage-index/index-statistics.png":::
 
@@ -54,7 +54,7 @@ On the index page, select **Edit JSON** to view its complete definition.
 
 <!--
 > [!NOTE]
-> The portal doesn't support synonym map definitions. You can use the portal to view existing synonyms, but you can't create them or assign them to fields. For more information, see [Add synonyms in Azure AI Search](search-synonym.md).
+> The portal doesn't support synonym map definitions. You can use the portal to view existing synonyms, but you can't create them or assign them to fields. For more information, see [Add synonyms in Azure AI Search](../../search-synonym.md).
 -->
 
 ## Delete an index
@@ -68,4 +68,4 @@ On the index page, select **Delete** to initiate the deletion process.
 
 The portal prompts you to confirm the deletion. After you select **Delete**, check your notifications to confirm that the deletion was successful.
 
-:::image type="content" source="../../media/search-how-to-manage-index/delete-confirmation.png" alt-text="Screenshot of the delete confirmation in the portal." border="true" lightbox="../../media/search-how-to-manage-index/delete-confirmation.png":::
+:::image type="content" source="../../media/search-how-to-manage-index/delete-confirmation.png" alt-text="Screenshot of the deletion confirmation in the portal." border="true" lightbox="../../media/search-how-to-manage-index/delete-confirmation.png":::
diff --git a/articles/search/includes/how-tos/manage-index-rest.md b/articles/search/includes/how-tos/manage-index-rest.md
@@ -7,13 +7,13 @@ ms.topic: include
 ms.date: 07/03/2025
 ---
 
-After you [create an index](search-how-to-create-search-index.md), you can use the [Azure AI Search REST APIs](/rest/api/searchservice/) to access its statistics and definition or remove it from your search service.
+After you [create an index](../../search-how-to-create-search-index.md), you can use the [Azure AI Search REST APIs](/rest/api/searchservice/) to access its statistics and definition or remove it from your search service.
 
-This article describes how to manage an index without affecting its content. For guidance on modifying an index definition, see [Update or rebuild an index in Azure AI Search](search-howto-reindex.md).
+This article describes how to manage an index without affecting its content. For guidance on modifying an index definition, see [Update or rebuild an index in Azure AI Search](../../search-howto-reindex.md).
 
 ## Limitations
 
-The pricing tier of your search service determines the maximum number and size of your indexes, fields, and documents. For more information, see [Service limits in Azure AI Search](search-limits-quotas-capacity.md).
+The pricing tier of your search service determines the maximum number and size of your indexes, fields, and documents. For more information, see [Service limits in Azure AI Search](../../search-limits-quotas-capacity.md).
 
 Otherwise, the following limitations apply to index management:
 
@@ -34,6 +34,8 @@ GET https://[service name].search.windows.net/indexes?api-version=[api version]
 
 ## View an index's statistics
 
+Each index is defined by fields and optional components that enhance search capabilities, such as analyzers, normalizers, tokenizers, and synonym maps. This definition determines the index's structure and behavior during indexing and querying.
+
 Use [Indexes - Get Statistics (REST API)](/rest/api/searchservice/indexes/get-statistics) to retrieve the document count, storage usage, and vector storage usage of an index.
 
 ```http
@@ -45,7 +47,7 @@ GET https://[service name].search.windows.net/indexes/[index name]/stats?api-ver
 
 ## View an index's definition
 
-Use [Indexes - Get (REST API)](https://docs.microsoft.com/rest/api/searchservice/get-index) to retrieve the JSON definition of an index.
+Use [Indexes - Get (REST API)](/rest/api/searchservice/indexes/get) to retrieve the JSON definition of an index.
 
 ```http
 ### Get index definition
@@ -59,7 +61,7 @@ GET https://[service name].search.windows.net/indexes/[index name]?api-version=[
 > [!WARNING]
 > You can't undo an index deletion. Before you proceed, make sure that you want to permanently remove the index and its documents from your search service. We recommend that you test this operation in a nonproduction environment.
 
-Use [Indexes - Delete (REST API)](https://docs.microsoft.com/rest/api/searchservice/delete-index) to permanently delete an index.
+Use [Indexes - Delete (REST API)](/rest/api/searchservice/indexes/delete) to permanently delete an index.
 
 ```http
 ### Delete an index
diff --git a/articles/search/includes/how-tos/manage-index-sdk.md b/articles/search/includes/how-tos/manage-index-sdk.md
@@ -7,13 +7,13 @@ ms.topic: include
 ms.date: 07/03/2025
 ---
 
-After you [create an index](search-how-to-create-search-index.md), you can use the Azure SDKs to access its statistics and definition or remove it from your search service.
+After you [create an index](../../search-how-to-create-search-index.md), you can use the Azure SDKs to access its statistics and definition or remove it from your search service.
 
-This article describes how to manage an index without affecting its content. For guidance on modifying an index definition, see [Update or rebuild an index in Azure AI Search](search-howto-reindex.md).
+This article describes how to manage an index without affecting its content. For guidance on modifying an index definition, see [Update or rebuild an index in Azure AI Search](../../search-howto-reindex.md).
 
 ## Limitations
 
-The pricing tier of your search service determines the maximum number and size of your indexes, fields, and documents. For more information, see [Service limits in Azure AI Search](search-limits-quotas-capacity.md).
+The pricing tier of your search service determines the maximum number and size of your indexes, fields, and documents. For more information, see [Service limits in Azure AI Search](../../search-limits-quotas-capacity.md).
 
 Otherwise, the following limitations apply to index management:
 
@@ -25,7 +25,7 @@ Otherwise, the following limitations apply to index management:
 
 Use your preferred Azure SDK to retrieve all indexes on your search service.
 
-### [.NET](#tab/dotnet)
+### [.NET](#tab/list-dotnet)
 
 The Azure SDK for .NET provides [GetIndexesAsync](/dotnet/api/azure.search.documents.indexes.searchindexclient.getindexesasync) for this task.
 
@@ -42,7 +42,7 @@ await foreach (var index in indexClient.GetIndexesAsync())
 }
 ```
 
-### [Java](#tab/java)
+### [Java](#tab/list-java)
 
 The Azure SDK for Java provides `listIndexes` in the [SearchIndexAsyncClient](/java/api/com.azure.search.documents.indexes.searchindexasyncclient) class for this task.
 
@@ -62,7 +62,7 @@ searchIndexAsyncClient.listIndexes()
     );
 ```
 
-### [JavaScript](#tab/javascript)
+### [JavaScript](#tab/list-javascript)
 
 The Azure SDK for JavaScript provides `listIndexes` in the [SearchIndexClient](/javascript/api/@azure/search-documents/searchindexclient) class for this task.
 
@@ -81,7 +81,7 @@ const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
 })();
 ```
 
-### [Python](#tab/python)
+### [Python](#tab/list-python)
 
 The Azure SDK for Python provides `list_indexes` in the [SearchIndexClient](/python/api/azure-search-documents/azure.search.documents.indexes.searchindexclient) class for this task.
 
@@ -96,17 +96,13 @@ for index in client.list_indexes():
     print(index.name)
 ```
 
-### [Typescript](#tab/typescript)
-
-The Azure SDK for TypeScript provides `listIndexes` in the [SearchIndexClient](/javascript/api/@azure/search-documents/searchindexclient) class for this task.
-
 ---
 
 ## View an index's statistics
 
 Use your preferred Azure SDK to retrieve the document count, storage usage, and vector storage usage of an index.
 
-### [.NET](#tab/dotnet)
+### [.NET](#tab/stats-dotnet)
 
 The Azure SDK for .NET provides [GetIndexStatisticsAsync](/dotnet/api/azure.search.documents.indexes.searchindexclient.getindexstatisticsasync) for this task.
 
@@ -124,7 +120,7 @@ Console.WriteLine($"Storage consumed by index: {stats.StorageSize:N0} bytes");
 Console.WriteLine($"Storage consumed by vectors: {stats.VectorIndexSize:N0} bytes");
 ```
 
-### [Java](#tab/java)
+### [Java](#tab/stats-java)
 
 The Azure SDK for Java provides `getIndexStatistics` in the [SearchIndexAsyncClient](/java/api/com.azure.search.documents.indexes.searchindexasyncclient) class for this task.
 
@@ -144,7 +140,7 @@ System.out.println("Storage consumed by index: " + stats.getStorageSize() + " by
 System.out.println("Storage consumed by vectors: " + stats.getVectorIndexSize() + " bytes");
 ```
 
-### [JavaScript](#tab/javascript)
+### [JavaScript](#tab/stats-javascript)
 
 The Azure SDK for JavaScript provides `getIndexStatistics` in the [SearchIndexClient](/javascript/api/@azure/search-documents/searchindexclient) class for this task.
 
@@ -164,7 +160,7 @@ const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
 })();
 ```
 
-### [Python](#tab/python)
+### [Python](#tab/stats-python)
 
 The Azure SDK for Python provides [get_index_statistics](/python/api/azure-search-documents/azure.search.documents.indexes.searchindexclient) for this task.
 
@@ -185,9 +181,11 @@ print(f"Storage consumed by vectors: {stats['vector_index_size']} bytes")
 
 ## View an index's definition
 
+Each index is defined by fields and optional components that enhance search capabilities, such as analyzers, normalizers, tokenizers, and synonym maps. This definition determines the index's structure and behavior during indexing and querying.
+
 Use your preferred Azure SDK to retrieve the JSON definition of an index.
 
-### [.NET](#tab/dotnet)
+### [.NET](#tab/definition-dotnet)
 
 The Azure SDK for .NET provides [GetIndexAsync](/dotnet/api/azure.search.documents.indexes.searchindexclient.getindexasync) for this task.
 
@@ -203,7 +201,7 @@ string indexJson = JsonSerializer.Serialize(index.Value, new JsonSerializerOptio
 Console.WriteLine(indexJson);
 ```
 
-### [Java](#tab/java)
+### [Java](#tab/definition-java)
 
 The Azure SDK for Java provides `getIndex` in the [SearchIndexAsyncClient](/java/api/com.azure.search.documents.indexes.searchindexasyncclient) class for this task.
 
@@ -230,7 +228,7 @@ searchIndexAsyncClient.getIndex("[index name]")
     });
 ```
 
-### [JavaScript](#tab/javascript)
+### [JavaScript](#tab/definition-javascript)
 
 The Azure SDK for JavaScript provides `getIndex` in the [SearchIndexClient](/javascript/api/@azure/search-documents/searchindexclient) class for this task.
 
@@ -248,7 +246,7 @@ const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
 })();
 ```
 
-### [Python](#tab/python)
+### [Python](#tab/definition-python)
 
 The Azure SDK for Python provides `get_index` in the [SearchIndexClient](/python/api/azure-search-documents/azure.search.documents.indexes.searchindexclient) class for this task.
 
@@ -270,7 +268,7 @@ print(json.dumps(index.as_dict(), indent=2, sort_keys=True, ensure_ascii=False))
 
 Use your preferred Azure SDK to permanently delete an index.
 
-### [.NET](#tab/dotnet)
+### [.NET](#tab/delete-dotnet)
 
 The Azure SDK for .NET provides [DeleteIndexAsync](/dotnet/api/azure.search.documents.indexes.searchindexclient.deleteindexasync) for this task.
 
@@ -285,7 +283,7 @@ await indexClient.DeleteIndexAsync("[index name]");
 Console.WriteLine("Index deleted successfully.");
 ```
 
-### [Java](#tab/java)
+### [Java](#tab/delete-java)
 
 The Azure SDK for Java provides `deleteIndex` in the [SearchIndexAsyncClient](/java/api/com.azure.search.documents.indexes.searchindexasyncclient) class for this task.
 
@@ -305,7 +303,7 @@ searchIndexAsyncClient.deleteIndex("[index name]")
     );
 ```
 
-### [JavaScript](#tab/javascript)
+### [JavaScript](#tab/delete-javascript)
 
 The Azure SDK for JavaScript provides `deleteIndex` in the [SearchIndexClient](/javascript/api/@azure/search-documents/searchindexclient) class for this task.
 
@@ -323,7 +321,7 @@ const client = new SearchIndexClient(endpoint, new AzureKeyCredential(adminKey)
 })();
 ```
 
-### [Python](#tab/python)
+### [Python](#tab/delete-python)
 
 The Azure SDK for Python provides `delete_index` in the [SearchIndexClient](/python/api/azure-search-documents/azure.search.documents.indexes.searchindexclient) class for this task.
 
diff --git a/articles/search/search-how-to-manage-index.md b/articles/search/search-how-to-manage-index.md
@@ -8,7 +8,7 @@ ms.author: haileytapia
 ms.service: azure-ai-search
 ms.topic: how-to
 ms.date: 07/03/2025
-zone_pivot_groups: manage-index-search
+zone_pivot_groups: search-how-to-manage-index
 ---
 
 # Manage an index in Azure AI Search
@@ -22,12 +22,12 @@ zone_pivot_groups: manage-index-search
 ::: zone-end
 
 ::: zone pivot="azure-sdks"
-[!INCLUDE [Azure SDKs instructions](includes/how-tos/manage-index-sdks.md)]
+[!INCLUDE [Azure SDKs instructions](includes/how-tos/manage-index-sdk.md)]
 ::: zone-end
 
 ## Related content
 
 + [Search indexes in Azure AI Search](search-what-is-an-index.md)
-+ [Create an index](create-search-index.md)
++ [Create an index](search-how-to-create-search-index.md)
 + [Load data into an index](tutorial-csharp-overview.md)
 + [Update or rebuild an index](search-howto-reindex.md)
