Skip to content

Commit 6608ed6

Browse files
committed
Updating search-manage.md
1 parent 543fad7 commit 6608ed6

File tree

1 file changed

+11
-13
lines changed

1 file changed

+11
-13
lines changed

articles/search/search-manage.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,13 @@ author: haileytap
77
ms.author: haileytapia
88
ms.service: azure-ai-search
99
ms.topic: how-to
10-
ms.date: 03/04/2025
10+
ms.date: 03/05/2025
1111
---
1212

1313
# Configure your Azure AI Search service in the Azure portal
1414

1515
Configuring your new Azure AI Search service involves several tasks to optimize security, access, and performance. This article provides a day-one checklist to help you set up your service in the [Azure portal](https://portal.azure.com).
1616

17-
## Day-one configuration checklist
18-
1917
After you create a search service, we recommend that you:
2018

2119
> [!div class="checklist"]
@@ -27,7 +25,7 @@ After you create a search service, we recommend that you:
2725
> + [Enable diagnostic logging](#enable-diagnostic-logging).
2826
> + [Provide connection information to developers](#provide-connection-information-to-developers).
2927
30-
### Configure role-based access
28+
## Configure role-based access
3129

3230
Portal access is based on [role assignments](search-security-rbac.md). By default, new search services have at least one service administrator or owner. Service administrators, co-administrators, and owners have permission to create more administrators and assign other roles. They also have access to all portal pages and operations on default search services.
3331

@@ -53,7 +51,7 @@ To configure RBAC:
5351

5452
1. [Assign more roles](search-security-rbac.md) for solution developers and apps.
5553

56-
### Configure a managed identity
54+
## Configure a managed identity
5755

5856
If you plan to use indexers for automated indexing, applied AI, or integrated vectorization, you should [configure your search service to use a managed identity](search-howto-managed-identities-data-sources.md). You can then assign roles on other Azure services that authorize your search service to access data and operations.
5957

@@ -64,9 +62,9 @@ For integrated vectorization, your search service identity needs the following r
6462

6563
Role assignments can take several minutes to take effect.
6664

67-
Before you move on to network security, consider testing all points of connection to validate role assignments. Run either the [Import data wizard](search-get-started-portal.md) or the [Import and vectorize data wizard](search-get-started-portal-image-search.md) to test permissions.
65+
Before you move on to network security, consider testing all points of connection to validate role assignments. Run either the [**Import data** wizard](search-get-started-portal.md) or the [**Import and vectorize data** wizard](search-get-started-portal-image-search.md) to test permissions.
6866

69-
### Configure network security
67+
## Configure network security
7068

7169
By default, a search service accepts authenticated and authorized requests over public internet connections. You have two options for enhancing network security:
7270

@@ -75,29 +73,29 @@ By default, a search service accepts authenticated and authorized requests over
7573

7674
To learn about inbound and outbound calls in Azure AI Search, see [Security in Azure AI Search](search-security-overview.md).
7775

78-
### Check capacity and understand billing
76+
## Check capacity and understand billing
7977

8078
By default, a search service is created with one replica and one partition. You can [add capacity](search-capacity-planning.md) by adding replicas and partitions, but we recommend waiting until volumes require it. Many customers run production workloads on the minimum configuration.
8179

8280
Semantic ranker increases the cost of running your service. You can [disable semantic ranker](semantic-how-to-enable-disable.md) at the service level to prevent the use of this feature.
8381

8482
To learn about other features that affect billing, see [How you're charged for Azure AI Search](search-sku-manage-costs.md#how-youre-charged-for-azure-ai-search).
8583

86-
### Enable diagnostic logging
84+
## Enable diagnostic logging
8785

8886
[Enable diagnostic logging](search-monitor-enable-logging.md) to track user activity. If you skip this step, you still get [activity logs](/azure/azure-monitor/essentials/activity-log) and [platform metrics](/azure/azure-monitor/essentials/data-platform-metrics#types-of-metrics) automatically. However, if you want index and query usage information, you should enable diagnostic logging and choose a destination for logged operations. We recommend Log Analytics Workspace for durable storage so that you can run system queries in the Azure portal.
8987

9088
Internally, Microsoft collects telemetry data about your service and the platform. To learn more about data retention, see [Retention of metrics](/azure/azure-monitor/essentials/data-platform-metrics#retention-of-metrics).
9189

9290
To learn more about data location and privacy, see [Data residency](search-security-overview.md#data-residency).
9391

94-
### Enable semantic ranker
92+
## Enable semantic ranker
9593

9694
Semantic ranker is free for the first 1,000 requests per month. It's enabled by default on newer search services.
9795

9896
To enable semantic ranker in the portal, select **Settings** > **Semantic ranker** from the left pane, and then select the **Free** plan. For more information, see [Enable semantic ranker](semantic-how-to-enable-disable.md).
9997

100-
### Provide connection information to developers
98+
## Provide connection information to developers
10199

102100
Developers need the following information to connect to Azure AI Search:
103101

@@ -106,8 +104,8 @@ Developers need the following information to connect to Azure AI Search:
106104

107105
We recommend using the portal for the following wizards and tools:
108106

109-
+ [Import data wizard](search-get-started-portal.md)
110-
+ [Import and vectorize data](search-get-started-portal-import-vectors.md)
107+
+ [**Import data** wizard](search-get-started-portal.md)
108+
+ [**Import and vectorize data** wizard](search-get-started-portal-import-vectors.md)
111109
+ [Search explorer](search-explorer.md)
112110

113111
Recall that a user must be a contributor or higher to run the import wizards.

0 commit comments

Comments
 (0)