Skip to content

Commit e58b5bf

Browse files
Merge pull request #268206 from HeidiSteen/heidist-fix
[azure search] Refresh vector query how-to article
2 parents 2b44344 + 1ae73eb commit e58b5bf

File tree

3 files changed

+82
-91
lines changed

3 files changed

+82
-91
lines changed

articles/search/search-create-service-portal.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: 'Create a search service in the portal'
33
titleSuffix: Azure AI Search
4-
description: Learn how to set up an Azure AI Search resource in the Azure portal. Choose resource groups, regions, and the SKU or pricing tier.
4+
description: Learn how to set up an Azure AI Search resource in the Azure portal. Choose resource groups, regions, and a pricing tier.
55

66
manager: nitinme
77
author: HeidiSteen
@@ -61,7 +61,7 @@ A resource group is a container that holds related resources for your Azure solu
6161

6262
Over time, you can track current and projected costs all-up or you can view charges for individual resources. The following screenshot shows the kind of cost information you can expect to see when you combine multiple resources into one group.
6363

64-
:::image type="content" source="media/search-create-service-portal/resource-group-cost-management.png" lightbox="media/search-create-service-portal/resource-group-cost-management.png" alt-text="Screenshot of the manage costs page in the portal." border="true":::
64+
:::image type="content" source="media/search-create-service-portal/resource-group-cost-management.png" lightbox="media/search-create-service-portal/resource-group-cost-management.png" alt-text="Screenshot of the Managing costs page in the portal." border="true":::
6565

6666
> [!TIP]
6767
> Resource groups simplify cleanup because deleting a resource group deletes everything within it.
@@ -74,9 +74,9 @@ Service name requirements:
7474

7575
+ Unique within the search.windows.net namespace
7676
+ Between 2 and 60 characters in length
77-
+ Consist of lowercase letters, digits, dashes (`-`), or underscores (`_`)
78-
+ Don't use dashes or underscores in the first 2 characters or as the last single character
79-
+ Don't use consecutive dashes or underscores anywhere
77+
+ Consist of lowercase letters, digits, or dashes (`-`)
78+
+ Don't use dashes in the first 2 characters or as the last single character
79+
+ Don't use consecutive dashes anywhere
8080

