Skip to content

Commit 900745e

Browse files
committed
Reordered admin tasks
1 parent 58daa83 commit 900745e

File tree

1 file changed

+19
-6
lines changed

1 file changed

+19
-6
lines changed

articles/search/search-manage.md

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -61,11 +61,23 @@ On a new search service, we recommend these configuration tasks.
6161

6262
By default, a search service is created in a minimum configuration of one replica and partition each. You can [modify capacity](search-capacity-planning.md) by adding or removing replicas and partitions, but we recommend waiting until volumes require it. Many customers run production workloads on the minimum configuration.
6363

64-
Some features add to the cost of running the service. [How you're charged for Azure AI Search](search-sku-manage-costs.md#how-youre-charged-for-azure-ai-search) explains which features have billing impact. You can [disable semantic ranking](semantic-how-to-enable-disable.md) at the service level to prevent usage.
64+
Some features add to the cost of running the service:
65+
66+
+ [How you're charged for Azure AI Search](search-sku-manage-costs.md#how-youre-charged-for-azure-ai-search) explains which features have billing impact.
67+
+ [(Optional) disable semantic ranking](semantic-how-to-enable-disable.md) at the service level to prevent usage of the feature.
68+
69+
### Configure network security
70+
71+
By default, a search service accepts authenticated and authorized requests over public internet connections. Network security restricts access through firewall rules, or by disabling public connections and allowing requests only from Azure virtual networks.
72+
73+
* [Configure IP firewall rules](service-configure-firewall.md) to restrict access by IP address.
74+
* [Configure a private endpoint](service-create-private-endpoint.md) using Azure Private Link and a private virtual network.
75+
76+
Review the [Security in Azure AI Search](search-security-overview.md) for details about inbound and outbound calls.
6577

6678
### Enable diagnostic logging
6779

68-
[Enable diagnostic logging](monitor-azure-cognitive-search.md) to track user activity. If you skip this step, you still get [**activity logs**](../azure-monitor/essentials/activity-log.md) and [**platform metrics**](../azure-monitor/essentials/data-platform-metrics.md#types-of-metrics), but if you want index and query usage information, you should enable diagnostic logging and choose a destination for logged operations.
80+
[Enable diagnostic logging](monitor-azure-cognitive-search.md) to track user activity. If you skip this step, you still get [**activity logs**](../azure-monitor/essentials/activity-log.md) and [**platform metrics**](../azure-monitor/essentials/data-platform-metrics.md#types-of-metrics) automatically, but if you want index and query usage information, you should enable diagnostic logging and choose a destination for logged operations.
6981

7082
We recommend Log Analytics Workspace for durable storage if you want to run system queries in the portal.
7183

@@ -87,12 +99,13 @@ Initially, only an owner has access to search service information and operations
8799

88100
A search service is always created with [API keys](search-security-api-keys.md). An admin API key grants read-write access to all data plane operations. You can't delete admin API keys but you can [disable API keys](search-security-rbac.md#disable-api-key-authentication) if you want all users to access data plane operations through role assignments.
89101

90-
### Configure network security
102+
### Provide connection information to developers
91103

92-
By default, a search service accepts authenticated and authorized requests over public internet connections. Network security restricts access through firewall rules, or by disabling public connections and allowing requests only from Azure virtual networks.
104+
Developers need the following information to connect to Azure AI Search:
93105

94-
* [Configure IP firewall rules](service-configure-firewall.md) to restrict access by IP address
95-
* [Configure a private endpoint](service-create-private-endpoint.md) using Azure Private Link and a private virtual network
106+
+ Endpoint or URL, provided on the **Overview** page.
107+
+ API key from the **Keys** page, or a role assignment (Search Index Data Contributor is recommended).
108+
+ Recommended. A portal link for access to the following wizards and tools: [Import data wizard](search-get-started-portal.md), [Import and vectorize data](search-get-started-portal-import-vectors.md), [Search explorer](search-explorer.md).
96109

97110
## Next steps
98111

0 commit comments

Comments
 (0)