8181
> [!TIP]
8282
> If you have multiple search services, it helps to include the region (or location) in the service name as a naming convention. A name like `mysearchservice-westus` can save you a trip to the properties page when deciding how to combine or attach resources.
@@ -105,7 +105,7 @@ Some features are subject to [regional availability](https://azure.microsoft.com
105105

106106
The [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?products=search) page indicates a common regional presence by showing two stacked check marks. An unavailable combination has a missing check mark. The time piece icon indicates future availability.
107107

108-
:::image type="content" source="media/search-create-service-portal/region-availability.png" lightbox="media/search-create-service-portal/region-availability.png" alt-text="Screenshot of the regional availability page." border="true":::
108+
:::image type="content" source="media/search-create-service-portal/region-availability.png" lightbox="media/search-create-service-portal/region-availability.png" alt-text="Screenshot of the Regional availability page." border="true":::
109109

110110
## Choose a tier
111111

@@ -125,7 +125,7 @@ After you've provided the necessary inputs, go ahead and create the service.
125125

126126
Your service is deployed within minutes. You can monitor progress through Azure notifications. Consider pinning the service to your dashboard for easy access in the future.
127127

128-
:::image type="content" source="media/search-create-service-portal/monitor-notifications.png" lightbox="media/search-create-service-portal/monitor-notifications.png" alt-text="Screenshot of the monitor and pin the service page." border="true":::
128+
:::image type="content" source="media/search-create-service-portal/monitor-notifications.png" lightbox="media/search-create-service-portal/monitor-notifications.png" alt-text="Screenshot of the Monitor and pin the service page." border="true":::
129129

130130
## Configure authentication
131131

@@ -136,11 +136,11 @@ Unless you're using the portal, programmatic access to your new service requires
136136

137137
1. When setting up a programmatic connection, you need the search service endpoint. On the **Overview** page, locate and copy the URL endpoint on the right side of the page.
138138

139-
:::image type="content" source="media/search-create-service-portal/get-endpoint.png" lightbox="media/search-create-service-portal/get-endpoint.png" alt-text="Screenshot of the service overview page with URL endpoint." border="true":::
139+
:::image type="content" source="media/search-create-service-portal/get-endpoint.png" lightbox="media/search-create-service-portal/get-endpoint.png" alt-text="Screenshot of the service Overview page with URL endpoint." border="true":::
140140

141141
1. To set authentication options, use the **Keys** page. Most quickstarts and tutorials use API keys for simplicity, but if you're setting up a service for production workloads, consider using Azure roles. You can copy keys from this page.
142142

143-
:::image type="content" source="media/search-create-service-portal/set-authentication-options.png" lightbox="media/search-create-service-portal/set-authentication-options.png" alt-text="Screenshot of the keys page with authentication options." border="true":::
143+
:::image type="content" source="media/search-create-service-portal/set-authentication-options.png" lightbox="media/search-create-service-portal/set-authentication-options.png" alt-text="Screenshot of the Keys page with authentication options." border="true":::
144144

145145
An endpoint and key aren't needed for portal-based tasks. The portal is already linked to your Azure AI Search resource with admin rights. For a portal walkthrough, start with [Quickstart: Create an Azure AI Search index in the portal](search-get-started-portal.md).
146146

@@ -161,15 +161,15 @@ Adding resources increases your monthly bill. The [pricing calculator](https://a
161161
1. In the left-navigation pane, select **Settings** > **Scale**.
162162
1. Use the slidebar to add resources of either type.
163163

164-
:::image type="content" source="media/search-create-service-portal/settings-scale.png" lightbox="media/search-create-service-portal/settings-scale.png" alt-text="Screenshot of the add capacity page." border="true":::
164+
:::image type="content" source="media/search-create-service-portal/settings-scale.png" lightbox="media/search-create-service-portal/settings-scale.png" alt-text="Screenshot of the scale page." border="true":::
165165

166166
## When to add a second service
167167

168168
Most customers use just one service provisioned at a tier [sufficient for expected load](search-capacity-planning.md). One service can host multiple indexes, subject to the [maximum limits of the tier you select](search-limits-quotas-capacity.md#index-limits), with each index isolated from another. In Azure AI Search, requests can only be directed to one index, minimizing the chance of accidental or intentional data retrieval from other indexes in the same service.
169169

170170
Although most customers use just one service, service redundancy might be necessary if operational requirements include the following:
171171

172-
+ [Business continuity and disaster recovery (BCDR)](../availability-zones/cross-region-replication-azure.md). Azure AI Search doesn't provide instant failover in the event of an outage.
172+
+ [Business continuity and disaster recovery (BCDR)](../availability-zones/cross-region-replication-azure.md). Azure AI Search doesn't provide instant failover if there's an outage.
173173

174174
+ [Multitenant architectures](search-modeling-multitenant-saas-applications.md) sometimes call for two or more services.
175175

articles/search/search-get-started-bicep.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ The Azure resource defined in this Bicep file:
6161
---
6262
6363
> [!NOTE]
64-
> Replace **\<service-name\>** with the name of the Search service. The service name must only contain lowercase letters, digits, dashes, or underscores. You can't use a dash as the first two characters or the last character. The name has a minimum length of 2 characters and a maximum length of 60 characters.
64+
> Replace **\<service-name\>** with the name of the Search service. The service name must only contain lowercase letters, digits, or dashes. You can't use a dash as the first two characters or the last character. The name has a minimum length of 2 characters and a maximum length of 60 characters.
6565
6666
When the deployment finishes, you should see a message indicating the deployment succeeded.
6767

0 commit comments

Comments
 (0)